Python Django RestFul Admin
Project description
Expose Django's admin as a RESTFUL service
- Support all of restful api
- Auto generat serializers
- Use Django Rest Framework
- Fully customization support
- Using Django Rest Framework ViewSet as AdminModels
- Support default Django auth permission
- Support Django custom model permission with simple configuration
- Using Django Rest Framework Serializer(or ModelSerializer) as request validators
- Support Single Serializer class to customize your detail view
- Auto generate documentation for CURDs
- Pagination and ability to change paginator
- Support custom action with permission
- Support all features in DRF
- Support LogEntry (Log history of objects)
Todo
- Add some documentation
- Add custom route Api documentation
- Add list_display
- Add Filter And Search
- Add exlude
- Add Fields
- Example inline
- Localization
- Somethings that's need in future
How To Install
pip install django-restful-admin
add to INSTALED_APPS
INSTALLED_APPS = [
...
'rest_framework',
'django_restful_admin',
...
]
How To use
you need only add the bellow code to admin.py
in your apps
from django_restful_admin import admin
from yourapp.models improt FisrtModel, ScoundModel
admin.site.register(FisrtModel)
admin.site.register(ScoundModel)
Then add URL to your project urls.py
from django_restful_admin import admin as api_admin
urlpatterns = [
...
path('apiadmin/', api_admin.site.urls),
...
]
Run the project and open URL http://your-ip:port/apiadmin/
enjoy!
Change Log
- export admin in init.py
- Add default django auth permissions support
- Add admin.register decorator
Customization
Example
Create a new Django project
$ django-admin startproject example`
$ cd example
$ python manage.py startapp blog
Create blog app models in blog/models.py
from django.db import models
class Category(models.Model)
title = models.CharField(
max_length=255
)
class Post(models.Model):
title = models.CharField(
max_length=255
)
summery = models.TextField()
description = models.TextField()
category = models.ForeignKey(
Category,
related_name='products',
on_delete=models.CASCADE
)
Add your blog app in INSTALLED_APPS
in example/settings.py
INSTALLED_APPS = [
# Django default apps...
'rest_framework',
'django_restful_admin',
'blog'
]
Add admin URLs to django URLs in example/urls.py
from django.conf.urls import url
from django.contrib import admin
from django_restful_admin import admin as api_admin
from django.urls import path
urlpatterns = [
path('apiadmin/', api_admin.site.urls), # this line added
# path('admin/', admin.site.urls),
# your apis custom must be set here
]
Register your model to restful admin site in blog/admin.py
from django_restful_admin import admin as api_admin
from blog.models import *
api_admin.site.register(Post)
api_admin.site.register(Category)
Add View and use decorators blog/admin.py
...
@api_admin.register(Category, Product)
class MyCustomApiAdmin(BaseRestFulModelAdmin):
authentication_classes = (CustomTokenAuthentication,)
permission_classes = [IsAuthenticated]
...
Read more about authentication and permission DRF Documentation.
Customize serialization
At first, you must define your serializer class
Make serializers.py
file in blog
Open blog/serializers.py
and make serializer like this:
from rest_framework import serializers
from .models import *
class ProductSerializer(serializers.ModelSerializer):
class Meta:
model = Product
feilds = ('id', 'title')
class CategorySerializer(serializers.ModelSerializer):
class Meta:
model = Category
fields = ('id','title)
class SingleProductSerializer(serializers.ModelSerializer):
category = CategorySerializer(read_only=True)
class Meta:
model = Product
feilds = ('id', 'title', 'summery', 'description', 'category')
from .serializers import ProductSerializer, SingleProductSerializer
@api_admin.register(Product)
class ProductApiAdmin(BaseRestFulModelAdmin):
serializer_class = ProductSerializer
single_serializer_class = SingleProductSerializer
serializer_class
use for serialize list of objects but single_serializer_class
use for serializer view signle object, update, partial update and create.
Add a custom route with permission
@api_admin.register(Product)
class MyCustomApiAdmin(BaseRestFulModelAdmin):
@api_admin.action(permission='product.view_product', detail=True, methods=['GET'], url_path=r'my-custom-action/(?P<another_key>[^/.]+)')
def my_custom_action(self, request, pk, another_key):
pass
## Do what you want to do
## this action make url like this /apiadmin/blog/product/2/my-custom-action/XXX
If you want to except permission you just send permission=True, for creating custom permission you can pass closure function or lambda to permission like this permission=lambda: view, action, request, obj=None: True
Contribute
If you think you can help me please let's start.
Project details
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
Hashes for django-restful-admin-1.1.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 742caa614d2338c7adf5afab6ccbcdc2ddef10037f7eee2366f012d2cede61c6 |
|
MD5 | d41594d0584a041e1e2f96d7a869d331 |
|
BLAKE2b-256 | 077534fd81b7f5688b0a7b1f0cdaa28a06f64b2d761b9125e60218199d2c7c64 |
Hashes for django_restful_admin-1.1.3-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0c6c6cdf29c694371087dfc50d5064ba761f32bb573ec65052f2591935e51b47 |
|
MD5 | a145905b384d1d75f51c0d28bfe8b406 |
|
BLAKE2b-256 | 662468d7df3f0146613e9c2983ecabf876dd42fbfb77c9d93db51223f6167197 |