Metadata-Version: 2.4
Name: autodoc_ai
Version: 2.0.2
Summary: AI-powered documentation generation and maintenance tool
Project-URL: Homepage, https://github.com/auraz/autodoc_ai
Project-URL: Bug Tracker, https://github.com/auraz/autodoc_ai/issues
Project-URL: Documentation, https://github.com/auraz/autodoc_ai/wiki
Author-email: Oleksandr Kryklia <kryklia@gmail.com>
License-Expression: MIT
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Software Development :: Documentation
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: <3.13,>=3.10
Requires-Dist: autodoceval-crewai>=0.2.0
Requires-Dist: crewai>=0.121.0
Requires-Dist: openai>=1.75.0
Requires-Dist: rich>=13.9.4
Requires-Dist: tiktoken>=0.9.0
Provides-Extra: dev
Requires-Dist: coverage>=7.0.0; extra == 'dev'
Requires-Dist: pytest>=7.0.0; extra == 'dev'
Requires-Dist: ruff>=0.1.0; extra == 'dev'
Description-Content-Type: text/markdown

# autodoc_ai 🚀

[![PyPI](https://img.shields.io/pypi/v/autodoc_ai)](https://pypi.org/project/autodoc_ai/)
[![License](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
[![Tests](https://github.com/auraz/autodoc_ai/actions/workflows/test.yml/badge.svg)](https://github.com/auraz/autodoc_ai/actions)

**autodoc_ai** is an AI-powered tool designed to automatically generate meaningful commit messages and keep documentation up-to-date. It integrates seamlessly into any repository, ensuring that your README and Wiki documentation remain current and useful.

## Features

- **Smart Commits**: Automatically generate meaningful commit messages derived from git diffs.
- **Auto Documentation**: Effortlessly update README and Wiki documentation based on code changes.
- **Quality Checks**: Utilize CrewAI agents to evaluate and enhance documentation quality.
- **Streamlined Integration**: Execute simple commands for all workflows with ease.

## New Commands Overview

- **`cmp`**: Commit changes using AI-generated messages.
- **`just cm`**: Enriches documentation, commits, and pushes.
- **`just enrich-days <days>`**: Update documentation based on the last `<days>` of commits.
- **`just enrich-release`**: Update documentation based on commits since the last tag.

## Quick Start

Integrate `autodoc_ai` into your repository to keep documentation synchronized:

```bash
# Install globally
pip install autodoc_ai

# Or install from source
git clone https://github.com/auraz/autodoc_ai.git
cd autodoc_ai
just install

# Set your OpenAI API key
export OPENAI_API_KEY="your-key-here"

# Optional: Configure logging and debug mode
export AUTODOC_LOG_LEVEL="DEBUG"  # Enable debug logging
export AUTODOC_DISABLE_CALLBACKS="true"  # Disable CrewAI callbacks if needed

# In your project directory
cd your-project
autodoc_ai  # Automatically enriches your README and Wiki based on staged changes
```

### Additional Configuration Options

- `BASH_COMMIT_COMMAND`: Customize the commit command for your environment.
- `BASH_COMMIT_SHORTCUT`: Set a shortcut for quick access to the commit command.

## Documentation Commands

### Evaluate Documentation Quality

- `just eval README.md`  # Auto-detects as README type
- `just eval wiki/Usage.md`  # Auto-detects wiki page type
- `just eval-all wiki/`  # Evaluate all documentation in the directory

### Evaluate with Custom Criteria

- `just eval-with-prompt README.md "Check for clear installation instructions and examples"`

### Deploy Wiki to GitHub

- `just deploy-wiki`  # Push wiki files to GitHub wiki

## Changelog

Stay informed about recent modifications and new features. Refer to the [Changelog](https://github.com/auraz/autodoc_ai/wiki/Changelog) for updates.

## Documentation

For comprehensive guidance, visit the [GitHub Wiki](https://github.com/auraz/autodoc_ai/wiki):

- [Installation Guide](https://github.com/auraz/autodoc_ai/wiki/Installation)
- [Usage & Commands](https://github.com/auraz/autodoc_ai/wiki/Usage)
- [Configuration](https://github.com/auraz/autodoc_ai/wiki/Configuration)
- [Architecture](https://github.com/auraz/autodoc_ai/wiki/Architecture)

## License

MIT License - see [LICENSE](LICENSE) file for details.

---

This README has been enhanced for clarity and improved navigation, ensuring users can easily locate essential information and commands. The addition of a Changelog section allows users to stay updated on recent changes and new features.
