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).
[![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)
File details
Details for the file django_doc_view-0.1.3.tar.gz
.
File metadata
- Download URL: django_doc_view-0.1.3.tar.gz
- Upload date:
- Size: 3.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | bb2fd15fbac484af9d93636184cf5e209288b18430455da2efeb33e2f122f832 |
|
MD5 | e0674a67999ca43020a26baeebaf0f0b |
|
BLAKE2b-256 | d5857b7f35a75163373cd118ec6365f7f90ad95d15e446f4e060d8762d0e5c7b |