Contributing

Contributing

We welcome contributions to Autobahn|Python! This guide explains how to get involved.

Getting in Touch

Reporting Issues

When reporting issues, please include:

  1. Python version (python --version)

  2. Autobahn version (python -c "import autobahn; print(autobahn.__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

  7. Network configuration if relevant (proxy, firewall, etc.)

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. Add a changelog entry to docs/changelog.rst for any user-visible change (kept in the PR so the branch is self-contained)

  6. Run the test suite to ensure nothing is broken

  7. Submit a pull request referencing any related issues

Development Setup

git clone https://github.com/crossbario/autobahn-python.git
cd autobahn-python
pip install -e .[dev,twisted,asyncio]

Running Tests

# Run all tests
tox

# Run tests for specific Python version
tox -e py312

# Run specific test file
pytest autobahn/test/test_websocket.py

Code Style

  • Follow PEP 8

  • Use meaningful variable and function names

  • Add docstrings for public APIs

  • Keep lines under 100 characters

  • Use type hints where appropriate

Documentation

  • Documentation uses reStructuredText

  • Build docs locally: cd docs && make html

  • View at docs/_build/html/index.html

Testing Both Frameworks

Autobahn|Python supports both Twisted and asyncio. When contributing:

  • Test changes on both frameworks if applicable

  • Use txaio for framework-agnostic code

  • Don’t break compatibility with either framework

WebSocket Conformance

For WebSocket changes, run the Autobahn|Testsuite:

# See docs/websocket/conformance.rst for details

Versioning

This project uses CalVer with PEP 440 development releases: YY.M.PATCH[.devN] — for example, 26.7.1 for a stable release and 26.7.1.dev1 while in development. Between releases the working tree always carries a .devN suffix.

The version is stored in two files kept in sync — pyproject.toml and src/autobahn/_version.py — and managed with just:

  • just file-version — show the current version (from both files)

  • just bump-dev — bump to the next dev version for the current month (YY.M.1.dev1)

  • just bump-next 26.7.2.dev1 — set a specific next dev version

  • just prep-release — strip the .devN suffix to cut a stable release

Git tags and releases are created by maintainers only.

License

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