Contributing to Cellects

How to Report Issues

• File bugs/feature requests on GitHub.

Code Contributions

1. Fork the repository and create a new branch:
   

      git checkout -b feature/new-widget
   

2. Write tests for new features (see tests/).
3. Submit a pull request with a clear description.

Testing

Run Tests

Cellects uses pytest + pytest-cov.
Install test dependencies:

pip install -e ".[test]"

Run the test suite (with coverage enabled by default via pyproject.toml):

pytest

You can access the coverage report with coverage html and open htmlcov/index.html in your browser.

open htmlcov/index.html        # macOS
xdg-open htmlcov/index.html    # Linux
start htmlcov\index.html       # Windows (PowerShell)

Or explicitly:

pytest --cov=src/cellects --cov-report=term-missing

Build Documentation

Install doc dependencies:

pip install -e ".[doc]"

Serve the docs locally:

mkdocs serve

Open http://127.0.0.1:8000 in your browser.