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: MIT](https://img.shields.io/github/license/ocavue/django-doc-view.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.3.tar.gz (3.2 kB view details)

Uploaded Source

File details

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

File metadata

File hashes

Hashes for django_doc_view-0.1.3.tar.gz
Algorithm Hash digest
SHA256 bb2fd15fbac484af9d93636184cf5e209288b18430455da2efeb33e2f122f832
MD5 e0674a67999ca43020a26baeebaf0f0b
BLAKE2b-256 d5857b7f35a75163373cd118ec6365f7f90ad95d15e446f4e060d8762d0e5c7b

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