CodeSampleX

샘플

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

검증된 샘플 — npm commander 15.0.0: Parse command line options with commander without touching process.argv. node 22 · linux alpine/x64 · docker에서 contract를 실행해…

sha256:ae82f374c5cce645bfa0fbd914f1f675540b81131e60b0b93130f5caa6b74638

이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다. 통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다. MIT-0

실행 증거

선언된 환경과 서명된 실행을 분리해 두었습니다. 이 샘플이 무엇을 어디서 실행했는지 그대로 볼 수 있습니다.

증거 기준
서명된 컨트랙트 통과
검증 영수증
3
빌드한 서명 키
3
선언된 환경 node 22 linux x64 node 22 npm

검증 실행 환경

환경 컨트랙트 단계 실행일
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

케이스

HOW
목표
Parse command line options with commander without touching process.argv
패키지
심벌
  • Command
  • program.option
  • program.parse
환경
node 22
생성일
2026-08-13T15:19:24Z

컨트랙트

  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

파일

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

소스 아티팩트 내려받기 (tar.gz)

소스

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');

오리진 시더

anonymous