GenDoc

• Generate a Markdown Documentation file from a Python Repository with DocStrings.
• See an output example here
• Pure 🐍 implementation with no external packages
• Tiny Tech Stack: os, ast, argparse

Installation

Use pip in your terminal to install GenDoc. The commands are listed below:

Use

GenDoc is a CLI based application. After installation, you can call the utility in any terminal application as follows:

• In all of these cases, you should be using cd to set your terminal directory to your project folder - otherwise you'll have to use the --files or --dir commands to specify your Python programs in order to avoid generating documentation for every single .py file on your computer!

You can also use any of the following flags in your terminal to customize your output (optional):

Notes:

• Use either --files or --dir, never both
  • --dir is used to change the directory and then scrape all files within it
  • --files is used to specify specific files to scrape (not the entire directory)
  • If you'd like to scrape specific files in a separate directory, simply use --files with their absolute PATHs
• Anytime a PATH is requested, it does not need to be in the current directory, both relative and absolute PATHs are accepted
• If you'd like to exclude any functions that do not have their own DocString, you can use the --emptyfunc flag and pass in the value 0
• The current default behavior is to exclude any files that do not contain any functions or classes
• Clickable links generated with --fileHeaders might break if you are using a different directory with the --dir flag or placing DOCS.md in a different directory with the --output flag
• If you aren't using markdown-styled DocStrings, passing the --codeFence flag will help auto-emphasize Python keywords, such as str, int, class, etc.

Future Development

GenDoc was developed to be a simple, plug-and-play package. However, due to the level of styling customization required for many projects' documentation, an additional html-based API is being developed so developers can use their own external stylesheets.

PRs are welcome, and please contact Samarth Chitgopekar for any questions, comments, or concerns.

Python DocStrings Generate DocStrings Python Markdown DocStrings DocStrings to Markdown Documentation Generator DocStrings Markdown Elegant Docs Module Doc Generator Pure Python DocString Scraper Python Doc Generator PyPI DocString Generator Markdown Docs API Documentation Generator Package Doc Generator