Сообщить об ошибке.

Класс ConfigParser() модуля configparser в Python

Конфигурационный парсер файлов

Синтаксис:

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