flexgui 1.0.0__py3-none-any.whl

flexgui/__init__.py

@@ -0,0 +1,71 @@
+# -*- coding: utf-8 -*-
+"""
+FlexGUI — thư viện GUI Python kéo-thả-thiết-kế trên nền tkinter.
+
+    pip install flexgui
+
+ĐỒNG GÓI 2 PHẦN TRONG 1 THƯ VIỆN:
+
+  (A) THƯ VIỆN RUNTIME — cú pháp gọn, định vị tuyệt đối bằng place(x, y):
+
+        import flexgui
+        from flexgui import App, Label, Button, Input, Checkbox, Text
+
+        app = App("Ứng dụng của tôi", 860, 560)
+        Label("Xin chào!", 40, 30)
+        Button("Bấm tôi", 40, 80)
+        Input(40, 130, width=26)
+        Checkbox("Đồng ý", 40, 180)
+        Text(40, 230, width=42, height=7)
+        app.run()
+
+  (B) CHẾ ĐỘ THIẾT KẾ (FlexGUI Studio) — mở bằng MỘT trong các cách:
+
+        import flexgui
+        flexgui.setup()               # cách 1 — mở Studio ngay
+
+        from flexgui import design    # cách 2 — tương đương
+        design.mode = True
+
+        python myapp.py --design      # cách 3 — cờ dòng lệnh
+
+      → Chạy file ở design mode: Studio tự tạo GIAO DIỆN TRỐNG (hoặc nạp
+        myapp.flexgui.json đã lưu). Kéo thả thành phần, chỉnh thuộc tính,
+        viết trigger bằng mini VS Code ngay trong Studio HOẶC mở file
+        myapp.triggers.py bằng VS Code thật — cả hai sửa CÙNG một file.
+
+      → Chạy thật: đổi setup() thành flexgui.run(__file__) rồi chạy lại.
+
+Truy cập widget theo ID (tự động, tái sử dụng ID khi xóa):
+        from flexgui import label, button, input, checkbox, text
+        label[1].set_text("Xin chào!")     # đọc/ghi thuộc tính trực tiếp
+
+Chi tiết: README.md đi kèm package.
+"""
+
+from .mode import design
+from .registry import label, button, input, checkbox, text
+from .triggers import (
+    on_click, on_change, on_enter, when, every, on_init,
+    refresh, set_title, set_size, set_bg, alert, confirm, prompt, close_app,
+)
+from .widgets import Label, Button, Input, Checkbox, Text
+from .app import App
+from .runtime import run, setup, run_embedded
+
+__version__ = "1.0.0"
+__author__ = "FlexGUI Team"
+
+__all__ = [
+    # cửa sổ & widget
+    "App", "Label", "Button", "Input", "Checkbox", "Text",
+    # vùng tên theo ID
+    "label", "button", "input", "checkbox", "text",
+    # chế độ thiết kế & chạy
+    "design", "setup", "run", "run_embedded",
+    # decorator trigger
+    "on_click", "on_change", "on_enter", "when", "every", "on_init",
+    # lệnh app
+    "refresh", "set_title", "set_size", "set_bg",
+    "alert", "confirm", "prompt", "close_app",
+]

flexgui/app.py

@@ -0,0 +1,221 @@
+# -*- coding: utf-8 -*-
+"""
+App — cửa sổ ứng dụng + đăng ký widget (ID tái sử dụng) + vòng đời chạy.
+
+    from flexgui import App, Label, Button
+
+    app = App("Ứng dụng của tôi", 860, 560)
+    Label("Xin chào!", 40, 30)
+    app.run()                        # chạy thật
+    app.run(design_mode=True)        # chuyển sang FlexGUI Studio
+
+ID tái sử dụng (từ phiên bản trước, giữ nguyên): widget bị xóa trả ID
+về pool; widget tạo kế tiếp nhận ID nhỏ nhất vừa rảnh — ví dụ xóa
+input[3] rồi thêm widget mới thì widget mới đúng là [3].
+"""
+
+import heapq
+import sys
+from pathlib import Path
+
+import tkinter as tk
+
+from . import registry as _reg
+from .mode import design
+from .theme import MAU_APP
+from .triggers import TriggerEngine
+
+
+def _doc_co_design(argv=None):
+    """Đọc cờ --design từ dòng lệnh (giữ tương thích thói quen cũ)."""
+    argv = sys.argv if argv is None else argv
+    return any(str(a).lower() in ("--design", "-design") for a in argv)
+
+
+class App:
+    """Cửa sổ ứng dụng.
+
+    Tham số:
+      title, width, height : tiêu đề + kích thước cửa sổ
+      bg                   : màu nền (mặc định #f5f6fa)
+      goc                  : None = cửa sổ chính (tk.Tk)
+                             tk widget = cửa sổ con (Toplevel) — dùng khi
+                             Studio mở bản XEM TRƯỚC, không chặn Studio.
+    """
+
+    def __init__(self, title="Ứng dụng FlexGUI", width=860, height=560,
+                 bg=None, goc=None):
+        self.title = title
+        self.width = int(width)
+        self.height = int(height)
+        self._nen = bg or MAU_APP["nen_mac_dinh"]
+        self.xem_truoc = goc is not None      # True = bản xem trước từ Studio
+        self.dang_thiet_ke = False
+
+        if goc is None:
+            self.root = tk.Tk()
+        else:
+            self.root = tk.Toplevel(goc)
+            self.root.title(title)
+        self.root.geometry(f"{self.width}x{self.height}")
+        self.root.minsize(320, 200)
+        self.root.configure(bg=self._nen)
+        self.khung = tk.Frame(self.root, bg=self._nen)
+        self.khung.pack(fill="both", expand=True)
+
+        # Sổ đăng ký widget
+        self.widgets = {}                       # id -> widget (mọi loại)
+        self.theo_loai = {                      # loại -> {id -> widget}
+            "label": {}, "button": {}, "input": {}, "checkbox": {}, "text": {},
+        }
+        self._id_tiep_theo = 1                   # ID mới kế tiếp (pool rỗng)
+        self._id_tu_do = []                      # pool ID đã xóa — TÁI SỬ DỤNG
+
+        # Hệ thống trigger + cổng chặn khi ở chế độ thiết kế
+        self.dong_co = TriggerEngine(self)
+        self.trigger_nguon = {}
+        self._cho_phep_thu_kich = False
+        self.designer = None
+
+        _reg._dat_app(self)
+
+    # ------------------------------------------------------------ vòng đời
+    def con_song(self):
+        """Cửa sổ còn tồn tại không (để registry tự dọn app chết)."""
+        try:
+            return bool(self.root.winfo_exists())
+        except Exception:
+            return False
+
+    # ------------------------------------------------------------ đăng ký ID
+    def _dang_ky(self, wgt, id=None):
+        """Cấp ID duy nhất — ưu tiên ID nhỏ nhất trong pool TÁI SỬ DỤNG."""
+        if id is None:
+            if self._id_tu_do:
+                id = heapq.heappop(self._id_tu_do)
+            else:
+                id = self._id_tiep_theo
+        id = int(id)
+        if id in self.widgets:
+            raise ValueError(f"ID {id} đã được widget khác sử dụng!")
+        if id in self._id_tu_do:          # id tường minh trùng id đang rảnh
+            self._id_tu_do.remove(id)
+            heapq.heapify(self._id_tu_do)
+        if id >= self._id_tiep_theo:
+            self._id_tiep_theo = id + 1
+        self.widgets[id] = wgt
+        self.theo_loai[wgt.loai][id] = wgt
+        return id
+
+    def _huy_dang_ky(self, wgt):
+        """Gỡ widget khỏi sổ đăng ký — ID trả về pool TÁI SỬ DỤNG."""
+        self.widgets.pop(wgt.id, None)
+        self.theo_loai.get(wgt.loai, {}).pop(wgt.id, None)
+        self.trigger_nguon.pop(wgt.id, None)
+        self.dong_co._click.pop(wgt.id, None)
+        self.dong_co._change.pop(wgt.id, None)
+        self.dong_co._enter.pop(wgt.id, None)
+        if wgt.id is not None and wgt.id not in self._id_tu_do:
+            heapq.heappush(self._id_tu_do, wgt.id)
+
+    # ------------------------------------------------------------ tiện ích
+    def bg(self, mau):
+        """Đổi màu nền cửa sổ."""
+        self._nen = mau
+        self.root.config(bg=mau)
+        self.khung.config(bg=mau)
+        for w in self.widgets.values():
+            try:
+                if w._mau_nen is None and w.loai in ("label", "checkbox"):
+                    w.tkw.config(bg=mau)
+                    if w.loai == "checkbox":
+                        w.tkw.config(activebackground=mau)
+            except Exception:
+                pass
+
+    def dat_trigger_chung(self, code):
+        """Gán đoạn code trigger CHUNG (giữ tương thích bản cũ)."""
+        self.trigger_nguon["global"] = code or ""
+
+    def lay_thiet_ke(self):
+        """Chụp toàn bộ app thành dict thiết kế (dùng khi --design trên
+        app viết bằng code thuần: chuyển code thành thiết kế chỉnh được)."""
+        return {
+            "window": {
+                "title": self.title,
+                "width": self.width,
+                "height": self.height,
+                "bg": self._nen,
+            },
+            "components": [w.lay_du_lieu()
+                           for w in self.widgets.values()],
+        }
+
+    # ------------------------------------------------------------ chạy
+    def run(self, design_mode=None, chay_mainloop=True):
+        """Khởi động ứng dụng.
+
+        design_mode=None : tự đọc design.mode (flexgui.design) + cờ --design
+        design_mode=True : chuyển sang FlexGUI Studio (mang theo toàn bộ
+                           widget đang có — thiết kế tiếp bằng kéo thả)
+        chay_mainloop=False : chỉ kích hoạt engine, không vào mainloop
+                             (dùng cho bản XEM TRƯỚC của Studio).
+        """
+        if design_mode is None:
+            design_mode = design.mode or _doc_co_design()
+        if design_mode:
+            from .designer import Studio
+            thiet_ke = self.lay_thiet_ke()
+            design._danh_dau_da_mo()
+            # file .py của người dùng (nếu chạy python myapp.py --design)
+            file_py = None
+            try:
+                if sys.argv and sys.argv[0].endswith(".py") \
+                        and Path(sys.argv[0]).exists():
+                    file_py = Path(sys.argv[0]).resolve()
+            except Exception:
+                pass
+            # Đóng cửa sổ code thuần (chưa vào mainloop nên chỉ cần destroy)
+            self.dong_co.dung()
+            try:
+                self.root.destroy()
+            except Exception:
+                pass
+            _reg._dat_app(None)
+            st = Studio(duong_dan=file_py, thiet_ke_ban_dau=thiet_ke)
+            st.chay()
+            return st
+
+        self._cho_phep_thu_kich = True
+        self.dong_co.bat_dau()
+
+        if self.xem_truoc:
+            # Bản xem trước từ Studio: đóng = dọn dẹp + destroy Toplevel
+            self.root.protocol("WM_DELETE_WINDOW", self._dong_xem_truoc)
+        else:
+            self.root.protocol("WM_DELETE_WINDOW", self._dong_app)
+
+        if chay_mainloop:
+            self.root.mainloop()
+
+    def _dong_app(self):
+        """Đóng ứng dụng thật: dừng engine, thoát mainloop rồi hủy."""
+        self.dong_co.dung()
+        try:
+            self.root.quit()
+        except Exception:
+            pass
+        try:
+            self.root.destroy()
+        except Exception:
+            pass
+
+    def _dong_xem_truoc(self):
+        """Đóng bản XEM TRƯỚC (Studio vẫn sống)."""
+        self.dong_co.dung()
+        try:
+            self.root.destroy()
+        except Exception:
+            pass
+        if _reg._app_hien_tai() is self:
+            _reg._dat_app(None)

flexgui/builder.py

@@ -0,0 +1,211 @@
+# -*- coding: utf-8 -*-
+"""
+Builder — xuất file chạy đơn & đóng gói .exe bằng PyInstaller.
+
+  • xuat_file_dung()  : gộp thiết kế + trigger thành MỘT file .py duy nhất
+                        (chạy được ngay: cần đã cài pip install flexgui)
+  • TrinhDongGoi      : chạy pyinstaller trong thread nền, log realtime,
+                        tự cài pyinstaller nếu thiếu
+"""
+
+import os
+import queue
+import subprocess
+import sys
+import threading
+
+import tkinter as tk
+from tkinter import ttk, messagebox
+
+from .theme import MAU, font_ui, font_mono
+
+
+def xuat_file_dung(duong_dan, thiet_ke, nguon_trigger):
+    """Ghi file .py tự chạy (nhúng toàn bộ thiết kế + trigger).
+
+    duong_dan : file .py đích (ví dụ myapp_app.py)
+    thiet_ke  : dict thiết kế (window + components)
+    nguon_trigger : chuỗi code trigger (file .triggers.py)
+    Trả về đường dẫn đã ghi.
+    """
+    import pprint
+
+    ten = os.path.splitext(os.path.basename(duong_dan))[0]
+    body = (
+        f"# {'=' * 74}\n"
+        f"# {ten} — sinh bởi FlexGUI Studio\n"
+        f"# Chạy:  python {os.path.basename(duong_dan)}\n"
+        f"# Cần:   pip install flexgui\n"
+        f"# {'=' * 74}\n"
+        f"import flexgui\n"
+        f"\n"
+        f"_THIET_KE = "
+    )
+    # pprint.pformat sinh literal PYTHON đúng (None/True/False, chuỗi '...')
+    body += pprint.pformat(thiet_ke, width=68)
+    body += "\n\n_TRIGGERS = "
+    body += pprint.pformat(nguon_trigger or "", width=68)
+    body += "\n\nflexgui.run_embedded(_THIET_KE, _TRIGGERS)\n"
+
+    with open(duong_dan, "w", encoding="utf-8") as f:
+        f.write(body)
+    return duong_dan
+
+
+class TrinhDongGoi:
+    """Đóng gói file .py thành file thực thi duy nhất (.exe trên Windows).
+
+    Quy trình tự động trong thread nền (không đơ giao diện):
+      1. Kiểm tra PyInstaller → thiếu thì pip install tự động
+      2. pyinstaller --onefile --windowed --name <tên> <file.py>
+      3. Kết quả: dist/<tên>.exe — log hiển thị trực tiếp trong cửa sổ
+    """
+
+    def __init__(self, goc, ten="ung_dung"):
+        self.goc = goc                    # cửa sổ cha (root Studio)
+        self.ten = ten
+        self.hang_doi = queue.Queue()
+        self._xong = False
+        self._thanh_cong = False
+        self._duong_dan_dist = None
+
+    # ------------------------------------------------------------ giao diện
+    def chay(self, duong_dan):
+        """Mở cửa sổ build rồi chạy build trong thread nền."""
+        cs = tk.Toplevel(self.goc)
+        cs.title(f"Đóng gói .exe — {self.ten}")
+        cs.geometry("780x460")
+        cs.configure(bg=MAU["nen_panel"])
+        cs.transient(self.goc)
+        self.cua_so = cs
+
+        tk.Label(cs, text="⏳ PyInstaller đang làm việc — có thể mất 1–3 phút "
+                          "lần đầu (nếu phải cài đặt).",
+                 bg=MAU["nen_panel"], fg=MAU["chu"], anchor="w",
+                 font=font_ui(10)).pack(fill="x", padx=14, pady=(12, 6))
+
+        self.thanh_tien = ttk.Progressbar(cs, mode="indeterminate")
+        self.thanh_tien.pack(fill="x", padx=14)
+        self.thanh_tien.start(14)
+
+        self.nhat_ky = tk.Text(cs, bg="#141414", fg=MAU["chu"], bd=0,
+                               font=font_mono(10), wrap="none",
+                               state="disabled")
+        self.nhat_ky.pack(fill="both", expand=True, padx=14, pady=(6, 6))
+
+        duoi = tk.Frame(cs, bg=MAU["nen_panel"])
+        duoi.pack(fill="x", padx=14, pady=(0, 12))
+        tk.Button(duoi, text="📂 Mở thư mục dist", state="disabled",
+                  bg=MAU["nen_nut"], fg=MAU["chu_mo"], bd=0,
+                  padx=12, pady=4, font=font_ui(9), cursor="hand2",
+                  command=self._mo_thu_muc).pack(side="right")
+
+        threading.Thread(target=self._thuc_thi, args=(duong_dan,),
+                         daemon=True).start()
+        self._do_hang()
+
+    def _ghi(self, s):
+        """Thread nền ghi log vào queue (thread-safe)."""
+        self.hang_doi.put(s)
+
+    def _do_hang(self):
+        """Vòng poll 150ms: rút log từ queue, phát hiện trạng thái kết thúc."""
+        try:
+            while True:
+                dong = self.hang_doi.get_nowait()
+                self.nhat_ky.config(state="normal")
+                self.nhat_ky.insert("end", dong)
+                self.nhat_ky.see("end")
+                self.nhat_ky.config(state="disabled")
+        except queue.Empty:
+            pass
+        if self._xong:
+            self.thanh_tien.stop()
+            if self._thanh_cong:
+                messagebox.showinfo(
+                    "Build xong", "Đã tạo file thực thi thành công!\n\n"
+                    f"{self._duong_dan_dist}", parent=self.cua_so)
+        else:
+            self.cua_so.after(150, self._do_hang)
+
+    def _mo_thu_muc(self):
+        """Mở thư mục chứa kết quả (đa nền tảng)."""
+        thu_muc = os.path.dirname(self._duong_dan_dist or "")
+        try:
+            if sys.platform.startswith("win"):
+                os.startfile(thu_muc)             # type: ignore[attr-defined]
+            elif sys.platform == "darwin":
+                subprocess.Popen(["open", thu_muc])
+            else:
+                subprocess.Popen(["xdg-open", thu_muc])
+        except Exception:
+            messagebox.showinfo("Thư mục", thu_muc, parent=self.cua_so)
+
+    # ------------------------------------------------------------ quy trình
+    def _moi_truong_build(self):
+        """Môi trường cho lệnh build.
+
+        Trên Linux với Python "di động" (uv, pyenv...), libtcl/libtk nằm
+        ngoài LD_LIBRARY_PATH mặc định nên PyInstaller không nhúng được —
+        thêm thư mục đó vào để file chạy được trên mọi máy.
+        """
+        import glob
+        mt = os.environ.copy()
+        if os.name == "posix":
+            thu_muc = os.path.join(sys.base_prefix, "lib")
+            if os.path.isdir(thu_muc) and \
+                    glob.glob(os.path.join(thu_muc, "libtcl*")):
+                mt["LD_LIBRARY_PATH"] = (thu_muc + os.pathsep +
+                                         mt.get("LD_LIBRARY_PATH", ""))
+        return mt
+
+    def _thuc_thi(self, duong_dan):
+        """Toàn bộ pipeline build — chạy trong thread nền."""
+        try:
+            self._ghi("► Bước 1/3: Kiểm tra PyInstaller...\n")
+            r = subprocess.run([sys.executable, "-m", "PyInstaller",
+                                "--version"], capture_output=True, text=True)
+            if r.returncode != 0:
+                self._ghi("   Chưa có PyInstaller → tự cài bằng pip...\n")
+                p = subprocess.run(
+                    [sys.executable, "-m", "pip", "install", "--quiet",
+                     "pyinstaller"], capture_output=True, text=True)
+                self._ghi((p.stdout or "") + (p.stderr or "") + "\n")
+                if p.returncode != 0:
+                    self._ghi("✘ Cài PyInstaller thất bại — kiểm tra mạng "
+                              "hoặc cài thủ công: pip install pyinstaller\n")
+                    return
+            else:
+                self._ghi(f"   Đã có PyInstaller {r.stdout.strip()}\n")
+
+            self._ghi("► Bước 2/3: Đang build (thường 1–3 phút)...\n")
+            thu_muc = os.path.dirname(os.path.abspath(duong_dan))
+            # --paths: bảo đảm PyInstaller luôn tìm thấy package flexgui
+            # (cần khi cài kiểu editable / pip install -e)
+            duong_goi = os.path.dirname(
+                os.path.dirname(os.path.abspath(__file__)))
+            lenh = [sys.executable, "-m", "PyInstaller", "--onefile",
+                    "--windowed", "--name", self.ten,
+                    "--paths", duong_goi,
+                    os.path.basename(duong_dan)]
+            tien = subprocess.Popen(lenh, cwd=thu_muc,
+                                    stdout=subprocess.PIPE,
+                                    stderr=subprocess.STDOUT, text=True,
+                                    bufsize=1, env=self._moi_truong_build())
+            for dong in tien.stdout:
+                self._ghi(dong)
+            ma = tien.wait()
+
+            ten_duoi = self.ten + (".exe" if os.name == "nt" else "")
+            self._duong_dan_dist = os.path.join(thu_muc, "dist", ten_duoi)
+            if ma == 0:
+                self._thanh_cong = True
+                self._ghi(f"\n✔✔✔ ĐÃ XONG: {self._duong_dan_dist}\n")
+            else:
+                self._ghi(f"\n✘ BUILD THẤT BẠI (mã thoát {ma}) — xem log "
+                          "phía trên.\n")
+        except Exception:
+            import traceback
+            self._ghi("\n✘ LỖI BẤT NGỜ:\n" + traceback.format_exc() + "\n")
+        finally:
+            self._xong = True