How crossbario/autobahn-testsuite works
Autobahn|Testsuite runs WebSocket conformance and robustness checks against client or server implementations, then records and reports outcomes. The main workflow is selecting a test mode and specification in wstest.py, running protocol cases through the fuzzing service, and generating results. The repository also exposes WAMP testing, testee endpoints, echo/broadcast utilities, mass-connect, and wsperf tools. Some auxiliary implementations were not excerpted, so their internal connections are shown only where the README documents them.
Main entry points: wstest.py Mode dispatcher · fuzzing.py WebSocket fuzz runner · wampfuzzing.py WAMP test runner · wampcase.py WAMP case behavior
Components 21
Modes and orchestration
- Mode dispatcher
autobahntestsuite/autobahntestsuite/wstest.py - Test specification
- Testee endpoints
autobahntestsuite/autobahntestsuite/testee.py
WebSocket conformance
- WebSocket fuzz runner
autobahntestsuite/autobahntestsuite/fuzzing.py - Case selection
autobahntestsuite/autobahntestsuite/caseset.py - Protocol case catalog
autobahntestsuite/autobahntestsuite/case/__init__.py - Case behavior
autobahntestsuite/autobahntestsuite/case/case.py - Test results
autobahntestsuite/autobahntestsuite/testrun.py - HTML reports
autobahntestsuite/autobahntestsuite/report.py - Result database
autobahntestsuite/autobahntestsuite/testdb.py
WAMP testing
- WAMP test runner
autobahntestsuite/autobahntestsuite/wampfuzzing.py - WAMP case catalog
autobahntestsuite/autobahntestsuite/wampcase/__init__.py - WAMP case behavior
autobahntestsuite/autobahntestsuite/wampcase/wampcase.py
Developer tools
- Echo server/client
autobahntestsuite/autobahntestsuite/echo.py - Broadcast server
autobahntestsuite/autobahntestsuite/broadcast.py - Mass-connect tool
autobahntestsuite/autobahntestsuite/massconnect.py - wsperf controller
autobahntestsuite/autobahntestsuite/wsperfcontrol.py - wsperf master
autobahntestsuite/autobahntestsuite/wsperfmaster.py
Other components
- Implementer
- WebSocket implementation
- WAMP implementation
Connections 24
- Implementer → Mode dispatcher: selects mode
autobahntestsuite/autobahntestsuite/wstest.py - Mode dispatcher → Test specification: loads configuration
autobahntestsuite/autobahntestsuite/wstest.py - Mode dispatcher → WebSocket fuzz runner: starts fuzzing
autobahntestsuite/autobahntestsuite/wstest.py - WebSocket fuzz runner → Case selection: selects cases
autobahntestsuite/autobahntestsuite/fuzzing.py - Case selection → Protocol case catalog: uses catalog
- Protocol case catalog → Case behavior: inherits behavior
- WebSocket fuzz runner → Case behavior: runs cases
autobahntestsuite/autobahntestsuite/fuzzing.py - WebSocket fuzz runner → WebSocket implementation: tests protocol
- WebSocket fuzz runner → Test results: produces outcomes
- WebSocket fuzz runner → HTML reports: generates reports
autobahntestsuite/autobahntestsuite/fuzzing.py - Test results → Result database: persists results
autobahntestsuite/autobahntestsuite/testdb.py - HTML reports → Result database: reads results
- Mode dispatcher → Testee endpoints: starts testee
autobahntestsuite/autobahntestsuite/wstest.py - Mode dispatcher → WAMP test runner: starts WAMP tests
autobahntestsuite/autobahntestsuite/wstest.py - WAMP test runner → WAMP case catalog: selects cases
- WAMP case catalog → WAMP case behavior: provides cases
autobahntestsuite/autobahntestsuite/wampcase/__init__.py - WAMP test runner → WAMP case behavior: runs cases
- WAMP case behavior → WAMP implementation: tests protocol
- Mode dispatcher → Echo server/client: starts mode
autobahntestsuite/autobahntestsuite/wstest.py - Mode dispatcher → Broadcast server: starts mode
autobahntestsuite/autobahntestsuite/wstest.py - Mode dispatcher → Mass-connect tool: starts mode
autobahntestsuite/autobahntestsuite/wstest.py - Mode dispatcher → wsperf controller: starts controller
autobahntestsuite/autobahntestsuite/wstest.py - Mode dispatcher → wsperf master: starts master
autobahntestsuite/autobahntestsuite/wstest.py - wsperf controller → wsperf master: coordinates performance