2020-12-22 16:31:42 +00:00
# Multini
[](https://github.com/GenZmeY/multini/actions?query=workflow%3Abuild)
[](https://github.com/GenZmeY/multini/actions?query=workflow%3Atests)
[](https://github.com/GenZmeY/multini/security/code-scanning)
[](https://golang.org)
[](LICENSE)
[](https://github.com/GenZmeY/multini/releases)
2020-12-22 16:32:25 +00:00
[English ](README.md ), [Русский ](README-ru.md )
2020-12-22 16:31:42 +00:00
*Утилита командной строки для манипулирования ini файлами с
Скомпилированная версия multini доступна на [странице релизов ](https://github.com/GenZmeY/multini/releases ).
***
# Описание
Некоторые программы используют формат ini файлов допускающий повторяющиеся имена ключей.
Например игры основаные на [unreal engine ](https://en.wikipedia.org/wiki/Unreal_Engine ).
Это может выглядеть так (часть конфигурации Killing Floor 2):
```
[OnlineSubsystemSteamworks.KFWorkshopSteamworks]
ServerSubscribedWorkshopItems=2267561023
ServerSubscribedWorkshopItems=2085786712
ServerSubscribedWorkshopItems=2222630586
ServerSubscribedWorkshopItems=2146677560
```
2020-12-22 16:38:20 +00:00
Большинство реализаций поддерживают только одно свойство с
2020-12-22 16:31:42 +00:00
**примечание:**
- multini чувствителен к регистру;
- кавычки вокруг значения не обрабатываются (multini считает их частью значения);
- многострочные значения не поддерживаются.
(но все это может измениться в будущем)
# Сборка и установка (вручную)
1. Установите [golang ](https://golang.org ), [git ](https://git-scm.com/ ), [make ](https://www.gnu.org/software/make/ );
2. Клонируйте этот репозиторий: `git clone https://github.com/GenZmeY/multini`
3. Перейдите в каталог с `cd multini`
4. Выполните сборку: `make`
5. Выполните установку: `make install`
# Использование
```
Использование: multini [ПАРАМЕТРЫ]... ДЕЙСТВИЕ ini_file [секция] [ключ] [значение]
Действия:
-g, --get Получить значения для заданной комбинации параметров.
-s, --set Установить значения для заданной комбинации параметров.
-a, --add Добавить значения для заданной комбинации параметров.
-d, --del Удалить указанную комбинацию параметров.
2020-12-22 19:16:43 +00:00
-c, --chk Показать ошибки парсинга указанного файла.
2020-12-22 16:31:42 +00:00
Параметры:
-e, --existing Для --set и --del завершить программу с
-r, --reverse Для --add добавлять элемент в начало секции
-i, --inplace Перезаписывать исходный файл.
Это не атомарно, но требует меньше разрешений
чем способ по умолчанию с
-o, --output ФАЙЛ Записать результат в ФАЙЛ. '-' означает стандартный вывод
-u, --unix Использовать LF в конце строки
-w, --windows Использовать CRLF в конце строки
-q, --quiet Подавить весь вывод
-h, --help Отобразить страницу помощи
--version Отобразить версию
```
# Примеры
**вывести глобальное значение вне секции:**
`multini --get ini_file '' key`
**вывести секцию:**
`multini --get ini_file section`
**вывести список секций:**
`multini --get ini_file`
**вывести значение:**
`multini --get ini_file section key`
- если ключей несколько, отобразится список всех значений этих ключей
**создать/обновить ключ (в единственном экземпляре):**
`multini --set ini_file section key value`
- если ключа нет, он будет добавлен
- если ключ существует, значение будет обновлено
- если ключ существует и имеет несколько значений, будет установлен ключ с
**добавить ключ с
`multini --add ini_file section key value`
- если ключа нет, он будет добавлен
- если ключ существует и не имеет указанного значения, будет добавлено новое значение
- если указанное значение повторяет существующее, никаких изменений не будет
**удалить все ключи с
`multini --del ini_file section key`
**удалить ключ с
`multini --del ini_file section key value`
**удалить секцию:**
`multini --del ini_file section`
**короткие версии параметров можно комбинировать:**
`multini -gq ini_file section key value`
- проверить наличие ключа с
# Лицензия
Copyright © 2020 GenZmeY
[MIT License ](LICENSE ).
