Files
kovagoadiandClaude f9eeae39ed
Continuous Integration / lint-and-security (pull_request) Successful in 20s
Continuous Integration / tests-and-coverage (pull_request) Successful in 24s
Merge branch 'main' into claude/silly-lederberg-231f6c
Conflicted only on the README feature list, where main's list_cargo()
bullet and this branch's bridge bullet were added at the same spot. Kept
both: list_cargo() with the other cargo queries, and the bridge one last,
since it is about what all of them run against.

list_cargo() landing also makes tests/test_gamescript.py's command check
meaningful in the other direction -- the bridge has answered list_cargo
all along with nothing sending it, which is exactly the asymmetry that
check tolerates on purpose.

Co-Authored-By: Claude <[email protected]>
2026-08-31 19:12:41 +02:00
..
2026-06-05 23:18:09 +02:00

Internal Package: openttd

This directory contains the core implementation of the OpenTTD network client.

Modules

  • __init__.py: Exposes the high-level OpenTTDClient API.
  • client.py: Implementation of the OpenTTDClient class. Manages the connection lifecycle, PAKE state, map synchronization, and keep-alive.
  • protocol.py: Implementation of the OpenTTDProtocol class. Handles low-level binary packet serialization, AEAD stream encryption, and static packet parsing.

Design Goals

  1. Encapsulation: The user should never need to manually handle bytes or encryption keys.
  2. Robustness: Gracefully handle server errors and unknown packet types.
  3. Efficiency: Use asyncio for non-blocking I/O and monocypher for fast cryptographic operations.