# 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
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
|