Note

This library is currently in the release candidate stage. The public API is considered stable and is undergoing final validation before the 1.0.0 release.

py-dependency-injection

A dependency injection library for Python - inspired by ASP.NET Core.

Overview

py-dependency-injection provides a lightweight and extensible way to manage dependencies in Python applications. It promotes constructor injection, supports scoped lifetimes, and encourages clean architecture through explicit configuration and testable design.

This library is well-suited for both standalone use in Python applications and as a foundation for frameworks or tools that require structured dependency management.

Key Advantages

• Familiar model – Inspired by ASP.NET Core’s DI system

• Scoped lifetimes – Support for singleton, scoped, and transient registrations

• Explicit injection – Promotes clarity over magic

• Test-friendly – Designed for container isolation and overrides

• Minimalistic – Easy to use, extend, and integrate

You can find the source code for py-dependency-injection in our GitHub repository.

User Guide

• Getting Started
• Introduction
• Installation
• Core Concepts and Features
• Quick Start Overview
• Best Practices
• Where to Go Next?

Examples

• Creating dependency containers
• Registering dependencies with scopes
• Registering with constructor arguments
• Resolving with factory functions
• Registering and using instances
• Registering and resolving with tags
• Using constructor injection
• Using constructor injection with tagged dependencies
• Using method injection

Releases

• Version History

You can find the source code for py-dependency-injection in our GitHub repository.