GitLocker: The Coding Marketplace

Description:

djangoapiframework 0.2.0

Easy CRUD API Framework

Zero code for a full CRUD API: Automatic and configurable, inspired by NextJs-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 based Django-Ninja APIs: thanks to Django-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 EasyAPI

api_admin_v1 = EasyAPI(
urls_namespace="admin_api",
version="v1.0.0",
)

# Automatic Admin API generation
api_admin_v1.auto_create_admin_controllers()

Go to urls.py and add the following:
from django.urls import path
from .apis import api_admin_v1

urlpatterns = [
path("admin/", admin.site.urls),
path("api_admin/v1/", api_admin_v1.urls), # <---------- !
]

Now go to http://127.0.0.1:8000/api_admin/v1/docs
You will see the automatic interactive API documentation (provided by Swagger UI).

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

Thanks to your help
If you find this project useful, please give your stars to support this open-source project. :) Thank you !
Advanced Usage
If CRUD_API_ENABLED_ALL_APPS is set to True (default), all app models CRUD apis will be generated.
Apps in the CRUD_API_EXCLUDE_APPS list, will always be excluded.
If CRUD_API_ENABLED_ALL_APPS is set to False, only apps in the CRUD_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 inheriting CrudAPIController class, CRUD APIs can be added to any API controller.
Configuration is available via APIMeta inner class in your Controller, same as the above APIMeta 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.