apywire

Lazy object wiring and dependency injection for Python 3.12+

Features

• 🚀 Lazy Loading
• ⚡ Async Support
• 🔒 Thread Safety
• 📦 Code Generation
• 📄 Naturally Configurable
• 🧩 Overlayable
• 🎯 Zero Dependencies

Installation

uv pip install apywire

Quick Example

from apywire import Wiring

spec = {
    "datetime.datetime now": {"year": 2025, "month": 1, "day": 1},
    "MyService service": {"start_time": "{now}"},  # Dependency injection
}

wired = Wiring(spec)
service = wired.service()  # Lazy instantiation + caching

spec is a plain dictionary. It can be written in Python, or come from a config file, apywire doesn't care.

Specs overlay, so a library can ship defaults and a user's config can extend them instead of restating them:

from apywire import Wiring, merge_specs

defaults = {"myapp.Registry registry": {"repos": ["{builtin}"]}}
user = {"registry": {"+repos": ["{my_repo}"]}}  # append, don't replace

wired = Wiring(merge_specs(defaults, user))

Documentation

📚 Full Documentation • Getting Started • API Reference • Examples

Build docs locally:

make docs-serve  # http://127.0.0.1:8000

Development

uv sync --extra dev  # Setup
make all             # Format, lint, test, build

See docs/development.md for guidelines.

License

ISC License - see LICENSES/ISC.txt