Django Rest Framework的元数据生成器
项目描述
安装
pip install -e git+https://github.com/night-crawler/drf-metadata.git@#egg=drf-metadata模型
class Author(models.Model):
name = models.CharField(max_length=255)
birth = models.DateField('birth date')
def __str__(self):
return self.name
class Publisher(models.Model):
name = models.CharField(max_length=255)
state = models.PositiveSmallIntegerField(
'publisher state',
choices=(
(0, 'Active'),
(1, 'Disabled')
),
default=1
)
def __str__(self):
return self.name
class Book(models.Model):
title = models.CharField(max_length=255)
authors = models.ManyToManyField(Author)
publisher = models.ForeignKey(Publisher)用法
from drf_metadata.meta import MetaData, AbstractField, CustomMetadata
class BookMetadata(MetaData):
model = Book
serializers = {
'publisher': PublisherSerializer
}
update_fields = {
'authors': {
'omg': {'lol': 1}
}
}
# skip serialization (don't include model instances to choice field)
dataset_urls = {
'authors': '/author/',
'publisher': '/publisher/',
}
# custom queryset for instance (self has `obj` if you need to filter qs)
def get_authors_queryset(self, field):
return Author.objects.filter(name='author0')
# use custom serializer for field instance(s)
def get_authors_serializer(self, field):
# self.request, self.view, self.obj are available in MetaData instance
return AuthorSerializer
# update field bundle with runtime values
def update_authors_field_meta(field, obj):
return {'new': 1, 'obj': str(obj)}
# use own serializer
def get_publisher_field_meta(field, obj):
return {'new': 1, 'obj': str(obj)}与django-rest-framework一起使用
# or redefine OPTIONS handler
class BookViewSet(viewsets.ReadOnlyModelViewSet):
@list_route()
def describe_book(self, request):
md = metadata.BookMetadata().determine_metadata(request, self)
return Response(md)示例响应
{
"title": "book", "description": "description",
"fields": [
{
"type": "CharField", "max_length": 255,
"name": "title",
"verbose_name": "title",
"help_text": "", "blank": false, "null": false, "editable": true, "required": true},
{
"type": "ForeignKey",
"name": "publisher", "verbose_name": "publisher", "help_text": "",
"blank": false, "null": false, "editable": true, "required": true,
"data": [
{"id": 47, "name": "pub0"},
{"id": 48, "name": "pub1"},
{"id": 49, "name": "pub2"}
]
},
{
"type": "ManyToManyField",
"name": "authors", "verbose_name": "authors", "help_text": "",
"blank": false, "null": false, "editable": true, "required": true,
"data": [
{"id": 37, "name": "author0"},
{"id": 38, "name": "author1"},
{"id": 39, "name": "author2"}
]
}
]
}非模型元数据
class ImpersonateMetadata(CustomMetadata):
title = 'View site as another user'
action_name = 'Impersonate'
fields = (
AbstractField(type='ForeignKey',
name='user_id',
verbose_name='User',
data='/data/',
required=True),
)
# method fields
def get_superfield(self, request):
return {
'name': 'hero',
'super': True
}
def get_lol(self, request):
return {
'name': 'lol',
'super': False
}
# update field `user_id`
def get_field_user_id(self, field_name, request):
return {
'lol': 1
}
下载文件
下载适用于您平台的文件。如果您不确定选择哪个，请了解更多关于安装包的信息。
源分布
drf-metadata-0.1.12.tar.gz (10.0 kB 查看哈希值)
构建分布
drf_metadata-0.1.12-py3-none-any.whl (14.4 kB 查看哈希值)
关闭
drf-metadata-0.1.12.tar.gz的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | dfcd4b0760972be360c012fb7fccd900026be0c752f87ba2a326d1164e62b7e9 |
|
| MD5 | 字符串：d7f4b9ac8e22057b8ab61c5991723031 |
|
| BLAKE2b-256 | 字符串：16b80fe7d0046fd9e6c10715ed9cdb55778fc705bd448d5820312b78cbf1c512 |
关闭
drf_metadata-0.1.12-py3-none-any.whl的哈希值
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 字符串：c3146350e73f69046406a8049b4eb984e384a74eab6be04920a5042b29e57da3 |
|
| MD5 | 字符串：c4f51da7b4830144ae7eae56f51ba529 |
|
| BLAKE2b-256 | 字符串：d65267b560912a97cb2c3cc9585d559771233fc408833fad4d3054582a994a39 |