Thank you for your interest in contributing to this project! We welcome bug reports, feature requests, and pull requests.
- Fork the repository and clone your fork locally.
- Install dependencies using uv:
uv sync --all-groups
- Create a new branch for your changes:
git checkout -b my-feature-or-fix
- Make your changes on the feature branch.
- Run the test suite before opening a pull request:
uv run pytest
- Ensure all tests pass and add new tests for any new behavior.
- Push your branch to your fork.
- Open a pull request against the
mainbranch of this repository. - Fill in the pull request template (if present) and describe what your changes do and why.
- A maintainer will review your PR. Please respond to any review comments in a timely manner.
- Once approved, a maintainer will merge your pull request.
Please use the GitHub Issues page to report bugs or request features. When reporting a bug, include:
- A clear description of the problem.
- Steps to reproduce the issue.
- The expected vs. actual behavior.
- Relevant environment information (OS, Python version, package version).
- Follow PEP 8 for Python code.
- Keep commits focused and atomic — one logical change per commit.
- Write clear, descriptive commit messages.
By contributing, you agree that your contributions will be licensed under the same license as this project. See LICENSE for details.