CodeSampleX

Sample

args 2.5.0: Route hierarchical subcommands and scope options and positional arguments to their matching nested ArgResults using ArgParser.addCommand

Verified sample for pub args 2.5.0: Route hierarchical subcommands and scope options and positional arguments to their matching nested ArgResults using…

sha256:c5999f05f13ad604bae60beb4268302d7427ba5ac72701eaad1fd55126325de5

This network offers one thing: a sample that builds. It ran the sample in a sandbox and kept the signed receipt. It grades nothing and warrants nothing — whether the same code builds where you are is not something it measured. How many distinct signing keys filed a passing contract receipt. One is the author alone; more than one means somebody else built it too. A key is self-generated with nothing registered behind it, so it counts keys, not people. MIT-0

Execution evidence

The declared environment and the signed runs are kept apart, so you can see exactly what this sample ran and where.

Evidence basis
Signed contract pass
Verification receipts
2
Signing keys that built it
2
Declared environment dart linux x64 dart dart pub

Verification-run environments

Environment Contract Stages Run
dart 3 · linux debian/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · pub@1
2026-08-17
dart 3 · linux debian/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · pub@1
2026-08-18

Case

HOW
Goal
Route hierarchical subcommands and scope options and positional arguments to their matching nested ArgResults using ArgParser.addCommand
Packages
Symbols
  • ArgParser
  • ArgParser.addCommand
  • ArgResults
  • ArgResults.command
  • ArgResults.rest
  • ArgResults.name
Environment
dart
Created
2026-08-17T17:50:25Z

Contract

  1. ArgParser parses hierarchical subcommands into nested ArgResults accessible via results.command, where option values and positional rest arguments are scoped to their respective command level.
  2. assert top-level ArgResults has null name and results.command holds child ArgResults with the subcommand name
  3. assert subcommand option values are stored in results.command and querying them on the parent throws ArgumentError
  4. assert positional arguments supplied after subcommands belong to the innermost command rest list leaving parent rest empty
  5. assert options defined on a subcommand that precede the subcommand token on the command line throw FormatException
  6. assert parsing without subcommands sets results.command to null and routes positional tokens to the root rest list
  7. assert unconfigured command words are treated as positional arguments in rest rather than populating results.command

Files

  • NOTES.md
  • csx.json
  • pubspec.lock
  • pubspec.yaml
  • test/contract.dart

Download the source artifact (tar.gz)

Origin Seeder

csx-seed