Skip to main content

llm-autodocs 🧞: Automatically generate docstrings for your codebase using LLMs.

Project description

llm-autodocs 🪄

Overview 🌞

autodocs is a Python-based command-line tool for automatically generating documentation for git-tracked Python files in a project. It leverages LLMs to generate documentation automatically and asynchronously.

Features ⚡️

  • Git Integration: Only selects Python files that are tracked by Git within a specified directory.
  • Custom File Selection: Offers the flexibility to specify files to include or exclude in the documentation process.
  • LLM Support: Currently supports OpenAI gpt models
  • Asynchronous Execution: Improves performance by handling multiple files concurrently.

Quickstart 🚴‍♂️

Install the library:

pip install llm-autodocs

Navigave to your git project and run:

cd my_project/
autodocs --directory .

This will run in the root of your project and include all tracked .py files. By default it uses gpt-3.5-turbo.

You will be prompted to review the files affected before continuing.

Examples

Specify a specific directory:

autodocs --directory ./src

Specify a different openai model (can be any of the gpt-3.5* or gpt-4* patterns):

autodocs --documenter gpt-4

Allow only certain file patterns:

autodocs --allowed-files utils.py data_model.py

Exclude certain file patterns:

autodocs --ignored-files __init__.py

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

llm_autodocs-0.0.6.tar.gz (5.3 kB view details)

Uploaded Source

Built Distribution

llm_autodocs-0.0.6-py3-none-any.whl (6.3 kB view details)

Uploaded Python 3

File details

Details for the file llm_autodocs-0.0.6.tar.gz.

File metadata

  • Download URL: llm_autodocs-0.0.6.tar.gz
  • Upload date:
  • Size: 5.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.13 Linux/6.2.0-1016-azure

File hashes

Hashes for llm_autodocs-0.0.6.tar.gz
Algorithm Hash digest
SHA256 2b00749187c7c4013ffa55a3ebab932ca74ab631592a5e3ad684fd2991ccfab3
MD5 565d155a74f8aff692804c4a6e7949b2
BLAKE2b-256 b7fbf695f91efca4665559111e05377e7d0b1d79a1dc97e6f16dd4769bb4107c

See more details on using hashes here.

File details

Details for the file llm_autodocs-0.0.6-py3-none-any.whl.

File metadata

  • Download URL: llm_autodocs-0.0.6-py3-none-any.whl
  • Upload date:
  • Size: 6.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.7.1 CPython/3.10.13 Linux/6.2.0-1016-azure

File hashes

Hashes for llm_autodocs-0.0.6-py3-none-any.whl
Algorithm Hash digest
SHA256 36b6ec681b0b1e4ec0414151df496e21b33e602d88a9de7d595e4f2eb1ecc4cf
MD5 735b8ba5ee59c738b5303a41a8dcfb27
BLAKE2b-256 3c213f1e1f04a4cbdcd7e3a6d8bcd113cbafd14226b4d240375378d3a5c9954c

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 Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page