Skip to content

Add connector demos and fix WebSocket keepalive handling#31

Merged
jillesvangurp merged 3 commits intomainfrom
gtfs-demo-connector
Apr 2, 2026
Merged

Add connector demos and fix WebSocket keepalive handling#31
jillesvangurp merged 3 commits intomainfrom
gtfs-demo-connector

Conversation

@jillesvangurp
Copy link
Copy Markdown
Contributor

Summary

  • add a reusable local hub demo runtime plus GTFS and OpenSky connector demonstrators
  • add uv-managed Python tooling and NDJSON WebSocket listeners for live validation
  • fix hub WebSocket keepalive handling so active clients are not dropped due to stale read deadlines

Details

  • move the local Dex/Postgres/Mosquitto/hub stack into connectors/local-hub/ with persistent bind-mounted state and dedicated setup docs
  • keep the GTFS demonstrator wired to the shared local-hub runtime
  • add an OpenSky demonstrator with airport fence bootstrap, live aircraft publishing, and listener/alignment scripts
  • document the connector demos in the repository docs
  • refresh WebSocket read deadlines on normal inbound messages
  • add WEBSOCKET_READ_TIMEOUT and WEBSOCKET_PING_INTERVAL configuration for explicit liveness tuning
  • add regression coverage and configuration docs for the keepalive behavior

Validation

  • python3 -m py_compile connectors/opensky/*.py connectors/opensky/scripts/*.py connectors/gtfs/*.py connectors/gtfs/scripts/*.py
  • uv run --project connectors/opensky python connectors/opensky/connector.py --env-file connectors/opensky/.env.local --once
  • live OpenSky validation against the New York area with airport fences and NDJSON capture
  • just bootstrap
  • just generate
  • just check

Closes #30

Refresh read deadlines on normal inbound messages, add dedicated websocket read timeout and ping interval settings, and document the new liveness behavior.\n\nRefs #30
@jillesvangurp jillesvangurp merged commit 9a0e7e7 into main Apr 2, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

WebSocket hub drops active clients because read deadlines are not refreshed on normal messages

1 participant