Metadata-Version: 2.3
Name: claude-code-botman
Version: 1.3.0
Summary: A Python wrapper for Claude Code CLI
License: MIT
Keywords: claude,ai,cli,wrapper,anthropic,code-generation,automation,subprocess,bot,mcp,model-context-protocol
Author: Octavio Pavon
Author-email: octavio.pavon@botman-ai.com
Maintainer: Octavio Pavon
Maintainer-email: octavio.pavon@botman-ai.com
Requires-Python: >=3.8
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Software Development :: Code Generators
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: System :: Shells
Classifier: Topic :: Utilities
Provides-Extra: async
Provides-Extra: dev
Provides-Extra: docs
Requires-Dist: aiosubprocess (>=2021.5.3) ; extra == "async"
Requires-Dist: bandit (>=1.7) ; extra == "dev"
Requires-Dist: black (>=23.0) ; extra == "dev"
Requires-Dist: flake8 (>=6.0) ; (python_version >= "3.8.1") and (extra == "dev")
Requires-Dist: isort (>=5.0) ; extra == "dev"
Requires-Dist: mypy (>=1.0) ; extra == "dev"
Requires-Dist: myst-parser (>=0.18) ; extra == "docs"
Requires-Dist: pre-commit (>=3.0) ; extra == "dev"
Requires-Dist: pytest (>=7.0) ; extra == "dev"
Requires-Dist: pytest-asyncio (>=0.21.0) ; extra == "dev"
Requires-Dist: pytest-cov (>=4.0) ; extra == "dev"
Requires-Dist: pytest-mock (>=3.10.0) ; extra == "dev"
Requires-Dist: sphinx (>=5.0) ; extra == "docs"
Requires-Dist: sphinx-autodoc-typehints (>=1.0) ; extra == "docs"
Requires-Dist: sphinx-rtd-theme (>=1.0) ; extra == "docs"
Requires-Dist: typing-extensions (>=4.0.0) ; python_version < "3.9"
Project-URL: Changelog, https://github.com/octavio-pavon/claude-code-botman/blob/main/CHANGELOG.md
Project-URL: Documentation, https://claude-code-botman.readthedocs.io
Project-URL: Homepage, https://github.com/octavio-pavon/claude-code-botman
Project-URL: Issues, https://github.com/octavio-pavon/claude-code-botman/issues
Project-URL: Repository, https://github.com/octavio-pavon/claude-code-botman
Description-Content-Type: text/markdown

# claude-code-botman

A Python wrapper library for the Claude Code CLI that enables programmatic interaction with Claude's coding assistant.

## Overview

claude-code-botman provides a simple Python interface to execute Claude Code commands from your scripts with full subprocess management, configuration handling, and response parsing.

## Installation

```bash
pip install -e .
```

For development:
```bash
pip install -e ".[dev]"
```

## Quick Start

```python
from claude_code_botman import ClaudeCode

# Basic usage
claude = ClaudeCode()
response = claude("Write a hello world function in Python")

# With configuration
claude = ClaudeCode(model="sonnet", timeout=60)
response = claude("Refactor this code for better performance")

# With rules from CLAUDE.md
claude = ClaudeCode(rules="./CLAUDE.md")
response = claude("Follow the project guidelines and add tests")
```

## Features

- **Simple API**: Single method call to execute Claude Code commands
- **Configuration Management**: Flexible config system with environment variable support
- **Response Parsing**: Structured parsing of Claude's responses including file changes and errors
- **Session Management**: Support for conversation continuity
- **Batch Operations**: Process multiple commands efficiently
- **Error Handling**: Comprehensive exception handling with specific error types

## Requirements

- Python 3.7+
- Claude Code CLI installed and configured

## Development

```bash
# Run tests
pytest

# Format code
black claude_code_botman/ tests/ examples/

# Type checking
mypy claude_code_botman/
```

## License

MIT
