netrc文件处理(3)Python文件格式(必读进阶Python教程)(参考资料)
本netrc
类解析和封装了Unix的使用NETRC文件格式的FTP程序和其他FTP客户端。
- class
netrc.
netrc
([ file ] ) - 一个
netrc
实例或子类的实例从NETRC文件封装数据。初始化参数(如果存在)指定要解析的文件。如果没有给出参数,则将读取.netrc
用户主目录中的文件(由…确定)os.path.expanduser()
。否则,FileNotFoundError
将引发异常。解析错误将NetrcParseError
随诊断信息而增加,包括文件名,行号和终止令牌。如果在POSIX系统上没有指定参数,如果文件所有权或权限不安全,则.netrc
文件中存在密码将引发NetrcParseError
(由运行该进程的用户以外的用户拥有,或者可由任何其他用户读取或写入用户)。这实现了与ftp和其他使用的程序相当的安全行为.netrc
。版本3.4中已更改:添加了POSIX权限检查。
版本3.7中更改:
os.path.expanduser()
用于.netrc
在文件未作为参数传递时查找文件的位置 。
- 异常
netrc.
NetrcParseError
netrc
在源文本中遇到语法错误时,类引发的异常。此异常的实例提供了三个有趣的属性:msg
是错误的文本说明,filename
是源文件的名称,并lineno
给出发现错误的行号。
netrc对象
一个netrc
实例有以下方法:
netrc.
authenticators
(主持人)- 返回主机的3元组验证器。如果netrc文件不包含给定主机的条目,则返回与“default”条目关联的元组。如果匹配的主机和默认条目都不可用,请返回。
(login, account, password)
None
netrc.
__repr__
()- 将类数据转换为netrc文件格式的字符串。(这会丢弃注释并可能对条目重新排序。)
的实例netrc
有公开的实例变量:
netrc.
hosts
- 字典将主机名映射到元组。“default”条目(如果有)按该名称表示为伪主机。
(login, account, password)
netrc.
macros
- 字典将宏名称映射到字符串列表。
注意
密码仅限于ASCII字符集的子集。密码中允许使用所有ASCII标点符号,但请注意密码中不允许使用空格和不可打印字符。这是对.netrc文件解析方式的限制,将来可能会被删除。