Mountainash Settings

An intelligent textbook for mountainash-settings -- a typed configuration framework for Python applications.

Transitional publishing: This manual remains on the central site until its per-repository cutover.

Open textbook

Chapters

1. Pydantic and Configuration Foundations
2. MountainAsh Base Settings
3. Settings Parameters and Merge Strategies
4. File Handling, Kwargs, and Field Templating
5. Secrets Resolution
6. Connection Profiles
7. Profile Registry and Invariants
8. Authentication System
9. Caching, Settings Management, and App Settings

Key Topics

• Base settings -- MountainAshBaseSettings extending Pydantic BaseSettings with post_init lifecycle, multi-format file loading (YAML, TOML, JSON, .env), and source customization
• Secrets resolution -- two-pass resolution pipeline with pluggable providers for HashiCorp Vault, AWS SSM, and Azure Key Vault
• Connection profiles -- ProfileDescriptor with ParameterSpec, MISSING sentinel, dynamic Pydantic field installation, and @decorator registration pattern
• Authentication system -- AuthSpec base with 10+ concrete auth modes as discriminated union, dispatching to driver-specific kwargs
• Caching and management -- LRU-cached settings retrieval, SettingsManager dictionary store, and runtime overrides via model_copy