yml

yml работает с компактным подмножеством YAML для конфигураций: вложенные mappings, скаляры и простые списки читаются, ищутся и изменяются по точечным путям.

ДанныеВерсия 1.1.6Стабильная
lil-terminal

Обзор

yml даёт компактную работу с распространёнными YAML-конфигурациями прямо в файле: точечные пути, поиск, изменение и удаление одного значения, проверка поддерживаемого подмножества и полный исходник через dump.

Отступы превращаются в точечный путь

Парсер намеренно строгий: табуляция и block-list строки вида - item не поддерживаются. Незнакомый YAML сначала проверяйте через -c; сложные документы лучше редактировать через edit или code.

Синтаксис

lil-terminal
yml <file> [key|options] · yml dump <file>

Справочник

yml <file>

показать данные YAML

yml <file> <key>

показать точное значение по точечному пути

yml dump <file>

показать нормализованный исходный текст YAML

-f <text|mask> [-k|-v]

найти совпадения в ключах или значениях; * и ? включают маску

-w <key> : <value>

записать значение прямо в файл

-w <key> < <file>

записать значение, прочитанное из другого файла

-d <key>

удалить значение по точечному пути

-c

проверить корректность файла YAML

Как читать, искать и менять настройки

Начните с yml config/app.yml — увидите параметры списком. Затем запросите database.host или найдите значение через -f. Флаг -k ищет только по именам, -v — только по значениям. Обычный текст ищется без учёта регистра, * и ? задают маску для всей строки. -c проверяет формат, dump показывает заново собранный текст файла.

-w <key> : <value> сразу записывает значение, -w <key> < <file> берёт его из другого файла, а -d <key> удаляет указанный путь. Числа, true и false могут распознаваться как типизированные значения; аккуратнее со строками из цифр. Перед записью сделайте копию. Символ $ обозначает последний открытый файл в Core; само имя файла может запускать назначенный обработчик.

Ограничения и безопасная правка

Поддерживаются YAML-словари с отступами и списки в стиле JSON, но не блочные списки - item, табуляция, якоря, псевдонимы, теги и многострочные блоки. Дубли ключей отклоняются. Запись пересоздаёт файл: комментарии и исходные пробелы исчезнут. Для сложного YAML выбирайте edit или code. В Minimum доступен только просмотр целого файла.

Интерактивный пример из `/sandbox/`

Запускайте подготовленные примеры прямо на странице. Результат заранее сформирован и показывается в браузере; команды терминала на сервере не выполняются.

Открыть файл и повторно использовать его через $

Установка и управление

Устанавливайте актуальную совместимую версию. Для полного набора возможностей выбирайте Base, для сокращённого — Minimum; уже установленный модуль обновляет команда upgrade.

Base и Minimum — два пакета одного текущего релиза модуля, а не разные версии команды.

Пакет Base

Установить полный пакет с локальной справкой и всеми опубликованными режимами.

install yml
Пакет Minimum

Установить сокращённый пакет без локальной справки; help <cmd> -i открывает актуальную серверную справку.

install yml -m
Точная публичная версия

Установить именно эту опубликованную версию.

install yml -v 1.1.6
Проверить или обновить

Поручить upgrade проверить совместимость и заменить установленный блок только при необходимости.

upgrade yml
Удалить модуль

Удалить блок расширения, не затрагивая ядро и остальные модули.

install yml -u

Примеры

Примеры можно копировать, но сайт их не выполняет. Перед запуском на реальном проекте проверьте пути, права и разрушающие флаги.

Открыть файл и повторно использовать его через $
cd \sandbox\config | yml app.yml
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Показать данные YAML
yml config/app.yml
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Показать точное значение по точечному пути
yml config/app.yml database.host
localhost
Показать точное значение по точечному пути
yml config/app.yml database.options.1
strict
Найти совпадения в ключах или значениях; * и ? включают маску
yml config/app.yml -f "database.*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Найти совпадения в ключах или значениях; * и ? включают маску
yml config/app.yml -f "strict" -v
database.options.1  strict
Найти совпадения в ключах или значениях; * и ? включают маску
yml config/app.yml -f "debug"
application.debug  true
Записать значение прямо в файл
yml config/app.yml -w application.debug : false
application.debug  false
Записать значение, прочитанное из другого файла
yml config/app.yml -w application.name < config/plain-value.txt
application.name  demo-site
Проверить отсутствующий файл
yml config/app.yml -d database.options.0
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  strict
Проверить корректность файла YAML
yml config/app.yml -c
Valid YAML
Показать нормализованный исходный текст YAML
yml dump config/app.yml
application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306
  options: ["utf8mb4","strict"]
Показать точное значение по точечному пути
yml config/app.yml unknown.key
Path not found
Проверить корректность файла YAML
yml config/invalid.yml -c
YAML block lists are not supported; use inline JSON-style lists
Показать данные YAML
yml config/missing.yml
File not found
Записать значение прямо в файл
yml config/app.yml -w database.port
Value required after : or

Файл из примера: sandbox/config/app.yml

Пример использует файл или каталог из защищённой учебной папки /sandbox/.

application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306
  options: ["utf8mb4", "strict"]

Связанная документация

Как установить модуль? →Почему команда отвечает «command not found»? →

Текущая публичная версия

v1.1.62026-11-01

Производственная доработка

Актуальная стабильная версия yml. yml работает с компактным подмножеством YAML для конфигураций: вложенные mappings, скаляры и простые списки читаются, ищутся и изменяются по точечным путям.

# История версий