# 🙌 Handsdown - Python documentation generator
Project description
🙌 Handsdown - Python documentation generator
Python docstring-based documentation generator for lazy perfectionists.
🔬 Features
- 👓 PEP257, Google and RST docstrings support. All of them are converted to a valid markdown.
- 🐈 Github-friendly. Use your local markdown viewer or open docs right on Github
- 📚 Signatures for every class, function and method.
- 🚀 Support for type annotations. Even for the ones from the
__future__
! - 📦 Nice list of all modules in Modules
- 🔎 Gather all scattered
README.md
in submodules to one place - 🚧 Links to source code from every doc section.
- #️⃣ Make links by just adding
module.import.String
to docs. - 💕 Do you love type annotations? Well, you get auto-discovery of related modules for free!
🎉 Usage
💻 From command line
Just go to your favorite project that has lots of docstrings but missing auto-generated docs and let handsdown
do the thing.
cd ~/my/project
# output buolt MD files to docs/*
handsdown
# or provide custom output: output_dir/*
handsdown -o output_dir
# generate docs only for my_module, but no migrations, plz
handsdown my_module --exclude my_module/migrations
Navigate to docs/README.md
to check your new documentation!
🧩 As a module
from handsdown import Generator
from handsdown import PathFinder
repo_path = Path.cwd()
handsdown = Generator(
input_path=repo_path,
output_path=repo_path / 'output',
source_paths=PathFinder(repo_path, "**/*.py").list()
)
# generate all docs at once
handsdown.generate_docs()
# or generate just for one doc
handsdown.generate_doc(repo_path / 'my_module' / 'source.py')
# and generate index.md file
handsdown.generate_index()
🐶 Installation
Install using pip
pip install handsdown
🔧 Development
- Install pipenv
- Run
pipenv install -d
- Use
black
formatter in your IDE
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
handsdown-0.1.3.tar.gz
(19.2 kB
view hashes)
Built Distribution
handsdown-0.1.3-py3-none-any.whl
(29.6 kB
view hashes)
Close
Hashes for handsdown-0.1.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | ccad4096c1c483e02b34b29154613410fbd414b09b43fa23de14d7af7fa79575 |
|
MD5 | c09c4248c0482753c39074cc6174008e |
|
BLAKE2b-256 | 56bdb1169c8c1901ba485755eb979c370eaa51432f5a15ae1688b4ede5a0ce1b |