Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

Async CRUD API with Zero coding. Easy and fast API framework based on Django-Ninja-Extra, inspired by NestJS-CRUD.

License

NotificationsYou must be signed in to change notification settings

freemindcore/django-api-framework

Repository files navigation

PyPI versionPyPI version

TestCodecovDownloads

PyPI versionPyPI version

Easy CRUD API Framework

  • Zero code for a full CRUD API: Automatic and configurable, inspired byNextJs-Crud.
    • Async CRUD API with Django RBAC security protection
    • Prefetch and retrieve all m2m fields if configured
    • Recursively retrieve all FK/OneToOne fields if configured
    • Excluding fields you do not want, or define a list of sensitive fields of your choice
  • Pure class basedDjango-Ninja APIs: thanks toDjango-Ninja-Extra
  • Domain/Service/Controller Base Structure: for better code organization.
  • Base Permission/Response/Exception Classes: and some handy features to help your API coding easier.
Django-Ninja features:  Easy: Designed to be easy to use and intuitive.  FAST execution: Very high performance thanks to Pydantic and async support.  Fast to code: Type hints and automatic docs lets you focus only on business logic.  Standards-based: Based on the open standards for APIs: OpenAPI (previously known as Swagger) and JSON Schema.  Django friendly: (obviously) has good integration with the Django core and ORM.Plus Extra:  Class Based: Design your APIs in a class based fashion.  Permissions: Protect endpoint(s) at ease with defined permissions and authorizations at route level or controller level.  Dependency Injection: Controller classes supports dependency injection with python Injector or django_injector. Giving you the ability to inject API dependable services to APIController class and utilizing them where needed

Install

pip install django-api-framework

Then add "easy" to your django INSTALLED_APPS:

[    ...,    "easy",    ...,]

Usage

Get all your Django app CRUD APIs up and running in < 1 min

In your Django project next to urls.py create new apis.py file:

from easy.main import EasyAPIapi_admin_v1 = EasyAPI(    urls_namespace="admin_api",    version="v1.0.0",)# Automatic Admin API generationapi_admin_v1.auto_create_admin_controllers()

Go to urls.py and add the following:

from django.urls import pathfrom .apis import api_admin_v1urlpatterns = [    path("admin/", admin.site.urls),    path("api_admin/v1/", api_admin_v1.urls),  # <---------- !]

Now go tohttp://127.0.0.1:8000/api_admin/v1/docs

You will see the automatic interactive API documentation (provided by Swagger UI).Auto generated APIs List

Boilerplate Django project

A boilerplate Django project for quickly getting started, and get production ready easy-apis with 100% test coverage UP and running:https://github.com/freemindcore/django-easy-api

Auto generated APIs - Users

Thanks to your help

If you find this project useful, please give your stars to support this open-source project. :) Thank you !

Advanced Usage

IfCRUD_API_ENABLED_ALL_APPS is set to True (default), all app models CRUD apis will be generated.Apps in theCRUD_API_EXCLUDE_APPS list, will always be excluded.

IfCRUD_API_ENABLED_ALL_APPS is set to False, only apps in theCRUD_API_INCLUDE_APPS list will have CRUD apis generated.

Also, configuration is possible for each model, via APIMeta class:

  • generate_crud: whether to create crud api, default to True
  • model_exclude: fields to be excluded in Schema
  • model_fields: fields to be included in Schema, default to"__all__"
  • model_join: prefetch and retrieve all m2m fields, default to False
  • model_recursive: recursively retrieve FK/OneToOne fields, default to False
  • sensitive_fields: fields to be ignored

Example:

class Category(TestBaseModel):    title = models.CharField(max_length=100)    status = models.PositiveSmallIntegerField(default=1, null=True)    class APIMeta:        generate_crud = True        model_fields = ["field_1", "field_2",] # if not configured default to "__all__"        model_join = True        model_recursive = True        sensitive_fields = ["password", "sensitive_info"]

Adding CRUD APIs to a specific API Controller

By inheritingCrudAPIController class, CRUD APIs can be added to any API controller.Configuration is available viaAPIMeta inner class in your Controller, same as the aboveAPIMeta inner class defined in your Django models.

Example:

@api_controller("event_api", permissions=[AdminSitePermission])class EventAPIController(CrudAPIController):    def __init__(self, service: EventService):        super().__init__(service)    class APIMeta:        model = Event # django model        generate_crud = True # whether to create crud api, default to True        model_fields = ["field_1", "field_2",] # if not configured default to "__all__"        model_join = True        model_recursive = True        sensitive_fields = ["password", "sensitive_info"]

Please check tests/demo_app for more examples.

About

Async CRUD API with Zero coding. Easy and fast API framework based on Django-Ninja-Extra, inspired by NestJS-CRUD.

Topics

Resources

License

Stars

Watchers

Forks


[8]ページ先頭

©2009-2025 Movatter.jp