import configparser configparser.ConfigParser(defaults=None, dict_type=dict, allow_no_value=False, delimiters=('=', ':'), comment_prefixes=('#', ';'), inline_comment_prefixes=None, strict=True, empty_lines_in_values=True, default_section=configparser.DEFAULTSECT, interpolation=BasicInterpolation(), converters={})
Подробный разбор параметров конструктора класса смотрите в разделе "Настройка парсера ConfigParser
"
Класс ConfigParser()
модуля configparser
представляет собой основной конфигурационный парсер.
Когда задан аргумент defaults
, то они инициализируются в словарь внутренних значений по умолчанию.
Когда задан аргумент dict_type
, то он будет использоваться для создания объектов словаря для списка разделов, для параметров в разделе и для значений по умолчанию.
Когда задан аргумент delimiters
, то он используется как набор подстрок, которые отделяют ключи от значений.
Когда задан аргумент comment_prefixes
, то он будет использоваться в качестве набора подстрок, которые определяют начальный символ для комментариев в других пустых строках. Комментарии могут быть с отступом. Аргумент inline_comment_prefixes
используется в качестве набора подстрок, которые определяют начальный символ для комментариев в непустых строках.
Если для параметра strict
установлено значение True
(по умолчанию), то синтаксический анализатор не допускает дублирование каких-либо разделов или параметров при чтении из одного источника (файла, строки или словаря), в результате чего возникают DuplicateSectionError
или DuplicateOptionError
.
Когда значение параметра empty_lines_in_values
равно False
(по умолчанию: True
), каждая пустая строка отмечает конец параметра. В противном случае внутренние пустые строки многострочного параметра сохраняются как часть значения.
Когда значение аргумента llow_no_value=True
(по умолчанию: False
), то принимаются параметры без значений. Для них устанавливается значение None
, и они сериализуются без конечного разделителя.
Когда задан аргумент default_section
, то он указывает имя для специального раздела, содержащего значения по умолчанию для других разделов и целей интерполяции и обычно называемые DEFAULT
. Это значение можно получить и изменить во время выполнения, используя атрибут экземпляра default_section
.
Поведение интерполяции может быть настроено путем предоставления специального обработчика через аргумент интерполяции. Ни один из них не может быть использован для полного отключения интерполяции. Класс configparser.ExtendedInterpolation()
предоставляет более продвинутый вариант, основанный на Buildout
.
Все имена параметров, используемые в интерполяции, будут передаваться через метод configparser.optionxform()
, как и любая другая ссылка на имя параметра. Например используя стандартную реализацию configparser.optionxform()
, которая преобразует имена параметров в нижний регистр, значения foo%(bar)s
и foo%(BAR)s
эквивалентны.
Когда задан аргумент converters
, то это должен быть словарь, в котором каждый ключ представляет имя типа конвертера, а каждое значение - вызываемую функцию, реализующую преобразование из строки в желаемый тип данных. Каждый конвертер получает свой собственный соответствующий новый метод get*()
для объекта парсера и прокси секций.
Пример простого использования класса configparser.ConfigParser()
смотрите в анонсе модуля configparser