39 lines
1.8 KiB
Markdown
39 lines
1.8 KiB
Markdown
# ConfigKit
|
|
|
|
An opinionated Go library for applications that use YAML configuration files.
|
|
|
|
ConfigKit is in early implementation. Its current loader accepts one strict YAML
|
|
source (or explicit defaults-only input), optionally traverses explicit path and glob
|
|
imports, strictly composes their disjoint definitions, applies typed defaults, and
|
|
can overlay one selected fixed profile and check an application schema version. It
|
|
returns detached metadata and safe diagnostics.
|
|
Applications may perform audited defaulting and normalization through a resolver,
|
|
then report domain errors and warnings through read-only semantic validation. Secret
|
|
tags and a path predicate drive deterministic redacted effective YAML. Typed secret
|
|
references resolve environment names before validation, and explicit
|
|
secrets-directory bootstrap is available as a separate startup operation. Explicit
|
|
CLI override records apply above profiles. Value explanation is available through
|
|
detached structured records and deterministic redacted output.
|
|
|
|
```go
|
|
type Config struct {
|
|
Enabled bool `yaml:"enabled"`
|
|
Workers int `yaml:"workers"`
|
|
}
|
|
|
|
func ReadConfig(path string) (Config, error) {
|
|
result, err := configkit.Load[Config](configkit.File(path))
|
|
if err != nil {
|
|
return Config{}, err
|
|
}
|
|
return result.Config, nil
|
|
}
|
|
```
|
|
|
|
The [configuration contract](docs/config.md) describes implemented behavior. The
|
|
[consumer adoption guide](docs/consumers/README.md) provides maintained Narratio-,
|
|
Notarius-, WeatherReporter-, and Seriatim-shaped examples and migration guidance.
|
|
The [initial target design](docs/roadmap/initial.md) describes planned behavior.
|
|
The [implementation plan](docs/roadmap/implementation.md) owns the pending stages.
|
|
See the [development guide](docs/development.md) for repository orientation.
|