@peter_marklund/json 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Peter Marklund
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @peter_marklund/json
+
+An npm package that provides a convenient way to work with JSON using JavaScript in the terminal.
+
+## TODO
+
+* Use stable/sorted JSON stringify
+
+## Installation
+
+```sh
+npm install @peter_marklund/json -g
+```
+
+## Usage
+
+```sh
+echo '{"foo": "1"}' | json .foo
+```
+
+## Developing the Library Locally
+
+```sh
+npm link
+```
+
+## Publishing a new Version
+
+```sh
+npm publish --access public
+```
+
+# Prior Art
+
+* [trentm/json](https://github.com/trentm/json) - nice library with [very good documentation](https://trentm.com/json/)

package/bin/json.js

@@ -0,0 +1,152 @@
+#!/usr/bin/env node --max-old-space-size=16384
+
+// Simple node script that provides a jq alternative for processing JSON using JavaScript on the command line.
+// Supports newline separated JSON (JSON lines) as well as JSON data.
+// Also supports log data where some lines are JSON and some aren't and log lines where the
+// beginning of the line is text and the end of the line is JSON, i.e.:
+//
+// 2022-10-18T14:07:53.960Z [INFO ] starting server with config: {"port":3000}
+
+// With pipe (can break for large amounts of JSON data)
+//
+// cat some-data.json | json <javascript-code>
+//
+// With a file path (works better for large amounts of data):
+//
+// json <javascript-code> <file-path>
+// The JSON data is available in a `data` variable. If the JavaScript code argument starts with a "." then that is equivalent to starting it with "data.".
+//
+// You can use map and filter and useful lodash functions like get:
+//
+// cat some-data.json | json ".Items.map(i => ({id: get(i, 'id.S'), updatedAt: get(i, 'updatedAt.N')})).filter(i => new Date(Number(i.updatedAt)) < new Date())"
+//
+// You can access the JSON data with the data variable:
+//
+// cat some-data.json | json "Object.keys(data)"
+//
+// Split complex processing with pipes if it helps readability:
+//
+// cat some-data.json \
+//  | json ".Items.map(i => ({id: get(i, 'id.S'), updatedAt: get(i, 'updatedAt.N')}))" \
+//  | json ".filter(i => new Date(Number(i.updatedAt)) < new Date())"
+//
+// Easily print lengths of arrays or keys of objects etc:
+//
+// cat some-data.json | json ".Items.length"
+//
+// Pretty print (echo) JSON data:
+//
+// cat some-data.json | json .
+
+const fs = require("fs");
+const readline = require("readline");
+const _ = require("lodash");
+Object.assign(global, require("lodash"));
+const { diff } = require("object-diffy");
+const { colorize } = require("json-colorizer");
+
+function getCodeArg() {
+    let code = process.argv[2] || "data"
+    // Support jq like dot syntax
+    if (code === ".") {
+        code = "data"
+    } else if (code.startsWith(".")) {
+        code = "data" + code
+    }
+    return code
+}
+
+function readStdIn() {
+    return fs.readFileSync(0).toString();
+}
+  
+async function jsonIn(filePath) {
+    let textInput
+    try {
+      if (filePath) {
+        return require(filePath)
+      } else {
+        textInput = readStdIn()
+        // NOTE: I've found JSON.parse intermittently errors out for data sizes around 15 MB but require(filePath) can handle more?
+        // const dataSizeMb = Buffer.byteLength(textInput) / 1024 / 1024
+        return JSON.parse(textInput)
+      }
+    } catch (jsonErr) {
+      try {
+        const lines = []
+        let openLines = []
+        let nErrors = 0
+        let lineCount = 0
+        const processLine = (line) => {
+          lineCount += 1
+          const result = parseLine(line, openLines)
+          if (result.error) {
+            console.log(error)
+            nErrors += 1
+          }
+          if (result.parsedLine) lines.push(result.parsedLine)
+          openLines = result.openLines
+        }
+        if (filePath) {
+          const rl = readline.createInterface({
+            input: fs.createReadStream(filePath),
+            crlfDelay: Infinity,
+          })
+          for await (const line of rl) {
+            processLine(line)
+          }
+        } else {
+          textInput = textInput || readStdIn()
+          const textLines = textInput
+            .trim()
+            .split("\n")
+            .map((l) => l.trim())
+            .filter(Boolean)
+          for (const [index, line] of textLines.entries()) {
+            processLine(line)
+          }
+        }
+        if (nErrors > 0)
+          console.log(
+            `Failed to parse ${nErrors}/${textLines.length} lines due to errors`
+          )
+        return lines
+      } catch (linesErr) {
+        console.log(jsonErr.stack)
+        console.log(linesErr.stack)
+        throw new Error("Could not parse input as JSON or as JSON lines")
+      }
+    }
+}
+  
+function printJson(data) {
+    console.log(JSON.stringify(data))
+}
+  
+function printPrettyJson(data) {
+    console.log(colorize(JSON.stringify(data, null, 4)))
+}
+
+async function main() {
+    const code = getCodeArg()
+    const filePath = process.argv[3]
+  
+    const data = await jsonIn(filePath)
+  
+    const processedData = eval(code)
+  
+    if (process.env.RAW === "true" || (process.env.RAW !== "false" && ["string", "number", "boolean"].includes(typeof processedData))) {
+      console.log(processedData)
+    } else if (process.env.JSONL === "true" && Array.isArray(processedData)) {
+      printJsonLines(processedData)
+    } else if (process.env.PRETTY === "false") {
+      printJson(processedData)
+    } else {
+      printPrettyJson(processedData)
+    }
+}
+  
+
+if (require.main === module) {
+  main()
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@peter_marklund/json",
+  "version": "0.0.1",
+  "description": "A convenient way to work with JSON using JavaScript in the terminal",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/peter/json.git"
+  },
+  "bin": {
+    "json": "./bin/json.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "type": "commonjs",
+  "bugs": {
+    "url": "https://github.com/peter/json/issues"
+  },
+  "homepage": "https://github.com/peter/json#readme",
+  "dependencies": {
+    "json-colorizer": "^3.0.1",
+    "lodash": "^4.17.23",
+    "object-diffy": "^1.0.4"
+  }
+}