CodeSampleX

샘플

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

검증된 샘플 — pub args 2.7.0: Preserve comma-delimited option values as single arguments in package:args by disabling splitCommas. dart 3 · linux debian/x64 …

sha256:524c2bfcd735bb3578e69cc3473ac78c127a42d307b69b9af273346500877f1a

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

실행 증거

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

증거 기준
서명된 컨트랙트 통과
검증 영수증
2
빌드한 서명 키
2
선언된 환경 dart linux x64 dart dart pub

검증 실행 환경

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

케이스

HOW
목표
Preserve comma-delimited option values as single arguments in package:args by disabling splitCommas
패키지
심벌
  • ArgParser
  • ArgParser.addMultiOption
  • ArgResults
환경
dart
생성일
2026-08-17T03:53:30Z

컨트랙트

  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

파일

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

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

소스

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

오리진 시더

csx-seed