Added missing tests and more examples.

Author: donework

examples/custom_color.py

@@ -0,0 +1,60 @@
+"""
+Custom RGB colors: shows that Color() accepts arbitrary r/g/b values (0–255).
+
+Two drones cycle through a warm sunset palette built from custom colors that
+have no named preset in flaight — demonstrating that the LED is not limited
+to the built-in constants.
+
+Usage:
+    python examples/custom_color.py            # dry-run (instant)
+    python examples/custom_color.py --realtime # dry-run, real-time pacing
+    python examples/custom_color.py --fly      # real hardware
+"""
+from flaight import Color, FadeColor, Hover, Land, SetColor, Show, Takeoff
+
+URIS = [
+    "radio://0/80/2M/E7E7E7E7E7",
+    "radio://0/81/2M/E7E7E7E7E7",
+]
+
+# Custom palette — none of these are named presets
+SUNSET = [
+    Color(r=255, g=20,  b=0),    # deep red
+    Color(r=255, g=80,  b=10),   # burnt orange
+    Color(r=255, g=140, b=0),    # dark amber
+    Color(r=255, g=200, b=30),   # golden yellow
+    Color(r=255, g=120, b=60),   # peach
+    Color(r=200, g=40,  b=80),   # crimson rose
+    Color(r=120, g=0,   b=60),   # deep violet
+]
+
+FADE = 1.8   # seconds per color transition
+HOLD = 0.4   # seconds to hold between fades
+
+show = Show()
+d1 = show.add_drone("cf1", uri=URIS[0])
+d2 = show.add_drone("cf2", uri=URIS[1])
+
+for drone, offset in ((d1, 0.0), (d2, FADE + HOLD)):
+    drone.at(0.0, Takeoff(height=1.0, duration=2.0))
+    drone.at(0.0, SetColor(Color.OFF))
+
+    total = FADE * len(SUNSET) + HOLD * (len(SUNSET) - 1)
+    drone.at(2.5, Hover(duration=total + offset))
+
+    t = 2.5 + offset
+    for color in SUNSET:
+        drone.at(t, FadeColor(color=color, duration=FADE))
+        t += FADE + HOLD
+
+    drone.at(t, FadeColor(color=Color.OFF, duration=FADE))
+    drone.at(t + FADE, Land(duration=2.0))
+
+if __name__ == "__main__":
+    import sys
+    if "--fly" in sys.argv:
+        from flaight import FlightRunner
+        FlightRunner(show).run()
+    else:
+        from flaight import DryRunRunner
+        DryRunRunner(show, realtime="--realtime" in sys.argv).run()

examples/export_script.py

@@ -0,0 +1,53 @@
+"""
+Export demo: build a show programmatically, then render it as a standalone script.
+
+Two export helpers are shown:
+  - to_script(show)  → returns the script as a string (useful for previewing)
+  - save_script(show) → writes it to ai_generated/ and returns the path
+
+The exported script is self-contained and can be run directly with Python.
+
+Usage:
+    python examples/export_script.py
+"""
+from flaight import Color, FadeColor, Hover, Land, MoveTo, SetColor, Show, Takeoff, save_script, to_script
+
+URIS = [
+    "radio://0/80/2M/E7E7E7E7E7",
+    "radio://0/81/2M/E7E7E7E7E7",
+]
+
+
+def build_show() -> Show:
+    show = Show()
+    d1 = show.add_drone("cf1", uri=URIS[0])
+    d2 = show.add_drone("cf2", uri=URIS[1])
+
+    d1.at(0.0, Takeoff(height=1.0, duration=2.0))
+    d1.at(0.0, SetColor(Color.GREEN))
+    d1.at(2.5, MoveTo(x=-0.5, y=0.0, z=1.2, duration=2.0))
+    d1.at(4.5, FadeColor(color=Color.CYAN, duration=1.5))
+    d1.at(6.0, Hover(duration=1.5))
+    d1.at(7.5, Land(duration=2.0))
+    d1.at(7.5, SetColor(Color.OFF))
+
+    d2.at(0.0, Takeoff(height=1.0, duration=2.0))
+    d2.at(0.0, SetColor(Color.MAGENTA))
+    d2.at(2.5, MoveTo(x=0.5, y=0.0, z=1.2, duration=2.0))
+    d2.at(4.5, FadeColor(color=Color.PURPLE, duration=1.5))
+    d2.at(6.0, Hover(duration=1.5))
+    d2.at(7.5, Land(duration=2.0))
+    d2.at(7.5, SetColor(Color.OFF))
+
+    return show
+
+
+if __name__ == "__main__":
+    show = build_show()
+
+    print("=== Generated script ===\n")
+    print(to_script(show))
+
+    path = save_script(show)
+    print(f"Script saved to: {path}")
+    print("Run it directly with:  python", path)

examples/figure_eight.py

@@ -0,0 +1,59 @@
+"""
+Figure-eight flight path: one drone traces a lemniscate in the horizontal plane.
+
+Waypoints are sampled from the parametric curve
+    x = 0.8 * sin(t),  y = 0.6 * sin(2t)
+which produces a smooth figure-8 within the recommended ±1 m flight area.
+
+Usage:
+    python examples/figure_eight.py            # dry-run (instant)
+    python examples/figure_eight.py --realtime # dry-run, real-time pacing
+    python examples/figure_eight.py --fly      # real hardware
+"""
+import math
+
+from flaight import Color, FadeColor, Land, MoveTo, SetColor, Show, Takeoff
+
+URI = "radio://0/80/2M/E7E7E7E7E7"
+
+# Lemniscate waypoints — 8 points + closing return to origin
+_N = 8
+_WAYPOINTS = [
+    (round(0.8 * math.sin(2 * math.pi * i / _N), 2),
+     round(0.6 * math.sin(4 * math.pi * i / _N), 2))
+    for i in range(_N + 1)
+]
+
+# Color wheel to cycle through during the flight
+_COLORS = [
+    Color.RED, Color.ORANGE, Color.YELLOW, Color.GREEN,
+    Color.CYAN, Color.BLUE, Color.PURPLE, Color.MAGENTA,
+]
+
+LEG_DURATION = 2.0  # seconds per waypoint segment
+HEIGHT = 1.2
+
+show = Show()
+d1 = show.add_drone("cf1", uri=URI)
+
+d1.at(0.0, Takeoff(height=HEIGHT, duration=2.0))
+d1.at(0.0, SetColor(Color.RED))
+
+# Fly to start position (first waypoint is the origin, so go straight to index 1)
+t = 2.5
+for i, (x, y) in enumerate(_WAYPOINTS[1:], start=1):
+    d1.at(t, MoveTo(x=x, y=y, z=HEIGHT, duration=LEG_DURATION))
+    d1.at(t, FadeColor(color=_COLORS[i % len(_COLORS)], duration=LEG_DURATION * 0.8))
+    t += LEG_DURATION
+
+d1.at(t, Land(duration=2.0))
+d1.at(t, SetColor(Color.OFF))
+
+if __name__ == "__main__":
+    import sys
+    if "--fly" in sys.argv:
+        from flaight import FlightRunner
+        FlightRunner(show).run()
+    else:
+        from flaight import DryRunRunner
+        DryRunRunner(show, realtime="--realtime" in sys.argv).run()

examples/pulse.py

@@ -0,0 +1,51 @@
+"""
+Breathing-light effect: drone hovers while the LED pulses between a color and off.
+
+Two drones pulse in antiphase so the overall light breathes like a heartbeat.
+
+Usage:
+    python examples/pulse.py            # dry-run (instant)
+    python examples/pulse.py --realtime # dry-run, real-time pacing
+    python examples/pulse.py --fly      # real hardware
+"""
+from flaight import Color, FadeColor, Hover, Land, SetColor, Show, Takeoff
+
+URIS = [
+    "radio://0/80/2M/E7E7E7E7E7",
+    "radio://0/81/2M/E7E7E7E7E7",
+]
+
+PULSE_COLOR = Color.WHITE
+PULSE_DURATION = 1.2  # seconds for one fade-in or fade-out
+PULSES = 6            # number of on/off cycles per drone
+HOVER_START = 2.5     # when pulsing begins (after takeoff)
+
+show = Show()
+d1 = show.add_drone("cf1", uri=URIS[0])
+d2 = show.add_drone("cf2", uri=URIS[1])
+
+total_pulse_time = PULSES * 2 * PULSE_DURATION
+
+for drone, phase_offset in ((d1, 0.0), (d2, PULSE_DURATION)):
+    drone.at(0.0, Takeoff(height=1.0, duration=2.0))
+    drone.at(0.0, SetColor(Color.OFF))
+    drone.at(HOVER_START, Hover(duration=total_pulse_time + phase_offset))
+
+    t = HOVER_START + phase_offset
+    for _ in range(PULSES):
+        drone.at(t, FadeColor(color=PULSE_COLOR, duration=PULSE_DURATION))
+        t += PULSE_DURATION
+        drone.at(t, FadeColor(color=Color.OFF, duration=PULSE_DURATION))
+        t += PULSE_DURATION
+
+    land_t = HOVER_START + phase_offset + total_pulse_time
+    drone.at(land_t, Land(duration=2.0))
+
+if __name__ == "__main__":
+    import sys
+    if "--fly" in sys.argv:
+        from flaight import FlightRunner
+        FlightRunner(show).run()
+    else:
+        from flaight import DryRunRunner
+        DryRunRunner(show, realtime="--realtime" in sys.argv).run()

examples/single_drone.py

@@ -0,0 +1,34 @@
+"""
+Minimal single-drone show: takeoff, hover, land.
+
+The simplest possible flaight program — a good starting point.
+
+Usage:
+    python examples/single_drone.py            # dry-run (instant)
+    python examples/single_drone.py --realtime # dry-run, real-time pacing
+    python examples/single_drone.py --fly      # real hardware
+"""
+from flaight import Color, FadeColor, Hover, Land, SetColor, Show, Takeoff
+
+URI = "radio://0/80/2M/E7E7E7E7E7"
+
+show = Show()
+d1 = show.add_drone("cf1", uri=URI)
+
+d1.at(0.0, Takeoff(height=1.0, duration=2.0))
+d1.at(0.0, SetColor(Color.RED))
+
+d1.at(2.5, FadeColor(color=Color.BLUE, duration=2.0))
+d1.at(4.5, Hover(duration=2.0))
+
+d1.at(6.5, Land(duration=2.0))
+d1.at(6.5, SetColor(Color.OFF))
+
+if __name__ == "__main__":
+    import sys
+    if "--fly" in sys.argv:
+        from flaight import FlightRunner
+        FlightRunner(show).run()
+    else:
+        from flaight import DryRunRunner
+        DryRunRunner(show, realtime="--realtime" in sys.argv).run()

examples/validate_collision.py

@@ -0,0 +1,58 @@
+"""
+Collision-detection demo: shows how validate() catches unsafe shows before flight.
+
+Two scenarios are run:
+  1. Unsafe — both drones fly to the same point → CollisionError is raised and caught.
+  2. Safe   — drones fly to opposite sides → validate() passes silently.
+
+No hardware required; validation runs entirely in Python.
+"""
+from flaight import CollisionError, Color, Land, MoveTo, SetColor, Show, Takeoff, validate
+
+
+def unsafe_show() -> Show:
+    show = Show()
+    d1 = show.add_drone("cf1", uri="radio://0/80/2M/E7E7E7E7E7")
+    d2 = show.add_drone("cf2", uri="radio://0/81/2M/E7E7E7E7E7")
+
+    for drone in (d1, d2):
+        drone.at(0.0, Takeoff(height=1.0, duration=2.0))
+        # Both drones converge on the exact same point
+        drone.at(2.0, MoveTo(x=0.0, y=0.0, z=1.0, duration=3.0))
+        drone.at(5.0, Land(duration=2.0))
+
+    return show
+
+
+def safe_show() -> Show:
+    show = Show()
+    d1 = show.add_drone("cf1", uri="radio://0/80/2M/E7E7E7E7E7")
+    d2 = show.add_drone("cf2", uri="radio://0/81/2M/E7E7E7E7E7")
+
+    d1.at(0.0, Takeoff(height=1.0, duration=2.0))
+    d1.at(0.0, SetColor(Color.BLUE))
+    d1.at(2.0, MoveTo(x=-0.8, y=0.0, z=1.0, duration=3.0))
+    d1.at(5.0, Land(duration=2.0))
+
+    d2.at(0.0, Takeoff(height=1.0, duration=2.0))
+    d2.at(0.0, SetColor(Color.RED))
+    d2.at(2.0, MoveTo(x=0.8, y=0.0, z=1.0, duration=3.0))
+    d2.at(5.0, Land(duration=2.0))
+
+    return show
+
+
+if __name__ == "__main__":
+    print("--- Scenario 1: unsafe show (drones collide) ---")
+    try:
+        validate(unsafe_show())
+        print("No collision detected.")
+    except CollisionError as exc:
+        print(f"CollisionError: {exc}\n")
+
+    print("--- Scenario 2: safe show (drones separated) ---")
+    try:
+        validate(safe_show())
+        print("Validation passed — show is safe to fly.")
+    except CollisionError as exc:
+        print(f"CollisionError: {exc}")

flaight/validate.py

@@ -105,9 +105,9 @@ def validate(show: Show, safety: float = SAFETY_DISTANCE) -> None:
                 dist = math.sqrt(sum((a - b) ** 2 for a, b in zip(p1, p2)))
                 if dist < safety:
                     raise CollisionError(
-                        f"Kollisionsgefahr bei t={t:.2f}s: {d1} und {d2} sind "
-                        f"nur {dist * 100:.0f} cm voneinander entfernt "
-                        f"(Sicherheitsabstand: {safety * 100:.0f} cm).\n"
+                        f"Collision risk at t={t:.2f}s: {d1} and {d2} are "
+                        f"only {dist * 100:.0f} cm apart "
+                        f"(safety distance: {safety * 100:.0f} cm).\n"
                         f"  {d1}: ({p1[0]:.2f}, {p1[1]:.2f}, {p1[2]:.2f}) m\n"
                         f"  {d2}: ({p2[0]:.2f}, {p2[1]:.2f}, {p2[2]:.2f}) m"
                     )

tests/conftest.py

@@ -0,0 +1,6 @@
+import sys
+from pathlib import Path
+
+# Make the examples/ directory importable so test_example_*.py can do
+# "import single_drone" etc.
+sys.path.insert(0, str(Path(__file__).parent.parent / "examples"))