easypyui 2.2.1__tar.gz → 2.4.0__tar.gz

{easypyui-2.2.1 → easypyui-2.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easypyui
-Version: 2.2.1
+Version: 2.4.0
 Summary: A simple and modern Python GUI library built on tkinter and ttk
 Author: EasyPyUI
 License: MIT
@@ -123,6 +123,77 @@ MIT License
 
 ## Version
 
-Current release: **2.2.1**
+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.1 → easypyui-2.4.0}/README.md

@@ -103,6 +103,77 @@ MIT License
 
 ## Version
 
-Current release: **2.2.1**
+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.1 → easypyui-2.4.0}/easypyui/__init__.py

@@ -1,6 +1,6 @@
 from .core import App, Value, Widget, Table, Canvas, Container, Row
 
-__version__ = "2.2.1"
+__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.1 → 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.2.1 → easypyui-2.4.0}/easypyui.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easypyui
-Version: 2.2.1
+Version: 2.4.0
 Summary: A simple and modern Python GUI library built on tkinter and ttk
 Author: EasyPyUI
 License: MIT
@@ -123,6 +123,77 @@ MIT License
 
 ## Version
 
-Current release: **2.2.1**
+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.1 → easypyui-2.4.0}/easypyui.egg-info/SOURCES.txt

@@ -4,7 +4,9 @@ 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.2.1 → easypyui-2.4.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "easypyui"
-version = "2.2.1"
+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"