Рецепты jqExplained

65 of 65 rows

Фильтр↕	Что даёт↕
Доступ
⤢.	Весь ввод, красиво отформатированный.
⤢.key .a.b	Значение по ключу или вложенным ключам.
⤢.["key"]	Значение по ключу, имя которого содержит спецсимволы.
⤢.[0]	Первый элемент массива (отрицательный индекс считает с конца).
⤢.[]	Каждый элемент массива или каждое значение объекта, на отдельной строке.
⤢.key?	Значение по ключу или null, без ошибки, когда ключ отсутствует.
Фильтрация и выбор
⤢select(cond)	Ввод без изменений, если cond истинно, иначе ничего.
⤢map(expr)	Применяет expr к каждому элементу массива и собирает результаты.
⤢keys values	Отсортированные имена ключей или значения объекта в виде массива.
⤢length	Длина массива или строки, либо количество ключей в объекте.
⤢[ .[] | select(.age > 18) ]	Только элементы, у которых age больше 18, одним массивом.
Коллекции
⤢any all	Истина, когда хотя бы один или когда каждый элемент истинен либо проходит фильтр.
⤢has(k) in(o)	Истина, когда ключ k существует в объекте; in выполняет тот же тест со стороны ключа.
⤢first last limit(n; f)	Первый элемент, последний или только первые n результатов f.
⤢min max	Наименьшее или наибольшее значение в массиве.
⤢range(n)	Числа от 0 до n, каждое отдельным результатом.
⤢flatten	Вложенные массивы, свёрнутые в один плоский массив.
⤢contains(x) inside(y)	Истина, когда x встречается где-то во вводе; inside меняет роли местами.
⤢walk(f)	Применяет f к каждому значению снизу вверх, затем пересобирает весь ввод.
Преобразование
⤢map(.price)	Массив только из поля price каждого элемента.
⤢add	Сумма массива чисел или слияние массива объектов.
⤢tostring tonumber	Приводит значение к строке или числовую строку к числу.
⤢@json @base64	Кодирует ввод как JSON-строку или base64.
⤢ascii_downcase	Строка в нижнем регистре.
Строки
⤢"\(expr)"	Строка со значением expr, вплетённым в текст.
⤢gsub(re; s) sub(re; s)	Заменяет каждое совпадение шаблона или только первое на s.
⤢split(s) join(s)	Разбивает строку в массив по разделителю или склеивает массив в одну строку.
⤢test(re) match(re) capture(re)	Проверяет строку на шаблон или извлекает совпадения и именованные группы.
⤢ltrimstr(s) rtrimstr(s)	Срезает префикс или суффикс, только когда он присутствует.
⤢startswith(s) endswith(s)	Истина или ложь: строка начинается или заканчивается на s.
⤢ascii_upcase	Строка в верхнем регистре.
⤢@csv @tsv @sh	Массив, кодированный как CSV-строка, TSV-строка или экранированные аргументы оболочки.
Сборка
⤢{ id, name }	Новый объект только с полями id и name из ввода.
⤢[ .items[] | .name ]	Массив значений name каждого элемента.
⤢to_entries	Массив объектов {key, value}, полученный из объекта.
⤢from_entries	Объект, собранный из массива объектов {key, value}.
⤢group_by(.cat)	Элементы, сгруппированные в подмассивы по их полю cat.
⤢sort_by(.x) unique_by(.id)	Сортирует по полю или оставляет один элемент на каждый уникальный id.
Обновление и пути
⤢.key |= f	Обновляет значение по ключу, применяя к нему f.
⤢.key = v	Перезаписывает значение по ключу значением v.
⤢.count += n	Прибавляет n к значению count на месте.
⤢getpath(p) setpath(p; v) delpaths(ps)	Читает, записывает или удаляет значения по путям, заданным как массивы.
Управление и логика
⤢if c then a else b end	a, если c истинно, иначе b, с elif для дополнительных ветвей.
⤢try f catch g	Выполняет f, а при сбое f выполняет g с сообщением об ошибке.
⤢error(msg)	Останавливается с ошибкой, несущей msg, если только try её не перехватит.
⤢empty	Никакого вывода; эта ветвь просто исчезает из результатов.
⤢and or not	Объединяет значения истинности или инвертирует одно.
Продвинутое
⤢reduce .[] as $x (0; . + $x)	Свёртывает весь массив в одну накопительную сумму.
⤢foreach .[] as $x (a; u; e)	Как reduce, но выдаёт состояние после каждого шага, а не только последнее.
⤢input inputs	Следующий ввод или все оставшиеся вводы, подтянутые внутри фильтра.
⤢tojson fromjson	Значение как JSON-текст или JSON-текст, разобранный обратно в значение.
⤢@base64d	Base64-текст, декодированный обратно в исходную строку.
⤢.a.b[0] = v	Присваивание глубоко в структуре, создающее недостающие уровни по пути.
⤢a // b	a, если оно не null и не ложь, иначе b (значение по умолчанию).
⤢del(.key)	Ввод с одним удалённым ключом.
⤢paths	Каждый путь во вводе как массив ключей, сверху вниз.
Переменные и CLI
⤢--arg name val	Определяет $name как строку оболочки, используемую внутри фильтра.
⤢--argjson name val	Определяет $name из сырого JSON — для чисел, булевых значений, массивов или объектов.
⤢--slurpfile name file	Определяет $name как всё содержимое JSON-файла.
⤢-r	Печатает строковые результаты как есть, без кавычек и экранирования.
⤢-c	Печатает каждый результат компактно в одну строку, без отступов.
⤢-n	Запускает фильтр один раз на null, чтобы построить вывод из ничего.
⤢-s	Читает весь ввод в один массив до запуска фильтра.
⤢-e	Задаёт код выхода по последнему результату, чтобы shell-скрипты могли его проверять.
⤢env.VAR	Значение переменной окружения, прочитанное внутри фильтра.