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, прежде чем использовать локальную кодировку.

exception netrc.NetrcParseError

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