toml

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

ДанныеВерсия 1.1.5Стабильная
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 <file>.

Поиск

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

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

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

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

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

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

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

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

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

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

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

Пакет Base

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

install toml
Пакет Minimum

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

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

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

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

Поручить 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
app.toml
application.name      lil-shop
application.debug     true
database.host         localhost
database.port         3306
database.options.0    utf8mb4
database.options.1    strict
Показать точное значение по точечному пути
toml $ database.host
localhost
Toml · find-key
toml $ -f "database*" -k
database.host       localhost
database.port       3306
database.options.0  utf8mb4
database.options.1  strict
Toml · find-value
toml $ -f "strict" -v
database.options.1  strict
Toml · write
toml $ -w database.port : 3307
database.port  3307
Toml · delete
toml $ -d database.port
database.host  localhost
Toml · validate
toml $ -c
Valid TOML
Показать нормализованный исходный текст TOML
toml dump $
[application]
name = "lil-shop"
debug = true

[database]
host = "localhost"
port = 3306
Проверить отсутствующий файл
toml \sandbox\config\missing.toml
Файл не найден

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

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

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

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

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

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

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

v1.1.52026-08-14

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

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

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