janelkit-desktop

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

pip install janelkit-desktop

En un minuto

from janelkit_desktop import clipboard, dialogs, notify

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)
    notify("Copiado", "La nota está en el portapapeles")

<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.
• Notificaciones del sistema. Con icono en la bandeja. Al pulsar una, la ventana pasa al frente y se llama a on_click.
• Fácil de probar. Añade métodos a janelkit.inspect para responder diálogos y leer notificaciones 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/chat (notificaciones).

Compatibilidad

Sigue la misma política de versiones que el núcleo, con versión propia.

Cambios

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.