janelkit-desktop

Servicios del sistema para aplicaciones JanelKit: diálogos nativos y portapapeles, con await y sin bloquear la ventana.

pip install janelkit-desktop

En un minuto

from janelkit_desktop import clipboard, dialogs

async def abrir():
    ruta = await dialogs.open_file("Abrir nota", filters=["Texto (*.txt *.md)"])
    if ruta is not None:                      # None si el usuario cancela
        texto.value = ruta.read_text()

async def borrar():
    if await dialogs.confirm("¿Borrar la nota?"):
        ...

def copiar():
    clipboard.copy(texto.value)

<button on:click={abrir}>Abrir…</button>
<text>En el portapapeles: {clipboard.paste()}</text>

Características

• Diálogos nativos y asíncronos. Abrir, guardar, elegir carpeta, mensaje y confirmación. Se esperan con await: la ventana sigue respondiendo y el resultado llega como Path, una lista, bool o None si se cancela.
• Portapapeles reactivo. clipboard.paste() en la plantilla se actualiza cuando cambia el portapapeles, también si cambia desde otra aplicación.
• Fácil de probar. Añade métodos a janelkit.inspect para responder diálogos en las pruebas, sin ventanas reales.
• Solo API pública. Usa janelkit y janelkit.ext, nada interno del núcleo; una prueba del repositorio lo comprueba.

Referencia

Las tres piezas necesitan una aplicación en marcha.

En pruebas

Al importarse, el paquete añade estos métodos a MountedApp de janelkit.inspect:

from janelkit import inspect

def test_borrar_pregunta_antes():
    with inspect.mount("src/App.janel") as app:
        app.find(text="Borrar").click()
        app.answer_dialog(False)              # el usuario cancela
        assert app.find(text="Mi nota")

Ejemplos: apps/examples/files (elegir carpeta), apps/challenges/gestor (confirmaciones) y apps/challenges/hoja (abrir y guardar CSV, portapapeles).

Compatibilidad

Comparte la serie con el núcleo: janelkit-desktop 0.2.x.x va con janelkit 0.2.x.x. Los dos últimos números son suyos (política de versiones).

Cambios

0.2.0.0 (2026-11-05)

• Se quitan las notificaciones: notify, el icono de la bandeja del sistema y app.notifications() en janelkit.inspect. El paquete se queda con lo que casi toda aplicación de escritorio necesita: diálogos de archivos, carpeta, mensaje y confirmación, y el portapapeles. Para avisar dentro de la aplicación, usa un aviso en la propia ventana (por ejemplo, un {#if} con un timeout). Importar notify da un error que lo explica.

0.1.0

• Primera versión publicada. Antes eran los módulos janelkit.dialogs, janelkit.clipboard y janelkit.notifications del núcleo: cambia from janelkit import dialogs, clipboard, notify por from janelkit_desktop import dialogs, clipboard, notify.
• Compatible con janelkit 0.1 (janelkit>=0.1,<0.2).

Licencia

MIT.