JanelKit

Aplicaciones de escritorio con componentes de archivo único, escritas en Python.

Cada componente .janel reúne en un archivo la lógica en Python, una plantilla declarativa y reactiva, y sus estilos en CSS. JanelKit lo compila a Qt Quick (PySide6): interfaces nativas y aceleradas por GPU en Windows, macOS y Linux, sin escribir JavaScript ni QML.

pip install janelkit
janel new mi-app
cd mi-app
python main.py

Un componente

<script lang="python">
from janelkit import state, computed

todos = state([{"id": 1, "title": "Probar JanelKit", "done": False}])
draft = state("")

@computed
def pending():
    return sum(not t["done"] for t in todos.value)

def add():
    todos.value.append({"id": len(todos.value) + 1, "title": draft.value, "done": False})
    draft.value = ""
</script>

<window title="Tareas" width={480} height={400}>
  <column class="page">
    <text class="title">{pending} pendientes</text>
    <row class="new">
      <textfield bind:value={draft} on:submit={add} placeholder="Nueva tarea" flex={1} />
      <button variant="primary" on:click={add}>Añadir</button>
    </row>
    {#each todos as todo (todo["id"])}
      <checkbox checked={todo["done"]} on:change={todo["done"] = event}>{todo["title"]}</checkbox>
    {:else}
      <text>No hay tareas.</text>
    {/each}
  </column>
</window>

<style>
.page { padding: 24px; gap: 12px; }
.title { font-size: var(--font-size-xl); font-weight: 600; }
.new { gap: 8px; }
</style>

Cuando cambia un state, solo se recalcula lo que lo leyó, y solo se actualiza en pantalla lo afectado. Las listas y diccionarios son reactivos también al modificarlos en el sitio (append, todo["done"] = True).

Por qué JanelKit

• Python de principio a fin. La lógica, los manejadores y las expresiones de la plantilla son Python: tus módulos, tus bibliotecas y tus pruebas de siempre.
• Rendimiento nativo. Qt Quick dibuja; JanelKit solo avisa de lo que cambió. Una aplicación mediana arranca en menos de 300 ms y responde en menos de 70 ms. Una <list> virtualizada crea 10 000 filas en unos 40 ms.
• Errores que ayudan. Cada error indica archivo, línea y columna, con sugerencias («¿quisiste decir on:click?»), también los que vienen de Qt o de la ejecución.
• Recarga al guardar. janel dev recarga la vista y conserva el estado de los componentes cuyo script no cambió.
• Probado a fondo. Una suite extensa de pruebas que la CI ejecuta en Windows, Linux y macOS, y cinco aplicaciones grandes de validación (chat, panel en tiempo real, Kanban, hoja de cálculo y gestor de proyectos) construidas sin tocar el framework.
• API pública explícita. Qué es público está documentado y protegido por pruebas, con una política de versiones clara.

Qué incluye

Comandos

Probar una aplicación

from janelkit import inspect

def test_add(tmp_path):
    with inspect.mount("src/App.janel") as app:
        app.find(placeholder="Nueva tarea").type("Pan")
        app.find(text="Añadir").click()
        assert app.find(text="1 pendientes")

Ecosistema

Requisitos

• Python 3.10 o posterior.
• PySide6-Essentials 6.8 o posterior, salvo la 6.12.0: los módulos básicos de Qt, sin los Addons (se instala solo).
• Windows, macOS o Linux.

Estado

JanelKit está en alfa (serie 0.x). Lo público está documentado. Cada serie (0.1, 0.2…) es un cambio de paradigma que puede romperlo; dentro de una serie (0.2.0.0, 0.2.1.0…), lo que se rompa o se retire sigue funcionando con un aviso cuando es viable. Todo cambio se anuncia en las notas de la versión con cómo migrar.

Documentación

• Tutorial: una aplicación completa paso a paso. Empieza aquí.
• El lenguaje .janel: expresiones, bloques, componentes y elementos.
• Estilos y disposición: CSS soportado, flexbox, tokens y temas.
• Desarrollo: janel dev, janel build, errores y editor.
• API pública y cambios entre versiones.
• Crear un ejecutable con PyInstaller.
• Ejemplos: contador, tareas, notas, explorador de archivos, cliente de una API, idiomas, vídeo…

Licencia

MIT. JanelKit usa PySide6 (Qt for Python), que se distribuye bajo LGPL-3.0: si empaquetas tu aplicación con Qt incluido, revisa sus condiciones.