pynest-api 0.5.0

PyNest is a FastAPI Abstraction for building microservices, influenced by NestJS.

PyNest is a Python framework built on top of FastAPI that follows the modular architecture of NestJS

Description

PyNest is designed to help structure your APIs in an intuitive, easy to understand, and enjoyable way.

With PyNest, you can build scalable and maintainable APIs with ease. The framework supports dependency injection, type annotations, decorators, and code generation, making it easy to write clean and testable code.

This framework is not a direct port of NestJS to Python but rather a re-imagining of the framework specifically for Python developers, including backend engineers and ML engineers. It aims to assist them in building better and faster APIs for their data applications.

Getting Started

To get started with PyNest, you'll need to install it using pip:

pip install pynest-api

Start with cli

pynest generate application -n my_app_name

this command will create a new project with the following structure:

├── app.py
├── main.py
├── requirements.txt
├── .gitignore
├── README.md
├── src
│    ├── __init__.py

once you have created your app, get into the folder and run the following command:

cd my_app_name

run the server with the following command:

uvicorn "app:app" --host "0.0.0.0" --port "8000" --reload

Now you can visit OpenAPI in your browser to see the default API documentation.

Adding resources

To add a new module to your application, you can use the pynest generate module command:

pynest generate resource -n users

This will create a new resource called users in your application with the following structure under the src folder:

├── users
│    ├── __init__.py
│    ├── users_controller.py
│    ├── users_service.py
│    ├── users_model.py
│    ├── users_entity.py
│    ├── users_module.py

The users module will immediately register itself with the application and will be available for use.

You can then start defining routes and other application components using decorators and other PyNest constructs.

For more information on how to use PyNest, check out the official documentation at https://pythonnest.github.io/PyNest/.

PyNest CLI Usage Guide

This document provides a guide on how to use the PyNest Command Line Interface (CLI). Below are the available commands and their descriptions:

pynest Command

• Description: The main command group for PyNest CLI.

generate application Subcommand

• Description: Create a new nest app.
• Options:
  • --app-name/-n: The name of the nest app (required).
  • --db-type/-db: The type of the database (optional). You can specify PostgreSQL, MySQL, SQLite, or MongoDB.
  • --is-async: Whether the project should be asynchronous (optional, default is False).

generate command group

• Description: Group command for generating boilerplate code.

resource Subcommand

• Description: Generate a new module (controller, service, entity, model, module).
• Options:
  • --name/-n: The name of the module (required).

CLI Examples

• create a blank nest application - pynest generate application -n my_app_name

• create a nest application with postgres database and async connection - pynest generate application -n my_app_name -db postgresql --is-async

• create new module - pynest generate resource -n users

Key Features

Modular Architecture

PyNest follows the modular architecture of NestJS, which allows for easy separation of concerns and code organization. Each module contains a collection of related controllers, services, and providers.

Dependency Injection

PyNest supports dependency injection, which makes it easy to manage dependencies and write testable code. You can easily inject services and providers into your controllers using decorators.

Decorators

PyNest makes extensive use of decorators to define routes, middleware, and other application components. This helps keep the code concise and easy to read.

Type Annotations

PyNest leverages Python's type annotations to provide better tooling and help prevent errors. You can annotate your controllers, services, and providers with types to make your code more robust.

Code Generation

PyNest includes a code generation tool that can create boilerplate code for modules, controllers, and other components. This saves you time and helps you focus on writing the code that matters.

Future Plans

• Create plugins Marketplace for modules where developers can share their modules and download modules created by others.
• Implement IOC mechanism and introduce Module decorator
• Add support for new databases
• Create out-of-the-box authentication module that can be easily integrated into any application.
• Add support for other testing frameworks and create testing templates.
• Add support for other web frameworks (Litestar, blackship, etc.) - Same Architecture, different engine.

Contributing

Contributions are welcome! Please feel free to grab one of the open issues, or open a new one if you have an idea for a new feature or improvement.

This would bring a huge impact to the project and the community.

Development

This repository uses uv for local development, testing, building, and release automation. As a library project, uv.lock is intentionally ignored and not committed.

uv sync --no-dev --group test
uv run pytest tests

Build and validate the package before publishing:

uv sync --no-dev --group build
uv build --sdist --wheel
uv run twine check dist/*

Docs can be built with:

uv sync --no-dev --group docs
uv run mkdocs build --clean

License

PyNest is MIT licensed.

Credits

PyNest is inspired by NestJS.