Skip to main content

Provide an automatic documentation for Django's Apps

Project description

Autodoc-Django

An auto documentation tool for Django's Apps with MermaidJS in MarkDown files.

graph TD
    A[Django developer] --> B{Has docs?};
    B -- Yes --> C[Ship it!];
    B -- No --> D[Use django-autodoc];
    D --> E[Generate docs];
    E --> F[Ship it!];

Installation and Setup

To install Autodoc-Django, run the following command:

pip install autodoc-django

In settings.py file, add autodoc on INSTALLED_APPS constant.

INSTALLED_APPS = [
    ...
    "autodoc",
]

Usage

To generate a Flow Chart documentation for your Django project, use the following command:

python3 manage.py autodoc_flow <app_name>

To generate a Sequence Diagram documentation for your Django project, use the following command:

python3 manage.py autodoc_sequence <app_name>

This will create documentation based on your Django models and views.

Contributing

Contributions to Autodoc-Django are welcome! Please fork the repository and submit a pull request.

License

Autodoc-Django is licensed under the MIT License.

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

autodoc_django-0.1.1.tar.gz (14.8 kB view details)

Uploaded Source

File details

Details for the file autodoc_django-0.1.1.tar.gz.

File metadata

  • Download URL: autodoc_django-0.1.1.tar.gz
  • Upload date:
  • Size: 14.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.1

File hashes

Hashes for autodoc_django-0.1.1.tar.gz
Algorithm Hash digest
SHA256 0d656a1de5d62060d40eb7959a0946954ea4fd14b349458e2f6fcd7ad1693322
MD5 780d9607e72097e41184e45a027e12f4
BLAKE2b-256 da5b63b4f364e6168c77e8cd9d62963f547f5c59bbf335ec4be96220d39df401

See more details on using hashes here.

Supported by

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