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

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