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 details)

Uploaded Source

Built Distribution

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

Uploaded Python 3

File details

Details for the file aidoc-0.1.5.tar.gz.

File metadata

  • Download URL: aidoc-0.1.5.tar.gz
  • Upload date:
  • Size: 18.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.8

File hashes

Hashes for aidoc-0.1.5.tar.gz
Algorithm Hash digest
SHA256 b3e3a1fa5bf4cefa0bc8a9b2dceca3ef5216f41df0aa7cbf950ac7b536c343c2
MD5 9d1cae7489d585f4e7d80b9884ebc58b
BLAKE2b-256 ae6f86d4803c5b24b38145742ee2bb74aeb79dcc3eae0b5156882a13474ece36

See more details on using hashes here.

File details

Details for the file aidoc-0.1.5-py3-none-any.whl.

File metadata

  • Download URL: aidoc-0.1.5-py3-none-any.whl
  • Upload date:
  • Size: 18.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.10.8

File hashes

Hashes for aidoc-0.1.5-py3-none-any.whl
Algorithm Hash digest
SHA256 15539ea3756c0c3c36105991f05c04886e93a527d3780dfe766eeedaae09f307
MD5 20b60e0624c2f1b598704de0171b8a39
BLAKE2b-256 154fa45f931773bd3535d38073298741608729c687b3c518d2c330b1c53f3ea0

See more details on using hashes here.

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