Skip to content

CHANGELOG.md

Latest commit

 

History

History
95 lines (78 loc) · 4.71 KB

CHANGELOG.md

File metadata and controls

95 lines (78 loc) · 4.71 KB
Raw

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[0.4.0]

Added

  • AutowiredDjangoConfig — a project-wide AppConfig driven by a settings.DJANGO_AUTOWIRED dict. Brings Spring Boot–style auto-discovery to Django: one INSTALLED_APPS entry plus a config dict bootstraps DI for every domain app, no per-app apps.py config required. Supports PACKAGES (explicit list), AUTODISCOVER_PREFIX (filter INSTALLED_APPS by prefix), AUTODISCOVER_SUBPACKAGE (e.g. "adapters" for partial adoption), EXTRA_MODULES as dotted "module:attr" strings, and a STRICT flag for fail-fast scanning.
  • examples/django_autodiscover_demo/ — Spring Boot–style Django demo with multiple bounded contexts, cross-app DI, and a @provides feature flag.
  • strict parameter on container.initialize() and scan_packages() — when True, broken sub-modules raise instead of logging a warning.

0.3.0

Added

  • @provides decorator for conditional/factory-based bindings. Use when the concrete implementation of an interface must be chosen at runtime (feature flags, environment, etc.). Factories support dependency injection via annotated parameters and respect Scope.SINGLETON, TRANSIENT, and THREAD for invocation frequency. Factories are evaluated eagerly at container.initialize(); failures raise the new ProviderResolutionError.
  • ProviderResolutionError exception type for @provides factory failures.
  • All three example apps (Django, FastAPI, Flask) now demo @provides via a GREETER_FORMATTER_STYLE env var that swaps the name formatter at boot.

Changed

  • Lowered minimum Python version to 3.12 (was 3.13).

0.2.0

Fixed

  • container.reset() and the testing fixtures (autowired_container, build_container, container_context) no longer clear the registry. Python caches imported modules, so clearing the registry between tests would strip registrations whose modules were already imported — the next scan_packages() call would then be a no-op and resolution would fail. Registrations now persist for the process lifetime; use container.override() for per-test binding changes.
  • InjectorBackend.override() now rebuilds the injector from scratch with the overrides baked in, instead of creating a child injector. The child injector approach did not affect transitive dependencies of parent-owned singletons, so overrides silently had no effect on deeper graphs.

0.1.0

Added

  • examples/django_demo/, examples/fastapi_demo/, examples/flask_demo/ — minimal projects demonstrating ports/adapters, @injectable, framework integration, and the three testing patterns (pure unit, full wiring, override).
  • django_autowired.inspect module with BindingReport, report(), and renderers for table, tree, json, and mermaid output.
  • python -m django_autowired inspect CLI that scans packages and prints a report of registered @injectable bindings without requiring a running container. Supports --format and --exclude.
  • @injectable decorator with optional bind_to and scope.
  • Scope enum: SINGLETON, TRANSIENT, THREAD.
  • Thread-safe _Registry that detects duplicate interface bindings at decoration time.
  • scan_packages(*paths, exclude_patterns=...) with built-in skips for migrations, tests, test, conftest, factories, fixtures.
  • Global container lifecycle: initialize, get, override, reset, is_initialized.
  • Backend adapters:
    • InjectorBackend (priority) — auto-applies @inject to annotated constructors.
    • LagomBackend — dict-based overrides to work around immutable definitions.
    • WireupBackend — create_sync_container + injectable decorator composition. Scope.THREAD falls back to SINGLETON.
    • DishkaBackend — dynamic Provider synthesis with rebuild-on-override.
  • Integrations:
    • AutowiredAppConfig for Django.
    • autowired_lifespan + Provide for FastAPI.
    • Autowired extension + inject_dep for Flask.
  • Testing utilities: autowired_container fixture, build_container factory, container_context, InMemoryOverrideModule.
  • Typed exceptions: AutowiredError, ContainerNotInitializedError, ContainerAlreadyInitializedError, DuplicateBindingError, BackendNotInstalledError, UnresolvableTypeError.