Providers

Providers are plain python classes that are declared as providers in a Nestipy module.

Services

Let's create a example of service.

Python

from typing import Any

from nestipy.common import Injectable


@Injectable()
class CatsService:
    _cats: list[Any] = []

    def create(self, cat: Any):
        self._cats.append(cat)

    def find_all(self):
        return self._cats

This is how we use it inside controller.

Python

from dataclasses import dataclass
from typing import Annotated
from nestipy.ioc import Inject, Body

from nestipy.common import Controller, Post, Get
from .cats_service import CatsService


@dataclass
class CreateCat:
    name: str


@Controller('cats')
class CatsController:
    _service: Annotated[CatsService, Inject()]

    @Post()
    async def create(self, data: Body[CreateCat]):
        self._service.create(data)

    @Get()
    async def find_all(self):
        return self._service.find_all()

Register provider in module.

Python

from nestipy.common import Module


@Module(
    providers=[
        CatsService
    ],
    controllers=[
        CatsController
    ]
)
class CatsModule:
    pass

Provider can be exported to use by other module.

Python

from nestipy.common import Module


@Module(
    providers=[
        CatsService
    ],
    controllers=[
        CatsController
    ],
    exports=[
        CatsService
    ]
)
class CatsModule:
    pass

Dependency injection

With Nestipy, dependency work in 2 ways:

Inject dependency via property( for class).

Python

@Controller('cats')
class CatsController:
    _service: Annotated[CatsService, Inject()]

Inject dependency via class method.

It work like other dependency method.

Take a look here for an example.

Support us

Nestipy is a project released under the MIT license, meaning it's open source and freely available for use and modification. Its development thrives with the generous contributions of these fantastic individuals.