Django REST Framework + Swagger
Project description
# DRF Swagger
#### Code Based API document builder
# Overview
- Django Rest Framework (DRF)
- Code Based (Serializer to Docs)
- Swagger UI (https://swagger.io/swagger-ui/)
# Example
```python
from django.http import HttpResponse
from django.contrib.auth.models import User
from rest_framework import viewsets, serializers
from drf_swagger import drf_request, drf_response
class ViewSetTest(viewsets.ViewSet):
lookup_field = 'view_set'
@drf_request(RootSerializer)
@drf_response(RootSerializer)
def update(self, request, view_set):
"""
summary: test summary
parameters:
- name: test_param
in: query
type: string
description: Only 'name, in, type' is required
example: test example
required: true
"""
return HttpResponse("!@3123")
class RootSerializer(serializers.ModelSerializer):
id = serializers.CharField(
help_text='user pk: 46887',
required=True
)
class Meta:
model = User
fields = (
'email',
'id'
)
```
![example-img]
# Install
# Quick Start
# Warning
- For security, override SwaggerView and add login
- Will Make login/security setting someday...
[example-img]: https://github.com/koyouhun/drf_swagger/blob/master/img/web.png?raw=true
#### Code Based API document builder
# Overview
- Django Rest Framework (DRF)
- Code Based (Serializer to Docs)
- Swagger UI (https://swagger.io/swagger-ui/)
# Example
```python
from django.http import HttpResponse
from django.contrib.auth.models import User
from rest_framework import viewsets, serializers
from drf_swagger import drf_request, drf_response
class ViewSetTest(viewsets.ViewSet):
lookup_field = 'view_set'
@drf_request(RootSerializer)
@drf_response(RootSerializer)
def update(self, request, view_set):
"""
summary: test summary
parameters:
- name: test_param
in: query
type: string
description: Only 'name, in, type' is required
example: test example
required: true
"""
return HttpResponse("!@3123")
class RootSerializer(serializers.ModelSerializer):
id = serializers.CharField(
help_text='user pk: 46887',
required=True
)
class Meta:
model = User
fields = (
'email',
'id'
)
```
![example-img]
# Install
# Quick Start
# Warning
- For security, override SwaggerView and add login
- Will Make login/security setting someday...
[example-img]: https://github.com/koyouhun/drf_swagger/blob/master/img/web.png?raw=true
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file pip_test_swagger-0.1.3.tar.gz
.
File metadata
- Download URL: pip_test_swagger-0.1.3.tar.gz
- Upload date:
- Size: 4.1 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 858e3e36d277790d092aa336f35c4a693fcb65794d84b53c2a3f80d79f4782bf |
|
MD5 | e977917e33833e787c0796e307151fe1 |
|
BLAKE2b-256 | 9b7f53830a829a5d964cbd22eb61fa7dbdd714e97414ff77f9359c02459c895e |