CodeSampleX

Exemple

commander 15.0.0: Parse command line options with commander without touching process.argv

Échantillon vérifié pour npm commander 15.0.0: Parse command line options with commander without touching process.argv. Le contrat s'est exécuté sur node 22…

sha256:ae82f374c5cce645bfa0fbd914f1f675540b81131e60b0b93130f5caa6b74638

Ce réseau offre une seule chose : un échantillon qui compile. Il l'a exécuté dans un bac à sable et conservé le reçu signé. Il ne note rien et ne garantit rien : si le même code compile chez vous, il ne l'a pas mesuré. Combien de clés de signature distinctes ont déposé un reçu de contrat réussi. Une seule, c'est l'auteur ; plus d'une signifie que quelqu'un d'autre l'a compilé aussi. Une clé est auto-générée sans identité enregistrée derrière, donc on compte des clés, pas des personnes. MIT-0

Preuves d'exécution

L'environnement déclaré et les exécutions signées sont séparés, pour que vous voyiez exactement ce que cet échantillon a exécuté et où.

Base de preuve
Contrat signé réussi
Reçus de vérification
3
Clés de signature qui l’ont compilé
3
Environnement déclaré node 22 linux x64 node 22 npm

Environnements des exécutions de vérification

Environnement Contrat Étapes Exécution
node 22 · linux alpine/x64 · docker ed25519:a2ec939a4c60e243 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1		 2026-08-13
node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1		 2026-08-17
node 22 · linux alpine/x64 · docker ed25519:c1973797be207ac4 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1node:22-alpine@sha256:c610fcdfb1d5…		 2026-09-08

Cas

HOW
Objectif
Parse command line options with commander without touching process.argv
Paquets
Symboles
  • Command
  • program.option
  • program.parse
Environnement
node 22
Créé
2026-08-13T15:19:24Z

Contrat

  1. build a Command with a value option, a flag and a default
  2. parse an explicit argument array with from: user
  3. assert values, flags and defaults land in opts()
  4. assert positional arguments are still reachable

Fichiers

  • csx.json
  • package-lock.json
  • package.json
  • src/index.mjs
  • test/contract.mjs

Télécharger l’artefact source (tar.gz)

Code source

csx.json
{"case":{"caseId":"case:sha256:12b9ee4f453ffcb914628f2a8bda58849d2ef93510e12c01d9971b548155205f","constraints":{"moduleSystem":"esm","runtime":"node"},"contract":["build a Command with a value option, a flag and a default","parse an explicit argument array with from: user","assert values, flags and defaults land in opts()","assert positional arguments are still reachable"],"goal":"Parse command line options with commander without touching process.argv","kind":"HOW","packages":["pkg:npm/commander@15.0.0"],"schemaVersion":1,"symbols":["Command","program.option","program.parse"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","ecosystem":"npm","executionContext":"node","moduleSystem":"esm","os":"linux","packageManager":"npm","runtime":"node","runtimeVersion":"22","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/commander@15.0.0"],"schemaVersion":1,"symbols":["Command","program.option","program.parse"],"verifierAdapter":"node-typescript@1"}
package-lock.json
{
  "name": "csx-sample-commander-parse-options",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "csx-sample-commander-parse-options",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "commander": "15.0.0"
      }
    },
    "node_modules/commander": {
      "version": "15.0.0",
      "resolved": "https://registry.npmjs.org/commander/-/commander-15.0.0.tgz",
      "integrity": "sha512-z67u4ZhzCL/Tydu1lJARtEZYWbWaN7oYLHbsuzocr6y4N6WZAagG3RQ4FW61V1/0+jImpj293XfrcYnd1qxtPg==",
      "license": "MIT",
      "engines": {
        "node": ">=22.12.0"
      }
    }
  }
}
package.json
{
  "name": "csx-sample-commander-parse-options",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "commander": "15.0.0"
  }
}
src/index.mjs
import { Command } from 'commander';

// parse(argv) expects a full node argv (argv[0] node, argv[1] script).
// Passing your own array without { from: 'user' } silently eats the first
// two entries — the classic "my first option disappeared" report.
export function parseArgs(argv) {
  const program = new Command();
  program
    .name('csx-demo')
    .argument('[target]', 'what to build', 'all')
    .option('-p, --port <number>', 'port to listen on', '3000')
    .option('-v, --verbose', 'verbose output')
    .exitOverride(); // throw instead of calling process.exit in a library
  program.parse(argv, { from: 'user' });
  return { options: program.opts(), args: program.args };
}
test/contract.mjs
import { strict as assert } from 'node:assert';
import { parseArgs } from '../src/index.mjs';

const explicit = parseArgs(['--port', '8080', '--verbose', 'server']);
assert.equal(explicit.options.port, '8080');
assert.equal(explicit.options.verbose, true);
assert.deepEqual(explicit.args, ['server']);

const defaults = parseArgs([]);
assert.equal(defaults.options.port, '3000'); // declared default
assert.equal(defaults.options.verbose, undefined);
console.log('CONTRACT PASS: commander parsed an explicit argv with from: user');

Seeder d'origine

anonymous