How vpuzdriak/mapgen works
Mapgen is a .NET compile-time object mapper: users declare mapper methods and configuration, then generated mapping code provides type-safe conversions without runtime reflection. The principal workflow is mapper declaration → configuration parsing and mapping analysis → generated mapper and extension methods; diagnostics and code fixes support correction. The README documents custom, multi-parameter, collection, ignored-member, and enum mapping capabilities. Internal call evidence is limited to the supplied excerpts and SOURCE INDEX, so uncertain generator-stage links are marked dashed.
Main entry points: MappingGenerator.cs Mapping generator · MapperTemplateEngine.cs Mapper template engine · MappingParser.cs Configuration parser · MappingConfigurationMethods.cs Mapping configuration
Components 17
Mapper authoring
- Mapper declaration
src/Mapgen.Analyzer/Mapper/AttributeGenerator.cs - Mapping configuration
src/Mapgen.Analyzer/Mapper/MappingConfigurationMethods.cs
Mapping analysis
- Configuration parser
src/Mapgen.Analyzer/Mapper/MappingParser.cs - Mapping metadata
src/Mapgen.Analyzer/Mapper/Metadata - Mapping strategies
src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs - Type compatibility
src/Mapgen.Analyzer/Mapper/Utils/TypeCompatibilityChecker.cs
Code generation
- Mapping generator
src/Mapgen.Analyzer/Mapper/MappingGenerator.cs - Mapper template engine
src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs - Extension metadata
src/Mapgen.Analyzer/Extensions/ExtensionMethodInfo.cs - Extension generator
src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs - Generated mapper code
- Generated extensions
IDE feedback
- Mapping diagnostics
src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnostic.cs - Diagnostic identifiers
src/Mapgen.Analyzer/Mapper/Diagnostics/DiagnosticIds.cs - Diagnostic reporter
src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnosticsReporter.cs - Code fixes
src/Mapgen.Analyzer/Mapper/CodeFixes
Other components
- Mapper author
Connections 21
- Mapper author → Mapper declaration: declares
- Mapper author → Mapping configuration: configures
- Mapper declaration → Mapping generator: compile-time analysis
- Mapping configuration → Configuration parser: parses calls
src/Mapgen.Analyzer/Mapper/MappingParser.cs - Configuration parser → Mapping metadata: builds metadata
src/Mapgen.Analyzer/Mapper/MappingParser.cs - Configuration parser → Mapping configuration: recognizes methods
src/Mapgen.Analyzer/Mapper/MappingParser.cs - Mapping strategies → Mapping metadata: reads metadata
src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs - Mapping strategies → Type compatibility: checks types
src/Mapgen.Analyzer/Mapper/Strategies/ConstructorMappingStrategy.cs - Mapping generator → Configuration parser: analyzes configuration
- Mapping generator → Mapping strategies: selects mappings
- Mapping generator → Mapper template engine: generates mapper
- Mapper template engine → Mapping metadata: renders metadata
src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs - Mapper template engine → Generated mapper code: emits code
- Mapper template engine → Mapping configuration: renders configuration helpers
src/Mapgen.Analyzer/Mapper/MapperTemplateEngine.cs - Extension generator → Extension metadata: renders methods
src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs - Extension generator → Generated extensions: emits wrappers
src/Mapgen.Analyzer/Extensions/MappingExtensionsTemplateEngine.cs - Mapping generator → Extension generator: generates extensions
- Mapping metadata → Mapping diagnostics: stores diagnostics
src/Mapgen.Analyzer/Mapper/Metadata/MapperMethodMetadata.cs - Mapping diagnostics → Diagnostic identifiers: uses identifiers
src/Mapgen.Analyzer/Mapper/Diagnostics/MapperDiagnostic.cs - Mapping generator → Diagnostic reporter: reports issues
- Code fixes → Diagnostic identifiers: handles diagnostics
src/Mapgen.Analyzer/Mapper/CodeFixes/AmbiguousConstructorCodeFixProvider.cs