`ini`

ini работает с настоящими INI-файлами: читает секции и типизированные значения, ищет настройки, проверяет синтаксис и атомарно меняет один ключ. Путь имеет форму key или section.key.

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

lil-terminal

pwd/sandboxdir 1 . -Fconfig/ data/ logs/ src/ tmp/app.iniapplication.name lil-sandbox application.debug true paths.source ../src paths.public ../publicini $ -cValid INIini $ -f "path*" -kpaths.public ../public paths.source ../src

Обзор

ini работает прямо с INI-файлом: читает ключи по точечному пути, ищет по ключам или значениям, атомарно меняет одну настройку, проверяет результат и показывает нормализованный исходник — без буфера сессии.

Секция и ключ образуют два уровня

application.name выбирает ключ name внутри секции [application]. Более глубокий путь вроде a.b.c отклоняется намеренно; для конфигурации с дополнительной вложенностью лучше подходят JSON, TOML или YAML.

Синтаксис

lil-terminal

ini <file> [key|options] · ini dump <file>

Справочник

ini <file>

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

ini <file> <key>

показать точное значение ключа или раздела

ini dump <file>

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

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

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

-w <key> : <value>

записать скаляр или JSON-список прямо в файл

-w <key> < <file>

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

-d <key>

удалить ключ или раздел

-c

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

Активный файл

В текущем ядре успешно открытый файл сразу становится доступен через $. Если этот модуль — установленный обработчик с наивысшим приоритетом для расширения файла, достаточно ввести только имя файла: ядро направит его в эту команду. Это удобства ядра; явной формой остаётся ini <file>.

Поиск

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

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

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

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

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

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

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

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

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

Пакет Base

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

install ini

Пакет Minimum

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

install ini -m

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

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

install ini -v 1.3.5

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

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

upgrade ini

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

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

install ini -u

Примеры

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

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

cd \sandbox\config | ini app.ini

application.name   lil-sandbox
application.debug  true
paths.source        ../src
paths.public        ../public

Показать данные INI

app.ini

application.name   lil-sandbox
application.debug  true
paths.source        ../src
paths.public        ../public

Показать точное значение ключа или раздела

ini $ application.name

lil-sandbox

Ini · find-key

ini $ -f "path*" -k

paths.public  ../public
paths.source  ../src

Ini · find-value

ini $ -f "../public" -v

paths.public  ../public

Ini · write

ini $ -w application.password : "Ed1g!fs:13od"

application.password  Ed1g!fs:13od

Ini · delete

ini $ -d application.password

application.name   lil-sandbox
application.debug  true

Ini · validate

ini $ -c

Valid INI

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

ini dump $ > ini-review.txt -r

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

[paths]
source = "../src"
public = "../public"

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

ini \sandbox\config\missing.ini

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

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

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

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

[paths]
source = "../src"
public = "../public"

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

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

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

v1.3.52026-08-13

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

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

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

ini