configparser.md
1> **Источник:** https://python-all.ru/3.6/library/configparser.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 14.2. [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) – Парсер конфигурационных файлов89**Исходный код:** [Lib/configparser.py](https://python-all.ru/src/3.6/Lib/configparser.py)1011---1213Этот модуль предоставляет класс [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser), реализующий базовый язык конфигурации, структура которого аналогична файлам INI в Microsoft Windows. Его можно использовать для написания программ на Python, которые конечные пользователи могут легко настраивать.1415> **Примечание**16>17> Эта библиотека *не* интерпретирует и не записывает префиксы типов значений, используемые в расширенной версии синтаксиса INI из реестра Windows.1819> **См. также**20>21> **Модуль [`shlex`](https://python-all.ru/3.6/library/shlex.html#module-shlex)**22>23> Поддержка создания мини-языков, подобных командным оболочкам Unix, которые можно использовать в качестве альтернативного формата для файлов конфигурации приложений.24>25> **Модуль [`json`](https://python-all.ru/3.6/library/json.html#module-json)**26>27> Модуль json реализует подмножество синтаксиса JavaScript, которое также можно использовать для этой цели.2829## 14.2.1. Быстрый старт3031Рассмотрим простейший конфигурационный файл, который выглядит так:3233```ini34[DEFAULT]35ServerAliveInterval = 4536Compression = yes37CompressionLevel = 938ForwardX11 = yes3940[bitbucket.org]41User = hg4243[topsecret.server.com]44Port = 5002245ForwardX11 = no46```4748Структура INI-файлов описана [в следующем разделе](https://python-all.ru/3.6/library/configparser.html#supported-ini-file-structure). По существу, файл состоит из секций, каждая из которых содержит ключи со значениями. Класс [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) может читать и записывать такие файлы. Начнем с программного создания приведенного выше конфигурационного файла.4950```pycon51>>> import configparser52>>> config = configparser.ConfigParser()53>>> config['DEFAULT'] = {'ServerAliveInterval': '45',54... 'Compression': 'yes',55... 'CompressionLevel': '9'}56>>> config['bitbucket.org'] = {}57>>> config['bitbucket.org']['User'] = 'hg'58>>> config['topsecret.server.com'] = {}59>>> topsecret = config['topsecret.server.com']60>>> topsecret['Port'] = '50022' # изменяет парсер61>>> topsecret['ForwardX11'] = 'no' # то же самое62>>> config['DEFAULT']['ForwardX11'] = 'yes'63>>> with open('example.ini', 'w') as configfile:64... config.write(configfile)65...66```6768Как видите, парсер конфигураций можно использовать почти как словарь. Есть различия, [описанные далее](https://python-all.ru/3.6/library/configparser.html#mapping-protocol-access), но поведение очень близко к тому, что можно ожидать от словаря.6970Теперь, когда мы создали и сохранили конфигурационный файл, давайте прочитаем его и изучим содержащиеся в нем данные.7172```pycon73>>> import configparser74>>> config = configparser.ConfigParser()75>>> config.sections()76[]77>>> config.read('example.ini')78['example.ini']79>>> config.sections()80['bitbucket.org', 'topsecret.server.com']81>>> 'bitbucket.org' in config82True83>>> 'bytebong.com' in config84False85>>> config['bitbucket.org']['User']86'hg'87>>> config['DEFAULT']['Compression']88'yes'89>>> topsecret = config['topsecret.server.com']90>>> topsecret['ForwardX11']91'no'92>>> topsecret['Port']93'50022'94>>> for key in config['bitbucket.org']: print(key)95...96user97compressionlevel98serveraliveinterval99compression100forwardx11101>>> config['bitbucket.org']['ForwardX11']102'yes'103```104105Как видно выше, API довольно прост. Единственная «магия» – это секция `DEFAULT`, которая предоставляет значения по умолчанию для всех остальных секций [1](https://python-all.ru/3.6/library/configparser.html#id14). Также обратите внимание, что ключи в секциях нечувствительны к регистру и хранятся в нижнем регистре [1](https://python-all.ru/3.6/library/configparser.html#id14).106107## 14.2.2. Поддерживаемые типы данных108109Парсеры конфигураций не угадывают типы данных значений в конфигурационных файлах, а всегда хранят их внутри как строки. Это означает, что если вам нужны другие типы данных, преобразование нужно выполнять самостоятельно:110111```pycon112>>> int(topsecret['Port'])11350022114>>> float(topsecret['CompressionLevel'])1159.0116```117118Поскольку эта задача встречается часто, парсеры конфигураций предоставляют ряд удобных методов-геттеров для работы с целыми числами, числами с плавающей точкой и булевыми значениями. Последний тип наиболее интересен, потому что простая передача значения в `bool()` не даст результата, поскольку `bool('False')` все еще является `True`. Именно поэтому парсеры конфигураций также предоставляют метод [`getboolean()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getboolean). Этот метод нечувствителен к регистру и распознает булевы значения из `'yes'`/`'no'`, `'on'`/`'off'`, `'true'`/`'false'` и `'1'`/`'0'` [1](https://python-all.ru/3.6/library/configparser.html#id14). Например:119120```pycon121>>> topsecret.getboolean('ForwardX11')122False123>>> config['bitbucket.org'].getboolean('ForwardX11')124True125>>> config.getboolean('bitbucket.org', 'Compression')126True127```128129Помимо [`getboolean()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getboolean), парсеры конфигураций также предоставляют эквивалентные методы [`getint()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getint) и [`getfloat()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getfloat). Вы можете зарегистрировать собственные преобразователи и настроить предоставленные. [1](https://python-all.ru/3.6/library/configparser.html#id14)130131## 14.2.3. Значения по умолчанию132133Как и в словаре, для указания резервных значений можно использовать метод `get()` секции:134135```pycon136>>> topsecret.get('Port')137'50022'138>>> topsecret.get('CompressionLevel')139'9'140>>> topsecret.get('Cipher')141>>> topsecret.get('Cipher', '3des-cbc')142'3des-cbc'143```144145Обратите внимание, что значения по умолчанию имеют приоритет над резервными. Например, в нашем примере ключ `'CompressionLevel'` был указан только в секции `'DEFAULT'`. Если мы попытаемся получить его из секции `'topsecret.server.com'`, мы всегда получим значение по умолчанию, даже если указано резервное:146147```pycon148>>> topsecret.get('CompressionLevel', '3')149'9'150```151152Еще одна деталь: метод `get()` на уровне парсера предоставляет собственный, более сложный интерфейс, сохраненный для обратной совместимости. При использовании этого метода резервное значение можно передать через именованный аргумент `fallback`:153154```pycon155>>> config.get('bitbucket.org', 'monster',156... fallback='No such things as monsters')157'No such things as monsters'158```159160Тот же аргумент `fallback` можно использовать с методами [`getint()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getint), [`getfloat()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getfloat) и [`getboolean()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getboolean), например:161162```pycon163>>> 'BatchMode' in topsecret164False165>>> topsecret.getboolean('BatchMode', fallback=True)166True167>>> config['DEFAULT']['BatchMode'] = 'no'168>>> topsecret.getboolean('BatchMode', fallback=True)169False170```171172## 14.2.4. Поддерживаемая структура INI-файлов173174Конфигурационный файл состоит из секций, каждая секция начинается с заголовка `[section]`, за которым следуют записи ключ/значение, разделённые определённой строкой (по умолчанию `=` или `:` [1](https://python-all.ru/3.6/library/configparser.html#id14)). По умолчанию имена секций чувствительны к регистру, а ключи – нет [1](https://python-all.ru/3.6/library/configparser.html#id14). Начальные и конечные пробелы удаляются из ключей и значений. Значения можно опускать, и в этом случае разделитель ключ/значение также может быть опущен. Значения могут занимать несколько строк, если они имеют больший отступ, чем первая строка значения. В зависимости от режима парсера пустые строки могут считаться частью многострочных значений или игнорироваться.175176Конфигурационные файлы могут содержать комментарии, начинающиеся с определенных символов (по умолчанию `#` и `;` [1](https://python-all.ru/3.6/library/configparser.html#id14)). Комментарии могут располагаться на отдельной пустой строке, возможно с отступом. [1](https://python-all.ru/3.6/library/configparser.html#id14)177178Например:179180```ini181[Simple Values]182key=value183spaces in keys=allowed184spaces in values=allowed as well185spaces around the delimiter = obviously186you can also use : to delimit keys from values187188[All Values Are Strings]189values like this: 1000000190or this: 3.14159265359191are they treated as numbers? : no192integers, floats and booleans are held as: strings193can use the API to get converted values directly: true194195[Multiline Values]196chorus: I'm a lumberjack, and I'm okay197 I sleep all night and I work all day198199[No Values]200key_without_value201empty string value here =202203[You can use comments]204# как этот205; или этот206207# По умолчанию только в пустой строке.208# Встроенные комментарии могут быть вредны, поскольку не позволяют пользователям209# использовать разделительные символы как части значений.210# Тем не менее, это можно настроить.211212 [Sections Can Be Indented]213 can_values_be_as_well = True214 does_that_mean_anything_special = False215 purpose = formatting for readability216 multiline_values = are217 handled just fine as218 long as they are indented219 deeper than the first line220 of a value221 # Кстати, комментарии тоже можно делать с отступом.222```223224## 14.2.5. Интерполяция значений225226Помимо основной функциональности, [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser) поддерживает интерполяцию. Это означает, что значения могут обрабатываться перед тем, как быть возвращёнными из вызовов `get()`.227228#### `class configparser.BasicInterpolation`229230Реализация по умолчанию, используемая в [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser). Она позволяет значениям содержать строки форматирования, ссылающиеся на другие значения в том же разделе или на значения в специальном разделе по умолчанию [1](https://python-all.ru/3.6/library/configparser.html#id14). Дополнительные значения по умолчанию можно указать при инициализации.231232Например:233234```ini235[Paths]236home_dir: /Users237my_dir: %(home_dir)s/lumberjack238my_pictures: %(my_dir)s/Pictures239```240241В примере выше [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser) с параметром *interpolation*, установленным в `BasicInterpolation()`, преобразовал бы `%(home_dir)s` в значение `home_dir` (в данном случае `/Users`). `%(my_dir)s`, в свою очередь, преобразовалось бы в `/Users/lumberjack`. Все подстановки выполняются по требованию, поэтому ключи, используемые в цепочке ссылок, не обязаны быть указаны в каком-либо определённом порядке в конфигурационном файле.242243Если `interpolation` установлен в `None`, анализатор просто вернёт `%(my_dir)s/Pictures` как значение `my_pictures` и `%(home_dir)s/lumberjack` как значение `my_dir`.244245#### `class configparser.ExtendedInterpolation`246247Альтернативный обработчик для интерполяции, реализующий более сложный синтаксис, используемый, например, в `zc.buildout`. Расширенная интерполяция использует `${section:option}` для обозначения значения из другого раздела. Интерполяция может быть многоуровневой. Для удобства, если часть `section:` опущена, интерполяция по умолчанию берётся из текущего раздела (а также из значений по умолчанию из специального раздела).248249Например, конфигурация, заданная выше с базовой интерполяцией, с расширенной интерполяцией будет выглядеть так:250251```ini252[Paths]253home_dir: /Users254my_dir: ${home_dir}/lumberjack255my_pictures: ${my_dir}/Pictures256```257258Значения из других разделов также можно получать:259260```ini261[Common]262home_dir: /Users263library_dir: /Library264system_dir: /System265macports_dir: /opt/local266267[Frameworks]268Python: 3.2269path: ${Common:system_dir}/Library/Frameworks/270271[Arthur]272nickname: Two Sheds273last_name: Jackson274my_dir: ${Common:home_dir}/twosheds275my_pictures: ${my_dir}/Pictures276python_dir: ${Frameworks:path}/Python/Versions/${Frameworks:Python}277```278279## 14.2.6. Доступ через протокол отображения280281Новое в версии 3.2.282283Доступ через протокол отображения – это общее название функциональности, позволяющей использовать пользовательские объекты как словари. В случае [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) реализация интерфейса отображения использует нотацию `parser['section']['option']`.284285`parser['section']`, в частности, возвращает прокси для данных раздела в анализаторе. Это означает, что значения не копируются, а берутся из исходного анализатора по требованию. Что ещё более важно: при изменении значений в прокси-разделе они фактически изменяются и в исходном анализаторе.286287Объекты [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) ведут себя максимально близко к настоящим словарям. Интерфейс отображения реализован полностью и соответствует абстрактному базовому классу [`MutableMapping`](https://python-all.ru/3.6/library/collections.abc.html#collections.abc.MutableMapping). Однако есть несколько различий, которые следует учитывать:288289- По умолчанию все ключи в разделах доступны без учёта регистра [1](https://python-all.ru/3.6/library/configparser.html#id14). Например, `for option in parser["section"]` возвращает только имена опций, приведённые к `optionxform`. По умолчанию это означает ключи в нижнем регистре. В то же время для раздела, содержащего ключ `'a'`, оба выражения вернут `True`:290291 ```python292 "a" in parser["section"]293 "A" in parser["section"]294 ```295- Все разделы также содержат значения `DEFAULTSECT`, то есть `.clear()`, применённый к разделу, может не оставить его видимо пустым. Это связано с тем, что значения по умолчанию нельзя удалить из раздела (технически их там нет). Если они переопределены в разделе, удаление приводит к тому, что значение по умолчанию снова становится видимым. Попытка удалить значение по умолчанию вызывает `KeyError`.296- `DEFAULTSECT` нельзя удалить из анализатора:297298 - попытка удалить его вызывает `ValueError`,299 - `parser.clear()` оставляет его нетронутым,300 - `parser.popitem()` никогда его не возвращает.301- `parser.get(section, option, **kwargs)` – второй аргумент **не** является запасным значением. Однако обратите внимание, что методы `get()` на уровне раздела совместимы как с протоколом отображения, так и с классическим API configparser.302- `parser.items()` совместим с протоколом отображения (возвращает список пар *название\_раздела*, *прокси\_раздела*, включая DEFAULTSECT). Однако этот метод также может быть вызван с аргументами: `parser.items(section, raw, vars)`. Последний вызов возвращает список пар *опция*, *значение* для указанного `section`, со всеми раскрытыми интерполяциями (если не указан `raw=True`).303304Протокол отображения реализован поверх существующего устаревшего API, поэтому подклассы, переопределяющие исходный интерфейс, по-прежнему должны работать с отображением, как и ожидается.305306## 14.2.7. Настройка поведения парсера307308Вариантов формата INI почти столько же, сколько приложений, его использующих. [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) прилагает большие усилия для поддержки максимально широкого набора стилей INI. Функциональность по умолчанию в основном продиктована историческим опытом, и вполне вероятно, что вам потребуется настроить некоторые возможности.309310Самый распространённый способ изменить поведение конкретного анализатора конфигурации – использовать опции [`__init__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__init__):311312- *defaults*, значение по умолчанию: `None`313314 Эта опция принимает словарь пар ключ-значение, которые изначально помещаются в раздел `DEFAULT`. Это позволяет элегантно поддерживать лаконичные конфигурационные файлы, в которых не указываются значения, совпадающие с задокументированными значениями по умолчанию.315316 Подсказка: если нужно задать значения по умолчанию для конкретного раздела, используйте `read_dict()` до чтения самого файла.317- *dict\_type*, значение по умолчанию: [`collections.OrderedDict`](https://python-all.ru/3.6/library/collections.html#collections.OrderedDict)318319 Эта опция существенно влияет на то, как будет вести себя протокол отображения и как выглядят записанные файлы конфигурации. При использовании упорядоченного словаря по умолчанию каждый раздел хранится в порядке добавления в анализатор. То же самое относится и к опциям внутри разделов.320321 Альтернативный тип словаря можно использовать, например, для сортировки разделов и опций при обратной записи. Также можно использовать обычный словарь по соображениям производительности.322323 Обратите внимание: существует несколько способов добавления набора пар ключ-значение за одну операцию. Если в таких операциях используется обычный словарь, порядок ключей может быть случайным. Например:324325 ```pycon326 >>> parser = configparser.ConfigParser()327 >>> parser.read_dict({'section1': {'key1': 'value1',328 ... 'key2': 'value2',329 ... 'key3': 'value3'},330 ... 'section2': {'keyA': 'valueA',331 ... 'keyB': 'valueB',332 ... 'keyC': 'valueC'},333 ... 'section3': {'foo': 'x',334 ... 'bar': 'y',335 ... 'baz': 'z'}336 ... })337 >>> parser.sections()338 ['section3', 'section2', 'section1']339 >>> [option for option in parser['section3']]340 ['baz', 'foo', 'bar']341 ```342343 В таких операциях также необходимо использовать упорядоченный словарь:344345 ```pycon346 >>> from collections import OrderedDict347 >>> parser = configparser.ConfigParser()348 >>> parser.read_dict(349 ... OrderedDict((350 ... ('s1',351 ... OrderedDict((352 ... ('1', '2'),353 ... ('3', '4'),354 ... ('5', '6'),355 ... ))356 ... ),357 ... ('s2',358 ... OrderedDict((359 ... ('a', 'b'),360 ... ('c', 'd'),361 ... ('e', 'f'),362 ... ))363 ... ),364 ... ))365 ... )366 >>> parser.sections()367 ['s1', 's2']368 >>> [option for option in parser['s1']]369 ['1', '3', '5']370 >>> [option for option in parser['s2'].values()]371 ['b', 'd', 'f']372 ```373- *allow\_no\_value*, значение по умолчанию: `False`374375 Известно, что некоторые конфигурационные файлы содержат настройки без значений, но в остальном соответствуют синтаксису, поддерживаемому [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser). Параметр *allow\_no\_value* конструктора можно использовать, чтобы указать, что такие значения следует принимать:376377 ```pycon378 >>> import configparser379380 >>> sample_config = """381 ... [mysqld]382 ... user = mysql383 ... pid-file = /var/run/mysqld/mysqld.pid384 ... skip-external-locking385 ... old_passwords = 1386 ... skip-bdb387 ... # we don't need ACID today388 ... skip-innodb389 ... """390 >>> config = configparser.ConfigParser(allow_no_value=True)391 >>> config.read_string(sample_config)392393 >>> # Настройки со значениями обрабатываются как и раньше:394 >>> config["mysqld"]["user"]395 'mysql'396397 >>> # Настройки без значений дают None:398 >>> config["mysqld"]["skip-bdb"]399400 >>> # Настройки, которые не указаны, по-прежнему вызывают ошибку:401 >>> config["mysqld"]["does-not-exist"]402 Traceback (most recent call last):403 ...404 KeyError: 'does-not-exist'405 ```406- *delimiters*, значение по умолчанию: `('=', ':')`407408 Разделители – это подстроки, которые отделяют ключи от значений внутри раздела. Первое вхождение такой подстроки в строке считается разделителем. Это означает, что значения (но не ключи) могут содержать разделители.409410 См. также аргумент *space\_around\_delimiters* для [`ConfigParser.write()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.write).411- *comment\_prefixes*, значение по умолчанию: `('#', ';')`412- *inline\_comment\_prefixes*, значение по умолчанию: `None`413414 Префиксы комментариев – это строки, указывающие начало допустимого комментария в конфигурационном файле. *comment\_prefixes* используются только на пустых строках (возможно, с отступом), тогда как *inline\_comment\_prefixes* могут использоваться после любого допустимого значения (например, названий разделов, параметров и пустых строк). По умолчанию строчные комментарии отключены, а в качестве префиксов для комментариев на всю строку используются `'#'` и `';'`.415416 Изменено в версии 3.2: В предыдущих версиях [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) поведение соответствовало `comment_prefixes=('#',';')` и `inline_comment_prefixes=(';',)`.417418 Обратите внимание: парсеры конфигурации не поддерживают экранирование префиксов комментариев, поэтому использование *inline\_comment\_prefixes* может помешать пользователям указывать значения параметров, содержащие символы, используемые как префиксы комментариев. Если сомневаетесь, избегайте установки *inline\_comment\_prefixes*. В любом случае, единственный способ сохранить символы префикса комментария в начале строки в многострочных значениях – это интерполировать префикс, например:419420 ```python421 >>> from configparser import ConfigParser, ExtendedInterpolation422 >>> parser = ConfigParser(interpolation=ExtendedInterpolation())423 >>> # можно также использовать стандартный BasicInterpolation424 >>> parser.read_string("""425 ... [DEFAULT]426 ... hash = #427 ...428 ... [hashes]429 ... shebang =430 ... ${hash}!/usr/bin/env python431 ... ${hash} -*- coding: utf-8 -*-432 ...433 ... extensions =434 ... enabled_extension435 ... another_extension436 ... #disabled_by_comment437 ... yet_another_extension438 ...439 ... interpolation not necessary = if # is not at line start440 ... even in multiline values = line #1441 ... line #2442 ... line #3443 ... """)444 >>> print(parser['hashes']['shebang'])445446 #!/usr/bin/env python447 # -*- coding: utf-8 -*-448 >>> print(parser['hashes']['extensions'])449450 enabled_extension451 another_extension452 yet_another_extension453 >>> print(parser['hashes']['interpolation not necessary'])454 if # is not at line start455 >>> print(parser['hashes']['even in multiline values'])456 line #1457 line #2458 line #3459 ```460- *strict*, значение по умолчанию: `True`461462 Если установлено `True`, парсер не допускает дублирования разделов или параметров при чтении из одного источника (с помощью `read_file()`, `read_string()` или `read_dict()`). В новых приложениях рекомендуется использовать строгие парсеры.463464 Изменено в версии 3.2: В предыдущих версиях [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) поведение соответствовало `strict=False`.465- *empty\_lines\_in\_values*, значение по умолчанию: `True`466467 В парсерах конфигурации значения могут занимать несколько строк, если их отступ больше, чем у ключа, к которому они относятся. По умолчанию парсеры также допускают, чтобы пустые строки были частью значений. В то же время сами ключи могут иметь произвольный отступ для улучшения читаемости. В результате, когда конфигурационные файлы становятся большими и сложными, пользователю легко потерять представление о структуре файла. Рассмотрим пример:468469 ```ini470 [Section]471 key = multiline472 value with a gotcha473474 this = is still a part of the multiline value of 'key'475 ```476477 Это может быть особенно проблематично для пользователя, если он использует пропорциональный шрифт для редактирования файла. Вот почему, если вашему приложению не нужны значения с пустыми строками, стоит рассмотреть возможность их запрета. Это приведёт к тому, что пустые строки будут каждый раз разделять ключи. В приведённом выше примере получилось бы два ключа: `key` и `this`.478- *default\_section*, значение по умолчанию: `configparser.DEFAULTSECT` (то есть `"DEFAULT"`)479480 Возможность выделить специальный раздел со значениями по умолчанию для других разделов или для интерполяции – это мощная концепция данной библиотеки, позволяющая пользователям создавать сложные декларативные конфигурации. Этот раздел обычно называется `"DEFAULT"`, однако его можно настроить на любое другое допустимое имя раздела. Некоторые типичные значения: `"general"` или `"common"`. Указанное имя используется для распознавания разделов по умолчанию при чтении из любого источника, а также при записи конфигурации обратно в файл. Текущее значение можно получить через атрибут `parser_instance.default_section` и изменить во время выполнения (например, для преобразования файлов из одного формата в другой).481- *interpolation*, значение по умолчанию: `configparser.BasicInterpolation`482483 Поведение интерполяции можно настроить, передав собственный обработчик через аргумент *interpolation*. `None` позволяет полностью отключить интерполяцию, `ExtendedInterpolation()` предоставляет более продвинутый вариант, вдохновлённый `zc.buildout`. Подробнее об этом в [соответствующем разделе документации](https://python-all.ru/3.6/library/configparser.html#interpolation-of-values). [`RawConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.RawConfigParser) имеет значение по умолчанию `None`.484- *converters*, значение по умолчанию: не задано485486 Парсеры конфигурации предоставляют геттеры значений параметров, выполняющие преобразование типов. По умолчанию реализованы [`getint()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getint), [`getfloat()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getfloat) и [`getboolean()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getboolean). Если нужны другие геттеры, пользователи могут определить их в подклассе или передать словарь, где каждый ключ – имя преобразователя, а каждое значение – вызываемый объект, реализующий это преобразование. Например, передача `{'decimal': decimal.Decimal}` добавит `getdecimal()` как на объект парсера, так и на все прокси разделов. Другими словами, станет возможным писать как `parser_instance.getdecimal('section', 'key', fallback=0)`, так и `parser_instance['section'].getdecimal('key', 0)`.487488 Если преобразователю требуется доступ к состоянию парсера, его можно реализовать как метод подкласса парсера конфигурации. Если имя этого метода начинается с `get`, он будет доступен на всех прокси разделов в dict-совместимой форме (см. пример `getdecimal()` выше).489490Более тонкую настройку можно выполнить, переопределив значения по умолчанию этих атрибутов парсера. Значения по умолчанию заданы на уровне классов, поэтому их можно переопределить в подклассах или путём присваивания атрибуту.491492#### `ConfigParser.BOOLEAN_STATES`493494По умолчанию при использовании [`getboolean()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.getboolean) парсеры конфигурации считают следующие значения `True`: `'1'`, `'yes'`, `'true'`, `'on'`, а следующие значения `False`: `'0'`, `'no'`, `'false'`, `'off'`. Вы можете переопределить это, указав свой словарь строк и соответствующих им логических значений. Например:495496```pycon497>>> custom = configparser.ConfigParser()498>>> custom['section1'] = {'funky': 'nope'}499>>> custom['section1'].getboolean('funky')500Traceback (most recent call last):501...502ValueError: Not a boolean: nope503>>> custom.BOOLEAN_STATES = {'sure': True, 'nope': False}504>>> custom['section1'].getboolean('funky')505False506```507508Другие типичные логические пары: `accept`/`reject` или `enabled`/`disabled`.509510#### `ConfigParser.optionxform(option)`511512Этот метод преобразует имена параметров при каждой операции чтения, получения или установки. По умолчанию он приводит имя к нижнему регистру. Это также означает, что при записи конфигурационного файла все ключи будут в нижнем регистре. Переопределите этот метод, если такое поведение не подходит. Например:513514```pycon515>>> config = """516... [Section1]517... Key = Value518...519... [Section2]520... AnotherKey = Value521... """522>>> typical = configparser.ConfigParser()523>>> typical.read_string(config)524>>> list(typical['Section1'].keys())525['key']526>>> list(typical['Section2'].keys())527['anotherkey']528>>> custom = configparser.RawConfigParser()529>>> custom.optionxform = lambda option: option530>>> custom.read_string(config)531>>> list(custom['Section1'].keys())532['Key']533>>> list(custom['Section2'].keys())534['AnotherKey']535```536537#### `ConfigParser.SECTCRE`538539Скомпилированное регулярное выражение для разбора заголовков разделов. По умолчанию сопоставляет `[section]` с именем `"section"`. Пробельные символы считаются частью имени раздела, поэтому `[ larch ]` будет прочитан как раздел с именем `" larch "`. Переопределите этот атрибут, если это не подходит. Например:540541```pycon542>>> config = """543... [Section 1]544... option = value545...546... [ Section 2 ]547... another = val548... """549>>> typical = ConfigParser()550>>> typical.read_string(config)551>>> typical.sections()552['Section 1', ' Section 2 ']553>>> custom = ConfigParser()554>>> custom.SECTCRE = re.compile(r"\[ *(?P<header>[^]]+?) *\]")555>>> custom.read_string(config)556>>> custom.sections()557['Section 1', 'Section 2']558```559560> **Примечание**561>562> Хотя объекты ConfigParser также используют атрибут `OPTCRE` для распознавания строк с опциями, переопределять его не рекомендуется, так как это помешает работе параметров конструктора *allow\_no\_value* и *delimiters*.563564## 14.2.8. Примеры устаревшего API565566В основном из соображений обратной совместимости [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser) также предоставляет устаревший API с явными методами `get`/`set`. Хотя у методов, перечисленных ниже, есть свои обоснованные сценарии использования, для новых проектов предпочтительнее доступ через протокол отображения. Устаревший API иногда более продвинутый, низкоуровневый и откровенно неинтуитивный.567568Пример записи в файл конфигурации:569570```python571import configparser572573config = configparser.RawConfigParser()574575# Обратите внимание: используя функции set класса RawConfigParser, можно присваивать576# ключам внутренние значения, не являющиеся строками, но при попытке577# записи в файл или при получении значения в не-сыром режиме возникнет ошибка. Присваивание578# значений через протокол отображения или ConfigParser.set() не допускает579# выполнения таких присваиваний.580config.add_section('Section1')581config.set('Section1', 'an_int', '15')582config.set('Section1', 'a_bool', 'true')583config.set('Section1', 'a_float', '3.1415')584config.set('Section1', 'baz', 'fun')585config.set('Section1', 'bar', 'Python')586config.set('Section1', 'foo', '%(bar)s is %(baz)s!')587588# Записываем наш конфигурационный файл в 'example.cfg'589with open('example.cfg', 'w') as configfile:590 config.write(configfile)591```592593Пример повторного чтения файла конфигурации:594595```python596import configparser597598config = configparser.RawConfigParser()599config.read('example.cfg')600601# getfloat() вызывает исключение, если значение не является float.602# getint() и getboolean() делают то же самое для своих типов.603a_float = config.getfloat('Section1', 'a_float')604an_int = config.getint('Section1', 'an_int')605print(a_float + an_int)606607# Обратите внимание, что следующий вывод не интерполирует '%(bar)s' или '%(baz)s'.608# Это потому, что мы используем RawConfigParser().609if config.getboolean('Section1', 'a_bool'):610 print(config.get('Section1', 'foo'))611```612613Чтобы получить интерполяцию, используйте [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser):614615```python616import configparser617618cfg = configparser.ConfigParser()619cfg.read('example.cfg')620621# Установите необязательный аргумент *raw* метода get() в True, если требуется отключить622# интерполяцию в одной операции get.623print(cfg.get('Section1', 'foo', raw=False)) # -> "Python – это весело!"624print(cfg.get('Section1', 'foo', raw=True)) # -> "%(bar)s – это %(baz)s!"625626# Необязательный аргумент *vars* – это словарь с элементами, которые будут иметь627# приоритет при интерполяции.628print(cfg.get('Section1', 'foo', vars={'bar': 'Documentation',629 'baz': 'evil'}))630631# Необязательный аргумент *fallback* можно использовать для предоставления запасного значения632print(cfg.get('Section1', 'foo'))633 # -> "Python – это весело!"634635print(cfg.get('Section1', 'foo', fallback='Monty is not.'))636 # -> "Python – это весело!"637638print(cfg.get('Section1', 'monster', fallback='No such things as monsters.'))639 # -> "Монстров не существует."640641# Голый вызов print(cfg.get('Section1', 'monster')) вызовет NoOptionError, но мы также можем использовать:642# но мы также можем использовать:643644print(cfg.get('Section1', 'monster', fallback=None))645 # -> None646```647648Значения по умолчанию доступны в обоих типах ConfigParsers. Они используются при интерполяции, если используемая опция не определена в другом месте.649650```python651import configparser652653# Новый экземпляр с 'bar' и 'baz', по умолчанию равными 'Life' и 'hard' соответственно.654config = configparser.ConfigParser({'bar': 'Life', 'baz': 'hard'})655config.read('example.cfg')656657print(config.get('Section1', 'foo')) # -> "Python – это весело!"658config.remove_option('Section1', 'bar')659config.remove_option('Section1', 'baz')660print(config.get('Section1', 'foo')) # -> "Жизнь тяжела!"661```662663## 14.2.9. Объекты ConfigParser664665#### `class configparser.ConfigParser(defaults=None, dict_type=collections.OrderedDict, 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={})`666667Основной парсер конфигурации. Когда задан *defaults*, он инициализируется как словарь внутренних значений по умолчанию. Когда задан *dict\_type*, он будет использоваться для создания словарей для списка разделов, опций внутри раздела и значений по умолчанию.668669Когда задан *delimiters*, он используется как набор подстрок, которые отделяют ключи от значений. Когда задан *comment\_prefixes*, он будет использоваться как набор подстрок, которые обозначают начало комментария в иначе пустых строках. Комментарии могут быть с отступом. Когда задан *inline\_comment\_prefixes*, он будет использоваться как набор подстрок, которые обозначают начало комментария в непустых строках.670671Когда *strict* равен `True` (по умолчанию), парсер не допускает повторяющихся разделов или опций при чтении из одного источника (файла, строки или словаря), вызывая [`DuplicateSectionError`](https://python-all.ru/3.6/library/configparser.html#configparser.DuplicateSectionError) или [`DuplicateOptionError`](https://python-all.ru/3.6/library/configparser.html#configparser.DuplicateOptionError). Когда *empty\_lines\_in\_values* равен `False` (по умолчанию: `True`), каждая пустая строка обозначает конец опции. В противном случае пустые строки внутри многострочной опции сохраняются как часть значения. Когда *allow\_no\_value* равен `True` (по умолчанию: `False`), опции без значений принимаются; значение для них равно `None`, и они сериализуются без завершающего разделителя.672673Если задан параметр *default\_section*, он определяет имя специального раздела, содержащего значения по умолчанию для других разделов и целей интерполяции (обычно называемого `"DEFAULT"`). Это значение можно получить и изменить во время выполнения с помощью атрибута экземпляра `default_section`.674675Поведение интерполяции можно настроить, передав собственный обработчик через аргумент *interpolation*. `None` можно использовать для полного отключения интерполяции, `ExtendedInterpolation()` предоставляет более продвинутый вариант, вдохновлённый `zc.buildout`. Подробнее об этом в [соответствующем разделе документации](https://python-all.ru/3.6/library/configparser.html#interpolation-of-values).676677Все имена опций, используемые в интерполяции, передаются через метод [`optionxform()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.optionxform), как и любые другие ссылки на имена опций. Например, при использовании реализации по умолчанию [`optionxform()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.optionxform) (которая преобразует имена опций в нижний регистр) значения `foo %(bar)s` и `foo %(BAR)s` эквивалентны.678679Когда задан *converters*, это должен быть словарь, где каждый ключ представляет имя конвертера типов, а каждое значение – вызываемый объект, реализующий преобразование из строки в нужный тип данных. Каждый конвертер получает свой собственный соответствующий метод `get*()` на объекте парсера и прокси-объектах разделов.680681Изменено в версии 3.1: Значение по умолчанию *dict\_type* – [`collections.OrderedDict`](https://python-all.ru/3.6/library/collections.html#collections.OrderedDict).682683Изменено в версии 3.2: Были добавлены *allow\_no\_value*, *delimiters*, *comment\_prefixes*, *strict*, *empty\_lines\_in\_values*, *default\_section* и *interpolation*.684685Изменено в версии 3.5: Был добавлен аргумент *converters*.686687#### `defaults()`688689Возвращает словарь, содержащий значения по умолчанию для экземпляра.690691#### `sections()`692693Возвращает список доступных разделов; *раздел по умолчанию* не включён в список.694695#### `add_section(section)`696697Добавляет раздел с именем *section* в экземпляр. Если раздел с таким именем уже существует, возбуждается [`DuplicateSectionError`](https://python-all.ru/3.6/library/configparser.html#configparser.DuplicateSectionError). Если передано имя *раздела по умолчанию*, возбуждается [`ValueError`](https://python-all.ru/3.6/library/exceptions.html#ValueError). Имя раздела должно быть строкой; в противном случае возбуждается [`TypeError`](https://python-all.ru/3.6/library/exceptions.html#TypeError).698699Изменено в версии 3.2: Имена разделов, не являющиеся строками, вызывают [`TypeError`](https://python-all.ru/3.6/library/exceptions.html#TypeError).700701#### `has_section(section)`702703Указывает, присутствует ли в конфигурации указанный *раздел*. *Раздел по умолчанию* не учитывается.704705#### `options(section)`706707Возвращает список доступных параметров в указанном *разделе*.708709#### `has_option(section, option)`710711Если указанный *раздел* существует и содержит указанный *параметр*, вернуть [`True`](https://python-all.ru/3.6/library/constants.html#True); в противном случае вернуть [`False`](https://python-all.ru/3.6/library/constants.html#False). Если указанный *раздел* равен [`None`](https://python-all.ru/3.6/library/constants.html#None) или пустой строке, подразумевается DEFAULT.712713#### `read(filenames, encoding=None)`714715Пытается прочитать и разобрать итерируемый объект с именами файлов, возвращая список имён файлов, которые были успешно разобраны.716717Если *filenames* – строка или [объект, подобный пути](https://python-all.ru/3.6/glossary.html#term-path-like-object), он обрабатывается как одно имя файла. Если файл, указанный в *filenames*, не удается открыть, этот файл будет проигнорирован. Это сделано для того, чтобы можно было указать итерируемый объект с потенциальными расположениями конфигурационных файлов (например, текущий каталог, домашний каталог пользователя и какой-нибудь общесистемный каталог), и все существующие конфигурационные файлы из этого итерируемого объекта будут прочитаны.718719Если ни один из указанных файлов не существует, экземпляр [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser) будет содержать пустой набор данных. Приложение, которому требуется загрузить начальные значения из файла, должно загрузить необходимый файл или файлы с помощью [`read_file()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.read_file) перед вызовом [`read()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.read) для дополнительных файлов:720721```python722import configparser, os723724config = configparser.ConfigParser()725config.read_file(open('defaults.cfg'))726config.read(['site.cfg', os.path.expanduser('~/.myapp.cfg')],727 encoding='cp1250')728```729730Новое в версии 3.2: Параметр *encoding*. Ранее все файлы читались с использованием кодировки по умолчанию для [`open()`](https://python-all.ru/3.6/library/functions.html#open).731732Новое в версии 3.6.1: Параметр *filenames* принимает [объект, подобный пути](https://python-all.ru/3.6/glossary.html#term-path-like-object).733734#### `read_file(f, source=None)`735736Читает и разбирает данные конфигурации из *f*, который должен быть итерируемым объектом, возвращающим строки Unicode (например, файлы, открытые в текстовом режиме).737738Необязательный аргумент *source* задаёт имя читаемого файла. Если он не указан и *f* имеет атрибут `name`, то он используется для *source*; по умолчанию `'<???>'`.739740Новое в версии 3.2: Заменяет [`readfp()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.readfp).741742#### `read_string(string, source='<string>')`743744Разбирает данные конфигурации из строки.745746Необязательный аргумент *source* задаёт контекстно-зависимое имя переданной строки. Если не указан, используется `'<string>'`. Обычно это путь файловой системы или URL.747748Новое в версии 3.2.749750#### `read_dict(dictionary, source='<dict>')`751752Загружает конфигурацию из любого объекта, предоставляющего метод `items()`, подобный словарю. Ключи – это имена разделов, значения – словари с ключами и значениями, которые должны присутствовать в разделе. Если используемый тип словаря сохраняет порядок, разделы и их ключи будут добавлены по порядку. Значения автоматически преобразуются в строки.753754Необязательный аргумент *source* задаёт контекстно-зависимое имя переданного словаря. Если не указан, используется `<dict>`.755756Этот метод можно использовать для копирования состояния между парсерами.757758Новое в версии 3.2.759760#### `get(section, option, *, raw=False, vars=None[, fallback])`761762Получает значение *параметра* для указанного *раздела*. Если указан *vars*, он должен быть словарём. *Параметр* ищется в *vars* (если указан), *разделе* и в *DEFAULTSECT* в указанном порядке. Если ключ не найден и указан *fallback*, он используется как запасное значение. `None` может быть указан в качестве *запасного значения*.763764Все операции `'%'` интерполяции раскрываются в возвращаемых значениях, если только аргумент *raw* не равен true. Значения для ключей интерполяции ищутся так же, как и параметр.765766Изменено в версии 3.2: Аргументы *raw*, *vars* и *fallback* стали только ключевыми, чтобы защитить пользователей от попытки использовать третий аргумент в качестве запасного значения *fallback* (особенно при использовании протокола отображения).767768#### `getint(section, option, *, raw=False, vars=None[, fallback])`769770Удобный метод, который преобразует *параметр* в указанном *разделе* в целое число. См. [`get()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.get) для объяснения *raw*, *vars* и *fallback*.771772#### `getfloat(section, option, *, raw=False, vars=None[, fallback])`773774Удобный метод, который приводит *option* в указанном разделе *section* к числу с плавающей запятой. См. [`get()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.get) для пояснения параметров *raw*, *vars* и *fallback*.775776#### `getboolean(section, option, *, raw=False, vars=None[, fallback])`777778Удобный метод, который приводит *option* в указанном *section* к логическому значению. Обратите внимание, что допустимыми значениями для параметра являются `'1'`, `'yes'`, `'true'` и `'on'`, при которых этот метод возвращает `True`, а `'0'`, `'no'`, `'false'` и `'off'` – `False`. Строковые значения проверяются без учёта регистра. Любое другое значение приведёт к возбуждению исключения [`ValueError`](https://python-all.ru/3.6/library/exceptions.html#ValueError). См. [`get()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.get) для пояснения *raw*, *vars* и *fallback*.779780#### `items(raw=False, vars=None)`781782#### `items(section, raw=False, vars=None)`783784Если *section* не указан, возвращает список пар *section\_name*, *section\_proxy*, включая DEFAULTSECT.785786В противном случае возвращает список пар *name*, *value* для параметров в указанном *section*. Необязательные аргументы имеют тот же смысл, что и для метода [`get()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.get).787788#### `set(section, option, value)`789790Если указанный раздел существует, устанавливает заданный параметр в указанное значение; в противном случае возбуждает исключение [`NoSectionError`](https://python-all.ru/3.6/library/configparser.html#configparser.NoSectionError). *option* и *value* должны быть строками; в противном случае возбуждается исключение [`TypeError`](https://python-all.ru/3.6/library/exceptions.html#TypeError).791792#### `write(fileobject, space_around_delimiters=True)`793794Записывает представление конфигурации в указанный [файловый объект](https://python-all.ru/3.6/glossary.html#term-file-object), который должен быть открыт в текстовом режиме (принимает строки). Это представление может быть разобрано будущим вызовом [`read()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.read). Если *space\_around\_delimiters* равно true, разделители между ключами и значениями окружаются пробелами.795796#### `remove_option(section, option)`797798Удаляет указанный *option* из указанного *section*. Если раздел не существует, возбуждает исключение [`NoSectionError`](https://python-all.ru/3.6/library/configparser.html#configparser.NoSectionError). Если параметр существовал и был удалён, возвращает [`True`](https://python-all.ru/3.6/library/constants.html#True); в противном случае возвращает [`False`](https://python-all.ru/3.6/library/constants.html#False).799800#### `remove_section(section)`801802Удаляет указанный *section* из конфигурации. Если раздел действительно существовал, возвращает `True`. В противном случае возвращает `False`.803804#### `optionxform(option)`805806Преобразует имя параметра *option*, как оно найдено во входном файле или передано клиентским кодом, в форму, которая должна использоваться во внутренних структурах. Реализация по умолчанию возвращает версию *option* в нижнем регистре; подклассы могут переопределить это, или клиентский код может установить атрибут с таким именем на экземплярах, чтобы повлиять на это поведение.807808Для использования этого метода не нужно создавать подкласс анализатора; можно также установить его на экземпляре, присвоив функцию, которая принимает строковый аргумент и возвращает строку. Установка его в `str`, например, сделает имена параметров чувствительными к регистру:809810```python811cfgparser = ConfigParser()812cfgparser.optionxform = str813```814815Обратите внимание, что при чтении файлов конфигурации пробельные символы вокруг имён параметров удаляются перед вызовом [`optionxform()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.optionxform).816817#### `readfp(fp, filename=None)`818819Устарело с версии 3.2: Используйте [`read_file()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.read_file) вместо.820821Изменено в версии 3.2: [`readfp()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.readfp) теперь выполняет итерацию по *fp* вместо вызова `fp.readline()`.822823Для существующего кода, вызывающего [`readfp()`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser.readfp) с аргументами, которые не поддерживают итерацию, следующий генератор можно использовать как обёртку вокруг файлоподобного объекта:824825```python826def readline_generator(fp):827 line = fp.readline()828 while line:829 yield line830 line = fp.readline()831```832833Вместо `parser.readfp(fp)` используйте `parser.read_file(readline_generator(fp))`.834835#### `configparser.MAX_INTERPOLATION_DEPTH`836837Максимальная глубина рекурсивной интерполяции для `get()`, когда параметр *raw* равен false. Это актуально только при использовании *интерполяция* по умолчанию.838839## 14.2.10. Объекты RawConfigParser840841#### `class configparser.RawConfigParser(defaults=None, dict_type=collections.OrderedDict, allow_no_value=False, *, delimiters=('=', ':'), comment_prefixes=('#', ';'), inline_comment_prefixes=None, strict=True, empty_lines_in_values=True, default_section=configparser.DEFAULTSECT[, interpolation])`842843Устаревший вариант [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser) с отключенной по умолчанию интерполяцией и небезопасными методами `add_section` и `set`.844845> **Примечание**846>847> Рассмотрите возможность использования [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser) – он проверяет типы сохраняемых внутри значений. Если интерполяция не нужна, можно использовать `ConfigParser(interpolation=None)`.848849#### `add_section(section)`850851Добавляет раздел с именем *section* в экземпляр. Если раздел с указанным именем уже существует, возникает [`DuplicateSectionError`](https://python-all.ru/3.6/library/configparser.html#configparser.DuplicateSectionError). Если передано имя *раздела по умолчанию*, возникает [`ValueError`](https://python-all.ru/3.6/library/exceptions.html#ValueError).852853Тип *section* не проверяется, что позволяет создавать разделы с нестроковыми именами. Это поведение не поддерживается и может вызывать внутренние ошибки.854855#### `set(section, option, value)`856857Если указанный раздел существует, устанавливает указанный параметр в заданное значение; иначе возбуждает [`NoSectionError`](https://python-all.ru/3.6/library/configparser.html#configparser.NoSectionError). Хотя для *внутреннего* хранения нестроковых значений можно использовать [`RawConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.RawConfigParser) (или [`ConfigParser`](https://python-all.ru/3.6/library/configparser.html#configparser.ConfigParser) с параметром *raw*, установленным в true), полная функциональность (включая интерполяцию и вывод в файлы) достигается только при использовании строковых значений.858859Этот метод позволяет пользователям присваивать нестроковые значения ключам внутри. Такое поведение не поддерживается и приведет к ошибкам при попытке записи в файл или получении значения в несыром режиме. **Используйте API протокола отображения**, который не допускает таких присваиваний.860861## 14.2.11. Исключения862863#### `exception configparser.Error`864865Базовый класс для всех прочих исключений [`configparser`](https://python-all.ru/3.6/library/configparser.html#module-configparser).866867#### `exception configparser.NoSectionError`868869Исключение, возбуждаемое, когда указанный раздел не найден.870871#### `exception configparser.DuplicateSectionError`872873Исключение, возбуждаемое, если `add_section()` вызывается с именем уже существующего раздела, или в строгих парсерах, когда раздел встречается более одного раза в одном входном файле, строке или словаре.874875Новое в версии 3.2: Добавлены необязательные атрибуты и аргументы `source` и `lineno` для [`__init__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__init__).876877#### `exception configparser.DuplicateOptionError`878879Исключение, возбуждаемое строгими парсерами, если один параметр встречается дважды при чтении из одного файла, строки или словаря. Это позволяет отлавливать опечатки и ошибки, связанные с регистром символов: например, в словаре может быть два ключа, представляющих один и тот же конфигурационный ключ, регистр которого не учитывается.880881#### `exception configparser.NoOptionError`882883Исключение, возбуждаемое, когда указанный параметр не найден в указанном разделе.884885#### `exception configparser.InterpolationError`886887Базовый класс для исключений, возбуждаемых при возникновении проблем во время выполнения строковой интерполяции.888889#### `exception configparser.InterpolationDepthError`890891Исключение, возбуждаемое, когда строковая интерполяция не может быть завершена, поскольку количество итераций превышает [`MAX_INTERPOLATION_DEPTH`](https://python-all.ru/3.6/library/configparser.html#configparser.MAX_INTERPOLATION_DEPTH). Подкласс [`InterpolationError`](https://python-all.ru/3.6/library/configparser.html#configparser.InterpolationError).892893#### `exception configparser.InterpolationMissingOptionError`894895Исключение, возбуждаемое, когда параметр, на который есть ссылка из значения, не существует. Подкласс [`InterpolationError`](https://python-all.ru/3.6/library/configparser.html#configparser.InterpolationError).896897#### `exception configparser.InterpolationSyntaxError`898899Исключение, возбуждаемое, когда исходный текст, в который вносятся подстановки, не соответствует требуемому синтаксису. Подкласс [`InterpolationError`](https://python-all.ru/3.6/library/configparser.html#configparser.InterpolationError).900901#### `exception configparser.MissingSectionHeaderError`902903Исключение, возбуждаемое при попытке разобрать файл, не содержащий заголовков разделов.904905#### `exception configparser.ParsingError`906907Исключение, возникающее при ошибках во время разбора файла.908909Изменено в версии 3.2: Атрибут `filename` и аргумент [`__init__()`](https://python-all.ru/3.6/reference/datamodel.html#object.__init__) были переименованы в `source` для согласованности.910911Сноски912913**1([1](https://python-all.ru/3.6/library/configparser.html#id1),[2](https://python-all.ru/3.6/library/configparser.html#id2),[3](https://python-all.ru/3.6/library/configparser.html#id3),[4](https://python-all.ru/3.6/library/configparser.html#id4),[5](https://python-all.ru/3.6/library/configparser.html#id5),[6](https://python-all.ru/3.6/library/configparser.html#id6),[7](https://python-all.ru/3.6/library/configparser.html#id7),[8](https://python-all.ru/3.6/library/configparser.html#id8),[9](https://python-all.ru/3.6/library/configparser.html#id9),[10](https://python-all.ru/3.6/library/configparser.html#id10))**914915Парсеры конфигураций допускают широкую настройку. Если вас интересует изменение поведения, описанного в сноске, обратитесь к разделу [Настройка поведения парсера](https://python-all.ru/3.6/library/configparser.html#customizing-parser-behaviour).916