Skip to main content

LLM-based library to auto-generate docstrings for Python scripts and modules.

Project description

pydocify - LLM-Based Documentation Generator Library for Python Code

Author : Rahul Bhoyar

pydocify is a library that uses a language model (LLM) to generate and add documentation strings (docstrings) for Python scripts, functions, and classes. This is especially useful for maintaining code readability and consistency in projects with minimal documentation.

Features

  • Automatically generates docstrings based on code content.
  • Archives original Python files before documentation is added.
  • Recursively processes all Python files in a specified directory.
  • Supports deleting archive files created during the documentation process.

Installation

Install pydocify with pip:

pip install pydocify

Usage

1. Documenting All Python Files in a Directory

Use the DirectoryStringGenerator class to recursively document all Python files in a specified directory:

from pydocify.core import DirectoryStringGenerator

doc_generator = DirectoryStringGenerator()
doc_generator.generate("/path/to/your/directory")

2. Deleting Archive Files during documentation process

Use delete_archives to remove any archive files created during the documentation process:

doc_generator.delete_archives("/path/to/your/directory")

Requirements

Ensure that you have your OPENAI_API_KEY set up as an environment variable in a .env file.

License

pydocify is licensed under the MIT License.

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

pydocify-0.1.7.tar.gz (5.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pydocify-0.1.7-py3-none-any.whl (5.2 kB view details)

Uploaded Python 3

File details

Details for the file pydocify-0.1.7.tar.gz.

File metadata

  • Download URL: pydocify-0.1.7.tar.gz
  • Upload date:
  • Size: 5.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.8rc1

File hashes

Hashes for pydocify-0.1.7.tar.gz
Algorithm Hash digest
SHA256 9ee383386d4f7444d002a3f1f55102111ae0e337779c88bf8b50ed22f8ec4659
MD5 5beabd498a8fdfcdea85712a125d9d8f
BLAKE2b-256 d3b7fc1bfb8339471727a750a5ecd2c71ec8eeceb34586040968dc1f6e81b174

See more details on using hashes here.

File details

Details for the file pydocify-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: pydocify-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 5.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.1.1 CPython/3.8.8rc1

File hashes

Hashes for pydocify-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 cb46702b4a4dfb656001526b9c5fefd2df9b6813b67e794ed5c420e8a058b134
MD5 7c4059549dc69891e2dfe631000ad2f0
BLAKE2b-256 ecc0d2f651f0b03e6a5e13387915d6b1cfe9f5e8774c4a8a494f08ed4fa75f74

See more details on using hashes here.

Supported by

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