Sample
Setting FlagSet.ParseErrorsWhitelist.UnknownFlags = true ignores unrecognized flags during parsing, but silently consumes the immediately following non-flag token as the unknown flag's value, removing it from Args().
sha256:922657434b0768a0eafcdc138f53352c18de04eed8a691e1eba5c1a138954b04
PUBLISHED
L3_CONTRACT_PASS
MIT-0
Execution evidence
Declared environment and signed verification runs are separated so you can see exactly what this sample proves.
Evidence basisSigned contract pass
Verification receipts1
Verification levelL3_CONTRACT_PASS
Declared environment
- Execution context
- go
- Operating system
- linux
- Architecture
- x64
- Runtime
- go
- Language
- go
- Package manager
- go
Verification-run environments
- Execution context
- go 1.26
- Operating system
- linux alpine · musl
- Architecture
- x64
- Runtime
- go 1.26
- Language
- go
- Package manager
- go
- Execution
- container · docker
CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17
Case
- Goal
- Setting FlagSet.ParseErrorsWhitelist.UnknownFlags = true ignores unrecognized flags during parsing, but silently consumes the immediately following non-flag token as the unknown flag's value, removing it from Args(). HOW
- Packages
-
github.com/spf13/pflag 1.0.10
- Environment
- go
- Created
- 2026-08-17T12:00:26Z
Commonly assumed
Enabling ParseErrorsWhitelist.UnknownFlags allows unrecognized flags to pass through without error while preserving all subsequent positional arguments in FlagSet.Args().
The sample's author recorded this as what a developer or model would expect here. The contract below is what actually ran.
Contract
- When ParseErrorsWhitelist.UnknownFlags is true, FlagSet.Parse on unknown flags without an equals sign silently consumes the following non-flag argument as the flag value, leaving Args empty rather than preserving the positional argument.
- When ParseErrorsWhitelist.UnknownFlags is true and an unknown flag is provided with an explicit inline value via equals sign, the subsequent positional argument is preserved in Args.
- When ParseErrorsWhitelist.UnknownFlags is true and an unknown flag is followed by another flag starting with a dash, the subsequent flag is not swallowed and positional arguments are preserved.
- When ParseErrorsWhitelist.UnknownFlags is false by default, FlagSet.Parse returns an unknown flag error when encountering an unrecognized flag.
Files
- NOTES.md
- csx.json
- go.mod
- go.sum
- pflag_config_test.go
Download the source artifact (tar.gz)
Origin Seeder
csx-seed
Verification receipts
- go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9