pendify 0.1.0__tar.gz

pendify-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ElkinDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pendify-0.1.0/MANIFEST.in

@@ -0,0 +1 @@
+prune tests

pendify-0.1.0/PKG-INFO

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: pendify
+Version: 0.1.0
+Summary: Pairs this PC with a phone account by a QR on a loopback page and sends it two kinds of alerts.
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/ElkinDev/PendiFy
+Project-URL: Source, https://github.com/ElkinDev/PendiFy
+Keywords: notifications,alerts,phone,qr,pairing,windows
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# PendiFy
+
+## Español
+
+Un programa pequeño para Windows que avisa en tu teléfono cuando se encuentra tu partida y cuando empieza.
+Se enlaza una sola vez con tu cuenta de Pendi leyendo un código QR, sin crear ninguna cuenta nueva.
+Es gratis, no pide permisos de administrador y solo usa Python.
+
+### Instalar
+
+Pulsa Windows + R, pega esta línea completa y pulsa Enter. También sirve en PowerShell o en el Símbolo del sistema.
+
+    powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-install.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/install.ps1 -OutFile ~\pendify-install.ps1; ~\pendify-install.ps1"
+
+La línea guarda el instalador como `pendify-install.ps1` en tu carpeta de usuario y lo ejecuta desde ahí; puedes borrar ese archivo cuando termine.
+
+La ventana queda abierta al terminar para que leas el resultado; ciérrala cuando acabe.
+
+Si Windows dice que no puede acceder al archivo o el antivirus detiene la línea, no se instaló nada: actualiza las definiciones del antivirus y vuelve a intentarlo, o descarga `install.ps1` desde la página del repositorio, haz clic en él con el botón derecho y elige «Ejecutar con PowerShell».
+
+Si ves "'irm' no se reconoce como un comando interno o externo", pegaste solo la parte corta en el Símbolo del sistema: usa la línea completa de arriba.
+
+El instalador busca Python 3.10 o más nuevo; si no lo hay lo instala con winget solo para tu usuario, o te indica https://www.python.org/downloads/ cuando winget no existe. Después instala PendiFy con pip, deja un acceso directo `PendiFy` en el Escritorio y en el menú Inicio, y lo inicia.
+
+En PowerShell: para ver qué haría sin cambiar nada: `$env:PENDIFY_DRYRUN = "1"` antes de pegar la línea. Para no iniciarlo al final: `$env:PENDIFY_NOSTART = "1"`.
+
+Otra forma, sin ejecutar ningún script: si el PC ya tiene Python 3.10 o más nuevo, o si en él no se permite ejecutar scripts, instálalo con pip e inícialo:
+
+    python -m pip install --upgrade pendify
+    python -m pendify
+
+Si Windows responde que no encuentra `python`, usa `py` en su lugar: `py -m pip install --upgrade pendify` y `py -m pendify`.
+
+Así no se crean los accesos directos en el Escritorio ni en el menú Inicio, y el inicio con Windows queda en el interruptor de la página. Para actualizar, pulsa «Salir» en la página, ejecuta otra vez la misma línea de pip y vuelve a iniciarlo. Para quitarlo, apaga primero el interruptor «Iniciar con Windows» en la página, pulsa «Salir» y después ejecuta `python -m pip uninstall pendify`. La configuración en `%APPDATA%\pendify`, con el enlace con el teléfono, se queda; puedes borrar esa carpeta a mano.
+
+### Enlazar
+
+Al iniciarse, el navegador abre una página local con un código QR. Escanéalo con la cámara del teléfono: se abre la app Pendi y te pide confirmar el enlace. La página muestra cuando el enlace quedó hecho.
+
+El código QR y la clave se muestran durante un minuto al pulsar «Mostrar el código» y luego se ocultan de nuevo.
+
+El botón de arriba a la derecha cambia entre el tema claro y el oscuro, y el programa guarda la elección para la próxima vez.
+
+### Iniciar, detener, desinstalar
+
+- Iniciar: el acceso directo `PendiFy`, o `pythonw -m pendify`, que es lo que ejecuta el acceso directo; sin consola, si ya está abierto o no puede iniciarse te lo dice en una ventana. Para verlo en una consola: `python -m pendify`.
+- Detener: pulsa «Salir» en la página del programa; si no la tienes abierta, iniciarlo otra vez la abre. Como último recurso, cierra el proceso `pythonw.exe` en el Administrador de tareas.
+- Pausar: «Pausar avisos», en la tarjeta «Este PC» de la página, deja de leer el cliente del juego: no acepta partidas ni avisa a tu teléfono, y la página sigue abierta. «Reanudar avisos» vuelve a leerlo. La pausa no se guarda: cada vez que el programa se inicia, empieza activo.
+- Iniciar con Windows: el interruptor «Iniciar con Windows», en la misma tarjeta, está apagado hasta que lo enciendas. Encendido, el programa empieza solo al iniciar sesión en Windows, solo para tu usuario y sin abrir el navegador ni la página.
+- Actividad: la tarjeta «Actividad» de la página lista lo que el programa hizo desde que empezó: el cliente del juego encontrado y perdido, cada fase, la partida aceptada y el aviso enviado. Guarda las últimas 50 líneas, solo en memoria.
+- Idioma: la página sigue el idioma del navegador hasta que eliges ES o EN con el selector de arriba, y la elección se guarda para este PC.
+- Desinstalar: pega `powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-uninstall.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/uninstall.ps1 -OutFile ~\pendify-uninstall.ps1; ~\pendify-uninstall.ps1"` igual que la línea de instalación; deja `pendify-uninstall.ps1` en tu carpeta de usuario, que puedes borrar. Quita el paquete del mismo Python que lo instaló, comprueba que ya no está, quita los dos accesos directos y quita el inicio con Windows si estaba encendido; la configuración en `%APPDATA%\pendify` se queda y te dice dónde está.
+- Actualizar: pulsa «Salir» en la página y vuelve a pegar la línea de instalación; instala la última versión y conserva la configuración y el enlace.
+
+### Qué envía y a quién
+
+Solo envía, al servicio de enlace de Pendi, el tipo de aviso (partida encontrada o partida empezada) junto con el identificador del enlace y el secreto de este PC, que viven en `%APPDATA%\pendify\config.json`. El servicio lo entrega a la cuenta que enlazaste. No envía tu nombre, tus partidas ni nada más del juego. Para saber cuándo empieza la partida lee el reloj del juego en este mismo PC, y no lo guarda ni lo envía.
+
+### `--dry`
+
+Con `--dry` el programa solo avisa y no acepta la partida por ti.
+
+Licencia: MIT
+
+## English
+
+A small Windows program that alerts your phone when your match is found and when it starts.
+It links once to your Pendi account by scanning a QR code, with no new account of any kind.
+It is free, needs no administrator rights and only uses Python.
+
+### Install
+
+Press Windows + R, paste this whole line and press Enter. It also works in PowerShell or the Command Prompt.
+
+    powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-install.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/install.ps1 -OutFile ~\pendify-install.ps1; ~\pendify-install.ps1"
+
+The line saves the installer as `pendify-install.ps1` in your user folder and runs it from there; you can delete that file when it is done.
+
+The window stays open at the end so you can read the result; close it when it is done.
+
+If Windows says it cannot access the file or the antivirus stops the line, nothing was installed: update the antivirus definitions and try again, or download `install.ps1` from the repository page, click it with the right button and choose "Run with PowerShell".
+
+If you see "'irm' is not recognized as an internal or external command", you pasted only the short part into the Command Prompt: use the whole line above.
+
+The installer looks for Python 3.10 or newer; when there is none it installs it with winget for your user only, or points you to https://www.python.org/downloads/ when winget is missing. Then it installs PendiFy with pip, leaves a `PendiFy` shortcut on the Desktop and in the Start menu, and starts it.
+
+In PowerShell: to see what it would do without changing anything, set `$env:PENDIFY_DRYRUN = "1"` before pasting the line. To leave it stopped at the end, set `$env:PENDIFY_NOSTART = "1"`.
+
+Another way, with no script at all: on a PC that already has Python 3.10 or newer, or where scripts are not allowed, install it with pip and start it:
+
+    python -m pip install --upgrade pendify
+    python -m pendify
+
+If Windows answers that `python` was not found, use `py` in its place: `py -m pip install --upgrade pendify` and `py -m pendify`.
+
+This way leaves no shortcut on the Desktop or in the Start menu, and the start with Windows is the switch on the page. To update, press «Quit» on the page, run the same pip line again and start it again. To remove it, first turn off the «Start with Windows» switch on the page, press «Quit», then run `python -m pip uninstall pendify`. The configuration in `%APPDATA%\pendify`, with the link to the phone, stays; you can delete that folder by hand.
+
+### Link
+
+When it starts, the browser opens a local page with a QR code. Scan it with the phone's camera: the Pendi app opens and asks you to confirm the link. The page shows when the link is done.
+
+The QR code and the key show for a minute when «Show the code» is pressed, and then hide again.
+
+The button at the top right switches between the light and the dark theme, and the program keeps the choice for the next time.
+
+### Start, stop, uninstall
+
+- Start: the `PendiFy` shortcut, or `pythonw -m pendify`, which is what the shortcut runs; with no console, it tells you in a window when it is already running or cannot start. To see it in a console: `python -m pendify`.
+- Stop: press «Quit» on the program's page; if it is not open, starting the program again opens it. As a last resort, end the `pythonw.exe` process in Task Manager.
+- Pause: «Pause alerts», on the page's «This PC» card, stops reading the game client: it accepts no match and sends no alert to your phone, and the page stays open. «Resume alerts» reads it again. The pause is not kept: every start of the program is active again.
+- Start with Windows: the «Start with Windows» switch, on the same card, is off until you turn it on. When it is on, the program starts by itself when you sign in to Windows, for your user only, without opening the browser or the page.
+- Activity: the page's «Activity» card lists what the program did since it started: the game client found and lost, each phase, the match accepted and the alert sent. It keeps the last 50 lines, in memory only.
+- Language: the page follows the browser's language until you choose ES or EN with the switch at the top, and the choice is kept for this PC.
+- Uninstall: paste `powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-uninstall.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/uninstall.ps1 -OutFile ~\pendify-uninstall.ps1; ~\pendify-uninstall.ps1"` the same way as the install line; it leaves `pendify-uninstall.ps1` in your user folder, which you can delete. It removes the package from the same Python that installed it, checks that it is gone, removes both shortcuts and removes the start with Windows when it is on; the configuration in `%APPDATA%\pendify` stays, and it tells you where it is.
+- Update: press "Quit" on the page and paste the install line again; it installs the latest version and keeps the configuration and the link.
+
+### What it sends and to whom
+
+It only sends, to Pendi's link service, the alert kind (match found or match started) together with the link id and this PC's secret, which live in `%APPDATA%\pendify\config.json`. The service delivers it to the account you linked. It sends no name, no match history and nothing else from the game. To tell when the match starts it reads the game's clock on this same PC, and neither keeps nor sends it.
+
+### `--dry`
+
+With `--dry` the program only alerts and never accepts the match for you.
+
+License: MIT
+
+## Developer commands
+
+    python -m pendify
+    python -m pendify ping <kind>
+
+The first loads the config, starts the page and opens it in the default browser, paired or not.
+It also watches the game client on this PC: when a match is found it accepts after a short random delay, beeps, and sends the found-match alert; when the loading screen starts it beeps, and when the match itself starts it beeps and sends the started alert.
+Add `--dry` to watch and alert without accepting. Add `--quiet` for the start by the system at logon, the line the start with Windows switch writes (`pythonw -m pendify --quiet`): it never opens the browser, a start that ends well shows no window, and a second quiet start prints `already running` and exits. One copy runs per config folder: a second start opens the page of the one that runs and exits. Ctrl+C stops the page and the watcher together.
+The second sends one alert with the stored pair and prints one line with the answer.
+
+Both commands take `--data-dir <dir>`, used instead of `%APPDATA%` (the config file lives in a folder under it), and `--worker <address>`, used instead of the pairing service's address and accepted only as `http://127.0.0.1:<port>` or `http://localhost:<port>`, so a test run never reaches the real service. `--client-lockfile <file>` replaces the game client's lockfile, with no read of the running processes, and the client it names is reached over plain http on 127.0.0.1, so a test run never reaches a real client.
+
+    python -m unittest discover -s tests -v

pendify-0.1.0/README.md

@@ -0,0 +1,139 @@
+# PendiFy
+
+## Español
+
+Un programa pequeño para Windows que avisa en tu teléfono cuando se encuentra tu partida y cuando empieza.
+Se enlaza una sola vez con tu cuenta de Pendi leyendo un código QR, sin crear ninguna cuenta nueva.
+Es gratis, no pide permisos de administrador y solo usa Python.
+
+### Instalar
+
+Pulsa Windows + R, pega esta línea completa y pulsa Enter. También sirve en PowerShell o en el Símbolo del sistema.
+
+    powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-install.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/install.ps1 -OutFile ~\pendify-install.ps1; ~\pendify-install.ps1"
+
+La línea guarda el instalador como `pendify-install.ps1` en tu carpeta de usuario y lo ejecuta desde ahí; puedes borrar ese archivo cuando termine.
+
+La ventana queda abierta al terminar para que leas el resultado; ciérrala cuando acabe.
+
+Si Windows dice que no puede acceder al archivo o el antivirus detiene la línea, no se instaló nada: actualiza las definiciones del antivirus y vuelve a intentarlo, o descarga `install.ps1` desde la página del repositorio, haz clic en él con el botón derecho y elige «Ejecutar con PowerShell».
+
+Si ves "'irm' no se reconoce como un comando interno o externo", pegaste solo la parte corta en el Símbolo del sistema: usa la línea completa de arriba.
+
+El instalador busca Python 3.10 o más nuevo; si no lo hay lo instala con winget solo para tu usuario, o te indica https://www.python.org/downloads/ cuando winget no existe. Después instala PendiFy con pip, deja un acceso directo `PendiFy` en el Escritorio y en el menú Inicio, y lo inicia.
+
+En PowerShell: para ver qué haría sin cambiar nada: `$env:PENDIFY_DRYRUN = "1"` antes de pegar la línea. Para no iniciarlo al final: `$env:PENDIFY_NOSTART = "1"`.
+
+Otra forma, sin ejecutar ningún script: si el PC ya tiene Python 3.10 o más nuevo, o si en él no se permite ejecutar scripts, instálalo con pip e inícialo:
+
+    python -m pip install --upgrade pendify
+    python -m pendify
+
+Si Windows responde que no encuentra `python`, usa `py` en su lugar: `py -m pip install --upgrade pendify` y `py -m pendify`.
+
+Así no se crean los accesos directos en el Escritorio ni en el menú Inicio, y el inicio con Windows queda en el interruptor de la página. Para actualizar, pulsa «Salir» en la página, ejecuta otra vez la misma línea de pip y vuelve a iniciarlo. Para quitarlo, apaga primero el interruptor «Iniciar con Windows» en la página, pulsa «Salir» y después ejecuta `python -m pip uninstall pendify`. La configuración en `%APPDATA%\pendify`, con el enlace con el teléfono, se queda; puedes borrar esa carpeta a mano.
+
+### Enlazar
+
+Al iniciarse, el navegador abre una página local con un código QR. Escanéalo con la cámara del teléfono: se abre la app Pendi y te pide confirmar el enlace. La página muestra cuando el enlace quedó hecho.
+
+El código QR y la clave se muestran durante un minuto al pulsar «Mostrar el código» y luego se ocultan de nuevo.
+
+El botón de arriba a la derecha cambia entre el tema claro y el oscuro, y el programa guarda la elección para la próxima vez.
+
+### Iniciar, detener, desinstalar
+
+- Iniciar: el acceso directo `PendiFy`, o `pythonw -m pendify`, que es lo que ejecuta el acceso directo; sin consola, si ya está abierto o no puede iniciarse te lo dice en una ventana. Para verlo en una consola: `python -m pendify`.
+- Detener: pulsa «Salir» en la página del programa; si no la tienes abierta, iniciarlo otra vez la abre. Como último recurso, cierra el proceso `pythonw.exe` en el Administrador de tareas.
+- Pausar: «Pausar avisos», en la tarjeta «Este PC» de la página, deja de leer el cliente del juego: no acepta partidas ni avisa a tu teléfono, y la página sigue abierta. «Reanudar avisos» vuelve a leerlo. La pausa no se guarda: cada vez que el programa se inicia, empieza activo.
+- Iniciar con Windows: el interruptor «Iniciar con Windows», en la misma tarjeta, está apagado hasta que lo enciendas. Encendido, el programa empieza solo al iniciar sesión en Windows, solo para tu usuario y sin abrir el navegador ni la página.
+- Actividad: la tarjeta «Actividad» de la página lista lo que el programa hizo desde que empezó: el cliente del juego encontrado y perdido, cada fase, la partida aceptada y el aviso enviado. Guarda las últimas 50 líneas, solo en memoria.
+- Idioma: la página sigue el idioma del navegador hasta que eliges ES o EN con el selector de arriba, y la elección se guarda para este PC.
+- Desinstalar: pega `powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-uninstall.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/uninstall.ps1 -OutFile ~\pendify-uninstall.ps1; ~\pendify-uninstall.ps1"` igual que la línea de instalación; deja `pendify-uninstall.ps1` en tu carpeta de usuario, que puedes borrar. Quita el paquete del mismo Python que lo instaló, comprueba que ya no está, quita los dos accesos directos y quita el inicio con Windows si estaba encendido; la configuración en `%APPDATA%\pendify` se queda y te dice dónde está.
+- Actualizar: pulsa «Salir» en la página y vuelve a pegar la línea de instalación; instala la última versión y conserva la configuración y el enlace.
+
+### Qué envía y a quién
+
+Solo envía, al servicio de enlace de Pendi, el tipo de aviso (partida encontrada o partida empezada) junto con el identificador del enlace y el secreto de este PC, que viven en `%APPDATA%\pendify\config.json`. El servicio lo entrega a la cuenta que enlazaste. No envía tu nombre, tus partidas ni nada más del juego. Para saber cuándo empieza la partida lee el reloj del juego en este mismo PC, y no lo guarda ni lo envía.
+
+### `--dry`
+
+Con `--dry` el programa solo avisa y no acepta la partida por ti.
+
+Licencia: MIT
+
+## English
+
+A small Windows program that alerts your phone when your match is found and when it starts.
+It links once to your Pendi account by scanning a QR code, with no new account of any kind.
+It is free, needs no administrator rights and only uses Python.
+
+### Install
+
+Press Windows + R, paste this whole line and press Enter. It also works in PowerShell or the Command Prompt.
+
+    powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-install.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/install.ps1 -OutFile ~\pendify-install.ps1; ~\pendify-install.ps1"
+
+The line saves the installer as `pendify-install.ps1` in your user folder and runs it from there; you can delete that file when it is done.
+
+The window stays open at the end so you can read the result; close it when it is done.
+
+If Windows says it cannot access the file or the antivirus stops the line, nothing was installed: update the antivirus definitions and try again, or download `install.ps1` from the repository page, click it with the right button and choose "Run with PowerShell".
+
+If you see "'irm' is not recognized as an internal or external command", you pasted only the short part into the Command Prompt: use the whole line above.
+
+The installer looks for Python 3.10 or newer; when there is none it installs it with winget for your user only, or points you to https://www.python.org/downloads/ when winget is missing. Then it installs PendiFy with pip, leaves a `PendiFy` shortcut on the Desktop and in the Start menu, and starts it.
+
+In PowerShell: to see what it would do without changing anything, set `$env:PENDIFY_DRYRUN = "1"` before pasting the line. To leave it stopped at the end, set `$env:PENDIFY_NOSTART = "1"`.
+
+Another way, with no script at all: on a PC that already has Python 3.10 or newer, or where scripts are not allowed, install it with pip and start it:
+
+    python -m pip install --upgrade pendify
+    python -m pendify
+
+If Windows answers that `python` was not found, use `py` in its place: `py -m pip install --upgrade pendify` and `py -m pendify`.
+
+This way leaves no shortcut on the Desktop or in the Start menu, and the start with Windows is the switch on the page. To update, press «Quit» on the page, run the same pip line again and start it again. To remove it, first turn off the «Start with Windows» switch on the page, press «Quit», then run `python -m pip uninstall pendify`. The configuration in `%APPDATA%\pendify`, with the link to the phone, stays; you can delete that folder by hand.
+
+### Link
+
+When it starts, the browser opens a local page with a QR code. Scan it with the phone's camera: the Pendi app opens and asks you to confirm the link. The page shows when the link is done.
+
+The QR code and the key show for a minute when «Show the code» is pressed, and then hide again.
+
+The button at the top right switches between the light and the dark theme, and the program keeps the choice for the next time.
+
+### Start, stop, uninstall
+
+- Start: the `PendiFy` shortcut, or `pythonw -m pendify`, which is what the shortcut runs; with no console, it tells you in a window when it is already running or cannot start. To see it in a console: `python -m pendify`.
+- Stop: press «Quit» on the program's page; if it is not open, starting the program again opens it. As a last resort, end the `pythonw.exe` process in Task Manager.
+- Pause: «Pause alerts», on the page's «This PC» card, stops reading the game client: it accepts no match and sends no alert to your phone, and the page stays open. «Resume alerts» reads it again. The pause is not kept: every start of the program is active again.
+- Start with Windows: the «Start with Windows» switch, on the same card, is off until you turn it on. When it is on, the program starts by itself when you sign in to Windows, for your user only, without opening the browser or the page.
+- Activity: the page's «Activity» card lists what the program did since it started: the game client found and lost, each phase, the match accepted and the alert sent. It keeps the last 50 lines, in memory only.
+- Language: the page follows the browser's language until you choose ES or EN with the switch at the top, and the choice is kept for this PC.
+- Uninstall: paste `powershell -NoExit -NoProfile -ExecutionPolicy Bypass -Command "ri ~\pendify-uninstall.ps1 -ea 0; irm https://raw.githubusercontent.com/ElkinDev/PendiFy/main/uninstall.ps1 -OutFile ~\pendify-uninstall.ps1; ~\pendify-uninstall.ps1"` the same way as the install line; it leaves `pendify-uninstall.ps1` in your user folder, which you can delete. It removes the package from the same Python that installed it, checks that it is gone, removes both shortcuts and removes the start with Windows when it is on; the configuration in `%APPDATA%\pendify` stays, and it tells you where it is.
+- Update: press "Quit" on the page and paste the install line again; it installs the latest version and keeps the configuration and the link.
+
+### What it sends and to whom
+
+It only sends, to Pendi's link service, the alert kind (match found or match started) together with the link id and this PC's secret, which live in `%APPDATA%\pendify\config.json`. The service delivers it to the account you linked. It sends no name, no match history and nothing else from the game. To tell when the match starts it reads the game's clock on this same PC, and neither keeps nor sends it.
+
+### `--dry`
+
+With `--dry` the program only alerts and never accepts the match for you.
+
+License: MIT
+
+## Developer commands
+
+    python -m pendify
+    python -m pendify ping <kind>
+
+The first loads the config, starts the page and opens it in the default browser, paired or not.
+It also watches the game client on this PC: when a match is found it accepts after a short random delay, beeps, and sends the found-match alert; when the loading screen starts it beeps, and when the match itself starts it beeps and sends the started alert.
+Add `--dry` to watch and alert without accepting. Add `--quiet` for the start by the system at logon, the line the start with Windows switch writes (`pythonw -m pendify --quiet`): it never opens the browser, a start that ends well shows no window, and a second quiet start prints `already running` and exits. One copy runs per config folder: a second start opens the page of the one that runs and exits. Ctrl+C stops the page and the watcher together.
+The second sends one alert with the stored pair and prints one line with the answer.
+
+Both commands take `--data-dir <dir>`, used instead of `%APPDATA%` (the config file lives in a folder under it), and `--worker <address>`, used instead of the pairing service's address and accepted only as `http://127.0.0.1:<port>` or `http://localhost:<port>`, so a test run never reaches the real service. `--client-lockfile <file>` replaces the game client's lockfile, with no read of the running processes, and the client it names is reached over plain http on 127.0.0.1, so a test run never reaches a real client.
+
+    python -m unittest discover -s tests -v

pendify-0.1.0/pyproject.toml

@@ -0,0 +1,27 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pendify"
+version = "0.1.0"
+description = "Pairs this PC with a phone account by a QR on a loopback page and sends it two kinds of alerts."
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.10"
+dependencies = []
+keywords = ["notifications", "alerts", "phone", "qr", "pairing", "windows"]
+classifiers = [
+    "Operating System :: Microsoft :: Windows",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3 :: Only",
+]
+
+[project.urls]
+Homepage = "https://github.com/ElkinDev/PendiFy"
+Source = "https://github.com/ElkinDev/PendiFy"
+
+# pip lays the icon beside the modules; install.ps1 points the shortcuts at it.
+[tool.setuptools.package-data]
+pendify = ["*.ico"]

pendify-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pendify-0.1.0/src/pendify/__init__.py

@@ -0,0 +1 @@
+"""Pairs this PC with a phone account by a QR on a loopback page, standard library only."""

pendify-0.1.0/src/pendify/__main__.py

@@ -0,0 +1,265 @@
+"""The commands.
+
+    python -m <package>              the pairing page and the watcher of the game client, together
+    python -m <package> --dry        the same, but the watcher never accepts: it alerts at the queue pop
+    python -m <package> --quiet      the same, started by the system at logon: no browser, and no message box
+                                     unless the start fails
+    python -m <package> ping <kind>  one alert with the stored pair, one fixed line per answer
+
+The page and the watcher stop together on Ctrl+C, on Ctrl+Break and on the page's quit button, which
+removes the run file and exits 0. One instance per config folder: a second start opens the running page
+and exits 0, and one made while that program is still closing after its quit waits for it to end and starts.
+Where no console is attached (a pythonw start), the line a start ends on is also shown in a
+message box. `--data-dir`, `--worker` and `--client-lockfile` are the
+test overrides, loopback only, so a test run reads neither the profile, the Worker nor the client's files.
+"""
+import argparse
+import os
+import signal
+import sys
+import threading
+import time
+import webbrowser
+from pathlib import Path
+
+from . import alert, client, config, page, pairing, runfile, watcher, worker
+from .autostart import Autostart
+
+TICK_SECONDS = 1.0
+STOP_SECONDS = 5.0
+# How long a start waits for a copy that is closing to let its run file go: one tick and the two STOP_SECONDS waits
+# of its stop, with room.
+CLOSING_WAIT_SECONDS = 15.0
+REFUSED_LINE = "refused: the pairing of this PC was not accepted; link it again from the page"
+NOT_LINKED_LINE = "not linked: start the program without arguments and link this PC first"
+ALREADY_RUNNING_LINE = "already running: opening the page of the program that runs"
+# A quiet second start opens nothing, so its line promises nothing.
+QUIET_RUNNING_LINE = "already running"
+PAGE_NOT_KNOWN_LINE = ("already running: the page of the program that runs is not known yet; start it again in a "
+                       "moment to open it")
+CLAIM_FAILED_LINE = "cannot start: the run file cannot be replaced: {path}"
+FOLDER_FAILED_LINE = "cannot start: the config folder cannot be written: {path}"
+_MB_ICONINFORMATION = 0x40
+_MB_SETFOREGROUND = 0x10000
+
+
+def _data_dir(value):
+    if not value.strip():
+        raise argparse.ArgumentTypeError("the data directory is empty")
+    return Path(value)
+
+
+def _client_lockfile(value):
+    if not value.strip():
+        raise argparse.ArgumentTypeError("the lockfile path is empty")
+    return Path(value)
+
+
+def _worker_address(value):
+    try:
+        return worker.loopback_base(value)
+    except ValueError as refused:
+        raise argparse.ArgumentTypeError(str(refused)) from None
+
+
+def _arguments(argv):
+    # The options are accepted before and after the command; SUPPRESS keeps one side from erasing the other.
+    common = argparse.ArgumentParser(add_help=False)
+    common.add_argument("--data-dir", type=_data_dir, default=argparse.SUPPRESS,
+                        help="a directory used instead of %%APPDATA%%, for test runs")
+    common.add_argument("--worker", type=_worker_address, default=argparse.SUPPRESS,
+                        help="http://127.0.0.1:<port> or http://localhost:<port> instead of the Worker, for test runs")
+    common.add_argument("--client-lockfile", type=_client_lockfile, default=argparse.SUPPRESS,
+                        help="a lockfile read instead of the client's, its client reached over plain http on "
+                             "127.0.0.1, for test runs")
+    parser = argparse.ArgumentParser(prog=f"python -m {__package__}", parents=[common],
+                                     description="Pairs this PC by a QR on a loopback page, watches the game "
+                                                 "client and sends alerts.")
+    parser.add_argument("--dry", action="store_true", help="watch and alert, but never accept")
+    parser.add_argument("--quiet", action="store_true",
+                        help="a start by the system: no browser, and no message box for a start that ends well")
+    commands = parser.add_subparsers(dest="command")
+    ping = commands.add_parser("ping", parents=[common], help="send one alert with the stored pair")
+    ping.add_argument("kind", choices=worker.KINDS)
+    return parser.parse_args(argv)
+
+
+def _ping_line(result):
+    if isinstance(result, worker.Sent):
+        return "sent"
+    if isinstance(result, worker.Refused):
+        return REFUSED_LINE
+    if isinstance(result, worker.NotDelivered):
+        return f"not delivered (HTTP {result.status})"
+    return f"failed: {result.reason}"
+
+
+def _ping(store, base, kind, timeout):
+    pair = store.read()  # never a first load: a ping mints nothing
+    if pair is None or pair.link_id is None:
+        print(NOT_LINKED_LINE)
+        return 2
+    result = worker.ping(pair.link_id, pair.secret, kind, base=base, timeout=timeout)
+    print(_ping_line(result))
+    return 0 if isinstance(result, worker.Sent) else 1
+
+
+def _watcher(args, store, state, base, timeout, stop, delay, beep):
+    """The watcher and its alert. The test override reads its one lockfile, with no process read, and
+    reaches its client over plain http on 127.0.0.1."""
+    lockfile = getattr(args, "client_lockfile", None)
+    if lockfile is None:
+        credentials, addresses = client.ClientCredentials(), client.real_addresses
+    else:
+        credentials, addresses = client.ClientCredentials((str(lockfile),), run=None), client.loopback_addresses
+    alerter = alert.Alerter(store, state, lambda link_id, secret, kind: worker.ping(
+        link_id, secret, kind, base=base, timeout=timeout), beep=beep)
+    return watcher.Watcher(credentials, alerter, accept=not args.dry, addresses=addresses, delay=delay,
+                           stop=stop), alerter
+
+
+def _console_attached():
+    """False only on Windows with no terminal on stdout and no console window: a pythonw start, where a
+    printed line reaches nobody."""
+    if os.name != "nt":
+        return True
+    if sys.stdout is not None and sys.stdout.isatty():
+        return True
+    import ctypes
+    from ctypes import wintypes
+
+    kernel32 = ctypes.WinDLL("kernel32")
+    kernel32.GetConsoleWindow.restype = wintypes.HWND
+    return bool(kernel32.GetConsoleWindow())
+
+
+def _message_box(line):
+    """The line in a Windows message box, the one place a start with no console can show it."""
+    import ctypes
+    from ctypes import wintypes
+
+    user32 = ctypes.WinDLL("user32")
+    user32.MessageBoxW.argtypes = (wintypes.HWND, wintypes.LPCWSTR, wintypes.LPCWSTR, wintypes.UINT)
+    user32.MessageBoxW(None, line, __package__, _MB_ICONINFORMATION | _MB_SETFOREGROUND)
+
+
+def _ends(line, code, show):
+    """The line a start ends on: printed as ever, and shown where no console is attached."""
+    print(line, flush=True)
+    show(line)
+    return code
+
+
+def _serve(args, store, base, timeout, opener, stop, delay, beep, show, clock, sleep, autostart):
+    # A quiet start is the system's, at logon: it never opens the browser, and a start that ends well shows no box.
+    calm = (lambda line: None) if args.quiet else show
+    run = runfile.RunFile(store.path.parent, clock=clock, sleep=sleep)
+    try:
+        holder = run.claim()
+        if holder is not None and holder["closing"] and run.wait_released(holder, CLOSING_WAIT_SECONDS):
+            holder = run.claim()  # the closing copy let its file go: this start claims it as a first one does
+    except runfile.FolderNotWritable as refused:
+        return _ends(FOLDER_FAILED_LINE.format(path=refused.filename), 1, show)
+    except OSError:
+        return _ends(CLAIM_FAILED_LINE.format(path=run.path), 1, show)
+    if holder is not None:
+        if holder["closing"]:  # still closing at the bound: its page is going, so it is never opened
+            return _ends(QUIET_RUNNING_LINE if args.quiet else PAGE_NOT_KNOWN_LINE, 0, calm)
+        port = holder["port"] if holder["port"] is not None else run.holder_port(holder)
+        if port is None:  # a winner with no page yet: nothing is opened; a quiet start promises no page either
+            return _ends(QUIET_RUNNING_LINE if args.quiet else PAGE_NOT_KNOWN_LINE, 0, calm)
+        if args.quiet:  # the system's start at logon: nothing opened, nothing shown, a line of its own
+            print(QUIET_RUNNING_LINE, flush=True)
+            return 0
+        print(ALREADY_RUNNING_LINE, flush=True)
+        opener(f"http://{page.ADDRESS}:{port}/")
+        show(ALREADY_RUNNING_LINE)
+        return 0
+    try:
+        state = pairing.PairingState(store, lambda secret: worker.check(secret, base=base, timeout=timeout))
+        watch, alerter = _watcher(args, store, state, base, timeout, stop, delay, beep)
+
+        def quit_page():
+            # The page's quit marks the record closing at once, since a tick can be held in a slow check before
+            # the finally runs, then sets the same stop event as Ctrl+C: the watcher, the page and the run file
+            # end below.
+            try:
+                run.mark_closing()
+            except OSError:
+                pass  # unmarked, the finally marks it again; the stop goes on
+            stop.set()
+
+        pairing_page = page.PairingPage(state, watch=watch.snapshot, on_quit=quit_page, on_pause=watch.pause,
+                                        on_resume=watch.resume, autostart=autostart, events=watch.events)
+        url = pairing_page.start()
+        watching = threading.Thread(target=watch.run, daemon=True)
+        try:
+            run.publish(pairing_page.port)
+            print(f"page: {url}", flush=True)
+            if not args.quiet and not opener(url):  # a start by a person opens the page, linked or not
+                print("open the address above in a browser", flush=True)
+            watching.start()
+            while True:
+                state.tick()
+                if stop.wait(TICK_SECONDS):
+                    break
+        except KeyboardInterrupt:
+            pass
+        finally:
+            stop.set()
+            # First, so a start made while this one stops waits for it instead of opening a closing page: Ctrl+C
+            # and Ctrl+Break are marked only here, and the page's quit, marked already, is marked again.
+            try:
+                run.mark_closing()
+            except OSError:
+                pass  # unmarked, a start meanwhile opens this page as before; the stop goes on
+            if watching.is_alive():
+                watching.join(STOP_SECONDS)
+            alerter.flush(STOP_SECONDS)
+            pairing_page.close()
+    finally:
+        run.release()
+    return 0
+
+
+def _break_as_interrupt():
+    """Ctrl+Break stops the program as Ctrl+C does; only on Windows and only on the main thread."""
+    if not hasattr(signal, "SIGBREAK") or threading.current_thread() is not threading.main_thread():
+        return None
+    return signal.signal(signal.SIGBREAK, signal.default_int_handler)
+
+
+def main(argv=None, *, opener=webbrowser.open, stop=None, timeout=worker.TIMEOUT_SECONDS, delay=None,
+         beep=alert.beep, box=_message_box, autostart=None, console=_console_attached, clock=time.monotonic,
+         sleep=time.sleep):
+    """`beep`, `box` and `autostart` are the seams of the sound, of the message box and of the start with Windows
+    (the per-user Run value when None): a test run passes silent ones and a fake. `console` says whether a printed
+    line reaches anybody; `clock` and `sleep` time the run file's re-reads."""
+    args = _arguments(sys.argv[1:] if argv is None else argv)
+    store = config.ConfigStore(getattr(args, "data_dir", None) or config.default_base_dir())
+    base = getattr(args, "worker", worker.BASE_URL)
+
+    def show(line):  # a start's last line, also in a message box where no console is attached
+        if not console():
+            box(line)
+
+    try:
+        if args.command == "ping":
+            return _ping(store, base, args.kind, timeout)
+        previous = _break_as_interrupt()
+        try:
+            return _serve(args, store, base, timeout, opener, stop or threading.Event(),
+                          delay or watcher.accept_delay, beep, show, clock, sleep,
+                          autostart if autostart is not None else Autostart())
+        finally:
+            if previous is not None:
+                signal.signal(signal.SIGBREAK, previous)
+    except config.ConfigError as failure:  # at start or mid-run: its one sentence, never a traceback
+        print(failure)
+        if args.command != "ping":  # a start ends on it
+            show(str(failure))
+        return 1
+
+
+if __name__ == "__main__":
+    sys.exit(main())