easypyui 2.4.0__tar.gz → 3.0.0__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: easypyui
-Version: 2.4.0
+Version: 3.0.0
 Summary: A simple and modern Python GUI library built on tkinter and ttk
 Author: EasyPyUI
 License: MIT
@@ -123,7 +123,7 @@ MIT License
 
 ## Version
 
-Current release: **2.4.0**
+Current release: **3.0.0**
 
 2.2.1 is a PyPI metadata and documentation update for the 2.2 series.
 
@@ -197,3 +197,50 @@ table.set_rows([
     ("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.4.0/PKG-INFO → easypyui-3.0.0/README.md

@@ -1,199 +1,226 @@
-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
+
+**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.4.0 → easypyui-3.0.0}/easypyui/__init__.py

@@ -1,6 +1,6 @@
 from .core import App, Value, Widget, Table, Canvas, Container, Row
 
-__version__ = "2.4.0"
+__version__ = "3.0.0"
 
 _current = None
 
@@ -119,3 +119,9 @@ 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.4.0 → easypyui-3.0.0}/easypyui/core.py

@@ -1196,3 +1196,8 @@ 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/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.4.0/README.md → easypyui-3.0.0/easypyui.egg-info/PKG-INFO

@@ -1,179 +1,246 @@
-# 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),
-])
-```
+Metadata-Version: 2.4
+Name: easypyui
+Version: 3.0.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: **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.4.0 → easypyui-3.0.0}/easypyui.egg-info/SOURCES.txt

@@ -2,12 +2,19 @@ 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/top_level.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.4.0 → easypyui-3.0.0}/pyproject.toml

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