easypyui 2.2.0__tar.gz → 2.4.0__tar.gz

easypyui-2.4.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 EasyPyUI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software.

easypyui-2.4.0/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: easypyui
+Version: 2.4.0
+Summary: A simple and modern Python GUI library built on tkinter and ttk
+Author: EasyPyUI
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/easypyui/
+Keywords: gui,tkinter,ttk,desktop,ui,python-gui
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# EasyPyUI
+
+**Build modern Python desktop GUIs with much less code than raw tkinter.**
+
+EasyPyUI is a lightweight GUI library built on Python's standard `tkinter` and `ttk`.
+It provides a short beginner-friendly API while keeping access to native Tk widgets.
+
+## Installation
+
+```bash
+pip install easypyui
+```
+
+## Quick Start
+
+```python
+from easypyui import *
+
+app("Hello EasyPyUI", 500, 400, appearance="dark")
+title("Hello!")
+
+name = minput("Name", placeholder="Your name")
+mbutton("Say hello", lambda: notify("Hello " + name.get()))
+
+fade_in(400)
+run()
+```
+
+## Modern UI
+
+EasyPyUI 2.x includes `mbutton()`, `minput()`, `mswitch()`, `mcard()`,
+Light/Dark appearance and custom accent colors.
+
+```python
+app("Dashboard", 700, 500, appearance="dark", accent="#8b5cf6")
+```
+
+## Animation
+
+```python
+ring = progress_ring(20, size=110)
+mbutton("Start", lambda: ring.animate_to(100, 1000))
+fade_in(500)
+```
+
+Easing modes: `linear`, `ease_in`, `ease_out`, `ease_in_out`.
+
+## Pages / Router
+
+```python
+from easypyui import *
+
+app("Pages", 500, 350)
+
+def home(ui):
+    title("Home")
+    on("Settings", lambda: go("settings"))
+
+def settings(ui):
+    title("Settings")
+    on("Back", lambda: go("home"))
+
+route("home", home)
+route("settings", settings)
+go("home")
+run()
+```
+
+## Background Tasks
+
+```python
+def work():
+    import time
+    time.sleep(2)
+    return "Done!"
+
+run_task(work, done=lambda result: notify(result), loading_text="Working...")
+```
+
+## Native tkinter access
+
+Most EasyPyUI wrapper objects expose `.tk`:
+
+```python
+btn = mbutton("Test", lambda: print("clicked"))
+btn.tk.bind("<Button-2>", lambda event: print("middle click"))
+```
+
+## Classic API
+
+The older API remains available, including `window()`, `text()`, `inputbox()`,
+`button()`, `table()`, `canvas()` and `start()`.
+
+## Requirements
+
+- Python 3.9+
+- tkinter support in your Python installation
+- No mandatory third-party runtime GUI dependency
+
+## License
+
+MIT License
+
+## Version
+
+Current release: **2.4.0**
+
+2.2.1 is a PyPI metadata and documentation update for the 2.2 series.
+
+
+## 2.3 Productivity APIs
+
+### Form validation
+
+```python
+f = form()
+
+email = f.add(
+    "Email",
+    minput("Email"),
+    [Validator.required(), Validator.email()]
+)
+
+password_box = f.add(
+    "Password",
+    minput("Password", password=True),
+    [Validator.required(), Validator.min_length(8)]
+)
+
+def submit():
+    ok, errors = f.validate()
+    if ok:
+        notify(str(f.values()))
+
+mbutton("Submit", submit)
+```
+
+### Reactive State
+
+```python
+count = state(0)
+
+label_widget = text("0")
+count.bind_text(label_widget)
+
+mbutton("+1", lambda: count.update(lambda n: n + 1))
+```
+
+### Keyboard shortcuts
+
+```python
+shortcut("ctrl+s", save)
+shortcut("ctrl+q", close)
+```
+
+### Debounce / Throttle
+
+```python
+search = debounce(300, do_search)
+resize_handler = throttle(100, update_layout)
+```
+
+
+## 2.4 Large Application Widgets
+
+- `datatable()` — search, sorting and pagination
+- `modal()` — modal window
+- `drawer()` — collapsible side drawer
+- `accordion()` — expandable sections
+- `datepicker()` — date value input
+- `notifications()` — notification center
+
+```python
+table = datatable(["name", "score"], ["Name", "Score"], page_size=5)
+table.set_rows([
+    ("Noah", 100),
+    ("Daniel", 95),
+])
+```

easypyui-2.4.0/README.md

@@ -0,0 +1,179 @@
+# EasyPyUI
+
+**Build modern Python desktop GUIs with much less code than raw tkinter.**
+
+EasyPyUI is a lightweight GUI library built on Python's standard `tkinter` and `ttk`.
+It provides a short beginner-friendly API while keeping access to native Tk widgets.
+
+## Installation
+
+```bash
+pip install easypyui
+```
+
+## Quick Start
+
+```python
+from easypyui import *
+
+app("Hello EasyPyUI", 500, 400, appearance="dark")
+title("Hello!")
+
+name = minput("Name", placeholder="Your name")
+mbutton("Say hello", lambda: notify("Hello " + name.get()))
+
+fade_in(400)
+run()
+```
+
+## Modern UI
+
+EasyPyUI 2.x includes `mbutton()`, `minput()`, `mswitch()`, `mcard()`,
+Light/Dark appearance and custom accent colors.
+
+```python
+app("Dashboard", 700, 500, appearance="dark", accent="#8b5cf6")
+```
+
+## Animation
+
+```python
+ring = progress_ring(20, size=110)
+mbutton("Start", lambda: ring.animate_to(100, 1000))
+fade_in(500)
+```
+
+Easing modes: `linear`, `ease_in`, `ease_out`, `ease_in_out`.
+
+## Pages / Router
+
+```python
+from easypyui import *
+
+app("Pages", 500, 350)
+
+def home(ui):
+    title("Home")
+    on("Settings", lambda: go("settings"))
+
+def settings(ui):
+    title("Settings")
+    on("Back", lambda: go("home"))
+
+route("home", home)
+route("settings", settings)
+go("home")
+run()
+```
+
+## Background Tasks
+
+```python
+def work():
+    import time
+    time.sleep(2)
+    return "Done!"
+
+run_task(work, done=lambda result: notify(result), loading_text="Working...")
+```
+
+## Native tkinter access
+
+Most EasyPyUI wrapper objects expose `.tk`:
+
+```python
+btn = mbutton("Test", lambda: print("clicked"))
+btn.tk.bind("<Button-2>", lambda event: print("middle click"))
+```
+
+## Classic API
+
+The older API remains available, including `window()`, `text()`, `inputbox()`,
+`button()`, `table()`, `canvas()` and `start()`.
+
+## Requirements
+
+- Python 3.9+
+- tkinter support in your Python installation
+- No mandatory third-party runtime GUI dependency
+
+## License
+
+MIT License
+
+## Version
+
+Current release: **2.4.0**
+
+2.2.1 is a PyPI metadata and documentation update for the 2.2 series.
+
+
+## 2.3 Productivity APIs
+
+### Form validation
+
+```python
+f = form()
+
+email = f.add(
+    "Email",
+    minput("Email"),
+    [Validator.required(), Validator.email()]
+)
+
+password_box = f.add(
+    "Password",
+    minput("Password", password=True),
+    [Validator.required(), Validator.min_length(8)]
+)
+
+def submit():
+    ok, errors = f.validate()
+    if ok:
+        notify(str(f.values()))
+
+mbutton("Submit", submit)
+```
+
+### Reactive State
+
+```python
+count = state(0)
+
+label_widget = text("0")
+count.bind_text(label_widget)
+
+mbutton("+1", lambda: count.update(lambda n: n + 1))
+```
+
+### Keyboard shortcuts
+
+```python
+shortcut("ctrl+s", save)
+shortcut("ctrl+q", close)
+```
+
+### Debounce / Throttle
+
+```python
+search = debounce(300, do_search)
+resize_handler = throttle(100, update_layout)
+```
+
+
+## 2.4 Large Application Widgets
+
+- `datatable()` — search, sorting and pagination
+- `modal()` — modal window
+- `drawer()` — collapsible side drawer
+- `accordion()` — expandable sections
+- `datepicker()` — date value input
+- `notifications()` — notification center
+
+```python
+table = datatable(["name", "score"], ["Name", "Score"], page_size=5)
+table.set_rows([
+    ("Noah", 100),
+    ("Daniel", 95),
+])
+```

{easypyui-2.2.0 → easypyui-2.4.0}/easypyui/__init__.py

@@ -1,6 +1,6 @@
 from .core import App, Value, Widget, Table, Canvas, Container, Row
 
-__version__ = "2.2.0"
+__version__ = "2.4.0"
 
 _current = None
 
@@ -103,3 +103,19 @@ 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)
+
+from .productivity import Validator, Form, State
+
+def form(): return _app().form()
+def state(value=None): return _app().state(value)
+def shortcut(keys, callback): return _app().shortcut(keys, callback)
+def debounce(wait_ms, func): return _app().debounce(wait_ms, func)
+def throttle(wait_ms, func): return _app().throttle(wait_ms, func)
+
+from .largeapp import Modal, Drawer, Accordion, DataTable, DatePicker, NotificationCenter
+def modal(*a, **k): return _app().modal(*a, **k)
+def drawer(*a, **k): return _app().drawer(*a, **k)
+def accordion(*a, **k): return _app().accordion(*a, **k)
+def datatable(*a, **k): return _app().datatable(*a, **k)
+def datepicker(*a, **k): return _app().datepicker(*a, **k)
+def notifications(): return _app().notifications()

{easypyui-2.2.0 → easypyui-2.4.0}/easypyui/core.py

@@ -1190,3 +1190,9 @@ install_modern_api(App, _Builder)
 
 from .animation import install_animation_api
 install_animation_api(App, _Builder)
+
+from .productivity import install_productivity_api
+install_productivity_api(App, _Builder)
+
+from .largeapp import install_largeapp_api
+install_largeapp_api(App, _Builder)

easypyui-2.4.0/easypyui/largeapp.py

@@ -0,0 +1,138 @@
+import tkinter as tk
+from tkinter import ttk
+from datetime import date
+
+class Modal:
+    def __init__(self, app, title="Modal", width=420, height=260):
+        self.app=app
+        self.win=tk.Toplevel(app.root)
+        self.win.title(title); self.win.geometry(f"{width}x{height}")
+        self.win.transient(app.root); self.win.grab_set()
+        self.body=tk.Frame(self.win, padx=16, pady=16)
+        self.body.pack(fill="both", expand=True)
+        self.tk=self.win
+    def close(self):
+        try: self.win.grab_release()
+        except Exception: pass
+        self.win.destroy()
+
+class Drawer:
+    def __init__(self, app, width=260, side="left"):
+        self.app=app; self.width=width; self.side=side
+        self.frame=tk.Frame(app.root, bd=1, relief="solid")
+        self.opened=False; self.tk=self.frame
+    def open(self):
+        self.frame.pack(side=self.side, fill="y", before=self.app.body)
+        self.opened=True; return self
+    def close(self):
+        self.frame.pack_forget(); self.opened=False; return self
+    def toggle(self): return self.close() if self.opened else self.open()
+
+class Accordion:
+    def __init__(self,parent):
+        self.frame=ttk.Frame(parent); self.frame.pack(fill="x", pady=3); self.sections=[]
+        self.tk=self.frame
+    def add(self,title,builder=None,opened=False):
+        head=ttk.Button(self.frame,text=title)
+        body=ttk.Frame(self.frame,padding=8)
+        def toggle():
+            if body.winfo_ismapped(): body.pack_forget()
+            else: body.pack(fill="x")
+        head.configure(command=toggle); head.pack(fill="x")
+        if builder: builder(body)
+        if opened: body.pack(fill="x")
+        self.sections.append((head,body)); return body
+
+class DataTable:
+    def __init__(self,parent,columns,headings=None,page_size=10):
+        self.columns=list(columns); self.page_size=max(1,page_size); self.page=0
+        self.all_rows=[]; self.filtered=[]; self.sort_col=None; self.sort_reverse=False
+        self.frame=ttk.Frame(parent)
+        bar=ttk.Frame(self.frame); bar.pack(fill="x",pady=(0,5))
+        self.query=tk.StringVar()
+        ent=ttk.Entry(bar,textvariable=self.query); ent.pack(side="left",fill="x",expand=True)
+        ttk.Button(bar,text="搜尋",command=self.refresh).pack(side="left",padx=4)
+        self.tree=ttk.Treeview(self.frame,columns=self.columns,show="headings")
+        self.tree.pack(fill="both",expand=True)
+        hs=headings or self.columns
+        for col,h in zip(self.columns,hs):
+            self.tree.heading(col,text=h,command=lambda c=col:self.sort(c))
+        nav=ttk.Frame(self.frame); nav.pack(fill="x",pady=(5,0))
+        ttk.Button(nav,text="上一頁",command=self.prev).pack(side="left")
+        self.info=ttk.Label(nav,text="1 / 1"); self.info.pack(side="left",padx=8)
+        ttk.Button(nav,text="下一頁",command=self.next).pack(side="left")
+        self.tk=self.tree
+    def pack(self,**kw): self.frame.pack(**kw); return self
+    def grid(self,**kw): self.frame.grid(**kw); return self
+    def set_rows(self,rows): self.all_rows=[tuple(x) for x in rows]; self.page=0; self.refresh(); return self
+    def add(self,row): self.all_rows.append(tuple(row)); self.refresh(); return self
+    def refresh(self):
+        q=self.query.get().lower().strip()
+        self.filtered=[r for r in self.all_rows if not q or q in " ".join(map(str,r)).lower()]
+        if self.sort_col in self.columns:
+            i=self.columns.index(self.sort_col)
+            self.filtered.sort(key=lambda r:str(r[i]).lower(),reverse=self.sort_reverse)
+        pages=max(1,(len(self.filtered)+self.page_size-1)//self.page_size)
+        self.page=min(self.page,pages-1)
+        for x in self.tree.get_children(): self.tree.delete(x)
+        start=self.page*self.page_size
+        for row in self.filtered[start:start+self.page_size]: self.tree.insert("","end",values=row)
+        self.info.configure(text=f"{self.page+1} / {pages}")
+        return self
+    def sort(self,col):
+        if self.sort_col==col: self.sort_reverse=not self.sort_reverse
+        else: self.sort_col=col; self.sort_reverse=False
+        return self.refresh()
+    def next(self):
+        pages=max(1,(len(self.filtered)+self.page_size-1)//self.page_size)
+        if self.page+1<pages: self.page+=1; self.refresh()
+    def prev(self):
+        if self.page>0: self.page-=1; self.refresh()
+    def selected(self):
+        ids=self.tree.selection()
+        return self.tree.item(ids[0],"values") if ids else None
+    def rows(self): return list(self.filtered)
+
+class DatePicker:
+    def __init__(self,parent,default=None):
+        self.var=tk.StringVar(value=default or date.today().isoformat())
+        self.entry=ttk.Entry(parent,textvariable=self.var,width=14)
+        self.tk=self.entry
+    def get(self): return self.var.get()
+    def set(self,value): self.var.set(str(value)); return self
+    def pack(self,**kw): self.entry.pack(**kw); return self
+    def grid(self,**kw): self.entry.grid(**kw); return self
+
+class NotificationCenter:
+    def __init__(self,app):
+        self.app=app; self.items=[]
+    def add(self,text,kind="info",title=None):
+        item={"text":text,"kind":kind,"title":title}
+        self.items.append(item); self.app.notify(text,title=title); return item
+    def clear(self): self.items.clear(); return self
+    def unread(self): return len(self.items)
+
+def install_largeapp_api(App,Builder):
+    def modal(self,title="Modal",width=420,height=260): return Modal(self,title,width,height)
+    def drawer(self,width=260,side="left"): return Drawer(self,width,side)
+    def notifications(self):
+        if not hasattr(self,"_notifications"): self._notifications=NotificationCenter(self)
+        return self._notifications
+    App.modal=modal; App.drawer=drawer; App.notifications=notifications
+
+    def accordion(self,layout="pack",**kwargs):
+        w=Accordion(self._parent); return w
+    def datatable(self,columns,headings=None,page_size=10,layout="pack",**kwargs):
+        w=DataTable(self._parent,columns,headings,page_size)
+        opts=kwargs.pop("layout_opts",{})
+        if layout=="grid": w.grid(**opts)
+        elif layout!="none":
+            d={"fill":"both","expand":True,"pady":5}; d.update(opts); w.pack(**d)
+        return w
+    def datepicker(self,default=None,layout="pack",**kwargs):
+        w=DatePicker(self._parent,default); opts=kwargs.pop("layout_opts",{})
+        if layout=="grid": w.grid(**opts)
+        elif layout!="none":
+            d={"anchor":"w","pady":4}; d.update(opts); w.pack(**d)
+        return w
+    Builder.accordion=accordion; Builder.datatable=datatable; Builder.datepicker=datepicker

easypyui-2.4.0/easypyui/productivity.py

@@ -0,0 +1,142 @@
+import re
+import time
+
+class Validator:
+    @staticmethod
+    def required(message="此欄位必填"):
+        return lambda value: (bool(str(value).strip()), message)
+
+    @staticmethod
+    def min_length(length, message=None):
+        msg = message or f"至少需要 {length} 個字元"
+        return lambda value: (len(str(value)) >= length, msg)
+
+    @staticmethod
+    def max_length(length, message=None):
+        msg = message or f"最多 {length} 個字元"
+        return lambda value: (len(str(value)) <= length, msg)
+
+    @staticmethod
+    def email(message="Email 格式不正確"):
+        pattern = re.compile(r"^[^@\s]+@[^@\s]+\.[^@\s]+$")
+        return lambda value: (bool(pattern.match(str(value))), message)
+
+    @staticmethod
+    def number(message="必須是數字"):
+        def check(value):
+            try:
+                float(value); return True, message
+            except (TypeError, ValueError):
+                return False, message
+        return check
+
+class Form:
+    def __init__(self, app):
+        self.app = app
+        self.fields = {}
+
+    def add(self, name, widget, validators=None):
+        self.fields[name] = (widget, list(validators or []))
+        return widget
+
+    def values(self):
+        return {name: widget.get() for name, (widget, _) in self.fields.items()}
+
+    def validate(self, show_error=True):
+        errors = {}
+        for name, (widget, validators) in self.fields.items():
+            value = widget.get()
+            for validator in validators:
+                ok, message = validator(value)
+                if not ok:
+                    errors[name] = message
+                    break
+        if errors and show_error:
+            text = "\n".join(f"{name}: {msg}" for name, msg in errors.items())
+            self.app.warning(text, title="資料檢查")
+        return not errors, errors
+
+    def clear(self):
+        for widget, _ in self.fields.values():
+            try: widget.set("")
+            except Exception: pass
+        return self
+
+class State:
+    def __init__(self, value=None):
+        self._value = value
+        self._listeners = []
+
+    def get(self):
+        return self._value
+
+    def set(self, value):
+        if value == self._value:
+            return self
+        self._value = value
+        for callback in list(self._listeners):
+            callback(value)
+        return self
+
+    def update(self, func):
+        return self.set(func(self._value))
+
+    def watch(self, callback, immediate=False):
+        self._listeners.append(callback)
+        if immediate:
+            callback(self._value)
+        return lambda: self.unwatch(callback)
+
+    def unwatch(self, callback):
+        if callback in self._listeners:
+            self._listeners.remove(callback)
+
+    def bind_text(self, widget):
+        def apply(value):
+            try: widget.set(value)
+            except Exception:
+                try: widget.config(text=str(value))
+                except Exception: pass
+        self.watch(apply, immediate=True)
+        return self
+
+def install_productivity_api(App, Builder):
+    def form(self):
+        return Form(self)
+    App.form = form
+
+    def state(self, value=None):
+        return State(value)
+    App.state = state
+
+    def shortcut(self, keys, callback):
+        sequence = keys
+        if not str(keys).startswith("<"):
+            parts = str(keys).lower().replace("+", "-").split("-")
+            names = {"ctrl":"Control", "control":"Control", "alt":"Alt",
+                     "shift":"Shift", "enter":"Return", "esc":"Escape",
+                     "escape":"Escape", "space":"space", "tab":"Tab"}
+            sequence = "<" + "-".join(names.get(x, x) for x in parts) + ">"
+        self.root.bind(sequence, lambda event: callback())
+        return self
+    App.shortcut = shortcut
+
+    def debounce(self, wait_ms, func):
+        holder = {"id": None}
+        def wrapped(*args, **kwargs):
+            if holder["id"] is not None:
+                try: self.root.after_cancel(holder["id"])
+                except Exception: pass
+            holder["id"] = self.root.after(wait_ms, lambda: func(*args, **kwargs))
+        return wrapped
+    App.debounce = debounce
+
+    def throttle(self, wait_ms, func):
+        last = {"time": 0.0}
+        def wrapped(*args, **kwargs):
+            now = time.monotonic() * 1000
+            if now - last["time"] >= wait_ms:
+                last["time"] = now
+                return func(*args, **kwargs)
+        return wrapped
+    App.throttle = throttle

easypyui-2.4.0/easypyui.egg-info/PKG-INFO

@@ -0,0 +1,199 @@
+Metadata-Version: 2.4
+Name: easypyui
+Version: 2.4.0
+Summary: A simple and modern Python GUI library built on tkinter and ttk
+Author: EasyPyUI
+License: MIT
+Project-URL: Homepage, https://pypi.org/project/easypyui/
+Keywords: gui,tkinter,ttk,desktop,ui,python-gui
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# EasyPyUI
+
+**Build modern Python desktop GUIs with much less code than raw tkinter.**
+
+EasyPyUI is a lightweight GUI library built on Python's standard `tkinter` and `ttk`.
+It provides a short beginner-friendly API while keeping access to native Tk widgets.
+
+## Installation
+
+```bash
+pip install easypyui
+```
+
+## Quick Start
+
+```python
+from easypyui import *
+
+app("Hello EasyPyUI", 500, 400, appearance="dark")
+title("Hello!")
+
+name = minput("Name", placeholder="Your name")
+mbutton("Say hello", lambda: notify("Hello " + name.get()))
+
+fade_in(400)
+run()
+```
+
+## Modern UI
+
+EasyPyUI 2.x includes `mbutton()`, `minput()`, `mswitch()`, `mcard()`,
+Light/Dark appearance and custom accent colors.
+
+```python
+app("Dashboard", 700, 500, appearance="dark", accent="#8b5cf6")
+```
+
+## Animation
+
+```python
+ring = progress_ring(20, size=110)
+mbutton("Start", lambda: ring.animate_to(100, 1000))
+fade_in(500)
+```
+
+Easing modes: `linear`, `ease_in`, `ease_out`, `ease_in_out`.
+
+## Pages / Router
+
+```python
+from easypyui import *
+
+app("Pages", 500, 350)
+
+def home(ui):
+    title("Home")
+    on("Settings", lambda: go("settings"))
+
+def settings(ui):
+    title("Settings")
+    on("Back", lambda: go("home"))
+
+route("home", home)
+route("settings", settings)
+go("home")
+run()
+```
+
+## Background Tasks
+
+```python
+def work():
+    import time
+    time.sleep(2)
+    return "Done!"
+
+run_task(work, done=lambda result: notify(result), loading_text="Working...")
+```
+
+## Native tkinter access
+
+Most EasyPyUI wrapper objects expose `.tk`:
+
+```python
+btn = mbutton("Test", lambda: print("clicked"))
+btn.tk.bind("<Button-2>", lambda event: print("middle click"))
+```
+
+## Classic API
+
+The older API remains available, including `window()`, `text()`, `inputbox()`,
+`button()`, `table()`, `canvas()` and `start()`.
+
+## Requirements
+
+- Python 3.9+
+- tkinter support in your Python installation
+- No mandatory third-party runtime GUI dependency
+
+## License
+
+MIT License
+
+## Version
+
+Current release: **2.4.0**
+
+2.2.1 is a PyPI metadata and documentation update for the 2.2 series.
+
+
+## 2.3 Productivity APIs
+
+### Form validation
+
+```python
+f = form()
+
+email = f.add(
+    "Email",
+    minput("Email"),
+    [Validator.required(), Validator.email()]
+)
+
+password_box = f.add(
+    "Password",
+    minput("Password", password=True),
+    [Validator.required(), Validator.min_length(8)]
+)
+
+def submit():
+    ok, errors = f.validate()
+    if ok:
+        notify(str(f.values()))
+
+mbutton("Submit", submit)
+```
+
+### Reactive State
+
+```python
+count = state(0)
+
+label_widget = text("0")
+count.bind_text(label_widget)
+
+mbutton("+1", lambda: count.update(lambda n: n + 1))
+```
+
+### Keyboard shortcuts
+
+```python
+shortcut("ctrl+s", save)
+shortcut("ctrl+q", close)
+```
+
+### Debounce / Throttle
+
+```python
+search = debounce(300, do_search)
+resize_handler = throttle(100, update_layout)
+```
+
+
+## 2.4 Large Application Widgets
+
+- `datatable()` — search, sorting and pagination
+- `modal()` — modal window
+- `drawer()` — collapsible side drawer
+- `accordion()` — expandable sections
+- `datepicker()` — date value input
+- `notifications()` — notification center
+
+```python
+table = datatable(["name", "score"], ["Name", "Score"], page_size=5)
+table.set_rows([
+    ("Noah", 100),
+    ("Daniel", 95),
+])
+```

{easypyui-2.2.0 → easypyui-2.4.0}/easypyui.egg-info/SOURCES.txt

@@ -1,9 +1,12 @@
+LICENSE
 README.md
 pyproject.toml
 easypyui/__init__.py
 easypyui/animation.py
 easypyui/core.py
+easypyui/largeapp.py
 easypyui/modern.py
+easypyui/productivity.py
 easypyui.egg-info/PKG-INFO
 easypyui.egg-info/SOURCES.txt
 easypyui.egg-info/dependency_links.txt

easypyui-2.4.0/pyproject.toml

@@ -0,0 +1,29 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "easypyui"
+version = "2.4.0"
+description = "A simple and modern Python GUI library built on tkinter and ttk"
+readme = {file = "README.md", content-type = "text/markdown"}
+requires-python = ">=3.9"
+license = {text = "MIT"}
+authors = [{name = "EasyPyUI"}]
+keywords = ["gui", "tkinter", "ttk", "desktop", "ui", "python-gui"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Software Development :: User Interfaces"
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/easypyui/"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["easypyui*"]

easypyui-2.2.0/PKG-INFO

@@ -1,7 +0,0 @@
-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

@@ -1,49 +0,0 @@
-# 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.egg-info/PKG-INFO

@@ -1,7 +0,0 @@
-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/pyproject.toml

@@ -1,14 +0,0 @@
-[build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
-
-[project]
-name = "easypyui"
-version = "2.2.0"
-description = "A concise modern GUI wrapper for tkinter and ttk"
-requires-python = ">=3.9"
-license = {text = "MIT"}
-keywords = ["gui", "tkinter", "ttk", "easy", "desktop"]
-
-[tool.setuptools]
-packages = ["easypyui"]