Skip to main content

The simplest way to document your Django APIs

Project description

# django-doc-view: The simplest way to document your Django APIs

[![license](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/ocavue/django-doc-view/blob/master/LICENSE)
[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/ambv/black)
[![PyPI](https://img.shields.io/pypi/v/django-doc-view.svg)](https://pypi.org/project/django-doc-view)

`django-doc-view` find view's docsting and output them in shell after formatting.

## Installation

```bash
pip3 install django-doc-view
```

## Base Usage

Add `django_doc_view` to your INSTALLED_APPS setting:

```python
# settings.py

INSTALLED_APPS = (
...
'django_doc_view'
)
```

Then you can get the result by doc_view command:

```bash
python3 manage.py doc_view
```

## Example

```python

def index(request):
"""
A example of Function-based view
"""
return HttpResponse("Hello, world. You're at the polls index.")


class User(View):
"""
A example of Class-based view

method:
get
request:
id
"""

def get(self, request, *args, **kwargs):
...
```

```bash

$ python3 manage.py doc_view

## polls/

A example of Function-based view

## polls/user

A example of Class-based view

method:
get
request:
id

```

You can find a runnable example from [here](https://github.com/ocavue/django-doc-view-emample).

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

django_doc_view-0.1.2.tar.gz (3.1 kB view hashes)

Uploaded Source

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