di-easy 1.0.0

Library for easy dependency injection

Easy-DI: Lightweight Dependency Injection for Python 🚀🚀🚀

Introduction 🎯🔧📌

Easy-DI is a simple yet powerful Python library for dependency injection. It helps you manage dependencies efficiently, promoting modular, reusable, and testable code. With Easy-DI, you can dynamically register and inject dependencies using decorators, making dependency management seamless. ✅✅✅

Key Features ✨🔥💡

• Decorator-based dependency injection for clean and intuitive code
• Dynamic registration and unregistration of dependencies
• Support for various dependency types: functions, classes, objects, and more
• Strict enforcement of string-based dependency IDs
• Grouped dependency injection for better organization
• Supports wildcard injection (group.*) to inject all dependencies from a group as separate elements
• Full compatibility with Python's type hints for type safety

Installation 💻📦⚙️

🚨 Note: Currently, Easy-DI is not available on PyPI due to temporary issues. Please install it directly from GitHub. 🚨

Easy-DI has no external dependencies. You can install it using your preferred package manager:

Using pip (via GitHub) 🐍📌✅

pip install git+https://github.com/AsfhtgkDavid/easy-di.git

Using Poetry (via GitHub) 🎼📌✅

poetry add git+https://github.com/AsfhtgkDavid/easy-di.git

Using uv (via GitHub) ⚡📌✅

uv pip install git+https://github.com/AsfhtgkDavid/easy-di.git

or

uv add git+https://github.com/AsfhtgkDavid/easy-di.git

Usage Guide 📝🚀🔍

Basic Dependency Injection 🏗️🔄🎯

from easy_di import BaseInjector

# Define a class to be used as a dependency
class Service:
    def process(self, arg):
        return f"Processed: {arg}"

# Register an instance of the class as a dependency
BaseInjector.register("service", Service())  # IDs must be strings

# Define a function with dependency injection
@BaseInjector("service")
def my_function(deps, arg):
    return deps["service"].process(arg)

print(my_function("Hello"))  # Output: "Processed: Hello"

Grouped Dependency Injection 🎯🔗📌

from easy_di import GroupInjector

# Register a dependency group with multiple dependencies
GroupInjector.register_dependency_group("services", logger=lambda msg: f"Log: {msg}", config={"debug": True})

# Define a function with grouped injection
@GroupInjector("services.logger", "services.config")
def log_message(deps, message):
    return f"{deps['services.logger'](message)} | Debug: {deps['services.config']['debug']}"

print(log_message("An event occurred"))  # Output: "Log: An event occurred | Debug: True"

Wildcard Group Injection (group.*) 🎯✨🔧

You can inject all dependencies from a group using the group.* pattern. Each dependency in the group will be added as a separate element in deps.

from easy_di import GroupInjector

# Register a dependency group with multiple dependencies
GroupInjector.register_dependency_group("config", host="localhost", port=8080, debug=True)

# Inject all elements of the group as separate entries in `deps`
@GroupInjector("config.*")
def app_settings(deps):
    return f"Host: {deps['config.host']}, Port: {deps['config.port']}, Debug: {deps['config.debug']}"

print(app_settings())  # Output: "Host: localhost, Port: 8080, Debug: True"

API Reference 📚🔍🛠️

BaseInjector ⚙️🔄📌

BaseInjector(dependency_id: str)

Decorator that injects a registered dependency into a function.

BaseInjector.register(dependency_id: str, dependency: Any) -> None

Registers a dependency using a string ID.

BaseInjector.unregister(dependency_id: str) -> None

Unregisters a dependency by its ID.

---

GroupInjector 🔗⚙️📌

GroupInjector(dependency_id: str)

Decorator that injects dependencies from a registered group.

GroupInjector.register_dependency_group(group_id: str, **dependencies: Any) -> None

Registers a dependency group containing multiple dependencies.

GroupInjector.register_dependency(dependency_id: str, dependency: Any, group_id: Optional[str] = None) -> None

Registers a dependency inside an existing group.

GroupInjector.unregister_dependency(dependency_id: str, group_id: Optional[str] = None) -> None

Unregisters a specific dependency from a group.

GroupInjector.unregister_dependency_group(group_id: str) -> None

Unregisters an entire dependency group.

Development & Configuration 🛠️💡🔧

Easy-DI follows PEP8 guidelines and enforces strict type checking with MyPy. The following tools are used in development:

• coverage (test coverage analysis)
• isort (import sorting)
• mypy (static type checking)
• ruff (linting and code formatting)

License 📜✅🔓

Easy-DI is released under the MIT License.

Contributing 🤝📢📌

Contributions are welcome! Feel free to open issues or submit pull requests.

Support & Contact 📩💬📌

For questions or support, please open an issue in the repository.