nestipy-db 0.1.0

Nestipy dababase adapter for edgy

NestipyDB

NestipyDB is the official database module for Nestipy. It is built on top of Edgy and designed to be modular and configurable.

Installation

NestipyDB depends on Edgy. Make sure to follow the Edgy installation guide to set up dependencies for your specific database.

pip install nestipy-db

Usage

First, in your app_module.py, replace the url in DbConfig with your own:

from nestipy.common import Module
from nestipy_db import DbConfig, DbModule

@Module(
    imports=[
        DbModule.for_root(
            DbConfig(url="sqlite:///db.sqlite", models=[])
        ),
        # other modules...
    ]
)
class AppModule:
    ...

To load the config asynchronously, use DbModule.for_root_async:

from typing import Annotated
from nestipy.common import Module
from nestipy.ioc import Inject
from nestipy_config import ConfigModule, ConfigService, ConfigOption
from nestipy_db import DbConfig, DbModule

async def get_db_config(config: Annotated[ConfigService, Inject()]):
    return DbConfig(
        url=config.get("DATABASE_URL"),
        models=[]
    )

@Module(
    imports=[
        ConfigModule.for_root(ConfigOption(), is_global=True),
        DbModule.for_root_async(
            factory=get_db_config,
            inject=[ConfigService]
        ),
        # other modules...
    ]
)
class AppModule:
    ...

Note

Note that, you need to register all of your models inside DbConfig(..., models=[]) or by importing DbModule.for_feature(Model1, Model2) in your current module.

CLI

NestipyDB aliases Edgy CLI commands and adds support for model generation. Instead of using edgy, use:

nestipy run db #follow edgy command

NestipyDB introduces a new model generation command:

nestipy run db new|g|gen|generate model_name module_name

• module_name is optional.
• If omitted, model_name will also be used as the module_name.
• The model will be created inside the specified module, or the module folder will be created if it doesn't exist.

Support

Nestipy is an MIT-licensed open source project. It continues to grow thanks to support from the community. If you'd like to contribute or sponsor, please [read more here].

Stay in Touch

• Author - Tsiresy Mila

License

Nestipy is MIT licensed.