netrc
源代码: Lib/netrc.py
这个 netrc
类解析并封装Unix使用的netrc文件格式 ftp 程序和其他FTP客户端。
- class netrc.netrc([file])
A
netrc
实例或子类实例封装来自netrc文件的数据。初始化参数(如果存在)指定要分析的文件。如果没有给出参数,则文件.netrc
在用户的主目录中--由os.path.expanduser()
--将被读取。否则,aFileNotFoundError
将引发异常。分析错误将引发NetrcParseError
带有诊断信息,包括文件名、行号和终止令牌。如果在POSIX系统上未指定任何参数,则在.netrc
文件将引发NetrcParseError
如果文件所有权或权限不安全(由运行进程的用户以外的用户拥有,或可供任何其他用户读取或写入)。这实现了与ftp和其他使用.netrc
.在 3.4 版更改: 添加了POSIX权限检查。
在 3.7 版更改:
os.path.expanduser()
用于查找.netrc
当文件 file 不是作为参数传递的。
- exception netrc.NetrcParseError
由引发的异常
netrc
当源文本中遇到语法错误时初始化。此异常的实例提供三个有趣的属性:msg
是对错误的文本解释,filename
是源文件的名称,并且lineno
给出错误所在的行号。
NETRC对象
A netrc
实例具有以下方法:
- netrc.authenticators(host)
返回3元组
(login, account, password)
的身份验证程序 host . 如果netrc文件不包含给定主机的条目,则返回与“default”条目关联的元组。如果匹配的主机和默认条目都不可用,则返回None
.
实例 netrc
具有公共实例变量:
注解
密码仅限于ASCII字符集的一个子集。密码中允许使用所有ASCII标点符号,但是请注意,密码中不允许使用空格和不可打印的字符。这是对.netrc文件解析方式的限制,将来可能会删除该文件。