@cto.af/chex-cli 1.0.0

package/bin/chex.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+/* eslint-disable no-console */
+
+import {Command, Option} from 'commander';
+import {Buffer} from 'buffer';
+import fs from 'fs/promises';
+import {hexDump} from '@cto.af/chex';
+
+const program = new Command();
+program
+  .argument('[file...]', 'file names to read or "-" for stdin')
+  .option('-c,--colors', 'force colors on even if stdout is not a tty')
+  .option('-d,--dots', 'use dots for more control characters, instead of Unicode representations')
+  .addOption(new Option(
+    '-s,--strings <encoding>',
+    'try to decode strings in this encoding'
+  ).choices(['utf8', 'utf-8']))
+  .parse();
+
+const opts = program.opts();
+const {args} = program;
+if (args.length === 0) {
+  args.push('-');
+}
+
+function readStdin() {
+  return new Promise((resolve, reject) => {
+    const bufs = [];
+    process.stdin.on('data', d => bufs.push(d));
+    process.stdin.on('end', () => resolve(new Uint8Array(Buffer.concat(bufs))));
+    process.stdin.on('error', reject);
+  });
+}
+
+async function main(argv) {
+  for (const fn of argv) {
+    if (argv.length > 1) {
+      console.log(fn);
+    }
+    const buf = fn === '-' ?
+      await readStdin() :
+      new Uint8Array(await fs.readFile(fn));
+    console.log(hexDump(buf, {
+      colors: opts.colors || process.stdout.isTTY,
+      dots: opts.dots,
+      decode: opts.strings,
+    }));
+  }
+}
+
+main(args).catch(console.error);

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@cto.af/chex-cli",
+  "version": "1.0.0",
+  "description": "hexdump -C as a small JS library",
+  "main": "lib/index.js",
+  "type": "module",
+  "bin": {
+    "chex": "bin/chex.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cto-af/chex.git",
+    "directory": "pkg/chex-cli"
+  },
+  "keywords": [
+    "hexdump",
+    "hex",
+    "unicode",
+    "cli"
+  ],
+  "author": "Joe Hildebrand <joe-github@cursive.net>",
+  "license": "MIT",
+  "dependencies": {
+    "@cto.af/chex": "workspace:*",
+    "commander": "12.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}