fx/npm/README.md

# fx

A non-interactive, JavaScript version of the [**fx**](https://fx.wtf). 
Short for _Function eXecution_ or _f(x)_.

```sh
npm i -g fx
```

Or use **npx**:

```sh
cat file.json | npx fx .field
```

Or use **node**:

```sh
cat file.json | node <(curl -s https://fx.wtf) .field
```

Or use **deno**:

```sh
cat file.json | deno run https://fx.wtf .field
```

## 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.

```sh
echo '{"name": "world"}' | fx 'x => x.name' 'x => `Hello, ${x}!`'
```

Use `this` to access the input data. Use `.` at the start of the expression to 
access the input data without a `x => x` part.

```sh
echo '{"name": "world"}' | fx '.name' '`Hello, ${this}!`'
```

Use other JS functions to process the data.

```sh
echo `{"name": "world"}` | fx 'Object.keys'
```

## Advanced Usage

Fx has a shortcut for the map function. Fox example, `this.map(x => x.commit.message)`
can be rewritten without leading dot and without `x => x` parts.  

```sh
curl https://api.github.com/repos/antonmedv/fx/commits | fx 'map(.commit.message)'
```

```sh
echo '[{"name": "world"}]' | fx 'map(`Hello, ${x.name}!`)'
```

Fx has a special syntax for the flatMap function. Fox example,
`.flatMap(x => x.labels.flatMap(x => x.name))` can be rewritten in the next way.

```sh
curl https://api.github.com/repos/kubernetes/kubernetes/issues | fx '.[].labels[].name'
```

Fx works with promises.

```sh
echo '"https://medv.io/*"' | fx 'fetch' '.text()'
```

When using the **-r** or **--raw** flag, the input will be treated as a raw string
instead of JSON. This can be useful when working with non-JSON input data, such as
plain text or CSV data.

```sh
ls | fx -r '.trim().split("\n")'
```

## License

[MIT](../LICENSE)