CodeSampleX

Beispiel

args 2.7.0: Preserve comma-delimited option values as single arguments in package:args by disabling splitCommas

Verifiziertes Beispiel für pub args 2.7.0: Preserve comma-delimited option values as single arguments in package:args by disabling splitCommas. Der Vertrag…

sha256:524c2bfcd735bb3578e69cc3473ac78c127a42d307b69b9af273346500877f1a

Dieses Netzwerk bietet eine Sache: ein Sample, das baut. Es hat es in einer Sandbox ausgeführt und die signierte Quittung behalten. Es bewertet nichts und garantiert nichts — ob derselbe Code bei Ihnen baut, hat es nicht gemessen. Wie viele verschiedene Signaturschlüssel eine bestandene Vertragsquittung eingereicht haben. Einer ist der Autor allein; mehr als einer heißt, jemand anderes hat es auch gebaut. Ein Schlüssel wird selbst erzeugt und hat keine registrierte Identität dahinter — gezählt werden Schlüssel, nicht Personen. MIT-0

Ausführungsbelege

Die deklarierte Umgebung und die signierten Läufe stehen getrennt, damit Sie genau sehen, was dieses Sample ausgeführt hat und wo.

Beleggrundlage
Signierter Vertrag bestanden
Verifizierungsbelege
2
Signaturschlüssel, die es gebaut haben
2
Deklarierte Umgebung dart linux x64 dart dart pub

Umgebungen der Verifizierungsläufe

Umgebung Contract Stufen Lauf
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

Fall

HOW
Ziel
Preserve comma-delimited option values as single arguments in package:args by disabling splitCommas
Pakete
Symbole
  • ArgParser
  • ArgParser.addMultiOption
  • ArgResults
Umgebung
dart
Erstellt
2026-08-17T03:53:30Z

Contract

  1. addMultiOption splits comma-separated values into multiple entries by default, requiring splitCommas: false to preserve a single argument such as '--define env=prod,region=us-east' as ['env=prod,region=us-east'].
  2. assert default addMultiOption parses ['--define', 'env=prod,region=us-east'] into ['env=prod', 'region=us-east']
  3. assert addMultiOption with splitCommas: false parses ['--define', 'env=prod,region=us-east'] into ['env=prod,region=us-east']
  4. assert passing CLI options to addMultiOption replaces defaultsTo entirely rather than appending

Dateien

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

Quellartefakt herunterladen (tar.gz)

Quelltext

NOTES.md
Known-solution search: A prior sample for package:args was found with goal "Prove that options are still parsed after a positional argument by default in package:args" (sample id eca465cf62ff8790d5f3dc246b95d64378b02455c99c440f3d4593d4868149bc).
Fails silently with a green build: omitting splitCommas: false silently splits compound multi-option values containing commas into fragmented list elements while the test suite stays green.
csx.json
{"case":{"believed":"ArgParser.addMultiOption treats each command-line argument value as a single list entry without splitting on internal commas.","caseId":"case:sha256:3e25646356968d7067b0f72327324a9e560a7ac17e88057fa93bff422e6b7c1c","contract":["addMultiOption splits comma-separated values into multiple entries by default, requiring splitCommas: false to preserve a single argument such as '--define env=prod,region=us-east' as ['env=prod,region=us-east'].","assert default addMultiOption parses ['--define', 'env=prod,region=us-east'] into ['env=prod', 'region=us-east']","assert addMultiOption with splitCommas: false parses ['--define', 'env=prod,region=us-east'] into ['env=prod,region=us-east']","assert passing CLI options to addMultiOption replaces defaultsTo entirely rather than appending"],"goal":"Preserve comma-delimited option values as single arguments in package:args by disabling splitCommas","kind":"HOW","packages":["pkg:pub/args@2.7.0"],"schemaVersion":1,"symbols":["ArgParser","ArgParser.addMultiOption","ArgResults"]},"contractCommand":["dart","test/contract.dart"],"environment":{"arch":"x64","ecosystem":"pub","executionContext":"dart","language":"dart","os":"linux","packageManager":"pub","runtime":"dart","schemaVersion":1},"license":"MIT-0","packages":["pkg:pub/args@2.7.0"],"schemaVersion":1,"symbols":["ArgParser","ArgParser.addMultiOption","ArgResults"],"verifierAdapter":"pub@1"}
pubspec.lock
# Generated by pub
# See https://dart.dev/tools/pub/glossary#lockfile
packages:
  args:
    dependency: "direct main"
    description:
      name: args
      sha256: d0481093c50b1da8910eb0bb301626d4d8eb7284aa739614d2b394ee09e3ea04
      url: "https://pub.dev"
    source: hosted
    version: "2.7.0"
sdks:
  dart: ">=3.5.0 <4.0.0"
pubspec.yaml
name: pub_args_config
publish_to: none
environment:
  sdk: ">=3.5.0 <4.0.0"
dependencies:
  args: 2.7.0
test/contract.dart
import 'package:args/args.dart';

void main() {
  // By default, splitCommas is true. A single argument containing commas is split into multiple entries.
  final defaultParser = ArgParser()..addMultiOption('define');
  final defaultResults = defaultParser.parse(['--define', 'env=prod,region=us-east']);

  final defaultValues = defaultResults['define'] as List<String>;
  if (defaultValues.length != 2 ||
      defaultValues[0] != 'env=prod' ||
      defaultValues[1] != 'region=us-east') {
    throw StateError(
      'Expected default addMultiOption to split on commas into 2 items, got $defaultValues',
    );
  }

  // Setting splitCommas: false preserves the value as a single item.
  final exactParser = ArgParser()..addMultiOption('define', splitCommas: false);
  final exactResults = exactParser.parse(['--define', 'env=prod,region=us-east']);

  final exactValues = exactResults['define'] as List<String>;
  if (exactValues.length != 1 || exactValues[0] != 'env=prod,region=us-east') {
    throw StateError(
      'Expected splitCommas: false to preserve the comma-containing string as 1 item, got $exactValues',
    );
  }

  // Passing CLI values replaces defaultsTo entirely rather than appending.
  final defaultListParser = ArgParser()
    ..addMultiOption('include', defaultsTo: ['base.dart', 'core.dart']);
  final defaultListResults = defaultListParser.parse(['--include', 'custom.dart']);

  final listValues = defaultListResults['include'] as List<String>;
  if (listValues.length != 1 || listValues[0] != 'custom.dart') {
    throw StateError(
      'Expected CLI options to replace defaultsTo list rather than append, got $listValues',
    );
  }
}

Ursprungs-Seeder

csx-seed