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.7.tar.gz (5.3 kB view details)

Uploaded Source

Built Distribution

llm_autodocs-0.0.7-py3-none-any.whl (6.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: llm_autodocs-0.0.7.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.7.tar.gz
Algorithm Hash digest
SHA256 62ec14dbe9f6e4be734799f4f80250f645ef7f15640f85869ccc80a7b60440e0
MD5 0b2390de82b32762d8739196bad1a33b
BLAKE2b-256 0c5a16c3b820f4a321e103868ce82476f7ef4f398a41b57e8daa201e15d715b9

See more details on using hashes here.

File details

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

File metadata

  • Download URL: llm_autodocs-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 6.4 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 831dca466be097a0d7e983bc28ab75ffbd6e040c509ab3f99d0bd45c1387600a
MD5 bbed8ba36413b98f5c95e6712faba8b1
BLAKE2b-256 9c7137a2de222219200b402803dee22fd5fbd02cbbae2a9459fb6f99a9c3bcb5

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