verynicegui 1.0.0__py3-none-any.whl

verynicegui/__init__.py

@@ -0,0 +1,31 @@
+from verynicegui.app import VeryNiceGUI
+from verynicegui.layout import VeryNiceLayout, RightDrawer
+from verynicegui.table import VeryNiceTable
+from verynicegui.card import VeryNiceCard
+from verynicegui.i18n import tr, set_language
+from verynicegui.auth import (
+    get_current_user,
+    is_admin,
+    has_permission,
+    do_login,
+    do_logout,
+    load_users,
+    save_users,
+)
+
+__all__ = [
+    "VeryNiceGUI",
+    "VeryNiceLayout",
+    "RightDrawer",
+    "VeryNiceTable",
+    "VeryNiceCard",
+    "tr",
+    "set_language",
+    "get_current_user",
+    "is_admin",
+    "has_permission",
+    "do_login",
+    "do_logout",
+    "load_users",
+    "save_users",
+]

verynicegui/__main__.py

@@ -0,0 +1,4 @@
+from verynicegui.cli import main
+
+if __name__ == "__main__":
+    main()

verynicegui/admin.py

@@ -0,0 +1,351 @@
+from nicegui import ui
+from verynicegui.auth import (
+    load_users,
+    save_users,
+    hash_password,
+    is_admin,
+)
+
+
+def _role_badge(role: str) -> None:
+    """Renders a colorful badge representing the user's role."""
+    if role == "admin":
+        color = "background:#6366f1;color:white"
+        label = "Admin"
+        icon_name = "verified"
+    else:
+        color = "background:#0ea5e9;color:white"
+        label = "Kullanıcı"
+        icon_name = "person"
+
+    with ui.element("div").style(
+        f"display:inline-flex;align-items:center;gap:4px;padding:4px 12px;"
+        f"border-radius:20px;font-size:12px;font-weight:600;{color}"
+    ):
+        ui.icon(icon_name, size="14px")
+        ui.label(label).style("font-size:11px;font-weight:600")
+
+
+def _perm_chip(label: str) -> None:
+    """Renders a custom permission chip styled for dark/light themes."""
+    ui.element("span").classes("mn-perm-chip").text = label
+
+
+def get_available_categories(app_instance) -> list[dict]:
+    """Retrieves all distinct categories defined in the menu hierarchy."""
+    categories = []
+    menu = app_instance.left_drawer_config.get("menu", [])
+    for item in menu:
+        category = item.get("category")
+        if category and category != "admin":
+            categories.append({
+                "category": category,
+                "title": item.get("title", category),
+                "icon": item.get("icon", "circle")
+            })
+    return categories
+
+
+def admin_page(app_instance) -> None:
+    """Renders the built-in Admin User Management Dashboard."""
+    if not is_admin():
+        ui.navigate.to("/403")
+        return
+
+    card_style = "background-color:var(--mn-card-bg); border:var(--mn-card-border)"
+    text_primary = "color:var(--mn-text-primary)"
+    text_secondary = "color:var(--mn-text-secondary)"
+
+    # Page Header
+    with ui.row().classes("items-center justify-between w-full mb-2"):
+        with ui.column().classes("gap-1"):
+            ui.label("Kullanıcı Yönetimi").classes("text-3xl font-bold").style(text_primary)
+            ui.label("SaaS platformu kullanıcılarını oluşturun, düzenleyin ve sayfa izinlerini yönetin.").style(text_secondary + ";font-size:14px")
+
+        ui.button(
+            "Yeni Kullanıcı",
+            icon="person_add",
+            on_click=lambda: create_dialog.open(),
+        ).props("unelevated no-caps color=indigo").style("border-radius:12px; padding: 10px 20px")
+
+    # Refreshable Statistics Cards
+    @ui.refreshable
+    def stats_row():
+        users = load_users()
+        admin_count = sum(1 for u in users.values() if u.get("role") == "admin" or "*" in u.get("permissions", []))
+        total_count = len(users)
+
+        stat_cards = [
+            ("group", str(total_count), "Toplam Kullanıcı", "#6366f1"),
+            ("admin_panel_settings", str(admin_count), "Yönetici (Admin)", "#a855f7"),
+            ("shield", str(total_count - admin_count), "Standart Kullanıcı", "#0ea5e9"),
+        ]
+
+        with ui.row().classes("w-full gap-4 mb-4"):
+            for icon_name, value, label_text, color in stat_cards:
+                with ui.element("div").style(
+                    f"{card_style};border-radius:16px;"
+                    f"padding:20px 24px;flex:1;display:flex;align-items:center;gap:20px"
+                ):
+                    with ui.element("div").style(
+                        f"width:52px;height:52px;border-radius:14px;"
+                        f"background:{color}15;display:flex;align-items:center;justify-content:center;flex-shrink:0"
+                    ):
+                        ui.icon(icon_name, size="28px").style(f"color:{color}")
+                    with ui.column().classes("gap-0"):
+                        ui.label(value).style(f"{text_primary};font-size:28px;font-weight:800;line-height:1")
+                        ui.label(label_text).style(f"{text_secondary};font-size:13px;font-weight:500;margin-top:4px")
+
+    stats_row()
+
+    # Refreshable Users List
+    @ui.refreshable
+    def user_list():
+        users = load_users()
+        categories = get_available_categories(app_instance)
+
+        if not users:
+            ui.label("Henüz kayıtlı kullanıcı bulunmamaktadır.").style(text_secondary)
+            return
+
+        with ui.column().classes("w-full gap-4"):
+            for username, user_data in users.items():
+                _user_card(username, user_data, categories, card_style, text_primary, text_secondary)
+
+    def _user_card(uname, udata, categories, card_style, text_primary, text_secondary):
+        with ui.element("div").style(
+            f"{card_style};border-radius:16px;padding:20px 24px;"
+            f"display:flex;align-items:center;gap:20px;transition:box-shadow 0.2s"
+        ):
+            # Initials Avatar
+            display_name = udata.get("display_name") or uname
+            initials = (display_name[:1] or "?").upper()
+            av_color = "#6366f1" if udata.get("role") == "admin" else "#0ea5e9"
+            with ui.element("div").style(
+                f"width:48px;height:48px;border-radius:50%;"
+                f"background:{av_color};display:flex;align-items:center;"
+                f"justify-content:center;flex-shrink:0;font-size:18px;font-weight:700;color:white"
+            ):
+                ui.label(initials)
+
+            # Details Area
+            with ui.column().classes("gap-1").style("flex:1;min-width:0"):
+                with ui.row().classes("items-center gap-3 flex-wrap"):
+                    ui.label(display_name).style(f"{text_primary};font-size:16px;font-weight:700")
+                    ui.label(f"@{uname}").style(f"{text_secondary};font-size:12px")
+                    _role_badge(udata.get("role", "user"))
+
+                # Permissions Chip Display
+                with ui.row().classes("items-center gap-1 flex-wrap mt-1"):
+                    perms = udata.get("permissions", [])
+                    if "*" in perms:
+                        _perm_chip("Tüm Sayfalar (Admin)")
+                    else:
+                        rendered_any = False
+                        for cat in categories:
+                            if cat["category"] in perms:
+                                _perm_chip(cat["title"])
+                                rendered_any = True
+                        if not rendered_any:
+                            ui.label("Erişim Yetkisi Yok").style(f"{text_secondary};font-size:12px;font-style:italic")
+
+            # Actions Button Group
+            with ui.row().classes("items-center gap-2 flex-shrink-0"):
+                ui.button(icon="edit", on_click=lambda u=uname, d=udata: open_edit_dialog(u, d)).props(
+                    "flat round color=indigo dense"
+                ).tooltip("Düzenle")
+
+                if uname != "admin":  # Protect primary admin user
+                    ui.button(
+                        icon="delete",
+                        on_click=lambda u=uname: confirm_delete(u),
+                    ).props("flat round color=negative dense").tooltip("Sil")
+
+    user_list()
+
+    # ─── CREATE USER DIALOG ────────────────────────────────────────────────
+    with ui.dialog() as create_dialog, ui.card().style(
+        f"{card_style};border-radius:20px;padding:32px;width:480px;max-width:95vw"
+    ):
+        ui.label("Yeni Kullanıcı").style(f"{text_primary};font-size:20px;font-weight:700")
+        ui.label("Kullanıcı profil bilgilerini ve sayfa yetkilerini ayarlayın.").style(
+            f"{text_secondary};font-size:13px;margin-top:-8px"
+        )
+
+        new_uname = ui.input("Kullanıcı Adı").classes("w-full").props("outlined")
+        new_dname = ui.input("Görünen Ad").classes("w-full").props("outlined")
+        new_pwd = ui.input("Şifre", password=True, password_toggle_button=True).classes("w-full").props("outlined")
+
+        ui.label("Sayfa Kategorileri İzinleri").style(
+            f"{text_primary};font-size:14px;font-weight:600;margin-top:8px"
+        )
+
+        categories = get_available_categories(app_instance)
+        perm_switches: dict[str, ui.switch] = {}
+
+        with ui.column().classes("w-full gap-2"):
+            for cat in categories:
+                with ui.row().classes("items-center justify-between w-full"):
+                    with ui.row().classes("items-center gap-2"):
+                        ui.icon(cat["icon"], size="18px").style("color:#6366f1")
+                        ui.label(cat["title"]).style(f"{text_primary};font-size:14px")
+                    sw = ui.switch().props("color=indigo")
+                    perm_switches[cat["category"]] = sw
+
+        ui.separator().style("margin:8px 0")
+
+        with ui.row().classes("justify-end gap-2 w-full"):
+            ui.button("İptal", on_click=create_dialog.close).props("flat no-caps color=grey")
+
+            def do_create():
+                uname = (new_uname.value or "").strip()
+                pwd = new_pwd.value or ""
+                dname = (new_dname.value or "").strip() or uname
+
+                if not uname:
+                    ui.notify("Kullanıcı adı gereklidir.", type="warning")
+                    return
+                if len(pwd) < 4:
+                    ui.notify("Şifre en az 4 karakter olmalıdır.", type="warning")
+                    return
+
+                users = load_users()
+                if uname in users:
+                    ui.notify(f"'{uname}' kullanıcısı zaten mevcut.", type="warning")
+                    return
+
+                perms = [cat for cat, sw in perm_switches.items() if sw.value]
+                users[uname] = {
+                    "password_hash": hash_password(pwd),
+                    "role": "user",
+                    "permissions": perms,
+                    "display_name": dname,
+                    "theme": "light"
+                }
+                save_users(users)
+
+                # Reset form fields
+                new_uname.value = ""
+                new_dname.value = ""
+                new_pwd.value = ""
+                for sw in perm_switches.values():
+                    sw.value = False
+
+                create_dialog.close()
+                user_list.refresh()
+                stats_row.refresh()
+                ui.notify(f"'{uname}' kullanıcısı oluşturuldu.", type="positive", icon="check_circle")
+
+            ui.button("Oluştur", on_click=do_create).props("unelevated no-caps color=indigo").style("border-radius:10px")
+
+    # ─── EDIT USER DIALOG ──────────────────────────────────────────────────
+    edit_dialog = ui.dialog()
+
+    def open_edit_dialog(uname: str, udata: dict):
+        edit_dialog.clear()
+
+        with edit_dialog, ui.card().style(
+            f"{card_style};border-radius:20px;padding:32px;width:480px;max-width:95vw"
+        ):
+            ui.label(f"Düzenle: @{uname}").style(f"{text_primary};font-size:20px;font-weight:700")
+
+            categories = get_available_categories(app_instance)
+            current_perms = udata.get("permissions", [])
+            is_super = "*" in current_perms
+
+            edit_dname = ui.input("Görünen Ad", value=udata.get("display_name", uname)).classes("w-full").props("outlined")
+            edit_pwd = ui.input("Yeni Şifre (boş bırakılırsa değişmez)", password=True, password_toggle_button=True).classes("w-full").props("outlined")
+
+            if is_super:
+                with ui.row().classes("items-center gap-3 w-full").style(
+                    "background:rgba(99,102,241,0.1);border-radius:12px;padding:12px 16px;margin-top:8px"
+                ):
+                    ui.icon("verified", size="20px").style("color:#6366f1")
+                    ui.label("Bu hesap tüm yetkilere sahiptir (Admin).").style(f"{text_secondary};font-size:13px")
+                edit_perm_switches = {}
+            else:
+                ui.label("Sayfa Kategorileri İzinleri").style(
+                    f"{text_primary};font-size:14px;font-weight:600;margin-top:8px"
+                )
+                edit_perm_switches: dict[str, ui.switch] = {}
+
+                with ui.column().classes("w-full gap-2"):
+                    for cat in categories:
+                        with ui.row().classes("items-center justify-between w-full"):
+                            with ui.row().classes("items-center gap-2"):
+                                ui.icon(cat["icon"], size="18px").style("color:#6366f1")
+                                ui.label(cat["title"]).style(f"{text_primary};font-size:14px")
+                            sw = ui.switch(value=cat["category"] in current_perms).props("color=indigo")
+                            edit_perm_switches[cat["category"]] = sw
+
+            ui.separator().style("margin:8px 0")
+
+            with ui.row().classes("justify-end gap-2 w-full"):
+                ui.button("İptal", on_click=edit_dialog.close).props("flat no-caps color=grey")
+
+                def do_save(un=uname, is_sup=is_super, sw_map=edit_perm_switches):
+                    users = load_users()
+                    if un not in users:
+                        ui.notify("Kullanıcı bulunamadı.", type="negative")
+                        return
+
+                    dname = (edit_dname.value or "").strip()
+                    if dname:
+                        users[un]["display_name"] = dname
+
+                    pwd = edit_pwd.value or ""
+                    if pwd:
+                        if len(pwd) < 4:
+                            ui.notify("Şifre en az 4 karakter olmalıdır.", type="warning")
+                            return
+                        users[un]["password_hash"] = hash_password(pwd)
+
+                    if not is_sup:
+                        users[un]["permissions"] = [
+                            cat for cat, sw in sw_map.items() if sw.value
+                        ]
+
+                    save_users(users)
+                    edit_dialog.close()
+                    user_list.refresh()
+                    ui.notify("Değişiklikler kaydedildi.", type="positive", icon="check_circle")
+
+                ui.button("Kaydet", on_click=do_save).props("unelevated no-caps color=indigo").style("border-radius:10px")
+
+        edit_dialog.open()
+
+    # ─── CONFIRM DELETE DIALOG ─────────────────────────────────────────────
+    def confirm_delete(uname: str):
+        with ui.dialog() as del_dialog, ui.card().style(
+            f"{card_style};border-radius:20px;padding:28px;width:380px"
+        ):
+            with ui.row().classes("items-center gap-3 mb-2"):
+                with ui.element("div").style(
+                    "width:44px;height:44px;background:rgba(239,68,68,0.12);"
+                    "border-radius:12px;display:flex;align-items:center;justify-content:center"
+                ):
+                    ui.icon("warning", size="24px").style("color:#ef4444")
+                ui.label("Kullanıcıyı Sil").style(f"{text_primary};font-size:18px;font-weight:700")
+
+            ui.label(
+                f"'{uname}' kullanıcısını silmek istediğinizden emin misiniz? Bu işlem geri alınamaz."
+            ).style(f"{text_secondary};font-size:14px")
+
+            ui.separator().style("margin:12px 0")
+
+            with ui.row().classes("justify-end gap-2 w-full"):
+                ui.button("Vazgeç", on_click=del_dialog.close).props("flat no-caps color=grey")
+
+                def do_delete(u=uname):
+                    users = load_users()
+                    if u in users:
+                        del users[u]
+                        save_users(users)
+                    del_dialog.close()
+                    user_list.refresh()
+                    stats_row.refresh()
+                    ui.notify(f"'{u}' kullanıcısı başarıyla silindi.", type="info", icon="delete")
+
+                ui.button("Evet, Sil", on_click=do_delete).props("unelevated no-caps color=negative").style("border-radius:10px")
+
+        del_dialog.open()

verynicegui/app.py

@@ -0,0 +1,209 @@
+import inspect
+from nicegui import ui
+from verynicegui.layout import VeryNiceLayout, RightDrawer
+
+
+class VeryNiceGUI:
+    """The main application wrapper for verynicegui.
+    
+    Handles configuration, default page routing (login, 403, admin),
+    and automatic page layout injection via the @app.page decorator.
+    """
+    
+    def __init__(self, title: str = "VeryNiceGUI App", header: dict = None, left_drawer: dict = None, footer: dict = None, translations: dict = None):
+        # Configure Header
+        self.header_config = {
+            "logo": "radar",
+            "title": title,
+            "show_theme_toggle": True
+        }
+        if header:
+            self.header_config.update(header)
+
+        # Configure Left Drawer
+        self.left_drawer_config = {
+            "menu": [],
+            "show_settings": True,
+            "title": "NAVİGASYON"
+        }
+        if left_drawer:
+            self.left_drawer_config.update(left_drawer)
+
+        # Configure Footer
+        self.footer_config = {
+            "left": "",
+            "middle": "",
+            "right": ""
+        }
+        if footer:
+            self.footer_config.update(footer)
+
+        # Add global head script and styles for preventing theme loading flashes
+        ui.add_head_html("""
+        <script>
+            (function() {
+                var theme = 'light';
+                var match = document.cookie.match(new RegExp('(^| )theme=([^;]+)'));
+                if (match) theme = match[2];
+                if (theme === 'dark') {
+                    document.documentElement.classList.add('body--dark');
+                } else {
+                    document.documentElement.classList.remove('body--dark');
+                }
+            })();
+        </script>
+        <style>
+            html, body, .q-layout, .q-page-container {
+                background-color: #f8fafc !important;
+            }
+            html.body--dark, html.body--dark body, html.body--dark .q-layout, html.body--dark .q-page-container,
+            body.body--dark, body.body--dark .q-layout, body.body--dark .q-page-container {
+                background-color: #0f172a !important;
+            }
+        </style>
+        <meta name="darkreader-lock">
+        """, shared=True)
+
+        # Register custom translations
+        if translations:
+            from verynicegui.i18n import custom_translations
+            for lang, trans_dict in translations.items():
+                if lang not in custom_translations:
+                    custom_translations[lang] = {}
+                custom_translations[lang].update(trans_dict)
+
+        self.registered_routes = set()
+
+    def page(self, route: str, title: str = None, allowed_categories: list[str] = None, standalone: bool = False):
+        """Decorator to register a page route.
+        
+        Automatically wraps pages with authentication checks, authorization (RBAC),
+        and layout injection (SaaSLayout).
+        If the page function signature contains a parameter named 'drawer' or 'right_drawer',
+        a toggleable RightDrawer component is instantiated and injected.
+        """
+        self.registered_routes.add(route)
+
+        def decorator(func):
+            # Inspect signature to see if page function requests the right drawer or request
+            sig = inspect.signature(func)
+            drawer_param_name = None
+            for param in sig.parameters.values():
+                if param.name in ("drawer", "right_drawer"):
+                    drawer_param_name = param.name
+                    break
+
+            from fastapi import Request
+
+            @ui.page(route)
+            def page_wrapper(request: Request):
+                # Resolve arguments for user-defined function
+                func_kwargs = {}
+                if "request" in sig.parameters:
+                    func_kwargs["request"] = request
+
+                if standalone:
+                    func(**func_kwargs)
+                    return
+
+                # Auth Guard
+                from verynicegui.auth import require_login
+                if not require_login():
+                    return
+
+                # RBAC Category Guard
+                if allowed_categories:
+                    from verynicegui.auth import has_permission
+                    authorized = any(has_permission(cat) for cat in allowed_categories)
+                    if not authorized:
+                        ui.navigate.to("/403")
+                        return
+
+                # Instantiate right drawer if requested by the page function
+                right_drawer = None
+                if drawer_param_name:
+                    right_drawer = RightDrawer()
+                    func_kwargs[drawer_param_name] = right_drawer
+
+                # Render page inside standard VeryNiceLayout
+                with VeryNiceLayout(
+                    title=title or self.header_config.get("title", "Page"),
+                    app_instance=self,
+                    right_drawer=right_drawer,
+                    current_route=route
+                ):
+                    func(**func_kwargs)
+
+            return page_wrapper
+        return decorator
+
+    def _register_default_routes(self):
+        """Auto-registers system routes (login, logout, 403, and admin) if not overridden."""
+        from verynicegui.templates import login_page, forbidden_page
+        from verynicegui.auth import do_logout, require_login, is_admin
+        from verynicegui.admin import admin_page
+
+        # Login page (Standalone)
+        if "/login" not in self.registered_routes:
+            @ui.page("/login")
+            def login_route():
+                login_page(
+                    app_title=self.header_config.get("title", "VeryNiceGUI"),
+                    logo_icon=self.header_config.get("logo", "radar")
+                )
+
+        # Forbidden page (Standalone)
+        if "/403" not in self.registered_routes:
+            @ui.page("/403")
+            def forbidden_route():
+                if not require_login():
+                    return
+                forbidden_page(app_title=self.header_config.get("title", "VeryNiceGUI"))
+
+        # Logout route (API / Action redirect)
+        if "/logout" not in self.registered_routes:
+            @ui.page("/logout")
+            def logout_route():
+                do_logout()
+                ui.navigate.to("/login")
+
+        # Admin route (Built-in user management with standard layout)
+        if "/admin" not in self.registered_routes:
+            @ui.page("/admin")
+            def admin_route():
+                if not require_login():
+                    return
+                if not is_admin():
+                    ui.navigate.to("/403")
+                    return
+
+                with VeryNiceLayout(
+                    title="Ayarlar / Admin",
+                    app_instance=self,
+                    current_route="/admin"
+                ):
+                    admin_page(app_instance=self)
+
+    def run(self, **kwargs):
+        """Initializes default system routes and runs NiceGUI."""
+        # Auto-serve assets directory relative to the running entrypoint script
+        import sys
+        from pathlib import Path
+        if sys.argv and sys.argv[0]:
+            entry_dir = Path(sys.argv[0]).parent.resolve()
+            assets_path = entry_dir / "assets"
+            if assets_path.exists() and assets_path.is_dir():
+                from nicegui import app as nicegui_app
+                try:
+                    nicegui_app.add_static_files("/assets", str(assets_path))
+                except Exception:
+                    pass
+
+        self._register_default_routes()
+        
+        # Merge defaults
+        kwargs.setdefault("port", 8080)
+        kwargs.setdefault("reload", True)
+        kwargs.setdefault("storage_secret", "very-nice-gui-secret-key-123456")
+        
+        ui.run(**kwargs)