Skip to main content

A thoughtful dependency injection framework 💉

Project description

https://img.shields.io/badge/license-public%20domain-ff69b4.svg https://img.shields.io/badge/pypi-v0.3.1-blue.svg

Outline

  1. Overview

  2. Installation

  3. Usage

  4. License

Overview

Nurse is a dependency injection framework with a small API that uses type annotations to manage dependencies in your codebase.

Installation

Nurse is a Python3-only module that you can install via Poetry

poetry add nurse

It can also be installed with pip

pip3 install nurse

Usage

Nurse stores the available dependencies into a service catalog, that needs to be filled-in generally at the startup of your application.

import nurse

# A user defined class that will be used accross your application
class Player:

    @property
    def name(self) -> str:
        return "Leeroy Jenkins"

# Now, add it to nurse service catalog in order to use it later in your application
nurse.serve(Player())

By default, dependencies are referenced by their concrete type, but you can also serve them via one of their parent class.

import nurse

class Animal:
    pass

class AngryAnimal(Animal):

    @property
    def roar(self) -> str:
        return "Grrr! 🦁"

nurse.serve(AngryAnimal(), through=Animal)

Once you filled-in the service catalog with your different components, your can declare them as dependencies to any of your class.

@nurse.inject("player")
class Game:
    player: Player
    enemy: Animal

    def welcome_hero(self):
        print(f"Welcome {self.player.name} !")

    def summon_monster(self):
        print(self.enemy.roar)

Game = Game()
game.welcome_hero()
# Welcome Leeroy Jenkins !
game.summon_monster()
# Grrr! 🦁

Or in any function

@nurse.inject('enemy')
def summon_monster(enemy: Animal):
    print(enemy.roar)

summon_monster()
# Grrr! 🦁

And it works with async function as well !

import asyncio

@nurse.inject('enemy')
async def summon_monster(enemy: Animal):
    print(enemy.roar)

asyncio.run(summon_monster())
# Grrr! 🦁

Finally, you can also retrieve a service without using a decorator

enemy = nurse.get(Animal)
print(enemy.roar)
# Grrr! 🦁

License

Nurse is released into the Public Domain. 🎉

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nurse-0.5.0.tar.gz (4.0 kB view hashes)

Uploaded source

Built Distribution

nurse-0.5.0-py3-none-any.whl (4.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page