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.
- {stackhelx-1.1.2 → stackhelx-1.1.3}/CHANGELOG.md +8 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/PKG-INFO +14 -12
- {stackhelx-1.1.2 → stackhelx-1.1.3}/README.es.md +3 -2
- {stackhelx-1.1.2 → stackhelx-1.1.3}/README.md +13 -11
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/interfaz.md +7 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/interfaz.md +19 -12
- stackhelx-1.1.3/stackhelx/__init__.py +2 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/cli.py +228 -290
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/web/app.css +35 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/web/app.js +546 -346
- stackhelx-1.1.3/stackhelx/web/index.html +542 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/conftest.py +10 -1
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_cli.py +19 -19
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_server.py +20 -0
- stackhelx-1.1.2/stackhelx/__init__.py +0 -2
- stackhelx-1.1.2/stackhelx/web/index.html +0 -415
- {stackhelx-1.1.2 → stackhelx-1.1.3}/.github/workflows/ci.yml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/.github/workflows/release.yml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/.gitignore +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/AGENTS.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/CLAUDE.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/LICENSE +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/comandos.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/deteccion.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/comandos.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/deteccion.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/es/stack-yaml.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/docs/stack-yaml.md +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/pyproject.toml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/scripts/check_docs.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/scripts/check_metadata.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stack.example.yaml +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/__main__.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/browse.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/config.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/detect.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/docker.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/doctor.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/guardrails.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/history.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/mcp.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/ports.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/registry.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/runner.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/scripts.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/server.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/tunnel.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/stackhelx/web/tokens.css +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_browse.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_config.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_conftest.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_detect.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_guardrails.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_history.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_mcp.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_ports.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_registry.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_runner.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_scripts.py +0 -0
- {stackhelx-1.1.2 → stackhelx-1.1.3}/tests/test_tunnel.py +0 -0
- {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.
|
|
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
|
-
|
|
175
|
-
|
|
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
|
|
178
|
-
|
|
179
|
-
|
|
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 `
|
|
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
|
-
|
|
256
|
-
3000
|
|
257
|
-
8080
|
|
258
|
-
5432
|
|
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 "
|
|
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
|
|
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
|
-
|
|
116
|
-
|
|
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
|
|
119
|
-
|
|
120
|
-
|
|
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 `
|
|
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
|
-
|
|
197
|
-
3000
|
|
198
|
-
8080
|
|
199
|
-
5432
|
|
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 "
|
|
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 `
|
|
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 `
|
|
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 `
|
|
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 `
|
|
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 `
|
|
34
|
-
top-level `
|
|
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
|
|
43
|
-
or `Docker
|
|
44
|
-
is down, or `
|
|
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 (`
|
|
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
|
|
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: `
|
|
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
|