@tacuchi/updater 3.0.0 → 3.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +67 -62
- package/dist/cli.js +1379 -1197
- package/package.json +11 -2
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Tacuchi
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,94 +1,99 @@
|
|
|
1
1
|
# @tacuchi/updater
|
|
2
2
|
|
|
3
|
+
> Interfaz de terminal para actualizar gestores de paquetes de macOS, Linux y Windows en un solo flujo.
|
|
4
|
+
|
|
3
5
|
TUI multiplataforma para actualizar **todos** los gestores de paquetes de tu sistema desde un solo flujo. macOS · Linux · Windows. Sin permisos de administrador (salvo los gestores que los exigen).
|
|
4
6
|
|
|
7
|
+
## Instalación
|
|
8
|
+
|
|
9
|
+
### Antes de instalar: lo que necesitas
|
|
10
|
+
|
|
11
|
+
Node.js >=18 y npm, según el manifiesto, y los gestores que quieras actualizar.
|
|
12
|
+
La interfaz con teclado requiere una terminal TTY; sin ella, el flujo se confirma automáticamente.
|
|
13
|
+
|
|
14
|
+
### Instalar el paquete
|
|
15
|
+
|
|
16
|
+
```sh
|
|
17
|
+
npm install -g @tacuchi/updater
|
|
18
|
+
```
|
|
19
|
+
|
|
20
|
+
También puedes ejecutarlo sin instalación global:
|
|
21
|
+
|
|
5
22
|
```bash
|
|
6
23
|
npx @tacuchi/updater # ejecutar sin instalar
|
|
7
|
-
npx @tacuchi/updater --sudo #
|
|
24
|
+
npx @tacuchi/updater --sudo # macOS/Linux: relanzar con permisos de administrador
|
|
8
25
|
```
|
|
9
26
|
|
|
10
|
-
|
|
27
|
+
### Preparar una copia propia
|
|
11
28
|
|
|
12
|
-
|
|
29
|
+
No necesita configurar un servicio. Las preferencias se crean al necesitarlas por primera vez.
|
|
30
|
+
La guía de [preferencias y diagnóstico](docs/config-y-logs.md) explica cómo editarlas.
|
|
13
31
|
|
|
14
|
-
|
|
15
|
-
- Verás spinners mientras trabaja y un resumen inequívoco al terminar (qué se actualizó, qué falló y **por qué**, con la ruta del log).
|
|
16
|
-
- Verificación real: cada actualización se confirma re-listando paquetes desactualizados — un fallo nunca se reporta como éxito.
|
|
32
|
+
### Actualización
|
|
17
33
|
|
|
18
|
-
|
|
34
|
+
```sh
|
|
35
|
+
npm install -g @tacuchi/updater@latest
|
|
36
|
+
```
|
|
19
37
|
|
|
20
|
-
|
|
21
|
-
- **Lenguajes/runtimes**: npm, pnpm, yarn, bun, pip, pipx, conda, gem, composer, angular
|
|
22
|
-
- **Apps/tiendas**: winget, choco, flatpak, snap, mas, scoop
|
|
23
|
-
- **SDK/toolchains**: rustup, cargo, mise, asdf, flutter, go
|
|
38
|
+
### Desinstalar
|
|
24
39
|
|
|
25
|
-
|
|
40
|
+
```sh
|
|
41
|
+
npm uninstall -g @tacuchi/updater
|
|
42
|
+
```
|
|
26
43
|
|
|
27
|
-
|
|
44
|
+
La desinstalación del paquete no incluye una rutina para retirar preferencias o registros.
|
|
28
45
|
|
|
29
|
-
|
|
30
|
-
npm install
|
|
31
|
-
npm run dev # ejecutar sin compilar (tsx)
|
|
32
|
-
npm test # vitest
|
|
33
|
-
npm run typecheck # tsc --noEmit
|
|
34
|
-
npm run build # tsup → dist/cli.js
|
|
35
|
-
```
|
|
46
|
+
### Plataformas
|
|
36
47
|
|
|
37
|
-
|
|
48
|
+
macOS, Linux y Windows. Cada descriptor declara dónde se ofrece y qué permisos necesita.
|
|
49
|
+
En Windows, `--sudo` no eleva: abre la terminal como Administrador o usa `E` en Confirmar.
|
|
38
50
|
|
|
39
|
-
##
|
|
51
|
+
## Uso
|
|
40
52
|
|
|
41
|
-
|
|
42
|
-
que siempre hay algo que leer y editar.
|
|
53
|
+
### Qué puedes recorrer
|
|
43
54
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
55
|
+
Detección con reintento, selección de paquetes, confirmación, actualización y resumen; incluye Ajustes y Detalle.
|
|
56
|
+
La cabecera reúne marca y paso; durante una corrida, Q y Esc preguntan antes de cancelar.
|
|
57
|
+
Ctrl+C cancela y sale de inmediato. La presentación adapta tema, glifos y pistas a la terminal.
|
|
58
|
+
La [guía de uso](docs/uso.md) conserva la lista de 27 gestores y explica los controles y límites.
|
|
48
59
|
|
|
49
|
-
|
|
60
|
+
### Comandos
|
|
50
61
|
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
62
|
+
```sh
|
|
63
|
+
updater
|
|
64
|
+
updater --sudo
|
|
65
|
+
updater --yes
|
|
66
|
+
updater --help
|
|
67
|
+
updater --version
|
|
68
|
+
```
|
|
69
|
+
|
|
70
|
+
`--yes`, `-y`, `--all` o una entrada sin TTY seleccionan y confirman automáticamente.
|
|
71
|
+
Con stdout redirigido, se escriben eventos y resumen por líneas, sin redibujo ni atajos.
|
|
72
|
+
Usa `updater --yes > resultado.txt` para seleccionar y confirmar al redirigir la salida.
|
|
73
|
+
Revisa el resumen: un estado indeterminado puede terminar con código de salida 0.
|
|
60
74
|
|
|
61
|
-
|
|
62
|
-
salida, y **termina siempre con una línea de cierre que declara cómo terminó la corrida** — completa,
|
|
63
|
-
cancelada, interrumpida, fallida o cedida a una consola elevada.
|
|
75
|
+
### Desarrollo y comprobaciones
|
|
64
76
|
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
`SIGHUP` y deja su línea de cierre: se escribe de forma **sincrónica** y **antes** de cancelar la
|
|
68
|
-
corrida, así que no gasta el margen que el sistema da antes de matar el proceso. En Windows ese margen
|
|
69
|
-
es de **5000 ms** (`SPI_GETHUNGAPPTIMEOUT`) y escribir el cierre mide **0,08 ms**. La verificación corre
|
|
70
|
-
en la matriz: el paso *Probe* de `windows-latest` lanza el binario en su propia consola y la cierra.
|
|
77
|
+
La guía de [desarrollo](docs/desarrollo.md) conserva los comandos de instalación, pruebas y construcción.
|
|
78
|
+
La guía de [preferencias y diagnóstico](docs/config-y-logs.md) reúne configuración, registros y señales.
|
|
71
79
|
|
|
72
|
-
|
|
73
|
-
apagar Windows **no entrega ninguna señal**. libuv mapea a `SIGHUP` sólo `CTRL_CLOSE_EVENT` e ignora
|
|
74
|
-
`CTRL_LOGOFF_EVENT` y `CTRL_SHUTDOWN_EVENT`, y `node.exe` enlaza `user32`, lo que según la
|
|
75
|
-
documentación de `SetConsoleCtrlHandler` impide que el manejador se llame para esos dos. Una corrida
|
|
76
|
-
terminada por un apagado no deja línea de cierre. Cubrirlo necesitaría un registro que confirme cada
|
|
77
|
-
línea, no mejor evidencia.
|
|
80
|
+
## Cómo funciona
|
|
78
81
|
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
motivo y un rechazo ahí significa que el archivo está bloqueado por otro proceso.
|
|
82
|
+
Un proceso Node.js presenta la interfaz con React e Ink y coordina descriptores de gestores.
|
|
83
|
+
El motor ejecuta comandos locales y compara los pendientes antes y después de actualizar.
|
|
84
|
+
Preferencias y registros quedan en archivos locales; los gestores usan su propia configuración de red.
|
|
83
85
|
|
|
84
|
-
|
|
85
|
-
informa una sola vez.
|
|
86
|
+

|
|
86
87
|
|
|
87
|
-
|
|
88
|
-
real sin tocar tus datos: `TACUCHI_UPDATER_CONFIG_DIR` y `TACUCHI_UPDATER_LOG_DIR`.
|
|
88
|
+
El cuadro completo está en [ARCHITECTURE.md](ARCHITECTURE.md).
|
|
89
89
|
|
|
90
90
|
El script Python original se conserva en `legacy/updater_simple.py` como referencia histórica.
|
|
91
91
|
|
|
92
|
+
## Contribuir
|
|
93
|
+
|
|
94
|
+
Se aceptan issues y pull requests.
|
|
95
|
+
Para trabajar en el código, consulta [desarrollo](docs/desarrollo.md).
|
|
96
|
+
|
|
92
97
|
## Licencia
|
|
93
98
|
|
|
94
|
-
MIT
|
|
99
|
+
[MIT](LICENSE)
|