# cdervis/sharpconfig architecture

> Architecture diagram of the GitHub repository cdervis/sharpconfig, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/cdervis/sharpconfig
- Repository: https://github.com/cdervis/sharpconfig

## Overview

SharpConfig is a .NET configuration library for reading, modifying, and saving cfg/ini data through files, streams, or strings, in textual or binary form. Its central workflow loads input into a Configuration containing sections and settings, exposes typed values and object mapping for edits, then serializes the configuration back out. The graph also captures conversion, array parsing, comments, and multiline support. Source excerpts establish the main parser, writer, and model relationships; less-visible capabilities are included where documented, without inferring unshown call paths.

Main entry points: [`Src/Configuration.cs`](https://github.com/cdervis/sharpconfig/blob/main/Src/Configuration.cs) (Configuration), [`Src/Section.cs`](https://github.com/cdervis/sharpconfig/blob/main/Src/Section.cs) (Section), [`Src/Setting.cs`](https://github.com/cdervis/sharpconfig/blob/main/Src/Setting.cs) (Setting), [`Src/ConfigurationReader.cs`](https://github.com/cdervis/sharpconfig/blob/main/Src/ConfigurationReader.cs) (Input Reader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_io["Configuration I/O"]
  node_reader["Input Reader"]
  node_writer["Output Writer"]
  node_parser_error["Parser Errors<br/>[ParserException.cs]"]
end

subgraph group_model["Configuration Model"]
  node_config["Configuration<br/>[Configuration.cs]"]
  node_section["Section<br/>[Section.cs]"]
  node_setting["Setting<br/>[Setting.cs]"]
  node_element["Element Comments"]
end

subgraph group_values["Values and Mapping"]
  node_array["Array Enumerator"]
  node_converter_api["Converter API"]
  node_stock["Built-in Converters"]
  node_cast_error["Cast Errors"]
  node_multiline["Multiline Attribute"]
  node_ignore["Ignore Attribute<br/>[IgnoreAttribute.cs]"]
end

node_caller(("Application"))
node_file["Config File or Stream"]

node_caller -->|"uses API"| node_config
node_config -->|"loads through"| node_reader
node_config -->|"saves through"| node_writer
node_file -->|"loads input"| node_config
node_config -->|"writes output"| node_file
node_reader -->|"creates"| node_section
node_reader -->|"creates"| node_setting
node_reader -->|"raises"| node_parser_error
node_writer -->|"serializes"| node_section
node_writer -->|"formats comments"| node_element
node_section -.->|"contains"| node_setting
node_setting -->|"enumerates arrays"| node_array
node_setting -.->|"raises"| node_cast_error
node_config -->|"registers converters"| node_stock
node_stock -->|"implements"| node_converter_api
node_section -.->|"maps attribute"| node_multiline
node_section -.->|"maps attribute"| node_ignore
node_caller -->|"maps objects"| node_section
node_caller -->|"reads typed values"| node_setting

click node_config "https://github.com/cdervis/sharpconfig/blob/main/Src/Configuration.cs"
click node_reader "https://github.com/cdervis/sharpconfig/blob/main/Src/ConfigurationReader.cs"
click node_writer "https://github.com/cdervis/sharpconfig/blob/main/Src/ConfigurationWriter.cs"
click node_section "https://github.com/cdervis/sharpconfig/blob/main/Src/Section.cs"
click node_setting "https://github.com/cdervis/sharpconfig/blob/main/Src/Setting.cs"
click node_element "https://github.com/cdervis/sharpconfig/blob/main/Src/ConfigurationElement.cs"
click node_array "https://github.com/cdervis/sharpconfig/blob/main/Src/SettingArrayEnumerator.cs"
click node_converter_api "https://github.com/cdervis/sharpconfig/blob/main/Src/ITypeStringConverter.cs"
click node_stock "https://github.com/cdervis/sharpconfig/blob/main/Src/StockStringConverters.cs"
click node_parser_error "https://github.com/cdervis/sharpconfig/blob/main/Src/ParserException.cs"
click node_cast_error "https://github.com/cdervis/sharpconfig/blob/main/Src/SettingValueCastException.cs"
click node_multiline "https://github.com/cdervis/sharpconfig/blob/main/Src/MultilineAttribute.cs"
click node_ignore "https://github.com/cdervis/sharpconfig/blob/main/Src/IgnoreAttribute.cs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_reader,node_writer,node_parser_error toneBlue
class node_config,node_section,node_setting,node_element toneAmber
class node_array,node_converter_api,node_stock,node_cast_error,node_multiline,node_ignore toneMint
class node_caller,node_file toneIndigo
```

## Components

### Configuration I/O

- [Input Reader](https://github.com/cdervis/sharpconfig/blob/main/Src/ConfigurationReader.cs): `Src/ConfigurationReader.cs`
- [Output Writer](https://github.com/cdervis/sharpconfig/blob/main/Src/ConfigurationWriter.cs): `Src/ConfigurationWriter.cs`
- [Parser Errors](https://github.com/cdervis/sharpconfig/blob/main/Src/ParserException.cs): `Src/ParserException.cs`

### Configuration Model

- [Configuration](https://github.com/cdervis/sharpconfig/blob/main/Src/Configuration.cs): `Src/Configuration.cs`
- [Section](https://github.com/cdervis/sharpconfig/blob/main/Src/Section.cs): `Src/Section.cs`
- [Setting](https://github.com/cdervis/sharpconfig/blob/main/Src/Setting.cs): `Src/Setting.cs`
- [Element Comments](https://github.com/cdervis/sharpconfig/blob/main/Src/ConfigurationElement.cs): `Src/ConfigurationElement.cs`

### Values and Mapping

- [Array Enumerator](https://github.com/cdervis/sharpconfig/blob/main/Src/SettingArrayEnumerator.cs): `Src/SettingArrayEnumerator.cs`
- [Converter API](https://github.com/cdervis/sharpconfig/blob/main/Src/ITypeStringConverter.cs): `Src/ITypeStringConverter.cs`
- [Built-in Converters](https://github.com/cdervis/sharpconfig/blob/main/Src/StockStringConverters.cs): `Src/StockStringConverters.cs`
- [Cast Errors](https://github.com/cdervis/sharpconfig/blob/main/Src/SettingValueCastException.cs): `Src/SettingValueCastException.cs`
- [Multiline Attribute](https://github.com/cdervis/sharpconfig/blob/main/Src/MultilineAttribute.cs): `Src/MultilineAttribute.cs`
- [Ignore Attribute](https://github.com/cdervis/sharpconfig/blob/main/Src/IgnoreAttribute.cs): `Src/IgnoreAttribute.cs`

### Other components

- **Application**
- **Config File or Stream**

## Connections

- Application → Configuration: uses API (evidence: `README.md`)
- Configuration → Input Reader: loads through (evidence: `Src/Configuration.cs`)
- Configuration → Output Writer: saves through (evidence: `Src/Configuration.cs`)
- Config File or Stream → Configuration: loads input (evidence: `README.md`)
- Configuration → Config File or Stream: writes output (evidence: `README.md`)
- Input Reader → Section: creates (evidence: `Src/ConfigurationReader.cs`)
- Input Reader → Setting: creates (evidence: `Src/ConfigurationReader.cs`)
- Input Reader → Parser Errors: raises (evidence: `Src/ConfigurationReader.cs`)
- Output Writer → Section: serializes (evidence: `Src/ConfigurationWriter.cs`)
- Output Writer → Element Comments: formats comments (evidence: `Src/ConfigurationWriter.cs`)
- Section → Setting: contains (evidence: `Src/Section.cs`)
- Setting → Array Enumerator: enumerates arrays (evidence: `Src/Setting.cs`)
- Setting → Cast Errors: raises (evidence: `Src/Setting.cs`)
- Configuration → Built-in Converters: registers converters (evidence: `Src/Configuration.cs`)
- Built-in Converters → Converter API: implements (evidence: `Src/StockStringConverters.cs`)
- Section → Multiline Attribute: maps attribute (evidence: `Src/Section.cs`)
- Section → Ignore Attribute: maps attribute (evidence: `Src/Section.cs`)
- Application → Section: maps objects (evidence: `README.md`)
- Application → Setting: reads typed values (evidence: `README.md`)
