catnose 1.1.0

Declarative JSON-to-JSON transformation engine with a built-in template language

Motor de transformación declarativa de JSON con lenguaje de plantillas integrado.

Instalación

pip install catnose

Uso rápido

API

from catnose import transform

items = [{"id": 1, "first_name": "Ana", "role": "admin"}]

mapper = {
  "id":   "id",
  "name": "first_name",
  "role": {
    "_cases": {
      "admin": "Administrador",
      "user":  "Usuario",
      "_default": "Otro"
    }
  },
  "label": {"_value": "{{ name }} ({{ role }})"}
}

result = transform(items, mapper)
# [{"id": 1, "name": "Ana", "role": "Administrador", "label": "Ana (Administrador)"}]

CLI

catnose input.json transform.json
catnose input.json transform.json -o output.json

La entrada puede ser un array JSON o un objeto JSON. Si es un objeto, se trata como una lista de un único elemento y recibe _rownum = 1.

Formato del mapeador

El JSON transformado parte de un objeto vacío; sólo se incluyen los campos declarados explícitamente. El JSON original actúa como contexto de evaluación junto con los campos ya calculados (en orden de definición).

{
  "<campo_destino>": "<campo_origen>",
  "<campo_destino>": {
    "_name":   "<campo_origen>",
    "_cases":  {"v1": "nuevo_v1", "_default": "<por_defecto>"},
    "_value":  "cadena con {{ expr }}"
  },
  "<campo_lista>": {
    "<sub_campo>": {
      "_name":  "<campo_origen>",
      "_cases": {"v1": "nv1"},
      "_value": "{{ expr }}"
    }
  }
}

Clave	Descripción
"<campo>": "<origen>"	Shorthand — copia el valor de <origen> del JSON original
_name	Campo fuente en el JSON original (por defecto: la clave del mapper)
_cases	Tabla de sustitución de valores; _default se usa si no hay coincidencia
_value	Plantilla evaluada con el motor de expresiones

Un mapping dict sin ninguna clave de control (_name, _cases, _value) se trata como lista de objetos, aplicando los sub-mapeos a cada elemento.

Motor de plantillas

Las expresiones _value usan la sintaxis {{ expr }} con evaluación Python completa. También se soportan bloques {% for %}, {% if %} / {% else %} / {% endif %}:

{
  "summary": {"_value": "{{ title.upper() }} — {{ cwss_score }} puntos"},
  "tags":    {"_value": "{% for t in tags %}[{{ t }}]{% endfor %}"}
}

El contexto de evaluación incluye:

• Todos los campos del JSON original
• Los campos ya calculados por mappings anteriores (en orden)
• _rownum (1..N, posición del elemento en el array; si la entrada es un objeto único, vale 1)

Para campos de tipo lista, el contexto incluye además los campos de cada elemento de la lista.

Historial de cambios

1.1.0

• transform acepta ahora un objeto JSON (dict) además de un array. Si la entrada es un objeto, devuelve un objeto en lugar de una lista.
• CLI actualizado para admitir ficheros de entrada que sean un objeto JSON único, asignándole _rownum = 1.

1.0.1

• Añadido logotipo del proyecto.

1.0.0

• rownum renombrado a _rownum en el contexto de evaluación para evitar colisiones con campos del JSON original.
• _parse_list eliminada del API pública (era un detalle de implementación interno).

0.0.1

• Versión inicial: motor de transformación declarativa, motor de plantillas {{ expr }} / {% for %} / {% if %}, y CLI.

Licencia

MIT