Skip to main content

A simple CLI tool to generate documentation for your Python projects automatically.

Project description

PyPI

aidoc

aidoc is a command line interface (CLI) tool that uses AI to automatically generate documentation for your code.

Requirements

Installation

  • globally install the package
python3 -m pip install aidoc
  • (recommended) create a virtual environment and install the package
pip install aidoc

Usage

To configure the API key and model for aidoc, run the following command:

aidoc configure

To generate documentation for a source file or directory, run the following command:

aidoc gen <source_file>

You can also specify the following optional arguments:

  • -o or --overwrite: Overwrite existing docstrings
  • -f or --format: Format the entire source file using black (default=True)
  • -pr or --pull-request: Create a pull request with the changes

Examples

Generate docstrings for the main.py file:

aidoc gen main.py

Generate docstrings for all Python files in the src directory and its subdirectories:

aidoc gen src

Generate docstrings and create a pull request with the changes:

aidoc gen main.py -pr

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Acknowledgments

Disclaimer

This project is not affiliated with OpenAI. The OpenAI API and GPT-3 language model are not free. You will need to sign up for a free OpenAI account and create an API key to use this tool.

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

aidoc-0.1.5.tar.gz (18.0 kB view hashes)

Uploaded Source

Built Distribution

aidoc-0.1.5-py3-none-any.whl (18.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page