fx 25.0.0 → 26.0.0

package/README.md

@@ -9,19 +9,19 @@ npm i -g fx
 Or use **npx**:
 
 ```sh
-cat file.json | npx fx .param
+cat file.json | npx fx .field
 ```
 
 Or use **node**:
 
 ```sh
-cat file.json | node <(curl -s https://fx.wtf) .param
+cat file.json | node <(curl -s https://fx.wtf) .field
 ```
 
 Or use **deno**:
 
 ```sh
-cat file.json | deno run https://fx.wtf .param
+cat file.json | deno run https://fx.wtf .field
 ```
 
 ## Usage
@@ -73,6 +73,14 @@ Fx works with promises.
 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)

package/index.js

@@ -1,13 +1,23 @@
+#!/usr/bin/env node
 void async function main() {
   const process = await import('node:process')
   const args = process.argv.slice(2)
+  if ((args.length === 0 && process.stdin.isTTY)
+    || (args.length === 1 && ['-h', '--help'].includes(args[0]))) {
+    printUsage()
+    return
+  }
+
   let input = ''
   process.stdin.setEncoding('utf8')
   for await (const chunk of process.stdin)
     input += chunk
 
   let json
-  try {
+  if (['-r', '--raw'].includes(args[0])) {
+    args.shift()
+    json = input
+  } else try {
     json = JSON.parse(input)
   } catch (err) {
     process.stderr.write(`Invalid JSON: ${err.message}\n`)
@@ -114,3 +124,13 @@ function groupBy(keyOrFunction) {
     return grouped
   }
 }
+
+function printUsage() {
+  const usage = `Usage
+  fx [flags] [code...]
+
+Flags
+  -h, --help    Display this help message
+  -r, --raw     Treat input as raw string`
+  console.log(usage)
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fx",
-  "version": "25.0.0",
+  "version": "26.0.0",
   "bin": {
     "fx": "index.js"
   },