netrc — Обработка файла netrc

Исходный код: Lib/netrc.py

Класс netrc парсит и инкапсулирует формат файла netrc, используемый программой Unix ftp и другими клиентами FTP.

class netrc.netrc([file])

Экземпляр класса netrc или экземпляр подкласса инкапсулирует данные из файла netrc. Аргумент инициализации, если он есть, указывает на файл для парсинга. Если аргумент не указан, будет прочитан файл .netrc в домашнем каталоге пользователя — как определено функцией os.path.expanduser(). В противном случае будет поднято исключение FileNotFoundError. Ошибки разбора приведут к исключению NetrcParseError с диагностической информацией, включая имя файла, номер строки и завершающий токен. Если на POSIX-системе аргумент не указан, наличие паролей в файле .netrc вызовет исключение NetrcParseError, если права доступа или права владения файлом небезопасны (владелец не тот пользователь, который запускает процесс, или доступ к чтению/записи предоставляется другим пользователям). Это реализует поведение безопасности, эквивалентное поведению программ ftp и других программ, использующих .netrc.

Изменено в версии 3.4: Добавлена проверка разрешений POSIX.

Изменено в версии 3.7: Для определения местоположения файла .netrc при отсутствии аргумента file используется os.path.expanduser().

Изменено в версии 3.10: Модуль netrc сначала пытается использовать кодировку UTF-8, а затем — кодировку, специфичную для локали. Запись в файле netrc больше не должна содержать всех токенов. Значения отсутствующих токенов по умолчанию устанавливаются в пустую строку. Теперь все токены и их значения могут содержать произвольные символы, такие как пробелы и не-ASCII символы. Если имя пользователя — anonymous, проверка безопасности не выполняется.

exception netrc.NetrcParseError

Исключение, выбрасываемое классом netrc при обнаружении синтаксических ошибок в исходном тексте. Экземпляры этого исключения предоставляют три полезных атрибута:

msg

Текстовое описание ошибки.

filename

Имя исходного файла.

lineno

Номер строки, в которой была обнаружена ошибка.