ipdetailscache 0.4.8

需求/第三方库

这项工作的一部分是基于google python的ip地址操作库（https://code.google.com/p/ipaddr-py/）和jeff ferland的ipy库（https://github.com/autocracy/python-ipy）。

您需要ipaddr或IPy；此库的版本>；=0.2尝试导入ipaddr，然后返回IPy。

您可以使用pip：

• pip install ipaddr
• pip install IPy

pip打包版本安装IPy库。

测试

在tests目录中提供了一些测试。您可以使用nosetests -vs运行它们。

互联网交换点（ixps）信息

从0.3.0版开始，可以使用Internet交换点（IXPS）IP地址空间信息丰富结果。 此功能基于peeringdb.com（www.peeringdb.com）API。

要启用ixps信息收集，请调用缓存的UseIXPs方法。

结果显示在包含以下键的字典中：

- ASN           ["<ASN>" | "unknown" | "not announced"]
- Holder        "string"
- Prefix        "string"
- HostName      "string"
- IsIXP         [ None | bool ]
- IXPName       "string"
- TS            int

主机名是使用本地socket.getfqdn函数获得的。

用法示例：

from pierky.ipdetailscache import IPDetailsCache
cache = IPDetailsCache( IP_ADDRESSES_CACHE_FILE = "ip_addr.cache", IP_PREFIXES_CACHE_FILE = "ip_pref.cache", MAX_CACHE = 604800, Debug = False )
cache.UseIXPs( WhenUse=1, IXP_CACHE_FILE="ixps.cache", MAX_CACHE=604800 )
result = cache.GetIPInformation( "IP_ADDRESS" )

UseIXPs方法的WhenUse参数具有以下含义：

• 0:不使用IXPS信息；
• 1:仅当无法确定ASN（未知或未公布）时才使用IXPS信息
• 2:始终使用ixps信息。

useixps示例，whenuse=1（默认值）

80.81.203.4=de-cix汉堡IP，未公布

80.249.208.1=AMS-IX IP，已发布

>>> cache.UseIXPs()
>>> decix_ip="80.81.203.4"     # DE-CIX Hamburg IP, not announced
>>> amsix_ip="80.249.208.1"    # AMS-IX IP, announced
>>> result = cache.GetIPInformation(decix_ip)
>>> result
{'HostName': 'ge1-1-12-br2.hamburg10.iphh.net', 'TS': 1453068691, 'Prefix': u'80.81.203.4', 'IsIXP': True, 'IXPName': u'DE-CIX Hamburg', 'Holder': '', 'ASN': 'not announced'}
>>> result = cache.GetIPInformation(amsix_ip)
>>> result
{'HostName': 'rtr-eun-01.ams-ix.net', 'TS': 1453068704, 'Prefix': u'80.249.208.0/21', 'IsIXP': None, 'IXPName': '', 'Holder': u'AMS-IX1 Amsterdam Internet Exchange B.V.,NL', 'ASN': '1200'}

AMS-IX IP已经公布，所以^{TT24}$是^{TT19}$，因为这里没有使用任何IXP信息。

当useixps=2

使用rm *.cache清除本地缓存，然后：

>>> from pierky.ipdetailscache import IPDetailsCache
>>> cache = IPDetailsCache()
>>> cache.UseIXPs(WhenUse=2)
>>> decix_ip="80.81.203.4"     # DE-CIX Hamburg IP, not announced
>>> amsix_ip="80.249.208.1"    # AMS-IX IP, announced
>>> result = cache.GetIPInformation(decix_ip)
>>> result
{'HostName': 'ge1-1-12-br2.hamburg10.iphh.net', 'TS': 1453068812, 'Prefix': u'80.81.203.4', 'IsIXP': True, 'IXPName': u'DE-CIX Hamburg', 'Holder': '', 'ASN': 'not announced'}
>>> result = cache.GetIPInformation(amsix_ip)
>>> result
{'HostName': 'rtr-eun-01.ams-ix.net', 'TS': 1453068956, 'Prefix': u'80.249.208.0/21', 'IsIXP': True, 'IXPName': u'AMS-IX', 'Holder': u'AMS-IX1 Amsterdam Internet Exchange B.V.,NL', 'ASN': '1200'}

在这里，即使ams-ix宣布了它的对等lan前缀，ixps信息也被用来丰富结果，因为WhenUse是2。

>>> result = cache.GetIPInformation( "193.0.6.139" )
>>> result
{'HostName': 'www.ripe.net', 'TS': 1453068965, 'Prefix': u'193.0.0.0/21', 'IsIXP': False, 'IXPName': '', 'Holder': u'RIPE-NCC-AS Reseaux IP Europeens Network Coordination Centre (RIPE NCC),NL', 'ASN': '3333'}

www.ripe.net IP不在IXPS对等LAN上，因此^{TT28}$。

0.4.8

• 解决包装问题。

0.4.7

• peeringdb api不再处于beta:url更新状态。

0.4.6

修复

• 缓存IP地址过期时的错误行为。

0.4.5

修复

• ixps信息中的行为变化：如果需要！=0检查ixps信息，也检查具有isixp==none的缓存地址

0.4.4

修复

• 在ixps信息下载中强制使用utf-8

0.4.3

修复

• 如果peeringdb中缺少或错误的ixps信息，请引发ipdetailscacheixpinformationerror

0.4.0至0.4.2

新功能

• 新的打包版本
• PEP8
• .md到.rst以获得更好的pypi可读性

0.3.0

新功能

• IXPS信息