pavalso / potage

A simple Python package that provides an easy way to use Dependency Injection in your projects.

pypotage

A simple Python package that provides an easy way to use Dependency Injection in your projects.

Key Features

• Easy to use
• Supports both function and class-based dependency injection
• Allows customizing the way dependencies are resolved
• Allows for the use of custom containers

Installing

To install the latest pypotage version, run the following command:

python -m pip install -U pypotage

Development

To install the development version:

git clone https://github.com/pavalso/potage.git
cd potage
python -m pip install -U .

Quick Examples

Basic usage

import pypotage
import logging

@pypotage.prepare
def logger():
    logging.basicConfig(level=logging.DEBUG)
    return logging.getLogger(__name__)

pypotage.cook(logging.Logger).take_out().info("Hello World!")

Using classes

import pypotage

class A:
    def __init__(self):
        ...

@pypotage.prepare
class B(A):
    def __init__(self):
        ...

pypotage.cook(A).take_out()  # returns an instance of B

potage's Issues

Enable disabling ingredient cache for specific ingredients

Generic types dont support inheritance when a type is specified

Split Pot responsabilities into new specialized classes

Multiple inheritance not supported

pypotage release raises import error

Generic multiple inheritance throws ingredient not found when cooking parent2

@pypotage.prepare
class SpecificChild(Parent1[int], Parent2[str]):
pass

pypotage.cook(Parent2[str]).take_out() <-- Raises RuntimeError

GenericChef._modify_formula:
...
elif hasattr(formula._type, "orig_bases"):
generic_type = formula._type.orig_bases[0].args <--- Just Parent1 is taken into account
formula.extra["generic_type"] = generic_type
...

Prepare proyect for release

• #25
• #26
• #39
• #41

Cooking raises "TypeError: unbound method type.__subclasses__() needs an argument" when ingredient is abc.ABCMeta

Create Advanced Usage guide (Becoming a Master Chef)

Document public package API interface

Make an ingredientProxy that redirects all calls to the referenced object

Create proyect documentation

Find a more understandable way for the flow of all Chefs, IngredientProxy and Ingredients.

Allow cook function to return a list of all available ingredients of a type

Implement ChefLine for prepare pot method, to enable further customization for specific types

Make IngredientProxies and Chefs inherit from Decorable

Python 3.9 TypeError: dataclass() got an unexpected keyword argument 'kw_only'

Reorganize the project to make it more intuitive

Create proyect README

Add decorators for ingredients arguments

@pypotage.prepare
@pypotage.lazy
@pypotage.primary
@pypotage.order(...)
...

Allow for an ingredient to be prepared whitout ever calling the attached function, returning it