OSCHINA-MIRROR/unknwon-goconfig

goconfig

ВАЖНО

Эта библиотека находится в режиме только исправления ошибок, что означает, что больше функций добавлено не будет.
Я продолжаю работать над улучшением кода Go с другой библиотекой: ini.

О библиотеке

Пакет goconfig — это простой в использовании парсер файлов конфигурации для языка программирования Go, который предоставляет структуру, аналогичную той, которую вы найдёте в файлах INI Microsoft Windows.

Файл конфигурации состоит из разделов, начинающихся с заголовка «[раздел]» и сопровождаемых записями «имя: значение» или «имя = значение». Обратите внимание, что начальные пробелы удаляются из значений. Необязательные значения могут содержать строки формата, которые ссылаются на другие значения в том же разделе или значения в специальном разделе DEFAULT. Комментарии обозначаются символами «;» или «#»; комментарии могут начинаться в любой точке строки.

Особенности

Он упрощает рабочие процессы, прост в использовании и понимании; следовательно, вероятность ошибок меньше.
Он использует точно такой же способ доступа к файлу конфигурации, как и Windows API, поэтому вам не нужно менять стиль кода.
Поддерживает рекурсивное чтение разделов.
Поддерживает автоинкремент ключа.
Поддерживает READ и WRITE файла конфигурации с комментариями для каждого раздела или ключа, чего не поддерживают другие парсеры!!!!!!!
Поддерживает получение значения через тип bool, float64, int, int64 и string, методы, начинающиеся с «Must», означают игнорирование ошибок и получение нулевого значения, если возникает ошибка, или вы можете указать значение по умолчанию.
Может загружать несколько файлов для перезаписи значений ключей.

Установка

go get github.com/Unknwon/goconfig

Или

gopm get github.com/Unknwon/goconfig

Документация API

Go Walker.

Пример

Пожалуйста, смотрите conf.ini в качестве примера.

Использование

Функция LoadConfigFile загружает файл (файлы) в зависимости от вашей ситуации и возвращает переменную типа ConfigFile.
GetValue обеспечивает базовую функциональность получения значения данного раздела и ключа.
Методы, такие как Bool, Int, Int64, возвращают соответствующие типы значений.
Методы, начинающиеся с Must, возвращают соответствующий тип значений и возвращают нулевое значение заданного типа, если что-то пойдёт не так.
SetValue устанавливает значение для данного раздела и ключа и вставляет его куда-нибудь, если он не существует.
DeleteKey удаляет по данному разделу и ключу.
Наконец, SaveConfigFile сохраняет вашу конфигурацию в локальной файловой системе.
Используйте метод Reload в случае, если кто-то другой изменил ваши файлы.
Методы содержат Comment, помогающие манипулировать комментариями.
LoadFromReader позволяет загружать данные без промежуточного файла.
Добавлен SaveConfigData, который записывает конфигурацию в произвольный модуль записи.
ReloadData позволяет перезагрузить данные из памяти.

Обратите внимание, что вы не можете смешивать конфигурацию в памяти с конфигурацией на диске.

Дополнительная информация

Все символы чувствительны к регистру, будьте осторожны!

Кредиты

Лицензия

Этот проект находится под лицензией Apache v2. См. файл LICENSE для полного текста лицензии.