Contributing

Contributing

We welcome contributions to txaio! This guide explains how to get involved.

Getting in Touch

Reporting Issues

When reporting issues, please include:

  1. Python version (python --version)

  2. txaio version (python -c "import txaio; print(txaio.__version__)")

  3. Operating system and version

  4. Framework being used (Twisted or asyncio)

  5. Minimal code example reproducing the issue

  6. Full traceback if applicable

Contributing Code

  1. Fork the repository on GitHub

  2. Create a feature branch from master

  3. Make your changes following the code style

  4. Add tests for new functionality

  5. Run the test suite to ensure nothing is broken

  6. Submit a pull request referencing any related issues

Development Setup

git clone https://github.com/crossbario/txaio.git
cd txaio
pip install -e .[dev]

Running Tests

# Run all tests
tox

# Run tests for specific Python version
tox -e py312

Code Style

  • Follow PEP 8

  • Use meaningful variable and function names

  • Add docstrings for public APIs

  • Keep lines under 100 characters

License

By contributing to txaio, you agree that your contributions will be licensed under the MIT License.