`yml`

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

ДанныеВерсия 1.1.5Стабильная

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.ymlapplication.name lil-shop application.debug true database.host localhost database.port 3306 database.options.0 utf8mb4yml $ -cValid YAMLyml dump $application: name: lil-shop debug: true database: host: localhost

Обзор

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 <file>.

Поиск

-f ищет по путям и значениям. -k ограничивает поиск ключами, -v — значениями. Если запрос содержит * или ?, он трактуется как маска.

Прямое редактирование

-w сразу записывает изменение в файл. После : задаётся значение в строке, а < <file> читает значение из другого файла. -d удаляет один точечный путь.

Границы формата

Модуль намеренно поддерживает распространённое подмножество конфигурационного формата, типичное для shared hosting. Редкие возможности формата лучше править текстом через edit или code, чтобы не переосмысливать их молча.

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

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

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

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

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

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

Пакет Base

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

install yml

Пакет Minimum

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

install yml -m

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

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

install yml -v 1.1.5

Проверить или обновить

Поручить 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

app.yml

application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict

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

yml $ database.host

localhost

Yml · find-key

yml $ -f "database*" -k

database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict

Yml · find-value

yml $ -f "strict" -v

database.options.1  strict

Yml · write

yml $ -w database.password : "Ed1g!fs:13od"

database.password  Ed1g!fs:13od

Yml · delete

yml $ -d database.password

database.host  localhost
database.port  3306

Yml · validate

yml $ -c

Valid YAML

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

yml dump $

application:
  name: lil-shop
  debug: true
database:
  host: localhost
  port: 3306

Проверить отсутствующий файл

yml \sandbox\config\missing.yml

Файл не найден

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

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

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

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

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

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

v1.1.52026-08-13

Единая справка структурированных данных

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

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

yml