easypyui 2.2.0__tar.gz

easypyui-2.2.0/PKG-INFO

@@ -0,0 +1,7 @@
+Metadata-Version: 2.4
+Name: easypyui
+Version: 2.2.0
+Summary: A concise modern GUI wrapper for tkinter and ttk
+License: MIT
+Keywords: gui,tkinter,ttk,easy,desktop
+Requires-Python: >=3.9

easypyui-2.2.0/README.md

@@ -0,0 +1,49 @@
+# EasyPyUI 2.2 — Animation
+
+2.2 加入輕量動畫引擎，沒有新增第三方依賴。
+
+## 新功能
+
+- `fade_in()` / `fade_out()`
+- `animate(..., kind="slide")`
+- easing：linear / ease_in / ease_out / ease_in_out
+- `progress_ring()` 圓形進度
+- `ring.animate_to(80)`
+- Animation 可 `.cancel()`
+- 2.1 現代 UI、2.0 Router、1.x API 全部保留
+
+## Fade
+
+```python
+from easypyui import *
+
+app("動畫", 500, 400, appearance="dark")
+title("EasyPyUI 2.2")
+mbutton("淡出", lambda: fade_out(500))
+fade_in(500)
+run()
+```
+
+## Progress Ring
+
+```python
+ring = progress_ring(20, size=110)
+mbutton("到 90%", lambda: ring.animate_to(90, 700))
+```
+
+## Slide
+
+```python
+btn = mbutton("滑入", lambda: None, layout="none")
+
+animate(
+    btn,
+    kind="slide",
+    from_x=-160,
+    from_y=180,
+    to_x=170,
+    to_y=180,
+    duration=600,
+    easing="ease_out"
+)
+```

easypyui-2.2.0/easypyui/__init__.py

@@ -0,0 +1,105 @@
+from .core import App, Value, Widget, Table, Canvas, Container, Row
+
+__version__ = "2.2.0"
+
+_current = None
+
+def window(title="EasyPyUI", width=500, height=400, **kwargs):
+    global _current
+    _current = App(title, width, height, **kwargs)
+    return _current
+
+def _app():
+    global _current
+    if _current is None:
+        _current = App()
+    return _current
+
+def text(*a, **k): return _app().text(*a, **k)
+def button(*a, **k): return _app().button(*a, **k)
+def inputbox(*a, **k): return _app().input(*a, **k)
+def password(*a, **k): return _app().password(*a, **k)
+def textbox(*a, **k): return _app().textbox(*a, **k)
+def check(*a, **k): return _app().check(*a, **k)
+def radio(*a, **k): return _app().radio(*a, **k)
+def select(*a, **k): return _app().select(*a, **k)
+def slider(*a, **k): return _app().slider(*a, **k)
+def spin(*a, **k): return _app().spin(*a, **k)
+def progress(*a, **k): return _app().progress(*a, **k)
+def listbox(*a, **k): return _app().listbox(*a, **k)
+def table(*a, **k): return _app().table(*a, **k)
+def canvas(*a, **k): return _app().canvas(*a, **k)
+def separator(*a, **k): return _app().separator(*a, **k)
+def group(*a, **k): return _app().group(*a, **k)
+def row(*a, **k): return _app().row(*a, **k)
+def frame(*a, **k): return _app().frame(*a, **k)
+def scroll_area(*a, **k): return _app().scroll_area(*a, **k)
+def alert(*a, **k): return _app().alert(*a, **k)
+def error(*a, **k): return _app().error(*a, **k)
+def warning(*a, **k): return _app().warning(*a, **k)
+def ask(*a, **k): return _app().ask(*a, **k)
+def prompt(*a, **k): return _app().prompt(*a, **k)
+def open_file(*a, **k): return _app().open_file(*a, **k)
+def open_files(*a, **k): return _app().open_files(*a, **k)
+def save_file(*a, **k): return _app().save_file(*a, **k)
+def folder(*a, **k): return _app().folder(*a, **k)
+def pick_color(*a, **k): return _app().pick_color(*a, **k)
+def later(*a, **k): return _app().later(*a, **k)
+def every(*a, **k): return _app().every(*a, **k)
+def start(): return _app().run()
+
+
+def switch(*a, **k): return _app().switch(*a, **k)
+def card(*a, **k): return _app().card(*a, **k)
+def badge(*a, **k): return _app().badge(*a, **k)
+def navbar(*a, **k): return _app().navbar(*a, **k)
+def sidebar(*a, **k): return _app().sidebar(*a, **k)
+def toast(*a, **k): return _app().toast(*a, **k)
+def loading(*a, **k): return _app().loading(*a, **k)
+def statusbar(*a, **k): return _app().statusbar(*a, **k)
+
+
+# EasyPyUI 2.0 short aliases
+def app(title="EasyPyUI", width=500, height=400, **kwargs):
+    return window(title, width, height, **kwargs)
+
+def title(text_value, size=24, **kwargs):
+    return _app().text(text_value, size=size, bold=True, **kwargs)
+
+def label(text_value="", **kwargs):
+    return _app().text(text_value, **kwargs)
+
+def input(prompt_text=None, **kwargs):
+    return _app().input(prompt_text, **kwargs)
+
+def on(text_value, action, **kwargs):
+    return _app().button(text_value, action, **kwargs)
+
+def run():
+    return start()
+
+def notify(*a, **k):
+    return _app().notify(*a, **k)
+
+def confirm(*a, **k):
+    return _app().confirm(*a, **k)
+
+def route(name, builder=None):
+    return _app().route(name, builder)
+
+def go(name):
+    return _app().route(name)
+
+def run_task(*a, **k):
+    return _app().run_task(*a, **k)
+
+
+def mbutton(*a, **k): return _app().modern_button(*a, **k)
+def minput(*a, **k): return _app().modern_input(*a, **k)
+def mswitch(*a, **k): return _app().modern_switch(*a, **k)
+def mcard(*a, **k): return _app().modern_card(*a, **k)
+
+def progress_ring(*a, **k): return _app().progress_ring(*a, **k)
+def fade_in(*a, **k): return _app().fade_in(*a, **k)
+def fade_out(*a, **k): return _app().fade_out(*a, **k)
+def animate(*a, **k): return _app().animate(*a, **k)

easypyui-2.2.0/easypyui/animation.py

@@ -0,0 +1,122 @@
+import time
+import math
+import tkinter as tk
+
+EASINGS = {
+    "linear": lambda t: t,
+    "ease_in": lambda t: t*t,
+    "ease_out": lambda t: 1-(1-t)*(1-t),
+    "ease_in_out": lambda t: 2*t*t if t < .5 else 1-((-2*t+2)**2)/2,
+}
+
+def _widget(obj):
+    return getattr(obj, "tk", getattr(obj, "widget", obj))
+
+class Animation:
+    def __init__(self, root, duration=300, fps=60, easing="ease_out"):
+        self.root = root
+        self.duration = max(1, duration)
+        self.interval = max(1, int(1000/fps))
+        self.ease = EASINGS.get(easing, EASINGS["ease_out"])
+        self.cancelled = False
+        self.after_id = None
+
+    def start(self, update, done=None):
+        started = time.perf_counter()
+        def tick():
+            if self.cancelled:
+                return
+            elapsed = (time.perf_counter()-started)*1000
+            raw = min(1.0, elapsed/self.duration)
+            update(self.ease(raw))
+            if raw >= 1:
+                if done: done()
+            else:
+                self.after_id = self.root.after(self.interval, tick)
+        tick()
+        return self
+
+    def cancel(self):
+        self.cancelled = True
+        if self.after_id:
+            try: self.root.after_cancel(self.after_id)
+            except Exception: pass
+
+def fade(window, start=0.0, end=1.0, duration=300, easing="ease_out", done=None):
+    root = window.winfo_toplevel()
+    try: root.attributes("-alpha", start)
+    except tk.TclError: return None
+    return Animation(root, duration, easing=easing).start(
+        lambda t: root.attributes("-alpha", start+(end-start)*t), done)
+
+def slide(widget, from_x, from_y, to_x, to_y, duration=350, easing="ease_out", done=None):
+    w = _widget(widget); root = w.winfo_toplevel()
+    w.place(x=from_x, y=from_y)
+    return Animation(root, duration, easing=easing).start(
+        lambda t: w.place(x=from_x+(to_x-from_x)*t, y=from_y+(to_y-from_y)*t), done)
+
+def animate_value(root, start, end, setter, duration=300, easing="ease_out", done=None):
+    return Animation(root, duration, easing=easing).start(
+        lambda t: setter(start+(end-start)*t), done)
+
+class ProgressRing:
+    def __init__(self, parent, value=0, maximum=100, size=90, width=8,
+                 accent="#2563eb", track="#d1d5db", text=True):
+        self.value=float(value); self.maximum=float(maximum); self.size=size
+        self.width=width; self.accent=accent; self.track=track; self.show_text=text
+        bg = parent.cget("bg") if "bg" in parent.keys() else "#f5f5f5"
+        self.canvas=tk.Canvas(parent,width=size,height=size,highlightthickness=0,bd=0,bg=bg)
+        self.tk=self.widget=self.canvas
+        self.draw()
+
+    def draw(self):
+        c=self.canvas; c.delete("all"); pad=self.width/2+3
+        c.create_oval(pad,pad,self.size-pad,self.size-pad,outline=self.track,width=self.width)
+        pct=max(0,min(1,self.value/self.maximum if self.maximum else 0))
+        c.create_arc(pad,pad,self.size-pad,self.size-pad,start=90,extent=-360*pct,
+                     style="arc",outline=self.accent,width=self.width)
+        if self.show_text:
+            c.create_text(self.size/2,self.size/2,text=f"{pct*100:.0f}%",font=("Arial",11,"bold"))
+
+    def get(self): return self.value
+    def set(self,value): self.value=float(value); self.draw(); return self
+    def pack(self,**kw): self.canvas.pack(**kw); return self
+    def grid(self,**kw): self.canvas.grid(**kw); return self
+    def place(self,**kw): self.canvas.place(**kw); return self
+
+    def animate_to(self,value,duration=500,easing="ease_out"):
+        start=self.value
+        return animate_value(self.canvas.winfo_toplevel(),start,float(value),self.set,duration,easing)
+
+def install_animation_api(App, Builder):
+    def progress_ring(self,value=0,maximum=100,size=90,width=8,layout="pack",**kwargs):
+        app=self.app if hasattr(self,"app") else self
+        p=app.palette()
+        ring=ProgressRing(self._parent,value,maximum,size,width,
+                          kwargs.pop("accent",p["accent"]),
+                          kwargs.pop("track","#555555" if getattr(app,"_theme_name","light")=="dark" else "#d1d5db"),
+                          kwargs.pop("text",True))
+        opts=kwargs.pop("layout_opts",{})
+        if layout=="grid": ring.grid(**opts)
+        elif layout=="place": ring.place(**opts)
+        elif layout!="none":
+            defaults={"anchor":"w","pady":5}; defaults.update(opts); ring.pack(**defaults)
+        return ring
+
+    Builder.progress_ring=progress_ring
+
+    def fade_in(self,duration=300,easing="ease_out"):
+        return fade(self.root,0,1,duration,easing)
+    def fade_out(self,duration=300,easing="ease_in",done=None):
+        return fade(self.root,1,0,duration,easing,done)
+    def animate(self,widget,kind="slide",duration=350,easing="ease_out",**kwargs):
+        if kind=="slide":
+            return slide(widget,kwargs.get("from_x",-100),kwargs.get("from_y",0),
+                         kwargs.get("to_x",0),kwargs.get("to_y",0),duration,easing,kwargs.get("done"))
+        if kind=="fade":
+            return fade(_widget(widget),kwargs.get("start",0),kwargs.get("end",1),
+                        duration,easing,kwargs.get("done"))
+        raise ValueError("kind 必須是 slide 或 fade")
+    App.fade_in=fade_in
+    App.fade_out=fade_out
+    App.animate=animate