publicsuffix 1.1.1

已弃用

请不要使用此模块。它仅出于历史原因提供。新代码应使用其他提供类似功能的库之一。例如

• publicsuffix2

• publicsuffixlist

关于

此模块允许您使用来自http://publicsuffix.org的公共后缀列表获取域名后缀。

公共后缀是用户可以直接注册名称的后缀。一些公共后缀的例子包括 .com、.co.uk 和 pvt.k12.wy.us。准确知道域名后缀对于处理网页浏览器cookies、在用户界面中突出显示域名最重要的部分或按网站排序URL非常有用。

由用户负责为此模块提供适当版本的公共后缀列表。提供了一个方便的函数，可以下载http://publicsuffix.org上可用的最新版本。

模块内容

fetch()函数下载列表的最新版本并返回一个文件对象。您应根据您的应用程序适当地缓存数据

>>> from publicsuffix import fetch
>>> psl_file = fetch()

或者，如果您已经通过其他方式下载了列表

>>> import codecs
>>> psl_file = codecs.open('publicsuffix/public_suffix_list.dat', encoding='utf8')

PublicSuffixList类解析公共后缀列表，并允许对单个域名进行查询

>>> from publicsuffix import PublicSuffixList
>>> psl = PublicSuffixList(psl_file)
>>> psl.get_public_suffix("www.example.com")
'example.com'

请注意，URL的主机部分可能包含不纯DNS域名字符串（IP地址、Punycode编码的名称、与端口号或用户名结合的名称等）。确保只有域名传递给get_public_suffix()方法的责任在于调用者。

安装

要从源代码分发安装并运行单元测试，请使用以下命令

$ python setup.py install
$ python setup.py test

源代码

您可以使用以下命令获取开发仓库的本地副本

git clone https://www.tablix.org/~avian/git/publicsuffix.git

关于向后兼容性的说明

本模块附带一份过时的公共后缀列表副本，以兼容旧版本。由于该列表鼓励应用不更新公共后缀列表数据，其使用已弃用。内置列表将在未来的版本中删除。

如果您在使用不带任何参数的 PublicSuffixList 构造函数，请使用 fetch() 函数并实现适当的缓存，如上所示。

支持

参见上面的弃用通知。如果存在影响尚未迁移到其他库的旧版软件的重大错误，请联系 tomaz.solc@tablix.org。

许可证

版权所有 (c) 2015 Tomaž Šolc <tomaz.solc@tablix.org>

包含在此分发的 Python 模块基于从 http://code.google.com/p/python-public-suffix-list/ 下载的代码，该代码在以下许可下可用

版权所有 (c) 2009 David Wilson

特此授予任何获得此软件及相关文档副本（“软件”）的人免费使用软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和/或销售软件副本的权利，并允许向软件提供者提供软件的人这样做，但前提是遵守以下条件

上述版权声明和本许可声明应包含在软件的所有副本或实质性部分中。

软件按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性、针对特定目的的适用性和非侵权性保证。在任何情况下，作者或版权所有者均不对任何索赔、损害或其他责任负责，无论此类责任是基于合同、侵权或其他方式，是否因软件或其使用或其他方式而产生。

包含在此分发的公共后缀列表已从 http://publicsuffix.org/ 下载，并受单独许可的约束。请参阅文件顶部的许可块。