paramsx 2.4.0__tar.gz → 2.5.0__tar.gz

{paramsx-2.4.0 → paramsx-2.5.0}/CHANGELOG.md

@@ -1,5 +1,24 @@
 # Changelog
 
+## 2.5.0
+
+### Añadido
+
+- **Reemplazar** en la web (botón «Reemplazar…» de la barra): buscar y reemplazar en valores, nombres, etiquetas o descripciones de los parámetros que se ven (con el filtro), con vista previa y una casilla por cambio. Solo cambia el editor: después se revisa y se aplica como siempre. Renombrar es crear uno nuevo con lo mismo y borrar el viejo, porque SSM no renombra.
+- Los parámetros nuevos de la web traen la etiqueta `ManagedBy=paramsx`.
+
+### Corregido
+
+- **Lo que falla al aplicar ya no se pierde**: tras aplicar se recarga de AWS, pero lo que no se aplicó (error o no válido en la revisión) vuelve a ponerse en el editor. Si era un conflicto de versión, la siguiente revisión lo sigue marcando.
+- Un parámetro nuevo cuyo nombre acaba en `/` ya no da error en AWS: se quitan las barras finales.
+- **Renombrar nunca pierde el parámetro**: si el nuevo nombre no se puede crear (ya existe, sin permiso, error de AWS), el viejo no se borra. El nuevo conserva la clave KMS propia del viejo.
+
+## 2.4.1
+
+### Cambiado
+
+- **La versión web viene incluida**: Flask pasa a ser una dependencia normal, así que basta con `pip install paramsx` (o `pipx install paramsx`) para tener las dos versiones. `paramsx[web]` se sigue aceptando, pero ya no añade nada.
+
 ## 2.4.0
 
 ### Añadido

{paramsx-2.4.0/paramsx.egg-info → paramsx-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.4.0
+Version: 2.5.0
 Summary: Librería para gestionar y respaldar parámetros de AWS SSM de manera sencilla y eficiente.
 Home-page: https://github.com/pistatxos/paramsx
 Author: Mariox
@@ -9,8 +9,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: boto3
 Requires-Dist: windows-curses; platform_system == "Windows"
+Requires-Dist: flask>=2.2
 Provides-Extra: web
-Requires-Dist: flask>=2.2; extra == "web"
 Dynamic: author
 Dynamic: author-email
 Dynamic: description
@@ -68,7 +68,6 @@ Al arrancar pregunta **1. Web** o **2. Terminal** (o directo: `paramsx --web` /
 ## Versión web
 
 ```bash
-pip install 'paramsx[web]'   # añade Flask
 paramsx --web
 ```
 
@@ -973,7 +972,7 @@ paramsx --version
 | Comando | Descripción |
 |---|---|
 | `paramsx` | Pregunta: web o terminal. |
-| `paramsx --web` | Abre la versión web (necesita `paramsx[web]`). |
+| `paramsx --web` | Abre la versión web en el navegador. |
 | `paramsx --tui` | Abre el menú de terminal. |
 | `paramsx configure` | Crea o comprueba la configuración. |
 | `paramsx configure --ejemplo` | Genera la plantilla completa de configuración. |

{paramsx-2.4.0 → paramsx-2.5.0}/README.md

@@ -45,7 +45,6 @@ Al arrancar pregunta **1. Web** o **2. Terminal** (o directo: `paramsx --web` /
 ## Versión web
 
 ```bash
-pip install 'paramsx[web]'   # añade Flask
 paramsx --web
 ```
 
@@ -950,7 +949,7 @@ paramsx --version
 | Comando | Descripción |
 |---|---|
 | `paramsx` | Pregunta: web o terminal. |
-| `paramsx --web` | Abre la versión web (necesita `paramsx[web]`). |
+| `paramsx --web` | Abre la versión web en el navegador. |
 | `paramsx --tui` | Abre el menú de terminal. |
 | `paramsx configure` | Crea o comprueba la configuración. |
 | `paramsx configure --ejemplo` | Genera la plantilla completa de configuración. |

paramsx-2.5.0/paramsx/__init__.py

@@ -0,0 +1 @@
+__version__ = "2.5.0"

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx/main.py

@@ -783,7 +783,7 @@ ParamsX __VERSION__ - Gestión de Parámetros de AWS SSM
 
 Comandos disponibles:
   paramsx                   Pregunta si quieres la versión web o la de terminal.
-  paramsx --web             Abre la versión web (necesita: pip install 'paramsx[web]').
+  paramsx --web             Abre la versión web en el navegador.
   paramsx --tui             Abre la versión de terminal (requiere configuración previa).
   paramsx configure         Crea ~/.xsoft/paramsx_config.py la primera vez. Si ya lo tienes,
                             NO lo toca: revisa qué opciones nuevas te faltan y si es válido.
@@ -832,7 +832,7 @@ Si necesitas más ayuda puedes leer el readme en GitHub o en Pypi:
 """
     print(help_text.replace("__VERSION__", version_actual()))
 
-MENSAJE_SIN_FLASK = "La versión web necesita Flask: pip install 'paramsx[web]'"
+MENSAJE_SIN_FLASK = "La versión web necesita Flask y no está instalado: reinstala paramsx o haz pip install flask"
 
 
 # Menú de arranque: web o terminal. Devuelve "web", "tui" o None (salir).
@@ -959,7 +959,7 @@ def _tarjetas(hay_web, defecto):
         "│ ▤▤▤▤  ▤▤▤▤▤▤  ▤▤▤    │",
         "│ ▤▤▤▤▤▤▤  ▤▤▤▤  ▤▤    │",
         "└──────────────────────┘",
-        "En el navegador" if hay_web else "pip install 'paramsx[web]'",
+        "En el navegador" if hay_web else "Falta Flask: pip install flask",
     ]
     tui = [
         "2 · TERMINAL",
@@ -996,7 +996,7 @@ def portada(hay_web, defecto):
     columnas = shutil.get_terminal_size((80, 24)).columns
     if columnas < 70:
         lineas = [f"ParamsX {__version__} · {FOOTER_TEXT}",
-                  "  1. Web       " + ("(en el navegador)" if hay_web else "(pip install 'paramsx[web]')"),
+                  "  1. Web       " + ("(en el navegador)" if hay_web else "(falta Flask: pip install flask)"),
                   "  2. Terminal  (el menú de siempre)"]
         return "\n".join(lineas)
 

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx/web/__init__.py

@@ -1,5 +1,5 @@
 """Versión web de paramsx: un Flask local en 127.0.0.1 que se abre en el navegador.
-Necesita el extra [web]: pip install 'paramsx[web]'."""
+Flask viene con paramsx desde la 2.4.1."""
 
 
 def flask_disponible():

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx/web/app.py

@@ -39,6 +39,12 @@ class ErrorWeb(Exception):
         self.mensaje, self.status, self.extra = mensaje, status, extra
 
 
+def sin_barra_final(nombre):
+    """«/dev/app/x/» → «/dev/app/x». Si no queda nada más que barras, se deja (lo rechaza la revisión)."""
+    nombre = nombre.strip()
+    return nombre.rstrip("/") or nombre
+
+
 def _sesion_boto3(perfil, region):
     return boto3.Session(profile_name=perfil or None, region_name=region or None)
 
@@ -245,7 +251,11 @@ def crear_app(config_path=None, token=None, sesion_factory=None, perfiles_aws=No
         items = datos.get("items")
         if not isinstance(items, list) or not items or len(items) > MAX_ITEMS:
             raise ErrorWeb("No hay cambios que revisar.")
-        return [it for it in items if isinstance(it, dict)]
+        items = [it for it in items if isinstance(it, dict)]
+        for it in items:  # un parámetro no puede acabar en «/»: en los nuevos se quita en vez de dar error en AWS
+            if it.get("accion") == "nuevo" and isinstance(it.get("name"), str):
+                it["name"] = sin_barra_final(it["name"])
+        return items
 
     # ------------------------------------------------------------ páginas
 

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx/web/ssm.py

@@ -305,8 +305,10 @@ def validar_item(it, cfg):
 def _revisar(ssm, items, cfg):
     """El plan y lo leído de AWS para hacerlo: (filas, meta). Se lee AWS en este momento."""
     nombres = sorted({it["name"] for it in items if isinstance(it, dict) and it.get("name")})
+    # De los renombrados también se lee el viejo (su clave KMS pasa al nuevo), aunque no se borre
+    viejos = {it["de"] for it in items if it.get("accion") == "nuevo" and isinstance(it.get("de"), str) and it["de"]}
     try:
-        meta = describir(ssm, "", nombres) if nombres else {}
+        meta = describir(ssm, "", sorted(set(nombres) | viejos)) if nombres else {}
     except ClientError as exc:
         if not denegado(exc):
             raise ParametrosError(motivo(exc)) from None
@@ -352,6 +354,13 @@ def _revisar(ssm, items, cfg):
         else:
             fila["errores"].append("Acción no válida.")
         filas.append(fila)
+
+    # Renombrar es crear el nuevo y borrar el viejo: si el nuevo no se puede crear, el viejo no se borra (se perdería)
+    borrados = {f["name"]: f for f in filas if f["accion"] == "borrar"}
+    for it, fila in zip(items, filas):
+        viejo = borrados.get(it.get("de") or "") if it.get("accion") == "nuevo" else None
+        if viejo and fila["errores"] and not viejo["errores"]:
+            viejo["errores"].append(f"No se borra: su nuevo nombre ({fila['name']}) no se puede crear.")
     return filas, meta or {}
 
 
@@ -401,7 +410,7 @@ def aplicar(ssm, items, cfg):
     [{name, accion, ok, error, version, cambios}] sin valores."""
     filas, meta = _revisar(ssm, items, cfg)
     revisado = {f["name"]: f for f in filas}
-    resultados, borrar = [], []
+    resultados, borrar, sin_sustituto = [], [], set()
 
     for it in items:
         nombre, accion = it.get("name", ""), it.get("accion")
@@ -416,12 +425,21 @@ def aplicar(ssm, items, cfg):
             borrar.append(res)
             continue
         try:
-            res["version"] = _aplicar_uno(ssm, it, fila, meta.get(nombre, {}), accion)
+            m = meta.get(it.get("de") or "", {}) if accion == "nuevo" else meta.get(nombre, {})
+            res["version"] = _aplicar_uno(ssm, it, fila, m, accion)
             res["ok"] = True
         except (ClientError, BotoCoreError) as exc:
             res["error"] = motivo(exc)
+            if accion == "nuevo" and it.get("de"):
+                sin_sustituto.add(it["de"])
         resultados.append(res)
 
+    # Su nuevo nombre no se pudo crear: el viejo se queda
+    for b in [b for b in borrar if b["name"] in sin_sustituto]:
+        b["error"] = "No se borra: su nuevo nombre no se pudo crear."
+        borrar.remove(b)
+        resultados.append(b)
+
     # Borrados de 10 en 10 (el máximo de DeleteParameters)
     for i in range(0, len(borrar), 10):
         lote = borrar[i:i + 10]
@@ -452,6 +470,9 @@ def _aplicar_uno(ssm, it, fila, m, accion):
             kw["Tags"] = tags
         if grande:
             kw["Tier"] = "Advanced"
+        # Renombrado (m es el viejo): se conserva su clave KMS propia en vez de la de por defecto
+        if it["type"] == "SecureString" and m.get("key_id") and m["key_id"] not in KMS_DEFECTO:
+            kw["KeyId"] = m["key_id"]
         return _put(ssm, **kw).get("Version")
 
     version = None

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx/web/static/app.css

@@ -260,3 +260,31 @@ details.rama[open] > summary.exp-fila::before { transform: rotate(90deg); }
   .barra-acciones { margin-left: 0; }
   .tabla { table-layout: auto; }
 }
+
+/* ---------------------------------------------------------------- reemplazar */
+.reemplazar { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin: 12px 0; }
+.reemplazar input { font-family: var(--mono); }
+.reemplazar-donde { display: flex; flex-wrap: wrap; align-items: center; gap: 8px 12px; margin-bottom: 10px; }
+.reemplazar-et { font-size: 12px; font-weight: 700; color: var(--suave); }
+.pildoras { display: inline-flex; border: 1px solid var(--campo); border-radius: 9px; overflow: hidden; }
+.pildora { position: relative; display: inline-flex; cursor: pointer; margin: 0; }
+.pildora input { position: absolute; opacity: 0; pointer-events: none; }
+.pildora span { padding: 7px 13px; font-size: 13px; font-weight: 600; color: var(--suave); background: #fff; border-left: 1px solid var(--borde); user-select: none; }
+.pildoras .pildora:first-child span { border-left: 0; }
+.pildora input:checked + span { background: var(--tinta); color: #fff; }
+.pildora input:focus-visible + span { outline: 2px solid #9cc0f5; outline-offset: -2px; }
+.pildora.sola span { border: 1px solid var(--campo); border-radius: 9px; }
+.modal .reemplazar-aviso { margin: 6px 0 10px; font-size: 12.5px; color: var(--ambar); }
+.reemplazar-lista { max-height: 45vh; overflow: auto; border: 1px solid var(--borde); border-radius: 10px; padding: 6px 10px; background: #fbfcfd; margin-bottom: 4px; }
+.modal .reemplazar-cuenta { margin: 0 0 8px; font-size: 12.5px; }
+.reemplazar-tabla { width: 100%; border-collapse: collapse; font-size: 12.5px; }
+.reemplazar-tabla th { text-align: left; font-size: 11px; letter-spacing: .06em; text-transform: uppercase; color: var(--suave); padding: 6px 8px; border-bottom: 1px solid var(--borde); position: sticky; top: 0; background: #fbfcfd; }
+.reemplazar-tabla td { padding: 8px; border-bottom: 1px solid var(--borde-suave); vertical-align: top; }
+.reemplazar-tabla tr:last-child td { border-bottom: 0; }
+.reemplazar-tabla th:first-child, .reemplazar-tabla td:first-child { width: 28px; text-align: center; }
+.reemplazar-tabla td:nth-child(2), .reemplazar-tabla td:nth-child(3) { white-space: nowrap; }
+.reemplazar-tabla td:nth-child(3) small { display: block; color: var(--tenue); margin-top: 3px; }
+.reemplazar-antes, .reemplazar-despues { display: block; font-family: var(--mono); font-size: 12px; white-space: pre-wrap; overflow-wrap: anywhere; padding: 2px 6px; border-radius: 5px; }
+.reemplazar-antes { background: var(--rojo-fondo); color: var(--rojo); text-decoration: line-through; margin-bottom: 3px; }
+.reemplazar-despues { background: var(--ok-fondo); color: var(--ok); }
+@media (max-width: 640px) { .reemplazar { grid-template-columns: 1fr; } }

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx/web/static/paramsx.js

@@ -11,6 +11,9 @@
   const obligatorias = () => cfg().tags_activas ? (cfg().tags_obligatorias || []) : [];
   const entornoDe = seg => cfg().entornos.find(e => e === String(seg).toLowerCase());
   const claseEntorno = e => !e ? '' : /^prod/.test(e) ? 'prod' : /^(stg|pre|staging|qa|test|uat)/.test(e) ? 'stg' : 'dev';
+  // Un parámetro no puede acabar en «/»: se quitan las barras finales si queda algo más (el servidor hace lo mismo)
+  const sinBarraFinal = n => { const t = String(n || '').trim(); return t.replace(/\/+$/, '') || t; };
+  const nombreEnvio = p => p.nuevo ? sinBarraFinal(p.name) : p.name.trim();
 
   // ------------------------------------------------ perfil, región y grupos
   async function pintarDonde() {
@@ -272,6 +275,7 @@
     if (e.target.dataset.campo !== 'name') return;
     const input = e.target, p = S.items[+input.closest('.param').dataset.i];
     const g = grupoSel();
+    p.name = sinBarraFinal(p.name); input.value = p.name;
     try {
       const r = await post('/api/nombre-nuevo', { base: S.ruta, nombre: p.name.trim(), perfil: g ? g.perfil : '' });
       p.name = r.nombre;
@@ -305,6 +309,7 @@
     if (!S.ruta) return toast('Carga antes un grupo o una ruta.', true);
     const entorno = S.entorno || (S.ruta.split('/').map(entornoDe).find(Boolean) || '');
     const tags = Object.fromEntries(obligatorias().map(k => [k, k === 'Environment' ? entorno : '']));
+    tags.ManagedBy = tags.ManagedBy || 'paramsx';  // quién lo creó; si es obligatoria, ya va rellena
     S.items.unshift({ name: S.ruta.replace(/\/$/, '') + '/', type: cfg().forzar_securestring === false ? 'String' : 'SecureString', value: '', description: '', tags, nuevo: true, borrar: false, ver: true, orig: null, descripcion_legible: true });
     pintar();
     const input = $('pLista').querySelector('[data-i="0"] [data-campo="name"]');
@@ -319,8 +324,8 @@
   window.addEventListener('beforeunload', e => { if (pendientes().length) { e.preventDefault(); e.returnValue = ''; } });
 
   // ------------------------------------------------ revisar y aplicar
-  const paraEnviar = () => pendientes().map(p => ({ name: p.name.trim(), accion: p.nuevo ? 'nuevo' : p.borrar ? 'borrar' : 'editar', version: p.orig ? p.orig.version : null,
-    value: p.value, description: p.description || '', type: p.type, tags: p.tags }));
+  const paraEnviar = () => pendientes().map(p => ({ name: nombreEnvio(p), accion: p.nuevo ? 'nuevo' : p.borrar ? 'borrar' : 'editar', version: p.orig ? p.orig.version : null,
+    value: p.value, description: p.description || '', type: p.type, tags: p.tags, ...(p.nuevo && p.de ? { de: p.de } : {}) }));
   const ETIQUETA = { nuevo: 'Nuevo', editar: 'Modificado', borrar: 'Borrar' };
   $('pRevisar').onclick = async () => {
     const items = paraEnviar();
@@ -332,7 +337,7 @@
     const frase = `APLICAR EN ${r.account}`;
     modal.abrir(`<h2>Revisar cambios</h2><p>Comparado con lo que hay ahora en AWS, en la cuenta <b>${esc(r.account)}</b> · ${esc(r.region_name)}.${r.plan.length - validos.length ? ` <span class="warn">${r.plan.length - validos.length} no se aplicarán (ver motivo).</span>` : ''}${conflictos ? ' <b class="error">Hay conflictos: recarga el grupo para ver lo que hay ahora.</b>' : ''}</p>
       <div class="plan">${r.plan.map(f => {
-        const actual = S.items.find(p => p.name.trim() === f.name) || {};
+        const actual = S.items.find(p => nombreEnvio(p) === f.name) || {};
         return `<div class="plan-fila ${f.errores.length ? 'mal' : ''}"><div>${f.conflicto ? '<span class="pill conflicto">Conflicto</span>' : `<span class="pill ${f.errores.length ? 'mal' : f.accion}">${ETIQUETA[f.accion] || esc(f.accion)}</span>`}<code>${esc(f.name)}</code> ${f.accion === 'editar' ? f.cambios.map(c => `<span class="cambio">${esc(c)}</span>`).join(' ') : ''}</div>
         ${f.errores.map(x => `<small class="error">${esc(x)}</small>`).join('')}${f.avisos.map(x => `<small class="warn">⚠ ${esc(x)}</small>`).join('')}
         ${f.cambios.includes('valor') && f.accion === 'editar' ? `<details><summary>Ver el valor antes y después</summary><div class="diff"><div><small>Ahora en AWS</small><pre>${esc(f.antes ?? '')}</pre></div><div><small>Después</small><pre>${esc(actual.value ?? '')}</pre></div></div></details>` : ''}
@@ -355,13 +360,113 @@
         const ok = res.resultados.filter(x => x.ok).length, mal = res.resultados.filter(x => !x.ok);
         modal.abrir(`<h2>${mal.length ? 'Aplicado en parte' : 'Aplicado'}</h2><p>${ok} de ${res.resultados.length} cambios hechos en AWS. El grupo se ha vuelto a cargar.</p>${mal.length ? `<div class="plan">${mal.map(x => `<div class="plan-fila mal"><code>${esc(x.name)}</code><small class="error">${esc(x.error)}</small></div>`).join('')}</div>` : ''}<div class="acciones"><button type="button" class="primario" id="pSeguir">Cerrar</button></div>`);
         $('pSeguir').onclick = modal.cerrar;
-        S.items = []; S.carpetas = null;  // se recarga de AWS (puede haber rutas nuevas o borradas)
+        // Se recarga de AWS (puede haber rutas nuevas o borradas), pero lo que no se aplicó (falló o la revisión lo dejó
+        // fuera) se guarda antes y se vuelve a poner, para corregirlo sin escribirlo otra vez
+        const hechos = new Set(res.resultados.filter(x => x.ok).map(x => x.name));
+        const sinHacer = pendientes().filter(p => !hechos.has(nombreEnvio(p))).map(p => ({ ...p, name: nombreEnvio(p) }));
+        const conflictos = new Set([...r.plan.filter(f => f.conflicto).map(f => f.name), ...mal.filter(x => /^Conflicto/.test(x.error)).map(x => x.name)]);
+        S.items = []; S.carpetas = null;
         await cargar();
+        if (sinHacer.length && S.ruta) { reponer(S.items, sinHacer, conflictos); pintar(); }
         toast(mal.length ? `${ok} aplicados, ${mal.length} con error` : `${ok} cambios aplicados`, !!mal.length);
       } catch (e) { $('pAplicar').disabled = false; $('pAplicar').textContent = 'Aplicar'; toast(e.message, true); }
     };
   };
 
+  // Tras aplicar y recargar: pone otra vez sobre lo recién leído de AWS lo que no se aplicó. Los nuevos, arriba y en
+  // su orden; en los existentes, lo editado y la marca de borrar. Si era un conflicto, se queda con la versión que se
+  // cargó entonces, para que la revisión lo siga marcando y no pise sin avisar el cambio de otro.
+  function reponer(items, sinHacer, conflictos) {
+    for (const g of [...sinHacer].reverse()) {
+      if (g.nuevo) { items.unshift(g); continue; }
+      const p = items.find(q => q.name === g.name); if (!p) continue;
+      Object.assign(p, { value: g.value, description: g.description, type: g.type, tags: g.tags ? { ...g.tags } : p.tags, borrar: g.borrar, ver: g.ver });
+      if (conflictos.has(g.name) && g.orig) p.orig = { ...p.orig, version: g.orig.version };
+    }
+    return items;
+  }
+
+  // ------------------------------------------------ reemplazar (buscar y reemplazar en lo que se ve con el filtro)
+  // Solo cambia el editor, como si se hubiera escrito a mano; después, «Revisar cambios» como siempre. Un nombre nuevo es
+  // crear otro parámetro con lo mismo y borrar el viejo (en SSM no se puede renombrar).
+  const escRe = t => t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const recorte = (t, re) => {  // en valores largos, el trozo de alrededor de la primera coincidencia
+    const m = t.search(re); if (t.length <= 90 || m < 0) return t;
+    const ini = Math.max(0, m - 35); return (ini ? '…' : '') + t.slice(ini, ini + 90) + (ini + 90 < t.length ? '…' : '');
+  };
+  const visibles = () => [...$('pLista').querySelectorAll('.param:not([hidden])')].map(c => +c.dataset.i);
+  function coincidencias(buscar, por, donde, mayus) {
+    const reT = new RegExp(escRe(buscar), mayus ? '' : 'i'), reG = new RegExp(escRe(buscar), mayus ? 'g' : 'gi'), out = [];
+    for (const i of visibles()) {
+      const p = S.items[i]; if (!p || p.bloqueado || p.borrar) continue;
+      const mira = (campo, clave, antes) => {
+        if (typeof antes !== 'string' || !reT.test(antes)) return;
+        const despues = antes.replace(reG, () => por);
+        if (despues === antes) return;  // no cambia nada (y un nombre igual sería crear y borrar el mismo)
+        out.push({ i, campo, clave, antes, despues, n: (antes.match(reG) || []).length, reT });
+      };
+      if (donde.nombre) mira('nombre', '', p.name);
+      if (donde.valor) mira('valor', '', p.value);
+      if (donde.descripcion && p.descripcion_legible !== false) mira('descripción', '', p.description || '');
+      if (donde.etiquetas && p.tags) Object.entries(p.tags).forEach(([k, v]) => mira('etiqueta', k, String(v)));
+    }
+    return out;
+  }
+  $('pReemplazar').onclick = () => {
+    if (!S.ruta) return toast('Carga antes un grupo o una ruta.', true);
+    const n = visibles().length;
+    modal.abrir(`<h2>Reemplazar</h2><p>En los ${n} parámetros que ves ahora${$('pFiltro').value.trim() ? ' (con el filtro)' : ''}. Solo cambia el editor: después, «Revisar cambios» como siempre.</p>
+      <div class="reemplazar"><label class="campo">Buscar<input id="rBuscar" ${NOFILL}></label><label class="campo">Reemplazar por<input id="rPor" ${NOFILL}></label></div>
+      <div class="reemplazar-donde"><span class="reemplazar-et">Buscar en</span><span class="pildoras">${[['rValor', 'Valores', true], ['rNombre', 'Nombres', false], ['rEtiquetas', 'Etiquetas', false], ['rDesc', 'Descripciones', false]]
+        .map(([id, t, on]) => `<label class="pildora"><input type="checkbox" id="${id}" ${on ? 'checked' : ''}><span>${t}</span></label>`).join('')}</span>
+        <label class="pildora sola"><input type="checkbox" id="rMayus"><span>Aa · distinguir mayúsculas</span></label></div>
+      <p class="aviso reemplazar-aviso" id="rAvisoNombre" hidden>⚠ En SSM un parámetro no se renombra: se crea uno nuevo con el mismo valor, tipo, descripción y etiquetas, y se borra el viejo. Lo que lo lea por el nombre viejo dejará de encontrarlo, y su historial de versiones no pasa al nuevo. Si el nuevo no se puede crear, el viejo no se borra.</p>
+      <div id="rLista" class="reemplazar-lista"><p class="muted">Escribe qué buscar.</p></div>
+      <div class="acciones"><button type="button" class="primario" id="rPoner" disabled>Poner en el editor</button><button type="button" class="secundario" id="rNo">Cancelar</button></div>`);
+    let lista = [];
+    const donde = () => ({ valor: $('rValor').checked, nombre: $('rNombre').checked, etiquetas: $('rEtiquetas').checked, descripcion: $('rDesc').checked });
+    const oculto = c => c.campo === 'valor' && S.items[c.i].type === 'SecureString' && !S.items[c.i].ver && !$('pMostrar').checked;
+    const ver = () => {
+      const buscar = $('rBuscar').value;
+      $('rAvisoNombre').hidden = !$('rNombre').checked;
+      lista = buscar ? coincidencias(buscar, $('rPor').value, donde(), $('rMayus').checked) : [];
+      const rePor = new RegExp(escRe($('rPor').value) || '^');
+      $('rLista').innerHTML = !buscar ? '<p class="muted">Escribe qué buscar.</p>' : !lista.length ? '<p class="muted">Nada que coincida.</p>'
+        : `<p class="reemplazar-cuenta">${lista.length} ${lista.length === 1 ? 'cambio' : 'cambios'} en ${new Set(lista.map(c => c.i)).size} parámetros · desmarca los que no quieras</p>
+          <table class="reemplazar-tabla"><thead><tr><th><input type="checkbox" id="rTodos" checked title="Todos" aria-label="Todos"></th><th>Parámetro</th><th>Dónde</th><th>Antes → después</th></tr></thead><tbody>${lista.map((c, k) => `<tr>
+          <td><input type="checkbox" data-r="${k}" checked aria-label="Aplicar este cambio"></td><td><code>${esc(S.items[c.i].name)}</code></td>
+          <td><span class="cambio">${c.campo}${c.clave ? ' · ' + esc(c.clave) : ''}</span>${c.n > 1 ? `<small>${c.n} veces</small>` : ''}</td>
+          <td>${oculto(c) ? '<small class="muted">Valor cifrado: marca «Mostrar valores» para verlo</small>'
+            : `<span class="reemplazar-antes">${esc(recorte(c.antes, c.reT))}</span><span class="reemplazar-despues">${esc(recorte(c.despues, rePor))}</span>`}</td></tr>`).join('')}</tbody></table>`;
+      if ($('rTodos')) $('rTodos').addEventListener('change', e => $('rLista').querySelectorAll('[data-r]').forEach(x => { x.checked = e.target.checked; }));
+      $('rPoner').disabled = !lista.length;
+    };
+    ['rBuscar', 'rPor'].forEach(id => $(id).addEventListener('input', ver));
+    ['rValor', 'rNombre', 'rEtiquetas', 'rDesc', 'rMayus'].forEach(id => $(id).addEventListener('change', ver));
+    $('rNo').onclick = modal.cerrar; $('rBuscar').focus();
+    $('rPoner').onclick = () => {
+      const elegidos = lista.filter((_, k) => ($('rLista').querySelector(`[data-r="${k}"]`) || {}).checked);
+      const nombres = elegidos.filter(c => c.campo === 'nombre'), choques = [];
+      for (const c of elegidos.filter(c => c.campo !== 'nombre')) {
+        const p = S.items[c.i];
+        if (c.campo === 'valor') p.value = c.despues;
+        else if (c.campo === 'descripción') p.description = c.despues;
+        else p.tags = { ...p.tags, [c.clave]: c.despues };
+      }
+      // Los nombres al final y de abajo arriba: cada nuevo va justo debajo del que sustituye, y el viejo se marca para borrar
+      for (const c of nombres.sort((a, b) => b.i - a.i)) {
+        const p = S.items[c.i], nuevo = sinBarraFinal(c.despues);
+        if (S.items.some(q => q !== p && nombreEnvio(q) === nuevo)) { choques.push(nuevo); continue; }
+        if (p.nuevo) { p.name = nuevo; continue; }
+        const copia = { name: nuevo, type: p.type, value: p.value, description: p.description || '', tags: p.tags ? { ...p.tags } : {}, nuevo: true, borrar: false, ver: p.ver, orig: null, descripcion_legible: true, de: p.name };
+        Object.assign(p, { value: p.orig.value, type: p.orig.type, description: p.orig.description, tags: p.orig.tags ? { ...p.orig.tags } : null, borrar: true });
+        S.items.splice(c.i + 1, 0, copia);
+      }
+      modal.cerrar(); pintar();
+      toast(`${elegidos.length - choques.length} ${elegidos.length - choques.length === 1 ? 'cambio puesto' : 'cambios puestos'} en el editor${choques.length ? `; ${choques.length} ${choques.length === 1 ? 'nombre no, porque ya existe' : 'nombres no, porque ya existen'}: ${choques.join(', ')}` : ''}. Revisa y aplica.`, !!choques.length);
+    };
+  };
+
   // ------------------------------------------------ historial (las versiones de AWS)
   async function historial(i) {
     const p = S.items[i];

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx/web/templates/index.html

@@ -42,6 +42,7 @@
       <label class="check"><input type="checkbox" id="pMostrar"><span>Mostrar valores</span></label>
       <span class="resumen" id="pResumen"></span>
       <span class="barra-acciones">
+        <button type="button" class="secundario" id="pReemplazar" title="Buscar y reemplazar en valores, nombres, etiquetas o descripciones de lo que ves (con el filtro)">Reemplazar…</button>
         <button type="button" class="secundario" id="pNuevo">+ Nuevo</button>
         <button type="button" class="secundario" id="pDescartar" hidden>Descartar cambios</button>
         <button type="button" class="primario" id="pRevisar" disabled>Revisar cambios</button>

{paramsx-2.4.0 → paramsx-2.5.0/paramsx.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.4.0
+Version: 2.5.0
 Summary: Librería para gestionar y respaldar parámetros de AWS SSM de manera sencilla y eficiente.
 Home-page: https://github.com/pistatxos/paramsx
 Author: Mariox
@@ -9,8 +9,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: boto3
 Requires-Dist: windows-curses; platform_system == "Windows"
+Requires-Dist: flask>=2.2
 Provides-Extra: web
-Requires-Dist: flask>=2.2; extra == "web"
 Dynamic: author
 Dynamic: author-email
 Dynamic: description
@@ -68,7 +68,6 @@ Al arrancar pregunta **1. Web** o **2. Terminal** (o directo: `paramsx --web` /
 ## Versión web
 
 ```bash
-pip install 'paramsx[web]'   # añade Flask
 paramsx --web
 ```
 
@@ -973,7 +972,7 @@ paramsx --version
 | Comando | Descripción |
 |---|---|
 | `paramsx` | Pregunta: web o terminal. |
-| `paramsx --web` | Abre la versión web (necesita `paramsx[web]`). |
+| `paramsx --web` | Abre la versión web en el navegador. |
 | `paramsx --tui` | Abre el menú de terminal. |
 | `paramsx configure` | Crea o comprueba la configuración. |
 | `paramsx configure --ejemplo` | Genera la plantilla completa de configuración. |

{paramsx-2.4.0 → paramsx-2.5.0}/setup.py

@@ -92,10 +92,11 @@ setup(
     install_requires= [
         "boto3",
         "windows-curses; platform_system == 'Windows'",
+        "flask>=2.2",  # la versión web
     ],
-    # La versión web es opcional: pip install 'paramsx[web]'
+    # 'paramsx[web]' se mantiene para quien lo instaló así en la 2.4.0; ya no añade nada
     extras_require={
-        "web": ["flask>=2.2"],
+        "web": [],
     },
     entry_points={
         "console_scripts": [

{paramsx-2.4.0 → paramsx-2.5.0}/tests/test_web.py

@@ -293,3 +293,117 @@ def test_guardar_no_reordena_perfiles(cliente, config_path):
     assert list(cfg["perfiles"]) == ["min", "max"]
     assert cliente.put("/api/config", json={"config": cfg}).status_code == 200
     assert list(core_config.cargar_config_literal(config_path)["perfiles"]) == ["min", "max"]
+
+
+def renombrar(p, nuevo):
+    """Lo que manda «Reemplazar» en nombres: el alta del nuevo (con «de») y el borrado del viejo."""
+    return [item(p, accion="nuevo", name=nuevo, version=None, de=p["name"]), item(p, accion="borrar")]
+
+
+def test_renombrar_conserva_la_clave_kms_y_nunca_pierde_el_viejo(cliente, ssm, monkeypatch):
+    clave = "arn:aws:kms:eu-south-2:1:key/propia"
+    ssm.poner("/dev/app/db", "secreto", tags=TAGS, key_id=clave)
+    ssm.poner("/dev/app/url", "https://x", tipo="String", tags=TAGS)
+    ssm.poner("/dev/app/grande", "ya estaba", tipo="String", tags=TAGS)
+    ps = cargar(cliente)
+    r = cliente.post("/api/aplicar", json={"items": renombrar(ps["/dev/app/db"], "/dev/app/db2"),
+                                           "confirmacion": CONFIRMA, "borrados": "1"}).get_json()
+    assert all(x["ok"] for x in r["resultados"]), r
+    assert ssm.ops("PutParameter")[0]["KeyId"] == clave  # la clave propia del viejo, no la de por defecto
+    assert ssm.params["/dev/app/db2"]["key_id"] == clave and "/dev/app/db" not in ssm.params
+
+    # El nuevo nombre ya existe en AWS: la revisión no deja borrar el viejo
+    filas = {f["name"]: f for f in cliente.post("/api/plan", json={
+        "items": renombrar(ps["/dev/app/url"], "/dev/app/grande")}).get_json()["plan"]}
+    assert "No se borra" in " ".join(filas["/dev/app/url"]["errores"])
+
+    # Y si falla al crearlo en AWS (aquí, otro lo crea justo antes), el viejo tampoco se borra
+    real = ssm.put_parameter
+
+    def lo_crea_otro(**kw):
+        if kw["Name"] not in ssm.params:
+            ssm.poner(kw["Name"], "de otro", tipo="String")
+        return real(**kw)
+    monkeypatch.setattr(ssm, "put_parameter", lo_crea_otro)
+    r = {x["name"]: x for x in cliente.post("/api/aplicar", json={
+        "items": renombrar(ps["/dev/app/url"], "/dev/app/url2"), "confirmacion": CONFIRMA,
+        "borrados": "1"}).get_json()["resultados"]}
+    assert not r["/dev/app/url2"]["ok"] and not r["/dev/app/url"]["ok"]
+    assert "No se borra" in r["/dev/app/url"]["error"]
+    assert "/dev/app/url" in ssm.params and not [o for o in ssm.ops("DeleteParameters") if "/dev/app/url" in o["Names"]]
+
+
+# ---------------------------------------------------------------- nombre sin barra final
+
+def test_nuevo_con_barra_final_se_quita(cliente, ssm):
+    nuevo = {"name": " /dev/app/n// ", "accion": "nuevo", "value": "v", "type": "String", "tags": TAGS}
+    plan = cliente.post("/api/plan", json={"items": [dict(nuevo)]}).get_json()["plan"]
+    assert plan[0]["name"] == "/dev/app/n" and not plan[0]["errores"]
+    r = cliente.post("/api/aplicar", json={"items": [nuevo], "confirmacion": CONFIRMA}).get_json()
+    assert r["resultados"][0]["ok"] and r["resultados"][0]["name"] == "/dev/app/n"
+    assert ssm.ops("PutParameter")[0]["Name"] == "/dev/app/n" and "/dev/app/n" in ssm.params
+    # Solo barras: no queda nombre, así que se deja y la revisión lo rechaza
+    solo = cliente.post("/api/plan", json={"items": [{**nuevo, "name": "//"}]}).get_json()["plan"][0]
+    assert solo["name"] == "//" and solo["errores"]
+
+
+def test_editar_con_barra_final_no_se_toca(cliente, ssm):
+    # Solo los nuevos: un existente se manda por su nombre tal cual
+    plan = cliente.post("/api/plan", json={"items": [
+        {"name": "/dev/app/x/", "accion": "editar", "value": "v", "type": "String", "tags": TAGS}]}).get_json()["plan"]
+    assert plan[0]["name"] == "/dev/app/x/" and plan[0]["errores"]
+
+
+# ---------------------------------------------------------------- JS: lo que no se aplicó no se pierde
+
+def _funcion_js(fuente, nombre):
+    """El código de `function nombre(...) {...}` de paramsx.js (va sangrado dos espacios dentro del IIFE)."""
+    ini = fuente.index(f"  function {nombre}(")
+    return fuente[ini:fuente.index("\n  }\n", ini) + 4]
+
+
+def test_js_reponer_lo_no_aplicado(tmp_path):
+    import json
+    import shutil
+    import subprocess
+    from pathlib import Path
+
+    node = shutil.which("node")
+    if not node:
+        pytest.skip("Sin node no se puede probar el JS")
+    fuente = (Path(__file__).parent.parent / "paramsx/web/static/paramsx.js").read_text(encoding="utf-8")
+    script = _funcion_js(fuente, "reponer") + r"""
+    // Lo recién cargado de AWS: a se aplicó (v2), b no (falló), c era conflicto (en AWS ya va por v5)
+    const de = (name, value, version) => ({ name, value, type: 'String', description: '', tags: { A: '1' }, borrar: false, nuevo: false,
+      orig: { name, value, type: 'String', description: '', tags: { A: '1' }, version } });
+    const items = [de('/r/a', 'a-nuevo', 2), de('/r/b', 'b', 1), de('/r/c', 'c-de-otro', 5), de('/r/d', 'd', 1)];
+    const sinHacer = [
+      { name: '/r/n1', value: 'v1', type: 'SecureString', description: 'uno', tags: { ManagedBy: 'paramsx' }, nuevo: true, borrar: false, orig: null },
+      { name: '/r/n2', value: 'v2', type: 'String', description: '', tags: {}, nuevo: true, borrar: false, orig: null },
+      { ...de('/r/b', 'b-editado', 1), description: 'desc', type: 'SecureString', tags: { A: '2' } },
+      { ...de('/r/c', 'c-mio', 3) },
+      { ...de('/r/d', 'd', 1), borrar: true },
+      { ...de('/r/ya-no-esta', 'x', 1) },
+    ];
+    const r = reponer(items, sinHacer, new Set(['/r/c']));
+    console.log(JSON.stringify(r));
+    """
+    ruta = tmp_path / "prueba.js"
+    ruta.write_text(script, encoding="utf-8")
+    out = json.loads(subprocess.run([node, str(ruta)], capture_output=True, text=True, check=True).stdout)
+    por = {p["name"]: p for p in out}
+    # Los nuevos, arriba y en su orden, con todo lo que llevaban
+    assert [p["name"] for p in out[:2]] == ["/r/n1", "/r/n2"]
+    assert por["/r/n1"]["value"] == "v1" and por["/r/n1"]["description"] == "uno" and por["/r/n1"]["type"] == "SecureString"
+    assert por["/r/n1"]["tags"] == {"ManagedBy": "paramsx"}
+    # Lo aplicado, como viene de AWS
+    assert por["/r/a"]["value"] == "a-nuevo" and por["/r/a"]["orig"]["version"] == 2
+    # Lo que falló, con lo editado otra vez encima de lo leído
+    b = por["/r/b"]
+    assert (b["value"], b["description"], b["type"], b["tags"]) == ("b-editado", "desc", "SecureString", {"A": "2"})
+    assert b["orig"]["value"] == "b"
+    # El conflicto conserva la versión que se cargó, para que la revisión lo siga marcando
+    assert por["/r/c"]["value"] == "c-mio" and por["/r/c"]["orig"]["version"] == 3
+    assert por["/r/d"]["borrar"] is True
+    # Lo que ya no está en AWS no se inventa
+    assert "/r/ya-no-esta" not in por and len(out) == 6

paramsx-2.4.0/paramsx/__init__.py

@@ -1 +0,0 @@
-__version__ = "2.4.0"

{paramsx-2.4.0 → paramsx-2.5.0}/paramsx.egg-info/requires.txt

@@ -1,7 +1,7 @@
 boto3
+flask>=2.2
 
 [:platform_system == "Windows"]
 windows-curses
 
 [web]
-flask>=2.2