Skip to main content

Generating python documentation made ez.

Project description

ez_pydocs

Description

ez_pydocs allows you to easily generate documentation for all of your python files by just providing it your source directory. It generates the documentation from all doc strings and will render markdown. After it's completed, it provides you markdown to put into your README.

Goals

  • Make documentation generation in python ez.
  • Open source this utility.
  • Expand on some features.

How to run/setup

Installing via source

cd ez_pydocs
pip3 install -e . --user
pip3 install ez_pydocs --user

It's that ez.

Usage

usage: ez_pydocs.py [-h] directory

positional arguments:
  directory   The directory to traverse. Ideally should be in the same
              directory as your README.md

optional arguments:
  -h, --help  show this help message and exit

How to contribute

Fork the current repository and then make the changes that you'd like to said fork. Upon adding features, fixing bugs, or whatever modifications you've made to the project, issue a pull request to this repository containing the changes that you've made and I will evaluate them before taking further action. This process may take anywhere from 3-7 days depending on the scope of the changes made, my schedule, and any other variable factors.

Resources

pydoc-markdown

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

ez_pydocs-0.1.1.tar.gz (3.2 kB view hashes)

Uploaded Source

Built Distribution

ez_pydocs-0.1.1-py3-none-any.whl (3.6 kB view hashes)

Uploaded Python 3

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