Metadata-Version: 2.3
Name: autodocify-cli
Version: 0.4.2
Summary: AutoDocify is a command-line interface (CLI) tool designed to automate the generation of project documentation and placeholder test files. Leveraging the power of Large Language Models (LLMs), AutoDocify streamlines your development workflow by creating professional READMEs, basic technical documentation, and a starting point for your testing strategy
License: Proprietary
Keywords: autodoc,documentation,automation,readme,tests,python,cli,llm,ai,developer,productivity,pytest,unittest,devtools
Author: AlexAdedeji
Author-email: alexadedeji15@gmail.com
Requires-Python: >=3.12,<4.0
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 3 - Alpha
Classifier: Programming Language :: Python :: 3.12
Classifier: Environment :: Console
Classifier: Operating System :: OS Independent
Classifier: Topic :: Documentation
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Software Development :: Documentation
Requires-Dist: google-generativeai (>=0.8.3,<0.9.0)
Requires-Dist: halo (>=0.0.31,<0.0.32)
Requires-Dist: openai (>=1.59.6,<2.0.0)
Requires-Dist: pydantic-settings (>=2.7.1,<3.0.0)
Requires-Dist: rich (>=13.9.4,<14.0.0)
Requires-Dist: typer (>=0.15.1,<0.16.0)
Requires-Dist: yaspin (>=3.1.0,<4.0.0)
Project-URL: Homepage, https://github.com/grayStone-Inc/autodocify-cli
Project-URL: Issues, https://github.com/grayStone-Inc/autodocify-cli/issues
Project-URL: Repository, https://github.com/grayStone-Inc/autodocify-cli
Description-Content-Type: text/markdown

# AutoDocify CLI

## Overview

AutoDocify CLI is a command-line tool designed to automate the generation of various project documentation, including READMEs, technical documentation, Swagger specifications, and test files.  Leveraging AI, it streamlines your documentation workflow, saving you valuable time and effort.  It currently supports Gemini, OpenAI, and Bard as language models (LLMs).

[//]: # (This is a comment used for Table of Contents generation)
[TOC]


## Installation Instructions

**Prerequisites:**

* Python 3.8 or higher
* `pip` (Python package installer)

**Installation:**

1. Clone the repository:
   ```bash
   git clone <REPOSITORY_URL>
   cd <PROJECT_NAME>
   ```

2. Install dependencies:
   ```bash
   pip install -r requirements.txt
   ```

3. **Configuration (Optional):**  Set your AI API keys and backend URLs in the `.env` file.  An example `.env` file (`.env.example`) is provided.  You need to replace the placeholder values with your actual keys.


## Usage Guide

The AutoDocify CLI offers several commands to generate different types of documentation.  All commands accept a `base_dir` argument to specify the project directory. If not provided, it defaults to the current working directory.  The `llm` argument allows you to specify the LLM to use ("gemini", "openai", or "bard").

**Basic Usage:**

```bash
autodocify <command> [options]
```

**Available Commands:**

* `greet`:  A simple greeting command.
* `generate-readme`: Generates a README.md file.
* `generate-tests`: Generates test files (currently supports Python's `pytest`).
* `generate-docs`: Generates technical documentation.
* `generate-swagger`: Generates Swagger documentation (JSON or YAML).

**Examples:**

* Generate a README using Gemini:
  ```bash
  autodocify generate-readme --llm gemini --output-file README_gemini.md
  ```

* Generate tests using Bard in a specific directory:
  ```bash
  autodocify generate-tests --base-dir /path/to/my/project --llm bard
  ```

* Generate Swagger documentation as YAML:
  ```bash
  autodocify generate-swagger --format yaml --output-file swagger.yaml
  ```

## Configuration

AutoDocify uses a `.env` file for configuration.  You can customize settings like the backend URL and AI API keys.  Refer to the `.env.example` file for the structure and available options.  Remember to rename `.env.example` to `.env` after setting your configurations.

## Technical Details

* **Programming Language:** Python
* **Framework:** Typer (for CLI), Rich (for console output)
* **Libraries:**  `requests`, `pydantic-settings`, `google.generativeai` (for Gemini), OpenAI Python library (for OpenAI), potentially others depending on LLM support.
* **Architecture:** The CLI interacts with an AI backend service (currently a placeholder, but the structure supports different LLMs) to generate the documentation.


## Contribution Guidelines

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and ensure they are well-documented and tested.
4. Commit your changes with clear commit messages.
5. Submit a pull request.  Please follow our coding standards and ensure your code passes all tests.


## License

This project is licensed under the <LICENSE_NAME> License - see the [LICENSE](LICENSE) file for details.


## FAQs

* **Q: What AI models are supported?**
    * A: Currently, Gemini, OpenAI, and Bard are supported.  Support for more LLMs may be added in future releases.

* **Q: How can I customize the generated documentation?**
    * A: You can customize the output by modifying the prompts templates found in the `prompt_templates` directory, adjusting settings in the `.env` file, or adding arguments to the CLI commands.

* **Q:  What if the AI generation fails?**
    * A: The CLI includes robust error handling.  It will display informative error messages, which often provide hints to help debug the problem. Contact support if you're unable to resolve the issue.


## Support

For support or bug reports, please open an issue on the [GitHub repository](<REPOSITORY_URL>).  For urgent issues, contact <YOUR_EMAIL>


