paramsx 2.0.0__tar.gz → 2.1.0__tar.gz

{paramsx-2.0.0 → paramsx-2.1.0}/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 2.1.0
+
+### Añadido
+
+- **Flag `obligatorias_vacias`** en `~/.xsoft/paramsx_config.py`. Solo tiene efecto con `abac = True`:
+  - `False` (valor por defecto, comportamiento de la 2.0.0): validación bloqueante. Si a un parámetro le falta cualquiera de las tags obligatorias no se sube ni su valor ni sus tags, y al crear un parámetro no se puede dejar una tag en blanco.
+  - `True`: se permite dejar vacías las tags obligatorias. El parámetro se sube igualmente y **las tags sin valor no se crean en AWS**: nunca se suben etiquetas vacías. En la creación puedes saltar una tag pulsando Enter y el resumen previo lista cuáles quedan vacías.
+- El informe de carga incluye un bloque `Tags obligatorias vacías` con el parámetro y las tags afectadas, para dejar constancia sin bloquear.
+
+No hay que tocar nada en la configuración para actualizar desde la 2.0.0: si no defines `obligatorias_vacias`, se asume `False` y todo sigue igual.
+
+### Nota
+
+Vaciar una tag **que ya tenía valor en AWS** sigue significando borrarla del parámetro, en los dos modos. Es la forma de eliminar una tag. Lo que cambia con `obligatorias_vacias = True` es que una tag en blanco que nunca existió simplemente no se crea, en vez de bloquear la subida.
+
 ## 2.0.0
 
 ### ⚠ Breaking change: hay que actualizar `~/.xsoft/paramsx_config.py` a mano

{paramsx-2.0.0/paramsx.egg-info → paramsx-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.0.0
+Version: 2.1.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
@@ -147,6 +147,8 @@ configuraciones = {
 
 abac = True
 
+obligatorias_vacias = False
+
 tags_obligatorias = [
     "Application", "Environment", "Owner", "Project",
     "Product", "Service", "Component", "ManagedBy",
@@ -237,14 +239,25 @@ parametros = [
 
 Este formato con tags **solo existe en el fichero temporal que genera ParamsX**: no se ve en la consola de AWS ni se persiste en ningún otro sitio. Tiene el mismo ciclo de vida que el resto del fichero (se genera, se edita, se compara, se aplica y se borra al confirmar).
 
+#### `obligatorias_vacias`: cuando alguna tag tiene que ir vacía
+
+En la práctica hay parámetros a los que no les aplica alguna de las 8 tags. Ese caso se controla con `obligatorias_vacias`, y solo tiene efecto si `abac = True`:
+
+| `obligatorias_vacias` | Comportamiento |
+|---|---|
+| `False` (por defecto) | Validación bloqueante: si a un parámetro le falta cualquiera de las tags obligatorias no se sube **ni su valor ni sus tags**. Al crear un parámetro tampoco te deja continuar dejando una tag en blanco. |
+| `True` | Se permiten vacías: el parámetro se sube igualmente y **las tags sin valor no se crean en AWS** (no se suben como etiquetas vacías). En el informe de carga verás qué parámetros han quedado con tags vacías y cuáles son. |
+
+Ojo con la diferencia entre "vacía" y "borrada": con `obligatorias_vacias = True`, una tag que se deja en blanco y **nunca existió** simplemente no se crea; pero si esa tag **ya tenía valor en AWS** y la vacías en el fichero, se interpreta como que quieres borrarla y se elimina del parámetro. Es la forma de quitar una tag.
+
 Detalles del comportamiento con `abac = True`:
 
-- La validación es **bloqueante y por parámetro**: si a uno le falta cualquiera de las 8 tags no se sube **ni su valor ni sus tags**, y verás un error indicando qué tags faltan y a qué `parameter_name`. El resto de parámetros del fichero que estén completos se suben con normalidad.
+- La validación es **por parámetro**, no global: con `obligatorias_vacias = False`, si a uno le falta cualquiera de las 8 tags no se sube ni su valor ni sus tags, y verás un error indicando qué tags faltan y a qué `parameter_name`. El resto de parámetros del fichero que estén completos se suben con normalidad.
 - Cuando una carga queda a medias, los ficheros `parameters_{entorno}.py` y su backup **no se borran**, para que corrijas lo que falta y vuelvas a cargar. El backup se resincroniza con lo ya aplicado, así que la segunda pasada solo sube lo que quedó pendiente.
 - Si el parámetro ya existe y le faltan tags (creado antes de esta versión), se rellenan en este mismo flujo de edición, sin borrar ni recrear el parámetro.
 - Los cambios de tags se aplican con `add_tags_to_resource` / `remove_tags_from_resource` en la misma pasada que el valor. Vaciar el campo de una tag en el fichero equivale a borrarla en AWS.
 - Las tags de sistema (`aws:*`) no se exportan ni se tocan. Las tags que ya existan en AWS y no estén en la lista obligatoria se conservan y se pueden editar.
-- No hay forma de saltarse la validación salvo poner `abac = False` explícitamente en tu configuración.
+- No hay forma de saltarse la validación por parámetro salvo relajarla explícitamente en tu configuración con `obligatorias_vacias = True`, o desactivar las tags por completo con `abac = False`.
 
 #### Configuración manual del PATH
 En algunos sistemas (especialmente en entornos corporativos como Windows), el PATH puede no configurarse automáticamente durante la instalación. Si ocurre esto, sigue los pasos según tu sistema operativo:
@@ -307,7 +320,7 @@ El programa mostrará un menú donde Podrás:
 1. Selecciona la opción "Crear nuevo parámetro" y elige el entorno.
 2. Escribe la ruta completa en convención `min` (`/dev/...`): se fuerza a minúscula y se valida que el primer segmento sea el entorno.
 3. Escribe el valor: texto plano o JSON en una línea.
-4. Rellena las tags obligatorias (si `abac = True`). `Environment` viene precargada con el entorno elegido.
+4. Rellena las tags obligatorias (si `abac = True`). `Environment` viene precargada con el entorno elegido. Con `obligatorias_vacias = True` puedes dejar alguna en blanco pulsando Enter: esas no se crearán en AWS.
 5. Confirma en la pantalla de resumen. Si es un parámetro de RDS y falta su contraparte (común o privado), verás el aviso de correlación de naming ahí mismo.
 
 ### Backup Parámetros:

{paramsx-2.0.0 → paramsx-2.1.0}/README.md

@@ -127,6 +127,8 @@ configuraciones = {
 
 abac = True
 
+obligatorias_vacias = False
+
 tags_obligatorias = [
     "Application", "Environment", "Owner", "Project",
     "Product", "Service", "Component", "ManagedBy",
@@ -217,14 +219,25 @@ parametros = [
 
 Este formato con tags **solo existe en el fichero temporal que genera ParamsX**: no se ve en la consola de AWS ni se persiste en ningún otro sitio. Tiene el mismo ciclo de vida que el resto del fichero (se genera, se edita, se compara, se aplica y se borra al confirmar).
 
+#### `obligatorias_vacias`: cuando alguna tag tiene que ir vacía
+
+En la práctica hay parámetros a los que no les aplica alguna de las 8 tags. Ese caso se controla con `obligatorias_vacias`, y solo tiene efecto si `abac = True`:
+
+| `obligatorias_vacias` | Comportamiento |
+|---|---|
+| `False` (por defecto) | Validación bloqueante: si a un parámetro le falta cualquiera de las tags obligatorias no se sube **ni su valor ni sus tags**. Al crear un parámetro tampoco te deja continuar dejando una tag en blanco. |
+| `True` | Se permiten vacías: el parámetro se sube igualmente y **las tags sin valor no se crean en AWS** (no se suben como etiquetas vacías). En el informe de carga verás qué parámetros han quedado con tags vacías y cuáles son. |
+
+Ojo con la diferencia entre "vacía" y "borrada": con `obligatorias_vacias = True`, una tag que se deja en blanco y **nunca existió** simplemente no se crea; pero si esa tag **ya tenía valor en AWS** y la vacías en el fichero, se interpreta como que quieres borrarla y se elimina del parámetro. Es la forma de quitar una tag.
+
 Detalles del comportamiento con `abac = True`:
 
-- La validación es **bloqueante y por parámetro**: si a uno le falta cualquiera de las 8 tags no se sube **ni su valor ni sus tags**, y verás un error indicando qué tags faltan y a qué `parameter_name`. El resto de parámetros del fichero que estén completos se suben con normalidad.
+- La validación es **por parámetro**, no global: con `obligatorias_vacias = False`, si a uno le falta cualquiera de las 8 tags no se sube ni su valor ni sus tags, y verás un error indicando qué tags faltan y a qué `parameter_name`. El resto de parámetros del fichero que estén completos se suben con normalidad.
 - Cuando una carga queda a medias, los ficheros `parameters_{entorno}.py` y su backup **no se borran**, para que corrijas lo que falta y vuelvas a cargar. El backup se resincroniza con lo ya aplicado, así que la segunda pasada solo sube lo que quedó pendiente.
 - Si el parámetro ya existe y le faltan tags (creado antes de esta versión), se rellenan en este mismo flujo de edición, sin borrar ni recrear el parámetro.
 - Los cambios de tags se aplican con `add_tags_to_resource` / `remove_tags_from_resource` en la misma pasada que el valor. Vaciar el campo de una tag en el fichero equivale a borrarla en AWS.
 - Las tags de sistema (`aws:*`) no se exportan ni se tocan. Las tags que ya existan en AWS y no estén en la lista obligatoria se conservan y se pueden editar.
-- No hay forma de saltarse la validación salvo poner `abac = False` explícitamente en tu configuración.
+- No hay forma de saltarse la validación por parámetro salvo relajarla explícitamente en tu configuración con `obligatorias_vacias = True`, o desactivar las tags por completo con `abac = False`.
 
 #### Configuración manual del PATH
 En algunos sistemas (especialmente en entornos corporativos como Windows), el PATH puede no configurarse automáticamente durante la instalación. Si ocurre esto, sigue los pasos según tu sistema operativo:
@@ -287,7 +300,7 @@ El programa mostrará un menú donde Podrás:
 1. Selecciona la opción "Crear nuevo parámetro" y elige el entorno.
 2. Escribe la ruta completa en convención `min` (`/dev/...`): se fuerza a minúscula y se valida que el primer segmento sea el entorno.
 3. Escribe el valor: texto plano o JSON en una línea.
-4. Rellena las tags obligatorias (si `abac = True`). `Environment` viene precargada con el entorno elegido.
+4. Rellena las tags obligatorias (si `abac = True`). `Environment` viene precargada con el entorno elegido. Con `obligatorias_vacias = True` puedes dejar alguna en blanco pulsando Enter: esas no se crearán en AWS.
 5. Confirma en la pantalla de resumen. Si es un parámetro de RDS y falta su contraparte (común o privado), verás el aviso de correlación de naming ahí mismo.
 
 ### Backup Parámetros:

{paramsx-2.0.0 → paramsx-2.1.0}/paramsx/main.py

@@ -56,9 +56,12 @@ def load_config():
     spec.loader.exec_module(modulo)
 
     config = dict(modulo.configuraciones)
-    # 'abac' y 'tags_obligatorias' son opcionales en el fichero del usuario:
-    # si no están, se usan los valores de la plantilla que trae el paquete.
+    # 'abac', 'obligatorias_vacias' y 'tags_obligatorias' son opcionales en el fichero del
+    # usuario: si no están, se usan los valores de la plantilla que trae el paquete.
     config["abac"] = bool(getattr(modulo, "abac", plantilla_config.abac))
+    config["obligatorias_vacias"] = bool(
+        getattr(modulo, "obligatorias_vacias", plantilla_config.obligatorias_vacias)
+    )
     config["tags_obligatorias"] = list(
         getattr(modulo, "tags_obligatorias", plantilla_config.tags_obligatorias)
     )
@@ -142,7 +145,7 @@ def leer_ruta(stdscr, ssm, full_path, abac, tags_obligatorias):
 
 
 # Feature 2: crear un parámetro nuevo, siempre en convención "min"
-def crear_parametro(stdscr, ssm, entornos, abac, tags_obligatorias):
+def crear_parametro(stdscr, ssm, entornos, abac, tags_obligatorias, obligatorias_vacias=False):
     env_choice = show_environment_selection(stdscr, entornos)
     if env_choice is None:
         return
@@ -197,7 +200,14 @@ def crear_parametro(stdscr, ssm, entornos, abac, tags_obligatorias):
 
     # 3. Tags obligatorias
     tags = {}
+    faltantes = []
     if abac:
+        if obligatorias_vacias:
+            ayuda_tags = ("Las tags sostienen el control de acceso ABAC vía IAM. "
+                          "Puedes dejarla vacía: si no tiene valor no se creará en AWS.")
+        else:
+            ayuda_tags = "Las tags sostienen el control de acceso ABAC vía IAM: son obligatorias."
+
         for indice, clave in enumerate(tags_obligatorias, start=1):
             predeterminado = entorno if clave == "Environment" else ""
             respuesta = prompt_input(
@@ -205,14 +215,15 @@ def crear_parametro(stdscr, ssm, entornos, abac, tags_obligatorias):
                 f"Crear nuevo parámetro (3/3): tags [{indice}/{len(tags_obligatorias)}]",
                 f"Valor de la tag obligatoria '{clave}':",
                 valor=predeterminado,
-                ayuda="Las tags sostienen el control de acceso ABAC vía IAM: son obligatorias.",
+                permitir_vacio=obligatorias_vacias,
+                ayuda=ayuda_tags,
             )
             if respuesta is None:
                 return
             tags[clave] = respuesta.strip()
 
         faltantes = validar_tags_obligatorias(tags, tags_obligatorias)
-        if faltantes:
+        if faltantes and not obligatorias_vacias:
             show_report(
                 stdscr,
                 "Tags obligatorias incompletas",
@@ -221,6 +232,9 @@ def crear_parametro(stdscr, ssm, entornos, abac, tags_obligatorias):
             )
             return
 
+        # Las tags sin valor no se suben a AWS
+        tags = {clave: valor for clave, valor in tags.items() if valor}
+
     # Aviso de correlación de naming en RDS (no bloquea)
     aviso_rds = check_rds_correlacion(ssm, path)
 
@@ -229,6 +243,10 @@ def crear_parametro(stdscr, ssm, entornos, abac, tags_obligatorias):
     if abac:
         lineas.append("Tags:")
         lineas.extend([f"  {clave} = {valor_tag}" for clave, valor_tag in tags.items()])
+        if faltantes:
+            lineas.append(
+                f"  Se quedan vacías (no se crearán en AWS): {', '.join(faltantes)}"
+            )
         lineas.append("")
     if aviso_rds:
         lineas.extend([aviso_rds, ""])
@@ -297,6 +315,7 @@ def main(stdscr, config=None):
     PARAMETER_LIST = config['parameter_list']
     ABAC = config['abac']
     TAGS_OBLIGATORIAS = config['tags_obligatorias']
+    OBLIGATORIAS_VACIAS = config.get('obligatorias_vacias', False)
 
     while True:
         # Usar el menú con navegación por flechas
@@ -395,21 +414,28 @@ def main(stdscr, config=None):
 
             aplicados = []
             errores = []
+            vacias = []
 
             for change in changes:
                 param_name = change["name"]
                 tipo = change["tipo"]
 
                 if tipo in ("Nuevo", "Modificado"):
-                    # Validación bloqueante por parámetro: sin las tags obligatorias no se sube nada
                     if ABAC:
                         faltantes = validar_tags_obligatorias(change["tags"], TAGS_OBLIGATORIAS)
-                        if faltantes:
+                        if faltantes and not OBLIGATORIAS_VACIAS:
+                            # Validación bloqueante por parámetro: sin las tags no se sube nada
                             errores.append(
                                 f"✗ {param_name}: no se ha subido (ni valor ni tags). "
                                 f"Faltan las tags obligatorias: {', '.join(faltantes)}."
                             )
                             continue
+                        if faltantes:
+                            # Permitidas vacías: se sube igual y esas tags no se crean en AWS
+                            vacias.append(
+                                f"· {param_name}: sin valor en {', '.join(faltantes)} "
+                                "(no se crean en AWS)."
+                            )
 
                     try:
                         if change["value_changed"]:
@@ -449,6 +475,10 @@ def main(stdscr, config=None):
 
             lineas = [f"Cambios aplicados: {len(aplicados)} de {len(changes)}"]
 
+            if vacias:
+                lineas.extend(["", f"Tags obligatorias vacías ({len(vacias)}):"])
+                lineas.extend(vacias)
+
             if errores:
                 # Se conservan los ficheros para que el usuario corrija y vuelva a cargar.
                 # El backup se resincroniza con lo ya aplicado para no repetir esos cambios.
@@ -589,7 +619,9 @@ def main(stdscr, config=None):
 
         elif choice == 4:
             # Crear nuevo parámetro (siempre en convención "min")
-            crear_parametro(stdscr, ssm, environments, ABAC, TAGS_OBLIGATORIAS)
+            crear_parametro(
+                stdscr, ssm, environments, ABAC, TAGS_OBLIGATORIAS, OBLIGATORIAS_VACIAS
+            )
 
         else:
             show_message(stdscr, "Opción inválida. Inténtalo de nuevo.", 2)
@@ -630,6 +662,9 @@ Configuración (~/.xsoft/paramsx_config.py):
                     'max' -> /API/DEV/STA    (entorno en mayúscula, tras el 1er segmento)
   abac              True para gestionar las tags obligatorias en el fichero exportado.
   tags_obligatorias Tags que sostienen el control de acceso ABAC vía IAM.
+  obligatorias_vacias  False -> no se sube un parámetro al que le falte alguna tag.
+                       True  -> se permite dejarlas vacías; las tags sin valor
+                                no se crean en AWS.
 
 Si necesitas más ayuda puedes leer el readme en GitHub o en Pypi:
 - https://github.com/Pistatxos/paramsx

{paramsx-2.0.0 → paramsx-2.1.0}/paramsx/paramsx_config.py

@@ -24,6 +24,13 @@ configuraciones = {
 #   False -> las tags no aparecen en el fichero exportado (comportamiento legacy, sin tags).
 abac = True
 
+# ¿Se pueden dejar vacías las tags obligatorias?
+#   False -> validación bloqueante: si a un parámetro le falta alguna de 'tags_obligatorias'
+#            no se sube (ni su valor ni sus tags).
+#   True  -> se permiten vacías: el parámetro se sube igualmente y las tags sin valor
+#            simplemente NO se crean en AWS (no se suben como etiquetas vacías).
+obligatorias_vacias = False
+
 # Estas tags sostienen el control de acceso ABAC vía IAM en toda la cuenta AWS.
 # La lista es ampliable, pero estas 8 son el mínimo por defecto.
 tags_obligatorias = [

{paramsx-2.0.0 → paramsx-2.1.0/paramsx.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.0.0
+Version: 2.1.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
@@ -147,6 +147,8 @@ configuraciones = {
 
 abac = True
 
+obligatorias_vacias = False
+
 tags_obligatorias = [
     "Application", "Environment", "Owner", "Project",
     "Product", "Service", "Component", "ManagedBy",
@@ -237,14 +239,25 @@ parametros = [
 
 Este formato con tags **solo existe en el fichero temporal que genera ParamsX**: no se ve en la consola de AWS ni se persiste en ningún otro sitio. Tiene el mismo ciclo de vida que el resto del fichero (se genera, se edita, se compara, se aplica y se borra al confirmar).
 
+#### `obligatorias_vacias`: cuando alguna tag tiene que ir vacía
+
+En la práctica hay parámetros a los que no les aplica alguna de las 8 tags. Ese caso se controla con `obligatorias_vacias`, y solo tiene efecto si `abac = True`:
+
+| `obligatorias_vacias` | Comportamiento |
+|---|---|
+| `False` (por defecto) | Validación bloqueante: si a un parámetro le falta cualquiera de las tags obligatorias no se sube **ni su valor ni sus tags**. Al crear un parámetro tampoco te deja continuar dejando una tag en blanco. |
+| `True` | Se permiten vacías: el parámetro se sube igualmente y **las tags sin valor no se crean en AWS** (no se suben como etiquetas vacías). En el informe de carga verás qué parámetros han quedado con tags vacías y cuáles son. |
+
+Ojo con la diferencia entre "vacía" y "borrada": con `obligatorias_vacias = True`, una tag que se deja en blanco y **nunca existió** simplemente no se crea; pero si esa tag **ya tenía valor en AWS** y la vacías en el fichero, se interpreta como que quieres borrarla y se elimina del parámetro. Es la forma de quitar una tag.
+
 Detalles del comportamiento con `abac = True`:
 
-- La validación es **bloqueante y por parámetro**: si a uno le falta cualquiera de las 8 tags no se sube **ni su valor ni sus tags**, y verás un error indicando qué tags faltan y a qué `parameter_name`. El resto de parámetros del fichero que estén completos se suben con normalidad.
+- La validación es **por parámetro**, no global: con `obligatorias_vacias = False`, si a uno le falta cualquiera de las 8 tags no se sube ni su valor ni sus tags, y verás un error indicando qué tags faltan y a qué `parameter_name`. El resto de parámetros del fichero que estén completos se suben con normalidad.
 - Cuando una carga queda a medias, los ficheros `parameters_{entorno}.py` y su backup **no se borran**, para que corrijas lo que falta y vuelvas a cargar. El backup se resincroniza con lo ya aplicado, así que la segunda pasada solo sube lo que quedó pendiente.
 - Si el parámetro ya existe y le faltan tags (creado antes de esta versión), se rellenan en este mismo flujo de edición, sin borrar ni recrear el parámetro.
 - Los cambios de tags se aplican con `add_tags_to_resource` / `remove_tags_from_resource` en la misma pasada que el valor. Vaciar el campo de una tag en el fichero equivale a borrarla en AWS.
 - Las tags de sistema (`aws:*`) no se exportan ni se tocan. Las tags que ya existan en AWS y no estén en la lista obligatoria se conservan y se pueden editar.
-- No hay forma de saltarse la validación salvo poner `abac = False` explícitamente en tu configuración.
+- No hay forma de saltarse la validación por parámetro salvo relajarla explícitamente en tu configuración con `obligatorias_vacias = True`, o desactivar las tags por completo con `abac = False`.
 
 #### Configuración manual del PATH
 En algunos sistemas (especialmente en entornos corporativos como Windows), el PATH puede no configurarse automáticamente durante la instalación. Si ocurre esto, sigue los pasos según tu sistema operativo:
@@ -307,7 +320,7 @@ El programa mostrará un menú donde Podrás:
 1. Selecciona la opción "Crear nuevo parámetro" y elige el entorno.
 2. Escribe la ruta completa en convención `min` (`/dev/...`): se fuerza a minúscula y se valida que el primer segmento sea el entorno.
 3. Escribe el valor: texto plano o JSON en una línea.
-4. Rellena las tags obligatorias (si `abac = True`). `Environment` viene precargada con el entorno elegido.
+4. Rellena las tags obligatorias (si `abac = True`). `Environment` viene precargada con el entorno elegido. Con `obligatorias_vacias = True` puedes dejar alguna en blanco pulsando Enter: esas no se crearán en AWS.
 5. Confirma en la pantalla de resumen. Si es un parámetro de RDS y falta su contraparte (común o privado), verás el aviso de correlación de naming ahí mismo.
 
 ### Backup Parámetros:

{paramsx-2.0.0 → paramsx-2.1.0}/setup.py

@@ -76,7 +76,7 @@ with open("README.md", "r", encoding="utf-8") as fh:
 # Configuración del paquete
 setup(
     name="paramsx",
-    version="2.0.0",
+    version="2.1.0",
     packages=find_packages(),
     include_package_data=True,
     package_data={