netrc.md

1> **Источник:** https://python-all.ru/3.1/library/netrc.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 13.3. `netrc` – обработка файлов netrc89Класс [`netrc`](https://python-all.ru/3.1/library/netrc.html#netrc.netrc) разбирает и инкапсулирует формат файлов netrc, используемый программой **ftp** в Unix и другими FTP-клиентами.1011#### `class netrc.netrc([file])`1213Экземпляр1415[`netrc`](https://python-all.ru/3.1/library/netrc.html#netrc.netrc)1617или его подкласс инкапсулирует данные из файла netrc. Аргумент инициализации, если указан, задаёт файл для разбора. Если аргумент не указан, будет прочитан файл1819`.netrc`2021из домашнего каталога пользователя. Ошибки разбора приведут к возникновению исключения2223[`NetrcParseError`](https://python-all.ru/3.1/library/netrc.html#netrc.NetrcParseError)2425с диагностической информацией, включающей имя файла, номер строки и завершающий токен.2627#### `exception netrc.NetrcParseError`2829Исключение, вызываемое классом3031[`netrc`](https://python-all.ru/3.1/library/netrc.html#netrc.netrc)3233при обнаружении синтаксических ошибок в исходном тексте. Экземпляры этого исключения предоставляют три полезных атрибута:3435`msg`3637– текстовое описание ошибки,3839`filename`4041– имя исходного файла, а4243`lineno`4445– номер строки, в которой была обнаружена ошибка.4647## 13.3.1. Объекты netrc4849Экземпляр [`netrc`](https://python-all.ru/3.1/library/netrc.html#netrc.netrc) имеет следующие методы:5051#### `netrc.authenticators(host)`5253Возвращает кортеж из трёх элементов5455`(login, account, password)`5657аутентификаторов для5859*host*6061. Если файл netrc не содержал записи для указанного хоста, возвращает кортеж, связанный с записью 'default'. Если нет ни подходящего хоста, ни записи по умолчанию, возвращает6263`None`6465.6667#### `netrc.__repr__()`6869Выгружает данные класса в виде строки в формате файла netrc. (При этом отбрасываются комментарии и может измениться порядок записей.)7071Экземпляры [`netrc`](https://python-all.ru/3.1/library/netrc.html#netrc.netrc) имеют открытые переменные экземпляра:7273#### `netrc.hosts`7475Словарь, отображающий имена хостов в кортежи7677`(login, account, password)`7879. Запись 'default', если она есть, представлена как псевдо-хост с этим именем.8081#### `netrc.macros`8283Словарь, сопоставляющий имена макросов со списками строк.8485> **Примечание**86>87> Пароли ограничены подмножеством символов ASCII. Все знаки пунктуации ASCII разрешены в паролях, однако обратите внимание, что пробельные символы и непечатаемые символы в паролях не допускаются. Это ограничение способа разбора файла .netrc и может быть устранено в будущем.88