CodeSampleX

Exemple

commander 10.0.1: Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the string into numeric indices as in Commander 10.0.0

Échantillon vérifié pour npm commander 10.0.1: Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the…

sha256:997e08319af13c6ed363d7ec20d7adfe1887d84969fab414a089a8f815cf9f19

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
2
Clés de signature qui l’ont compilé
2
Environnement déclaré node linux x64 node node npm

Environnements des exécutions de vérification

Environnement Contrat Étapes Exécution
node 22 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-16
node 22 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · node-typescript@1
2026-08-18

Cas

HOW
Objectif
Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the string into numeric indices as in Commander 10.0.0
Paquets
Symboles
  • Option.implies
Environnement
node
Créé
2026-08-16T17:52:05Z

Contrat

  1. Option.implies('quiet') on an option implicitly sets the boolean quiet option to true when the parent flag is present in Commander 10.0.1 instead of decomposing the string into numeric character properties as in 10.0.0
  2. opts().quiet is strict equal to true
  3. opts() does not contain string index keys ('0', '1', etc.)
  4. omitting the triggering option leaves implied options undefined
  5. direct --quiet flag sets quiet option independently

Fichiers

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

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

Code source

NOTES.md
# Notes

- **Search answer:** `search_known_solution` returned existing sample `sha256:5c6d27a5983a0c5c7ab82d8867250554602d63b07860b3cdacd2dcd58f498252` ("Pass a string option name to Option.implies() to imply boolean options without string key decomposition").
- **How the wrong version fails:** In Commander 10.0.0, passing a string option name to `.implies('quiet')` fails silently with a green build in loose assertions because `Object.assign` treats the string as an array-like object (`{ '0': 'q', '1': 'u', '2': 'i', '3': 'e', '4': 't' }`), leaving `opts.quiet` undefined and polluting `opts` with numeric string index keys.
csx.json
{"case":{"believed":"Passing a string option name to Option.implies() sets that option to true when the triggering option is parsed.","caseId":"case:sha256:dd859b17c9ecd9511d5daccf4846a5c9aba87919ca8d75cf30bd86b39e3ddf6a","contract":["Option.implies('quiet') on an option implicitly sets the boolean quiet option to true when the parent flag is present in Commander 10.0.1 instead of decomposing the string into numeric character properties as in 10.0.0","opts().quiet is strict equal to true","opts() does not contain string index keys ('0', '1', etc.)","omitting the triggering option leaves implied options undefined","direct --quiet flag sets quiet option independently"],"goal":"Option.implies() in Commander 10.0.1 accepts a string option name to set boolean flags without decomposing the string into numeric indices as in Commander 10.0.0","kind":"HOW","packages":["pkg:npm/commander@10.0.1"],"schemaVersion":1,"symbols":["Option.implies"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","ecosystem":"npm","executionContext":"node","language":"node","os":"linux","packageManager":"npm","runtime":"node","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/commander@10.0.1"],"schemaVersion":1,"symbols":["Option.implies"],"verifierAdapter":"node-typescript@1"}
package-lock.json
{
  "name": "csx-sample-commander-implies-fix",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "csx-sample-commander-implies-fix",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "commander": "10.0.1"
      }
    },
    "node_modules/commander": {
      "version": "10.0.1",
      "resolved": "https://registry.npmjs.org/commander/-/commander-10.0.1.tgz",
      "integrity": "sha512-y4Mg2tXshplEbSGzx7amzPwKKOCGuoSRP/CjEdwwk0FOGlUbq6lKuoyDZTNZkmxHdJtp54hdfY/JUrdL7Xfdug==",
      "license": "MIT",
      "engines": {
        "node": ">=14"
      }
    }
  }
}
package.json
{
  "name": "csx-sample-commander-implies-fix",
  "version": "1.0.0",
  "private": true,
  "type": "module",
  "license": "MIT-0",
  "dependencies": {
    "commander": "10.0.1"
  }
}
src/index.mjs
import { Command, Option } from 'commander';

/**
 * Parses CLI arguments for a command with implied option relationships.
 *
 * In Commander 10.0.0, passing a string option name to `.implies('quiet')`
 * decomposed the string as an object into `{ '0': 'q', '1': 'u', ... }` and left
 * `opts.quiet` undefined. Commander 10.0.1 (patch release fixing PR #1854)
 * handles string arguments directly as `{ quiet: true }`.
 *
 * @param {string[]} argv - CLI flags/arguments passed by user
 * @returns {Record<string, any>} Parsed options object
 */
export function parseOptions(argv) {
  const program = new Command();
  program
    .name('demo')
    .addOption(new Option('-s, --silent', 'suppress output').implies('quiet'))
    .option('-q, --quiet', 'quiet mode')
    .exitOverride();

  program.parse(argv, { from: 'user' });
  return program.opts();
}
test/contract.mjs
import { strict as assert } from 'node:assert';
import { parseOptions } from '../src/index.mjs';

// 1. Asserting string option name to Option.implies() sets target boolean option to true in Commander 10.0.1
const silentOpts = parseOptions(['--silent']);
assert.equal(silentOpts.silent, true);
assert.equal(silentOpts.quiet, true);

// 2. Asserting options dictionary is not polluted with decomposed numeric index keys ('0', '1', etc.)
assert.equal(silentOpts['0'], undefined);
assert.equal(silentOpts['1'], undefined);
assert.deepEqual(silentOpts, { silent: true, quiet: true });

// 3. Asserting target options remain undefined when triggering flag is omitted
const defaultOpts = parseOptions([]);
assert.equal(defaultOpts.silent, undefined);
assert.equal(defaultOpts.quiet, undefined);
assert.deepEqual(defaultOpts, {});

// 4. Asserting direct target flag still functions independently
const quietOpts = parseOptions(['--quiet']);
assert.equal(quietOpts.silent, undefined);
assert.equal(quietOpts.quiet, true);
assert.deepEqual(quietOpts, { quiet: true });

console.log('CONTRACT PASS: Option.implies() string argument implies boolean option in Commander 10.0.1 without string key decomposition');

Seeder d'origine

csx-seed