tequery

text transform query

Install

$ npm install tequery

Usage

basic $

Basic text transform query. $ is text body variable.

import { tequery as tq } from 'tequery'

tq(' hoge ', '$.trim()').result
// => 'hoge'
// equaliy shorthand
tq(' hoge ', '.trim()').result

tq('https://example.com', `.replace('https://', '')`).result
// => 'example.com'

line-run $$

const text = ` line1
   line2
 line3`

tq(text, '$$.trim()').result
// => 'line1\n'
// + 'line2\n'
// + 'line3'

finalize

final process to string from returned value type.

type	process
typeof v === 'function'	v($)
typeof v === 'string'	v
typeof v === 'number'	String(v)
typeof v === 'undefined'	""
v === null	""
Array.isArray(v)	v.join("\n")
other	String(v)
typeof v === 'object'	JSON.stringify

built-in funcs

util functions in running scope.

tq('', `len('abc')`).result
// => '3'
tq('abcde', 'len($)').result
// => '5'

// equaliy shorthand
tq('abcde', 'len').result

func	usage	return
len	len('aaa')	3
lineNum, ln	ln('a\nb')	2
count	count('aaa-a-', 'a')	4
pack	pack('a\nb\n\nc\n\n\n')	'a\nb\nc\n'
shiftl	shiftl('a-b-c-d', '-', 1)	'b-c-d'
shiftr	shiftr('a-b-c-d', '-', 1)	'a-b-c'

built-in vars

util vars in running scope.

tq('a,b,c', `$csv.join(':')`).result
// => 'a:b:c'
expect(tq('', `$tsv.join(':')`).result).toBe()
expect(tq('a+b+c', `$sp('+').join(':')`).result).toBe('a:b:c')

vars	$=	is
$tsv	a\tb\tc	['a', 'b', 'c']
$csv	a,b,c	['a', 'b', 'c']
$ls, $lines	a\nb\nc	['a', 'b', 'c']
$sp('+')	a+b+c	['a', 'b', 'c']

more example

vars with line-run

const txt = `a,b,c
d,e,f`

tq(text, `$$csv.join(':')`).result
// => 'a:b:c\n'
//  + 'd:e:f'

result object

type Result = {
  status: 'ok' | 'ng' // is changed
  result: string
  resultRaw: unknown
  evalQuery: string // compiled query
  errorText: string
  returnType: string
  comps: Complements // is shorthund enabled
}