easypyui 2.2.1__tar.gz → 3.0.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easypyui
-Version: 2.2.1
+Version: 3.0.0
 Summary: A simple and modern Python GUI library built on tkinter and ttk
 Author: EasyPyUI
 License: MIT
@@ -123,6 +123,124 @@ MIT License
 
 ## Version
 
-Current release: **2.2.1**
+Current release: **3.0.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 3.0
+
+EasyPyUI 3.0 moves beyond a tkinter helper toward a small application framework.
+
+## Reactive UI
+
+```python
+name = state("Noah")
+upper = computed(lambda: name.get().upper(), name)
+
+field = minput("Name")
+bind(field, name)
+text_widget = text("")
+upper.bind_text(text_widget)
+```
+
+## AppShell
+
+```python
+ui = shell("My App")
+
+ui.page("home", "Home", lambda parent: __import__("tkinter").Label(parent, text="Home").pack())
+ui.page("settings", "Settings", lambda parent: __import__("tkinter").Label(parent, text="Settings").pack())
+ui.start("home")
+```
+
+## Design Tokens
+
+```python
+design(radius=12, spacing=10, font="Segoe UI", title_size=24)
+```
+
+## CLI
+
+```bash
+easypyui new my_app
+cd my_app
+python app.py
+```
+
+## Included from 2.x
+
+Modern widgets, animations, routing, background tasks, forms and validators,
+state management, shortcuts, debounce/throttle, DataTable, Modal, Drawer,
+Accordion, DatePicker and NotificationCenter remain available.

easypyui-3.0.0/README.md

@@ -0,0 +1,226 @@
+# 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: **3.0.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 3.0
+
+EasyPyUI 3.0 moves beyond a tkinter helper toward a small application framework.
+
+## Reactive UI
+
+```python
+name = state("Noah")
+upper = computed(lambda: name.get().upper(), name)
+
+field = minput("Name")
+bind(field, name)
+text_widget = text("")
+upper.bind_text(text_widget)
+```
+
+## AppShell
+
+```python
+ui = shell("My App")
+
+ui.page("home", "Home", lambda parent: __import__("tkinter").Label(parent, text="Home").pack())
+ui.page("settings", "Settings", lambda parent: __import__("tkinter").Label(parent, text="Settings").pack())
+ui.start("home")
+```
+
+## Design Tokens
+
+```python
+design(radius=12, spacing=10, font="Segoe UI", title_size=24)
+```
+
+## CLI
+
+```bash
+easypyui new my_app
+cd my_app
+python app.py
+```
+
+## Included from 2.x
+
+Modern widgets, animations, routing, background tasks, forms and validators,
+state management, shortcuts, debounce/throttle, DataTable, Modal, Drawer,
+Accordion, DatePicker and NotificationCenter remain available.

{easypyui-2.2.1 → easypyui-3.0.0}/easypyui/__init__.py

@@ -1,6 +1,6 @@
 from .core import App, Value, Widget, Table, Canvas, Container, Row
 
-__version__ = "2.2.1"
+__version__ = "3.0.0"
 
 _current = None
 
@@ -103,3 +103,25 @@ 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()
+
+from .reactive import ComputedState, computed, bind
+from .shell import AppShell
+from .theme3 import ThemeConfig, DEFAULT_TOKENS
+def shell(*a, **k): return _app().shell(*a, **k)
+def design(**tokens): return _app().design(**tokens)

easypyui-3.0.0/easypyui/__main__.py

@@ -0,0 +1,2 @@
+from .cli import main
+raise SystemExit(main())

easypyui-3.0.0/easypyui/cli.py

@@ -0,0 +1,27 @@
+import argparse
+from pathlib import Path
+
+TEMPLATE = """from easypyui import *
+
+app("{title}", 720, 480, appearance="dark")
+title("{title}")
+label("Created with EasyPyUI 3.0")
+mbutton("Hello", lambda: notify("Hello EasyPyUI!"))
+run()
+"""
+
+def main(argv=None):
+    parser=argparse.ArgumentParser(prog="easypyui",description="EasyPyUI project tools")
+    sub=parser.add_subparsers(dest="command")
+    new=sub.add_parser("new",help="Create a new EasyPyUI project")
+    new.add_argument("name"); new.add_argument("--title",default=None)
+    args=parser.parse_args(argv)
+    if args.command=="new":
+        root=Path(args.name); root.mkdir(parents=True,exist_ok=True)
+        (root/"app.py").write_text(TEMPLATE.format(title=args.title or args.name),encoding="utf-8")
+        (root/"README.md").write_text(f"# {args.name}\\n\\nRun with `python app.py`.\\n",encoding="utf-8")
+        print(f"Created {root.resolve()}")
+        return 0
+    parser.print_help(); return 0
+
+if __name__=="__main__": raise SystemExit(main())

{easypyui-2.2.1 → easypyui-3.0.0}/easypyui/core.py

@@ -1190,3 +1190,14 @@ 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)
+
+from .shell import install_shell_api
+install_shell_api(App, _Builder)
+from .theme3 import install_theme3_api
+install_theme3_api(App, _Builder)

easypyui-3.0.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-3.0.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-3.0.0/easypyui/reactive.py

@@ -0,0 +1,43 @@
+class ComputedState:
+    def __init__(self, func, *deps):
+        self.func=func; self._listeners=[]
+        self._value=func()
+        for dep in deps:
+            dep.watch(lambda _v, self=self: self._refresh())
+    def _refresh(self):
+        new=self.func()
+        if new != self._value:
+            self._value=new
+            for cb in list(self._listeners): cb(new)
+    def get(self): return 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(v):
+            try: widget.set(v)
+            except Exception:
+                try: widget.config(text=str(v))
+                except Exception: pass
+        self.watch(apply, True); return self
+
+def computed(func, *deps): return ComputedState(func, *deps)
+
+def bind(widget, state, event="<KeyRelease>"):
+    try: widget.set(state.get())
+    except Exception: pass
+    def from_state(v):
+        try:
+            if widget.get() != v: widget.set(v)
+        except Exception: pass
+    state.watch(from_state)
+    tkobj=getattr(widget,"tk",widget)
+    def from_widget(_event=None):
+        try: state.set(widget.get())
+        except Exception: pass
+    try: tkobj.bind(event,from_widget,add="+")
+    except Exception: pass
+    return widget

easypyui-3.0.0/easypyui/shell.py

@@ -0,0 +1,34 @@
+import tkinter as tk
+from tkinter import ttk
+
+class AppShell:
+    def __init__(self, app, title="EasyPyUI", sidebar_width=210):
+        self.app=app; self.pages={}; self.buttons={}; self.current=None
+        try: app.clear_body()
+        except Exception: pass
+        self.frame=ttk.Frame(app.body); self.frame.pack(fill="both",expand=True)
+        self.sidebar=tk.Frame(self.frame,width=sidebar_width)
+        self.sidebar.pack(side="left",fill="y"); self.sidebar.pack_propagate(False)
+        self.main=ttk.Frame(self.frame); self.main.pack(side="left",fill="both",expand=True)
+        tk.Label(self.sidebar,text=title,font=("",16,"bold"),anchor="w",padx=14,pady=14).pack(fill="x")
+        self.content=ttk.Frame(self.main,padding=16); self.content.pack(fill="both",expand=True)
+        self.tk=self.frame
+    def page(self,name,label=None,builder=None):
+        self.pages[name]=builder
+        b=tk.Button(self.sidebar,text=label or name,anchor="w",relief="flat",
+                    command=lambda:self.go(name),padx=14,pady=8)
+        b.pack(fill="x"); self.buttons[name]=b; return self
+    def go(self,name):
+        if name not in self.pages: raise KeyError(name)
+        for child in self.content.winfo_children(): child.destroy()
+        self.current=name
+        builder=self.pages[name]
+        if builder: builder(self.content)
+        return self
+    def start(self,name=None):
+        target=name or (next(iter(self.pages)) if self.pages else None)
+        if target: self.go(target)
+        return self
+
+def install_shell_api(App,Builder):
+    App.shell=lambda self,*a,**k: AppShell(self,*a,**k)

easypyui-3.0.0/easypyui/theme3.py

@@ -0,0 +1,15 @@
+DEFAULT_TOKENS = {
+ "radius": 10, "spacing": 8, "font": "Segoe UI", "font_size": 10,
+ "title_size": 22, "control_height": 36
+}
+class ThemeConfig:
+    def __init__(self, **tokens):
+        self.tokens=dict(DEFAULT_TOKENS); self.tokens.update(tokens)
+    def get(self,key,default=None): return self.tokens.get(key,default)
+    def update(self,**tokens): self.tokens.update(tokens); return self
+
+def install_theme3_api(App,Builder):
+    def design(self,**tokens):
+        if not hasattr(self,"_design_tokens"): self._design_tokens=ThemeConfig()
+        self._design_tokens.update(**tokens); return self._design_tokens
+    App.design=design

{easypyui-2.2.1 → easypyui-3.0.0}/easypyui.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easypyui
-Version: 2.2.1
+Version: 3.0.0
 Summary: A simple and modern Python GUI library built on tkinter and ttk
 Author: EasyPyUI
 License: MIT
@@ -123,6 +123,124 @@ MIT License
 
 ## Version
 
-Current release: **2.2.1**
+Current release: **3.0.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 3.0
+
+EasyPyUI 3.0 moves beyond a tkinter helper toward a small application framework.
+
+## Reactive UI
+
+```python
+name = state("Noah")
+upper = computed(lambda: name.get().upper(), name)
+
+field = minput("Name")
+bind(field, name)
+text_widget = text("")
+upper.bind_text(text_widget)
+```
+
+## AppShell
+
+```python
+ui = shell("My App")
+
+ui.page("home", "Home", lambda parent: __import__("tkinter").Label(parent, text="Home").pack())
+ui.page("settings", "Settings", lambda parent: __import__("tkinter").Label(parent, text="Settings").pack())
+ui.start("home")
+```
+
+## Design Tokens
+
+```python
+design(radius=12, spacing=10, font="Segoe UI", title_size=24)
+```
+
+## CLI
+
+```bash
+easypyui new my_app
+cd my_app
+python app.py
+```
+
+## Included from 2.x
+
+Modern widgets, animations, routing, background tasks, forms and validators,
+state management, shortcuts, debounce/throttle, DataTable, Modal, Drawer,
+Accordion, DatePicker and NotificationCenter remain available.

easypyui-3.0.0/easypyui.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+easypyui/__init__.py
+easypyui/__main__.py
+easypyui/animation.py
+easypyui/cli.py
+easypyui/core.py
+easypyui/largeapp.py
+easypyui/modern.py
+easypyui/productivity.py
+easypyui/reactive.py
+easypyui/shell.py
+easypyui/theme3.py
+easypyui.egg-info/PKG-INFO
+easypyui.egg-info/SOURCES.txt
+easypyui.egg-info/dependency_links.txt
+easypyui.egg-info/entry_points.txt
+easypyui.egg-info/top_level.txt
+tests/test_public_api.py

easypyui-3.0.0/easypyui.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+easypyui = easypyui.cli:main

{easypyui-2.2.1 → easypyui-3.0.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "easypyui"
-version = "2.2.1"
+version = "3.0.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"
@@ -27,3 +27,6 @@ Homepage = "https://pypi.org/project/easypyui/"
 [tool.setuptools.packages.find]
 where = ["."]
 include = ["easypyui*"]
+
+[project.scripts]
+easypyui = "easypyui.cli:main"

easypyui-3.0.0/tests/test_public_api.py

@@ -0,0 +1,5 @@
+import easypyui
+
+def test_api():
+    for name in ["run_task","state","computed","bind","shell","datatable","modal","design"]:
+        assert hasattr(easypyui,name), name

easypyui-2.2.1/README.md

@@ -1,108 +0,0 @@
-# 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.2.1**
-
-2.2.1 is a PyPI metadata and documentation update for the 2.2 series.

easypyui-2.2.1/easypyui.egg-info/SOURCES.txt

@@ -1,11 +0,0 @@
-LICENSE
-README.md
-pyproject.toml
-easypyui/__init__.py
-easypyui/animation.py
-easypyui/core.py
-easypyui/modern.py
-easypyui.egg-info/PKG-INFO
-easypyui.egg-info/SOURCES.txt
-easypyui.egg-info/dependency_links.txt
-easypyui.egg-info/top_level.txt