Jamie-BitFlight/transformación-de-datos

Transformación de Datos con Dasel v3

<when_to_use>

Activa este skill cuando:

• Modifiques valores en archivos de configuración (YAML, TOML, JSON, XML, HCL, INI)
• Conviertas entre formatos de datos (JSON a YAML, TOML a JSON, etc.)
• Actualices elementos de arreglos por lotes (precios, versiones, banderas)
• Añadas, elimines o reestructures estructuras de datos
• Fusiones objetos o construyas nuevas estructuras a partir de datos existentes

</when_to_use>

Reglas de Seguridad

NUNCA redirijas la salida al mismo archivo de entrada. Esto trunca el archivo antes de que dasel lo lea, lo que resulta en pérdida de datos:

# INCORRECTO — destruye la entrada
cat config.yaml | dasel -i yaml --root 'port = 9090' > config.yaml

# CORRECTO — escribe a un temporal, luego renombra
cat config.yaml | dasel -i yaml --root 'port = 9090' > config_tmp.yaml && mv config_tmp.yaml config.yaml

Siempre verifica antes de sobrescribir. Previsualiza la salida de la transformación primero, luego redirige:

# Previsualizar
cat config.yaml | dasel -i yaml --root 'server.port = 9090'
# Aplicar
cat config.yaml | dasel -i yaml --root 'server.port = 9090' > config_tmp.yaml && mv config_tmp.yaml config.yaml

Sintaxis Central de Modificación

En dasel v3, los subcomandos put y delete no existen. Todas las modificaciones usan expresiones de asignación con --root para emitir el documento completo.

Establecer un Valor

# Emite el documento completo con un campo cambiado
cat config.yaml | dasel -i yaml --root 'server.port = 9090'

# Asignaciones numéricas, booleanas y de cadena
echo '{"count": 1}' | dasel -i json --root 'count = 42'
echo '{"enabled": false}' | dasel -i json --root 'enabled = true'
echo '{"name": "old"}' | dasel -i json --root 'name = "new"'

Establecer Valores Anidados

cat config.yaml | dasel -i yaml --root 'database.connection.host = "db.example.com"'
cat config.yaml | dasel -i yaml --root 'database.connection.port = 5432'

Modificación en el Lugar (Patrón Seguro)

# Actualización de un solo campo
cat config.yaml | dasel -i yaml --root 'server.port = 9090' > config_tmp.yaml && mv config_tmp.yaml config.yaml

# Múltiples campos — encadena con punto y coma
cat config.yaml | dasel -i yaml --root 'server.port = 9090; server.host = "0.0.0.0"' > config_tmp.yaml && mv config_tmp.yaml config.yaml

Conversión de Formatos

Usa tuberías con dasel y diferentes banderas de formato de entrada/salida:

# JSON a YAML
cat data.json | dasel -i json -o yaml > data.yaml

# YAML a TOML
cat config.yaml | dasel -i yaml -o toml > config.toml

# JSON a XML
cat data.json | dasel -i json -o xml > data.xml

# TOML a JSON
cat config.toml | dasel -i toml -o json > config.json

# CSV a JSON
cat data.csv | dasel -i csv -o json > data.json

Operaciones con Arreglos

Añadir a un Arreglo

# Agrega un elemento al final del arreglo
echo '[1,2,3]' | dasel -i json --root '[$this..., 4]'
# Salida: [1, 2, 3, 4]

# Añade un objeto a un arreglo
cat data.json | dasel -i json --root 'items = [$root.items..., {"name": "new", "value": 42}]'

Actualización por Lotes con each

# Multiplica todos los precios por 1.1 (incremento del 10%)
cat data.json | dasel -i json --root 'items.each(price = price * 1.1)'

# Establece una bandera en todos los elementos
cat data.json | dasel -i json --root 'users.each(active = true)'

# Incrementa todos los valores
echo '[1,2,3]' | dasel -i json --root 'each($this = $this + 1)'

Filtrar Luego Transformar

# Obtén solo los usuarios activos, luego extrae los nombres
cat data.json | dasel -i json 'users.filter(active == true).map(name)'

Operaciones con Objetos

Fusión mediante Spread

# Agrega una nueva clave a un objeto existente
cat base.json | dasel -i json --root '{ $root..., "newKey": "value" }'

# Fusiona dos objetos
cat base.json | dasel -i json --root '{ $root..., "extra": true, "version": 2 }'

Eliminación de Campos mediante Reconstrucción

Dado que v3 no tiene un comando delete, elimina campos construyendo un nuevo objeto solo con las claves deseadas:

# Conserva solo "name" y "email", elimina todo lo demás
echo '{"name":"a","email":"b","password":"c"}' | dasel -i json --root '{ name, email }'

Renombrar Campos mediante Reconstrucción

echo '{"old_name": "value"}' | dasel -i json --root '{ "new_name": old_name }'

Transformaciones de Múltiples Pasos

Usa asignación de variables y punto y coma para operaciones complejas:

# Almacena el resultado intermedio en una variable, luego transforma
cat data.json | dasel -i json '$active = users.filter(active == true); $active.map(name)'

# Múltiples variables
cat data.json | dasel -i json '$a = items.filter(price > 100); $b = $a.map(name); $b'

Transformación Condicional

# Establece un valor basado en una condición
cat data.json | dasel -i json --root 'if(count > 5) { status = "many" } else { status = "few" }'

Patrones de Transformación

Para patrones de transformación detallados por caso de uso (actualizaciones de configuración, procesamiento por lotes, migración de formatos, reestructuración de datos, manejo de errores), consulta Patrones de Transformación.

Referencias

• Documentación de Dasel v3 (obtenida el 2026-02-19)
• Operador Spread de Dasel (obtenida el 2026-02-19)
• Función each() de Dasel (obtenida el 2026-02-19)
• Función filter() de Dasel (obtenida el 2026-02-19)
• CHANGELOG de Dasel (obtenida el 2026-02-19)