A tool for generating command documentation from Python CLI applications.
Project description
> cmdpedia
cmdpedia_generator is a work-in-progress that aims to make documenting command line applications easier.
Given a Python (Click-only for now) module, it'll parse its docstring and commands to generate a single HTML file that displays this information in a searchable, interactive way.
Features
- Generates a standalone, sharable HTML file
- Search for commands by name or keyword
- View available inputs for a selected command
- Add inputs to customize the command's syntax
- Edit placeholder values in the syntax
- Copy the complete command syntax with selected inputs
Demo
View the cmdpedia for this project's main module.
Additional examples are located in the docs/example_modules folder.
Usage
Once installed, generate a cmdpedia by either importing the module and calling the generate_cmdpedia function, or by running the package as a script.
Contributing
Contributions are welcome! If you find a bug or have an idea for an enhancement, feel free to open an issue or submit a pull request.
Contact
If you have any questions about this project, please feel free to reach out to me at me@derekw.co.
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
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cmdpedia_generator-0.0.1a1.tar.gz.
File metadata
- Download URL: cmdpedia_generator-0.0.1a1.tar.gz
- Upload date:
- Size: 69.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.9.19
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9fc1f75fcfac39ae9d6c133e03d0ecc742bf7bde085bf19dde8889f15239ef92
|
|
| MD5 |
770005c29bca2d1291265d80bd03cba9
|
|
| BLAKE2b-256 |
f5c05bf01b2b5305da574beca63f4c99409eb5d8af74115a1657ee9172f47f78
|
File details
Details for the file cmdpedia_generator-0.0.1a1-py3-none-any.whl.
File metadata
- Download URL: cmdpedia_generator-0.0.1a1-py3-none-any.whl
- Upload date:
- Size: 70.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/5.1.1 CPython/3.9.19
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f44dcbdb1f801a47204ee54006075200c740e0132064301c71ae2b281b7e8a1d
|
|
| MD5 |
9922a4278c356a4734109f2b15d3cc16
|
|
| BLAKE2b-256 |
6ff24bbb4dd8c1e746d42b35388a44264024a545dab1cfcbac20ff6bf68fd789
|