Refined munch. Provides basic munch functionality (attribute-style access for python dicts) with additional generic typing support and runtime validation.
Also provides a config reader that reads config files into predefined runch models. Say goodbye to config["key"], config.get("key") and runtime errors caused by missing keys!
pip install runchIf you find any bugs, please submit an issue or a pull request at GitHub.
$ python3 -m runch ./etc/base.yaml# Generated from base{.example,}.yaml by runch
# Please be aware that `float` fields might be annotated as `int` due to the lack of type info in the config.
from __future__ import annotations
from typing import List
from pydantic import Field
from runch import RunchModel, RunchConfigReader
class BaseConfigModel(RunchModel):
host: str
port: str
user: str
password: str
base_reader = RunchConfigReader[BaseConfigModel]("base.yaml", config_dir="./etc", config_type="yaml")
base = base_reader.read()
# example:
print(base.config.host, base.config.port) # with awesome intellicode support & runtime validation!
# uncomment the following line to enable the watch_update feature
# _base_reader.enable_feature("watch_update", {"update_interval": 10})$ python -m runch <config_path> [config_ext]Manual:
Usage: python -m runch <config_path> [config_name [config_ext]]
Generate a model definition from a config file.
config_path: path to your config file.
config_name: controls generated variable name and class name.
config_type: content type of your config file. Default is `yaml`.
Example:
python -m runch path/to/my_config.foo
python -m runch path/to/my_config.foo chat_config
python -m runch path/to/my_config.foo chat_config yaml
# Read config from file. ↓ square brackets
example_config_reader = RunchConfigReader[ExampleConfig](
# ^^^^^^^^^^^^^ Config model class name
config_name="config_file_name", # with file extension, but don't include the ".example" part
config_dir="config_dir", # default is os.environ.get("RUNCH_CONFIG_DIR", "./etc")
config_type="yaml" # default is "yaml"
config_encoding="utf-8" # default is "utf-8"
)
example_config = example_config_reader.read() # Or .read_lazy() for lazy loading
print(example_config.config.db_host)$ touch example_config_dir/example_config_file.yamldb_host: localhost
db_port: 5432
db_user: user
db_password: password
db_name: database- YAML
- JSON
- TOML
- arbitrary file formats with custom parser, specified via the
custom_config_parserparam ofRunchConfigReader.__init__(). The custom parser should be a function that takes astr-type file content as its first argument, and returns a parsed dictionary.
from httpx import AsyncClient
from runch import (
RunchModel,
RunchAsyncCustomConfigReader,
)
class TestConfig(RunchModel):
status: str
method: str
async def example_config_loader(config_name: str) -> TestConfig:
"""Load config from a remote source."""
print(f"Loading config from remote source for {config_name=}...")
# Simulate a network request to fetch the config.
async with AsyncClient() as client:
response = await client.get(
f"https://dummyjson.com/test",
headers=headers,
)
response.raise_for_status()
return TestConfig(**response.json())
test_reader = RunchAsyncCustomConfigReader[TestConfig](
config_name="example",
config_loader=example_config_loader,
)
async def main():
test_config = await test_reader.read()
print(test_config.config.status)- configurable auto sync & update.
- optional lazy load & evaluate. Useful for optional configs that may not exist.
- configurable example merging for fast local development.
- read arbitrary file formats from any places (e.g. disk, network, db) with sync reader + custom config parser / async reader + custom config loader.