Skip to content

Mountainash Utils Secrets

An intelligent textbook for mountainash-utils-secrets -- unified multi-provider secret management.

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

Open textbook

Chapters

  1. Foundations of Secrets Management
  2. Constants and Type Definitions
  3. The Handler Base Class
  4. Provider Handlers
  5. Factory and Dispatch
  6. Settings and Configuration
  7. Error Handling and the Utils Facade

Key Topics

  • Handler base class -- SecretsHandlerBase abstract class defining the universal handler contract (get, set, delete, list, metadata, versions, validate) with built-in encryption, TTL caching, and retry logic
  • Provider handlers -- five concrete implementations for AWS Secrets Manager, Azure Key Vault, GCP Secret Manager, HashiCorp Vault, and Local Encrypted file storage
  • Factory and dispatch -- SecretsHandlerFactory with spec-driven dispatch via ProviderDescriptor and lazy SDK loading through importlib
  • Constants and types -- seven StrEnum classes defining provider types, authentication methods, encoding formats, rotation policies, and secret metadata types
  • Error handling -- nine-member exception hierarchy from SecretsError base through provider-specific and operation-specific exceptions