crystalwindow 4.5__py3-none-any.whl → 4.6__py3-none-any.whl

crystalwindow/__init__.py

@@ -32,8 +32,9 @@ from .collision import check_collision, resolve_collision
 from .gui import Button, Label, GUIManager, hex_to_rgb, Fade
 from .gui_ext import Toggle, Slider
 
-# === Time ===
-from .clock import Clock
+# === Time System ===
+# Includes upgraded Clock + all helper utilities
+from .clock import Clock, Stopwatch, CountdownTimer, Scheduler
 
 # === Drawing Helpers ===
 from .draw_helpers import gradient_rect, CameraShake
@@ -81,14 +82,19 @@ __all__ = [
     # --- GUI Extensions ---
     "Toggle", "Slider",
 
-    # --- Time ---
+    # --- Time System ---
+    # FULL time system is now exposed
     "Clock",
+    "Stopwatch",
+    "CountdownTimer",
+    "Scheduler",
 
     # --- Drawing ---
     "gradient_rect", "CameraShake", "DrawHelper", "DrawTextManager", "CrystalDraw", 
 
     # --- Misc ---
-    "random_name", "DebugOverlay", "Camera", "Colors", "Color", "random_palette", "lerp", "WebSearchResult", "WebSearch",
+    "random_name", "DebugOverlay", "Camera", "Colors", "Color",
+    "random_palette", "lerp", "WebSearchResult", "WebSearch",
 
     # --- 3D ---
     "CW3D",

crystalwindow/clock.py

@@ -1,23 +1,189 @@
 import time
+from datetime import datetime
+from collections import deque
 
-class Clock:
+
+# ============================================================
+# Stopwatch Helper
+# ============================================================
+class Stopwatch:
+    def __init__(self):
+        self.start_time = None
+        self.elapsed_time = 0.0
+        self.running = False
+
+    def start(self):
+        if not self.running:
+            self.start_time = time.perf_counter()
+            self.running = True
+
+    def stop(self):
+        if self.running:
+            self.elapsed_time += time.perf_counter() - self.start_time
+            self.running = False
+
+    def reset(self):
+        self.start_time = None
+        self.elapsed_time = 0.0
+        self.running = False
+
+    def elapsed(self):
+        if self.running:
+            return self.elapsed_time + (time.perf_counter() - self.start_time)
+        return self.elapsed_time
+
+
+# ============================================================
+# Countdown Timer Helper
+# ============================================================
+class CountdownTimer:
     def __init__(self):
-        self.last = time.time()
-        self.delta = 0
-        self.fps = 60
+        self.target_time = None
+
+    def start(self, seconds: float):
+        self.target_time = time.perf_counter() + seconds
+
+    def remaining(self):
+        if not self.target_time:
+            return 0
+        return max(0, self.target_time - time.perf_counter())
+
+    def done(self):
+        return self.remaining() == 0
+
+
+# ============================================================
+# Event Scheduler Helper
+# ============================================================
+class Scheduler:
+    def __init__(self):
+        self.events = []  # list of (interval, last_run, function)
+
+    def schedule(self, interval: float, func):
+        """Run function every `interval` seconds."""
+        self.events.append([interval, time.perf_counter(), func])
+
+    def run_pending(self):
+        now = time.perf_counter()
+        for event in self.events:
+            interval, last_run, func = event
+            if now - last_run >= interval:
+                func()
+                event[1] = now  # update last_run
+
+
+# ============================================================
+# MAIN CLOCK
+# ============================================================
+class Clock:
+    def __init__(self, target_fps: int = 60, smooth_fps: int = 30):
+        self.last = time.perf_counter()
+        self.delta = 0.0
+
+        # FPS
+        self.target_fps = target_fps
+        self.min_frame_time = 1 / target_fps if target_fps else 0
+        self.frame_times = deque(maxlen=smooth_fps)
+
+        self.paused = False
+
+        # Utilities
+        self.stopwatch = Stopwatch()
+        self.timer = CountdownTimer()
+        self.scheduler = Scheduler()
+
+    # ----------------------------------------------------------
+    # TICK + FPS
+    # ----------------------------------------------------------
+    def tick(self, fps: int | None = None):
+        if fps:
+            self.target_fps = fps
+            self.min_frame_time = 1 / fps
 
-    def tick(self, fps=None):
-        now = time.time()
-        self.delta = now - self.last
+        now = time.perf_counter()
+        raw_delta = now - self.last
         self.last = now
 
-        if fps:  
-            self.fps = fps
-            sleep_for = (1 / fps) - self.delta
-            if sleep_for > 0:
-                time.sleep(sleep_for)
+        # Paused = no delta
+        if self.paused:
+            self.delta = 0.0
+            return 0.0
+
+        # FPS limiting
+        sleep_time = self.min_frame_time - raw_delta
+        if sleep_time > 0:
+            time.sleep(sleep_time)
+            now2 = time.perf_counter()
+            raw_delta = now2 - (self.last - raw_delta)
+
+        self.delta = raw_delta
+        self.frame_times.append(raw_delta)
+
+        # Scheduler update
+        self.scheduler.run_pending()
 
         return self.delta
 
     def get_fps(self):
-        return round(1 / self.delta, 2) if self.delta else 0
+        if not self.frame_times:
+            return 0.0
+        avg = sum(self.frame_times) / len(self.frame_times)
+        return round(1 / avg, 2) if avg > 0 else 0
+
+    # ----------------------------------------------------------
+    # PAUSE / RESUME
+    # ----------------------------------------------------------
+    def pause(self):
+        self.paused = True
+
+    def resume(self):
+        self.paused = False
+        self.last = time.perf_counter()
+
+    # ----------------------------------------------------------
+    # TIME + DATE UTILITIES
+    # ----------------------------------------------------------
+    def time(self, milliseconds: bool = True, hour_12: bool = False):
+        now = datetime.now()
+
+        if hour_12:
+            fmt = "%I:%M:%S" + (" %p" if not milliseconds else ".%f %p")
+        else:
+            fmt = "%H:%M:%S" + (".%f" if milliseconds else "")
+
+        text = now.strftime(fmt)
+        if milliseconds:
+            # Trim microseconds to milliseconds
+            if hour_12:
+                # Example: "03:20:15.123000 PM" -> "03:20:15.123 PM"
+                parts = text.split(".")
+                ms = parts[1][:3] + parts[1][6:]  # keep .mmm, remove "000 PM"
+                text = parts[0] + "." + parts[1][:3] + " " + now.strftime("%p")
+            else:
+                text = text[:-3]  # remove last 3 microseconds digits
+
+        return text
+
+    def date(self, format: str = "%m/%d/%Y"):
+        return datetime.now().strftime(format)
+
+    def time_date(self, order: str = "time_first", **kwargs):
+        t = self.time(**kwargs)
+        d = self.date()
+        return f"{t}  |  {d}" if order == "time_first" else f"{d}  |  {t}"
+
+    # ----------------------------------------------------------
+    # CUSTOM FORMATTERS
+    # ----------------------------------------------------------
+    def format_time(self, fmt: str):
+        return datetime.now().strftime(fmt)
+
+    def format_date(self, fmt: str):
+        return datetime.now().strftime(fmt)
+
+    # ----------------------------------------------------------
+    # MONOTONIC TIMESTAMP
+    # ----------------------------------------------------------
+    def timestamp(self):
+        """High-precision monotonic timestamp."""
+        return time.perf_counter()

{crystalwindow-4.5.dist-info → crystalwindow-4.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: crystalwindow
-Version: 4.5
+Version: 4.6
 Summary: A Tkinter powered window + GUI toolkit made by Crystal (MEEEEEE)! Easier apps, smoother UI and all-in-one helpers!
 Home-page: https://pypi.org/project/crystalwindow/
 Author: CrystalBallyHereXD

{crystalwindow-4.5.dist-info → crystalwindow-4.6.dist-info}/RECORD

@@ -1,10 +1,10 @@
 crystalwindow/FileHelper.py,sha256=aUnnRG7UwvzJt-idjWjmpwy3RM6nqLlC3-7Bae6Yb94,5471
-crystalwindow/__init__.py,sha256=nOEUvoB4OpcYq_le1Kee0Uef3Jq38bYYapOI1u1CN2E,2457
+crystalwindow/__init__.py,sha256=Vr7Zd7Wgsu4id-3KaVuIkorRm80srd4zNR8fXWJZuhY,2662
 crystalwindow/ai.py,sha256=YIt6dNe1QljSAlNECCVa3DMUSIqQEJRIAAbQpYqFNNo,11525
 crystalwindow/animation.py,sha256=zHjrdBXQeyNaLAuaGPldJueX05OZ5j31YR8NizmR0uQ,427
 crystalwindow/assets.py,sha256=2Cj0zdhMWo3mWjdr9KU5n-9_8iKj_fJ9uShMFA-27HU,5193
 crystalwindow/camera.py,sha256=tbn4X-jxMIszAUg3Iu-89gJN5nij0mjPMEzGotcLbJI,712
-crystalwindow/clock.py,sha256=EAcNvxonD7ktkKSIbuVHqzhPhQqtUQtleMSBB_OuUQY,541
+crystalwindow/clock.py,sha256=P7Hzv6-_sHIwJRFcoMLMjQB2BnVjpQWQhRHotp6OPV0,6105
 crystalwindow/collision.py,sha256=hpkHTp_KparghVK-itp_rxuYdd2GbQMxICHlUBv0rSw,472
 crystalwindow/color_handler.py,sha256=ZnXnz8552GPiRAnCkW_8wycwRRMAaFRFLlCcsrv0j2E,4071
 crystalwindow/crystal3d.py,sha256=-Te9IJgbtzl8Mpuc4BPi2bn2apnvBNTI2GwxSLd8sqg,2006
@@ -35,8 +35,8 @@ crystalwindow/gametests/guitesting.py,sha256=SrOssY5peCQEV6TQ1AiOWtjb9phVGdRzW-Q
 crystalwindow/gametests/sandbox.py,sha256=Oo2tU2N0y3BPVa6T5vs_h9N6islhQrjSrr_78XLut5I,1007
 crystalwindow/gametests/squaremove.py,sha256=poP2Zjl2oc2HVvIAgIK34H2jVj6otL4jEdvAOR6L9sI,572
 crystalwindow/gametests/windowtesting.py,sha256=_9X6wnV1-_X_PtNS-0zu-k209NtFIwAc4vpxLPp7V2o,97
-crystalwindow-4.5.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
-crystalwindow-4.5.dist-info/METADATA,sha256=nWirrrZxkZMaUYGi8BbZQ3fGFCh0d0OZTtLReJHzYls,7338
-crystalwindow-4.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-crystalwindow-4.5.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
-crystalwindow-4.5.dist-info/RECORD,,
+crystalwindow-4.6.dist-info/licenses/LICENSE,sha256=Gt5cJRchdNt0guxyQMHKsATN5PM5mjuDhdO6Gzs9qQc,1096
+crystalwindow-4.6.dist-info/METADATA,sha256=PSVgwP0RGNqMC7PerNTZkFFH4KzslVZNDBCZ9MHrsww,7338
+crystalwindow-4.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+crystalwindow-4.6.dist-info/top_level.txt,sha256=PeQSld4b19XWT-zvbYkvE2Xg8sakIMbDzSzSdOSRN8o,14
+crystalwindow-4.6.dist-info/RECORD,,