qcload 0.1.0

Priority-based config loader for qdata ecosystem — hunts config.yaml/.env from home dir upward through parent dirs

qcload

Priority-based config loader for qdata ecosystem.

Quick start

from qcload import config, load_config, load_from_path

# Auto-search (global singleton, lazy load)
db_url = config["DATABASE_URL"]

# Functional call (new instance each time)
cfg = load_config()

# Load from specific file path
cfg = load_from_path("/path/to/my/config.yaml")

# Reload the global singleton
config = reload_config()

Search priority

qcload searches for config files in this order (first found wins):

1. ~/config.yaml (user home)
2. ~/.env
3. ./config.yaml (current directory)
4. ./.env
5. ../config.yaml (parent)
6. ../.env
7. ../../config.yaml (grandparent)
8. ../../.env

Config object

cfg = load_config()

# Dict access
cfg["DATABASE_URL"]

# Attribute access (nested yaml)
cfg.database.host

# Type helpers
cfg.get_int("PORT", 8080)
cfg.get_bool("DEBUG", False)
cfg.get_float("RATE", 0.0)
cfg.get_list("HOSTS", [])

# Metadata
cfg.source       # Path to the loaded file
cfg.file_type    # "yaml" or "env"
cfg.is_empty     # True if no keys loaded

License

MIT