confwire

A lightweight, Hydra-inspired alternative for instantiating nested Python objects from Python-style config files, with type-validated construction and precise, path-qualified error messages.

confwire gives you two things:

1. A Config class for loading, composing, and manipulating configuration from Python, YAML, or JSON files — with dict-like access, inheritance, variable substitution, and deprecation warnings.

2. A build_from_config function for turning a "type"-tagged config tree into live Python objects.

Start with the tutorial to learn how configs work, then move on to building objects.

Tutorial

• Installation
  • Requirements
  • Install from PyPI
  • Install from source
• Getting Started
  • What is confwire?
  • A minimal example
  • Next steps
• Config
  • Reserved keys
  • 1. Loading a configuration file
  • 2. Composing configs with _base_
  • 3. Overriding with _delete_
  • 4. Referencing values
  • Next steps
• Building Objects
  • The idea
  • Nested objects
  • Relative type paths
  • From a config file
  • Safety: blocked types
• Advanced Configuration
  • Usage
  • Predefined variables
  • Deprecating a config file
  • Additional notes
  • Next steps

Reference

• API Reference
  • Config
  • build_from_config()
  • confwire.config
  • confwire.build
  • confwire.utils
• Contributing to ConfWire
  • Quick Start
  • Development Workflow
  • Key Guidelines
  • Need Help?
• Changelog
  • [Unreleased]

Indices and tables

• Index

• Module Index

• Search Page