netrc – обработка файлов netrc¶netrc – netrc file processing

Исходный код: 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. Такие проверки безопасности недоступны на платформах, не поддерживающих os.getuid().

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

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

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

exception netrc.NetrcParseError¶

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

msg¶

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

filename¶

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

lineno¶

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