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 details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

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

Uploaded Python 3

File details

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

File metadata

  • Download URL: ez_pydocs-0.1.1.tar.gz
  • Upload date:
  • Size: 3.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.5

File hashes

Hashes for ez_pydocs-0.1.1.tar.gz
Algorithm Hash digest
SHA256 1c984193cde4e75353dc44ea2234992ef5852a9fb9e1c93d26ea937af541aae0
MD5 25b50635c7be404a1cb220658a5b7e30
BLAKE2b-256 2a111cb5cea0467e8cf7f21bc1968e398325d61541ad89429f278a1a9231100e

See more details on using hashes here.

File details

Details for the file ez_pydocs-0.1.1-py3-none-any.whl.

File metadata

  • Download URL: ez_pydocs-0.1.1-py3-none-any.whl
  • Upload date:
  • Size: 3.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.5

File hashes

Hashes for ez_pydocs-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 53ab293073f5a0d804008f1454ac2394033636d7e54f83bc71a20611af832ef1
MD5 88c5e4a1ba590564fac4b2fe56d65a9c
BLAKE2b-256 0fb52478bec97e7d3a46c4f650dd2decf0b1a219f28db2400abb1c02e2cc9015

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