Skip to main content

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

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

pip_test_swagger-0.1.3.tar.gz (4.1 MB view details)

Uploaded Source

File details

Details for the file pip_test_swagger-0.1.3.tar.gz.

File metadata

File hashes

Hashes for pip_test_swagger-0.1.3.tar.gz
Algorithm Hash digest
SHA256 858e3e36d277790d092aa336f35c4a693fcb65794d84b53c2a3f80d79f4782bf
MD5 e977917e33833e787c0796e307151fe1
BLAKE2b-256 9b7f53830a829a5d964cbd22eb61fa7dbdd714e97414ff77f9359c02459c895e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page