paramsx 2.2.0__tar.gz → 2.2.1__tar.gz

{paramsx-2.2.0 → paramsx-2.2.1}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 2.2.1
+
+Solo comandos de terminal y documentación: no cambia nada de la lectura, la carga ni la
+construcción de rutas. Si ya tienes la 2.2.0 funcionando, actualizar no te obliga a tocar
+tu configuración.
+
+### Añadido
+
+- **`paramsx --version`** (y `-v`), y la versión también en la cabecera de `paramsx --help`. La versión pasa a vivir en `paramsx/__init__.py` y `setup.py` la lee de ahí, para que el paquete y el comando no puedan decir cosas distintas.
+- **`paramsx configure` sobre una configuración que ya existe ya no se queda en "no se sobrescribirá".** Sigue sin tocar el fichero, pero ahora te dice qué opciones nuevas no tienes y con qué valor por defecto se rellenan, si usas el nombre antiguo `abac`, y si la configuración es válida.
+- **`paramsx configure --ejemplo`**: además de lo anterior, deja la plantilla de esta versión en `~/.xsoft/paramsx_config.ejemplo.py`, al lado de la tuya, para comparar. ParamsX no la lee: es solo referencia. Escribir en tu configuración es lo único que no se puede deshacer, así que va en un comando aparte y en otro fichero.
+- Mensaje de primer arranque más claro cuando todavía no hay configuración, explicando qué hace `paramsx configure` y dónde va el fichero.
+
+### Cambiado
+
+- **`paramsx --help` al día.** La opción 2 ya explica que eliges entre los ficheros que tengas en el directorio; el ejemplo de `mixto` usa el entorno en mayúscula como el resto de la documentación; `fichero_por_ruta` enseña el nombre real (`parameters_dev__API_STA__max.py`); y se documentan `profile_name`, `region_name` y `entornos`, que no aparecían aunque son obligatorios.
+- **El README muestra el contenido literal de `paramsx_config.py`**, con sus comentarios y tablas, en vez de una versión resumida: es exactamente lo que te crea `paramsx configure`, así que no pueden desincronizarse. Y una tabla con todos los comandos disponibles.
+
 ## 2.2.0
 
 ### Añadido

{paramsx-2.2.0/paramsx.egg-info → paramsx-2.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.2.0
+Version: 2.2.1
 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
@@ -128,11 +128,55 @@ Este comando creará automáticamente una carpeta de configuración en tu direct
 
 Dentro de esta carpeta, encontrarás el archivo paramsx_config.py. Este archivo contiene la configuración inicial que debes ajustar según tu entorno.
 
+Si ya tenías configuración de una versión anterior, `paramsx configure` **no la sobrescribe**: te dice qué opciones nuevas no tienes y con qué valor por defecto se están rellenando, y si la configuración es válida. Con `paramsx configure --ejemplo` además deja la plantilla de esta versión en `paramsx_config.ejemplo.py`, al lado de la tuya, para que compares sin tocar nada.
+
 Ejemplo del contenido de paramsx_config.py:
 
 ```python
 ## Configuraciones ParamsX
 
+# --- Perfiles de naming -------------------------------------------------------------
+# 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:
+#
+#   campo             | valores                                  | qué decide
+#   ------------------+------------------------------------------+---------------------------
+#   posicion_entorno  | inicio | final | mixto | ninguno          | dónde va el entorno
+#   case_entorno      | lower | upper | capitalize                | cómo se escribe el entorno
+#   case_ruta         | lower | upper | capitalize | ninguno      | case de la ruta AL CREAR
+#
+# posicion_entorno -> dónde se coloca el entorno (ejemplos con el entorno 'dev'):
+#
+#   valor    | ruta declarada  | ruta real en AWS
+#   ---------+-----------------+--------------------------------------------------------
+#   inicio   | /rds            | /dev/rds
+#   final    | /API/STA        | /API/STA/DEV
+#   mixto    | /API/*/STA      | /API/DEV/STA    el '*' marca el sitio; uno y como segmento
+#   ninguno  | /api/sta/auth   | /api/sta/auth   una cuenta AWS por entorno; case_entorno da igual
+#
+# case_entorno -> cómo se escribe ese entorno en la ruta:
+#
+#   valor       | 'dev' se escribe | ruta real de /API/STA con posicion_entorno=final
+#   ------------+------------------+------------------------------------------------
+#   lower       | dev              | /API/STA/dev
+#   upper       | DEV              | /API/STA/DEV
+#   capitalize  | Dev              | /API/STA/Dev
+#
+# case_ruta -> a qué case se fuerza la ruta que TÚ escribes al CREAR un parámetro
+# (opción 4 del menú). No afecta a leer ni a editar: lo que ya existe en AWS se
+# respeta siempre tal cual esté.
+#
+#   valor       | si escribes /API/MULTIAPI/Token, se crea
+#   ------------+-----------------------------------------
+#   lower       | /api/multiapi/token
+#   upper       | /API/MULTIAPI/TOKEN
+#   capitalize  | /Api/Multiapi/Token
+#   ninguno     | /API/MULTIAPI/Token
+#
+# Combina los tres campos como necesites: no hay una lista cerrada de perfiles. En el
+# README tienes más ejemplos.
+
 naming = {
     "min": {"posicion_entorno": "inicio", "case_entorno": "lower", "case_ruta": "lower"},
     "max": {"posicion_entorno": "final", "case_entorno": "upper", "case_ruta": "ninguno"},
@@ -150,97 +194,67 @@ configuraciones = {
         {"path": "/rds", "convencion": "min"},         # -> /dev/rds
         {"path": "/EMAIL", "convencion": "max"},       # -> /EMAIL/DEV
         {"path": "/API/STA", "convencion": "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
     ]
 }
 
+# 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"
 
+# ¿El nombre del fichero exportado incluye la ruta leída?
+#   False -> parameters_dev.py            (comportamiento de siempre)
+#   True  -> parameters_dev__API_STA__max.py  (uno por entrada y entorno: lleva el
+#            entorno, la ruta y el perfil, porque dos entradas pueden compartir ruta)
+# Ponlo en True si sueles leer varias rutas del mismo entorno y no quieres que la
+# segunda lectura te machaque el fichero de la primera.
 fichero_por_ruta = False
 
 
 ## Configuraciones Tags
 
+# Gestionar las tags de los parámetros: leerlas de AWS, exponerlas en el fichero
+# exportado para editarlas y validar las obligatorias al cargar.
+#   True  -> las tags viajan en el fichero y se validan.
+#   False -> no aparecen tags en el fichero y no se valida nada.
+# En cuentas cuyo control de acceso va por tags (ABAC vía IAM) esto debe estar en True.
 tags_activas = True
 
+# Solo aplica si tags_activas = True.
+#   False -> validación bloqueante: si a un parámetro le falta alguna tag obligatoria
+#            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
 
+# Tags que se exigen en cada parámetro cuando tags_activas = True. La lista es libre:
+# estas 8 son las que sostienen el control de acceso ABAC vía IAM de nuestra cuenta.
 tags_obligatorias = [
-    "Application", "Environment", "Owner", "Project",
-    "Product", "Service", "Component", "ManagedBy",
+    "Application",
+    "Environment",
+    "Owner",
+    "Project",
+    "Product",
+    "Service",
+    "Component",
+    "ManagedBy",
 ]
 ```
 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
 
-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.
-
-Un perfil tiene tres campos:
-
-| Campo | Valores | Qué decide |
-|---|---|---|
-| `posicion_entorno` | `inicio` \| `final` \| `mixto` \| `ninguno` | Dónde va el entorno dentro de la ruta. |
-| `case_entorno` | `lower` \| `upper` \| `capitalize` | Cómo se escribe el entorno. |
-| `case_ruta` | `lower` \| `upper` \| `capitalize` \| `ninguno` | Case de la ruta al crear parámetros. |
-
-Y en detalle:
-
-**`posicion_entorno`** — dónde se coloca el entorno, con el entorno `dev`:
-
-| Valor | Ruta declarada | Ruta real en AWS | |
-|---|---|---|---|
-| `inicio` | `/rds` | `/dev/rds` | |
-| `final` | `/API/STA` | `/API/STA/DEV` | |
-| `mixto` | `/API/*/STA` | `/API/DEV/STA` | el `*` marca el sitio |
-| `ninguno` | `/api/sta/auth` | `/api/sta/auth` | una cuenta AWS por entorno |
-
-**`case_entorno`** — cómo se escribe ese entorno en la ruta:
-
-| Valor | `dev` se escribe | `/API/STA` con `posicion_entorno: final` |
-|---|---|---|
-| `lower` | `dev` | `/API/STA/dev` |
-| `upper` | `DEV` | `/API/STA/DEV` |
-| `capitalize` | `Dev` | `/API/STA/Dev` |
-
-**`case_ruta`** — a qué case se fuerza la ruta que escribes al **crear** un parámetro (opción 4). No afecta a leer ni a editar: lo que ya existe en AWS se respeta siempre tal cual esté.
-
-| Valor | Si escribes `/API/MULTIAPI/Token`, se crea |
-|---|---|
-| `lower` | `/api/multiapi/token` |
-| `upper` | `/API/MULTIAPI/TOKEN` |
-| `capitalize` | `/Api/Multiapi/Token` |
-| `ninguno` | `/API/MULTIAPI/Token` |
+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.
 
 **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.
 
-**`mixto` y el marcador `*`.** Cuando el entorno no va ni al principio ni al final, se marca su sitio con un `*` en la propia ruta. Es útil para acotar la lectura a un solo subárbol: con `/API/MULTIAPI/*/stan_ai` lees únicamente `/API/MULTIAPI/DEV/stan_ai`, en vez de todo lo que cuelga de `/API/MULTIAPI/DEV`. El `*` debe ser un segmento entero y aparecer **exactamente una vez**, y solo se admite en perfiles `mixto`: si el perfil y la ruta no cuentan la misma historia, ParamsX te lo dice al arrancar en vez de leer una ruta inexistente y devolverte una lista vacía.
-
-**`ninguno` y las cuentas sin entorno en la ruta.** Hay organizaciones que separan los entornos por cuenta de AWS y no meten `dev`/`prod` en el path. Con `posicion_entorno: "ninguno"` la ruta se usa tal cual; el selector de entorno del menú sigue existiendo, pero no toca la ruta. En este perfil el `case_entorno` es irrelevante, porque no se escribe ningún entorno.
+**Para qué sirve el `*`.** Además de colocar el entorno donde quieras, acota la lectura a un solo subárbol: con `/API/MULTIAPI/*/stan_ai` lees únicamente `/API/MULTIAPI/DEV/stan_ai`, en vez de todo lo que cuelga de `/API/MULTIAPI/DEV`. Debe ser un segmento entero, aparecer **exactamente una vez** y solo se admite en perfiles `mixto`: si el perfil y la ruta no cuentan la misma historia, ParamsX te lo dice al arrancar en vez de leer una ruta inexistente y devolverte una lista vacía.
 
-Ya **no existe** la lista `entornos_old`: el entorno se escribe siempre a partir de la lista canónica `entornos` (en minúscula), aplicándole el `case_entorno` del perfil. Si en tus rutas el entorno se llama `staging` en vez de `pre`, ponlo así en `entornos`.
+**Los entornos.** Ya no existe la lista `entornos_old`: el entorno sale siempre de la lista canónica `entornos` (en minúscula), aplicándole el `case_entorno` del perfil. Si en tus rutas se llama `staging` en vez de `pre`, ponlo así en `entornos`.
 
-Ejemplo completo de una `parameter_list` real, mezclando perfiles:
-
-```python
-    "parameter_list": [
-        {"path": "/common", "convencion": "min"},
-        {"path": "/rds", "convencion": "min"},
-        {"path": "/api", "convencion": "min"},
-        {"path": "/INFRA", "convencion": "max"},
-        {"path": "/API/STA", "convencion": "max"},
-        {"path": "/API/p15", "convencion": "max"},
-        {"path": "/API/MULTIAPI", "convencion": "max"},
-        {"path": "/APP/Alertas", "convencion": "max"},
-        {"path": "/BUCKETS", "convencion": "max"},
-        {"path": "/EMAIL", "convencion": "max"},
-        {"path": "/INFERENCIAS/TASA_DMI", "convencion": "max"},
-        {"path": "/CEE/CEXGEN", "convencion": "max"},
-        {"path": "/API/MULTIAPI/*/stan_ai", "convencion": "mixto_max"},
-    ]
-```
-
-Sobre mayúsculas y minúsculas: ParamsX **no renombra ni fuerza el case de los parámetros que ya existen**, los lee y edita tal cual estén. El `case_ruta` del perfil solo entra en juego al crear parámetros nuevos.
+Y ParamsX **no renombra ni fuerza el case de los parámetros que ya existen**: los lee y edita tal cual estén. El `case_ruta` del perfil solo entra en juego al crear parámetros nuevos.
 
 ### Un fichero por ruta: `fichero_por_ruta`
 
@@ -342,7 +356,17 @@ En algunos sistemas (especialmente en entornos corporativos como Windows), el PA
 ```source ~/.zshrc    # Para zsh```
 
 Una vez instalado, verifica que el comando paramsx esté disponible ejecutando:
-```paramsx --help```
+```paramsx --version```
+
+Comandos disponibles:
+
+| Comando | Qué hace |
+|---|---|
+| `paramsx` | Abre el menú interactivo (necesita configuración). |
+| `paramsx configure` | Crea la configuración la primera vez; si ya existe, la revisa sin tocarla. |
+| `paramsx configure --ejemplo` | Además deja la plantilla de esta versión al lado, para comparar. |
+| `paramsx --version` | Versión instalada. |
+| `paramsx --help` | Ayuda, con el resumen de todas las opciones de configuración. |
 
 
 ## Modo de empleo

{paramsx-2.2.0 → paramsx-2.2.1}/README.md

@@ -108,11 +108,55 @@ Este comando creará automáticamente una carpeta de configuración en tu direct
 
 Dentro de esta carpeta, encontrarás el archivo paramsx_config.py. Este archivo contiene la configuración inicial que debes ajustar según tu entorno.
 
+Si ya tenías configuración de una versión anterior, `paramsx configure` **no la sobrescribe**: te dice qué opciones nuevas no tienes y con qué valor por defecto se están rellenando, y si la configuración es válida. Con `paramsx configure --ejemplo` además deja la plantilla de esta versión en `paramsx_config.ejemplo.py`, al lado de la tuya, para que compares sin tocar nada.
+
 Ejemplo del contenido de paramsx_config.py:
 
 ```python
 ## Configuraciones ParamsX
 
+# --- Perfiles de naming -------------------------------------------------------------
+# 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:
+#
+#   campo             | valores                                  | qué decide
+#   ------------------+------------------------------------------+---------------------------
+#   posicion_entorno  | inicio | final | mixto | ninguno          | dónde va el entorno
+#   case_entorno      | lower | upper | capitalize                | cómo se escribe el entorno
+#   case_ruta         | lower | upper | capitalize | ninguno      | case de la ruta AL CREAR
+#
+# posicion_entorno -> dónde se coloca el entorno (ejemplos con el entorno 'dev'):
+#
+#   valor    | ruta declarada  | ruta real en AWS
+#   ---------+-----------------+--------------------------------------------------------
+#   inicio   | /rds            | /dev/rds
+#   final    | /API/STA        | /API/STA/DEV
+#   mixto    | /API/*/STA      | /API/DEV/STA    el '*' marca el sitio; uno y como segmento
+#   ninguno  | /api/sta/auth   | /api/sta/auth   una cuenta AWS por entorno; case_entorno da igual
+#
+# case_entorno -> cómo se escribe ese entorno en la ruta:
+#
+#   valor       | 'dev' se escribe | ruta real de /API/STA con posicion_entorno=final
+#   ------------+------------------+------------------------------------------------
+#   lower       | dev              | /API/STA/dev
+#   upper       | DEV              | /API/STA/DEV
+#   capitalize  | Dev              | /API/STA/Dev
+#
+# case_ruta -> a qué case se fuerza la ruta que TÚ escribes al CREAR un parámetro
+# (opción 4 del menú). No afecta a leer ni a editar: lo que ya existe en AWS se
+# respeta siempre tal cual esté.
+#
+#   valor       | si escribes /API/MULTIAPI/Token, se crea
+#   ------------+-----------------------------------------
+#   lower       | /api/multiapi/token
+#   upper       | /API/MULTIAPI/TOKEN
+#   capitalize  | /Api/Multiapi/Token
+#   ninguno     | /API/MULTIAPI/Token
+#
+# Combina los tres campos como necesites: no hay una lista cerrada de perfiles. En el
+# README tienes más ejemplos.
+
 naming = {
     "min": {"posicion_entorno": "inicio", "case_entorno": "lower", "case_ruta": "lower"},
     "max": {"posicion_entorno": "final", "case_entorno": "upper", "case_ruta": "ninguno"},
@@ -130,97 +174,67 @@ configuraciones = {
         {"path": "/rds", "convencion": "min"},         # -> /dev/rds
         {"path": "/EMAIL", "convencion": "max"},       # -> /EMAIL/DEV
         {"path": "/API/STA", "convencion": "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
     ]
 }
 
+# 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"
 
+# ¿El nombre del fichero exportado incluye la ruta leída?
+#   False -> parameters_dev.py            (comportamiento de siempre)
+#   True  -> parameters_dev__API_STA__max.py  (uno por entrada y entorno: lleva el
+#            entorno, la ruta y el perfil, porque dos entradas pueden compartir ruta)
+# Ponlo en True si sueles leer varias rutas del mismo entorno y no quieres que la
+# segunda lectura te machaque el fichero de la primera.
 fichero_por_ruta = False
 
 
 ## Configuraciones Tags
 
+# Gestionar las tags de los parámetros: leerlas de AWS, exponerlas en el fichero
+# exportado para editarlas y validar las obligatorias al cargar.
+#   True  -> las tags viajan en el fichero y se validan.
+#   False -> no aparecen tags en el fichero y no se valida nada.
+# En cuentas cuyo control de acceso va por tags (ABAC vía IAM) esto debe estar en True.
 tags_activas = True
 
+# Solo aplica si tags_activas = True.
+#   False -> validación bloqueante: si a un parámetro le falta alguna tag obligatoria
+#            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
 
+# Tags que se exigen en cada parámetro cuando tags_activas = True. La lista es libre:
+# estas 8 son las que sostienen el control de acceso ABAC vía IAM de nuestra cuenta.
 tags_obligatorias = [
-    "Application", "Environment", "Owner", "Project",
-    "Product", "Service", "Component", "ManagedBy",
+    "Application",
+    "Environment",
+    "Owner",
+    "Project",
+    "Product",
+    "Service",
+    "Component",
+    "ManagedBy",
 ]
 ```
 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
 
-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.
-
-Un perfil tiene tres campos:
-
-| Campo | Valores | Qué decide |
-|---|---|---|
-| `posicion_entorno` | `inicio` \| `final` \| `mixto` \| `ninguno` | Dónde va el entorno dentro de la ruta. |
-| `case_entorno` | `lower` \| `upper` \| `capitalize` | Cómo se escribe el entorno. |
-| `case_ruta` | `lower` \| `upper` \| `capitalize` \| `ninguno` | Case de la ruta al crear parámetros. |
-
-Y en detalle:
-
-**`posicion_entorno`** — dónde se coloca el entorno, con el entorno `dev`:
-
-| Valor | Ruta declarada | Ruta real en AWS | |
-|---|---|---|---|
-| `inicio` | `/rds` | `/dev/rds` | |
-| `final` | `/API/STA` | `/API/STA/DEV` | |
-| `mixto` | `/API/*/STA` | `/API/DEV/STA` | el `*` marca el sitio |
-| `ninguno` | `/api/sta/auth` | `/api/sta/auth` | una cuenta AWS por entorno |
-
-**`case_entorno`** — cómo se escribe ese entorno en la ruta:
-
-| Valor | `dev` se escribe | `/API/STA` con `posicion_entorno: final` |
-|---|---|---|
-| `lower` | `dev` | `/API/STA/dev` |
-| `upper` | `DEV` | `/API/STA/DEV` |
-| `capitalize` | `Dev` | `/API/STA/Dev` |
-
-**`case_ruta`** — a qué case se fuerza la ruta que escribes al **crear** un parámetro (opción 4). No afecta a leer ni a editar: lo que ya existe en AWS se respeta siempre tal cual esté.
-
-| Valor | Si escribes `/API/MULTIAPI/Token`, se crea |
-|---|---|
-| `lower` | `/api/multiapi/token` |
-| `upper` | `/API/MULTIAPI/TOKEN` |
-| `capitalize` | `/Api/Multiapi/Token` |
-| `ninguno` | `/API/MULTIAPI/Token` |
+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.
 
 **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.
 
-**`mixto` y el marcador `*`.** Cuando el entorno no va ni al principio ni al final, se marca su sitio con un `*` en la propia ruta. Es útil para acotar la lectura a un solo subárbol: con `/API/MULTIAPI/*/stan_ai` lees únicamente `/API/MULTIAPI/DEV/stan_ai`, en vez de todo lo que cuelga de `/API/MULTIAPI/DEV`. El `*` debe ser un segmento entero y aparecer **exactamente una vez**, y solo se admite en perfiles `mixto`: si el perfil y la ruta no cuentan la misma historia, ParamsX te lo dice al arrancar en vez de leer una ruta inexistente y devolverte una lista vacía.
-
-**`ninguno` y las cuentas sin entorno en la ruta.** Hay organizaciones que separan los entornos por cuenta de AWS y no meten `dev`/`prod` en el path. Con `posicion_entorno: "ninguno"` la ruta se usa tal cual; el selector de entorno del menú sigue existiendo, pero no toca la ruta. En este perfil el `case_entorno` es irrelevante, porque no se escribe ningún entorno.
+**Para qué sirve el `*`.** Además de colocar el entorno donde quieras, acota la lectura a un solo subárbol: con `/API/MULTIAPI/*/stan_ai` lees únicamente `/API/MULTIAPI/DEV/stan_ai`, en vez de todo lo que cuelga de `/API/MULTIAPI/DEV`. Debe ser un segmento entero, aparecer **exactamente una vez** y solo se admite en perfiles `mixto`: si el perfil y la ruta no cuentan la misma historia, ParamsX te lo dice al arrancar en vez de leer una ruta inexistente y devolverte una lista vacía.
 
-Ya **no existe** la lista `entornos_old`: el entorno se escribe siempre a partir de la lista canónica `entornos` (en minúscula), aplicándole el `case_entorno` del perfil. Si en tus rutas el entorno se llama `staging` en vez de `pre`, ponlo así en `entornos`.
+**Los entornos.** Ya no existe la lista `entornos_old`: el entorno sale siempre de la lista canónica `entornos` (en minúscula), aplicándole el `case_entorno` del perfil. Si en tus rutas se llama `staging` en vez de `pre`, ponlo así en `entornos`.
 
-Ejemplo completo de una `parameter_list` real, mezclando perfiles:
-
-```python
-    "parameter_list": [
-        {"path": "/common", "convencion": "min"},
-        {"path": "/rds", "convencion": "min"},
-        {"path": "/api", "convencion": "min"},
-        {"path": "/INFRA", "convencion": "max"},
-        {"path": "/API/STA", "convencion": "max"},
-        {"path": "/API/p15", "convencion": "max"},
-        {"path": "/API/MULTIAPI", "convencion": "max"},
-        {"path": "/APP/Alertas", "convencion": "max"},
-        {"path": "/BUCKETS", "convencion": "max"},
-        {"path": "/EMAIL", "convencion": "max"},
-        {"path": "/INFERENCIAS/TASA_DMI", "convencion": "max"},
-        {"path": "/CEE/CEXGEN", "convencion": "max"},
-        {"path": "/API/MULTIAPI/*/stan_ai", "convencion": "mixto_max"},
-    ]
-```
-
-Sobre mayúsculas y minúsculas: ParamsX **no renombra ni fuerza el case de los parámetros que ya existen**, los lee y edita tal cual estén. El `case_ruta` del perfil solo entra en juego al crear parámetros nuevos.
+Y ParamsX **no renombra ni fuerza el case de los parámetros que ya existen**: los lee y edita tal cual estén. El `case_ruta` del perfil solo entra en juego al crear parámetros nuevos.
 
 ### Un fichero por ruta: `fichero_por_ruta`
 
@@ -322,7 +336,17 @@ En algunos sistemas (especialmente en entornos corporativos como Windows), el PA
 ```source ~/.zshrc    # Para zsh```
 
 Una vez instalado, verifica que el comando paramsx esté disponible ejecutando:
-```paramsx --help```
+```paramsx --version```
+
+Comandos disponibles:
+
+| Comando | Qué hace |
+|---|---|
+| `paramsx` | Abre el menú interactivo (necesita configuración). |
+| `paramsx configure` | Crea la configuración la primera vez; si ya existe, la revisa sin tocarla. |
+| `paramsx configure --ejemplo` | Además deja la plantilla de esta versión al lado, para comparar. |
+| `paramsx --version` | Versión instalada. |
+| `paramsx --help` | Ayuda, con el resumen de todas las opciones de configuración. |
 
 
 ## Modo de empleo

paramsx-2.2.1/paramsx/__init__.py

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

{paramsx-2.2.0 → paramsx-2.2.1}/paramsx/main.py

@@ -7,6 +7,7 @@ import curses
 import importlib.util
 from botocore.exceptions import ClientError
 from . import paramsx_config as plantilla_config
+from . import __version__
 from .funcions import (
     draw_header, draw_footer, show_main_menu, show_comparison_results,
     show_environment_selection, show_message, show_parameter_selection,
@@ -47,13 +48,27 @@ Ya no existe 'entornos_old': el entorno se escribe a partir de la lista 'entorno
 que va siempre en minúscula, aplicándole el 'case_entorno' del perfil."""
 
 
-# Cargar configuraciones desde el archivo de usuario
-def load_config():
+# 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",
+    "tags_activas", "obligatorias_vacias", "tags_obligatorias",
+)
+
+
+# Ejecutar el fichero de configuración del usuario y devolver el módulo resultante
+def cargar_modulo_config():
     if not os.path.exists(CONFIG_PATH):
         raise FileNotFoundError(f"No se encontró el archivo de configuración en {CONFIG_PATH}")
     spec = importlib.util.spec_from_file_location("config", CONFIG_PATH)
     modulo = importlib.util.module_from_spec(spec)
     spec.loader.exec_module(modulo)
+    return modulo
+
+
+# Cargar configuraciones desde el archivo de usuario
+def load_config():
+    modulo = cargar_modulo_config()
 
     config = dict(modulo.configuraciones)
     # Todo lo que va fuera de 'configuraciones' es opcional en el fichero del usuario:
@@ -814,48 +829,141 @@ def main(stdscr, config=None):
 
 
 # Función para crear la configuración inicial
-def create_config():
+def create_config(escribir_ejemplo=False):
     config_dir = os.path.expanduser("~/.xsoft")
     os.makedirs(config_dir, exist_ok=True)
 
     config_file = os.path.join(config_dir, "paramsx_config.py")
-    if os.path.exists(config_file):
-        print(f"El archivo de configuración ya existe en {config_file}. No se sobrescribirá.")
-    else:
+    if not os.path.exists(config_file):
         # Se copia la plantilla del paquete para no duplicar el formato en dos sitios
         shutil.copyfile(PLANTILLA_PATH, config_file)
-        print(f"Archivo de configuración creado en {config_file}. Por favor, edítalo con tus valores personalizados.")
+        print(f"Archivo de configuración creado en {config_file}.")
+        print("Ábrelo y ajústalo con tus valores: viene con cada opción comentada.")
+        return
+
+    # Con configuración ya hecha no se toca NADA: solo se revisa y se informa.
+    print(f"Ya tienes configuración en {config_file}, no se sobrescribe.")
+    print()
+    revisar_config(config_file)
+
+    ejemplo_file = os.path.join(config_dir, "paramsx_config.ejemplo.py")
+    if escribir_ejemplo:
+        shutil.copyfile(PLANTILLA_PATH, ejemplo_file)
+        print(f"\nPlantilla de esta versión escrita en {ejemplo_file}.")
+        print("Es solo una referencia para comparar: ParamsX no la lee.")
+    else:
+        print("\nPara dejar la plantilla de esta versión al lado de la tuya y comparar:")
+        print("  paramsx configure --ejemplo")
+
+
+# Valor por defecto en una línea: el repr de 'naming' o de las tags ocupa media pantalla
+def resumir_valor(valor):
+    if isinstance(valor, dict):
+        return f"{len(valor)} perfiles ({', '.join(valor)})"
+    if isinstance(valor, (list, tuple)):
+        elementos = ", ".join(str(v) for v in valor)
+        if len(elementos) > 50:
+            elementos = ", ".join(str(v) for v in list(valor)[:3]) + ", ..."
+        return f"{len(valor)} elementos ({elementos})"
+    return repr(valor)
+
+
+# Revisar una configuración existente sin modificarla: qué opciones nuevas le faltan
+# (que no son un error, se usa el valor por defecto) y qué está mal de verdad.
+def revisar_config(config_file):
+    try:
+        modulo = cargar_modulo_config()
+    except Exception as e:
+        print(f"No se ha podido leer: {e}")
+        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.")
+
+    if faltan:
+        print("Opciones que no tienes y que ParamsX rellena con el valor por defecto:")
+        for clave in faltan:
+            print(f"  {clave:20} -> {resumir_valor(getattr(plantilla_config, clave))}")
+        print("Añádelas solo si quieres cambiarlas; sin ellas todo sigue funcionando igual.")
+    else:
+        print("No te falta ninguna opción de esta versión.")
+
+    try:
+        # Validar SIN normalizar: normalize_config pasa 'entornos' a minúscula y se
+        # perdería el aviso de que están en mayúscula en el fichero del usuario.
+        errores, avisos = validate_config(load_config())
+    except Exception as e:
+        print(f"\nNo se ha podido validar: {e}")
+        return
+
+    if avisos:
+        print()
+        for aviso in avisos:
+            print(aviso)
+    if errores:
+        print("\nErrores que hay que corregir:\n")
+        for error in errores:
+            print(f"{error}\n")
+    else:
+        print("\nLa configuración es válida.")
+
+
+# Versión instalada del paquete; si se ejecuta desde el código fuente, la del módulo
+def version_actual():
+    try:
+        from importlib.metadata import version, PackageNotFoundError
+        try:
+            return version("paramsx")
+        except PackageNotFoundError:
+            return f"{__version__} (desde el código fuente, sin instalar)"
+    except ImportError:
+        return __version__
 
 # Mostrar ayuda
 def show_help():
+    # Texto plano, no f-string: lleva llaves literales de los dicts de ejemplo
     help_text = """
-ParamsX - Gestión de Parámetros de AWS SSM
+ParamsX __VERSION__ - Gestión de Parámetros de AWS SSM
 
 Comandos disponibles:
-  paramsx                Ejecuta el programa principal (requiere configuración previa).
-  paramsx configure      Crea el archivo de configuración inicial en ~/.xsoft/paramsx_config.py.
-  paramsx --help         Muestra esta ayuda.
+  paramsx                   Ejecuta el programa principal (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.
+  paramsx configure --ejemplo   Además deja la plantilla de esta versión al lado, como
+                            paramsx_config.ejemplo.py, para comparar sin tocar la tuya.
+  paramsx --version         Muestra la versión instalada.
+  paramsx --help            Muestra esta ayuda.
 
 Opciones del menú:
   1. Leer parámetros              Exporta a un fichero editable los parámetros de una ruta.
-  2. Cargar parámetros            Compara el fichero editado y aplica los cambios en AWS.
+  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'.
 
-Configuración (~/.xsoft/paramsx_config.py):
-  naming            Perfiles de naming. Cada uno dice dónde va el entorno en la ruta
-                    y cómo se escribe. Los nombres los eliges tú:
+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
+                    nombres los eliges tú y combinas estos tres campos:
                       posicion_entorno  'inicio'  /rds       -> /dev/rds
                                         'final'   /API/STA   -> /API/STA/DEV
-                                        'mixto'   /API/*/STA -> /API/dev/STA
+                                        'mixto'   /API/*/STA -> /API/DEV/STA
                                         'ninguno' /api/auth  -> /api/auth
                       case_entorno      'lower' | 'upper' | 'capitalize'
                       case_ruta         'lower' | 'upper' | 'capitalize' | 'ninguno'
-                                        (solo al crear parámetros)
+                                        (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.
-  fichero_por_ruta  True -> el fichero exportado incluye la ruta en su nombre, para
-                    que leer otra ruta del mismo entorno no machaque la anterior.
+  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
   tags_activas      True para gestionar las tags en el fichero exportado y validarlas.
                     (antes se llamaba 'abac'; ese nombre se sigue aceptando)
   tags_obligatorias Tags exigidas en cada parámetro cuando tags_activas = True.
@@ -868,23 +976,29 @@ Si necesitas más ayuda puedes leer el readme en GitHub o en Pypi:
 - https://pypi.org/project/paramsx/
 
 """
-    print(help_text)
+    print(help_text.replace("__VERSION__", version_actual()))
 
 # Entry point
 def entry_point():
     if len(sys.argv) > 1:
         command = sys.argv[1]
         if command in ["configure", "config", "configurar"]:
-            create_config()
+            create_config(escribir_ejemplo="--ejemplo" in sys.argv[2:])
             return
         elif command in ["--help", "-h"]:
             show_help()
             return
+        elif command in ["--version", "-v", "version"]:
+            print(f"paramsx {version_actual()}")
+            return
 
     # Verificar que exista el archivo de configuración
     if not os.path.exists(CONFIG_PATH):
-        print("Error: No se encontró el archivo de configuración.")
-        print("Usa 'paramsx configure' para crear uno automáticamente.")
+        print("ParamsX todavía no está configurado.")
+        print(f"No existe {CONFIG_PATH}.")
+        print()
+        print("Ejecuta 'paramsx configure': te crea el fichero con cada opción comentada")
+        print("para que lo ajustes con tu perfil de AWS, tus entornos y tus rutas.")
         return
 
     # Validar la configuración antes de entrar en la interfaz curses

{paramsx-2.2.0 → paramsx-2.2.1/paramsx.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: paramsx
-Version: 2.2.0
+Version: 2.2.1
 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
@@ -128,11 +128,55 @@ Este comando creará automáticamente una carpeta de configuración en tu direct
 
 Dentro de esta carpeta, encontrarás el archivo paramsx_config.py. Este archivo contiene la configuración inicial que debes ajustar según tu entorno.
 
+Si ya tenías configuración de una versión anterior, `paramsx configure` **no la sobrescribe**: te dice qué opciones nuevas no tienes y con qué valor por defecto se están rellenando, y si la configuración es válida. Con `paramsx configure --ejemplo` además deja la plantilla de esta versión en `paramsx_config.ejemplo.py`, al lado de la tuya, para que compares sin tocar nada.
+
 Ejemplo del contenido de paramsx_config.py:
 
 ```python
 ## Configuraciones ParamsX
 
+# --- Perfiles de naming -------------------------------------------------------------
+# 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:
+#
+#   campo             | valores                                  | qué decide
+#   ------------------+------------------------------------------+---------------------------
+#   posicion_entorno  | inicio | final | mixto | ninguno          | dónde va el entorno
+#   case_entorno      | lower | upper | capitalize                | cómo se escribe el entorno
+#   case_ruta         | lower | upper | capitalize | ninguno      | case de la ruta AL CREAR
+#
+# posicion_entorno -> dónde se coloca el entorno (ejemplos con el entorno 'dev'):
+#
+#   valor    | ruta declarada  | ruta real en AWS
+#   ---------+-----------------+--------------------------------------------------------
+#   inicio   | /rds            | /dev/rds
+#   final    | /API/STA        | /API/STA/DEV
+#   mixto    | /API/*/STA      | /API/DEV/STA    el '*' marca el sitio; uno y como segmento
+#   ninguno  | /api/sta/auth   | /api/sta/auth   una cuenta AWS por entorno; case_entorno da igual
+#
+# case_entorno -> cómo se escribe ese entorno en la ruta:
+#
+#   valor       | 'dev' se escribe | ruta real de /API/STA con posicion_entorno=final
+#   ------------+------------------+------------------------------------------------
+#   lower       | dev              | /API/STA/dev
+#   upper       | DEV              | /API/STA/DEV
+#   capitalize  | Dev              | /API/STA/Dev
+#
+# case_ruta -> a qué case se fuerza la ruta que TÚ escribes al CREAR un parámetro
+# (opción 4 del menú). No afecta a leer ni a editar: lo que ya existe en AWS se
+# respeta siempre tal cual esté.
+#
+#   valor       | si escribes /API/MULTIAPI/Token, se crea
+#   ------------+-----------------------------------------
+#   lower       | /api/multiapi/token
+#   upper       | /API/MULTIAPI/TOKEN
+#   capitalize  | /Api/Multiapi/Token
+#   ninguno     | /API/MULTIAPI/Token
+#
+# Combina los tres campos como necesites: no hay una lista cerrada de perfiles. En el
+# README tienes más ejemplos.
+
 naming = {
     "min": {"posicion_entorno": "inicio", "case_entorno": "lower", "case_ruta": "lower"},
     "max": {"posicion_entorno": "final", "case_entorno": "upper", "case_ruta": "ninguno"},
@@ -150,97 +194,67 @@ configuraciones = {
         {"path": "/rds", "convencion": "min"},         # -> /dev/rds
         {"path": "/EMAIL", "convencion": "max"},       # -> /EMAIL/DEV
         {"path": "/API/STA", "convencion": "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
     ]
 }
 
+# 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"
 
+# ¿El nombre del fichero exportado incluye la ruta leída?
+#   False -> parameters_dev.py            (comportamiento de siempre)
+#   True  -> parameters_dev__API_STA__max.py  (uno por entrada y entorno: lleva el
+#            entorno, la ruta y el perfil, porque dos entradas pueden compartir ruta)
+# Ponlo en True si sueles leer varias rutas del mismo entorno y no quieres que la
+# segunda lectura te machaque el fichero de la primera.
 fichero_por_ruta = False
 
 
 ## Configuraciones Tags
 
+# Gestionar las tags de los parámetros: leerlas de AWS, exponerlas en el fichero
+# exportado para editarlas y validar las obligatorias al cargar.
+#   True  -> las tags viajan en el fichero y se validan.
+#   False -> no aparecen tags en el fichero y no se valida nada.
+# En cuentas cuyo control de acceso va por tags (ABAC vía IAM) esto debe estar en True.
 tags_activas = True
 
+# Solo aplica si tags_activas = True.
+#   False -> validación bloqueante: si a un parámetro le falta alguna tag obligatoria
+#            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
 
+# Tags que se exigen en cada parámetro cuando tags_activas = True. La lista es libre:
+# estas 8 son las que sostienen el control de acceso ABAC vía IAM de nuestra cuenta.
 tags_obligatorias = [
-    "Application", "Environment", "Owner", "Project",
-    "Product", "Service", "Component", "ManagedBy",
+    "Application",
+    "Environment",
+    "Owner",
+    "Project",
+    "Product",
+    "Service",
+    "Component",
+    "ManagedBy",
 ]
 ```
 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
 
-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.
-
-Un perfil tiene tres campos:
-
-| Campo | Valores | Qué decide |
-|---|---|---|
-| `posicion_entorno` | `inicio` \| `final` \| `mixto` \| `ninguno` | Dónde va el entorno dentro de la ruta. |
-| `case_entorno` | `lower` \| `upper` \| `capitalize` | Cómo se escribe el entorno. |
-| `case_ruta` | `lower` \| `upper` \| `capitalize` \| `ninguno` | Case de la ruta al crear parámetros. |
-
-Y en detalle:
-
-**`posicion_entorno`** — dónde se coloca el entorno, con el entorno `dev`:
-
-| Valor | Ruta declarada | Ruta real en AWS | |
-|---|---|---|---|
-| `inicio` | `/rds` | `/dev/rds` | |
-| `final` | `/API/STA` | `/API/STA/DEV` | |
-| `mixto` | `/API/*/STA` | `/API/DEV/STA` | el `*` marca el sitio |
-| `ninguno` | `/api/sta/auth` | `/api/sta/auth` | una cuenta AWS por entorno |
-
-**`case_entorno`** — cómo se escribe ese entorno en la ruta:
-
-| Valor | `dev` se escribe | `/API/STA` con `posicion_entorno: final` |
-|---|---|---|
-| `lower` | `dev` | `/API/STA/dev` |
-| `upper` | `DEV` | `/API/STA/DEV` |
-| `capitalize` | `Dev` | `/API/STA/Dev` |
-
-**`case_ruta`** — a qué case se fuerza la ruta que escribes al **crear** un parámetro (opción 4). No afecta a leer ni a editar: lo que ya existe en AWS se respeta siempre tal cual esté.
-
-| Valor | Si escribes `/API/MULTIAPI/Token`, se crea |
-|---|---|
-| `lower` | `/api/multiapi/token` |
-| `upper` | `/API/MULTIAPI/TOKEN` |
-| `capitalize` | `/Api/Multiapi/Token` |
-| `ninguno` | `/API/MULTIAPI/Token` |
+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.
 
 **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.
 
-**`mixto` y el marcador `*`.** Cuando el entorno no va ni al principio ni al final, se marca su sitio con un `*` en la propia ruta. Es útil para acotar la lectura a un solo subárbol: con `/API/MULTIAPI/*/stan_ai` lees únicamente `/API/MULTIAPI/DEV/stan_ai`, en vez de todo lo que cuelga de `/API/MULTIAPI/DEV`. El `*` debe ser un segmento entero y aparecer **exactamente una vez**, y solo se admite en perfiles `mixto`: si el perfil y la ruta no cuentan la misma historia, ParamsX te lo dice al arrancar en vez de leer una ruta inexistente y devolverte una lista vacía.
-
-**`ninguno` y las cuentas sin entorno en la ruta.** Hay organizaciones que separan los entornos por cuenta de AWS y no meten `dev`/`prod` en el path. Con `posicion_entorno: "ninguno"` la ruta se usa tal cual; el selector de entorno del menú sigue existiendo, pero no toca la ruta. En este perfil el `case_entorno` es irrelevante, porque no se escribe ningún entorno.
+**Para qué sirve el `*`.** Además de colocar el entorno donde quieras, acota la lectura a un solo subárbol: con `/API/MULTIAPI/*/stan_ai` lees únicamente `/API/MULTIAPI/DEV/stan_ai`, en vez de todo lo que cuelga de `/API/MULTIAPI/DEV`. Debe ser un segmento entero, aparecer **exactamente una vez** y solo se admite en perfiles `mixto`: si el perfil y la ruta no cuentan la misma historia, ParamsX te lo dice al arrancar en vez de leer una ruta inexistente y devolverte una lista vacía.
 
-Ya **no existe** la lista `entornos_old`: el entorno se escribe siempre a partir de la lista canónica `entornos` (en minúscula), aplicándole el `case_entorno` del perfil. Si en tus rutas el entorno se llama `staging` en vez de `pre`, ponlo así en `entornos`.
+**Los entornos.** Ya no existe la lista `entornos_old`: el entorno sale siempre de la lista canónica `entornos` (en minúscula), aplicándole el `case_entorno` del perfil. Si en tus rutas se llama `staging` en vez de `pre`, ponlo así en `entornos`.
 
-Ejemplo completo de una `parameter_list` real, mezclando perfiles:
-
-```python
-    "parameter_list": [
-        {"path": "/common", "convencion": "min"},
-        {"path": "/rds", "convencion": "min"},
-        {"path": "/api", "convencion": "min"},
-        {"path": "/INFRA", "convencion": "max"},
-        {"path": "/API/STA", "convencion": "max"},
-        {"path": "/API/p15", "convencion": "max"},
-        {"path": "/API/MULTIAPI", "convencion": "max"},
-        {"path": "/APP/Alertas", "convencion": "max"},
-        {"path": "/BUCKETS", "convencion": "max"},
-        {"path": "/EMAIL", "convencion": "max"},
-        {"path": "/INFERENCIAS/TASA_DMI", "convencion": "max"},
-        {"path": "/CEE/CEXGEN", "convencion": "max"},
-        {"path": "/API/MULTIAPI/*/stan_ai", "convencion": "mixto_max"},
-    ]
-```
-
-Sobre mayúsculas y minúsculas: ParamsX **no renombra ni fuerza el case de los parámetros que ya existen**, los lee y edita tal cual estén. El `case_ruta` del perfil solo entra en juego al crear parámetros nuevos.
+Y ParamsX **no renombra ni fuerza el case de los parámetros que ya existen**: los lee y edita tal cual estén. El `case_ruta` del perfil solo entra en juego al crear parámetros nuevos.
 
 ### Un fichero por ruta: `fichero_por_ruta`
 
@@ -342,7 +356,17 @@ En algunos sistemas (especialmente en entornos corporativos como Windows), el PA
 ```source ~/.zshrc    # Para zsh```
 
 Una vez instalado, verifica que el comando paramsx esté disponible ejecutando:
-```paramsx --help```
+```paramsx --version```
+
+Comandos disponibles:
+
+| Comando | Qué hace |
+|---|---|
+| `paramsx` | Abre el menú interactivo (necesita configuración). |
+| `paramsx configure` | Crea la configuración la primera vez; si ya existe, la revisa sin tocarla. |
+| `paramsx configure --ejemplo` | Además deja la plantilla de esta versión al lado, para comparar. |
+| `paramsx --version` | Versión instalada. |
+| `paramsx --help` | Ayuda, con el resumen de todas las opciones de configuración. |
 
 
 ## Modo de empleo

{paramsx-2.2.0 → paramsx-2.2.1}/setup.py

@@ -2,6 +2,7 @@ from setuptools import setup, find_packages
 from setuptools.command.install import install
 from distutils import log
 import os
+import re
 import sys
 import shutil
 import platform
@@ -73,10 +74,15 @@ class CustomInstallCommand(install):
 with open("README.md", "r", encoding="utf-8") as fh:
     long_description = fh.read()
 
+## La versión vive en paramsx/__init__.py, para que 'paramsx --version' y el paquete
+## no puedan decir cosas distintas. Se lee con regex para no importar el paquete aquí.
+with open("paramsx/__init__.py", "r", encoding="utf-8") as fh:
+    version = re.search(r'^__version__\s*=\s*"([^"]+)"', fh.read(), re.M).group(1)
+
 # Configuración del paquete
 setup(
     name="paramsx",
-    version="2.2.0",
+    version=version,
     packages=find_packages(),
     include_package_data=True,
     package_data={