sygaldry 0.5.0

Features

• YAML and TOML configuration with deep-merge includes.

• Interpolation – ${VAR} placeholders resolved from config paths, environment variables, or defaults.

• Component instantiation – _type mappings construct classes, _func mappings import callables.

• References – _ref wires components together by name or dotted attribute path.

• Instance caching – identical specs share instances; named _instance tags give explicit control.

• Safety – no eval, no arbitrary code; imports are by dotted path only.

Installation

pip install sygaldry

Quick start

Define your components in a YAML file:

# config.yaml
db:
  _type: "myapp.db.Database"
  host: "${DB_HOST:-localhost}"
  port: 5432

service:
  _type: "myapp.services.UserService"
  db: { _ref: "db" }

Then load and resolve:

from sygaldry import load

graph = load("config.yaml")
service = graph["service"]   # a fully wired UserService instance

Or use the Artificery class for more control:

from sygaldry import Artificery

factory = Artificery("config.yaml", transient=True)
graph = factory.resolve()

License

MIT