blux-framework 0.1.0__tar.gz

blux_framework-0.1.0/PKG-INFO

@@ -0,0 +1,100 @@
+Metadata-Version: 2.3
+Name: blux-framework
+Version: 0.1.0
+Summary: Um framework full-stack declarativo
+Author: Ricardo
+Author-email: Ricardo <ricardokayoca@gmail.com>
+Requires-Dist: fastapi[standard]>=0.141.1
+Requires-Python: >=3.14
+Description-Content-Type: text/markdown
+
+# blux
+blux é um framework full-stack declarativo feito em Python para criar interfaces web com renderização dinâmica, ações no backend e roteamento baseado em diretórios.
+
+## Visão geral
+
+- roteamento baseado em diretórios
+- componentes para UI
+  - text
+  - view
+  - button
+  - input
+  - textarea
+  - image
+  - link
+  - table
+  - modal
+  - form
+- atualização parcial do componente quando uma action é chamada
+- actions: funções executadas no backend quando um evento ocorre
+
+## Documentação
+
+A documentação está em `docs/` e distribuída com MkDocs (Material).
+
+### Rodar a versão local
+
+```bash
+python -m pip install -e '.[docs]'
+mkdocs serve
+```
+
+### Conteúdo principal
+
+- [Início](docs/index.md)
+- [Primeiros passos](docs/quickstart.md)
+- [Conceitos](docs/concepts.md)
+- [Componentes](docs/components.md)
+- [Actions](docs/actions.md)
+- [API](docs/api.md)
+
+### Build da documentação
+
+```bash
+mkdocs build
+```
+
+## Status do projeto
+
+- [x] atualizar componente sempre que uma action é chamada
+- [x] actions: função que serão chamadas no back-end assim que um evento for chamado
+- [ ] api: rotas publicas
+- [ ] Middleware: deve executar antes da renderisação
+- [ ] Autenticação
+- [ ] Proteção contra CSRF
+- [ ] State
+
+## Estrutura principal
+
+```text
+app/
+  pages/
+src/
+  blux/
+```
+
+## Exemplo rápido
+
+```python
+import blux
+
+class HomePage(blux.Page):
+    title = "Home"
+
+    @blux.action
+    def salvar(self, request):
+        form = request.state.form
+        print(form.get("nome"))
+
+    def render(self, request):
+        return blux.Form(
+            action=self.salvar,
+            elements=[
+                blux.Input(name="nome", placeholder="Digite seu nome"),
+                blux.Button(content="Enviar", type="submit"),
+            ],
+        )
+```
+
+
+

blux_framework-0.1.0/README.md

@@ -0,0 +1,90 @@
+# blux
+blux é um framework full-stack declarativo feito em Python para criar interfaces web com renderização dinâmica, ações no backend e roteamento baseado em diretórios.
+
+## Visão geral
+
+- roteamento baseado em diretórios
+- componentes para UI
+  - text
+  - view
+  - button
+  - input
+  - textarea
+  - image
+  - link
+  - table
+  - modal
+  - form
+- atualização parcial do componente quando uma action é chamada
+- actions: funções executadas no backend quando um evento ocorre
+
+## Documentação
+
+A documentação está em `docs/` e distribuída com MkDocs (Material).
+
+### Rodar a versão local
+
+```bash
+python -m pip install -e '.[docs]'
+mkdocs serve
+```
+
+### Conteúdo principal
+
+- [Início](docs/index.md)
+- [Primeiros passos](docs/quickstart.md)
+- [Conceitos](docs/concepts.md)
+- [Componentes](docs/components.md)
+- [Actions](docs/actions.md)
+- [API](docs/api.md)
+
+### Build da documentação
+
+```bash
+mkdocs build
+```
+
+## Status do projeto
+
+- [x] atualizar componente sempre que uma action é chamada
+- [x] actions: função que serão chamadas no back-end assim que um evento for chamado
+- [ ] api: rotas publicas
+- [ ] Middleware: deve executar antes da renderisação
+- [ ] Autenticação
+- [ ] Proteção contra CSRF
+- [ ] State
+
+## Estrutura principal
+
+```text
+app/
+  pages/
+src/
+  blux/
+```
+
+## Exemplo rápido
+
+```python
+import blux
+
+class HomePage(blux.Page):
+    title = "Home"
+
+    @blux.action
+    def salvar(self, request):
+        form = request.state.form
+        print(form.get("nome"))
+
+    def render(self, request):
+        return blux.Form(
+            action=self.salvar,
+            elements=[
+                blux.Input(name="nome", placeholder="Digite seu nome"),
+                blux.Button(content="Enviar", type="submit"),
+            ],
+        )
+```
+
+
+

blux_framework-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "blux-framework"
+version = "0.1.0"
+description = "Um framework full-stack declarativo"
+readme = "README.md"
+authors = [
+    { name = "Ricardo", email = "ricardokayoca@gmail.com" }
+]
+requires-python = ">=3.14"
+dependencies = [
+    "fastapi[standard]>=0.141.1",
+]
+
+[project.scripts]
+blux = "blux.cli:main"
+
+[build-system]
+requires = ["uv_build>=0.11.29,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.uv.build-backend]
+module-name = "blux"
+
+[dependency-groups]
+dev = [
+    "mkdocs-material>=9.7.7",
+    "pymdown-extensions>=11.0.2",
+]
+
+[tool.uv.workspace]
+members = [
+    "test_app",
+]

blux_framework-0.1.0/src/blux/__init__.py

@@ -0,0 +1,10 @@
+
+from .core.elements import *
+from .core.render import (
+    Page,
+    action,
+    args
+)
+from .core.api import *
+from fastapi.requests import Request
+from starlette.datastructures import FormData

blux_framework-0.1.0/src/blux/__projeto_test/app/api/payments/appypay.py

@@ -0,0 +1,24 @@
+import blux
+from pydantic import BaseModel
+
+class Payment(BaseModel):
+    amount:float
+    client_name:str
+    client_email: str
+
+@blux.api()
+def get_payment(nome:str):
+    """ Criar um novo produto"""
+
+    return {"ok":"ok"}
+
+
+@blux.api(method="POST")
+def create_produtos(nome:str):
+    """ Criar um novo produto"""
+
+    return {"ok":"ok"}
+
+
+
+

blux_framework-0.1.0/src/blux/__projeto_test/app/api/produtos/index.py

@@ -0,0 +1,18 @@
+import blux
+
+@blux.api()
+def get_produtos(nome:str):
+    """ Criar um novo produto"""
+
+    return {"ok":"ok"}
+
+
+@blux.api(method="POST")
+def create_produtos(nome:str):
+    """ Criar um novo produto"""
+
+    return {"ok":"ok"}
+
+
+
+

blux_framework-0.1.0/src/blux/__projeto_test/app/assets/globals.css

@@ -0,0 +1,47 @@
+.content_app {
+    padding: 10px;
+    height: 100%;
+
+    display: flex;
+    justify-content: center;
+    align-items: center;
+    padding: 2rem;
+    text-align: center;
+
+    font-family: Verdana, Geneva, Tahoma, sans-serif;
+
+}
+
+.title {
+    font-weight: bold;
+    font-size: 2rem;
+}
+
+.text {
+    font-size: .8rem;
+    opacity: .7;
+    max-width: 70%;
+    margin: auto;
+}
+
+.content {
+    display: flex;
+    flex-direction: column;
+    gap: 10px;
+}
+
+.button_count {
+    background-color: #141414;
+    padding: 10px;
+    border: 0;
+    border-radius: 10px;
+    color: #d2d2d2;
+    cursor: pointer;
+}
+
+.row2 {
+    display: flex;
+    align-items: center;
+    gap: 10px;
+    justify-content: center;
+}

blux_framework-0.1.0/src/blux/__projeto_test/app/pages/index.py

@@ -0,0 +1,68 @@
+import blux
+
+num = 0
+
+class Index(blux.Page):
+
+    title = "index"
+    styles = ["globals.css"]
+
+    @blux.action
+    def contador(self, request:blux.Request):
+        global num
+        num += 1
+
+    def render(self, request:blux.Request):
+
+        return (
+            blux.View(
+                state=self.state,
+                class_name="content_app",
+                elements=[
+                    blux.View(
+                        class_name="content",
+                        elements=[
+
+                            blux.Text(content="Bem vindo ao Box", class_name="title"),
+                            blux.Text(
+                                content="O framework pensado na produtividade de criar aplicações full-stack com apenas uma base de codigo",
+                                class_name="text"
+                            ),
+                            blux.View(
+                                elements=[
+                                    blux.Button(
+                                        content=f"contador {num}",
+                                        on_click=self.contador,
+                                        class_name="button_count"
+                                    ),
+                                ]
+                            ),
+                            blux.View(
+                                elements=[
+                                    blux.Link(
+                                        content="Develop",
+                                        href="http://ricardocayoca.onrender.com/",
+                                        target="_blank"
+                                    ),
+                                    blux.Link(
+                                        content="Doc box",
+                                        href="/"
+                                    ),
+                                    blux.Link(
+                                        content="Swager",
+                                        href="/docs",
+                                        target="_blank"
+                                    ),
+                                    blux.Link(
+                                        content="API  doc",
+                                        href="/redoc",
+                                        target="_blank"
+                                    )
+                                ],
+                                class_name="row2"
+                            )
+                        ]
+                    )
+                ]
+            )
+        )

blux_framework-0.1.0/src/blux/__projeto_test/app/pages/sobre.py

@@ -0,0 +1,16 @@
+import blux
+
+
+class Sobre(blux.Page):
+
+    title = "sobre"
+
+    def render(self, request):
+        return (
+            blux.View(
+                elements=[
+                    blux.Text(content="Pagina sobre"),
+                    blux.Link(content="voltar", href="/")
+                ]
+            )
+        )

blux_framework-0.1.0/src/blux/app.py

@@ -0,0 +1,48 @@
+import os
+from pathlib import Path
+
+from fastapi import FastAPI
+from fastapi.staticfiles import StaticFiles
+from fastapi.templating import Jinja2Templates
+
+from .core.routes import build_router
+from .utils import install_form_middleware
+
+APP_DIR = None
+WEB_DIR = os.path.join(os.path.dirname(__file__), "web")
+
+
+template = Jinja2Templates(
+    directory=os.path.join(WEB_DIR, "templates")
+)
+
+def create_app():
+    app = FastAPI()
+
+    install_form_middleware(app)
+
+    app.mount("/static", StaticFiles(
+            directory=os.path.join(WEB_DIR, "static")
+        )
+    )
+
+    for page in Path(os.getcwd()).rglob("**/app"):
+        if page.exists():
+            APP_DIR = page
+            break
+
+    if not APP_DIR: raise FileNotFoundError(
+            f"Diretório de páginas não encontrado: app\n"
+            f"Rode o comando a partir da raiz do projeto, ou passe --app-dir."
+        )
+
+
+
+    app.mount("/assets", StaticFiles(
+        directory=APP_DIR.joinpath("assets")
+    ))
+
+    for route in build_router(APP_DIR, template):
+        app.include_router(route, include_in_schema=True)
+        
+    return app

blux_framework-0.1.0/src/blux/cli.py

@@ -0,0 +1,103 @@
+
+from __future__ import annotations
+
+import os
+import shutil
+from pathlib import Path
+
+import typer
+import uvicorn
+
+
+app = typer.Typer(help="CLI do blux — sobe o servidor e escaneia as rotas de app/")
+
+FACTORY_TARGET = "blux.app:create_app"
+
+
+@app.command()
+def dev(
+    host: str = typer.Option("127.0.0.1", help="Endereço para escutar"),
+    port: int = typer.Option(8000, help="Porta para escutar"),
+):
+    """Sobe o servidor de desenvolvimento com reload automático."""
+    typer.echo(f"blux dev -> http://{host}:{port}")
+    uvicorn.run(FACTORY_TARGET, factory=True, host=host, port=port, reload=True)
+
+
+@app.command()
+def init(name:str=typer.Argument(".", help="Diretório")):
+    """ Cria um estrutura do projeto """
+
+    ROOT = Path(name)
+
+    if ROOT.exists():
+        typer.echo(f"O projeto '{ROOT}' Já existe")
+        return
+    
+    origem = Path(os.path.dirname(__file__)).joinpath("__projeto_test")
+    print(origem)
+
+    for arquivo in origem.rglob("*"):
+        if arquivo.is_file():
+            relativo = arquivo.relative_to(origem)
+            destino_arquivo = ROOT / relativo
+
+            destino_arquivo.parent.mkdir(parents=True, exist_ok=True)
+            shutil.copy2(arquivo, destino_arquivo)
+
+
+    typer.echo(f"Projeto {ROOT} inicializado")
+    typer.echo(f"use: cd {ROOT}")
+    typer.echo("start develop server: blux dev")
+    typer.echo("cli help use: blux --help")
+
+
+    return True
+
+
+        
+
+
+
+
+
+
+@app.command()
+def start(
+    host: str = typer.Option("0.0.0.0", help="Endereço para escutar"),
+    port: int = typer.Option(8000, help="Porta para escutar"),
+    app_dir: str = typer.Option("app", "--app-dir", help="Diretório com as páginas"),
+    workers: int = typer.Option(1, help="Número de processos worker"),
+):
+    """Sobe o servidor em modo produção (sem reload)."""
+    os.environ["blux_APP_DIR"] = app_dir
+    typer.echo(f"backpay start -> http://{host}:{port}  (páginas em ./{app_dir}, workers={workers})")
+    uvicorn.run(FACTORY_TARGET, factory=True, host=host, port=port, workers=workers)
+
+
+@app.command()
+def routes(
+    app_dir: str = typer.Option("app", "--app-dir", help="Diretório com as páginas"),
+):
+    """Lista as rotas descobertas em app/, sem subir o servidor."""
+    from pathlib import Path
+
+    from .core.routes import discover_pages
+
+    pages = discover_pages(Path(app_dir))
+    if not pages:
+        typer.echo(f"Nenhuma página encontrada em ./{app_dir}")
+        raise typer.Exit(code=1)
+
+    for page in pages:
+        typer.echo(f"GET  {page.route_path}")
+        base = page.route_path.rstrip("/")
+        typer.echo(f"POST {base}/_action/{{component_id}}/{{action_name}}")
+
+
+def main():
+    app()
+
+
+if __name__ == "__main__":
+    main()

blux_framework-0.1.0/src/blux/core/api.py

@@ -0,0 +1,33 @@
+from functools import wraps
+from fastapi import (
+    APIRouter,
+    HTTPException,
+    Depends
+)
+
+from typing import Literal
+
+
+def api(
+        method:Literal["GET", "POST", "PUT"]="GET", 
+        middeware:list=[],
+        title="",
+    ):
+
+    def decorador(f:callable):
+        @wraps(f)
+        def wrapper(*args, **kwargs):
+
+            return f(*args, **kwargs)
+        wrapper._api = True
+        wrapper._method = method
+        wrapper._title = title
+        return wrapper
+    
+    return decorador
+
+
+
+
+
+