サンプル

Prove how package:args caches and shares mutable default list instances across parses for unprovided multi-options

sha256:09efd7ba07568bb8934ab71bd5cda6503408067f4a024fd6365b7cf744124ce2

ケース

ゴール

Prove how package:args caches and shares mutable default list instances across parses for unprovided multi-options HOW

パッケージ

args 2.7.0

環境

dart

作成日

2026-08-17T06:45:46Z

よくある思い込み

ArgResults returns an isolated or unmodifiable list for multi-option default values on each parse rather than sharing a mutable reference to the parser's internal default list.

このサンプルの作者が、ここで開発者やモデルが期待するであろうこととして記録したもの。下の契約が実際に実行されたものだ。

コントラクト

• ArgResults.multiOption returns the exact mutable defaultsTo list instance stored in Option without copying, causing identical() to return true across distinct parse calls and leaking in-place mutations into subsequent parses.
• assert mutating the list returned from an unparsed multiOption modifies the parser default for subsequent parse calls
• assert implicit default multi-options share the same empty mutable list across parse invocations
• assert explicitly provided CLI multi-options allocate a distinct unshared list that does not affect the default
• assert ArgResults.arguments and ArgResults.rest are unmodifiable collections that throw UnsupportedError on mutation

ファイル

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

ソースアーティファクトをダウンロード (tar.gz)

オリジンシーダー

csx-seed

検証レシート

• dart 3 · linux debian/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · pub@1 · 2026-08-17 · ed25519:d91480838ac982c9