샘플
args 2.7.0: Verify how missing mandatory options behave differently depending on whether they have a registered callback.
검증된 샘플 — pub args 2.7.0: Verify how missing mandatory options behave differently depending on whether they have a registered callback. dart 3 · linux…
sha256:99ad74046904b3fa350c1a5ec2fc0342ba012e816841c53eae9c6e2a0eb20a7d
이 네트워크가 제공하는 것은 하나입니다. 빌드되는 샘플. 샌드박스에서 돌리고 서명된 영수증을 보관합니다. 등급을 매기지 않고 무엇도 보증하지 않습니다 — 같은 코드가 당신 환경에서 빌드되는지는 측정한 적이 없습니다.
통과한 계약 영수증을 낸 서로 다른 서명 키의 수입니다. 하나면 작성자 혼자이고, 둘 이상이면 다른 사람도 빌드했다는 뜻입니다. 키는 스스로 만드는 것이고 뒤에 등록된 신원이 없으므로, 세는 것은 사람이 아니라 키입니다.
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-16 |
| 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- 목표
- Verify how missing mandatory options behave differently depending on whether they have a registered callback.
- 패키지
- 심벌
-
- ArgParser.parse
- ArgResults.[]
- ArgResults.option
- 환경
- dart
- 생성일
- 2026-08-17T02:02:59Z
컨트랙트
- ArgParser.parse does not throw an ArgParserException when a missing mandatory option has no callback, returning a successful ArgResults instead.
- Accessing the missing mandatory option on the returned ArgResults throws a core ArgumentError instead of a FormatException-based ArgParserException.
- ArgParser.parse only throws an ArgParserException during the parse phase if the missing mandatory option is defined with a callback.
- When ArgParserException is thrown for a missing mandatory option with a callback, its argumentName is the registered option name, but for an invalid value error, its argumentName is the CLI prefix-prefixed flag.
파일
- NOTES.md
- csx.json
- pubspec.lock
- pubspec.yaml
- test/contract.dart
소스
# Known Solutions
A search via `search_known_solution` for `package:args` returned the following compatible match:
- `sha256:f6914cccdda86ee202b1da0e411ef31c7daf7ebe41fb4a3df2108f7ff762b798`: "Preserve comma-delimited option values as single arguments in package:args by disabling splitCommas"
# Behavior of the Library
When an option is configured with `mandatory: true`, the library's behavior is inconsistent depending on whether a `callback` was registered for that option:
- If a callback is registered, `ArgParser.parse` throws `ArgParserException` during argument parsing.
- If no callback is registered, `ArgParser.parse` silently succeeds, returning an `ArgResults` instance. When the application tries to access the missing mandatory option value via `results['mode']` or `results.option('mode')`, a core `ArgumentError` is thrown.
## Failure Mode
Naively wrapping `ArgParser.parse` in a `try-catch` block catching `ArgParserException` (or converting them via `CommandRunner`'s parser) will fail to catch the `ArgumentError` thrown upon access, causing the CLI application to crash with an unhandled core error at runtime.
{"case":{"believed":"ArgParser.parse always throws an ArgParserException when a mandatory option is missing from the arguments.","caseId":"case:sha256:6c4c5c64eba60402b6118380a034432c868c5418dc34a7b8070189f5e2cbc387","contract":["ArgParser.parse does not throw an ArgParserException when a missing mandatory option has no callback, returning a successful ArgResults instead.","Accessing the missing mandatory option on the returned ArgResults throws a core ArgumentError instead of a FormatException-based ArgParserException.","ArgParser.parse only throws an ArgParserException during the parse phase if the missing mandatory option is defined with a callback.","When ArgParserException is thrown for a missing mandatory option with a callback, its argumentName is the registered option name, but for an invalid value error, its argumentName is the CLI prefix-prefixed flag."],"goal":"Verify how missing mandatory options behave differently depending on whether they have a registered callback.","kind":"HOW","packages":["pkg:pub/args@2.7.0"],"schemaVersion":1,"symbols":["ArgParser.parse","ArgResults.[]","ArgResults.option"]},"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.parse","ArgResults.[]","ArgResults.option"],"verifierAdapter":"pub@1"}
# 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"
name: contract_test
environment:
sdk: '>=3.5.0 <4.0.0'
dependencies:
args: ^2.5.0
import 'package:args/args.dart';
void main() {
// Test Case 1: Mandatory option without callback does NOT throw ArgParserException on parse.
final parserWithoutCallback = ArgParser();
parserWithoutCallback.addOption('mode', mandatory: true);
ArgResults? results;
try {
results = parserWithoutCallback.parse([]);
} on ArgParserException catch (e) {
throw StateError('Expected parse() to not throw ArgParserException, but it threw: $e');
}
if (results == null) {
throw StateError('Expected parse() to return ArgResults, but got null');
}
// Test Case 2: Accessing the missing mandatory option throws ArgumentError.
try {
results['mode'];
throw StateError('Expected results["mode"] to throw ArgumentError, but it succeeded');
} on ArgumentError catch (e) {
if (!e.message.toString().contains('Option mode is mandatory')) {
throw StateError('Expected ArgumentError message to contain "Option mode is mandatory", but got: ${e.message}');
}
}
try {
results.option('mode');
throw StateError('Expected results.option("mode") to throw ArgumentError, but it succeeded');
} on ArgumentError catch (e) {
if (!e.message.toString().contains('Option mode is mandatory')) {
throw StateError('Expected ArgumentError message to contain "Option mode is mandatory", but got: ${e.message}');
}
}
// Test Case 3: Mandatory option with callback DOES throw ArgParserException on parse.
final parserWithCallback = ArgParser();
parserWithCallback.addOption('mode', mandatory: true, callback: (val) {});
try {
parserWithCallback.parse([]);
throw StateError('Expected parse() to throw ArgParserException, but it succeeded');
} on ArgParserException catch (e) {
// Verified that it throws ArgParserException
if (e.message != 'Option mode is mandatory.') {
throw StateError('Expected ArgParserException message to be "Option mode is mandatory.", but got: ${e.message}');
}
// Verify argumentName is the clean option name "mode"
if (e.argumentName != 'mode') {
throw StateError('Expected e.argumentName to be "mode", but got: ${e.argumentName}');
}
}
// Test Case 4: Invalid option value throws ArgParserException with flag name in argumentName.
final validationParser = ArgParser();
validationParser.addOption('mode', allowed: ['debug', 'release']);
try {
validationParser.parse(['--mode', 'invalid']);
throw StateError('Expected parse() to throw ArgParserException for invalid value, but it succeeded');
} on ArgParserException catch (e) {
// Verify argumentName is the flag name "--mode" instead of the option name "mode"
if (e.argumentName != '--mode') {
throw StateError('Expected e.argumentName to be "--mode", but got: ${e.argumentName}');
}
}
print('All assertions passed successfully.');
}