Variables
Recuerda que un programa de jq es un pipeline de expresiones.
La asignación de variables sigue esta regla: una asignación de variable es una expresión con esta forma:
... | expr as $varname | ...
La salida del filtro es la entrada
Al igual que la expresión de identidad ., la salida de la asignación de variable es la misma que su entrada.
Establecer el valor de la variable es un efecto secundario.
Ejemplo que muestra que . después de la asignación es igual que la entrada inicial:
$ jq -c -n '42 | (. * 2) as $double | [., $double]'
[42,84]
Scope de las variables
El scope de la variable es «léxico»: la variable estará en scope durante el resto del pipeline.
Las variables definidas en funciones (ya llegaremos a las funciones) son «locales» a la función.
Nombres de las variables
La variable debe empezar por $.
El resto del nombre de la variable es un identificador: empieza por una letra o un guion bajo, seguido de letras, números o guiones bajos.
Asignación por desestructuración
Del manual:
Se pueden declarar varias variables con una única expresión as proporcionando un patrón que coincide con la estructura de la entrada (esto se conoce como «desestructuración»).
Ejemplos:
[1, 2, 3] as [$a, $b, $c]
| [$a, $b, $c] # => [1, 2, 3]
{"foo": "bar", "len": [10, 20]} as {foo: $f, len: [$h, $w]}
| [$f, $h, $w] # => ["bar", 10, 20]
Hacer coincidir el nombre de la variable con la clave del objeto ofrece un atajo:
{"x": 4, "y": 7} as {$x, $y}
| [$x, $y] # => [4, 7]
{"foo": "bar", "len": [10, 20]} as {$foo, $len}
| [$foo, $len] # => ["bar", [10, 20]]
El mismo atajo funciona en el sentido inverso para la construcción de objetos
4 as $x | 7 as $y | {$x, $y} # => {"x":4, "y": 7}
Constantes
Como se muestra en el ejemplo anterior, las variables resultan útiles para almacenar constantes.
Es mejor dar un nombre a las constantes en lugar de que aparezcan «números mágicos» en el código.
A menudo es más legible omitir las variables.
Considera el cálculo de la media de un array de números
[2, 4, 8, 7]
| add as $sum
| length as $len
| $sum / $len
en comparación con
[2, 4, 8, 7] | add / length
Esto pone de relieve uno de los aspectos más potentes de jq: la entrada de un filtro se proporciona a todas las subexpresiones:
- el array de entrada
[2,4,8,7] se pasa a add (que suma los números aplicando el operador + a todos los elementos)
-
en paralelo,
[2,4,8,7] también se pasa a length
- cuando estas subexpresiones terminan, sus resultados se dividen, lo que devuelve el valor medio de los números del array de entrada.
Operadores de jq que necesitarás para el ejercicio de aprendizaje
Operador alternativo: //
La expresión a // b produce b si a es falso o null; en caso contrario, produce a.
En el contexto de asignar una variable, resulta muy útil para proporcionar un valor predeterminado:
(.input.theAnswer // 42) as $answer | ...
Operadores aritméticos
-
+, - y * son los operadores habituales de suma, resta y multiplicación de números.
Ejercicio de aprendizaje
