Create SubClock Class

Author: DragonMoffon

arcade/future/sub_clock.py

@@ -36,3 +36,34 @@ def add_child(child: SubClock):
 
     clock.add_child = add_child  # type: ignore -- we know the clock will have .children
 
+
+class SubClock(Clock):
+    """
+    A SubClock which gets ticked by a parent clock and can have its flow
+    of time altered independantly of its parent or siblings.
+
+    Args:
+        parent: The clock which will tick the SubClock.
+            could be the GLOBAL_CLOCK or another SubClock
+        tick_speed: A multiplier on how the 'speed' of time.
+            i.e. a value of 0.5 means time elapsed half as fast for this clock. Defaults to 1.0.
+    """
+
+    def __init__(self, parent: Union[Clock, SubClock, None] = None, tick_speed: float = 1):
+        parent = parent or GLOBAL_CLOCK
+        super().__init__(parent._elapsed_time, parent._tick, tick_speed)
+        self.children: list[SubClock] = []
+        try:
+            parent.add_child(self)  # type: ignore -- we know the clock will have .children (or if not we want it to yell)
+        except AttributeError:
+            raise AttributeError(f'The clock {parent} has not been bootstrapped properly'
+                                 f'call boot_strap_clock({parent}) before adding children')
+
+    def add_child(self, child: SubClock):
+        self.children.append(child)
+
+    def tick(self, delta_time: float):
+        super().tick(delta_time)
+
+        for child in self.children:
+            child.tick(self.delta_time)