PyPI - paramsx - Versions diffs - 2.2.1__tar.gz → 2.2.2__tar.gz - Mend

paramsx 2.2.1tar.gz → 2.2.2tar.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 (19) hide show

{paramsx-2.2.1 → paramsx-2.2.2}/CHANGELOG.md RENAMED Viewed

@@ -1,5 +1,22 @@
 # Changelog
+## 2.2.2
+Un renombrado de la configuración, sin cambios de comportamiento. **Los nombres antiguos
+se siguen aceptando**, así que no tienes que tocar tu fichero para actualizar.
+### Cambiado
+- **Un solo nombre para el concepto: `perfiles` / `perfil`.** El mismo concepto se llamaba de tres formas distintas: el diccionario era `naming`, la clave de cada entrada de `parameter_list` era `convencion` y la documentación decía "perfil". Explicárselo a alguien obligaba a traducir dos veces. Ahora:
+  | Antes | Ahora |
+  |---|---|
+  | `naming = {...}` | `perfiles = {...}` |
+  | `{"path": "/rds", "convencion": "min"}` | `{"path": "/rds", "perfil": "min"}` |
+  | `convencion_nuevos = "min"` | `perfil_nuevos = "min"` |
+- `paramsx configure` te dice qué nombres antiguos usas y cómo se llaman ahora, incluidas las entradas de `parameter_list`. Los viejos (`naming`, `convencion`, `convencion_nuevos` y el `abac` de la 2.0) se traducen al cargar, así que dentro del programa solo existe el nombre nuevo.
 ## 2.2.1
 Solo comandos de terminal y documentación: no cambia nada de la lectura, la carga ni la

{paramsx-2.2.1/paramsx.egg-info → paramsx-2.2.2}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.2.1
+Version: 2.2.2
 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
@@ -24,7 +24,7 @@ ParamsX es una herramienta diseñada para gestionar y organizar parámetros de A
 ## ⚠ Breaking change en la versión 2.0.0
-Si vienes de la 1.x tienes que **actualizar a mano tu `~/.xsoft/paramsx_config.py`**: `parameter_list` ya no es una lista de strings, ahora cada entrada es un diccionario con su convención de naming. La versión antigua **no es compatible** y ParamsX se niega a arrancar mostrando cómo migrarla. Detalle completo en el [CHANGELOG](CHANGELOG.md).
+Si vienes de la 1.x tienes que **actualizar a mano tu `~/.xsoft/paramsx_config.py`**: `parameter_list` ya no es una lista de strings, ahora cada entrada es un diccionario que declara su perfil. La versión antigua **no es compatible** y ParamsX se niega a arrancar mostrando cómo migrarla. Detalle completo en el [CHANGELOG](CHANGELOG.md).
 ### Estructura Recomendada
 La convención de naming es de 5 niveles, donde los últimos segmentos son opcionales según el caso:
@@ -97,10 +97,10 @@ Esto te permitirá mantener respaldos seguros o realizar migraciones/reorganizac
 4. Crear nuevo parámetro
 - Crea un parámetro desde cero sin salir de la herramienta. Te pedirá, en este orden:
-    - La ruta **sin el entorno**, igual que la declaras en `parameter_list`: el perfil de naming se encarga de colocarlo. Verás en pantalla la ruta resultante en AWS antes de seguir.
+    - La ruta **sin el entorno**, igual que la declaras en `parameter_list`: el perfil se encarga de colocarlo. Verás en pantalla la ruta resultante en AWS antes de seguir.
     - El valor: texto plano o JSON en una línea (por ejemplo `{"host": "x", "user": "y", "pass": "z"}`), que se valida antes de continuar.
     - Las tags obligatorias, si tienes `tags_activas = True`.
-- El perfil que se usa es el que declares en `convencion_nuevos`. Si tu perfil es de tipo `mixto`, escribe el `*` en la ruta para indicar dónde va el entorno.
+- El perfil que se usa es el que declares en `perfil_nuevos`. Si tu perfil es de tipo `mixto`, escribe el `*` en la ruta para indicar dónde va el entorno.
 - Antes de subirlo verás una pantalla de confirmación con la ruta, el valor y las tags. El parámetro se crea con `Overwrite=False`, así que nunca machaca uno existente.
 - Tras crearlo aparecerá la próxima vez que leas la ruta correspondiente de tu `parameter_list`.
@@ -135,7 +135,7 @@ Ejemplo del contenido de paramsx_config.py:
 ```python
 ## Configuraciones ParamsX
-# --- Perfiles de naming -------------------------------------------------------------
+# --- Perfiles -------------------------------------------------------------
 # Un perfil dice CÓMO se construye la ruta real en AWS a partir de la ruta que declaras
 # en 'parameter_list' y del entorno que eliges en el menú. Los nombres son tuyos: define
 # solo los que uses y llámalos como quieras. Un perfil tiene tres campos:
@@ -177,7 +177,7 @@ Ejemplo del contenido de paramsx_config.py:
 # Combina los tres campos como necesites: no hay una lista cerrada de perfiles. En el
 # README tienes más ejemplos.
-naming = {
+perfiles = {
     "min": {"posicion_entorno": "inicio", "case_entorno": "lower", "case_ruta": "lower"},
     "max": {"posicion_entorno": "final", "case_entorno": "upper", "case_ruta": "ninguno"},
     "mixto_max": {"posicion_entorno": "mixto", "case_entorno": "upper", "case_ruta": "ninguno"},
@@ -190,19 +190,19 @@ configuraciones = {
     "region_name": "eu-south-2",         # Cambiar por tu región de AWS
     "entornos": ['dev', 'pre', 'prod'],  # SIEMPRE en minúscula, es la lista canónica única
     "parameter_list": [
-        {"path": "/common", "convencion": "min"},      # -> /dev/common
-        {"path": "/rds", "convencion": "min"},         # -> /dev/rds
-        {"path": "/EMAIL", "convencion": "max"},       # -> /EMAIL/DEV
-        {"path": "/API/STA", "convencion": "max"},     # -> /API/STA/DEV
+        {"path": "/common", "perfil": "min"},      # -> /dev/common
+        {"path": "/rds", "perfil": "min"},         # -> /dev/rds
+        {"path": "/EMAIL", "perfil": "max"},       # -> /EMAIL/DEV
+        {"path": "/API/STA", "perfil": "max"},     # -> /API/STA/DEV
         # Con 'mixto' acotas por debajo del entorno: esto lee solo stan_ai, en vez de
         # todo lo que cuelga de /API/MULTIAPI/DEV
-        {"path": "/API/MULTIAPI/*/stan_ai", "convencion": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
+        {"path": "/API/MULTIAPI/*/stan_ai", "perfil": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
     ]
 }
-# Perfil de naming que se usa al crear un parámetro nuevo (opción 4 del menú).
-# Si no lo defines, se usa el primer perfil de 'naming'.
-convencion_nuevos = "min"
+# Perfil que se usa al crear un parámetro nuevo (opción 4 del menú).
+# Si no lo defines, se usa el primero de 'perfiles'.
+perfil_nuevos = "min"
 # ¿El nombre del fichero exportado incluye la ruta leída?
 #   False -> parameters_dev.py            (comportamiento de siempre)
@@ -244,9 +244,9 @@ tags_obligatorias = [
 ```
 Nota: Si el archivo paramsx_config.py ya existe, no será sobrescrito durante la instalación para proteger las configuraciones personalizadas.
-### Los perfiles de naming
+### Los perfiles
-Cada organización nombra sus parámetros a su manera, así que ParamsX no impone ninguna convención: **tú defines los perfiles que uses en el diccionario `naming` y les pones el nombre que quieras**. Cada entrada de `parameter_list` declara con qué perfil se construye su ruta completa. Los tres campos de un perfil y sus valores están explicados en el propio fichero de configuración, ahí arriba.
+Cada organización nombra sus parámetros a su manera, así que ParamsX no impone ninguna convención: **tú defines los perfiles que uses en el diccionario `perfiles` y les pones el nombre que quieras**. Cada entrada de `parameter_list` declara con qué perfil se construye su ruta completa, con la clave `perfil`. Los tres campos de un perfil y sus valores están explicados en el propio fichero de configuración, ahí arriba.
 **No hay una lista cerrada de perfiles.** Los tres campos se combinan libremente, así que la plantilla no intenta traértelos todos: define los dos o tres que use tu organización y olvídate del resto. `min` y `max` vienen predefinidos porque son los que ParamsX traía antes de que los perfiles fueran configurables.
@@ -266,15 +266,15 @@ En el nombre van el entorno, la ruta y el perfil, porque dos entradas pueden com
 | Entrada | Fichero |
 |---|---|
-| `{"path": "/API/STA", "convencion": "max"}` | `parameters_dev__API_STA__max.py` |
-| `{"path": "/API/*/STA", "convencion": "mixto_max"}` | `parameters_dev__API_env_STA__mixto_max.py` |
+| `{"path": "/API/STA", "perfil": "max"}` | `parameters_dev__API_STA__max.py` |
+| `{"path": "/API/*/STA", "perfil": "mixto_max"}` | `parameters_dev__API_env_STA__mixto_max.py` |
 ### Cómo acotar tu parameter_list (recomendación)
 `parameter_list` es solo tu vista de trabajo: **la seguridad real la impone IAM, no este fichero**. La recomendación de uso es:
-- **Admins**: pueden configurar rutas raíz amplias, por ejemplo `{"path": "/rds", "convencion": "min"}` → `/dev/rds`.
-- **Usuarios normales**: conviene acotar la ruta a lo que su rol IAM tiene realmente autorizado, por ejemplo `{"path": "/rds/cee-dev/api", "convencion": "min"}` → `/dev/rds/cee-dev/api`.
+- **Admins**: pueden configurar rutas raíz amplias, por ejemplo `{"path": "/rds", "perfil": "min"}` → `/dev/rds`.
+- **Usuarios normales**: conviene acotar la ruta a lo que su rol IAM tiene realmente autorizado, por ejemplo `{"path": "/rds/cee-dev/api", "perfil": "min"}` → `/dev/rds/cee-dev/api`.
 Si configuras una ruta más amplia que tus permisos, no pasa nada grave: ParamsX te avisará con un mensaje claro de acceso denegado en vez de una traza de boto3. Pero afinar la ruta te ahorra el error.
@@ -383,7 +383,7 @@ El programa mostrará un menú donde Podrás:
 - Crear un parámetro nuevo.
 ### Leer Parámetros:
-1. Selecciona la opción "Leer parámetros" en el menú. La lista muestra cada ruta con su perfil de naming, por ejemplo `/rds  [min]` o `/API/STA  [max]`.
+1. Selecciona la opción "Leer parámetros" en el menú. La lista muestra cada ruta con su perfil, por ejemplo `/rds  [min]` o `/API/STA  [max]`.
 2. Elige el prefijo y el entorno que deseas consultar.
 3. Los parámetros serán descargados y guardados en archivos como:
     - parameters_dev.py
@@ -404,7 +404,7 @@ El programa mostrará un menú donde Podrás:
 ### Crear un parámetro nuevo:
 1. Selecciona la opción "Crear nuevo parámetro" y elige el entorno.
-2. Escribe la ruta **sin el entorno**, como en tu `parameter_list`: ParamsX le aplica el perfil de `convencion_nuevos` y te enseña la ruta resultante en AWS para que la confirmes.
+2. Escribe la ruta **sin el entorno**, como en tu `parameter_list`: ParamsX le aplica el perfil de `perfil_nuevos` y te enseña la ruta resultante en AWS para que la confirmes.
 3. Escribe el valor: texto plano o JSON en una línea.
 4. Rellena las tags obligatorias (si `tags_activas = 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.

{paramsx-2.2.1 → paramsx-2.2.2}/README.md RENAMED Viewed

@@ -4,7 +4,7 @@ ParamsX es una herramienta diseñada para gestionar y organizar parámetros de A
 ## ⚠ Breaking change en la versión 2.0.0
-Si vienes de la 1.x tienes que **actualizar a mano tu `~/.xsoft/paramsx_config.py`**: `parameter_list` ya no es una lista de strings, ahora cada entrada es un diccionario con su convención de naming. La versión antigua **no es compatible** y ParamsX se niega a arrancar mostrando cómo migrarla. Detalle completo en el [CHANGELOG](CHANGELOG.md).
+Si vienes de la 1.x tienes que **actualizar a mano tu `~/.xsoft/paramsx_config.py`**: `parameter_list` ya no es una lista de strings, ahora cada entrada es un diccionario que declara su perfil. La versión antigua **no es compatible** y ParamsX se niega a arrancar mostrando cómo migrarla. Detalle completo en el [CHANGELOG](CHANGELOG.md).
 ### Estructura Recomendada
 La convención de naming es de 5 niveles, donde los últimos segmentos son opcionales según el caso:
@@ -77,10 +77,10 @@ Esto te permitirá mantener respaldos seguros o realizar migraciones/reorganizac
 4. Crear nuevo parámetro
 - Crea un parámetro desde cero sin salir de la herramienta. Te pedirá, en este orden:
-    - La ruta **sin el entorno**, igual que la declaras en `parameter_list`: el perfil de naming se encarga de colocarlo. Verás en pantalla la ruta resultante en AWS antes de seguir.
+    - La ruta **sin el entorno**, igual que la declaras en `parameter_list`: el perfil se encarga de colocarlo. Verás en pantalla la ruta resultante en AWS antes de seguir.
     - El valor: texto plano o JSON en una línea (por ejemplo `{"host": "x", "user": "y", "pass": "z"}`), que se valida antes de continuar.
     - Las tags obligatorias, si tienes `tags_activas = True`.
-- El perfil que se usa es el que declares en `convencion_nuevos`. Si tu perfil es de tipo `mixto`, escribe el `*` en la ruta para indicar dónde va el entorno.
+- El perfil que se usa es el que declares en `perfil_nuevos`. Si tu perfil es de tipo `mixto`, escribe el `*` en la ruta para indicar dónde va el entorno.
 - Antes de subirlo verás una pantalla de confirmación con la ruta, el valor y las tags. El parámetro se crea con `Overwrite=False`, así que nunca machaca uno existente.
 - Tras crearlo aparecerá la próxima vez que leas la ruta correspondiente de tu `parameter_list`.
@@ -115,7 +115,7 @@ Ejemplo del contenido de paramsx_config.py:
 ```python
 ## Configuraciones ParamsX
-# --- Perfiles de naming -------------------------------------------------------------
+# --- Perfiles -------------------------------------------------------------
 # Un perfil dice CÓMO se construye la ruta real en AWS a partir de la ruta que declaras
 # en 'parameter_list' y del entorno que eliges en el menú. Los nombres son tuyos: define
 # solo los que uses y llámalos como quieras. Un perfil tiene tres campos:
@@ -157,7 +157,7 @@ Ejemplo del contenido de paramsx_config.py:
 # Combina los tres campos como necesites: no hay una lista cerrada de perfiles. En el
 # README tienes más ejemplos.
-naming = {
+perfiles = {
     "min": {"posicion_entorno": "inicio", "case_entorno": "lower", "case_ruta": "lower"},
     "max": {"posicion_entorno": "final", "case_entorno": "upper", "case_ruta": "ninguno"},
     "mixto_max": {"posicion_entorno": "mixto", "case_entorno": "upper", "case_ruta": "ninguno"},
@@ -170,19 +170,19 @@ configuraciones = {
     "region_name": "eu-south-2",         # Cambiar por tu región de AWS
     "entornos": ['dev', 'pre', 'prod'],  # SIEMPRE en minúscula, es la lista canónica única
     "parameter_list": [
-        {"path": "/common", "convencion": "min"},      # -> /dev/common
-        {"path": "/rds", "convencion": "min"},         # -> /dev/rds
-        {"path": "/EMAIL", "convencion": "max"},       # -> /EMAIL/DEV
-        {"path": "/API/STA", "convencion": "max"},     # -> /API/STA/DEV
+        {"path": "/common", "perfil": "min"},      # -> /dev/common
+        {"path": "/rds", "perfil": "min"},         # -> /dev/rds
+        {"path": "/EMAIL", "perfil": "max"},       # -> /EMAIL/DEV
+        {"path": "/API/STA", "perfil": "max"},     # -> /API/STA/DEV
         # Con 'mixto' acotas por debajo del entorno: esto lee solo stan_ai, en vez de
         # todo lo que cuelga de /API/MULTIAPI/DEV
-        {"path": "/API/MULTIAPI/*/stan_ai", "convencion": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
+        {"path": "/API/MULTIAPI/*/stan_ai", "perfil": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
     ]
 }
-# Perfil de naming que se usa al crear un parámetro nuevo (opción 4 del menú).
-# Si no lo defines, se usa el primer perfil de 'naming'.
-convencion_nuevos = "min"
+# Perfil que se usa al crear un parámetro nuevo (opción 4 del menú).
+# Si no lo defines, se usa el primero de 'perfiles'.
+perfil_nuevos = "min"
 # ¿El nombre del fichero exportado incluye la ruta leída?
 #   False -> parameters_dev.py            (comportamiento de siempre)
@@ -224,9 +224,9 @@ tags_obligatorias = [
 ```
 Nota: Si el archivo paramsx_config.py ya existe, no será sobrescrito durante la instalación para proteger las configuraciones personalizadas.
-### Los perfiles de naming
+### Los perfiles
-Cada organización nombra sus parámetros a su manera, así que ParamsX no impone ninguna convención: **tú defines los perfiles que uses en el diccionario `naming` y les pones el nombre que quieras**. Cada entrada de `parameter_list` declara con qué perfil se construye su ruta completa. Los tres campos de un perfil y sus valores están explicados en el propio fichero de configuración, ahí arriba.
+Cada organización nombra sus parámetros a su manera, así que ParamsX no impone ninguna convención: **tú defines los perfiles que uses en el diccionario `perfiles` y les pones el nombre que quieras**. Cada entrada de `parameter_list` declara con qué perfil se construye su ruta completa, con la clave `perfil`. Los tres campos de un perfil y sus valores están explicados en el propio fichero de configuración, ahí arriba.
 **No hay una lista cerrada de perfiles.** Los tres campos se combinan libremente, así que la plantilla no intenta traértelos todos: define los dos o tres que use tu organización y olvídate del resto. `min` y `max` vienen predefinidos porque son los que ParamsX traía antes de que los perfiles fueran configurables.
@@ -246,15 +246,15 @@ En el nombre van el entorno, la ruta y el perfil, porque dos entradas pueden com
 | Entrada | Fichero |
 |---|---|
-| `{"path": "/API/STA", "convencion": "max"}` | `parameters_dev__API_STA__max.py` |
-| `{"path": "/API/*/STA", "convencion": "mixto_max"}` | `parameters_dev__API_env_STA__mixto_max.py` |
+| `{"path": "/API/STA", "perfil": "max"}` | `parameters_dev__API_STA__max.py` |
+| `{"path": "/API/*/STA", "perfil": "mixto_max"}` | `parameters_dev__API_env_STA__mixto_max.py` |
 ### Cómo acotar tu parameter_list (recomendación)
 `parameter_list` es solo tu vista de trabajo: **la seguridad real la impone IAM, no este fichero**. La recomendación de uso es:
-- **Admins**: pueden configurar rutas raíz amplias, por ejemplo `{"path": "/rds", "convencion": "min"}` → `/dev/rds`.
-- **Usuarios normales**: conviene acotar la ruta a lo que su rol IAM tiene realmente autorizado, por ejemplo `{"path": "/rds/cee-dev/api", "convencion": "min"}` → `/dev/rds/cee-dev/api`.
+- **Admins**: pueden configurar rutas raíz amplias, por ejemplo `{"path": "/rds", "perfil": "min"}` → `/dev/rds`.
+- **Usuarios normales**: conviene acotar la ruta a lo que su rol IAM tiene realmente autorizado, por ejemplo `{"path": "/rds/cee-dev/api", "perfil": "min"}` → `/dev/rds/cee-dev/api`.
 Si configuras una ruta más amplia que tus permisos, no pasa nada grave: ParamsX te avisará con un mensaje claro de acceso denegado en vez de una traza de boto3. Pero afinar la ruta te ahorra el error.
@@ -363,7 +363,7 @@ El programa mostrará un menú donde Podrás:
 - Crear un parámetro nuevo.
 ### Leer Parámetros:
-1. Selecciona la opción "Leer parámetros" en el menú. La lista muestra cada ruta con su perfil de naming, por ejemplo `/rds  [min]` o `/API/STA  [max]`.
+1. Selecciona la opción "Leer parámetros" en el menú. La lista muestra cada ruta con su perfil, por ejemplo `/rds  [min]` o `/API/STA  [max]`.
 2. Elige el prefijo y el entorno que deseas consultar.
 3. Los parámetros serán descargados y guardados en archivos como:
     - parameters_dev.py
@@ -384,7 +384,7 @@ El programa mostrará un menú donde Podrás:
 ### Crear un parámetro nuevo:
 1. Selecciona la opción "Crear nuevo parámetro" y elige el entorno.
-2. Escribe la ruta **sin el entorno**, como en tu `parameter_list`: ParamsX le aplica el perfil de `convencion_nuevos` y te enseña la ruta resultante en AWS para que la confirmes.
+2. Escribe la ruta **sin el entorno**, como en tu `parameter_list`: ParamsX le aplica el perfil de `perfil_nuevos` y te enseña la ruta resultante en AWS para que la confirmes.
 3. Escribe el valor: texto plano o JSON en una línea.
 4. Rellena las tags obligatorias (si `tags_activas = 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.

paramsx-2.2.2/paramsx/__init__.py ADDED Viewed

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

{paramsx-2.2.1 → paramsx-2.2.2}/paramsx/funcions.py RENAMED Viewed

@@ -30,7 +30,7 @@ def _codigo_error(error):
     return error.response.get("Error", {}).get("Code", "")
-# Valores admitidos en un perfil de naming
+# Valores admitidos en un perfil
 POSICIONES_ENTORNO = ("inicio", "final", "mixto", "ninguno")
 CASES_ENTORNO = ("lower", "upper", "capitalize")
 CASES_RUTA = ("lower", "upper", "capitalize", "ninguno")
@@ -61,7 +61,7 @@ def aplicar_case_ruta(path, case_ruta):
     return path
-# Construir la ruta completa aplicando el perfil de naming de la entrada.
+# Construir la ruta completa aplicando el perfil de la entrada.
 # Las tres posiciones son la misma operación: se normaliza la ruta a una plantilla con
 # un único marcador y se sustituye por el entorno. "ninguno" no lleva marcador.
 def build_full_path(path, perfil, entorno):
@@ -96,20 +96,20 @@ def build_full_path(path, perfil, entorno):
 # Trozo de nombre de fichero derivado de una entrada de parameter_list:
-# {"path": "/API/*/STA", "convencion": "mixto_max"} -> API_env_STA__mixto_max
+# {"path": "/API/*/STA", "perfil": "mixto_max"} -> API_env_STA__mixto_max
 # Lleva la posición del marcador y el perfil porque dos entradas distintas pueden
 # compartir la ruta declarada (con perfiles distintos, o con el entorno en otro sitio)
 # y apuntar a rutas de AWS diferentes: sus ficheros no se pueden pisar.
 def slug_entrada(entrada):
     segmentos = [s for s in entrada["path"].strip("/").split("/") if s]
     ruta = "_".join("env" if s == MARCADOR_ENTORNO else s for s in segmentos)
-    convencion = entrada.get("convencion")
-    return f"{ruta}__{convencion}" if convencion else ruta
+    perfil = entrada.get("perfil")
+    return f"{ruta}__{perfil}" if perfil else ruta
 # Etiqueta legible de una entrada de parameter_list para los menús
 def etiqueta_entrada(entrada):
-    return f"{entrada['path']}  [{entrada['convencion']}]"
+    return f"{entrada['path']}  [{entrada['perfil']}]"
 # Ficheros exportados que hay en el directorio actual listos para cargar: los que

{paramsx-2.2.1 → paramsx-2.2.2}/paramsx/main.py RENAMED Viewed

@@ -31,17 +31,17 @@ PLANTILLA_PATH = os.path.join(os.path.dirname(os.path.abspath(__file__)), "param
 MENSAJE_MIGRACION = """BREAKING CHANGE en la configuración de ParamsX
 ------------------------------------------------
 'parameter_list' ya no es una lista de strings: ahora cada entrada es un diccionario
-que declara qué perfil de naming usa. Edita a mano ~/.xsoft/paramsx_config.py:
+que declara qué perfil usa. Edita a mano ~/.xsoft/paramsx_config.py:
     "entornos": ['dev', 'pre', 'prod'],   # SIEMPRE en minúscula
     "parameter_list": [
-        {"path": "/common",   "convencion": "min"},   # /common   + dev -> /dev/common
-        {"path": "/rds",      "convencion": "min"},   # /rds      + dev -> /dev/rds
-        {"path": "/EMAIL",    "convencion": "max"},   # /EMAIL    + dev -> /EMAIL/DEV
-        {"path": "/API/STA",  "convencion": "max"},   # /API/STA  + dev -> /API/STA/DEV
+        {"path": "/common",   "perfil": "min"},   # /common   + dev -> /dev/common
+        {"path": "/rds",      "perfil": "min"},   # /rds      + dev -> /dev/rds
+        {"path": "/EMAIL",    "perfil": "max"},   # /EMAIL    + dev -> /EMAIL/DEV
+        {"path": "/API/STA",  "perfil": "max"},   # /API/STA  + dev -> /API/STA/DEV
     ]
-Los perfiles se definen en el diccionario 'naming' del mismo fichero, con la posición
+Los perfiles se definen en el diccionario 'perfiles' del mismo fichero, con la posición
 y el case del entorno. 'min' y 'max' vienen predefinidos en la plantilla.
 Ya no existe 'entornos_old': el entorno se escribe a partir de la lista 'entornos',
@@ -51,10 +51,18 @@ que va siempre en minúscula, aplicándole el 'case_entorno' del perfil."""
 # Opciones que viven fuera de 'configuraciones' y son opcionales: si el usuario no las
 # tiene, se usa el valor de la plantilla. Se listan para poder decirle qué le falta.
 CLAVES_OPCIONALES = (
-    "naming", "convencion_nuevos", "fichero_por_ruta",
+    "perfiles", "perfil_nuevos", "fichero_por_ruta",
     "tags_activas", "obligatorias_vacias", "tags_obligatorias",
 )
+# Nombres antiguos que se siguen aceptando -> nombre actual. Se traducen al cargar, así
+# que dentro del código solo existe el nombre nuevo.
+NOMBRES_ANTIGUOS = {
+    "naming": "perfiles",              # 2.2.0
+    "convencion_nuevos": "perfil_nuevos",  # 2.2.0
+    "abac": "tags_activas",            # 2.0.0 y 2.1.0
+}
 # Ejecutar el fichero de configuración del usuario y devolver el módulo resultante
 def cargar_modulo_config():
@@ -73,7 +81,10 @@ def load_config():
     config = dict(modulo.configuraciones)
     # Todo lo que va fuera de 'configuraciones' es opcional en el fichero del usuario:
     # si no está, se usa el valor de la plantilla que trae el paquete.
-    config["naming"] = dict(getattr(modulo, "naming", plantilla_config.naming))
+    # 'naming' es el nombre que tuvo 'perfiles' en la 2.2.0
+    config["perfiles"] = dict(
+        getattr(modulo, "perfiles", getattr(modulo, "naming", plantilla_config.perfiles))
+    )
     # 'abac' es el nombre antiguo (2.0/2.1) de 'tags_activas': se sigue aceptando.
     config["tags_activas"] = bool(
         getattr(modulo, "tags_activas", getattr(modulo, "abac", plantilla_config.tags_activas))
@@ -88,8 +99,13 @@ def load_config():
         getattr(modulo, "fichero_por_ruta", plantilla_config.fichero_por_ruta)
     )
     # Si no se declara, los parámetros nuevos usan el primer perfil definido
-    primer_perfil = next(iter(config["naming"]), None)
-    config["convencion_nuevos"] = getattr(modulo, "convencion_nuevos", None) or primer_perfil
+    # ('convencion_nuevos' es el nombre que tuvo en la 2.2.0)
+    primer_perfil = next(iter(config["perfiles"]), None)
+    config["perfil_nuevos"] = (
+        getattr(modulo, "perfil_nuevos", None)
+        or getattr(modulo, "convencion_nuevos", None)
+        or primer_perfil
+    )
     return config
@@ -112,21 +128,21 @@ def validate_config(config):
     elif "entornos" in config:
         errores.append("'entornos' debe ser una lista no vacía de entornos en minúscula.")
-    naming = config.get("naming")
-    if not isinstance(naming, dict) or not naming:
+    perfiles = config.get("perfiles")
+    if not isinstance(perfiles, dict) or not perfiles:
         errores.append(
-            "'naming' debe ser un diccionario con al menos un perfil "
+            "'perfiles' debe ser un diccionario con al menos un perfil "
             "(ver la plantilla en el propio fichero de configuración)."
         )
-        naming = {}
+        perfiles = {}
     else:
-        errores.extend(validar_naming(naming))
+        errores.extend(validar_perfiles(perfiles))
-    convencion_nuevos = config.get("convencion_nuevos")
-    if naming and convencion_nuevos not in naming:
+    perfil_nuevos = config.get("perfil_nuevos")
+    if perfiles and perfil_nuevos not in perfiles:
         errores.append(
-            f"'convencion_nuevos' apunta a un perfil que no existe: {convencion_nuevos!r}. "
-            f"Perfiles definidos en 'naming': {', '.join(sorted(naming))}."
+            f"'perfil_nuevos' apunta a un perfil que no existe: {perfil_nuevos!r}. "
+            f"Perfiles definidos en 'perfiles': {', '.join(sorted(perfiles))}."
         )
     parameter_list = config.get("parameter_list")
@@ -144,26 +160,26 @@ def validate_config(config):
             errores.append(f"Entrada inválida en parameter_list: {entrada!r}")
             continue
         path = entrada.get("path")
-        convencion = entrada.get("convencion")
+        nombre_perfil = perfil_de(entrada)
         if not isinstance(path, str) or not path.strip("/"):
             errores.append(f"'path' inválido o vacío en parameter_list: {entrada!r}")
             continue
         if not path.startswith("/"):
             errores.append(f"El 'path' debe empezar por '/': {path!r}")
-        if convencion not in naming:
+        if nombre_perfil not in perfiles:
             errores.append(
-                f"'convencion' inválida en {path!r}: {convencion!r}. "
-                f"Perfiles definidos en 'naming': {', '.join(sorted(naming)) or '(ninguno)'}."
+                f"'perfil' inválido en {path!r}: {nombre_perfil!r}. "
+                f"Perfiles definidos en 'perfiles': {', '.join(sorted(perfiles)) or '(ninguno)'}."
             )
             continue
-        errores.extend(validar_marcador(path, convencion, naming[convencion]))
+        errores.extend(validar_marcador(path, nombre_perfil, perfiles[nombre_perfil]))
     # Dos entradas que resuelvan a la misma ruta no rompen nada, pero duplican trabajo
     # y confunden en el menú, así que se avisa.
     vistas = {}
     entornos_muestra = config.get("entornos") or ["dev"]
     for entrada in parameter_list:
-        perfil = naming.get(entrada.get("convencion")) if isinstance(entrada, dict) else None
+        perfil = perfiles.get(perfil_de(entrada)) if isinstance(entrada, dict) else None
         if not isinstance(perfil, dict):
             continue
         try:
@@ -181,12 +197,20 @@ def validate_config(config):
     return errores, avisos
-# Validar los perfiles de naming. Devuelve la lista de errores.
-def validar_naming(naming):
+# Nombre del perfil que usa una entrada. 'convencion' es el nombre que tuvo esta clave
+# en la 2.0, la 2.1 y la 2.2.0, y se sigue aceptando.
+def perfil_de(entrada):
+    if not isinstance(entrada, dict):
+        return None
+    return entrada.get("perfil", entrada.get("convencion"))
+# Validar los perfiles. Devuelve la lista de errores.
+def validar_perfiles(perfiles):
     errores = []
-    for nombre, perfil in naming.items():
+    for nombre, perfil in perfiles.items():
         if not isinstance(perfil, dict):
-            errores.append(f"El perfil de naming {nombre!r} debe ser un diccionario.")
+            errores.append(f"El perfil {nombre!r} debe ser un diccionario.")
             continue
         posicion = perfil.get("posicion_entorno")
@@ -215,7 +239,7 @@ def validar_naming(naming):
 # El marcador '*' y la posición del perfil tienen que contar la misma historia: si no,
 # la ruta se construye mal y SSM devuelve cero parámetros sin decir por qué.
-def validar_marcador(path, convencion, perfil):
+def validar_marcador(path, nombre_perfil, perfil):
     segmentos = [s for s in path.strip("/").split("/") if s]
     marcadores = segmentos.count(MARCADOR_ENTORNO)
     posicion = perfil.get("posicion_entorno")
@@ -228,14 +252,14 @@ def validar_marcador(path, convencion, perfil):
     if posicion == "mixto" and marcadores != 1:
         return [
-            f"La ruta {path!r} usa el perfil {convencion!r} ('mixto') y debe llevar "
+            f"La ruta {path!r} usa el perfil {nombre_perfil!r} ('mixto') y debe llevar "
             f"exactamente un '{MARCADOR_ENTORNO}' que marque dónde va el entorno "
             f"(tiene {marcadores})."
         ]
     if posicion != "mixto" and marcadores:
         return [
-            f"La ruta {path!r} lleva un '{MARCADOR_ENTORNO}' pero su perfil {convencion!r} "
+            f"La ruta {path!r} lleva un '{MARCADOR_ENTORNO}' pero su perfil {nombre_perfil!r} "
             f"tiene posicion_entorno='{posicion}', que ya decide dónde va el entorno. "
             "Usa un perfil 'mixto' o quita el marcador."
         ]
@@ -246,8 +270,10 @@ def validar_marcador(path, convencion, perfil):
 # Normalizar la configuración ya validada
 def normalize_config(config):
     config["entornos"] = [str(e).lower() for e in config["entornos"]]
+    # Se normaliza la clave del perfil: aunque el usuario haya escrito 'convencion',
+    # dentro del programa las entradas solo tienen 'perfil'.
     config["parameter_list"] = [
-        {"path": "/" + entrada["path"].strip("/"), "convencion": entrada["convencion"]}
+        {"path": "/" + entrada["path"].strip("/"), "perfil": perfil_de(entrada)}
         for entrada in config["parameter_list"]
     ]
     return config
@@ -282,8 +308,8 @@ def leer_ruta(stdscr, ssm, full_path, tags_activas, tags_obligatorias):
     return parameters, avisos
-# Feature 2: crear un parámetro nuevo con el perfil de naming de 'convencion_nuevos'
-def crear_parametro(stdscr, ssm, entornos, perfil, convencion, tags_activas,
+# Feature 2: crear un parámetro nuevo con el perfil declarado en 'perfil_nuevos'
+def crear_parametro(stdscr, ssm, entornos, perfil, nombre_perfil, tags_activas,
                     tags_obligatorias, obligatorias_vacias=False):
     env_choice = show_environment_selection(stdscr, entornos)
     if env_choice is None:
@@ -309,7 +335,7 @@ def crear_parametro(stdscr, ssm, entornos, perfil, convencion, tags_activas,
         path = prompt_input(
             stdscr,
             "Crear nuevo parámetro (1/4): ruta",
-            f"Ruta del parámetro (convención '{convencion}', sin el entorno):",
+            f"Ruta del parámetro (perfil '{nombre_perfil}', sin el entorno):",
             valor=path,
             ayuda=ayudas.get(posicion, ""),
         )
@@ -323,7 +349,7 @@ def crear_parametro(stdscr, ssm, entornos, perfil, convencion, tags_activas,
             show_message(stdscr, "La ruta no puede estar vacía.", 2)
             continue
-        problemas = validar_marcador(path, convencion, perfil)
+        problemas = validar_marcador(path, nombre_perfil, perfil)
         if problemas:
             show_message(stdscr, problemas[0], 2)
             continue
@@ -335,7 +361,7 @@ def crear_parametro(stdscr, ssm, entornos, perfil, convencion, tags_activas,
     if not show_report(
         stdscr, "Crear nuevo parámetro (2/4): confirmar la ruta",
-        [f"Convención: {convencion}",
+        [f"Perfil:  {nombre_perfil}",
          f"Escrita:    {path_declarado}",
          f"En AWS:     {path}",
          "",
@@ -481,12 +507,12 @@ def main(stdscr, config=None):
     environments = config['entornos']
     PARAMETER_LIST = config['parameter_list']
-    NAMING = config['naming']
+    PERFILES = config['perfiles']
     TAGS_ACTIVAS = config['tags_activas']
     TAGS_OBLIGATORIAS = config['tags_obligatorias']
     OBLIGATORIAS_VACIAS = config.get('obligatorias_vacias', False)
     FICHERO_POR_RUTA = config.get('fichero_por_ruta', False)
-    CONVENCION_NUEVOS = config.get('convencion_nuevos')
+    PERFIL_NUEVOS = config.get('perfil_nuevos')
     # Nombre del fichero exportado: con fichero_por_ruta cada ruta tiene el suyo, así que
     # leer una segunda ruta del mismo entorno no machaca lo que estabas editando.
@@ -512,9 +538,9 @@ def main(stdscr, config=None):
             selected_env = environments[env_choice]
-            # Crear el prefijo completo según el perfil de naming de la entrada
+            # Crear el prefijo completo según el perfil de la entrada
             full_path = build_full_path(
-                selected_param["path"], NAMING[selected_param["convencion"]], selected_env
+                selected_param["path"], PERFILES[selected_param["perfil"]], selected_env
             )
             show_message(stdscr, f"Buscando parámetros en: {full_path}...", 3)  # Mensaje inicial
@@ -727,7 +753,7 @@ def main(stdscr, config=None):
                 for entrada in PARAMETER_LIST:
                     for env in environments:
                         full_path = build_full_path(
-                            entrada["path"], NAMING[entrada["convencion"]], env
+                            entrada["path"], PERFILES[entrada["perfil"]], env
                         )
                         try:
                             # Obtener parámetros desde AWS SSM
@@ -791,9 +817,9 @@ def main(stdscr, config=None):
                 selected_env = environments[env_choice]
-                # Crear el prefijo completo según el perfil de naming de la entrada
+                # Crear el prefijo completo según el perfil de la entrada
                 full_path = build_full_path(
-                    selected_param["path"], NAMING[selected_param["convencion"]], selected_env
+                    selected_param["path"], PERFILES[selected_param["perfil"]], selected_env
                 )
                 parameters, avisos = leer_ruta(stdscr, ssm, full_path, TAGS_ACTIVAS, TAGS_OBLIGATORIAS)
@@ -818,9 +844,9 @@ def main(stdscr, config=None):
                 show_report(stdscr, "Backup creado", lineas, color_pair=3)
         elif choice == 4:
-            # Crear nuevo parámetro con el perfil declarado en 'convencion_nuevos'
+            # Crear nuevo parámetro con el perfil declarado en 'perfil_nuevos'
             crear_parametro(
-                stdscr, ssm, environments, NAMING[CONVENCION_NUEVOS], CONVENCION_NUEVOS,
+                stdscr, ssm, environments, PERFILES[PERFIL_NUEVOS], PERFIL_NUEVOS,
                 TAGS_ACTIVAS, TAGS_OBLIGATORIAS, OBLIGATORIAS_VACIAS
             )
@@ -856,7 +882,7 @@ def create_config(escribir_ejemplo=False):
         print("  paramsx configure --ejemplo")
-# Valor por defecto en una línea: el repr de 'naming' o de las tags ocupa media pantalla
+# Valor por defecto en una línea: el repr de 'perfiles' o de las tags ocupa media pantalla
 def resumir_valor(valor):
     if isinstance(valor, dict):
         return f"{len(valor)} perfiles ({', '.join(valor)})"
@@ -878,11 +904,27 @@ def revisar_config(config_file):
         return
     faltan = [clave for clave in CLAVES_OPCIONALES if not hasattr(modulo, clave)]
-    # 'abac' es el nombre antiguo de 'tags_activas': teniéndolo no falta nada
-    if "tags_activas" in faltan and hasattr(modulo, "abac"):
-        faltan.remove("tags_activas")
-        print("- 'abac' es el nombre antiguo de 'tags_activas'. Sigue funcionando, pero")
-        print("  renómbralo cuando puedas: el nuevo dice lo que hace.")
+    # Los nombres antiguos siguen funcionando, así que lo que cubren no "falta":
+    # solo se avisa de que hay una forma más clara de escribirlo.
+    antiguos = [(v, n) for v, n in NOMBRES_ANTIGUOS.items() if hasattr(modulo, v)]
+    lista = getattr(modulo, "configuraciones", {})
+    lista = lista.get("parameter_list", []) if isinstance(lista, dict) else []
+    con_convencion = [
+        e for e in lista
+        if isinstance(e, dict) and "perfil" not in e and "convencion" in e
+    ]
+    if antiguos or con_convencion:
+        print("Nombres antiguos que sigues usando. Funcionan, pero el nuevo se entiende mejor:")
+        for viejo, nuevo in antiguos:
+            if nuevo in faltan:
+                faltan.remove(nuevo)
+            print(f"  {viejo:20} -> {nuevo}")
+        if con_convencion:
+            print(f"  {'convencion':20} -> perfil "
+                  f"(en {len(con_convencion)} entrada(s) de parameter_list)")
+        print()
     if faltan:
         print("Opciones que no tienes y que ParamsX rellena con el valor por defecto:")
@@ -943,14 +985,14 @@ Opciones del menú:
   2. Cargar parámetros            Elige uno de los ficheros exportados que tengas en el
                                   directorio, compara y aplica los cambios en AWS.
   3. Crear Backup de parámetros   Respalda una ruta, la lista completa o toda la cuenta.
-  4. Crear nuevo parámetro        Crea un parámetro nuevo con el perfil 'convencion_nuevos'.
+  4. Crear nuevo parámetro        Crea un parámetro nuevo con el perfil de 'perfil_nuevos'.
 Configuración (~/.xsoft/paramsx_config.py). El fichero trae comentada cada opción:
   profile_name      Perfil de ~/.aws/credentials.
   region_name       Región de AWS.
   entornos          Lista de entornos, SIEMPRE en minúscula: ['dev', 'pre', 'prod'].
-                    Cada perfil de naming decide cómo se escriben en la ruta.
-  naming            Perfiles de naming: cómo se construye la ruta real en AWS. Los
+                    Cada perfil decide cómo se escriben en la ruta.
+  perfiles          Cómo se construye la ruta real en AWS. Los
                     nombres los eliges tú y combinas estos tres campos:
                       posicion_entorno  'inicio'  /rds       -> /dev/rds
                                         'final'   /API/STA   -> /API/STA/DEV
@@ -959,8 +1001,8 @@ Configuración (~/.xsoft/paramsx_config.py). El fichero trae comentada cada opci
                       case_entorno      'lower' | 'upper' | 'capitalize'
                       case_ruta         'lower' | 'upper' | 'capitalize' | 'ninguno'
                                         (solo al crear parámetros, opción 4)
-  parameter_list    Lista de dicts {"path": "/rds", "convencion": "<perfil de naming>"}.
-  convencion_nuevos Perfil que usan los parámetros creados con la opción 4.
+  parameter_list    Lista de dicts {"path": "/rds", "perfil": "<nombre de un perfil>"}.
+  perfil_nuevos     Perfil que usan los parámetros creados con la opción 4.
   fichero_por_ruta  True -> el fichero exportado lleva entorno, ruta y perfil en el
                     nombre, para que leer otra ruta del mismo entorno no machaque la
                     anterior: parameters_dev__API_STA__max.py

{paramsx-2.2.1 → paramsx-2.2.2}/paramsx/paramsx_config.py RENAMED Viewed

@@ -1,6 +1,6 @@
 ## Configuraciones ParamsX
-# --- Perfiles de naming -------------------------------------------------------------
+# --- Perfiles -------------------------------------------------------------
 # Un perfil dice CÓMO se construye la ruta real en AWS a partir de la ruta que declaras
 # en 'parameter_list' y del entorno que eliges en el menú. Los nombres son tuyos: define
 # solo los que uses y llámalos como quieras. Un perfil tiene tres campos:
@@ -42,7 +42,7 @@
 # Combina los tres campos como necesites: no hay una lista cerrada de perfiles. En el
 # README tienes más ejemplos.
-naming = {
+perfiles = {
     "min": {"posicion_entorno": "inicio", "case_entorno": "lower", "case_ruta": "lower"},
     "max": {"posicion_entorno": "final", "case_entorno": "upper", "case_ruta": "ninguno"},
     "mixto_max": {"posicion_entorno": "mixto", "case_entorno": "upper", "case_ruta": "ninguno"},
@@ -55,19 +55,19 @@ configuraciones = {
     "region_name": "eu-south-2",         # Cambiar por tu región de AWS
     "entornos": ['dev', 'pre', 'prod'],  # SIEMPRE en minúscula, es la lista canónica única
     "parameter_list": [
-        {"path": "/common", "convencion": "min"},      # -> /dev/common
-        {"path": "/rds", "convencion": "min"},         # -> /dev/rds
-        {"path": "/EMAIL", "convencion": "max"},       # -> /EMAIL/DEV
-        {"path": "/API/STA", "convencion": "max"},     # -> /API/STA/DEV
+        {"path": "/common", "perfil": "min"},      # -> /dev/common
+        {"path": "/rds", "perfil": "min"},         # -> /dev/rds
+        {"path": "/EMAIL", "perfil": "max"},       # -> /EMAIL/DEV
+        {"path": "/API/STA", "perfil": "max"},     # -> /API/STA/DEV
         # Con 'mixto' acotas por debajo del entorno: esto lee solo stan_ai, en vez de
         # todo lo que cuelga de /API/MULTIAPI/DEV
-        {"path": "/API/MULTIAPI/*/stan_ai", "convencion": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
+        {"path": "/API/MULTIAPI/*/stan_ai", "perfil": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
     ]
 }
-# Perfil de naming que se usa al crear un parámetro nuevo (opción 4 del menú).
-# Si no lo defines, se usa el primer perfil de 'naming'.
-convencion_nuevos = "min"
+# Perfil que se usa al crear un parámetro nuevo (opción 4 del menú).
+# Si no lo defines, se usa el primero de 'perfiles'.
+perfil_nuevos = "min"
 # ¿El nombre del fichero exportado incluye la ruta leída?
 #   False -> parameters_dev.py            (comportamiento de siempre)

{paramsx-2.2.1 → paramsx-2.2.2/paramsx.egg-info}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.2.1
+Version: 2.2.2
 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
@@ -24,7 +24,7 @@ ParamsX es una herramienta diseñada para gestionar y organizar parámetros de A
 ## ⚠ Breaking change en la versión 2.0.0
-Si vienes de la 1.x tienes que **actualizar a mano tu `~/.xsoft/paramsx_config.py`**: `parameter_list` ya no es una lista de strings, ahora cada entrada es un diccionario con su convención de naming. La versión antigua **no es compatible** y ParamsX se niega a arrancar mostrando cómo migrarla. Detalle completo en el [CHANGELOG](CHANGELOG.md).
+Si vienes de la 1.x tienes que **actualizar a mano tu `~/.xsoft/paramsx_config.py`**: `parameter_list` ya no es una lista de strings, ahora cada entrada es un diccionario que declara su perfil. La versión antigua **no es compatible** y ParamsX se niega a arrancar mostrando cómo migrarla. Detalle completo en el [CHANGELOG](CHANGELOG.md).
 ### Estructura Recomendada
 La convención de naming es de 5 niveles, donde los últimos segmentos son opcionales según el caso:
@@ -97,10 +97,10 @@ Esto te permitirá mantener respaldos seguros o realizar migraciones/reorganizac
 4. Crear nuevo parámetro
 - Crea un parámetro desde cero sin salir de la herramienta. Te pedirá, en este orden:
-    - La ruta **sin el entorno**, igual que la declaras en `parameter_list`: el perfil de naming se encarga de colocarlo. Verás en pantalla la ruta resultante en AWS antes de seguir.
+    - La ruta **sin el entorno**, igual que la declaras en `parameter_list`: el perfil se encarga de colocarlo. Verás en pantalla la ruta resultante en AWS antes de seguir.
     - El valor: texto plano o JSON en una línea (por ejemplo `{"host": "x", "user": "y", "pass": "z"}`), que se valida antes de continuar.
     - Las tags obligatorias, si tienes `tags_activas = True`.
-- El perfil que se usa es el que declares en `convencion_nuevos`. Si tu perfil es de tipo `mixto`, escribe el `*` en la ruta para indicar dónde va el entorno.
+- El perfil que se usa es el que declares en `perfil_nuevos`. Si tu perfil es de tipo `mixto`, escribe el `*` en la ruta para indicar dónde va el entorno.
 - Antes de subirlo verás una pantalla de confirmación con la ruta, el valor y las tags. El parámetro se crea con `Overwrite=False`, así que nunca machaca uno existente.
 - Tras crearlo aparecerá la próxima vez que leas la ruta correspondiente de tu `parameter_list`.
@@ -135,7 +135,7 @@ Ejemplo del contenido de paramsx_config.py:
 ```python
 ## Configuraciones ParamsX
-# --- Perfiles de naming -------------------------------------------------------------
+# --- Perfiles -------------------------------------------------------------
 # Un perfil dice CÓMO se construye la ruta real en AWS a partir de la ruta que declaras
 # en 'parameter_list' y del entorno que eliges en el menú. Los nombres son tuyos: define
 # solo los que uses y llámalos como quieras. Un perfil tiene tres campos:
@@ -177,7 +177,7 @@ Ejemplo del contenido de paramsx_config.py:
 # Combina los tres campos como necesites: no hay una lista cerrada de perfiles. En el
 # README tienes más ejemplos.
-naming = {
+perfiles = {
     "min": {"posicion_entorno": "inicio", "case_entorno": "lower", "case_ruta": "lower"},
     "max": {"posicion_entorno": "final", "case_entorno": "upper", "case_ruta": "ninguno"},
     "mixto_max": {"posicion_entorno": "mixto", "case_entorno": "upper", "case_ruta": "ninguno"},
@@ -190,19 +190,19 @@ configuraciones = {
     "region_name": "eu-south-2",         # Cambiar por tu región de AWS
     "entornos": ['dev', 'pre', 'prod'],  # SIEMPRE en minúscula, es la lista canónica única
     "parameter_list": [
-        {"path": "/common", "convencion": "min"},      # -> /dev/common
-        {"path": "/rds", "convencion": "min"},         # -> /dev/rds
-        {"path": "/EMAIL", "convencion": "max"},       # -> /EMAIL/DEV
-        {"path": "/API/STA", "convencion": "max"},     # -> /API/STA/DEV
+        {"path": "/common", "perfil": "min"},      # -> /dev/common
+        {"path": "/rds", "perfil": "min"},         # -> /dev/rds
+        {"path": "/EMAIL", "perfil": "max"},       # -> /EMAIL/DEV
+        {"path": "/API/STA", "perfil": "max"},     # -> /API/STA/DEV
         # Con 'mixto' acotas por debajo del entorno: esto lee solo stan_ai, en vez de
         # todo lo que cuelga de /API/MULTIAPI/DEV
-        {"path": "/API/MULTIAPI/*/stan_ai", "convencion": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
+        {"path": "/API/MULTIAPI/*/stan_ai", "perfil": "mixto_max"},  # -> /API/MULTIAPI/DEV/stan_ai
     ]
 }
-# Perfil de naming que se usa al crear un parámetro nuevo (opción 4 del menú).
-# Si no lo defines, se usa el primer perfil de 'naming'.
-convencion_nuevos = "min"
+# Perfil que se usa al crear un parámetro nuevo (opción 4 del menú).
+# Si no lo defines, se usa el primero de 'perfiles'.
+perfil_nuevos = "min"
 # ¿El nombre del fichero exportado incluye la ruta leída?
 #   False -> parameters_dev.py            (comportamiento de siempre)
@@ -244,9 +244,9 @@ tags_obligatorias = [
 ```
 Nota: Si el archivo paramsx_config.py ya existe, no será sobrescrito durante la instalación para proteger las configuraciones personalizadas.
-### Los perfiles de naming
+### Los perfiles
-Cada organización nombra sus parámetros a su manera, así que ParamsX no impone ninguna convención: **tú defines los perfiles que uses en el diccionario `naming` y les pones el nombre que quieras**. Cada entrada de `parameter_list` declara con qué perfil se construye su ruta completa. Los tres campos de un perfil y sus valores están explicados en el propio fichero de configuración, ahí arriba.
+Cada organización nombra sus parámetros a su manera, así que ParamsX no impone ninguna convención: **tú defines los perfiles que uses en el diccionario `perfiles` y les pones el nombre que quieras**. Cada entrada de `parameter_list` declara con qué perfil se construye su ruta completa, con la clave `perfil`. Los tres campos de un perfil y sus valores están explicados en el propio fichero de configuración, ahí arriba.
 **No hay una lista cerrada de perfiles.** Los tres campos se combinan libremente, así que la plantilla no intenta traértelos todos: define los dos o tres que use tu organización y olvídate del resto. `min` y `max` vienen predefinidos porque son los que ParamsX traía antes de que los perfiles fueran configurables.
@@ -266,15 +266,15 @@ En el nombre van el entorno, la ruta y el perfil, porque dos entradas pueden com
 | Entrada | Fichero |
 |---|---|
-| `{"path": "/API/STA", "convencion": "max"}` | `parameters_dev__API_STA__max.py` |
-| `{"path": "/API/*/STA", "convencion": "mixto_max"}` | `parameters_dev__API_env_STA__mixto_max.py` |
+| `{"path": "/API/STA", "perfil": "max"}` | `parameters_dev__API_STA__max.py` |
+| `{"path": "/API/*/STA", "perfil": "mixto_max"}` | `parameters_dev__API_env_STA__mixto_max.py` |
 ### Cómo acotar tu parameter_list (recomendación)
 `parameter_list` es solo tu vista de trabajo: **la seguridad real la impone IAM, no este fichero**. La recomendación de uso es:
-- **Admins**: pueden configurar rutas raíz amplias, por ejemplo `{"path": "/rds", "convencion": "min"}` → `/dev/rds`.
-- **Usuarios normales**: conviene acotar la ruta a lo que su rol IAM tiene realmente autorizado, por ejemplo `{"path": "/rds/cee-dev/api", "convencion": "min"}` → `/dev/rds/cee-dev/api`.
+- **Admins**: pueden configurar rutas raíz amplias, por ejemplo `{"path": "/rds", "perfil": "min"}` → `/dev/rds`.
+- **Usuarios normales**: conviene acotar la ruta a lo que su rol IAM tiene realmente autorizado, por ejemplo `{"path": "/rds/cee-dev/api", "perfil": "min"}` → `/dev/rds/cee-dev/api`.
 Si configuras una ruta más amplia que tus permisos, no pasa nada grave: ParamsX te avisará con un mensaje claro de acceso denegado en vez de una traza de boto3. Pero afinar la ruta te ahorra el error.
@@ -383,7 +383,7 @@ El programa mostrará un menú donde Podrás:
 - Crear un parámetro nuevo.
 ### Leer Parámetros:
-1. Selecciona la opción "Leer parámetros" en el menú. La lista muestra cada ruta con su perfil de naming, por ejemplo `/rds  [min]` o `/API/STA  [max]`.
+1. Selecciona la opción "Leer parámetros" en el menú. La lista muestra cada ruta con su perfil, por ejemplo `/rds  [min]` o `/API/STA  [max]`.
 2. Elige el prefijo y el entorno que deseas consultar.
 3. Los parámetros serán descargados y guardados en archivos como:
     - parameters_dev.py
@@ -404,7 +404,7 @@ El programa mostrará un menú donde Podrás:
 ### Crear un parámetro nuevo:
 1. Selecciona la opción "Crear nuevo parámetro" y elige el entorno.
-2. Escribe la ruta **sin el entorno**, como en tu `parameter_list`: ParamsX le aplica el perfil de `convencion_nuevos` y te enseña la ruta resultante en AWS para que la confirmes.
+2. Escribe la ruta **sin el entorno**, como en tu `parameter_list`: ParamsX le aplica el perfil de `perfil_nuevos` y te enseña la ruta resultante en AWS para que la confirmes.
 3. Escribe el valor: texto plano o JSON en una línea.
 4. Rellena las tags obligatorias (si `tags_activas = 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.