toml

toml читает и изменяет распространённое подмножество TOML: таблицы, точечные ключи, скалярные значения и простые списки. Проверка и запись выполняются непосредственно в выбранном файле.

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

Обзор

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

Таблицы превращаются в точечные пути

Таблица [database] с ключом host доступна как database.host. Парсер намеренно рассчитан на типичные конфигурации хостинга; сложные конструкции TOML лучше редактировать как текст, а не заставлять команду переосмысливать их.

Синтаксис

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

Справочник

toml <file>

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

toml <file> <key>

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

toml dump <file>

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

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

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

-w <key> : <value>

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

-w <key> < <file>

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

-d <key>

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

-c

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

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

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

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

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

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

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

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

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

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

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

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

Пакет Base

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

install toml
Пакет Minimum

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

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

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

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

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

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

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

install toml -u

Примеры

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

Открыть файл и повторно использовать его через $
cd \sandbox\config | toml app.toml
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Показать данные TOML
toml config/app.toml
application.name    lil-shop
application.debug   true
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Показать точное значение по точечному пути
toml config/app.toml database.host
localhost
Показать точное значение по точечному пути
toml config/app.toml database.options.0
utf8mb4
Найти совпадения в ключах или значениях; * и ? включают маску
toml config/app.toml -f "database.*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Найти совпадения в ключах или значениях; * и ? включают маску
toml config/app.toml -f "strict" -v
database.options.1  strict
Найти совпадения в ключах или значениях; * и ? включают маску
toml config/app.toml -f "debug"
application.debug  true
Записать значение прямо в файл
toml config/app.toml -w database.port : 3307
database.port  3307
Записать значение, прочитанное из другого файла
toml config/app.toml -w application.name < config/plain-value.txt
application.name  demo-site
Проверить отсутствующий файл
toml config/app.toml -d application.debug
application.name    lil-shop
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Проверить корректность файла TOML
toml config/app.toml -c
Valid TOML
Показать нормализованный исходный текст TOML
toml dump config/app.toml
[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
options = ["utf8mb4","strict"]
Показать точное значение по точечному пути
toml config/app.toml unknown.key
Path not found
Проверить корректность файла TOML
toml config/invalid.toml -c
Duplicate TOML key
Показать данные TOML
toml config/missing.toml
File not found
Записать значение прямо в файл
toml config/app.toml -w database.port
Value required after : or

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

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

[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
options = ["utf8mb4", "strict"]

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

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

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

v1.1.62026-11-01

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

Актуальная стабильная версия toml. toml читает и изменяет распространённое подмножество TOML: таблицы, точечные ключи, скалярные значения и простые списки.

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