- Notifications
You must be signed in to change notification settings - Fork3
Async CRUD API with Zero coding. Easy and fast API framework based on Django-Ninja-Extra, inspired by NestJS-CRUD.
License
freemindcore/django-api-framework
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
- 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
pip install django-api-framework
Then add "easy" to your django INSTALLED_APPS:
[ ..., "easy", ...,]
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).
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
If you find this project useful, please give your stars to support this open-source project. :) Thank you !
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 Truemodel_exclude
: fields to be excluded in Schemamodel_fields
: fields to be included in Schema, default to"__all__"
model_join
: prefetch and retrieve all m2m fields, default to Falsemodel_recursive
: recursively retrieve FK/OneToOne fields, default to Falsesensitive_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"]
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
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Uh oh!
There was an error while loading.Please reload this page.