Contributing

Contributions to ACMEOW are welcome!

Development Setup

  1. Clone the repository:

    git clone https://github.com/miichoow/ACMEOW.git
    cd ACMEOW
    
  2. Create a virtual environment:

    python -m venv .venv
    source .venv/bin/activate  # Linux/macOS
    .venv\Scripts\activate     # Windows
    
  3. Install in development mode:

    pip install -e ".[dev]"
    

Running Tests

pytest

Type Checking

mypy src/acmeow/

Linting

ruff check src/acmeow/

Building Documentation

cd docs
pip install -r requirements.txt
make html

Code Style

  • Follow PEP 8

  • Use type annotations

  • Write docstrings in Google style

  • Keep line length under 100 characters

Pull Requests

  1. Fork the repository

  2. Create a feature branch

  3. Make your changes

  4. Run tests and linting

  5. Submit a pull request

Issues

Report bugs and request features at: https://github.com/miichoow/ACMEOW/issues