properties

properties читает Java-style .properties как набор ключей и значений, понимает продолжение строк и показывает точечные имена как удобные пути для поиска и точечной правки.

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

Обзор

properties работает прямо с файлами Java Properties: читает точечные ключи, ищет ключи и значения, атомарно меняет одну настройку, проверяет файл и при необходимости показывает весь нормализованный исходник через dump.

Точечный путь всё равно принадлежит плоскому файлу

database.host удобно адресовать как путь, но на диске остаётся плоский properties-файл. Структурная запись нормализует его обратно в строки key=value, поэтому для сохранения комментариев и точного оформления лучше использовать текстовый редактор.

Синтаксис

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

Справочник

properties <file>

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

properties <file> <key>

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

properties dump <file>

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

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

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

-w <key> : <value>

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

-w <key> < <file>

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

-d <key>

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

-c

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

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

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

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

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

Поддерживаются простые пары с = или :, комментарии с #/! и переносы строк с \; точки в именах превращаются в пути. При чтении значения остаются строками, даже если выглядят как true или 3306. Это не полная реализация Java Properties: экранирование, Unicode и оформление могут измениться при записи, комментарии исчезнут. В Minimum — только просмотр.

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

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

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

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

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

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

Пакет Base

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

install properties
Пакет Minimum

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

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

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

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

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

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

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

install properties -u

Примеры

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

Открыть файл и повторно использовать его через $
cd \sandbox\config | properties app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
Показать данные properties
properties config/app.properties
application.name   lil-shop
application.debug  true
database.host      localhost
database.port      3306
Показать точное значение по точечному пути
properties config/app.properties database.host
localhost
Показать точное значение по точечному пути
properties config/app.properties application.debug
true
Найти совпадения в ключах или значениях; * и ? включают маску
properties config/app.properties -f "database.*" -k
database.host  localhost
database.port  3306
Найти совпадения в ключах или значениях; * и ? включают маску
properties config/app.properties -f "localhost" -v
database.host  localhost
Найти совпадения в ключах или значениях; * и ? включают маску
properties config/app.properties -f "debug"
application.debug  true
Записать значение прямо в файл
properties config/app.properties -w database.port : 3307
database.port  3307
Записать значение, прочитанное из другого файла
properties config/app.properties -w application.name < config/plain-value.txt
application.name  demo-site
Проверить отсутствующий файл
properties config/app.properties -d application.debug
application.name  lil-shop
database.host     localhost
database.port     3306
Проверить корректность файла properties
properties config/app.properties -c
Valid properties
Показать нормализованный исходный текст properties
properties dump config/app.properties
application.name=lil-shop
application.debug=true
database.host=localhost
database.port=3306
Показать точное значение по точечному пути
properties config/app.properties unknown.key
Path not found
Проверить корректность файла properties
properties config/duplicate.properties -c
Duplicate properties key
Показать данные properties
properties config/missing.properties
File not found
Записать значение прямо в файл
properties config/app.properties -w database.port
Value required after : or

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

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

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

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

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

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

v1.1.62026-11-01

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

Актуальная стабильная версия properties. properties читает Java-style `.

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