Содержание страницы
netrc – обработка файлов netrc¶netrc – netrc file processing
Класс netrc разбирает и инкапсулирует формат файлов netrc, используемый программой ftp в Unix и другими FTP-клиентами.
- class netrc.netrc([file])¶
- Экземпляр netrc или его подкласс инкапсулирует данные из файла netrc. Аргумент инициализации, если указан, задаёт файл для разбора. Если аргумент не указан, будет прочитан файл .netrc из домашнего каталога пользователя. Ошибки разбора приведут к возникновению исключения NetrcParseError с диагностической информацией, включающей имя файла, номер строки и завершающий токен.
- exception netrc.NetrcParseError¶
- Исключение, вызываемое классом netrc при обнаружении синтаксических ошибок в исходном тексте. Экземпляры этого исключения предоставляют три полезных атрибута: msg – текстовое описание ошибки, filename – имя исходного файла, а lineno – номер строки, в которой была обнаружена ошибка.
Объекты netrc¶netrc Objects
Экземпляр netrc имеет следующие методы:
- netrc.authenticators(host)¶
- Возвращает кортеж из трёх элементов (login, account, password) аутентификаторов для host. Если файл netrc не содержал записи для указанного хоста, возвращает кортеж, связанный с записью 'default'. Если нет ни подходящего хоста, ни записи по умолчанию, возвращает None.
- netrc.__repr__()¶
- Выгружает данные класса в виде строки в формате файла netrc. (При этом отбрасываются комментарии и может измениться порядок записей.)
Экземпляры netrc имеют открытые переменные экземпляра:
- netrc.hosts¶
- Словарь, отображающий имена хостов в кортежи (login, account, password). Запись 'default', если она есть, представлена как псевдо-хост с этим именем.
- netrc.macros¶
- Словарь, сопоставляющий имена макросов со списками строк.
Примечание
Пароли ограничены подмножеством символов ASCII. Все знаки пунктуации ASCII разрешены в паролях, однако обратите внимание, что пробельные символы и непечатаемые символы в паролях не допускаются. Это ограничение способа разбора файла .netrc и может быть устранено в будущем.