gostructor

gostructor documentation

The root README is the quick tour. This directory holds the deeper reference — read a page when you actually need it.

Learn by example

The features/ pages are the guided tour — one capability per page, each with a runnable command and its real output. Start here if you’re new. Every page maps to a self-contained program under examples/ you can go run directly.

#	Feature	Run it
1	Two-tag configuration	go run ./examples/basic
2	Priority = source order	go run ./examples/priority
3	Sources	go run ./examples/filesources
4	Field types	go run ./examples/types
5	Hooks	go run ./examples/hooks
6	Error taxonomy	go run ./examples/errors
7	Observability & masking	go run ./examples/observability
8	Full service config	go run ./examples/webservice

Reference

• configuration.md — the Configure API, WithSources, the full cfg/gos tag grammar, hooks, and logging.
• live-reload.md — Watch, the Watchable interface, WithDebounce/WithValidate, the durable snapshot store, and the live sources (file, git, Consul, etcd, Spring Cloud Config, Vault).
• sources.md — every source in detail (env, default, JSON, INI, YAML, TOML, HOCON, Vault), priority, and writing your own Source.
• field-types.md — every supported field type and the strict conversion rules.
• observability.md — the resolution trace (ConfigureWithReport) and secret masking.
• limitations.md — known limitations and the error taxonomy.
• migration.md — what changed in v1.0 and how to migrate from v0.x.

This site is open source. Improve this page.