How janecea/argparser works
ArgParser is a declarative .NET CLI parsing library. A consumer defines a BaseArgs type with attributes, creates a parser through the factory, and passes command-line tokens to Parse; the result is a populated typed argument object, or a parsing/help exception. Construction reflects and validates the declaration, then prepares metadata used to couple tokens, parse values, enforce requirements and validators, and assign results. Help generation and the Roslyn attribute-usage analyzer are additional capabilities. Edges reflect the excerpts, SOURCE INDEX references, or README; unsampled analyzer internals and other implementation details are not inferred.
Main entry points: ArgParser.cs Parser entry point · ArgParserFactory.cs Parser factory · PropertyMetadata.cs Property metadata · CoupledArgs.cs Token coupling
Components 18
Declaration and API
- Argument model
src/ArgParser/BaseArgs.cs - Declaration attributes
src/ArgParser/Attributes - Parser factory
src/ArgParser/ArgParserFactory.cs
Configuration metadata
- Class metadata
src/ArgParser/Internal/Metadata/ArgsClassMetadata.cs - Property metadata
src/ArgParser/Internal/Metadata/PropertyMetadata.cs - Configuration validation
src/ArgParser/Internal/Metadata/MetadataValidator.cs - Runtime metadata
src/ArgParser/Internal/Metadata/ProcessedClassMetadata.cs
Parsing runtime
- Parser entry point
src/ArgParser/ArgParser.cs - Parser exceptions
src/ArgParser/Exceptions/CommandLineParsingException.cs - Token coupling
src/ArgParser/Internal/CommandLine/CoupledArgs.cs - CLI conventions
src/ArgParser/Internal/CliStandards.cs - Value conversion
src/ArgParser/Internal/CommandLine/ValueParser.cs - Input validation
src/ArgParser/Internal/CommandLine/CommandLineValidator.cs - Help generation
src/ArgParser/Internal/HelpMessageGenerator.cs
Compile-time analysis
- Attribute usage analyzer
src/analyzers/ArgParser.Analyzers/AttributeUsageAnalyzer.cs - Analyzer contracts
src/analyzers/ArgParser.Analyzers.Abstractions/Abstractions.cs
Other components
- CLI consumer
- Roslyn compiler
Connections 23
- CLI consumer → Argument model: declares
README.md - CLI consumer → Parser factory: creates parser
README.md - Parser factory → Class metadata: reflects type
src/ArgParser/ArgParserFactory.cs - Class metadata → Property metadata: builds properties
src/ArgParser/Internal/Metadata/ArgsClassMetadata.cs - Parser factory → Configuration validation: validates declaration
src/ArgParser/ArgParserFactory.cs - Configuration validation → Property metadata: checks properties
src/ArgParser/Internal/Metadata/MetadataValidator.cs - Parser factory → Runtime metadata: prepares runtime metadata
src/ArgParser/ArgParserFactory.cs - Parser factory → Help generation: configures help
src/ArgParser/ArgParserFactory.cs - CLI consumer → Parser entry point: passes tokens
README.md - Parser entry point → Token coupling: groups tokens
src/ArgParser/ArgParser.cs - Token coupling → Runtime metadata: looks up names
src/ArgParser/Internal/CommandLine/CoupledArgs.cs - Token coupling → CLI conventions: uses conventions
src/ArgParser/Internal/CommandLine/CoupledArgs.cs - Parser entry point → Input validation: checks occurrences
src/ArgParser/ArgParser.cs - Parser entry point → Value conversion: converts values
src/ArgParser/ArgParser.cs - Value conversion → Property metadata: reads type policy
src/ArgParser/Internal/CommandLine/ValueParser.cs - Parser entry point → Runtime metadata: reads parse metadata
src/ArgParser/ArgParser.cs - Parser entry point → Argument model: populates result
src/ArgParser/ArgParser.cs - Parser entry point → Parser exceptions: signals failures
src/ArgParser/ArgParser.cs - Parser entry point → Help generation: returns help
src/ArgParser/ArgParser.cs - Declaration attributes → Class metadata: supplies declarations
src/ArgParser/Internal/Metadata/ArgsClassMetadata.cs - Declaration attributes → Property metadata: supplies property settings
src/ArgParser/Internal/Metadata/PropertyMetadata.cs - Roslyn compiler → Attribute usage analyzer: runs analysis
README.md - Attribute usage analyzer → Analyzer contracts: uses contracts
src/analyzers/ArgParser.Analyzers/AttributeUsageAnalyzer.cs