Django Ninja Extra
Django Ninja Extra is a powerful extension for Django Ninja that enhances your Django REST API development experience. It introduces class-based views and advanced features while maintaining the high performance and simplicity of Django Ninja. Whether you're building a small API or a large-scale application, Django Ninja Extra provides the tools you need for clean, maintainable, and efficient API development.
Features
Core Features (Inherited from Django Ninja)
- ⚡ High Performance: Built on Pydantic for lightning-fast validation
- 🔄 Async Support: First-class support for async/await operations
- 📝 Type Safety: Comprehensive type hints for better development experience
- 🎯 Django Integration: Seamless integration with Django's ecosystem
- 📚 OpenAPI Support: Automatic API documentation with Swagger/ReDoc
- 🔒 API Throttling: Rate limiting for your API
Extra Features
-
🏗️ Class-Based Controllers:
- Organize related endpoints in controller classes
- Inherit common functionality
- Share dependencies across endpoints
-
🔒 Advanced Permission System (Similar to Django Rest Framework):
- Controller-level permissions
- Route-level permission overrides
- Custom permission classes
-
💉 Dependency Injection:
- Built-in support for Injector
- Compatible with django_injector
- Automatic dependency resolution
-
🔧 Service Layer:
- Injectable services for business logic
- Better separation of concerns
- Reusable components
Requirements
- Python >= 3.6
- Django >= 2.1
- Pydantic >= 1.6
- Django-Ninja >= 0.16.1
Installation
- Install the package:
pip install django-ninja-extra
- Add to INSTALLED_APPS:
INSTALLED_APPS = [
...,
'ninja_extra',
]
Quick Start Guide
1. Basic API Setup
Create api.py in your Django project:
from ninja_extra import NinjaExtraAPI, api_controller, http_get
api = NinjaExtraAPI()
# Function-based endpoint example
@api.get("/hello", tags=['Basic'])
def hello(request, name: str = "World"):
return {"message": f"Hello, {name}!"}
# Class-based controller example
@api_controller('/math', tags=['Math'])
class MathController:
@http_get('/add')
def add(self, a: int, b: int):
"""Add two numbers"""
return {"result": a + b}
@http_get('/multiply')
def multiply(self, a: int, b: int):
"""Multiply two numbers"""
return {"result": a * b}
# Register your controllers
api.register_controllers(MathController)
2. URL Configuration
In urls.py:
from django.urls import path
from .api import api
urlpatterns = [
path("api/", api.urls), # This will mount your API at /api/
]
Advanced Features
Authentication and Permissions
from ninja_extra import api_controller, http_get
from ninja_extra.permissions import IsAuthenticated, PermissionBase
# Custom permission
class IsAdmin(PermissionBase):
def has_permission(self, context):
return context.request.user.is_staff
@api_controller('/admin', tags=['Admin'], permissions=[IsAuthenticated, IsAdmin])
class AdminController:
@http_get('/stats')
def get_stats(self):
return {"status": "admin only data"}
@http_get('/public', permissions=[]) # Override to make public
def public_stats(self):
return {"status": "public data"}
Dependency Injection with Services
from injector import inject
from ninja_extra import api_controller, http_get
# Service class
class UserService:
def get_user_details(self, user_id: int):
return {"user_id": user_id, "status": "active"}
# Controller with dependency injection
@api_controller('/users', tags=['Users'])
class UserController:
def __init__(self, user_service: UserService):
self.user_service = user_service
@http_get('/{user_id}')
def get_user(self, user_id: int):
return self.user_service.get_user_details(user_id)
API Documentation
Access your API's interactive documentation at /api/docs:
Learning Resources
Tutorials
Community and Support
Contributing
We welcome contributions! Here's how you can help:
- Fork the repository
- Create a feature branch
- Write your changes
- Submit a pull request
Please ensure your code follows our coding standards and includes appropriate tests.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Support the Project
- ⭐ Star the repository
- 🐛 Report issues
- 📖 Contribute to documentation
- 🤝 Submit pull requests
DEPRECATION NOTICE
0.22.2
The service attribute in ModelController has been changed from a class object to an instance object. When creating a custom ModelService for a ModelController, you have to specify it as service_type.
This is because services are now injected as dependencies during controller instantiation. Service instantiation is delegated to the injector package, so ensure that any additional dependencies required by your ModelService are properly registered in the dependency injection container.
For more details, please refer to the documentation
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file django_ninja_extra-0.31.7.tar.gz.
File metadata
- Download URL: django_ninja_extra-0.31.7.tar.gz
- Upload date:
- Size: 62.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ad3ab759ed839456ee15bc07c201f2b7fc2ceaedc0fac43841482922c2621dca
|
|
| MD5 |
bda94d3b03086e73d94c3d643571801f
|
|
| BLAKE2b-256 |
f7a1922e1b1ef33f505133971e15d28c46af4feb8ef36ce0d456690c42b803f0
|
File details
Details for the file django_ninja_extra-0.31.7-py3-none-any.whl.
File metadata
- Download URL: django_ninja_extra-0.31.7-py3-none-any.whl
- Upload date:
- Size: 84.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f6e980d9173b3551a3c9a18ce6fea9314c6b2cc6a2e97b48f4ac155a9bcef91a
|
|
| MD5 |
40570529b5dde9f1ec018bbbba293336
|
|
| BLAKE2b-256 |
8a769eff89eecd25c7ccbc5b4e840cd248fb31cdbeca8dad5007be6bcc1976fe
|
