Skip to main content

Command Line Tool that quickly generates markdown files from your docstrings

Project description

QuickMD

Python Markdown Documentation Generator

Overview

The Python Markdown Documentation Generator is a utility script that automatically generates Markdown documentation from Python files. It extracts details about functions, classes, methods, type hints, and docstrings, and organizes them into a structured Markdown file. This tool is particularly useful for developers who want to maintain clear and organized documentation for their Python projects without manually writing Markdown files.

Features

  • Automatic Extraction: Automatically extracts function signatures, type hints, and docstrings from Python files.
  • Class and Method Support: Supports documenting classes and their associated methods, grouping them appropriately in the output.
  • Structured Output: Generates well-organized Markdown files, separating functions and classes into different sections.
  • Customizable: Easily modify the script to tailor the output to your specific needs.

Installation

To use the Python Markdown Documentation Generator, simply clone this repository:

pip install QuickMD

Usage

  1. Navigate to cloned directory as above
  2. Get the file path of the python document you wish to generate documentation for.
  3. Run the following script with your desired FILE_PATH
python main.py --path "FILE_PATH"

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

quickmd-0.1.0.tar.gz (3.4 kB view details)

Uploaded Source

Built Distribution

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

QuickMD-0.1.0-py3-none-any.whl (3.8 kB view details)

Uploaded Python 3

File details

Details for the file quickmd-0.1.0.tar.gz.

File metadata

  • Download URL: quickmd-0.1.0.tar.gz
  • Upload date:
  • Size: 3.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for quickmd-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b3032f1d7c84b08e53e40016922951d2ad89373953cd41e90431b1b40a35dff4
MD5 fe51e19dbc03915bbf64adff9eef2f7c
BLAKE2b-256 b2c7022f4874adc6fe7f085d50ae1724e94b7cc307b0810db68adbf8cae4663a

See more details on using hashes here.

File details

Details for the file QuickMD-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: QuickMD-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 3.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.11.9

File hashes

Hashes for QuickMD-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 aeae642dfbfec83fc0e7008963a9cf6e0949ec1da322b407fd7549fc613d924f
MD5 3e7d1df1489db2fa928e19a0b0cda330
BLAKE2b-256 152c975fd79a292d0a1f86706a48423f494d7b4f377c18e3af026d34d072a0b2

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