stackhelx 1.1.2__tar.gz → 1.1.3__tar.gz

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.
Files changed (61) hide show
  1. {stackhelx-1.1.2 → stackhelx-1.1.3}/CHANGELOG.md +8 -0
  2. {stackhelx-1.1.2 → stackhelx-1.1.3}/PKG-INFO +14 -12
  3. {stackhelx-1.1.2 → stackhelx-1.1.3}/README.es.md +3 -2
  4. {stackhelx-1.1.2 → stackhelx-1.1.3}/README.md +13 -11
  5. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/interfaz.md +7 -0
  6. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/interfaz.md +19 -12
  7. stackhelx-1.1.3/stackhelx/__init__.py +2 -0
  8. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/cli.py +228 -290
  9. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/web/app.css +35 -0
  10. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/web/app.js +546 -346
  11. stackhelx-1.1.3/stackhelx/web/index.html +542 -0
  12. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/conftest.py +10 -1
  13. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_cli.py +19 -19
  14. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_server.py +20 -0
  15. stackhelx-1.1.2/stackhelx/__init__.py +0 -2
  16. stackhelx-1.1.2/stackhelx/web/index.html +0 -415
  17. {stackhelx-1.1.2 → stackhelx-1.1.3}/.github/workflows/ci.yml +0 -0
  18. {stackhelx-1.1.2 → stackhelx-1.1.3}/.github/workflows/release.yml +0 -0
  19. {stackhelx-1.1.2 → stackhelx-1.1.3}/.gitignore +0 -0
  20. {stackhelx-1.1.2 → stackhelx-1.1.3}/AGENTS.md +0 -0
  21. {stackhelx-1.1.2 → stackhelx-1.1.3}/CLAUDE.md +0 -0
  22. {stackhelx-1.1.2 → stackhelx-1.1.3}/LICENSE +0 -0
  23. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/comandos.md +0 -0
  24. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/deteccion.md +0 -0
  25. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/comandos.md +0 -0
  26. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/deteccion.md +0 -0
  27. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/stack-yaml.md +0 -0
  28. {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/stack-yaml.md +0 -0
  29. {stackhelx-1.1.2 → stackhelx-1.1.3}/pyproject.toml +0 -0
  30. {stackhelx-1.1.2 → stackhelx-1.1.3}/scripts/check_docs.py +0 -0
  31. {stackhelx-1.1.2 → stackhelx-1.1.3}/scripts/check_metadata.py +0 -0
  32. {stackhelx-1.1.2 → stackhelx-1.1.3}/stack.example.yaml +0 -0
  33. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/__main__.py +0 -0
  34. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/browse.py +0 -0
  35. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/config.py +0 -0
  36. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/detect.py +0 -0
  37. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/docker.py +0 -0
  38. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/doctor.py +0 -0
  39. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/guardrails.py +0 -0
  40. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/history.py +0 -0
  41. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/mcp.py +0 -0
  42. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/ports.py +0 -0
  43. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/registry.py +0 -0
  44. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/runner.py +0 -0
  45. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/scripts.py +0 -0
  46. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/server.py +0 -0
  47. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/tunnel.py +0 -0
  48. {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/web/tokens.css +0 -0
  49. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_browse.py +0 -0
  50. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_config.py +0 -0
  51. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_conftest.py +0 -0
  52. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_detect.py +0 -0
  53. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_guardrails.py +0 -0
  54. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_history.py +0 -0
  55. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_mcp.py +0 -0
  56. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_ports.py +0 -0
  57. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_registry.py +0 -0
  58. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_runner.py +0 -0
  59. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_scripts.py +0 -0
  60. {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_tunnel.py +0 -0
  61. {stackhelx-1.1.2 → stackhelx-1.1.3}/uv.lock +0 -0
@@ -4,6 +4,14 @@ Formato de [Keep a Changelog](https://keepachangelog.com/es/1.1.0/).
4
4
  Versionado semántico: la superficie pública son los comandos del CLI, el
5
5
  esquema de `stack.yaml` y las rutas de la API local.
6
6
 
7
+ ## [1.1.3] - 2026-10-09
8
+
9
+ ### Añadido y Mejorado
10
+
11
+ - **Selector de idioma en vivo (EN / ES) en la interfaz Web (`index.html`, `app.css`, `app.js`):** Botón selector accesible en el encabezado (`#btn-lang`) que conmuta toda la interfaz web en tiempo real sin recargar la página. Arranca en inglés por defecto y persiste la preferencia en `localStorage` (`stackhelx.lang`).
12
+ - **CLI internacionalizado a Inglés (`cli.py`):** Todos los comandos, ayudas (`shx --help`, `stackhelx <cmd> --help`), encabezados de tablas, confirmaciones y mensajes del CLI pasan a inglés.
13
+ - **Documentación y pruebas actualizadas (`README.md`, `README.es.md`, `docs/`, `tests/`):** Ejemplos de consola y referencias de interfaz actualizadas, aserciones del CLI en inglés y nueva prueba para el selector de idioma web (482/482 pruebas pasando al 100%).
14
+
7
15
  ## [1.1.2] - 2026-10-06
8
16
 
9
17
  ### Añadido y Mejorado
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: stackhelx
3
- Version: 1.1.2
3
+ Version: 1.1.3
4
4
  Summary: Local development environment orchestrator: ports, Docker, backend, and frontend with a single command
5
5
  Project-URL: Homepage, https://github.com/TicoraX/StackHelx
6
6
  Project-URL: Repository, https://github.com/TicoraX/StackHelx
@@ -171,12 +171,12 @@ root:
171
171
  | `package.json` with a server script (`dev`, `start:dev`, `serve`, `start`) | `npm run dev`, switching to `pnpm`/`yarn`/`bun` based on lockfile or `packageManager` |
172
172
 
173
173
  ```
174
- mi-app A:\Proyectos\mi-app
175
- Sin stack.yaml. Detectado:
174
+ my-app A:\Proyectos\my-app
175
+ No stack.yaml. Detected:
176
176
  docker docker compose up -d 5433
177
- web pnpm run dev al arrancar
178
- Para congelarlo en un archivo editable: stackhelx init
179
- Arrancar? [Y/n]
177
+ web pnpm run dev on start
178
+ To freeze into an editable file: stackhelx init
179
+ Start? [Y/n]
180
180
  ```
181
181
 
182
182
  Services start in that order and chain dependencies automatically: frontend
@@ -234,7 +234,9 @@ stackhelx serve # opens http://127.0.0.1:7666
234
234
  ```
235
235
 
236
236
  Included out of the box with no extra dependencies. Register projects directly
237
- from the browser via `Explorar…` or from the terminal with `stackhelx add .`.
237
+ from the browser via `Browse…` or from the terminal with `stackhelx add .`. Use
238
+ the `EN / ES` toggle in the header to switch the interface between English and
239
+ Spanish at any time.
238
240
 
239
241
  Monitor service states, start and stop stacks, free ports held by stray
240
242
  processes, inspect system-wide listening ports, and stream live logs per project.
@@ -252,10 +254,10 @@ stackhelx ports 3000 8080 # specific ports
252
254
  ```
253
255
 
254
256
  ```
255
- PUERTO ESTADO PID PROCESO COMANDO
256
- 3000 ocupado 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
257
- 8080 libre - - -
258
- 5432 ocupado 9012 com.docker.backend.exe
257
+ PORT STATUS PID PROCESS COMMAND
258
+ 3000 occupied 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
259
+ 8080 free - - -
260
+ 5432 occupied 9012 com.docker.backend.exe
259
261
  ```
260
262
 
261
263
  Free a port held by a zombie process:
@@ -284,7 +286,7 @@ The CLI does not track which processes you started in other terminals: if anothe
284
286
  stack is running in a separate shell, its services appear in that list too. That
285
287
  is why the CLI prints the full list before touching anything and defaults the
286
288
  prompt to "no". The web dashboard tracks its own active sessions and excludes
287
- them automatically when clicking "Liberar todos".
289
+ them automatically when clicking "Free all".
288
290
 
289
291
  ## What the kill switch refuses to do
290
292
 
@@ -173,8 +173,9 @@ stackhelx serve # abre http://127.0.0.1:7666
173
173
  ```
174
174
 
175
175
  Viene con la instalación, no hace falta nada más. Registrar proyectos se puede
176
- desde la propia interfaz con `Explorar…`, o desde la terminal con
177
- `stackhelx add .`.
176
+ desde la propia interfaz con `Explorar…` (`Browse…`), o desde la terminal con
177
+ `stackhelx add .`. En el encabezado podés conmutar el idioma de toda la interfaz
178
+ en vivo con el selector `EN / ES`.
178
179
 
179
180
  Estado de cada servicio, arrancar y apagar stacks, liberar puertos tomados por
180
181
  procesos ajenos, y logs en vivo por proyecto.
@@ -112,12 +112,12 @@ root:
112
112
  | `package.json` with a server script (`dev`, `start:dev`, `serve`, `start`) | `npm run dev`, switching to `pnpm`/`yarn`/`bun` based on lockfile or `packageManager` |
113
113
 
114
114
  ```
115
- mi-app A:\Proyectos\mi-app
116
- Sin stack.yaml. Detectado:
115
+ my-app A:\Proyectos\my-app
116
+ No stack.yaml. Detected:
117
117
  docker docker compose up -d 5433
118
- web pnpm run dev al arrancar
119
- Para congelarlo en un archivo editable: stackhelx init
120
- Arrancar? [Y/n]
118
+ web pnpm run dev on start
119
+ To freeze into an editable file: stackhelx init
120
+ Start? [Y/n]
121
121
  ```
122
122
 
123
123
  Services start in that order and chain dependencies automatically: frontend
@@ -175,7 +175,9 @@ stackhelx serve # opens http://127.0.0.1:7666
175
175
  ```
176
176
 
177
177
  Included out of the box with no extra dependencies. Register projects directly
178
- from the browser via `Explorar…` or from the terminal with `stackhelx add .`.
178
+ from the browser via `Browse…` or from the terminal with `stackhelx add .`. Use
179
+ the `EN / ES` toggle in the header to switch the interface between English and
180
+ Spanish at any time.
179
181
 
180
182
  Monitor service states, start and stop stacks, free ports held by stray
181
183
  processes, inspect system-wide listening ports, and stream live logs per project.
@@ -193,10 +195,10 @@ stackhelx ports 3000 8080 # specific ports
193
195
  ```
194
196
 
195
197
  ```
196
- PUERTO ESTADO PID PROCESO COMANDO
197
- 3000 ocupado 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
198
- 8080 libre - - -
199
- 5432 ocupado 9012 com.docker.backend.exe
198
+ PORT STATUS PID PROCESS COMMAND
199
+ 3000 occupied 24188 node.exe node C:\proj\frontend\node_modules\.bin\vite
200
+ 8080 free - - -
201
+ 5432 occupied 9012 com.docker.backend.exe
200
202
  ```
201
203
 
202
204
  Free a port held by a zombie process:
@@ -225,7 +227,7 @@ The CLI does not track which processes you started in other terminals: if anothe
225
227
  stack is running in a separate shell, its services appear in that list too. That
226
228
  is why the CLI prints the full list before touching anything and defaults the
227
229
  prompt to "no". The web dashboard tracks its own active sessions and excludes
228
- them automatically when clicking "Liberar todos".
230
+ them automatically when clicking "Free all".
229
231
 
230
232
  ## What the kill switch refuses to do
231
233
 
@@ -6,6 +6,13 @@ Cómo se arranca y qué muestra está en el
6
6
  [README](../../README.es.md#interfaz-web). Acá está el detalle de cada control y por
7
7
  qué se comporta como se comporta.
8
8
 
9
+ ## Selector de idioma (EN / ES)
10
+
11
+ El encabezado incluye un botón `EN / ES` que conmuta todas las etiquetas, estados,
12
+ tooltips y modales entre inglés y español en tiempo real sin recargar la página.
13
+ La interfaz abre en inglés por defecto y recuerda tu elección en `localStorage`
14
+ (`stackhelx.lang`).
15
+
9
16
  ## Caídas y avisos
10
17
 
11
18
  Cuando un servicio se muere solo, el título de la pestaña lleva un contador y
@@ -6,17 +6,24 @@ How to launch the dashboard and what it displays is covered in the
6
6
  [README](../README.md#web-dashboard). This document explains how each control
7
7
  behaves under the hood and why.
8
8
 
9
+ ## Language selector (EN / ES)
10
+
11
+ The header includes an `EN / ES` toggle that switches every label, status badge,
12
+ tooltip, and modal between English and Spanish in real time without reloading the
13
+ page. The dashboard defaults to English and persists your choice in
14
+ `localStorage` (`stackhelx.lang`).
15
+
9
16
  ## Crashes and browser notifications
10
17
 
11
18
  When a running service exits unexpectedly, the browser tab title shows a counter
12
- and the header reports how many services have fallen. Clicking `Avisarme`
19
+ and the header reports how many services have fallen. Clicking `Notify me`
13
20
  requests browser notification permissions so you get alerted on unexpected
14
- crashes, never when you click `Apagar` or `Reiniciar` yourself. Permission is
21
+ crashes, never when you click `Stop` or `Restart` yourself. Permission is
15
22
  requested only on that click, never on page load.
16
23
 
17
24
  ## Freezing to stack.yaml
18
25
 
19
- Auto-detected projects show a `Congelar a stack.yaml` button, which runs
26
+ Auto-detected projects show a `Freeze to stack.yaml` button, which runs
20
27
  `stackhelx init` directly from the browser. Useful when you want to customize a
21
28
  detected command or pin a port. It asks for confirmation inline on the same
22
29
  button, writes to the registered project path on the server (never trusting a
@@ -24,14 +31,14 @@ path sent from the client), and refuses to overwrite an existing file.
24
31
 
25
32
  ## Restarting a single service
26
33
 
27
- Every service started from the dashboard has its own `Reiniciar` button that
34
+ Every service started from the dashboard has its own `Restart` button that
28
35
  cycles only that service. When your frontend hangs, your database containers do
29
36
  not need to restart with it.
30
37
 
31
38
  ## The Open button
32
39
 
33
- Services that answer HTTP display an `Abrir` button, and the project card has a
34
- top-level `Abrir` button that opens the last HTTP-capable service in startup
40
+ Services that answer HTTP display an `Open` button, and the project card has a
41
+ top-level `Open` button that opens the last HTTP-capable service in startup
35
42
  order (typically the frontend). StackHelx does not guess by service name: once a
36
43
  service is ready, it probes the bound port over HTTP. Even a `404` counts as an
37
44
  HTTP server because many APIs do not serve a root route; only non-HTTP listeners
@@ -39,14 +46,14 @@ like databases are excluded.
39
46
 
40
47
  ## Docker controls
41
48
 
42
- When any registered project uses Docker, the toolbar displays `Docker corriendo`
43
- or `Docker cerrado` alongside an action button: `Abrir Docker` when the daemon
44
- is down, or `Reiniciar Docker` when the daemon is up. Both controls remain
49
+ When any registered project uses Docker, the toolbar displays `Docker running`
50
+ or `Docker stopped` alongside an action button: `Start Docker` when the daemon
51
+ is down, or `Restart Docker` when the daemon is up. Both controls remain
45
52
  visible whenever a project uses Docker: a status indicator that disappears when
46
53
  healthy cannot distinguish "everything is fine" from "the check stopped
47
54
  working".
48
55
 
49
- The stray processes section (`Procesos intrusos`) follows the same principle: as
56
+ The stray processes section (`Stray processes`) follows the same principle: as
50
57
  long as at least one project is registered, the section stays visible and
51
58
  explicitly states when zero stray processes are holding your ports.
52
59
 
@@ -54,7 +61,7 @@ Restarting Docker asks for inline confirmation because it restarts every running
54
61
  container on the machine, including containers from other projects. Starting
55
62
  Docker runs immediately without confirmation.
56
63
 
57
- Note that `Docker cerrado` checks whether the Docker daemon answers `docker
64
+ Note that `Docker stopped` checks whether the Docker daemon answers `docker
58
65
  info`, not whether the Docker Desktop window is open.
59
66
 
60
67
  Under the hood, StackHelx runs `docker desktop start --detach` or
@@ -64,7 +71,7 @@ boots.
64
71
 
65
72
  ## Folder browser
66
73
 
67
- You do not need to copy-paste paths to register a project: `Explorar…` opens a
74
+ You do not need to copy-paste paths to register a project: `Browse…` opens a
68
75
  directory browser starting at your home folder and mounted drives, highlighting
69
76
  folders that contain `stack.yaml`, a Compose file, `package.json`, or
70
77
  `manage.py`. The server builds the listing and returns only folder names and
@@ -0,0 +1,2 @@
1
+ __version__ = "1.1.3"
2
+