pieceful 0.3.0

Simple python package to solve dependency injections

Pieceful

Description

Pieceful is a Python package that provides a collection of utility functions for working with dependency injection.

Installation

Install with

pip install pieceful

Features

• TODO

Usage

First perform necessary import:

from typing import Annotated
from pieceful import Piece, PieceFactor, get_piece

Than decorate your dependencies with Piece or PieceFactory decorator and name your dependencies.

class Engine:
    pass

class PowerfulEngine(Engine):
    pass

@PieceFactory("powerful_engine")
def powerful_engine_factory() -> Engine:
    return PowerfulEngine()

class AbstractVehicle:
    pass

@Piece("car")
class Car(AbstractVehicle):
    def __init__(self, engine: Annotated[Engine, "powerful_engine"]):
        self.engine = engine

When components are registered (with decorators in this case) they can be injected to other components (like Engine -> Car) by using typing.Annotated or they can be directly obtained.

car = get_piece("car", Car)