fx
A non-interactive, JavaScript version of the fx .
Short for Function eXecution or f(x) .
Or use npx :
cat file.json | npx fx .field copy
Or use deno :
cat file.json | deno run -A npm:fx .field copy
Usage
Fx treats arguments as JavaScript functions. Fx passes the input data to the first
function and then passes the result of the first function to the second function
and so on.
echo '{"name": "world"}' | fx 'x => x.name' 'x => `Hello, ${x}!`' copy
Use this to access the input data. Use . at the start of the expression to
access the input data without a x => x part.
echo '{"name": "world"}' | fx '.name' '`Hello, ${this}!`' copy
Use other JS functions to process the data.
echo '{"name": "world"}' | fx 'Object.keys' copy
Stream processing
Fx can process a stream of json objects. Fx will apply arguments to each object.
echo '{"name": "hello"}\n{"name": "world"}' | fx '.name' copy
If you want to process a stream of json objects as a single array,
use the --slurp or -s flag.
echo '{"name": "hello"}\n{"name": "world"}' | fx --slurp '.map(x => x.name)' '.join(", ")' copy
If you want to process non-JSON data, use the --raw or -r flag.
ls | fx -r '[this, this.includes(".md")]' copy
You can use --raw and --slurp (or -rs ) together to get a single array of strings.
ls | fx -rs '.filter(x => x.includes(".md"))' copy
Fx has a special symbol skip for skipping the printing of the result.
ls | fx -r '.includes(".md") ? this : skip' copy
Built-in functions
Fx comes with a set of useful functions: uniq , sort , groupBy , chunk , zip .
cat file.json | fx 'uniq' 'sort' 'groupBy(x => x.name)' copy
Edit-in-place
You can use special function save to edit-in-place the input data.
fx file.json 'x.name = x.name.toUpperCase(), x' 'save' copy
The edited data will be saved to the same file.json file.
Syntactic Sugar
Prefix an expression with @ to apply it to each item of an array. For example,
.map(x => x.commit.message) can be written as @.commit.message.
curl https://api.github.com/repos/antonmedv/fx/commits | fx '@.commit.message' copy
echo '[{"name": "world"}]' | fx '@`Hello, ${x.name}!`' copy
Fx has a special syntax for the flatMap function. Fox example,
.issues.flatMap(x => x.labels.flatMap(x => x)) can be rewritten in the next way.
curl https://fx.wtf/example.json | fx '.issues[].labels[]' copy
.fxrc.js
Fx supports .fxrc.js file in the current directory, or in the home directory, or in XDG config directory.
Put the next code in the .fxrc.js file to make myFunction available in the fx.
function addOne (x) {
return x + 1
} copy
Now you can use addOne in the fx.
If you would like to create global variables use var instead of let or const.
License
MIT