crystalwindow 4.5__tar.gz → 4.6__tar.gz

{crystalwindow-4.5/crystalwindow.egg-info → crystalwindow-4.6}/PKG-INFO

@@ -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 → crystalwindow-4.6}/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-4.6/crystalwindow/clock.py

@@ -0,0 +1,189 @@
+import time
+from datetime import datetime
+from collections import deque
+
+
+# ============================================================
+# 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.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
+
+        now = time.perf_counter()
+        raw_delta = now - self.last
+        self.last = now
+
+        # 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):
+        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 → crystalwindow-4.6/crystalwindow.egg-info}/PKG-INFO

@@ -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 → crystalwindow-4.6}/setup.py

@@ -7,7 +7,7 @@ with open("README.md", encoding="utf-8") as f:
 
 setup(
     name="crystalwindow",
-    version="4.5",  # Force metadata refresh
+    version="4.6",  # Force metadata refresh
     packages=find_packages(include=["crystalwindow", "crystalwindow.*"]),
 
     include_package_data=True,  # include package_data files

crystalwindow-4.5/crystalwindow/clock.py

@@ -1,23 +0,0 @@
-import time
-
-class Clock:
-    def __init__(self):
-        self.last = time.time()
-        self.delta = 0
-        self.fps = 60
-
-    def tick(self, fps=None):
-        now = time.time()
-        self.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)
-
-        return self.delta
-
-    def get_fps(self):
-        return round(1 / self.delta, 2) if self.delta else 0