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

python -m pip install -e '.[docs]'
mkdocs serve

Conteúdo principal

• Início
• Primeiros passos
• Conceitos
• Componentes
• Actions
• API

Build da documentação

mkdocs build

Status do projeto

• atualizar componente sempre que uma action é chamada
• 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

app/
  pages/
src/
  blux/

Exemplo rápido

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"),
            ],
        )