fleting 1.1.4__tar.gz

fleting-1.1.4/LICENSE

@@ -0,0 +1,7 @@
+MIT License
+
+Copyright (c) 2026 Alex Yucra
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction...

fleting-1.1.4/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: fleting
+Version: 1.1.4
+Summary: Micro-framework MVC baseado em Flet para aplicações mobile, tablet e desktop
+License: MIT
+License-File: LICENSE
+Keywords: flet,framework,mvc,ui,desktop,mobile
+Author: Alex Yucra
+Requires-Python: >=3.11
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Dist: flet
+Project-URL: Documentation, https://github.com/alexyucra/fleting/tree/main/docs
+Project-URL: Homepage, https://github.com/alexyucra/fleting
+Project-URL: Issues, https://github.com/alexyucra/fleting/issues
+Project-URL: Repository, https://github.com/alexyucra/fleting
+Description-Content-Type: text/markdown
+
+<p align="center">
+  <a href="README.md">🇧🇷 Português</a> |
+  <a href="docs/readme-es.md">🇪🇸 Español</a> |
+</p>
+
+---
+
+# ⚡ Fleting Framework
+
+![](docs/img/fleting.png)
+
+Fleting é um micro-framework opinativo construído sobre **Flet**, focado em:
+- simplicidade
+- organização clara
+- produtividade
+- aplicações multiplataforma (mobile, tablet e desktop)
+
+Ele traz uma arquitetura inspirada em MVC, com **layout desacoplado**, **roteamento simples**, **i18n**, **responsividade automática** e um **CLI para geração de código**.
+
+## 🚀 Quick Start
+
+### 1. crie um ambiente virtual isolado
+
+- [Recomendado: env com poetry](docs/pt/enviroment.md)
+
+
+## 🛠️ CLI
+
+```shell
+pip install flet
+pip install fleting
+
+fleting init
+fleting run
+
+# para desenvolvimento
+fleting create page home
+flet run fleting/app.py
+```
+
+## 📚 Documentação
+
+A documentação completa está disponível em:
+
+👉 [documentação completa](docs/pt/index.md)
+
+---
+
+## 🎯 Filosofia
+
+O Fleting foi criado com alguns princípios claros:
+
+### 1️⃣ Simplicidade acima de tudo
+- Nada de abstrações desnecessárias
+- Código explícito e fácil de entender
+- Arquitetura previsível
+
+### 2️⃣ Separação de responsabilidades
+- **View** → UI pura (Flet)
+- **Layout** → Estrutura visual reutilizável
+- **Controller** → Regras de negócio
+- **Model** → Dados
+- **Router** → Navegação
+- **Core** → Infraestrutura do framework
+
+### 3️⃣ Mobile-first
+- O estado global da aplicação identifica automaticamente:
+  - `mobile`
+  - `tablet`
+  - `desktop`
+- Layouts podem reagir dinamicamente ao tipo de dispositivo
+
+### 4️⃣ Internacionalização nativa
+- Sistema de tradução simples baseado em JSON
+- Mudança de idioma em tempo real
+- Traduções acessíveis em qualquer parte da app
+
+### 5️⃣ CLI como cidadão de primeira classe
+- Criação e remoção de arquivos padronizados
+- Redução de boilerplate
+- Convenção > Configuração
+
+---
+
+## 📄 Licença
+
+MIT
+
+## Como contribuir
+- [Para quem quiser contribuir com o Fleting no GitHub.](CONTRIBUTING.md)

fleting-1.1.4/README.md

@@ -0,0 +1,90 @@
+<p align="center">
+  <a href="README.md">🇧🇷 Português</a> |
+  <a href="docs/readme-es.md">🇪🇸 Español</a> |
+</p>
+
+---
+
+# ⚡ Fleting Framework
+
+![](docs/img/fleting.png)
+
+Fleting é um micro-framework opinativo construído sobre **Flet**, focado em:
+- simplicidade
+- organização clara
+- produtividade
+- aplicações multiplataforma (mobile, tablet e desktop)
+
+Ele traz uma arquitetura inspirada em MVC, com **layout desacoplado**, **roteamento simples**, **i18n**, **responsividade automática** e um **CLI para geração de código**.
+
+## 🚀 Quick Start
+
+### 1. crie um ambiente virtual isolado
+
+- [Recomendado: env com poetry](docs/pt/enviroment.md)
+
+
+## 🛠️ CLI
+
+```shell
+pip install flet
+pip install fleting
+
+fleting init
+fleting run
+
+# para desenvolvimento
+fleting create page home
+flet run fleting/app.py
+```
+
+## 📚 Documentação
+
+A documentação completa está disponível em:
+
+👉 [documentação completa](docs/pt/index.md)
+
+---
+
+## 🎯 Filosofia
+
+O Fleting foi criado com alguns princípios claros:
+
+### 1️⃣ Simplicidade acima de tudo
+- Nada de abstrações desnecessárias
+- Código explícito e fácil de entender
+- Arquitetura previsível
+
+### 2️⃣ Separação de responsabilidades
+- **View** → UI pura (Flet)
+- **Layout** → Estrutura visual reutilizável
+- **Controller** → Regras de negócio
+- **Model** → Dados
+- **Router** → Navegação
+- **Core** → Infraestrutura do framework
+
+### 3️⃣ Mobile-first
+- O estado global da aplicação identifica automaticamente:
+  - `mobile`
+  - `tablet`
+  - `desktop`
+- Layouts podem reagir dinamicamente ao tipo de dispositivo
+
+### 4️⃣ Internacionalização nativa
+- Sistema de tradução simples baseado em JSON
+- Mudança de idioma em tempo real
+- Traduções acessíveis em qualquer parte da app
+
+### 5️⃣ CLI como cidadão de primeira classe
+- Criação e remoção de arquivos padronizados
+- Redução de boilerplate
+- Convenção > Configuração
+
+---
+
+## 📄 Licença
+
+MIT
+
+## Como contribuir
+- [Para quem quiser contribuir com o Fleting no GitHub.](CONTRIBUTING.md)

fleting-1.1.4/fleting/__init__.py

@@ -0,0 +1 @@
+__version__ = "0.1.0"

fleting-1.1.4/fleting/app.py

@@ -0,0 +1,29 @@
+
+import flet as ft
+from configs.app_config import AppConfig
+from core.logger import get_logger
+from core.error_handler import GlobalErrorHandler
+
+logger = get_logger("App")
+
+def main(page: ft.Page):
+    try:
+        from core.app import FletingApp
+        page.window.width = AppConfig.DEFAULT_SCREEN["width"]
+        page.window.height = AppConfig.DEFAULT_SCREEN["height"]
+
+        from core.i18n import I18n
+        I18n.load("pt")
+
+        from core.router import Router
+        from configs.routes import routes
+
+        router = Router(page)
+        router.navigate("/")
+
+        logger.info("Aplicação iniciada com sucesso")
+        
+    except Exception as e:
+        GlobalErrorHandler.handle(page, e)
+
+ft.run(main)

fleting-1.1.4/fleting/cli/cli.py

@@ -0,0 +1,58 @@
+import sys
+from fleting.cli.commands.init import handle_init
+from fleting.cli.commands.run import handle_run
+from fleting.cli.commands.info import handle_info
+from fleting.cli.commands.create import handle_create
+from fleting.cli.commands.delete import handle_delete
+
+def print_help():
+    print("""
+Fleting CLI
+
+Uso:
+  fleting init
+      Inicializa um novo projeto Fleting
+
+  fleting create page <nome>
+      Cria uma nova página (model + controller + view)
+
+  fleting create view <nome>
+  fleting create model <nome>
+  fleting create controller <nome>
+
+  fleting delete page <nome>
+  fleting delete view <nome>
+  fleting delete model <nome>
+  fleting delete controller <nome>
+""")
+
+def main():
+    
+    args = sys.argv[1:]
+
+    if not args or args[0] in ("-h", "--help"):
+        print_help()
+        return
+
+    command = args[0]
+    
+    try:
+        if command == "init":
+            handle_init()
+        elif command == "run":
+            handle_run()
+        elif command == "info":
+            handle_info()
+        elif command == "create":
+            handle_create(args[1:])
+        elif command == "delete":
+            handle_delete(args[1:])
+        else:
+            print(f"Comando desconhecido: {command}")
+            print_help()
+
+    except Exception as e:
+         print("Erro ao executar comando CLI:", str(e))
+
+if __name__ == "__main__":
+    main()

fleting-1.1.4/fleting/cli/commands/create.py

@@ -0,0 +1,159 @@
+from pathlib import Path
+
+BASE = Path.cwd()
+
+def handle_create(args):
+    if len(args) < 2:
+        print("Uso: fleting create <controller|view|model|page> <nome>")
+        return
+
+    kind, name = args[0], args[1]
+    name = name.lower()
+
+    try:
+        if kind == "controller":
+            create_controller(name)
+        elif kind == "view":
+            create_view(name)
+        elif kind == "model":
+            create_model(name)
+        elif kind == "page":
+            create_page(name)
+        else:
+            print(f"Tipo não suportado: {kind}")
+
+    except Exception:
+        print(f"Erro ao criar {kind} {name}")
+
+# --------------
+# create controller
+# --------------
+def create_controller(name: str):
+    path = BASE / "controllers" / f"{name}_controller.py"
+
+    if path.exists():
+        print(f"Controller '{name}' já existe")
+        return
+
+    class_name = f"{name.capitalize()}Controller"
+
+    content = f"""class {class_name}:
+    def __init__(self, model=None):
+        self.model = model
+
+    def get_title(self):
+        return "{name.capitalize()}"
+"""
+    path.write_text(content, encoding="utf-8")
+    print(f"Controller criado com sucesso: {name}")
+
+
+# --------------
+# create view
+# --------------
+def create_view(name: str):
+    path = BASE / "views" / "pages" / f"{name}_view.py"
+
+    if path.exists():
+        print(f"View '{name}' já existe")
+        return
+
+    class_name = f"{name.capitalize()}View"
+
+    content = f"""import flet as ft
+from views.layouts.main_layout import MainLayout
+
+class {class_name}:
+    def __init__(self, page, router):
+        self.page = page
+        self.router = router
+
+    def render(self):
+        content = ft.Column(
+            controls=[
+                ft.Text("{name.capitalize()}", size=24),
+            ],
+            spacing=16,
+        )
+
+        return MainLayout(
+            page=self.page,
+            content=content,
+            router=self.router,
+        )
+"""
+
+    path.write_text(content, encoding="utf-8")
+    print(f"View criada com sucesso: {name}")
+
+
+# --------------
+# create model
+# --------------
+def create_model(name: str):
+    path = BASE / "models" / f"{name}_model.py"
+
+    if path.exists():
+        print(f"Model '{name}' já existe")
+        return
+
+    class_name = f"{name.capitalize()}Model"
+
+    content = f"""class {class_name}:
+    def __init__(self):
+        pass
+"""
+
+    path.write_text(content, encoding="utf-8")
+    print(f"Model criado com sucesso: {name}")
+
+# --------------
+# create page
+# --------------
+def create_page(name: str):
+    print(f"Criando page completa: {name}")
+
+    create_model(name)
+    create_controller(name)
+    create_page_view(name)
+
+def create_page_view(name: str):
+    path = BASE / "views" / "pages" / f"{name}_view.py"
+
+    if path.exists():
+        print(f"View '{name}' já existe")
+        return
+
+    class_name = f"{name.capitalize()}View"
+    controller_class = f"{name.capitalize()}Controller"
+    model_class = f"{name.capitalize()}Model"
+
+    content = f"""import flet as ft
+from views.layouts.main_layout import MainLayout
+from controllers.{name}_controller import {controller_class}
+from models.{name}_model import {model_class}
+
+class {class_name}:
+    def __init__(self, page, router):
+        self.page = page
+        self.router = router
+
+        self.model = {model_class}()
+        self.controller = {controller_class}(self.model)
+
+    def render(self):
+        content = ft.Column(
+            controls=[
+                ft.Text(self.controller.get_title(), size=24),
+            ],
+            spacing=16,
+        )
+
+        return MainLayout(
+            page=self.page,
+            content=content,
+            router=self.router,
+        )
+"""
+    path.write_text(content, encoding="utf-8")
+    print(f"Page criada com sucesso: {name}")

fleting-1.1.4/fleting/cli/commands/delete.py

@@ -0,0 +1,76 @@
+from pathlib import Path
+
+BASE = Path.cwd()
+
+def handle_delete(args):
+    if len(args) < 2:
+        print("Uso: fleting delete <controller|view|model|page> <nome>")
+        return
+
+    kind, name = args[0], args[1].lower()
+
+    try:
+        if kind == "view":
+            delete_view(name)
+
+        elif kind == "controller":
+            delete_controller(name)
+
+        elif kind == "model":
+            delete_model(name)
+
+        elif kind == "page":
+            delete_page(name)
+
+        else:
+            print(f"Tipo não suportado: {kind}")
+
+    except Exception:
+        print(f"Erro ao deletar {kind} {name}")
+
+# -----------------
+# delete controller
+# -----------------
+def delete_controller(name: str):
+    path = BASE / "controllers" / f"{name}_controller.py"
+
+    if not path.exists():
+        print(f"Controller '{name}' não existe")
+        return
+
+    path.unlink()
+    print(f"Controller removido com sucesso: {name}")
+
+# -----------------
+# delete view
+# -----------------
+def delete_view(name: str):
+    path = BASE / "views" / "pages" / f"{name}_view.py"
+
+    if not path.exists():
+        print(f"View '{name}' não existe")
+        return
+
+    path.unlink()
+    print(f"View removida com sucesso: {name}")
+
+# -----------------
+# delete model
+# -----------------
+def delete_model(name: str):
+    path = BASE / "models" / f"{name}_model.py"
+
+    if not path.exists():
+        print(f"Model '{name}' não existe")
+        return
+
+    path.unlink()
+    print(f"Model removido com sucesso: {name}")
+
+# -----------------
+# delete page
+# -----------------
+def delete_page(name: str):
+    delete_view(name)
+    delete_controller(name)
+    delete_model(name)

fleting-1.1.4/fleting/cli/commands/info.py

@@ -0,0 +1,44 @@
+import platform
+import sys
+from importlib import metadata
+
+BANNER = r"""
+ ______ _      _   _             
+|  ____| |    | | (_)            
+| |__  | | ___| |_ _ _ __   __ _ 
+|  __| | |/ _ \ __| | '_ \ / _` |
+| |    | |  __/ |_| | | | | (_| |
+|_|    |_|\___|\__|_|_| |_|\__, |
+                            __/ |
+                           |___/
+"""
+
+def _get_version(pkg_name: str):
+    try:
+        return metadata.version(pkg_name)
+    except metadata.PackageNotFoundError:
+        return "não instalado"
+
+def handle_info():
+    python_version = sys.version.split()[0]
+    system = f"{platform.system()} {platform.release()}"
+
+    flet_version = _get_version("flet")
+    fleting_version = _get_version("fleting")
+
+    print(BANNER)
+    print("🚀 Fleting Framework\n")
+
+    print("📦 Ambiente\n")
+    print(f"🧠 Python        : {python_version}")
+    print(f"🖥️  Sistema      : {system}")
+    print(f"🧩 Flet          : {flet_version}")
+    print(f"🚀 Fleting       : {fleting_version}")
+
+    print("\n📚 Bibliotecas instaladas:")
+    for dist in sorted(metadata.distributions(), key=lambda d: d.metadata["Name"].lower()):
+        name = dist.metadata["Name"]
+        version = dist.version
+        print(f"  - {name}=={version}")
+
+    print("\n✅ Ambiente pronto para uso.\n")

fleting-1.1.4/fleting/cli/commands/init.py

@@ -0,0 +1,4 @@
+from fleting.cli.templates.index import init_project
+
+def handle_init():
+    init_project()

fleting-1.1.4/fleting/cli/commands/run.py

@@ -0,0 +1,28 @@
+import subprocess
+import sys
+import shutil
+from pathlib import Path
+
+def handle_run():
+    project_root = Path.cwd()
+    app_path = project_root / "fleting" / "app.py"
+
+    if not shutil.which("flet"):
+        print("❌ Flet não está instalado no ambiente")
+        print("👉 pip install flet")
+        return
+
+    if not app_path.exists():
+        print("❌ fleting/app.py não encontrado.")
+        print("👉 Execute 'fleting init' primeiro.")
+        return
+
+    print("🚀 Iniciando aplicação Fleting...\n")
+
+    try:
+        subprocess.run(
+            ["flet", "run", str(app_path)],
+            check=True
+        )
+    except subprocess.CalledProcessError:
+        print("❌ Erro ao executar o app com Flet")