Define architecture & package structure

[NuwanJ]

Define the overall architecture and package structure for the Python port of the robot library. Determine the module layout and naming (e.g., robotlib/mqtt_client.py, sensors/, communication/, helpers/, indicators/). Decide whether to use synchronous or asynchronous MQTT clients and how the event loop will be implemented. Create a design document or wiki page summarizing the decisions.

[NuwanJ]

robot-library-python/
├─ .github/workflows/         # CI configurations (pytest, flake8, build)
├─ docs/                      # Documentation (e.g., Sphinx or MkDocs)
├─ examples/                  # Example scripts demonstrating robot usage
├─ pyproject.toml             # Build configuration (see §4)
├─ README.md                  # Project overview and usage instructions
├─ LICENSE                    # License file (e.g., MIT)
├─ src/
│   └─ robot/              # Top‑level Python package (choose a unique name)
│      ├─ __init__.py         # Export high‑level API
│      ├─ mqtt_client.py      # MQTT wrapper similar to `RobotMqttClient`:contentReference[oaicite:16]{index=16}
│      ├─ robot_base.py       # Base `Robot` class (constructor, setup, loop, run loop):contentReference[oaicite:17]{index=17}
│      ├─ motion.py           # `MotionController` equivalent with movement algorithms:contentReference[oaicite:18]{index=18}
│      ├─ sensors/
│      │   ├─ __init__.py
│      │   ├─ distance.py     # `DistanceSensor` – subscription and `get_distance()`:contentReference[oaicite:19]{index=19}:contentReference[oaicite:20]{index=20}
│      │   ├─ proximity.py    # `ProximitySensor`
│      │   └─ color.py        # `ColorSensor`
│      ├─ communication/
│      │   ├─ __init__.py
│      │   ├─ simple_comm.py  # `SimpleCommunication`
│      │   └─ directed_comm.py
│      ├─ helpers/
│      │   ├─ __init__.py
│      │   ├─ coordinate.py   # Track and publish x, y, heading
│      │   └─ robot_mqtt.py   # `RobotMQTT` helper:contentReference[oaicite:21]{index=21}
│      └─ indicators/
│          ├─ __init__.py
│          └─ neopixel.py     # Control NeoPixel or LED outputs
└─ tests/
    ├─ __init__.py
    └─ test_motion.py         # Example unit test using pytest