diff options
author | David P. D. Moss <drkjam@gmail.com> | 2009-01-21 01:11:51 +0000 |
---|---|---|
committer | David P. D. Moss <drkjam@gmail.com> | 2009-01-21 01:11:51 +0000 |
commit | 4cccfcdc49b1ea6b1693a49926464f25103b3844 (patch) | |
tree | c7d683d1c6f005aee5a506b9d7ed4071ee065747 /docs | |
parent | ee0b30e666c3be30cd2eaccb88cb08a8bd4147a7 (diff) | |
download | netaddr-4cccfcdc49b1ea6b1693a49926464f25103b3844.tar.gz |
This checkin makes up release 0.6. See CHANGELOG for details.
Diffstat (limited to 'docs')
60 files changed, 15899 insertions, 5107 deletions
diff --git a/docs/api/api-objects.txt b/docs/api/api-objects.txt index 86db877..010b040 100755 --- a/docs/api/api-objects.txt +++ b/docs/api/api-objects.txt @@ -14,67 +14,70 @@ netaddr.ST_EUI64 netaddr-module.html#ST_EUI64 netaddr.address netaddr.address-module.html netaddr.address.AT_STRATEGIES netaddr.address-module.html#AT_STRATEGIES netaddr.address.nrange netaddr.address-module.html#nrange +netaddr.core netaddr.core-module.html +netaddr.eui netaddr.eui-module.html +netaddr.eui.create_ieee_indices netaddr.eui-module.html#create_ieee_indices +netaddr.eui.IEEE_OUI_METADATA netaddr.eui-module.html#IEEE_OUI_METADATA +netaddr.eui.IEEE_IAB_REGISTRY netaddr.eui-module.html#IEEE_IAB_REGISTRY +netaddr.eui.IEEE_OUI_INDEX netaddr.eui-module.html#IEEE_OUI_INDEX +netaddr.eui.IEEE_OUI_REGISTRY netaddr.eui-module.html#IEEE_OUI_REGISTRY +netaddr.eui.IEEE_IAB_METADATA netaddr.eui-module.html#IEEE_IAB_METADATA +netaddr.eui.IEEE_IAB_INDEX netaddr.eui-module.html#IEEE_IAB_INDEX +netaddr.eui.load_ieee_indices netaddr.eui-module.html#load_ieee_indices +netaddr.ip netaddr.ip-module.html +netaddr.ip.IANA_INFO netaddr.ip-module.html#IANA_INFO +netaddr.ip.query netaddr.ip-module.html#query +netaddr.ip.load_iana_info netaddr.ip-module.html#load_iana_info +netaddr.misc netaddr.misc-module.html +netaddr.misc.ipv6_cidr_prefixes netaddr.misc-module.html#ipv6_cidr_prefixes +netaddr.misc.print_ipv6_cidr_prefixes netaddr.misc-module.html#print_ipv6_cidr_prefixes +netaddr.misc.ipv4_cidr_prefixes netaddr.misc-module.html#ipv4_cidr_prefixes +netaddr.misc.print_ipv4_cidr_prefixes netaddr.misc-module.html#print_ipv4_cidr_prefixes netaddr.strategy netaddr.strategy-module.html -netaddr.strategy.ST_EUI48 netaddr.strategy-module.html#ST_EUI48 netaddr.strategy.USE_IPV4_OPT netaddr.strategy-module.html#USE_IPV4_OPT -netaddr.strategy.ST_IPV4 netaddr.strategy-module.html#ST_IPV4 +netaddr.strategy.ST_EUI48 netaddr.strategy-module.html#ST_EUI48 netaddr.strategy._BYTES_TO_BITS netaddr.strategy-module.html#_BYTES_TO_BITS netaddr.strategy.ST_IPV6 netaddr.strategy-module.html#ST_IPV6 +netaddr.strategy.ST_IPV4 netaddr.strategy-module.html#ST_IPV4 netaddr.strategy.ST_EUI64 netaddr.strategy-module.html#ST_EUI64 netaddr.AddrConversionError netaddr.AddrConversionError-class.html netaddr.AddrFormatError netaddr.AddrFormatError-class.html netaddr.address.Addr netaddr.address.Addr-class.html netaddr.address.Addr.__int__ netaddr.address.Addr-class.html#__int__ netaddr.address.Addr.ADDR_TYPES netaddr.address.Addr-class.html#ADDR_TYPES -netaddr.address.Addr.__isub__ netaddr.address.Addr-class.html#__isub__ +netaddr.address.Addr.__ne__ netaddr.address.Addr-class.html#__ne__ netaddr.address.Addr.__str__ netaddr.address.Addr-class.html#__str__ netaddr.address.Addr.value netaddr.address.Addr-class.html#value +netaddr.address.Addr.__and__ netaddr.address.Addr-class.html#__and__ netaddr.address.Addr.__lt__ netaddr.address.Addr-class.html#__lt__ netaddr.address.Addr.__init__ netaddr.address.Addr-class.html#__init__ +netaddr.address.Addr.__sub__ netaddr.address.Addr-class.html#__sub__ +netaddr.address.Addr.__rshift__ netaddr.address.Addr-class.html#__rshift__ +netaddr.address.Addr.__invert__ netaddr.address.Addr-class.html#__invert__ netaddr.address.Addr.strategy netaddr.address.Addr-class.html#strategy +netaddr.address.Addr.packed netaddr.address.Addr-class.html#packed netaddr.address.Addr.bits netaddr.address.Addr-class.html#bits netaddr.address.Addr.addr_type netaddr.address.Addr-class.html#addr_type netaddr.address.Addr.__len__ netaddr.address.Addr-class.html#__len__ -netaddr.address.Addr.__ne__ netaddr.address.Addr-class.html#__ne__ +netaddr.address.Addr.bin netaddr.address.Addr-class.html#bin +netaddr.address.Addr.__isub__ netaddr.address.Addr-class.html#__isub__ +netaddr.address.Addr.__lshift__ netaddr.address.Addr-class.html#__lshift__ netaddr.address.Addr.__getitem__ netaddr.address.Addr-class.html#__getitem__ -netaddr.address.Addr.__iter__ netaddr.address.Addr-class.html#__iter__ +netaddr.address.Addr.__setitem__ netaddr.address.Addr-class.html#__setitem__ +netaddr.address.Addr.__or__ netaddr.address.Addr-class.html#__or__ +netaddr.address.Addr.__add__ netaddr.address.Addr-class.html#__add__ netaddr.address.Addr.__gt__ netaddr.address.Addr-class.html#__gt__ netaddr.address.Addr.__hex__ netaddr.address.Addr-class.html#__hex__ netaddr.address.Addr.__eq__ netaddr.address.Addr-class.html#__eq__ -netaddr.address.Addr.__setitem__ netaddr.address.Addr-class.html#__setitem__ +netaddr.address.Addr.__iter__ netaddr.address.Addr-class.html#__iter__ netaddr.address.Addr.__iadd__ netaddr.address.Addr-class.html#__iadd__ +netaddr.address.Addr.__xor__ netaddr.address.Addr-class.html#__xor__ netaddr.address.Addr.__le__ netaddr.address.Addr-class.html#__le__ netaddr.address.Addr.__repr__ netaddr.address.Addr-class.html#__repr__ netaddr.address.Addr.__hash__ netaddr.address.Addr-class.html#__hash__ netaddr.address.Addr.STRATEGIES netaddr.address.Addr-class.html#STRATEGIES netaddr.address.Addr.__long__ netaddr.address.Addr-class.html#__long__ netaddr.address.Addr.__ge__ netaddr.address.Addr-class.html#__ge__ -netaddr.address.AddrRange netaddr.address.AddrRange-class.html -netaddr.address.AddrRange.ADDR_TYPES netaddr.address.AddrRange-class.html#ADDR_TYPES -netaddr.address.AddrRange.__ne__ netaddr.address.AddrRange-class.html#__ne__ -netaddr.address.AddrRange.__str__ netaddr.address.AddrRange-class.html#__str__ -netaddr.address.AddrRange.data_flavour netaddr.address.AddrRange-class.html#data_flavour -netaddr.address.AddrRange.__lt__ netaddr.address.AddrRange-class.html#__lt__ -netaddr.address.AddrRange.__init__ netaddr.address.AddrRange-class.html#__init__ -netaddr.address.AddrRange.size netaddr.address.AddrRange-class.html#size -netaddr.address.AddrRange.__contains__ netaddr.address.AddrRange-class.html#__contains__ -netaddr.address.AddrRange.strategy netaddr.address.AddrRange-class.html#strategy -netaddr.address.AddrRange.addr_type netaddr.address.AddrRange-class.html#addr_type -netaddr.address.AddrRange.__len__ netaddr.address.AddrRange-class.html#__len__ -netaddr.address.AddrRange.klass netaddr.address.AddrRange-class.html#klass -netaddr.address.AddrRange.__isub__ netaddr.address.AddrRange-class.html#__isub__ -netaddr.address.AddrRange.__getitem__ netaddr.address.AddrRange-class.html#__getitem__ -netaddr.address.AddrRange.__iter__ netaddr.address.AddrRange-class.html#__iter__ -netaddr.address.AddrRange.__gt__ netaddr.address.AddrRange-class.html#__gt__ -netaddr.address.AddrRange.__eq__ netaddr.address.AddrRange-class.html#__eq__ -netaddr.address.AddrRange.last netaddr.address.AddrRange-class.html#last -netaddr.address.AddrRange.__iadd__ netaddr.address.AddrRange-class.html#__iadd__ -netaddr.address.AddrRange.__le__ netaddr.address.AddrRange-class.html#__le__ -netaddr.address.AddrRange.__repr__ netaddr.address.AddrRange-class.html#__repr__ -netaddr.address.AddrRange.__hash__ netaddr.address.AddrRange-class.html#__hash__ -netaddr.address.AddrRange.STRATEGIES netaddr.address.AddrRange-class.html#STRATEGIES -netaddr.address.AddrRange.__ge__ netaddr.address.AddrRange-class.html#__ge__ -netaddr.address.AddrRange.first netaddr.address.AddrRange-class.html#first netaddr.address.AddrTypeDescriptor netaddr.address.AddrTypeDescriptor-class.html netaddr.address.AddrTypeDescriptor.__set__ netaddr.address.AddrTypeDescriptor-class.html#__set__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrTypeDescriptor-class.html#__init__ @@ -84,106 +87,190 @@ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.AddrValueDescriptor netaddr.address.CIDR netaddr.address.CIDR-class.html netaddr.address.CIDR.ADDR_TYPES netaddr.address.CIDR-class.html#ADDR_TYPES netaddr.address.CIDR.hostmask netaddr.address.CIDR-class.html#hostmask -netaddr.address.AddrRange.__isub__ netaddr.address.AddrRange-class.html#__isub__ +netaddr.address.IPRange.__ne__ netaddr.address.IPRange-class.html#__ne__ netaddr.address.CIDR.__str__ netaddr.address.CIDR-class.html#__str__ -netaddr.address.AddrRange.__gt__ netaddr.address.AddrRange-class.html#__gt__ -netaddr.address.AddrRange.data_flavour netaddr.address.AddrRange-class.html#data_flavour +netaddr.address.IPRange.__gt__ netaddr.address.IPRange-class.html#__gt__ netaddr.address.CIDR.prefixlen netaddr.address.CIDR-class.html#prefixlen -netaddr.address.AddrRange.__lt__ netaddr.address.AddrRange-class.html#__lt__ +netaddr.address.IPRange.__lt__ netaddr.address.IPRange-class.html#__lt__ +netaddr.address.IPRange.iprange netaddr.address.IPRange-class.html#iprange netaddr.address.CIDR.__init__ netaddr.address.CIDR-class.html#__init__ -netaddr.address.AddrRange.size netaddr.address.AddrRange-class.html#size -netaddr.address.AddrRange.__contains__ netaddr.address.AddrRange-class.html#__contains__ +netaddr.address.IPRange.size netaddr.address.IPRange-class.html#size +netaddr.address.CIDR.subnet netaddr.address.CIDR-class.html#subnet +netaddr.address.CIDR.span netaddr.address.CIDR-class.html#span +netaddr.address.CIDR.network netaddr.address.CIDR-class.html#network +netaddr.address.IPRange.__contains__ netaddr.address.IPRange-class.html#__contains__ +netaddr.address.IPRange.issupernet netaddr.address.IPRange-class.html#issupernet +netaddr.address.CIDR.fmt netaddr.address.CIDR-class.html#fmt netaddr.address.CIDR.strategy netaddr.address.CIDR-class.html#strategy +netaddr.address.IPRange.adjacent netaddr.address.IPRange-class.html#adjacent netaddr.address.CIDR.addr_type netaddr.address.CIDR-class.html#addr_type -netaddr.address.AddrRange.__len__ netaddr.address.AddrRange-class.html#__len__ -netaddr.address.CIDR.__repr__ netaddr.address.CIDR-class.html#__repr__ -netaddr.address.AddrRange.__ne__ netaddr.address.AddrRange-class.html#__ne__ -netaddr.address.AddrRange.__getitem__ netaddr.address.AddrRange-class.html#__getitem__ +netaddr.address.IPRange.__len__ netaddr.address.IPRange-class.html#__len__ +netaddr.address.IPRange.overlaps netaddr.address.IPRange-class.html#overlaps +netaddr.address.IPRange.__isub__ netaddr.address.IPRange-class.html#__isub__ +netaddr.address.IPRange.__getitem__ netaddr.address.IPRange-class.html#__getitem__ +netaddr.address.IPRange.format netaddr.address.IPRange-class.html#format +netaddr.address.CIDR.broadcast netaddr.address.CIDR-class.html#broadcast netaddr.address.CIDR.netmask netaddr.address.CIDR-class.html#netmask -netaddr.address.CIDR.STRATEGIES netaddr.address.CIDR-class.html#STRATEGIES -netaddr.address.AddrRange.__eq__ netaddr.address.AddrRange-class.html#__eq__ -netaddr.address.CIDR.abbrev_to_verbose netaddr.address.CIDR-class.html#abbrev_to_verbose -netaddr.address.AddrRange.last netaddr.address.AddrRange-class.html#last -netaddr.address.AddrRange.__iter__ netaddr.address.AddrRange-class.html#__iter__ -netaddr.address.AddrRange.__iadd__ netaddr.address.AddrRange-class.html#__iadd__ -netaddr.address.AddrRange.__le__ netaddr.address.AddrRange-class.html#__le__ -netaddr.address.CIDR.klass netaddr.address.CIDR-class.html#klass -netaddr.address.CIDR.wildcard netaddr.address.CIDR-class.html#wildcard -netaddr.address.AddrRange.__hash__ netaddr.address.AddrRange-class.html#__hash__ +netaddr.address.CIDR.__add__ netaddr.address.CIDR-class.html#__add__ netaddr.address.CIDR.__sub__ netaddr.address.CIDR-class.html#__sub__ -netaddr.address.AddrRange.__ge__ netaddr.address.AddrRange-class.html#__ge__ -netaddr.address.AddrRange.first netaddr.address.AddrRange-class.html#first +netaddr.address.IPRange.__eq__ netaddr.address.IPRange-class.html#__eq__ +netaddr.address.CIDR.abbrev_to_verbose netaddr.address.CIDR-class.html#abbrev_to_verbose +netaddr.address.IPRange.last netaddr.address.IPRange-class.html#last +netaddr.address.CIDR.cidrs netaddr.address.CIDR-class.html#cidrs +netaddr.address.IPRange.__iter__ netaddr.address.IPRange-class.html#__iter__ +netaddr.address.IPRange.__iadd__ netaddr.address.IPRange-class.html#__iadd__ +netaddr.address.IPRange.__le__ netaddr.address.IPRange-class.html#__le__ +netaddr.address.CIDR.__repr__ netaddr.address.CIDR-class.html#__repr__ +netaddr.address.IPRange.wildcard netaddr.address.IPRange-class.html#wildcard +netaddr.address.IPRange.issubnet netaddr.address.IPRange-class.html#issubnet +netaddr.address.IPRange.__hash__ netaddr.address.IPRange-class.html#__hash__ +netaddr.address.CIDR.STRATEGIES netaddr.address.CIDR-class.html#STRATEGIES +netaddr.address.IPRange.__ge__ netaddr.address.IPRange-class.html#__ge__ +netaddr.address.IPRange.first netaddr.address.IPRange-class.html#first netaddr.address.EUI netaddr.address.EUI-class.html netaddr.address.Addr.__int__ netaddr.address.Addr-class.html#__int__ netaddr.address.EUI.oui netaddr.address.EUI-class.html#oui netaddr.address.EUI.ei netaddr.address.EUI-class.html#ei netaddr.address.EUI.ADDR_TYPES netaddr.address.EUI-class.html#ADDR_TYPES -netaddr.address.Addr.__ne__ netaddr.address.Addr-class.html#__ne__ +netaddr.address.Addr.__isub__ netaddr.address.Addr-class.html#__isub__ netaddr.address.Addr.__str__ netaddr.address.Addr-class.html#__str__ +netaddr.address.Addr.__gt__ netaddr.address.Addr-class.html#__gt__ +netaddr.address.Addr.__getitem__ netaddr.address.Addr-class.html#__getitem__ netaddr.address.Addr.__iadd__ netaddr.address.Addr-class.html#__iadd__ +netaddr.address.Addr.__and__ netaddr.address.Addr-class.html#__and__ netaddr.address.Addr.__lt__ netaddr.address.Addr-class.html#__lt__ -netaddr.address.EUI.__init__ netaddr.address.EUI-class.html#__init__ +netaddr.address.EUI.iab netaddr.address.EUI-class.html#iab +netaddr.address.Addr.packed netaddr.address.Addr-class.html#packed +netaddr.address.Addr.__rshift__ netaddr.address.Addr-class.html#__rshift__ netaddr.address.EUI.ipv6_link_local netaddr.address.EUI-class.html#ipv6_link_local netaddr.address.EUI.strategy netaddr.address.EUI-class.html#strategy +netaddr.address.EUI.isiab netaddr.address.EUI-class.html#isiab +netaddr.address.EUI.__init__ netaddr.address.EUI-class.html#__init__ netaddr.address.Addr.bits netaddr.address.Addr-class.html#bits netaddr.address.EUI.addr_type netaddr.address.EUI-class.html#addr_type netaddr.address.Addr.__len__ netaddr.address.Addr-class.html#__len__ -netaddr.address.Addr.__isub__ netaddr.address.Addr-class.html#__isub__ -netaddr.address.Addr.__getitem__ netaddr.address.Addr-class.html#__getitem__ +netaddr.address.Addr.bin netaddr.address.Addr-class.html#bin +netaddr.address.Addr.__ne__ netaddr.address.Addr-class.html#__ne__ +netaddr.address.Addr.__invert__ netaddr.address.Addr-class.html#__invert__ +netaddr.address.Addr.__add__ netaddr.address.Addr-class.html#__add__ netaddr.address.Addr.__hash__ netaddr.address.Addr-class.html#__hash__ -netaddr.address.Addr.__iter__ netaddr.address.Addr-class.html#__iter__ -netaddr.address.Addr.__gt__ netaddr.address.Addr-class.html#__gt__ +netaddr.address.Addr.__setitem__ netaddr.address.Addr-class.html#__setitem__ +netaddr.address.Addr.__or__ netaddr.address.Addr-class.html#__or__ +netaddr.address.Addr.__lshift__ netaddr.address.Addr-class.html#__lshift__ +netaddr.address.EUI.STRATEGIES netaddr.address.EUI-class.html#STRATEGIES netaddr.address.Addr.__hex__ netaddr.address.Addr-class.html#__hex__ netaddr.address.Addr.__eq__ netaddr.address.Addr-class.html#__eq__ -netaddr.address.Addr.__setitem__ netaddr.address.Addr-class.html#__setitem__ +netaddr.address.EUI.info netaddr.address.EUI-class.html#info +netaddr.address.Addr.__iter__ netaddr.address.Addr-class.html#__iter__ netaddr.address.Addr.value netaddr.address.Addr-class.html#value +netaddr.address.Addr.__xor__ netaddr.address.Addr-class.html#__xor__ netaddr.address.Addr.__le__ netaddr.address.Addr-class.html#__le__ netaddr.address.Addr.__repr__ netaddr.address.Addr-class.html#__repr__ netaddr.address.EUI.eui64 netaddr.address.EUI-class.html#eui64 -netaddr.address.EUI.STRATEGIES netaddr.address.EUI-class.html#STRATEGIES +netaddr.address.Addr.__sub__ netaddr.address.Addr-class.html#__sub__ netaddr.address.Addr.__long__ netaddr.address.Addr-class.html#__long__ netaddr.address.Addr.__ge__ netaddr.address.Addr-class.html#__ge__ +netaddr.address.FormatDescriptor netaddr.address.FormatDescriptor-class.html +netaddr.address.FormatDescriptor.__set__ netaddr.address.FormatDescriptor-class.html#__set__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.FormatDescriptor-class.html#__init__ netaddr.address.IP netaddr.address.IP-class.html netaddr.address.Addr.__int__ netaddr.address.Addr-class.html#__int__ +netaddr.address.Addr.packed netaddr.address.Addr-class.html#packed netaddr.address.IP.ADDR_TYPES netaddr.address.IP-class.html#ADDR_TYPES -netaddr.address.Addr.__ne__ netaddr.address.Addr-class.html#__ne__ +netaddr.address.Addr.__isub__ netaddr.address.Addr-class.html#__isub__ netaddr.address.IP.__str__ netaddr.address.IP-class.html#__str__ +netaddr.address.Addr.__gt__ netaddr.address.Addr-class.html#__gt__ +netaddr.address.Addr.__and__ netaddr.address.Addr-class.html#__and__ netaddr.address.IP.netmask_bits netaddr.address.IP-class.html#netmask_bits netaddr.address.Addr.__iadd__ netaddr.address.Addr-class.html#__iadd__ netaddr.address.IP.prefixlen netaddr.address.IP-class.html#prefixlen netaddr.address.Addr.__lt__ netaddr.address.Addr-class.html#__lt__ -netaddr.address.IP.__init__ netaddr.address.IP-class.html#__init__ +netaddr.address.IP.iprange netaddr.address.IP-class.html#iprange +netaddr.address.IP.is_ipv4_mapped netaddr.address.IP-class.html#is_ipv4_mapped +netaddr.address.Addr.__rshift__ netaddr.address.Addr-class.html#__rshift__ +netaddr.address.Addr.__getitem__ netaddr.address.Addr-class.html#__getitem__ netaddr.address.IP.hostname netaddr.address.IP-class.html#hostname +netaddr.address.Addr.__iter__ netaddr.address.Addr-class.html#__iter__ netaddr.address.IP.strategy netaddr.address.IP-class.html#strategy netaddr.address.IP.is_unicast netaddr.address.IP-class.html#is_unicast -netaddr.address.IP.ipv4 netaddr.address.IP-class.html#ipv4 +netaddr.address.IP.is_private netaddr.address.IP-class.html#is_private netaddr.address.IP.is_multicast netaddr.address.IP-class.html#is_multicast -netaddr.address.Addr.__setitem__ netaddr.address.Addr-class.html#__setitem__ +netaddr.address.IP.is_ipv4_compat netaddr.address.IP-class.html#is_ipv4_compat netaddr.address.IP.is_netmask netaddr.address.IP-class.html#is_netmask netaddr.address.Addr.bits netaddr.address.Addr-class.html#bits netaddr.address.IP.addr_type netaddr.address.IP-class.html#addr_type netaddr.address.Addr.__len__ netaddr.address.Addr-class.html#__len__ -netaddr.address.Addr.__isub__ netaddr.address.Addr-class.html#__isub__ -netaddr.address.Addr.__getitem__ netaddr.address.Addr-class.html#__getitem__ +netaddr.address.IP.ipv4 netaddr.address.IP-class.html#ipv4 +netaddr.address.Addr.bin netaddr.address.Addr-class.html#bin +netaddr.address.Addr.__ne__ netaddr.address.Addr-class.html#__ne__ +netaddr.address.IP.wildcard netaddr.address.IP-class.html#wildcard +netaddr.address.Addr.__invert__ netaddr.address.Addr-class.html#__invert__ +netaddr.address.Addr.__add__ netaddr.address.Addr-class.html#__add__ netaddr.address.IP.ipv6 netaddr.address.IP-class.html#ipv6 +netaddr.address.IP.is_link_local netaddr.address.IP-class.html#is_link_local netaddr.address.IP.is_hostmask netaddr.address.IP-class.html#is_hostmask -netaddr.address.Addr.__gt__ netaddr.address.Addr-class.html#__gt__ +netaddr.address.Addr.__or__ netaddr.address.Addr-class.html#__or__ +netaddr.address.Addr.__lshift__ netaddr.address.Addr-class.html#__lshift__ +netaddr.address.Addr.__sub__ netaddr.address.Addr-class.html#__sub__ netaddr.address.Addr.__hex__ netaddr.address.Addr-class.html#__hex__ netaddr.address.IP.cidr netaddr.address.IP-class.html#cidr netaddr.address.IP.TRANSLATE_STR netaddr.address.IP-class.html#TRANSLATE_STR netaddr.address.Addr.__eq__ netaddr.address.Addr-class.html#__eq__ -netaddr.address.Addr.__iter__ netaddr.address.Addr-class.html#__iter__ +netaddr.address.IP._ netaddr.address.IP-class.html#_ +netaddr.address.IP.info netaddr.address.IP-class.html#info +netaddr.address.IP.is_reserved netaddr.address.IP-class.html#is_reserved +netaddr.address.IP.is_loopback netaddr.address.IP-class.html#is_loopback +netaddr.address.Addr.__setitem__ netaddr.address.Addr-class.html#__setitem__ netaddr.address.Addr.value netaddr.address.Addr-class.html#value +netaddr.address.Addr.__xor__ netaddr.address.Addr-class.html#__xor__ netaddr.address.IP.reverse_dns netaddr.address.IP-class.html#reverse_dns netaddr.address.Addr.__le__ netaddr.address.Addr-class.html#__le__ netaddr.address.IP.__repr__ netaddr.address.IP-class.html#__repr__ +netaddr.address.IP.__init__ netaddr.address.IP-class.html#__init__ netaddr.address.Addr.__hash__ netaddr.address.Addr-class.html#__hash__ netaddr.address.IP.STRATEGIES netaddr.address.IP-class.html#STRATEGIES netaddr.address.Addr.__long__ netaddr.address.Addr-class.html#__long__ netaddr.address.Addr.__ge__ netaddr.address.Addr-class.html#__ge__ -netaddr.address.KlassDescriptor netaddr.address.KlassDescriptor-class.html -netaddr.address.KlassDescriptor.__set__ netaddr.address.KlassDescriptor-class.html#__set__ -netaddr.address.KlassDescriptor.__init__ netaddr.address.KlassDescriptor-class.html#__init__ +netaddr.address.IPRange netaddr.address.IPRange-class.html +netaddr.address.IPRange.ADDR_TYPES netaddr.address.IPRange-class.html#ADDR_TYPES +netaddr.address.IPRange.__isub__ netaddr.address.IPRange-class.html#__isub__ +netaddr.address.IPRange.__str__ netaddr.address.IPRange-class.html#__str__ +netaddr.address.IPRange.__lt__ netaddr.address.IPRange-class.html#__lt__ +netaddr.address.IPRange.iprange netaddr.address.IPRange-class.html#iprange +netaddr.address.IPRange.__init__ netaddr.address.IPRange-class.html#__init__ +netaddr.address.IPRange.size netaddr.address.IPRange-class.html#size +netaddr.address.IPRange.__contains__ netaddr.address.IPRange-class.html#__contains__ +netaddr.address.IPRange.issupernet netaddr.address.IPRange-class.html#issupernet +netaddr.address.IPRange.fmt netaddr.address.IPRange-class.html#fmt +netaddr.address.IPRange.strategy netaddr.address.IPRange-class.html#strategy +netaddr.address.IPRange.adjacent netaddr.address.IPRange-class.html#adjacent +netaddr.address.IPRange.addr_type netaddr.address.IPRange-class.html#addr_type +netaddr.address.IPRange.__len__ netaddr.address.IPRange-class.html#__len__ +netaddr.address.IPRange.overlaps netaddr.address.IPRange-class.html#overlaps +netaddr.address.IPRange.__ne__ netaddr.address.IPRange-class.html#__ne__ +netaddr.address.IPRange.__getitem__ netaddr.address.IPRange-class.html#__getitem__ +netaddr.address.IPRange.format netaddr.address.IPRange-class.html#format +netaddr.address.IPRange.__iter__ netaddr.address.IPRange-class.html#__iter__ +netaddr.address.IPRange.__gt__ netaddr.address.IPRange-class.html#__gt__ +netaddr.address.IPRange.__eq__ netaddr.address.IPRange-class.html#__eq__ +netaddr.address.IPRange.last netaddr.address.IPRange-class.html#last +netaddr.address.IPRange.cidrs netaddr.address.IPRange-class.html#cidrs +netaddr.address.IPRange.__iadd__ netaddr.address.IPRange-class.html#__iadd__ +netaddr.address.IPRange.__le__ netaddr.address.IPRange-class.html#__le__ +netaddr.address.IPRange.__repr__ netaddr.address.IPRange-class.html#__repr__ +netaddr.address.IPRange.wildcard netaddr.address.IPRange-class.html#wildcard +netaddr.address.IPRange.issubnet netaddr.address.IPRange-class.html#issubnet +netaddr.address.IPRange.__hash__ netaddr.address.IPRange-class.html#__hash__ +netaddr.address.IPRange.STRATEGIES netaddr.address.IPRange-class.html#STRATEGIES +netaddr.address.IPRange.__ge__ netaddr.address.IPRange-class.html#__ge__ +netaddr.address.IPRange.first netaddr.address.IPRange-class.html#first +netaddr.address.IPRangeSet netaddr.address.IPRangeSet-class.html +netaddr.address.IPRangeSet.max_match netaddr.address.IPRangeSet-class.html#max_match +netaddr.address.IPRangeSet.__init__ netaddr.address.IPRangeSet-class.html#__init__ +netaddr.address.IPRangeSet.any_match netaddr.address.IPRangeSet-class.html#any_match +netaddr.address.IPRangeSet.__contains__ netaddr.address.IPRangeSet-class.html#__contains__ +netaddr.address.IPRangeSet.all_matches netaddr.address.IPRangeSet-class.html#all_matches +netaddr.address.IPRangeSet.min_match netaddr.address.IPRangeSet-class.html#min_match netaddr.address.PrefixLenDescriptor netaddr.address.PrefixLenDescriptor-class.html netaddr.address.PrefixLenDescriptor.__set__ netaddr.address.PrefixLenDescriptor-class.html#__set__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.PrefixLenDescriptor-class.html#__init__ @@ -192,137 +279,207 @@ netaddr.address.StrategyDescriptor.__set__ netaddr.address.StrategyDescriptor-cl netaddr.address.StrategyDescriptor.__init__ netaddr.address.StrategyDescriptor-class.html#__init__ netaddr.address.Wildcard netaddr.address.Wildcard-class.html netaddr.address.Wildcard.ADDR_TYPES netaddr.address.Wildcard-class.html#ADDR_TYPES -netaddr.address.AddrRange.__isub__ netaddr.address.AddrRange-class.html#__isub__ +netaddr.address.IPRange.__ne__ netaddr.address.IPRange-class.html#__ne__ netaddr.address.Wildcard.__str__ netaddr.address.Wildcard-class.html#__str__ -netaddr.address.AddrRange.data_flavour netaddr.address.AddrRange-class.html#data_flavour -netaddr.address.AddrRange.__lt__ netaddr.address.AddrRange-class.html#__lt__ +netaddr.address.IPRange.__lt__ netaddr.address.IPRange-class.html#__lt__ +netaddr.address.IPRange.iprange netaddr.address.IPRange-class.html#iprange netaddr.address.Wildcard.__init__ netaddr.address.Wildcard-class.html#__init__ -netaddr.address.AddrRange.size netaddr.address.AddrRange-class.html#size -netaddr.address.AddrRange.__contains__ netaddr.address.AddrRange-class.html#__contains__ +netaddr.address.IPRange.size netaddr.address.IPRange-class.html#size +netaddr.address.IPRange.__contains__ netaddr.address.IPRange-class.html#__contains__ +netaddr.address.IPRange.issupernet netaddr.address.IPRange-class.html#issupernet +netaddr.address.Wildcard.fmt netaddr.address.Wildcard-class.html#fmt netaddr.address.Wildcard.strategy netaddr.address.Wildcard-class.html#strategy netaddr.address.Wildcard.is_valid netaddr.address.Wildcard-class.html#is_valid +netaddr.address.IPRange.adjacent netaddr.address.IPRange-class.html#adjacent netaddr.address.Wildcard.addr_type netaddr.address.Wildcard-class.html#addr_type -netaddr.address.AddrRange.__len__ netaddr.address.AddrRange-class.html#__len__ -netaddr.address.Wildcard.klass netaddr.address.Wildcard-class.html#klass -netaddr.address.AddrRange.__ne__ netaddr.address.AddrRange-class.html#__ne__ -netaddr.address.AddrRange.__getitem__ netaddr.address.AddrRange-class.html#__getitem__ -netaddr.address.AddrRange.__iter__ netaddr.address.AddrRange-class.html#__iter__ -netaddr.address.AddrRange.__gt__ netaddr.address.AddrRange-class.html#__gt__ -netaddr.address.Wildcard.cidr netaddr.address.Wildcard-class.html#cidr -netaddr.address.AddrRange.__eq__ netaddr.address.AddrRange-class.html#__eq__ -netaddr.address.AddrRange.last netaddr.address.AddrRange-class.html#last -netaddr.address.AddrRange.__iadd__ netaddr.address.AddrRange-class.html#__iadd__ -netaddr.address.AddrRange.__le__ netaddr.address.AddrRange-class.html#__le__ +netaddr.address.IPRange.__len__ netaddr.address.IPRange-class.html#__len__ +netaddr.address.IPRange.overlaps netaddr.address.IPRange-class.html#overlaps +netaddr.address.IPRange.__isub__ netaddr.address.IPRange-class.html#__isub__ +netaddr.address.IPRange.__getitem__ netaddr.address.IPRange-class.html#__getitem__ +netaddr.address.IPRange.format netaddr.address.IPRange-class.html#format +netaddr.address.IPRange.__iter__ netaddr.address.IPRange-class.html#__iter__ +netaddr.address.IPRange.__gt__ netaddr.address.IPRange-class.html#__gt__ +netaddr.address.IPRange.__eq__ netaddr.address.IPRange-class.html#__eq__ +netaddr.address.IPRange.last netaddr.address.IPRange-class.html#last +netaddr.address.IPRange.cidrs netaddr.address.IPRange-class.html#cidrs +netaddr.address.IPRange.__iadd__ netaddr.address.IPRange-class.html#__iadd__ +netaddr.address.IPRange.__le__ netaddr.address.IPRange-class.html#__le__ netaddr.address.Wildcard.__repr__ netaddr.address.Wildcard-class.html#__repr__ -netaddr.address.AddrRange.__hash__ netaddr.address.AddrRange-class.html#__hash__ +netaddr.address.IPRange.wildcard netaddr.address.IPRange-class.html#wildcard +netaddr.address.IPRange.issubnet netaddr.address.IPRange-class.html#issubnet +netaddr.address.IPRange.__hash__ netaddr.address.IPRange-class.html#__hash__ netaddr.address.Wildcard.STRATEGIES netaddr.address.Wildcard-class.html#STRATEGIES -netaddr.address.AddrRange.__ge__ netaddr.address.AddrRange-class.html#__ge__ -netaddr.address.AddrRange.first netaddr.address.AddrRange-class.html#first +netaddr.address.IPRange.__ge__ netaddr.address.IPRange-class.html#__ge__ +netaddr.address.IPRange.first netaddr.address.IPRange-class.html#first +netaddr.core.PrettyPrinter netaddr.core.PrettyPrinter-class.html +netaddr.core.PrettyPrinter.update netaddr.core.PrettyPrinter-class.html#update +netaddr.core.PrettyPrinter.__init__ netaddr.core.PrettyPrinter-class.html#__init__ +netaddr.core.Publisher netaddr.core.Publisher-class.html +netaddr.core.Publisher.attach netaddr.core.Publisher-class.html#attach +netaddr.core.Publisher.notify netaddr.core.Publisher-class.html#notify +netaddr.core.Publisher.detach netaddr.core.Publisher-class.html#detach +netaddr.core.Publisher.__init__ netaddr.core.Publisher-class.html#__init__ +netaddr.core.Subscriber netaddr.core.Subscriber-class.html +netaddr.core.Subscriber.update netaddr.core.Subscriber-class.html#update +netaddr.eui.FileIndexer netaddr.eui.FileIndexer-class.html +netaddr.eui.FileIndexer.update netaddr.eui.FileIndexer-class.html#update +netaddr.eui.FileIndexer.__init__ netaddr.eui.FileIndexer-class.html#__init__ +netaddr.eui.IAB netaddr.eui.IAB-class.html +netaddr.eui.IAB.__int__ netaddr.eui.IAB-class.html#__int__ +netaddr.eui.IAB.organisation netaddr.eui.IAB-class.html#organisation +netaddr.eui.IAB.registration netaddr.eui.IAB-class.html#registration +netaddr.eui.IAB.split_iab_mac netaddr.eui.IAB-class.html#split_iab_mac +netaddr.eui.IAB._parse_data netaddr.eui.IAB-class.html#_parse_data +netaddr.eui.IAB.__repr__ netaddr.eui.IAB-class.html#__repr__ +netaddr.eui.IAB.address netaddr.eui.IAB-class.html#address +netaddr.eui.IAB.__hex__ netaddr.eui.IAB-class.html#__hex__ +netaddr.eui.IAB.org netaddr.eui.IAB-class.html#org +netaddr.eui.IAB.__str__ netaddr.eui.IAB-class.html#__str__ +netaddr.eui.IAB.__init__ netaddr.eui.IAB-class.html#__init__ +netaddr.eui.IABIndexParser netaddr.eui.IABIndexParser-class.html +netaddr.eui.IABIndexParser.parse netaddr.eui.IABIndexParser-class.html#parse +netaddr.core.Publisher.attach netaddr.core.Publisher-class.html#attach +netaddr.core.Publisher.notify netaddr.core.Publisher-class.html#notify +netaddr.core.Publisher.detach netaddr.core.Publisher-class.html#detach +netaddr.eui.IABIndexParser.__init__ netaddr.eui.IABIndexParser-class.html#__init__ +netaddr.eui.NotRegisteredError netaddr.eui.NotRegisteredError-class.html +netaddr.eui.OUI netaddr.eui.OUI-class.html +netaddr.eui.OUI.__int__ netaddr.eui.OUI-class.html#__int__ +netaddr.eui.OUI.organisation netaddr.eui.OUI-class.html#organisation +netaddr.eui.OUI.address netaddr.eui.OUI-class.html#address +netaddr.eui.OUI._parse_data netaddr.eui.OUI-class.html#_parse_data +netaddr.eui.OUI.__repr__ netaddr.eui.OUI-class.html#__repr__ +netaddr.eui.OUI.registration netaddr.eui.OUI-class.html#registration +netaddr.eui.OUI.__hex__ netaddr.eui.OUI-class.html#__hex__ +netaddr.eui.OUI.org netaddr.eui.OUI-class.html#org +netaddr.eui.OUI.__str__ netaddr.eui.OUI-class.html#__str__ +netaddr.eui.OUI.__init__ netaddr.eui.OUI-class.html#__init__ +netaddr.eui.OUI.org_count netaddr.eui.OUI-class.html#org_count +netaddr.eui.OUIIndexParser netaddr.eui.OUIIndexParser-class.html +netaddr.eui.OUIIndexParser.parse netaddr.eui.OUIIndexParser-class.html#parse +netaddr.core.Publisher.attach netaddr.core.Publisher-class.html#attach +netaddr.core.Publisher.notify netaddr.core.Publisher-class.html#notify +netaddr.core.Publisher.detach netaddr.core.Publisher-class.html#detach +netaddr.eui.OUIIndexParser.__init__ netaddr.eui.OUIIndexParser-class.html#__init__ +netaddr.ip.DictUpdater netaddr.ip.DictUpdater-class.html +netaddr.ip.DictUpdater.update netaddr.ip.DictUpdater-class.html#update +netaddr.ip.DictUpdater.__init__ netaddr.ip.DictUpdater-class.html#__init__ +netaddr.ip.IPv4Parser netaddr.ip.IPv4Parser-class.html +netaddr.ip.LineRecordParser.parse netaddr.ip.LineRecordParser-class.html#parse +netaddr.core.Publisher.attach netaddr.core.Publisher-class.html#attach +netaddr.ip.IPv4Parser.parse_line netaddr.ip.IPv4Parser-class.html#parse_line +netaddr.core.Publisher.notify netaddr.core.Publisher-class.html#notify +netaddr.core.Publisher.detach netaddr.core.Publisher-class.html#detach +netaddr.ip.IPv4Parser.__init__ netaddr.ip.IPv4Parser-class.html#__init__ +netaddr.ip.IPv6Parser netaddr.ip.IPv6Parser-class.html +netaddr.ip.LineRecordParser.parse netaddr.ip.LineRecordParser-class.html#parse +netaddr.core.Publisher.attach netaddr.core.Publisher-class.html#attach +netaddr.ip.IPv6Parser.parse_line netaddr.ip.IPv6Parser-class.html#parse_line +netaddr.core.Publisher.notify netaddr.core.Publisher-class.html#notify +netaddr.core.Publisher.detach netaddr.core.Publisher-class.html#detach +netaddr.ip.IPv6Parser.__init__ netaddr.ip.IPv6Parser-class.html#__init__ +netaddr.ip.LineRecordParser netaddr.ip.LineRecordParser-class.html +netaddr.ip.LineRecordParser.parse netaddr.ip.LineRecordParser-class.html#parse +netaddr.core.Publisher.attach netaddr.core.Publisher-class.html#attach +netaddr.ip.LineRecordParser.parse_line netaddr.ip.LineRecordParser-class.html#parse_line +netaddr.core.Publisher.notify netaddr.core.Publisher-class.html#notify +netaddr.core.Publisher.detach netaddr.core.Publisher-class.html#detach +netaddr.ip.LineRecordParser.__init__ netaddr.ip.LineRecordParser-class.html#__init__ +netaddr.ip.MulticastParser netaddr.ip.MulticastParser-class.html +netaddr.ip.MulticastParser.normalise_addr netaddr.ip.MulticastParser-class.html#normalise_addr +netaddr.ip.LineRecordParser.parse netaddr.ip.LineRecordParser-class.html#parse +netaddr.core.Publisher.attach netaddr.core.Publisher-class.html#attach +netaddr.ip.MulticastParser.parse_line netaddr.ip.MulticastParser-class.html#parse_line +netaddr.core.Publisher.notify netaddr.core.Publisher-class.html#notify +netaddr.core.Publisher.detach netaddr.core.Publisher-class.html#detach +netaddr.ip.MulticastParser.__init__ netaddr.ip.MulticastParser-class.html#__init__ netaddr.strategy.AddrStrategy netaddr.strategy.AddrStrategy-class.html -netaddr.strategy.AddrStrategy.words_to_str netaddr.strategy.AddrStrategy-class.html#words_to_str netaddr.strategy.AddrStrategy.int_to_bits netaddr.strategy.AddrStrategy-class.html#int_to_bits -netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits +netaddr.strategy.AddrStrategy.int_to_packed netaddr.strategy.AddrStrategy-class.html#int_to_packed +netaddr.strategy.AddrStrategy.int_to_words netaddr.strategy.AddrStrategy-class.html#int_to_words netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.AddrStrategy-class.html#__init__ +netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits netaddr.strategy.AddrStrategy.valid_int netaddr.strategy.AddrStrategy-class.html#valid_int -netaddr.strategy.AddrStrategy.str_to_bits netaddr.strategy.AddrStrategy-class.html#str_to_bits -netaddr.strategy.AddrStrategy.str_to_words netaddr.strategy.AddrStrategy-class.html#str_to_words -netaddr.strategy.AddrStrategy.bits_to_words netaddr.strategy.AddrStrategy-class.html#bits_to_words -netaddr.strategy.AddrStrategy.int_to_words netaddr.strategy.AddrStrategy-class.html#int_to_words -netaddr.strategy.AddrStrategy.description netaddr.strategy.AddrStrategy-class.html#description +netaddr.strategy.AddrStrategy.packed_to_int netaddr.strategy.AddrStrategy-class.html#packed_to_int netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.AddrStrategy-class.html#int_to_str netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.AddrStrategy-class.html#valid_str -netaddr.strategy.AddrStrategy.word_to_bits netaddr.strategy.AddrStrategy-class.html#word_to_bits netaddr.strategy.AddrStrategy.bits_to_int netaddr.strategy.AddrStrategy-class.html#bits_to_int netaddr.strategy.AddrStrategy.str_to_int netaddr.strategy.AddrStrategy-class.html#str_to_int netaddr.strategy.AddrStrategy.words_to_int netaddr.strategy.AddrStrategy-class.html#words_to_int netaddr.strategy.AddrStrategy.valid_words netaddr.strategy.AddrStrategy-class.html#valid_words netaddr.strategy.AddrStrategy.__repr__ netaddr.strategy.AddrStrategy-class.html#__repr__ -netaddr.strategy.AddrStrategy.words_to_bits netaddr.strategy.AddrStrategy-class.html#words_to_bits -netaddr.strategy.AddrStrategy.bits_to_str netaddr.strategy.AddrStrategy-class.html#bits_to_str +netaddr.strategy.AddrStrategy.int_to_bin netaddr.strategy.AddrStrategy-class.html#int_to_bin +netaddr.strategy.AddrStrategy.STRUCT_FORMATS netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS netaddr.strategy.EUI48Strategy netaddr.strategy.EUI48Strategy-class.html -netaddr.strategy.AddrStrategy.words_to_str netaddr.strategy.AddrStrategy-class.html#words_to_str netaddr.strategy.AddrStrategy.int_to_bits netaddr.strategy.AddrStrategy-class.html#int_to_bits -netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits +netaddr.strategy.AddrStrategy.int_to_packed netaddr.strategy.AddrStrategy-class.html#int_to_packed +netaddr.strategy.AddrStrategy.int_to_words netaddr.strategy.AddrStrategy-class.html#int_to_words netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.EUI48Strategy-class.html#__init__ +netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits netaddr.strategy.AddrStrategy.valid_int netaddr.strategy.AddrStrategy-class.html#valid_int -netaddr.strategy.AddrStrategy.str_to_bits netaddr.strategy.AddrStrategy-class.html#str_to_bits -netaddr.strategy.EUI48Strategy.str_to_words netaddr.strategy.EUI48Strategy-class.html#str_to_words -netaddr.strategy.AddrStrategy.word_to_bits netaddr.strategy.AddrStrategy-class.html#word_to_bits -netaddr.strategy.AddrStrategy.int_to_words netaddr.strategy.AddrStrategy-class.html#int_to_words -netaddr.strategy.AddrStrategy.description netaddr.strategy.AddrStrategy-class.html#description -netaddr.strategy.AddrStrategy.bits_to_words netaddr.strategy.AddrStrategy-class.html#bits_to_words -netaddr.strategy.EUI48Strategy.valid_str netaddr.strategy.EUI48Strategy-class.html#valid_str +netaddr.strategy.AddrStrategy.packed_to_int netaddr.strategy.AddrStrategy-class.html#packed_to_int +netaddr.strategy.EUI48Strategy.RE_MAC_FORMATS netaddr.strategy.EUI48Strategy-class.html#RE_MAC_FORMATS netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.EUI48Strategy-class.html#int_to_str +netaddr.strategy.EUI48Strategy.valid_str netaddr.strategy.EUI48Strategy-class.html#valid_str netaddr.strategy.AddrStrategy.bits_to_int netaddr.strategy.AddrStrategy-class.html#bits_to_int -netaddr.strategy.AddrStrategy.str_to_int netaddr.strategy.AddrStrategy-class.html#str_to_int +netaddr.strategy.EUI48Strategy._ netaddr.strategy.EUI48Strategy-class.html#_ +netaddr.strategy.EUI48Strategy.str_to_int netaddr.strategy.EUI48Strategy-class.html#str_to_int netaddr.strategy.AddrStrategy.words_to_int netaddr.strategy.AddrStrategy-class.html#words_to_int netaddr.strategy.AddrStrategy.valid_words netaddr.strategy.AddrStrategy-class.html#valid_words netaddr.strategy.AddrStrategy.__repr__ netaddr.strategy.AddrStrategy-class.html#__repr__ -netaddr.strategy.AddrStrategy.words_to_bits netaddr.strategy.AddrStrategy-class.html#words_to_bits -netaddr.strategy.AddrStrategy.bits_to_str netaddr.strategy.AddrStrategy-class.html#bits_to_str +netaddr.strategy.AddrStrategy.int_to_bin netaddr.strategy.AddrStrategy-class.html#int_to_bin +netaddr.strategy.AddrStrategy.STRUCT_FORMATS netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS netaddr.strategy.IPv4StrategyOpt netaddr.strategy.IPv4StrategyOpt-class.html -netaddr.strategy.AddrStrategy.words_to_str netaddr.strategy.AddrStrategy-class.html#words_to_str netaddr.strategy.AddrStrategy.int_to_bits netaddr.strategy.AddrStrategy-class.html#int_to_bits +netaddr.strategy.AddrStrategy.int_to_packed netaddr.strategy.AddrStrategy-class.html#int_to_packed netaddr.strategy.IPv4StrategyOpt.int_to_words netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyOpt-class.html#__init__ netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits netaddr.strategy.AddrStrategy.valid_int netaddr.strategy.AddrStrategy-class.html#valid_int -netaddr.strategy.AddrStrategy.word_to_bits netaddr.strategy.AddrStrategy-class.html#word_to_bits -netaddr.strategy.AddrStrategy.str_to_bits netaddr.strategy.AddrStrategy-class.html#str_to_bits -netaddr.strategy.AddrStrategy.str_to_words netaddr.strategy.AddrStrategy-class.html#str_to_words -netaddr.strategy.IPv4StrategyStd.int_to_arpa netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa -netaddr.strategy.AddrStrategy.description netaddr.strategy.AddrStrategy-class.html#description -netaddr.strategy.AddrStrategy.bits_to_words netaddr.strategy.AddrStrategy-class.html#bits_to_words -netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.AddrStrategy-class.html#valid_str +netaddr.strategy.AddrStrategy.valid_words netaddr.strategy.AddrStrategy-class.html#valid_words +netaddr.strategy.AddrStrategy.packed_to_int netaddr.strategy.AddrStrategy-class.html#packed_to_int netaddr.strategy.IPv4StrategyOpt.int_to_str netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str +netaddr.strategy.IPv4StrategyOpt.valid_str netaddr.strategy.IPv4StrategyOpt-class.html#valid_str netaddr.strategy.AddrStrategy.bits_to_int netaddr.strategy.AddrStrategy-class.html#bits_to_int netaddr.strategy.IPv4StrategyOpt.str_to_int netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int netaddr.strategy.IPv4StrategyOpt.words_to_int netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int -netaddr.strategy.AddrStrategy.valid_words netaddr.strategy.AddrStrategy-class.html#valid_words +netaddr.strategy.IPv4StrategyStd.int_to_arpa netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa netaddr.strategy.AddrStrategy.__repr__ netaddr.strategy.AddrStrategy-class.html#__repr__ -netaddr.strategy.AddrStrategy.words_to_bits netaddr.strategy.AddrStrategy-class.html#words_to_bits -netaddr.strategy.AddrStrategy.bits_to_str netaddr.strategy.AddrStrategy-class.html#bits_to_str +netaddr.strategy.AddrStrategy.int_to_bin netaddr.strategy.AddrStrategy-class.html#int_to_bin +netaddr.strategy.AddrStrategy.STRUCT_FORMATS netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS netaddr.strategy.IPv4StrategyStd netaddr.strategy.IPv4StrategyStd-class.html -netaddr.strategy.AddrStrategy.words_to_str netaddr.strategy.AddrStrategy-class.html#words_to_str netaddr.strategy.AddrStrategy.int_to_bits netaddr.strategy.AddrStrategy-class.html#int_to_bits -netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits +netaddr.strategy.AddrStrategy.int_to_packed netaddr.strategy.AddrStrategy-class.html#int_to_packed +netaddr.strategy.AddrStrategy.int_to_words netaddr.strategy.AddrStrategy-class.html#int_to_words netaddr.strategy.IPv4StrategyStd.__init__ netaddr.strategy.IPv4StrategyStd-class.html#__init__ +netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits netaddr.strategy.AddrStrategy.valid_int netaddr.strategy.AddrStrategy-class.html#valid_int -netaddr.strategy.AddrStrategy.word_to_bits netaddr.strategy.AddrStrategy-class.html#word_to_bits -netaddr.strategy.AddrStrategy.str_to_bits netaddr.strategy.AddrStrategy-class.html#str_to_bits -netaddr.strategy.AddrStrategy.str_to_words netaddr.strategy.AddrStrategy-class.html#str_to_words netaddr.strategy.AddrStrategy.valid_words netaddr.strategy.AddrStrategy-class.html#valid_words -netaddr.strategy.AddrStrategy.int_to_words netaddr.strategy.AddrStrategy-class.html#int_to_words -netaddr.strategy.AddrStrategy.description netaddr.strategy.AddrStrategy-class.html#description -netaddr.strategy.AddrStrategy.bits_to_words netaddr.strategy.AddrStrategy-class.html#bits_to_words -netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.AddrStrategy-class.html#valid_str +netaddr.strategy.AddrStrategy.packed_to_int netaddr.strategy.AddrStrategy-class.html#packed_to_int netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.AddrStrategy-class.html#int_to_str +netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.AddrStrategy-class.html#valid_str netaddr.strategy.AddrStrategy.bits_to_int netaddr.strategy.AddrStrategy-class.html#bits_to_int netaddr.strategy.AddrStrategy.str_to_int netaddr.strategy.AddrStrategy-class.html#str_to_int netaddr.strategy.AddrStrategy.words_to_int netaddr.strategy.AddrStrategy-class.html#words_to_int netaddr.strategy.IPv4StrategyStd.int_to_arpa netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa netaddr.strategy.AddrStrategy.__repr__ netaddr.strategy.AddrStrategy-class.html#__repr__ -netaddr.strategy.AddrStrategy.words_to_bits netaddr.strategy.AddrStrategy-class.html#words_to_bits -netaddr.strategy.AddrStrategy.bits_to_str netaddr.strategy.AddrStrategy-class.html#bits_to_str +netaddr.strategy.AddrStrategy.int_to_bin netaddr.strategy.AddrStrategy-class.html#int_to_bin +netaddr.strategy.AddrStrategy.STRUCT_FORMATS netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS netaddr.strategy.IPv6Strategy netaddr.strategy.IPv6Strategy-class.html -netaddr.strategy.AddrStrategy.words_to_str netaddr.strategy.AddrStrategy-class.html#words_to_str netaddr.strategy.AddrStrategy.int_to_bits netaddr.strategy.AddrStrategy-class.html#int_to_bits +netaddr.strategy.AddrStrategy.int_to_packed netaddr.strategy.AddrStrategy-class.html#int_to_packed netaddr.strategy.AddrStrategy.valid_bits netaddr.strategy.AddrStrategy-class.html#valid_bits netaddr.strategy.IPv6Strategy.__init__ netaddr.strategy.IPv6Strategy-class.html#__init__ netaddr.strategy.AddrStrategy.valid_int netaddr.strategy.AddrStrategy-class.html#valid_int -netaddr.strategy.AddrStrategy.word_to_bits netaddr.strategy.AddrStrategy-class.html#word_to_bits -netaddr.strategy.AddrStrategy.str_to_bits netaddr.strategy.AddrStrategy-class.html#str_to_bits -netaddr.strategy.AddrStrategy.str_to_words netaddr.strategy.AddrStrategy-class.html#str_to_words -netaddr.strategy.IPv6Strategy.int_to_arpa netaddr.strategy.IPv6Strategy-class.html#int_to_arpa +netaddr.strategy.AddrStrategy.valid_words netaddr.strategy.AddrStrategy-class.html#valid_words +netaddr.strategy.AddrStrategy.packed_to_int netaddr.strategy.AddrStrategy-class.html#packed_to_int netaddr.strategy.AddrStrategy.int_to_words netaddr.strategy.AddrStrategy-class.html#int_to_words -netaddr.strategy.AddrStrategy.description netaddr.strategy.AddrStrategy-class.html#description -netaddr.strategy.AddrStrategy.bits_to_words netaddr.strategy.AddrStrategy-class.html#bits_to_words -netaddr.strategy.IPv6Strategy.valid_str netaddr.strategy.IPv6Strategy-class.html#valid_str netaddr.strategy.IPv6Strategy.int_to_str netaddr.strategy.IPv6Strategy-class.html#int_to_str +netaddr.strategy.IPv6Strategy.valid_str netaddr.strategy.IPv6Strategy-class.html#valid_str netaddr.strategy.AddrStrategy.bits_to_int netaddr.strategy.AddrStrategy-class.html#bits_to_int netaddr.strategy.IPv6Strategy.str_to_int netaddr.strategy.IPv6Strategy-class.html#str_to_int netaddr.strategy.AddrStrategy.words_to_int netaddr.strategy.AddrStrategy-class.html#words_to_int -netaddr.strategy.AddrStrategy.valid_words netaddr.strategy.AddrStrategy-class.html#valid_words +netaddr.strategy.IPv6Strategy.int_to_arpa netaddr.strategy.IPv6Strategy-class.html#int_to_arpa netaddr.strategy.AddrStrategy.__repr__ netaddr.strategy.AddrStrategy-class.html#__repr__ -netaddr.strategy.AddrStrategy.words_to_bits netaddr.strategy.AddrStrategy-class.html#words_to_bits -netaddr.strategy.AddrStrategy.bits_to_str netaddr.strategy.AddrStrategy-class.html#bits_to_str +netaddr.strategy.AddrStrategy.int_to_bin netaddr.strategy.AddrStrategy-class.html#int_to_bin +netaddr.strategy.AddrStrategy.STRUCT_FORMATS netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS diff --git a/docs/api/class-tree.html b/docs/api/class-tree.html index a2a4bf7..29b9c0c 100755 --- a/docs/api/class-tree.html +++ b/docs/api/class-tree.html @@ -66,36 +66,19 @@ representing various network address types.</em> <ul> <li> <strong class="uidlink"><a href="netaddr.address.EUI-class.html">netaddr.address.EUI</a></strong>: - <em class="summary">EUI objects represent IEEE Extended Unique Identifiers.</em> + <em class="summary">Represents an IEEE EUI (Extended Unique Identifier) indentifier.</em> </li> <li> <strong class="uidlink"><a href="netaddr.address.IP-class.html">netaddr.address.IP</a></strong>: - <em class="summary">A class whose objects represent Internet Protocol network - addresses.</em> - </li> - </ul> - </li> - <li> <strong class="uidlink"><a href="netaddr.address.AddrRange-class.html">netaddr.address.AddrRange</a></strong>: - <em class="summary">A block of contiguous network addresses bounded by an arbitrary - start and stop address.</em> - <ul> - <li> <strong class="uidlink"><a href="netaddr.address.CIDR-class.html">netaddr.address.CIDR</a></strong>: - <em class="summary">A block of contiguous IPv4 or IPv6 network addresses defined by a - base network address and a bitmask prefix or subnet mask address - indicating the size/extent of the subnet.</em> - </li> - <li> <strong class="uidlink"><a href="netaddr.address.Wildcard-class.html">netaddr.address.Wildcard</a></strong>: - <em class="summary">A block of contiguous IPv4 network addresses defined using a - wildcard style syntax.</em> + <em class="summary">Represents <b>individual</b> IPv4 and IPv6 addresses.</em> </li> </ul> </li> <li> <strong class="uidlink"><a href="netaddr.strategy.AddrStrategy-class.html">netaddr.strategy.AddrStrategy</a></strong>: - <em class="summary">Very basic support for all common operations performed on each - network type.</em> + <em class="summary">Basic support for common operations performed on each address type</em> <ul> <li> <strong class="uidlink"><a href="netaddr.strategy.EUI48Strategy-class.html">netaddr.strategy.EUI48Strategy</a></strong>: <em class="summary">Implements the operations that can be performed on an IEEE 48-bit - EUI (Extended Unique Identifer).</em> + EUI (Extended Unique Identifer) a.k.a.</em> </li> <li> <strong class="uidlink"><a href="netaddr.strategy.IPv4StrategyStd-class.html">netaddr.strategy.IPv4StrategyStd</a></strong>: <em class="summary">A 'safe' <a href="netaddr.strategy.AddrStrategy-class.html" @@ -129,28 +112,115 @@ <em class="summary">Common base class for all non-exit exceptions.</em> <ul> <li> <strong class="uidlink"><a href="netaddr.AddrConversionError-class.html">netaddr.AddrConversionError</a></strong>: - <em class="summary">Conversion between address types or notations failed.</em> + <em class="summary">An Exception indicating a failure to convert between address types + or notations.</em> </li> <li> <strong class="uidlink"><a href="netaddr.AddrFormatError-class.html">netaddr.AddrFormatError</a></strong>: - <em class="summary">Network address format not recognised.</em> + <em class="summary">An Exception indicating that a network address format is not + recognised.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.eui.NotRegisteredError-class.html">netaddr.eui.NotRegisteredError</a></strong>: + <em class="summary">An Exception indicating that an OUI or IAB was not found in the + IEEE Registry.</em> </li> </ul> </li> </ul> </li> - <li> <strong class="uidlink"><a href="netaddr.address.KlassDescriptor-class.html">netaddr.address.KlassDescriptor</a></strong>: - <em class="summary">A descriptor that checks klass (data flavour) property assignments - for validity.</em> + <li> <strong class="uidlink"><a href="netaddr.address.FormatDescriptor-class.html">netaddr.address.FormatDescriptor</a></strong>: + <em class="summary">A descriptor that checks formatter property assignments for + validity.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.eui.IAB-class.html">netaddr.eui.IAB</a></strong>: + <em class="summary">Represents an individual IEEE IAB (Individual Address Block) + identifier.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.address.IPRange-class.html">netaddr.address.IPRange</a></strong>: + <em class="summary">Represents arbitrary contiguous blocks of IPv4 and IPv6 addresses + using only a lower and upper bound IP address.</em> + <ul> + <li> <strong class="uidlink"><a href="netaddr.address.CIDR-class.html">netaddr.address.CIDR</a></strong>: + <em class="summary">Represents blocks of IPv4 and IPv6 addresses using CIDR (Classless + Inter-Domain Routing) notation.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.address.Wildcard-class.html">netaddr.address.Wildcard</a></strong>: + <em class="summary">Represents blocks of IPv4 addresses using a wildcard or glob style + syntax.</em> + </li> + </ul> + </li> + <li> <strong class="uidlink"><a href="netaddr.eui.OUI-class.html">netaddr.eui.OUI</a></strong>: + <em class="summary">Represents an individual IEEE OUI (Organisationally Unique + Identifier) identifier.</em> </li> <li> <strong class="uidlink"><a href="netaddr.address.PrefixLenDescriptor-class.html">netaddr.address.PrefixLenDescriptor</a></strong>: <em class="summary">A descriptor that checks prefixlen property assignments for validity based on address type.</em> </li> + <li> <strong class="uidlink"><a href="netaddr.core.Publisher-class.html">netaddr.core.Publisher</a></strong>: + <em class="summary">A 'push' publisher that maintains a list of Subscriber objects + notifying them of state changes when its subclasses encounter + events of interest.</em> + <ul> + <li> <strong class="uidlink"><a href="netaddr.eui.IABIndexParser-class.html">netaddr.eui.IABIndexParser</a></strong>: + <em class="summary">A parser that processes IAB (Individual Address Block) registration + file data published by the IEEE.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.ip.LineRecordParser-class.html">netaddr.ip.LineRecordParser</a></strong>: + <em class="summary">A configurable Parser that understands how to parse line based + records.</em> + <ul> + <li> <strong class="uidlink"><a href="netaddr.ip.IPv4Parser-class.html">netaddr.ip.IPv4Parser</a></strong>: + <em class="summary">A LineRecordParser that understands how to parse and retrieve data + records from the IANA IPv4 address space file.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.ip.IPv6Parser-class.html">netaddr.ip.IPv6Parser</a></strong>: + <em class="summary">A LineRecordParser that understands how to parse and retrieve data + records from the IANA IPv6 address space file.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.ip.MulticastParser-class.html">netaddr.ip.MulticastParser</a></strong>: + <em class="summary">A LineParser that knows how to process the IANA IPv4 multicast + address allocation file.</em> + </li> + </ul> + </li> + <li> <strong class="uidlink"><a href="netaddr.eui.OUIIndexParser-class.html">netaddr.eui.OUIIndexParser</a></strong>: + <em class="summary">A parser that processes OUI (Organisationally Unique Identifier) + registration file data published by the IEEE.</em> + </li> + </ul> + </li> <li> <strong class="uidlink"><a href="netaddr.address.StrategyDescriptor-class.html">netaddr.address.StrategyDescriptor</a></strong>: <em class="summary">A descriptor that checks strategy property assignments for validity and also keeps the addr_type property in sync with any changes made.</em> </li> + <li> <strong class="uidlink"><a href="netaddr.core.Subscriber-class.html">netaddr.core.Subscriber</a></strong>: + <em class="summary">Abstract class defining interface expected by a Publisher that + concrete subclass instances register with to receive updates from.</em> + <ul> + <li> <strong class="uidlink"><a href="netaddr.ip.DictUpdater-class.html">netaddr.ip.DictUpdater</a></strong>: + <em class="summary">Concrete Subscriber that inserts records received from a Publisher + into a dictionary.</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.eui.FileIndexer-class.html">netaddr.eui.FileIndexer</a></strong>: + <em class="summary">Stores index data found by a parser in a CSV file</em> + </li> + <li> <strong class="uidlink"><a href="netaddr.core.PrettyPrinter-class.html">netaddr.core.PrettyPrinter</a></strong>: + <em class="summary">Concrete Subscriber that uses the pprint module to format all data + from updates received writing them to any file-like object.</em> + </li> + </ul> + </li> + <li> <strong class="uidlink">set</strong>: + <em class="summary">set(iterable) --> set object</em> + <ul> + <li> <strong class="uidlink"><a href="netaddr.address.IPRangeSet-class.html">netaddr.address.IPRangeSet</a></strong>: + <em class="summary"><b>*EXPERIMENTAL*</b> A customised Python set class that deals with + collections of IPRange class and subclass instances.</em> + </li> + </ul> + </li> </ul> </li> </ul> @@ -185,7 +255,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/help.html b/docs/api/help.html index f354824..7889b59 100755 --- a/docs/api/help.html +++ b/docs/api/help.html @@ -254,7 +254,7 @@ page was last updated. </p> <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/identifier-index.html b/docs/api/identifier-index.html index 08a472e..f239c92 100755 --- a/docs/api/identifier-index.html +++ b/docs/api/identifier-index.html @@ -67,13 +67,13 @@ <a href="#H">H</a> <a href="#I">I</a> J - <a href="#K">K</a> + K <a href="#L">L</a> - M + <a href="#M">M</a> <a href="#N">N</a> <a href="#O">O</a> <a href="#P">P</a> - Q + <a href="#Q">Q</a> <a href="#R">R</a> <a href="#S">S</a> <a href="#T">T</a> @@ -93,41 +93,33 @@ <tr> <td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#abbrev_to_verbose">abbrev_to_verbose()</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> -<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrValueDescriptor-class.html">AddrValueDescriptor</a><br /> -<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#adjacent">adjacent()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html">Addr</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> -<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr-module.html#AT_EUI64">AT_EUI64</a><br /> -<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRangeSet-class.html#all_matches">all_matches()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#addr_type">addr_type</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> -<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr-module.html#AT_INET">AT_INET</a><br /> -<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -</tr> -<tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#addr_type">addr_type</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> <span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr-module.html#AT_INET6">AT_INET6</a><br /> -<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRangeSet-class.html#any_match">any_match()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#addr_type">addr_type</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.AddrConversionError-class.html">AddrConversionError</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr-module.html#AT_LINK">AT_LINK</a><br /> +<td width="33%" class="link-index"><a href="netaddr-module.html#AT_EUI64">AT_EUI64</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> </tr> <tr> @@ -135,23 +127,31 @@ <span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address-module.html">address</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr-module.html#AT_NAMES">AT_NAMES</a><br /> +<td width="33%" class="link-index"><a href="netaddr-module.html#AT_INET">AT_INET</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#addr_type">addr_type</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.AddrFormatError-class.html">AddrFormatError</a><br /> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#address">address()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr-module.html#AT_INET6">AT_INET6</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#addr_type">addr_type</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#address">address()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr-module.html#AT_LINK">AT_LINK</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address-module.html#AT_STRATEGIES">AT_STRATEGIES</a><br /> -<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#addr_type">addr_type</a><br /> <span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html">AddrRange</a><br /> -<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr-module.html#AT_UNSPEC">AT_UNSPEC</a><br /> +<td width="33%" class="link-index"><a href="netaddr.AddrFormatError-class.html">AddrFormatError</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr-module.html#AT_NAMES">AT_NAMES</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> </tr> <tr> @@ -159,14 +159,24 @@ <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a><br /> <span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> -<td width="33%" class="link-index"> </td> +<td width="33%" class="link-index"><a href="netaddr.address-module.html#AT_STRATEGIES">AT_STRATEGIES</a><br /> +<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.AddrTypeDescriptor-class.html">AddrTypeDescriptor</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> -<td width="33%" class="link-index"> </td> +<td width="33%" class="link-index"><a href="netaddr-module.html#AT_UNSPEC">AT_UNSPEC</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#ADDR_TYPES">ADDR_TYPES</a><br /> +<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.AddrValueDescriptor-class.html">AddrValueDescriptor</a><br /> +<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.Publisher-class.html#attach">attach()</a><br /> +<span class="index-where">(in <a href="netaddr.core.Publisher-class.html">Publisher</a>)</span></td> </tr> </table> </td></tr> @@ -176,15 +186,15 @@ <tr> <td width="33%" class="link-index"><a href="netaddr-module.html#BIG_ENDIAN_PLATFORM">BIG_ENDIAN_PLATFORM</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_words">bits_to_words()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#bits">bits()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#broadcast">broadcast</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#bits">bits()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#bin">bin()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_str">bits_to_str()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> @@ -196,22 +206,29 @@ <tr> <td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html">CIDR</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#cidrs">cidrs()</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core-module.html">core</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +</tr> +<tr> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#cidr">cidr()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#cidr">cidr()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#cidrs">cidrs()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#create_ieee_indices">create_ieee_indices()</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> </tr> -<tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> </table> </td></tr> <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="D">D</a></h2></td> <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#data_flavour">data_flavour()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#description">description()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.Publisher-class.html#detach">detach()</a><br /> +<span class="index-where">(in <a href="netaddr.core.Publisher-class.html">Publisher</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.DictUpdater-class.html">DictUpdater</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> <tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> @@ -223,15 +240,16 @@ <tr> <td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#ei">ei()</a><br /> <span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a><br /> -<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> -<td width="33%" class="link-index"> </td> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html">eui</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#eui64">eui64()</a><br /> +<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html">EUI</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#eui64">eui64()</a><br /> -<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a><br /> +<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> </table> @@ -240,19 +258,34 @@ <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#first">first</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.FileIndexer-class.html">FileIndexer</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#fmt">fmt</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.FormatDescriptor-class.html">FormatDescriptor</a><br /> +<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#first">first</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#fmt">fmt</a><br /> +<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> <td width="33%" class="link-index"> </td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#fmt">fmt</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#format">format()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> -<tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> </table> </td></tr> <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="H">H</a></h2></td> <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#hostmask">hostmask()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#hostmask">hostmask</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#hostname">hostname()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> @@ -265,92 +298,186 @@ <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa">int_to_arpa()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_words">int_to_words()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html">IAB</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#int_to_str">int_to_str()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#ipv6_link_local">ipv6_link_local()</a><br /> <span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#int_to_arpa">int_to_arpa()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words">int_to_words()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#iab">iab()</a><br /> +<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str">int_to_str()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.IPv6Parser-class.html">IPv6Parser</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui.IABIndexParser-class.html">IABIndexParser</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#int_to_str">int_to_str()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a><br /> <span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.ip-module.html#IANA_INFO">IANA_INFO</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_words">int_to_words()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_hostmask">is_hostmask()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#IEEE_IAB_INDEX">IEEE_IAB_INDEX</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words">int_to_words()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_ipv4_compat">is_ipv4_compat()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#IEEE_IAB_METADATA">IEEE_IAB_METADATA</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html">IP</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_hostmask">is_hostmask()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_ipv4_mapped">is_ipv4_mapped()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_str">int_to_str()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#ipv4">ipv4()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#IEEE_IAB_REGISTRY">IEEE_IAB_REGISTRY</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip-module.html">ip</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_link_local">is_link_local()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#IEEE_OUI_INDEX">IEEE_OUI_INDEX</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html">IPRange</a><br /> +<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_loopback">is_loopback()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#IEEE_OUI_METADATA">IEEE_OUI_METADATA</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#iprange">iprange()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_multicast">is_multicast()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#int_to_str">int_to_str()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a><br /> -<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#IEEE_OUI_REGISTRY">IEEE_OUI_REGISTRY</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#iprange">iprange()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_netmask">is_netmask()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str">int_to_str()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a><br /> -<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#info">info()</a><br /> +<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a><br /> +<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_private">is_private()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#info">info()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#ipv4">ipv4()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_reserved">is_reserved()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa">int_to_arpa()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.misc-module.html#ipv4_cidr_prefixes">ipv4_cidr_prefixes()</a><br /> +<span class="index-where">(in <a href="netaddr.misc-module.html">netaddr.misc</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#is_unicast">is_unicast()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#int_to_str">int_to_str()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#int_to_arpa">int_to_arpa()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#ipv6">ipv6()</a><br /> -<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.IPv4Parser-class.html">IPv4Parser</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#is_valid">is_valid()</a><br /> <span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> </tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bin">int_to_bin()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a><br /> +<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#isiab">isiab()</a><br /> +<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a><br /> +<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#issubnet">issubnet()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_packed">int_to_packed()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#ipv6">ipv6()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#issupernet">issupernet()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_str">int_to_str()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.misc-module.html#ipv6_cidr_prefixes">ipv6_cidr_prefixes()</a><br /> +<span class="index-where">(in <a href="netaddr.misc-module.html">netaddr.misc</a>)</span></td> +<td width="33%" class="link-index"> </td> +</tr> </table> </td></tr> -<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="K">K</a></h2></td> +<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="L">L</a></h2></td> <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#klass">klass</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#klass">klass</a><br /> -<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#last">last</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip-module.html#load_iana_info">load_iana_info()</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#klass">klass</a><br /> -<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.KlassDescriptor-class.html">KlassDescriptor</a><br /> -<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui-module.html#load_ieee_indices">load_ieee_indices()</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> </table> </td></tr> -<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="L">L</a></h2></td> +<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="M">M</a></h2></td> <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#last">last</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRangeSet-class.html#max_match">max_match()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.misc-module.html">misc</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> <td width="33%" class="link-index"> </td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRangeSet-class.html#min_match">min_match()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.MulticastParser-class.html">MulticastParser</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> -<tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> </table> </td></tr> <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="N">N</a></h2></td> @@ -358,15 +485,24 @@ <table class="link-index" width="100%" border="1"> <tr> <td width="33%" class="link-index"><a href="netaddr-module.html">netaddr</a></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#netmask_bits">netmask_bits()</a><br /> -<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> -<td width="33%" class="link-index"> </td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#network">network</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.NotRegisteredError-class.html">NotRegisteredError</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#netmask">netmask()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#netmask">netmask</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.MulticastParser-class.html#normalise_addr">normalise_addr()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.MulticastParser-class.html">MulticastParser</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address-module.html#nrange">nrange()</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#netmask_bits">netmask_bits()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.Publisher-class.html#notify">notify()</a><br /> +<span class="index-where">(in <a href="netaddr.core.Publisher-class.html">Publisher</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> </table> @@ -375,24 +511,88 @@ <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#org">org()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html">OUI</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#overlaps">overlaps()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#org">org()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#oui">oui()</a><br /> <span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> <td width="33%" class="link-index"> </td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#org_count">org_count()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUIIndexParser-class.html">OUIIndexParser</a><br /> +<span class="index-where">(in <a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> -<tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> </table> </td></tr> <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="P">P</a></h2></td> <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#packed">packed()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.IPv6Parser-class.html#parse_line">parse_line()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.IPv6Parser-class.html">IPv6Parser</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.PrettyPrinter-class.html">PrettyPrinter</a><br /> +<span class="index-where">(in <a href="netaddr.core-module.html" onclick="show_private();">netaddr.core</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#packed_to_int">packed_to_int()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.LineRecordParser-class.html#parse_line">parse_line()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.misc-module.html#print_ipv4_cidr_prefixes">print_ipv4_cidr_prefixes()</a><br /> +<span class="index-where">(in <a href="netaddr.misc-module.html">netaddr.misc</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui.IABIndexParser-class.html#parse">parse()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IABIndexParser-class.html">IABIndexParser</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.MulticastParser-class.html#parse_line">parse_line()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.MulticastParser-class.html">MulticastParser</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.misc-module.html#print_ipv6_cidr_prefixes">print_ipv6_cidr_prefixes()</a><br /> +<span class="index-where">(in <a href="netaddr.misc-module.html">netaddr.misc</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui.OUIIndexParser-class.html#parse">parse()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUIIndexParser-class.html">OUIIndexParser</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#prefixlen">prefixlen</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.Publisher-class.html">Publisher</a><br /> +<span class="index-where">(in <a href="netaddr.core-module.html" onclick="show_private();">netaddr.core</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.ip.LineRecordParser-class.html#parse">parse()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#prefixlen">prefixlen</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"> </td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.ip.IPv4Parser-class.html#parse_line">parse_line()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.IPv4Parser-class.html">IPv4Parser</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.PrefixLenDescriptor-class.html">PrefixLenDescriptor</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> +<td width="33%" class="link-index"> </td> +</tr> +</table> +</td></tr> +<tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="Q">Q</a></h2></td> +<td valign="top"> +<table class="link-index" width="100%" border="1"> +<tr> +<td width="33%" class="link-index"><a href="netaddr.ip-module.html#query">query()</a><br /> +<span class="index-where">(in <a href="netaddr.ip-module.html">netaddr.ip</a>)</span></td> +<td width="33%" class="link-index"> </td> +<td width="33%" class="link-index"> </td> </tr> <tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> </table> @@ -401,94 +601,109 @@ <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#RE_MAC_FORMATS">RE_MAC_FORMATS</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#registration">registration()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> +<td width="33%" class="link-index"> </td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#registration">registration()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#reverse_dns">reverse_dns()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> <td width="33%" class="link-index"> </td> -<td width="33%" class="link-index"> </td> </tr> -<tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> </table> </td></tr> <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="S">S</a></h2></td> <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#size">size()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#size">size()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#str_to_int">str_to_int()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#STRATEGIES">STRATEGIES</a><br /> -<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#strategy">strategy</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr-module.html#ST_EUI48">ST_EUI48</a><br /> -<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#span">span()</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#str_to_int">str_to_int()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#strategy">strategy</a><br /> +<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#split_iab_mac">split_iab_mac()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int">str_to_int()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#strategy">strategy</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#strategy">strategy</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.strategy-module.html#ST_EUI48">ST_EUI48</a><br /> -<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr-module.html#ST_EUI48">ST_EUI48</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#str_to_int">str_to_int()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#strategy">strategy</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#strategy">strategy</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy-module.html#ST_EUI48">ST_EUI48</a><br /> +<span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#STRATEGIES">STRATEGIES</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#strategy">strategy</a><br /> +<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr-module.html#ST_EUI64">ST_EUI64</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#str_to_words">str_to_words()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#strategy">strategy</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#STRATEGIES">STRATEGIES</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy-module.html">strategy</a><br /> +<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.strategy-module.html#ST_EUI64">ST_EUI64</a><br /> <span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#str_to_words">str_to_words()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#strategy">strategy</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#STRATEGIES">STRATEGIES</a><br /> <span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.StrategyDescriptor-class.html">StrategyDescriptor</a><br /> +<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr-module.html#ST_IPV4">ST_IPV4</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#STRATEGIES">STRATEGIES</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#strategy">strategy</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#STRATEGIES">STRATEGIES</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS">STRUCT_FORMATS</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.strategy-module.html#ST_IPV4">ST_IPV4</a><br /> <span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#STRATEGIES">STRATEGIES</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#strategy">strategy</a><br /> -<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#STRATEGIES">STRATEGIES</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#subnet">subnet()</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr-module.html#ST_IPV6">ST_IPV6</a><br /> <span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#STRATEGIES">STRATEGIES</a><br /> -<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy-module.html">strategy</a><br /> -<span class="index-where">(in <a href="netaddr-module.html">netaddr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#STRATEGIES">STRATEGIES</a><br /> +<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.Subscriber-class.html">Subscriber</a><br /> +<span class="index-where">(in <a href="netaddr.core-module.html" onclick="show_private();">netaddr.core</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.strategy-module.html#ST_IPV6">ST_IPV6</a><br /> <span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#STRATEGIES">STRATEGIES</a><br /> -<span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.StrategyDescriptor-class.html">StrategyDescriptor</a><br /> -<span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> -</tr> -<tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#str_to_bits">str_to_bits()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#STRATEGIES">STRATEGIES</a><br /> -<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#strategy">strategy</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> </table> @@ -509,12 +724,20 @@ <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> +<td width="33%" class="link-index"><a href="netaddr.core.PrettyPrinter-class.html#update">update()</a><br /> +<span class="index-where">(in <a href="netaddr.core.PrettyPrinter-class.html">PrettyPrinter</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.FileIndexer-class.html#update">update()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.FileIndexer-class.html">FileIndexer</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy-module.html#USE_IPV4_OPT">USE_IPV4_OPT</a><br /> <span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> -<td width="33%" class="link-index"> </td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.core.Subscriber-class.html#update">update()</a><br /> +<span class="index-where">(in <a href="netaddr.core.Subscriber-class.html">Subscriber</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.DictUpdater-class.html#update">update()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.DictUpdater-class.html">DictUpdater</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> -<tr><td class="link-index"> </td><td class="link-index"> </td><td class="link-index"> </td></tr> </table> </td></tr> <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="V">V</a></h2></td> @@ -525,21 +748,22 @@ <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#valid_str">valid_str()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#value">value</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#valid_int">valid_int()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#valid_str">valid_str()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> -<td width="33%" class="link-index"> </td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#valid_str">valid_str()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#value">value</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#valid_str">valid_str()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#valid_str">valid_str()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> </table> @@ -550,178 +774,227 @@ <tr> <td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html">Wildcard</a><br /> <span class="index-where">(in <a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#words_to_bits">words_to_bits()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#words_to_str">words_to_str()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#wildcard">wildcard()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int">words_to_int()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#wildcard">wildcard()</a><br /> -<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#wildcard">wildcard()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> <td width="33%" class="link-index"> </td> </tr> -<tr> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#word_to_bits">word_to_bits()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int">words_to_int()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> -<td width="33%" class="link-index"> </td> -</tr> </table> </td></tr> <tr valign="top"><td valign="top" width="1%"><h2 class="epydoc"><a name="_">_</a></h2></td> <td valign="top"> <table class="link-index" width="100%" border="1"> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__contains__">__contains__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.KlassDescriptor-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.KlassDescriptor-class.html">KlassDescriptor</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#_">_</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.StrategyDescriptor-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.StrategyDescriptor-class.html">StrategyDescriptor</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__lshift__">__lshift__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#_">_</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__lt__">__lt__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__add__">__add__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.PrettyPrinter-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.core.PrettyPrinter-class.html">PrettyPrinter</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__lt__">__lt__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#__add__">__add__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.core.Publisher-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.core.Publisher-class.html">Publisher</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__ne__">__ne__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__eq__">__eq__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__and__">__and__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.PrefixLenDescriptor-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.PrefixLenDescriptor-class.html">PrefixLenDescriptor</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__ne__">__ne__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.FileIndexer-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.FileIndexer-class.html">FileIndexer</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__ne__">__ne__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__eq__">__eq__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.StrategyDescriptor-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.StrategyDescriptor-class.html">StrategyDescriptor</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__repr__">__repr__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__contains__">__contains__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__or__">__or__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__ge__">__ge__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.IPRangeSet-class.html#__contains__">__contains__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.IABIndexParser-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IABIndexParser-class.html">IABIndexParser</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__repr__">__repr__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__repr__">__repr__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__ge__">__ge__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__eq__">__eq__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#__repr__">__repr__()</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__getitem__">__getitem__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__eq__">__eq__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUIIndexParser-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUIIndexParser-class.html">OUIIndexParser</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#__repr__">__repr__()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__getitem__">__getitem__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__ge__">__ge__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.DictUpdater-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.DictUpdater-class.html">DictUpdater</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__repr__">__repr__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__ge__">__ge__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.IPv4Parser-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.IPv4Parser-class.html">IPv4Parser</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#__repr__">__repr__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> </tr> <tr> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__getitem__">__getitem__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.IPv6Parser-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.IPv6Parser-class.html">IPv6Parser</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#__repr__">__repr__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__getitem__">__getitem__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.LineRecordParser-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#__repr__">__repr__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> +</tr> +<tr> <td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__gt__">__gt__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyStd-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.ip.MulticastParser-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.ip.MulticastParser-class.html">MulticastParser</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#__repr__">__repr__()</a><br /> <span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__gt__">__gt__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrTypeDescriptor-class.html#__set__">__set__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrTypeDescriptor-class.html">AddrTypeDescriptor</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__gt__">__gt__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.AddrStrategy-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__rshift__">__rshift__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__hash__">__hash__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__int__">__int__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.EUI48Strategy-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.AddrTypeDescriptor-class.html#__set__">__set__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.AddrTypeDescriptor-class.html">AddrTypeDescriptor</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__hash__">__hash__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.AddrValueDescriptor-class.html#__set__">__set__()</a><br /> <span class="index-where">(in <a href="netaddr.address.AddrValueDescriptor-class.html">AddrValueDescriptor</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__hash__">__hash__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__isub__">__isub__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__hex__">__hex__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.KlassDescriptor-class.html#__set__">__set__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.KlassDescriptor-class.html">KlassDescriptor</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv4StrategyStd-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.FormatDescriptor-class.html#__set__">__set__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.FormatDescriptor-class.html">FormatDescriptor</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__hex__">__hex__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__isub__">__isub__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#__hex__">__hex__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.strategy.IPv6Strategy-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.PrefixLenDescriptor-class.html#__set__">__set__()</a><br /> <span class="index-where">(in <a href="netaddr.address.PrefixLenDescriptor-class.html">PrefixLenDescriptor</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__iadd__">__iadd__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__iter__">__iter__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#__hex__">__hex__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__int__">__int__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.StrategyDescriptor-class.html#__set__">__set__()</a><br /> <span class="index-where">(in <a href="netaddr.address.StrategyDescriptor-class.html">StrategyDescriptor</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__iadd__">__iadd__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__iter__">__iter__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__iadd__">__iadd__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#__int__">__int__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__setitem__">__setitem__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__le__">__le__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__iadd__">__iadd__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#__int__">__int__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__str__">__str__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> </tr> <tr> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__init__">__init__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__le__">__le__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__str__">__str__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__invert__">__invert__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#__str__">__str__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.AddrTypeDescriptor-class.html#__init__">__init__()</a><br /> <span class="index-where">(in <a href="netaddr.address.AddrTypeDescriptor-class.html">AddrTypeDescriptor</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__len__">__len__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__isub__">__isub__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#__str__">__str__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#__str__">__str__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.AddrValueDescriptor-class.html#__init__">__init__()</a><br /> <span class="index-where">(in <a href="netaddr.address.AddrValueDescriptor-class.html">AddrValueDescriptor</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__len__">__len__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#__str__">__str__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__isub__">__isub__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__str__">__str__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#__init__">__init__()</a><br /> <span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__long__">__long__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__iter__">__iter__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.address.Wildcard-class.html#__str__">__str__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Wildcard-class.html">Wildcard</a>)</span></td> @@ -729,16 +1002,48 @@ <tr> <td width="33%" class="link-index"><a href="netaddr.address.EUI-class.html#__init__">__init__()</a><br /> <span class="index-where">(in <a href="netaddr.address.EUI-class.html">EUI</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__lt__">__lt__()</a><br /> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__iter__">__iter__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.IAB-class.html#__str__">__str__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.IAB-class.html">IAB</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.FormatDescriptor-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.FormatDescriptor-class.html">FormatDescriptor</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__le__">__le__()</a><br /> <span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#__sub__">__sub__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.eui.OUI-class.html#__str__">__str__()</a><br /> +<span class="index-where">(in <a href="netaddr.eui.OUI-class.html">OUI</a>)</span></td> </tr> <tr> <td width="33%" class="link-index"><a href="netaddr.address.IP-class.html#__init__">__init__()</a><br /> <span class="index-where">(in <a href="netaddr.address.IP-class.html">IP</a>)</span></td> -<td width="33%" class="link-index"><a href="netaddr.address.AddrRange-class.html#__lt__">__lt__()</a><br /> -<span class="index-where">(in <a href="netaddr.address.AddrRange-class.html">AddrRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__le__">__le__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__sub__">__sub__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__len__">__len__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.CIDR-class.html#__sub__">__sub__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.CIDR-class.html">CIDR</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.IPRangeSet-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.IPRange-class.html#__len__">__len__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.IPRange-class.html">IPRange</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__xor__">__xor__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> +</tr> +<tr> +<td width="33%" class="link-index"><a href="netaddr.address.PrefixLenDescriptor-class.html#__init__">__init__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.PrefixLenDescriptor-class.html">PrefixLenDescriptor</a>)</span></td> +<td width="33%" class="link-index"><a href="netaddr.address.Addr-class.html#__long__">__long__()</a><br /> +<span class="index-where">(in <a href="netaddr.address.Addr-class.html">Addr</a>)</span></td> <td width="33%" class="link-index"><a href="netaddr.strategy-module.html#_BYTES_TO_BITS">_BYTES_TO_BITS</a><br /> <span class="index-where">(in <a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a>)</span></td> </tr> @@ -776,7 +1081,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/module-tree.html b/docs/api/module-tree.html index 05b7ad0..6605bed 100755 --- a/docs/api/module-tree.html +++ b/docs/api/module-tree.html @@ -61,9 +61,16 @@ <li> <strong class="uidlink"><a href="netaddr-module.html">netaddr</a></strong>: <em class="summary">network address manipulation, done Pythonically</em> <ul> <li class="private"> <strong class="uidlink"><a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a></strong>: <em class="summary">network address classes (IP, EUI) and associated aggregate classes - (CIDR, Wilcard, etc).</em> </li> - <li class="private"> <strong class="uidlink"><a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a></strong>: <em class="summary">network address type logic, constants used to identify them and - shared strategy objects.</em> </li> + (CIDR, Wildcard and IPRange).</em> </li> + <li class="private"> <strong class="uidlink"><a href="netaddr.core-module.html" onclick="show_private();">netaddr.core</a></strong>: <em class="summary">Classes and routines that are common to various netaddr sub + modules.</em> </li> + <li class="private"> <strong class="uidlink"><a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a></strong>: <em class="summary">Provides access to public network address information published by + the IEEE.</em> </li> + <li> <strong class="uidlink"><a href="netaddr.ip-module.html">netaddr.ip</a></strong>: <em class="summary">Provides access to public network address information published by + IANA.</em> </li> + <li> <strong class="uidlink"><a href="netaddr.misc-module.html">netaddr.misc</a></strong>: <em class="summary">Miscellanous functions and classes.</em> </li> + <li class="private"> <strong class="uidlink"><a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a></strong>: <em class="summary">network address conversion logic, constants and shared strategy + objects.</em> </li> </ul> </li> </ul> @@ -98,7 +105,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr-module.html b/docs/api/netaddr-module.html index 7acaa94..77d11a4 100755 --- a/docs/api/netaddr-module.html +++ b/docs/api/netaddr-module.html @@ -62,7 +62,7 @@ <hr /> <div class="fields"> <p><strong>Version:</strong> - 0.5.2 + 0.6 </p> </div><!-- ==================== SUBMODULES ==================== --> <a name="section-Submodules"></a> @@ -75,9 +75,16 @@ <tr><td class="summary"> <ul class="nomargin"> <li class="private"> <strong class="uidlink"><a href="netaddr.address-module.html" onclick="show_private();">netaddr.address</a></strong>: <em class="summary">network address classes (IP, EUI) and associated aggregate classes - (CIDR, Wilcard, etc).</em> </li> - <li class="private"> <strong class="uidlink"><a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a></strong>: <em class="summary">network address type logic, constants used to identify them and - shared strategy objects.</em> </li> + (CIDR, Wildcard and IPRange).</em> </li> + <li class="private"> <strong class="uidlink"><a href="netaddr.core-module.html" onclick="show_private();">netaddr.core</a></strong>: <em class="summary">Classes and routines that are common to various netaddr sub + modules.</em> </li> + <li class="private"> <strong class="uidlink"><a href="netaddr.eui-module.html" onclick="show_private();">netaddr.eui</a></strong>: <em class="summary">Provides access to public network address information published by + the IEEE.</em> </li> + <li> <strong class="uidlink"><a href="netaddr.ip-module.html">netaddr.ip</a></strong>: <em class="summary">Provides access to public network address information published by + IANA.</em> </li> + <li> <strong class="uidlink"><a href="netaddr.misc-module.html">netaddr.misc</a></strong>: <em class="summary">Miscellanous functions and classes.</em> </li> + <li class="private"> <strong class="uidlink"><a href="netaddr.strategy-module.html" onclick="show_private();">netaddr.strategy</a></strong>: <em class="summary">network address conversion logic, constants and shared strategy + objects.</em> </li> </ul></td></tr> </table> @@ -95,7 +102,8 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.AddrFormatError-class.html" class="summary-name">AddrFormatError</a><br /> - Network address format not recognised. + An Exception indicating that a network address format is not + recognised. </td> </tr> <tr> @@ -103,34 +111,34 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.AddrConversionError-class.html" class="summary-name">AddrConversionError</a><br /> - Conversion between address types or notations failed. + An Exception indicating a failure to convert between address types + or notations. </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.Addr-class.html" class="summary-name">Addr</a><br /> - The base class containing common functionality for all subclasses - representing various network address types. + <a href="netaddr.address.IP-class.html" class="summary-name">IP</a><br /> + Represents <b>individual</b> IPv4 and IPv6 addresses. </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.AddrRange-class.html" class="summary-name">AddrRange</a><br /> - A block of contiguous network addresses bounded by an arbitrary - start and stop address. + <a href="netaddr.address.IPRange-class.html" class="summary-name">IPRange</a><br /> + Represents arbitrary contiguous blocks of IPv4 and IPv6 addresses + using only a lower and upper bound IP address. </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.IP-class.html" class="summary-name">IP</a><br /> - A class whose objects represent Internet Protocol network - addresses. + <a href="netaddr.address.IPRangeSet-class.html" class="summary-name">IPRangeSet</a><br /> + <b>*EXPERIMENTAL*</b> A customised Python set class that deals with + collections of IPRange class and subclass instances. </td> </tr> <tr> @@ -138,9 +146,8 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address.CIDR-class.html" class="summary-name">CIDR</a><br /> - A block of contiguous IPv4 or IPv6 network addresses defined by a - base network address and a bitmask prefix or subnet mask address - indicating the size/extent of the subnet. + Represents blocks of IPv4 and IPv6 addresses using CIDR (Classless + Inter-Domain Routing) notation. </td> </tr> <tr> @@ -148,8 +155,8 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address.Wildcard-class.html" class="summary-name">Wildcard</a><br /> - A block of contiguous IPv4 network addresses defined using a - wildcard style syntax. + Represents blocks of IPv4 addresses using a wildcard or glob style + syntax. </td> </tr> <tr> @@ -157,7 +164,34 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address.EUI-class.html" class="summary-name">EUI</a><br /> - EUI objects represent IEEE Extended Unique Identifiers. + Represents an IEEE EUI (Extended Unique Identifier) indentifier. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.OUI-class.html" class="summary-name">OUI</a><br /> + Represents an individual IEEE OUI (Organisationally Unique + Identifier) identifier. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.IAB-class.html" class="summary-name">IAB</a><br /> + Represents an individual IEEE IAB (Individual Address Block) + identifier. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.NotRegisteredError-class.html" class="summary-name">NotRegisteredError</a><br /> + An Exception indicating that an OUI or IAB was not found in the + IEEE Registry. </td> </tr> </table> @@ -178,9 +212,10 @@ <td><span class="summary-sig"><a href="netaddr-module.html#nrange" class="summary-sig-name">nrange</a>(<span class="summary-sig-arg">start</span>, <span class="summary-sig-arg">stop</span>, <span class="summary-sig-arg">step</span>=<span class="summary-sig-default">1</span>, - <span class="summary-sig-arg">klass</span>=<span class="summary-sig-default">None</span>)</span><br /> - A generator producing sequences of network addresses based on start - and stop values, in intervals of step.</td> + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default">None</span>)</span><br /> + An xrange work alike generator that produces sequences of IP + addresses based on start and stop addresses, in intervals of step + size.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#nrange">source code</a></span> @@ -235,28 +270,28 @@ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr-module.html#ST_IPV4" class="summary-name">ST_IPV4</a> = <code title="netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)">netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False<code class="variable-ellipsis">...</code></code> + <a href="netaddr-module.html#ST_IPV4" class="summary-name">ST_IPV4</a> = <code title="netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False)">netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, F<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr-module.html#ST_IPV6" class="summary-name">ST_IPV6</a> = <code title="netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)">netaddr.address.IPv6Strategy(128, 16, ':', 6, True, <code class="variable-ellipsis">...</code></code> + <a href="netaddr-module.html#ST_IPV6" class="summary-name">ST_IPV6</a> = <code title="netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False)">netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, Fa<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr-module.html#ST_EUI48" class="summary-name">ST_EUI48</a> = <code title="netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True)">netaddr.address.EUI48Strategy(48, 8, '-', 48, True,<code class="variable-ellipsis">...</code></code> + <a href="netaddr-module.html#ST_EUI48" class="summary-name">ST_EUI48</a> = <code title="netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True)">netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, T<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr-module.html#ST_EUI64" class="summary-name">ST_EUI64</a> = <code title="netaddr.address.AddrStrategy(64, 8, '-', 64, True, True)">netaddr.address.AddrStrategy(64, 8, '-', 64, True, <code class="variable-ellipsis">...</code></code> + <a name="ST_EUI64"></a><span class="summary-name">ST_EUI64</span> = <code title="netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)">netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)</code> </td> </tr> </table> @@ -279,43 +314,42 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">nrange</span>(<span class="sig-arg">start</span>, <span class="sig-arg">stop</span>, <span class="sig-arg">step</span>=<span class="sig-default">1</span>, - <span class="sig-arg">klass</span>=<span class="sig-default">None</span>)</span> + <span class="sig-arg">fmt</span>=<span class="sig-default">None</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.address-pysrc.html#nrange">source code</a></span> </td> </tr></table> - <p>A generator producing sequences of network addresses based on start - and stop values, in intervals of step.</p> + <p>An xrange work alike generator that produces sequences of IP addresses + based on start and stop addresses, in intervals of step size.</p> <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>start</code></strong> - first network address as string or instance of <a - href="netaddr.address.Addr-class.html" class="link">Addr</a> - (sub)class.</li> - <li><strong class="pname"><code>stop</code></strong> - last network address as string or instance of <a - href="netaddr.address.Addr-class.html" class="link">Addr</a> - (sub)class.</li> - <li><strong class="pname"><code>step</code></strong> - (optional) size of step between addresses in range. Default is 1.</li> - <li><strong class="pname"><code>klass</code></strong> - (optional) the class used to create objects returned. Default: <a - href="netaddr.address.Addr-class.html" class="link">Addr</a> - class. + <li><strong class="pname"><code>start</code></strong> - first IP address string or <a + href="netaddr.address.IP-class.html" class="link">IP</a> object + in range.</li> + <li><strong class="pname"><code>stop</code></strong> - last IP address string or <a href="netaddr.address.IP-class.html" + class="link">IP</a> object in range</li> + <li><strong class="pname"><code>step</code></strong> - (optional) size of step between address in range. (Default: 1)</li> + <li><strong class="pname"><code>fmt</code></strong> - (optional) callable used on addresses returned. (Default: None - + <a href="netaddr.address.IP-class.html" class="link">IP</a> + objects). Supported options :- <ul> <li> - <code>str</code> returns string representation of network - address + <code>str</code> - IP address strings + </li> + <li> + <code>int</code>, <code>long</code> - IP address integer + (network byte order) </li> <li> - <code>int</code>, <code>long</code> and <code>hex</code> - return expected values + <code>hex</code> - IP address as a hexadecimal number </li> <li> - <a href="netaddr.address.Addr-class.html" - class="link">Addr</a> (sub)class or duck type* return objects - of that class. If you use your own duck class, make sure you - handle both arguments <code>(addr_value, addr_type)</code> - passed to the constructor. + <a href="netaddr.address.IP-class.html" class="link">IP</a> + class/subclass or callable that accepts + <code>addr_value</code> and <code>addr_type</code> arguments. </li> </ul></li> </ul></dd> @@ -344,7 +378,7 @@ <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False) +netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False) </pre></td></tr></table> </dd> </dl> @@ -362,7 +396,7 @@ netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False) <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False) +netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False) </pre></td></tr></table> </dd> </dl> @@ -380,25 +414,7 @@ netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False) <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True) -</pre></td></tr></table> -</dd> - </dl> -</td></tr></table> -</div> -<a name="ST_EUI64"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <h3 class="epydoc">ST_EUI64</h3> - - <dl class="fields"> - </dl> - <dl class="fields"> - <dt>Value:</dt> - <dd><table><tr><td><pre class="variable"> -netaddr.address.AddrStrategy(64, 8, '-', 64, True, True) +netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True) </pre></td></tr></table> </dd> </dl> @@ -436,7 +452,7 @@ netaddr.address.AddrStrategy(64, 8, '-', 64, True, True) <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr-pysrc.html b/docs/api/netaddr-pysrc.html index 6a8f4c1..f2c9f72 100755 --- a/docs/api/netaddr-pysrc.html +++ b/docs/api/netaddr-pysrc.html @@ -67,7 +67,7 @@ <a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-docstring">"""</tt> </tt> <a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">network address manipulation, done Pythonically</tt> </tt> <a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> -<a name="L10"></a><tt class="py-lineno">10</tt> <tt class="py-line"><tt class="py-name">__version__</tt> <tt class="py-op">=</tt> <tt class="py-string">'0.5.2'</tt> </tt> +<a name="L10"></a><tt class="py-lineno">10</tt> <tt class="py-line"><tt class="py-name">__version__</tt> <tt class="py-op">=</tt> <tt class="py-string">'0.6'</tt> </tt> <a name="L11"></a><tt class="py-lineno">11</tt> <tt class="py-line"> </tt> <a name="L12"></a><tt class="py-lineno">12</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">struct</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_struct</tt> </tt> <a name="L13"></a><tt class="py-lineno">13</tt> <tt class="py-line"> </tt> @@ -100,42 +100,61 @@ <a name="L40"></a><tt class="py-lineno">40</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> <a name="AddrFormatError"></a><div id="AddrFormatError-def"><a name="L41"></a><tt class="py-lineno">41</tt> <a class="py-toggle" href="#" id="AddrFormatError-toggle" onclick="return toggle('AddrFormatError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.AddrFormatError-class.html">AddrFormatError</a><tt class="py-op">(</tt><tt class="py-base-class">Exception</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> </div><div id="AddrFormatError-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="AddrFormatError-expanded"><a name="L42"></a><tt class="py-lineno">42</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L43"></a><tt class="py-lineno">43</tt> <tt class="py-line"><tt class="py-docstring"> Network address format not recognised.</tt> </tt> +<a name="L43"></a><tt class="py-lineno">43</tt> <tt class="py-line"><tt class="py-docstring"> An Exception indicating that a network address format is not recognised.</tt> </tt> <a name="L44"></a><tt class="py-lineno">44</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> <a name="L45"></a><tt class="py-lineno">45</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> </div><a name="L46"></a><tt class="py-lineno">46</tt> <tt class="py-line"> </tt> <a name="AddrConversionError"></a><div id="AddrConversionError-def"><a name="L47"></a><tt class="py-lineno">47</tt> <a class="py-toggle" href="#" id="AddrConversionError-toggle" onclick="return toggle('AddrConversionError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.AddrConversionError-class.html">AddrConversionError</a><tt class="py-op">(</tt><tt class="py-base-class">Exception</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> </div><div id="AddrConversionError-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="AddrConversionError-expanded"><a name="L48"></a><tt class="py-lineno">48</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L49"></a><tt class="py-lineno">49</tt> <tt class="py-line"><tt class="py-docstring"> Conversion between address types or notations failed.</tt> </tt> -<a name="L50"></a><tt class="py-lineno">50</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L51"></a><tt class="py-lineno">51</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -</div><a name="L52"></a><tt class="py-lineno">52</tt> <tt class="py-line"> </tt> -<a name="L53"></a><tt class="py-lineno">53</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L54"></a><tt class="py-lineno">54</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Public interface and exports.</tt> </tt> -<a name="L55"></a><tt class="py-lineno">55</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L56"></a><tt class="py-lineno">56</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="L57"></a><tt class="py-lineno">57</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-12" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-12', 'netaddr', 'link-12');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-13" class="py-name" targets="Module netaddr.address=netaddr.address-module.html"><a title="netaddr.address" class="py-name" href="#" onclick="return doclink('link-13', 'address', 'link-13');">address</a></tt> <tt class="py-keyword">import</tt> <tt id="link-14" class="py-name" targets="Class netaddr.address.Addr=netaddr.address.Addr-class.html"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-14', 'Addr', 'link-14');">Addr</a></tt><tt class="py-op">,</tt> <tt id="link-15" class="py-name" targets="Class netaddr.address.AddrRange=netaddr.address.AddrRange-class.html"><a title="netaddr.address.AddrRange" class="py-name" href="#" onclick="return doclink('link-15', 'AddrRange', 'link-15');">AddrRange</a></tt><tt class="py-op">,</tt> <tt id="link-16" class="py-name" targets="Function netaddr.address.nrange()=netaddr.address-module.html#nrange"><a title="netaddr.address.nrange" class="py-name" href="#" onclick="return doclink('link-16', 'nrange', 'link-16');">nrange</a></tt><tt class="py-op">,</tt> <tt id="link-17" class="py-name" targets="Class netaddr.address.IP=netaddr.address.IP-class.html"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-17', 'IP', 'link-17');">IP</a></tt><tt class="py-op">,</tt> <tt id="link-18" class="py-name" targets="Class netaddr.address.CIDR=netaddr.address.CIDR-class.html"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-18', 'CIDR', 'link-18');">CIDR</a></tt><tt class="py-op">,</tt> <tt id="link-19" class="py-name" targets="Class netaddr.address.Wildcard=netaddr.address.Wildcard-class.html"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-19', 'Wildcard', 'link-19');">Wildcard</a></tt><tt class="py-op">,</tt> <tt id="link-20" class="py-name" targets="Class netaddr.address.EUI=netaddr.address.EUI-class.html"><a title="netaddr.address.EUI" class="py-name" href="#" onclick="return doclink('link-20', 'EUI', 'link-20');">EUI</a></tt> </tt> -<a name="L58"></a><tt class="py-lineno">58</tt> <tt class="py-line"> </tt> -<a name="L59"></a><tt class="py-lineno">59</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-21" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-21', 'netaddr', 'link-12');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-22" class="py-name" targets="Variable netaddr.address.Addr.strategy=netaddr.address.Addr-class.html#strategy,Variable netaddr.address.AddrRange.strategy=netaddr.address.AddrRange-class.html#strategy,Variable netaddr.address.CIDR.strategy=netaddr.address.CIDR-class.html#strategy,Variable netaddr.address.EUI.strategy=netaddr.address.EUI-class.html#strategy,Variable netaddr.address.IP.strategy=netaddr.address.IP-class.html#strategy,Variable netaddr.address.Wildcard.strategy=netaddr.address.Wildcard-class.html#strategy,Module netaddr.strategy=netaddr.strategy-module.html"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +<a name="L49"></a><tt class="py-lineno">49</tt> <tt class="py-line"><tt class="py-docstring"> An Exception indicating a failure to convert between address types or</tt> </tt> +<a name="L50"></a><tt class="py-lineno">50</tt> <tt class="py-line"><tt class="py-docstring"> notations.</tt> </tt> +<a name="L51"></a><tt class="py-lineno">51</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L52"></a><tt class="py-lineno">52</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +</div><a name="L53"></a><tt class="py-lineno">53</tt> <tt class="py-line"> </tt> +<a name="L54"></a><tt class="py-lineno">54</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L55"></a><tt class="py-lineno">55</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Submodule imports.</tt> </tt> +<a name="L56"></a><tt class="py-lineno">56</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L57"></a><tt class="py-lineno">57</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="L58"></a><tt class="py-lineno">58</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-12" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-12', 'netaddr', 'link-12');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-13" class="py-name" targets="Module netaddr.address=netaddr.address-module.html,Method netaddr.eui.IAB.address()=netaddr.eui.IAB-class.html#address,Method netaddr.eui.OUI.address()=netaddr.eui.OUI-class.html#address"><a title="netaddr.address +netaddr.eui.IAB.address +netaddr.eui.OUI.address" class="py-name" href="#" onclick="return doclink('link-13', 'address', 'link-13');">address</a></tt> <tt class="py-keyword">import</tt> <tt id="link-14" class="py-name" targets="Function netaddr.address.nrange()=netaddr.address-module.html#nrange"><a title="netaddr.address.nrange" class="py-name" href="#" onclick="return doclink('link-14', 'nrange', 'link-14');">nrange</a></tt><tt class="py-op">,</tt> <tt id="link-15" class="py-name" targets="Class netaddr.address.IP=netaddr.address.IP-class.html"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-15', 'IP', 'link-15');">IP</a></tt><tt class="py-op">,</tt> <tt id="link-16" class="py-name" targets="Class netaddr.address.IPRange=netaddr.address.IPRange-class.html"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-16', 'IPRange', 'link-16');">IPRange</a></tt><tt class="py-op">,</tt> <tt id="link-17" class="py-name" targets="Class netaddr.address.IPRangeSet=netaddr.address.IPRangeSet-class.html"><a title="netaddr.address.IPRangeSet" class="py-name" href="#" onclick="return doclink('link-17', 'IPRangeSet', 'link-17');">IPRangeSet</a></tt><tt class="py-op">,</tt> <tt id="link-18" class="py-name" targets="Class netaddr.address.CIDR=netaddr.address.CIDR-class.html"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-18', 'CIDR', 'link-18');">CIDR</a></tt><tt class="py-op">,</tt> \ </tt> +<a name="L59"></a><tt class="py-lineno">59</tt> <tt class="py-line"> <tt id="link-19" class="py-name" targets="Class netaddr.address.Wildcard=netaddr.address.Wildcard-class.html"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-19', 'Wildcard', 'link-19');">Wildcard</a></tt><tt class="py-op">,</tt> <tt id="link-20" class="py-name" targets="Class netaddr.address.EUI=netaddr.address.EUI-class.html"><a title="netaddr.address.EUI" class="py-name" href="#" onclick="return doclink('link-20', 'EUI', 'link-20');">EUI</a></tt> </tt> +<a name="L60"></a><tt class="py-lineno">60</tt> <tt class="py-line"> </tt> +<a name="L61"></a><tt class="py-lineno">61</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-21" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-21', 'netaddr', 'link-12');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-22" class="py-name" targets="Package netaddr.eui=netaddr.eui-module.html"><a title="netaddr.eui" class="py-name" href="#" onclick="return doclink('link-22', 'eui', 'link-22');">eui</a></tt> <tt class="py-keyword">import</tt> <tt id="link-23" class="py-name" targets="Class netaddr.eui.OUI=netaddr.eui.OUI-class.html"><a title="netaddr.eui.OUI" class="py-name" href="#" onclick="return doclink('link-23', 'OUI', 'link-23');">OUI</a></tt><tt class="py-op">,</tt> <tt id="link-24" class="py-name" targets="Class netaddr.eui.IAB=netaddr.eui.IAB-class.html"><a title="netaddr.eui.IAB" class="py-name" href="#" onclick="return doclink('link-24', 'IAB', 'link-24');">IAB</a></tt><tt class="py-op">,</tt> <tt id="link-25" class="py-name" targets="Class netaddr.eui.NotRegisteredError=netaddr.eui.NotRegisteredError-class.html"><a title="netaddr.eui.NotRegisteredError" class="py-name" href="#" onclick="return doclink('link-25', 'NotRegisteredError', 'link-25');">NotRegisteredError</a></tt> </tt> +<a name="L62"></a><tt class="py-lineno">62</tt> <tt class="py-line"> </tt> +<a name="L63"></a><tt class="py-lineno">63</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-26" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-26', 'netaddr', 'link-12');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-27" class="py-name" targets="Variable netaddr.address.Addr.strategy=netaddr.address.Addr-class.html#strategy,Variable netaddr.address.CIDR.strategy=netaddr.address.CIDR-class.html#strategy,Variable netaddr.address.EUI.strategy=netaddr.address.EUI-class.html#strategy,Variable netaddr.address.IP.strategy=netaddr.address.IP-class.html#strategy,Variable netaddr.address.IPRange.strategy=netaddr.address.IPRange-class.html#strategy,Variable netaddr.address.Wildcard.strategy=netaddr.address.Wildcard-class.html#strategy,Module netaddr.strategy=netaddr.strategy-module.html"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-22', 'strategy', 'link-22');">strategy</a></tt> <tt class="py-keyword">import</tt> <tt id="link-23" class="py-name" targets="Variable netaddr.ST_IPV4=netaddr-module.html#ST_IPV4,Variable netaddr.strategy.ST_IPV4=netaddr.strategy-module.html#ST_IPV4"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-23', 'ST_IPV4', 'link-23');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-24" class="py-name" targets="Variable netaddr.ST_IPV6=netaddr-module.html#ST_IPV6,Variable netaddr.strategy.ST_IPV6=netaddr.strategy-module.html#ST_IPV6"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-24', 'ST_IPV6', 'link-24');">ST_IPV6</a></tt><tt class="py-op">,</tt> <tt id="link-25" class="py-name" targets="Variable netaddr.ST_EUI48=netaddr-module.html#ST_EUI48,Variable netaddr.strategy.ST_EUI48=netaddr.strategy-module.html#ST_EUI48"><a title="netaddr.ST_EUI48 -netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-25', 'ST_EUI48', 'link-25');">ST_EUI48</a></tt><tt class="py-op">,</tt> <tt id="link-26" class="py-name" targets="Variable netaddr.ST_EUI64=netaddr-module.html#ST_EUI64,Variable netaddr.strategy.ST_EUI64=netaddr.strategy-module.html#ST_EUI64"><a title="netaddr.ST_EUI64 -netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-26', 'ST_EUI64', 'link-26');">ST_EUI64</a></tt> </tt> -<a name="L60"></a><tt class="py-lineno">60</tt> <tt class="py-line"> </tt> -<a name="L61"></a><tt class="py-lineno">61</tt> <tt class="py-line"><tt class="py-name">__all__</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt> </tt> -<a name="L62"></a><tt class="py-lineno">62</tt> <tt class="py-line"> <tt class="py-string">'Addr'</tt><tt class="py-op">,</tt> <tt class="py-string">'AddrRange'</tt><tt class="py-op">,</tt> <tt class="py-string">'nrange'</tt><tt class="py-op">,</tt> <tt class="py-comment"># generic functionality</tt> </tt> -<a name="L63"></a><tt class="py-lineno">63</tt> <tt class="py-line"> <tt class="py-string">'AddrFormatError'</tt><tt class="py-op">,</tt> <tt class="py-string">'AddrConversionError'</tt><tt class="py-op">,</tt> <tt class="py-comment"># custom exceptions</tt> </tt> -<a name="L64"></a><tt class="py-lineno">64</tt> <tt class="py-line"> <tt class="py-string">'IP'</tt><tt class="py-op">,</tt> <tt class="py-string">'CIDR'</tt><tt class="py-op">,</tt> <tt class="py-string">'Wildcard'</tt><tt class="py-op">,</tt> <tt class="py-string">'EUI'</tt><tt class="py-op">,</tt> <tt class="py-comment"># general purpose classes</tt> </tt> -<a name="L65"></a><tt class="py-lineno">65</tt> <tt class="py-line"> <tt class="py-string">'ST_IPV4'</tt><tt class="py-op">,</tt> <tt class="py-string">'ST_IPV6'</tt><tt class="py-op">,</tt> <tt class="py-string">'ST_EUI48'</tt><tt class="py-op">,</tt> <tt class="py-string">'ST_EUI64'</tt><tt class="py-op">,</tt> <tt class="py-comment"># shared strategy objects</tt> </tt> -<a name="L66"></a><tt class="py-lineno">66</tt> <tt class="py-line"> <tt class="py-string">'AT_INET'</tt><tt class="py-op">,</tt> <tt class="py-string">'AT_INET6'</tt><tt class="py-op">,</tt> <tt class="py-string">'AT_LINK'</tt><tt class="py-op">,</tt> <tt class="py-string">'AT_EUI64'</tt><tt class="py-op">,</tt> <tt class="py-comment"># type constants</tt> </tt> -<a name="L67"></a><tt class="py-lineno">67</tt> <tt class="py-line"><tt class="py-op">]</tt> </tt> -<a name="L68"></a><tt class="py-lineno">68</tt> <tt class="py-line"> </tt><script type="text/javascript"> +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-27', 'strategy', 'link-27');">strategy</a></tt> <tt class="py-keyword">import</tt> <tt id="link-28" class="py-name" targets="Variable netaddr.ST_IPV4=netaddr-module.html#ST_IPV4,Variable netaddr.strategy.ST_IPV4=netaddr.strategy-module.html#ST_IPV4"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-28', 'ST_IPV4', 'link-28');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-29" class="py-name" targets="Variable netaddr.ST_IPV6=netaddr-module.html#ST_IPV6,Variable netaddr.strategy.ST_IPV6=netaddr.strategy-module.html#ST_IPV6"><a title="netaddr.ST_IPV6 +netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-29', 'ST_IPV6', 'link-29');">ST_IPV6</a></tt><tt class="py-op">,</tt> <tt id="link-30" class="py-name" targets="Variable netaddr.ST_EUI48=netaddr-module.html#ST_EUI48,Variable netaddr.strategy.ST_EUI48=netaddr.strategy-module.html#ST_EUI48"><a title="netaddr.ST_EUI48 +netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-30', 'ST_EUI48', 'link-30');">ST_EUI48</a></tt><tt class="py-op">,</tt> <tt id="link-31" class="py-name" targets="Variable netaddr.ST_EUI64=netaddr-module.html#ST_EUI64,Variable netaddr.strategy.ST_EUI64=netaddr.strategy-module.html#ST_EUI64"><a title="netaddr.ST_EUI64 +netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-31', 'ST_EUI64', 'link-31');">ST_EUI64</a></tt> </tt> +<a name="L64"></a><tt class="py-lineno">64</tt> <tt class="py-line"> </tt> +<a name="L65"></a><tt class="py-lineno">65</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L66"></a><tt class="py-lineno">66</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Public interface.</tt> </tt> +<a name="L67"></a><tt class="py-lineno">67</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L68"></a><tt class="py-lineno">68</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-name">__all__</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt> </tt> +<a name="L69"></a><tt class="py-lineno">69</tt> <tt class="py-line"> <tt class="py-comment"># type constants</tt> </tt> +<a name="L70"></a><tt class="py-lineno">70</tt> <tt class="py-line"> <tt class="py-string">'AT_INET'</tt><tt class="py-op">,</tt> <tt class="py-string">'AT_INET6'</tt><tt class="py-op">,</tt> <tt class="py-string">'AT_LINK'</tt><tt class="py-op">,</tt> <tt class="py-string">'AT_EUI64'</tt><tt class="py-op">,</tt> </tt> +<a name="L71"></a><tt class="py-lineno">71</tt> <tt class="py-line"> </tt> +<a name="L72"></a><tt class="py-lineno">72</tt> <tt class="py-line"> <tt class="py-comment"># module specific exceptions</tt> </tt> +<a name="L73"></a><tt class="py-lineno">73</tt> <tt class="py-line"> <tt class="py-string">'AddrFormatError'</tt><tt class="py-op">,</tt> <tt class="py-string">'AddrConversionError'</tt><tt class="py-op">,</tt> <tt class="py-string">'NotRegisteredError'</tt><tt class="py-op">,</tt> </tt> +<a name="L74"></a><tt class="py-lineno">74</tt> <tt class="py-line"> </tt> +<a name="L75"></a><tt class="py-lineno">75</tt> <tt class="py-line"> <tt class="py-comment"># shared strategy objects</tt> </tt> +<a name="L76"></a><tt class="py-lineno">76</tt> <tt class="py-line"> <tt class="py-string">'ST_IPV4'</tt><tt class="py-op">,</tt> <tt class="py-string">'ST_IPV6'</tt><tt class="py-op">,</tt> <tt class="py-string">'ST_EUI48'</tt><tt class="py-op">,</tt> <tt class="py-string">'ST_EUI64'</tt><tt class="py-op">,</tt> </tt> +<a name="L77"></a><tt class="py-lineno">77</tt> <tt class="py-line"> </tt> +<a name="L78"></a><tt class="py-lineno">78</tt> <tt class="py-line"> <tt class="py-comment"># main interface classes</tt> </tt> +<a name="L79"></a><tt class="py-lineno">79</tt> <tt class="py-line"> <tt class="py-string">'CIDR'</tt><tt class="py-op">,</tt> <tt class="py-string">'IP'</tt><tt class="py-op">,</tt> <tt class="py-string">'IPRange'</tt><tt class="py-op">,</tt> <tt class="py-string">'IPRangeSet'</tt><tt class="py-op">,</tt> <tt class="py-string">'Wildcard'</tt><tt class="py-op">,</tt> </tt> +<a name="L80"></a><tt class="py-lineno">80</tt> <tt class="py-line"> <tt class="py-string">'EUI'</tt><tt class="py-op">,</tt> <tt class="py-string">'OUI'</tt><tt class="py-op">,</tt> <tt class="py-string">'IAB'</tt><tt class="py-op">,</tt> </tt> +<a name="L81"></a><tt class="py-lineno">81</tt> <tt class="py-line"> </tt> +<a name="L82"></a><tt class="py-lineno">82</tt> <tt class="py-line"> <tt class="py-comment"># functions</tt> </tt> +<a name="L83"></a><tt class="py-lineno">83</tt> <tt class="py-line"> <tt class="py-string">'nrange'</tt><tt class="py-op">,</tt> </tt> +<a name="L84"></a><tt class="py-lineno">84</tt> <tt class="py-line"><tt class="py-op">]</tt> </tt> +<a name="L85"></a><tt class="py-lineno">85</tt> <tt class="py-line"> </tt><script type="text/javascript"> <!-- expandto(location.href); // --> @@ -173,7 +192,7 @@ expandto(location.href); <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:25 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:24 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.AddrConversionError-class.html b/docs/api/netaddr.AddrConversionError-class.html index e764645..da58568 100644 --- a/docs/api/netaddr.AddrConversionError-class.html +++ b/docs/api/netaddr.AddrConversionError-class.html @@ -70,7 +70,8 @@ exceptions.BaseException --+ </pre> <hr /> -<p>Conversion between address types or notations failed.</p> +<p>An Exception indicating a failure to convert between address types or + notations.</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -155,7 +156,7 @@ exceptions.BaseException --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.AddrFormatError-class.html b/docs/api/netaddr.AddrFormatError-class.html index 53edc7c..3eff4d9 100644 --- a/docs/api/netaddr.AddrFormatError-class.html +++ b/docs/api/netaddr.AddrFormatError-class.html @@ -70,7 +70,8 @@ exceptions.BaseException --+ </pre> <hr /> -<p>Network address format not recognised.</p> +<p>An Exception indicating that a network address format is not + recognised.</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -155,7 +156,7 @@ exceptions.BaseException --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address-module.html b/docs/api/netaddr.address-module.html index 7251d09..05a5770 100755 --- a/docs/api/netaddr.address-module.html +++ b/docs/api/netaddr.address-module.html @@ -60,7 +60,7 @@ <!-- ==================== MODULE DESCRIPTION ==================== --> <h1 class="epydoc">Module address</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.address-pysrc.html">source code</a></span></p> <p>network address classes (IP, EUI) and associated aggregate classes - (CIDR, Wilcard, etc).</p> + (CIDR, Wildcard and IPRange).</p> <!-- ==================== CLASSES ==================== --> <a name="section-Classes"></a> @@ -112,9 +112,9 @@ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.KlassDescriptor-class.html" class="summary-name">KlassDescriptor</a><br /> - A descriptor that checks klass (data flavour) property assignments - for validity. + <a href="netaddr.address.FormatDescriptor-class.html" class="summary-name">FormatDescriptor</a><br /> + A descriptor that checks formatter property assignments for + validity. </td> </tr> <tr> @@ -131,7 +131,7 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address.EUI-class.html" class="summary-name">EUI</a><br /> - EUI objects represent IEEE Extended Unique Identifiers. + Represents an IEEE EUI (Extended Unique Identifier) indentifier. </td> </tr> <tr> @@ -139,17 +139,16 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address.IP-class.html" class="summary-name">IP</a><br /> - A class whose objects represent Internet Protocol network - addresses. + Represents <b>individual</b> IPv4 and IPv6 addresses. </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.AddrRange-class.html" class="summary-name">AddrRange</a><br /> - A block of contiguous network addresses bounded by an arbitrary - start and stop address. + <a href="netaddr.address.IPRange-class.html" class="summary-name">IPRange</a><br /> + Represents arbitrary contiguous blocks of IPv4 and IPv6 addresses + using only a lower and upper bound IP address. </td> </tr> <tr> @@ -157,9 +156,8 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address.CIDR-class.html" class="summary-name">CIDR</a><br /> - A block of contiguous IPv4 or IPv6 network addresses defined by a - base network address and a bitmask prefix or subnet mask address - indicating the size/extent of the subnet. + Represents blocks of IPv4 and IPv6 addresses using CIDR (Classless + Inter-Domain Routing) notation. </td> </tr> <tr> @@ -167,8 +165,17 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address.Wildcard-class.html" class="summary-name">Wildcard</a><br /> - A block of contiguous IPv4 network addresses defined using a - wildcard style syntax. + Represents blocks of IPv4 addresses using a wildcard or glob style + syntax. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.address.IPRangeSet-class.html" class="summary-name">IPRangeSet</a><br /> + <b>*EXPERIMENTAL*</b> A customised Python set class that deals with + collections of IPRange class and subclass instances. </td> </tr> </table> @@ -189,9 +196,10 @@ <td><span class="summary-sig"><a href="netaddr.address-module.html#nrange" class="summary-sig-name">nrange</a>(<span class="summary-sig-arg">start</span>, <span class="summary-sig-arg">stop</span>, <span class="summary-sig-arg">step</span>=<span class="summary-sig-default">1</span>, - <span class="summary-sig-arg">klass</span>=<span class="summary-sig-default">None</span>)</span><br /> - A generator producing sequences of network addresses based on start - and stop values, in intervals of step.</td> + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default">None</span>)</span><br /> + An xrange work alike generator that produces sequences of IP + addresses based on start and stop addresses, in intervals of step + size.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#nrange">source code</a></span> @@ -215,10 +223,10 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.address-module.html#AT_STRATEGIES" class="summary-name">AT_STRATEGIES</a> = <code title="{0: None, - 4: netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False), - 6: netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False), - 48: netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True), - 64: netaddr.address.AddrStrategy(64, 8, '-', 64, True, True)}"><code class="variable-group">{</code>0<code class="variable-op">: </code>None<code class="variable-op">, </code>4<code class="variable-op">: </code>netaddr.address.IPv4StrategyOpt(3<code class="variable-ellipsis">...</code></code><br /> + 4: netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False), + 6: netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False), + 48: netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True), + 64: netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)}"><code class="variable-group">{</code>0<code class="variable-op">: </code>None<code class="variable-op">, </code>4<code class="variable-op">: </code>netaddr.address.IPv4StrategyOpt(3<code class="variable-ellipsis">...</code></code><br /> Address type to strategy object lookup dict. </td> </tr> @@ -242,43 +250,42 @@ <h3 class="epydoc"><span class="sig"><span class="sig-name">nrange</span>(<span class="sig-arg">start</span>, <span class="sig-arg">stop</span>, <span class="sig-arg">step</span>=<span class="sig-default">1</span>, - <span class="sig-arg">klass</span>=<span class="sig-default">None</span>)</span> + <span class="sig-arg">fmt</span>=<span class="sig-default">None</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.address-pysrc.html#nrange">source code</a></span> </td> </tr></table> - <p>A generator producing sequences of network addresses based on start - and stop values, in intervals of step.</p> + <p>An xrange work alike generator that produces sequences of IP addresses + based on start and stop addresses, in intervals of step size.</p> <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>start</code></strong> - first network address as string or instance of <a - href="netaddr.address.Addr-class.html" class="link">Addr</a> - (sub)class.</li> - <li><strong class="pname"><code>stop</code></strong> - last network address as string or instance of <a - href="netaddr.address.Addr-class.html" class="link">Addr</a> - (sub)class.</li> - <li><strong class="pname"><code>step</code></strong> - (optional) size of step between addresses in range. Default is 1.</li> - <li><strong class="pname"><code>klass</code></strong> - (optional) the class used to create objects returned. Default: <a - href="netaddr.address.Addr-class.html" class="link">Addr</a> - class. + <li><strong class="pname"><code>start</code></strong> - first IP address string or <a + href="netaddr.address.IP-class.html" class="link">IP</a> object + in range.</li> + <li><strong class="pname"><code>stop</code></strong> - last IP address string or <a href="netaddr.address.IP-class.html" + class="link">IP</a> object in range</li> + <li><strong class="pname"><code>step</code></strong> - (optional) size of step between address in range. (Default: 1)</li> + <li><strong class="pname"><code>fmt</code></strong> - (optional) callable used on addresses returned. (Default: None - + <a href="netaddr.address.IP-class.html" class="link">IP</a> + objects). Supported options :- <ul> <li> - <code>str</code> returns string representation of network - address + <code>str</code> - IP address strings + </li> + <li> + <code>int</code>, <code>long</code> - IP address integer + (network byte order) </li> <li> - <code>int</code>, <code>long</code> and <code>hex</code> - return expected values + <code>hex</code> - IP address as a hexadecimal number </li> <li> - <a href="netaddr.address.Addr-class.html" - class="link">Addr</a> (sub)class or duck type* return objects - of that class. If you use your own duck class, make sure you - handle both arguments <code>(addr_value, addr_type)</code> - passed to the constructor. + <a href="netaddr.address.IP-class.html" class="link">IP</a> + class/subclass or callable that accepts + <code>addr_value</code> and <code>addr_type</code> arguments. </li> </ul></li> </ul></dd> @@ -308,10 +315,10 @@ <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> <code class="variable-group">{</code>0<code class="variable-op">: </code>None<code class="variable-op">,</code> - 4<code class="variable-op">: </code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)<code class="variable-op">,</code> - 6<code class="variable-op">: </code>netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)<code class="variable-op">,</code> - 48<code class="variable-op">: </code>netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True)<code class="variable-op">,</code> - 64<code class="variable-op">: </code>netaddr.address.AddrStrategy(64, 8, '-', 64, True, True)<code class="variable-group">}</code> + 4<code class="variable-op">: </code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False)<code class="variable-op">,</code> + 6<code class="variable-op">: </code>netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False)<code class="variable-op">,</code> + 48<code class="variable-op">: </code>netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True)<code class="variable-op">,</code> + 64<code class="variable-op">: </code>netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)<code class="variable-group">}</code> </pre></td></tr></table> </dd> </dl> @@ -349,7 +356,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address-pysrc.html b/docs/api/netaddr.address-pysrc.html index 86f0cc4..02358a9 100755 --- a/docs/api/netaddr.address-pysrc.html +++ b/docs/api/netaddr.address-pysrc.html @@ -67,7 +67,7 @@ <a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> <a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-docstring">"""</tt> </tt> <a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">network address classes (IP, EUI) and associated aggregate classes (CIDR,</tt> </tt> -<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">Wilcard, etc).</tt> </tt> +<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">Wildcard and IPRange).</tt> </tt> <a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> <a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">math</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_math</tt> </tt> <a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">socket</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_socket</tt> </tt> @@ -75,11 +75,11 @@ <a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-0" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-0', 'netaddr', 'link-0');">netaddr</a></tt> <tt class="py-keyword">import</tt> <tt id="link-1" class="py-name" targets="Class netaddr.AddrFormatError=netaddr.AddrFormatError-class.html"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-1', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">,</tt> <tt id="link-2" class="py-name" targets="Class netaddr.AddrConversionError=netaddr.AddrConversionError-class.html"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-2', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">,</tt> <tt id="link-3" class="py-name" targets="Variable netaddr.AT_UNSPEC=netaddr-module.html#AT_UNSPEC"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-3', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> \ </tt> <a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"> <tt id="link-4" class="py-name" targets="Variable netaddr.AT_INET=netaddr-module.html#AT_INET"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-4', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-5" class="py-name" targets="Variable netaddr.AT_INET6=netaddr-module.html#AT_INET6"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-5', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">,</tt> <tt id="link-6" class="py-name" targets="Variable netaddr.AT_LINK=netaddr-module.html#AT_LINK"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-6', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-7" class="py-name" targets="Variable netaddr.AT_EUI64=netaddr-module.html#AT_EUI64"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-7', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt><tt class="py-op">,</tt> <tt id="link-8" class="py-name" targets="Variable netaddr.AT_NAMES=netaddr-module.html#AT_NAMES"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-8', 'AT_NAMES', 'link-8');">AT_NAMES</a></tt> </tt> <a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"> </tt> -<a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-9" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-9', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-10" class="py-name" targets="Variable netaddr.address.Addr.strategy=netaddr.address.Addr-class.html#strategy,Variable netaddr.address.AddrRange.strategy=netaddr.address.AddrRange-class.html#strategy,Variable netaddr.address.CIDR.strategy=netaddr.address.CIDR-class.html#strategy,Variable netaddr.address.EUI.strategy=netaddr.address.EUI-class.html#strategy,Variable netaddr.address.IP.strategy=netaddr.address.IP-class.html#strategy,Variable netaddr.address.Wildcard.strategy=netaddr.address.Wildcard-class.html#strategy,Module netaddr.strategy=netaddr.strategy-module.html"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +<a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-9" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-9', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-10" class="py-name" targets="Variable netaddr.address.Addr.strategy=netaddr.address.Addr-class.html#strategy,Variable netaddr.address.CIDR.strategy=netaddr.address.CIDR-class.html#strategy,Variable netaddr.address.EUI.strategy=netaddr.address.EUI-class.html#strategy,Variable netaddr.address.IP.strategy=netaddr.address.IP-class.html#strategy,Variable netaddr.address.IPRange.strategy=netaddr.address.IPRange-class.html#strategy,Variable netaddr.address.Wildcard.strategy=netaddr.address.Wildcard-class.html#strategy,Module netaddr.strategy=netaddr.strategy-module.html"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-10', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-keyword">import</tt> <tt id="link-11" class="py-name" targets="Variable netaddr.ST_IPV4=netaddr-module.html#ST_IPV4,Variable netaddr.strategy.ST_IPV4=netaddr.strategy-module.html#ST_IPV4"><a title="netaddr.ST_IPV4 netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-11', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-12" class="py-name" targets="Variable netaddr.ST_IPV6=netaddr-module.html#ST_IPV6,Variable netaddr.strategy.ST_IPV6=netaddr.strategy-module.html#ST_IPV6"><a title="netaddr.ST_IPV6 @@ -88,2999 +88,3931 @@ netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('lin netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-14', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">,</tt> \ </tt> <a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"> <tt id="link-15" class="py-name" targets="Class netaddr.strategy.AddrStrategy=netaddr.strategy.AddrStrategy-class.html"><a title="netaddr.strategy.AddrStrategy" class="py-name" href="#" onclick="return doclink('link-15', 'AddrStrategy', 'link-15');">AddrStrategy</a></tt> </tt> <a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"> </tt> -<a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"><tt class="py-comment">#: Address type to strategy object lookup dict.</tt> </tt> -<a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-16" class="py-name" targets="Variable netaddr.address.AT_STRATEGIES=netaddr.address-module.html#AT_STRATEGIES"><a title="netaddr.address.AT_STRATEGIES" class="py-name" href="#" onclick="return doclink('link-16', 'AT_STRATEGIES', 'link-16');">AT_STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt> -<a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"> <tt id="link-17" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-17', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt> <tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> </tt> -<a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"> <tt id="link-18" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-18', 'AT_INET', 'link-4');">AT_INET</a></tt> <tt class="py-op">:</tt> <tt id="link-19" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-19', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> </tt> -<a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"> <tt id="link-20" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-20', 'AT_INET6', 'link-5');">AT_INET6</a></tt> <tt class="py-op">:</tt> <tt id="link-21" class="py-name"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-21', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">,</tt> </tt> -<a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"> <tt id="link-22" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-22', 'AT_LINK', 'link-6');">AT_LINK</a></tt> <tt class="py-op">:</tt> <tt id="link-23" class="py-name"><a title="netaddr.ST_EUI48 -netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-23', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">,</tt> </tt> -<a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"> <tt id="link-24" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-24', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt> <tt class="py-op">:</tt> <tt id="link-25" class="py-name"><a title="netaddr.ST_EUI64 -netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-25', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">,</tt> </tt> -<a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"><tt class="py-op">}</tt> </tt> -<a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"> </tt> -<a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Descriptor protocol classes.</tt> </tt> -<a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="AddrTypeDescriptor"></a><div id="AddrTypeDescriptor-def"><a name="L33"></a><tt class="py-lineno"> 33</tt> <a class="py-toggle" href="#" id="AddrTypeDescriptor-toggle" onclick="return toggle('AddrTypeDescriptor');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.AddrTypeDescriptor-class.html">AddrTypeDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrTypeDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="AddrTypeDescriptor-expanded"><a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks addr_type property assignments for validity and</tt> </tt> -<a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"><tt class="py-docstring"> also keeps the strategy property in sync with any changes made.</tt> </tt> -<a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="AddrTypeDescriptor.__init__"></a><div id="AddrTypeDescriptor.__init__-def"><a name="L38"></a><tt class="py-lineno"> 38</tt> <a class="py-toggle" href="#" id="AddrTypeDescriptor.__init__-toggle" onclick="return toggle('AddrTypeDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrTypeDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr_types</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrTypeDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrTypeDescriptor.__init__-expanded"><a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_types: a list of address types constants that are</tt> </tt> -<a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt class="py-docstring"> acceptable for assignment to the addr_type property.</tt> </tt> -<a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">addr_types</tt> <tt class="py-op">=</tt> <tt class="py-name">addr_types</tt> </tt> -</div><a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"> </tt> -<a name="AddrTypeDescriptor.__set__"></a><div id="AddrTypeDescriptor.__set__-def"><a name="L47"></a><tt class="py-lineno"> 47</tt> <a class="py-toggle" href="#" id="AddrTypeDescriptor.__set__-toggle" onclick="return toggle('AddrTypeDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrTypeDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrTypeDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrTypeDescriptor.__set__-expanded"><a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-26" class="py-name" targets="Variable netaddr.address.Addr.value=netaddr.address.Addr-class.html#value"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-26', 'value', 'link-26');">value</a></tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">addr_types</tt><tt class="py-op">:</tt> </tt> -<a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'addr_type %r is invalid for objects of '</tt> \ </tt> -<a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"> <tt class="py-string">'the %s() class!'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-27" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-27', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'addr_type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-28" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-28', 'value', 'link-26');">value</a></tt> </tt> -<a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'strategy'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-29" class="py-name"><a title="netaddr.address.AT_STRATEGIES" class="py-name" href="#" onclick="return doclink('link-29', 'AT_STRATEGIES', 'link-16');">AT_STRATEGIES</a></tt><tt class="py-op">[</tt><tt id="link-30" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-30', 'value', 'link-26');">value</a></tt><tt class="py-op">]</tt> </tt> -</div></div><a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"> </tt> -<a name="L54"></a><tt class="py-lineno"> 54</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="AddrValueDescriptor"></a><div id="AddrValueDescriptor-def"><a name="L55"></a><tt class="py-lineno"> 55</tt> <a class="py-toggle" href="#" id="AddrValueDescriptor-toggle" onclick="return toggle('AddrValueDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.AddrValueDescriptor-class.html">AddrValueDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrValueDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="AddrValueDescriptor-expanded"><a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks assignments to the named parameter passed to the</tt> </tt> -<a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"><tt class="py-docstring"> constructor. It accepts network addresses in either string format or as</tt> </tt> -<a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"><tt class="py-docstring"> network byte order integers. String based addresses are converted to their</tt> </tt> -<a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-docstring"> integer equivalents before assignment to the named parameter. Also ensures</tt> </tt> -<a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"><tt class="py-docstring"> that addr_type and strategy are set correctly when parsing string based</tt> </tt> -<a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"><tt class="py-docstring"> addresses.</tt> </tt> -<a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="AddrValueDescriptor.__init__"></a><div id="AddrValueDescriptor.__init__-def"><a name="L64"></a><tt class="py-lineno"> 64</tt> <a class="py-toggle" href="#" id="AddrValueDescriptor.__init__-toggle" onclick="return toggle('AddrValueDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrValueDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">name</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrValueDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrValueDescriptor.__init__-expanded"><a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"><tt class="py-docstring"> Descriptor constructor.</tt> </tt> -<a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"><tt class="py-docstring"> @param name: the name of attribute which will be assigned the value.</tt> </tt> -<a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt class="py-name">name</tt> </tt> -</div><a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"> </tt> -<a name="AddrValueDescriptor.__set__"></a><div id="AddrValueDescriptor.__set__-def"><a name="L72"></a><tt class="py-lineno"> 72</tt> <a class="py-toggle" href="#" id="AddrValueDescriptor.__set__-toggle" onclick="return toggle('AddrValueDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrValueDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrValueDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrValueDescriptor.__set__-expanded"><a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt id="link-31" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-31', 'value', 'link-26');">value</a></tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt id="link-32" class="py-name" targets="Class netaddr.address.Addr=netaddr.address.Addr-class.html"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-32', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-33" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-33', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-34" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-34', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-35" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-35', 'value', 'link-26');">value</a></tt><tt class="py-op">.</tt><tt id="link-36" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-36', 'strategy', 'link-10');">strategy</a></tt> </tt> -<a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"> <tt id="link-37" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-37', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-38" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-38', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-39" class="py-name" targets="Variable netaddr.address.Addr.addr_type=netaddr.address.Addr-class.html#addr_type,Variable netaddr.address.AddrRange.addr_type=netaddr.address.AddrRange-class.html#addr_type,Variable netaddr.address.CIDR.addr_type=netaddr.address.CIDR-class.html#addr_type,Variable netaddr.address.EUI.addr_type=netaddr.address.EUI-class.html#addr_type,Variable netaddr.address.IP.addr_type=netaddr.address.IP-class.html#addr_type,Variable netaddr.address.Wildcard.addr_type=netaddr.address.Wildcard-class.html#addr_type"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-39', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-40" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-40', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">:</tt> </tt> -<a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"> <tt class="py-comment"># Select a strategy object for this address.</tt> </tt> -<a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">for</tt> <tt id="link-41" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-41', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt id="link-42" class="py-name" targets="Variable netaddr.address.Addr.STRATEGIES=netaddr.address.Addr-class.html#STRATEGIES,Variable netaddr.address.AddrRange.STRATEGIES=netaddr.address.AddrRange-class.html#STRATEGIES,Variable netaddr.address.CIDR.STRATEGIES=netaddr.address.CIDR-class.html#STRATEGIES,Variable netaddr.address.EUI.STRATEGIES=netaddr.address.EUI-class.html#STRATEGIES,Variable netaddr.address.IP.STRATEGIES=netaddr.address.IP-class.html#STRATEGIES,Variable netaddr.address.Wildcard.STRATEGIES=netaddr.address.Wildcard-class.html#STRATEGIES"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +<a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-16" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-16', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-17" class="py-name" targets="Package netaddr.eui=netaddr.eui-module.html"><a title="netaddr.eui" class="py-name" href="#" onclick="return doclink('link-17', 'eui', 'link-17');">eui</a></tt> <tt class="py-keyword">import</tt> <tt id="link-18" class="py-name" targets="Class netaddr.eui.OUI=netaddr.eui.OUI-class.html"><a title="netaddr.eui.OUI" class="py-name" href="#" onclick="return doclink('link-18', 'OUI', 'link-18');">OUI</a></tt><tt class="py-op">,</tt> <tt id="link-19" class="py-name" targets="Class netaddr.eui.IAB=netaddr.eui.IAB-class.html"><a title="netaddr.eui.IAB" class="py-name" href="#" onclick="return doclink('link-19', 'IAB', 'link-19');">IAB</a></tt> </tt> +<a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"> </tt> +<a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"><tt class="py-comment">#: Address type to strategy object lookup dict.</tt> </tt> +<a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-20" class="py-name" targets="Variable netaddr.address.AT_STRATEGIES=netaddr.address-module.html#AT_STRATEGIES"><a title="netaddr.address.AT_STRATEGIES" class="py-name" href="#" onclick="return doclink('link-20', 'AT_STRATEGIES', 'link-20');">AT_STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt> +<a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"> <tt id="link-21" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-21', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt> <tt class="py-op">:</tt> <tt class="py-name">None</tt><tt class="py-op">,</tt> </tt> +<a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"> <tt id="link-22" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-22', 'AT_INET', 'link-4');">AT_INET</a></tt> <tt class="py-op">:</tt> <tt id="link-23" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-23', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> </tt> +<a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"> <tt id="link-24" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-24', 'AT_INET6', 'link-5');">AT_INET6</a></tt> <tt class="py-op">:</tt> <tt id="link-25" class="py-name"><a title="netaddr.ST_IPV6 +netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-25', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">,</tt> </tt> +<a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"> <tt id="link-26" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-26', 'AT_LINK', 'link-6');">AT_LINK</a></tt> <tt class="py-op">:</tt> <tt id="link-27" class="py-name"><a title="netaddr.ST_EUI48 +netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-27', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">,</tt> </tt> +<a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"> <tt id="link-28" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-28', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt> <tt class="py-op">:</tt> <tt id="link-29" class="py-name"><a title="netaddr.ST_EUI64 +netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-29', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">,</tt> </tt> +<a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-op">}</tt> </tt> +<a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"> </tt> +<a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="AddrTypeDescriptor"></a><div id="AddrTypeDescriptor-def"><a name="L32"></a><tt class="py-lineno"> 32</tt> <a class="py-toggle" href="#" id="AddrTypeDescriptor-toggle" onclick="return toggle('AddrTypeDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.AddrTypeDescriptor-class.html">AddrTypeDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrTypeDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="AddrTypeDescriptor-expanded"><a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks addr_type property assignments for validity and</tt> </tt> +<a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"><tt class="py-docstring"> also keeps the strategy property in sync with any changes made.</tt> </tt> +<a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="AddrTypeDescriptor.__init__"></a><div id="AddrTypeDescriptor.__init__-def"><a name="L37"></a><tt class="py-lineno"> 37</tt> <a class="py-toggle" href="#" id="AddrTypeDescriptor.__init__-toggle" onclick="return toggle('AddrTypeDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrTypeDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr_types</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrTypeDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrTypeDescriptor.__init__-expanded"><a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_types: a list of address types constants that are</tt> </tt> +<a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt class="py-docstring"> acceptable for assignment to the addr_type property.</tt> </tt> +<a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">addr_types</tt> <tt class="py-op">=</tt> <tt class="py-name">addr_types</tt> </tt> +</div><a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"> </tt> +<a name="AddrTypeDescriptor.__set__"></a><div id="AddrTypeDescriptor.__set__-def"><a name="L46"></a><tt class="py-lineno"> 46</tt> <a class="py-toggle" href="#" id="AddrTypeDescriptor.__set__-toggle" onclick="return toggle('AddrTypeDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrTypeDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrTypeDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrTypeDescriptor.__set__-expanded"><a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-30" class="py-name" targets="Variable netaddr.address.Addr.value=netaddr.address.Addr-class.html#value"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-30', 'value', 'link-30');">value</a></tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">addr_types</tt><tt class="py-op">:</tt> </tt> +<a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'addr_type %r is invalid for objects of '</tt> \ </tt> +<a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"> <tt class="py-string">'the %s() class!'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-31" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-31', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'addr_type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-32" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-32', 'value', 'link-30');">value</a></tt> </tt> +<a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'strategy'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-33" class="py-name"><a title="netaddr.address.AT_STRATEGIES" class="py-name" href="#" onclick="return doclink('link-33', 'AT_STRATEGIES', 'link-20');">AT_STRATEGIES</a></tt><tt class="py-op">[</tt><tt id="link-34" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-34', 'value', 'link-30');">value</a></tt><tt class="py-op">]</tt> </tt> +</div></div><a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"> </tt> +<a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="AddrValueDescriptor"></a><div id="AddrValueDescriptor-def"><a name="L54"></a><tt class="py-lineno"> 54</tt> <a class="py-toggle" href="#" id="AddrValueDescriptor-toggle" onclick="return toggle('AddrValueDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.AddrValueDescriptor-class.html">AddrValueDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrValueDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="AddrValueDescriptor-expanded"><a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks assignments to the named parameter passed to the</tt> </tt> +<a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"><tt class="py-docstring"> constructor. It accepts network addresses in either string format or as</tt> </tt> +<a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"><tt class="py-docstring"> network byte order integers. String based addresses are converted to their</tt> </tt> +<a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"><tt class="py-docstring"> integer equivalents before assignment to the named parameter. Also ensures</tt> </tt> +<a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-docstring"> that addr_type and strategy are set correctly when parsing string based</tt> </tt> +<a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"><tt class="py-docstring"> addresses.</tt> </tt> +<a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="AddrValueDescriptor.__init__"></a><div id="AddrValueDescriptor.__init__-def"><a name="L63"></a><tt class="py-lineno"> 63</tt> <a class="py-toggle" href="#" id="AddrValueDescriptor.__init__-toggle" onclick="return toggle('AddrValueDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrValueDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">name</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrValueDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrValueDescriptor.__init__-expanded"><a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"><tt class="py-docstring"> Descriptor constructor.</tt> </tt> +<a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"><tt class="py-docstring"> @param name: the name of attribute which will be assigned the value.</tt> </tt> +<a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt class="py-name">name</tt> </tt> +</div><a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"> </tt> +<a name="AddrValueDescriptor.__set__"></a><div id="AddrValueDescriptor.__set__-def"><a name="L71"></a><tt class="py-lineno"> 71</tt> <a class="py-toggle" href="#" id="AddrValueDescriptor.__set__-toggle" onclick="return toggle('AddrValueDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrValueDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrValueDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrValueDescriptor.__set__-expanded"><a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt id="link-35" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-35', 'value', 'link-30');">value</a></tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt id="link-36" class="py-name" targets="Class netaddr.address.Addr=netaddr.address.Addr-class.html"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-36', 'Addr', 'link-36');">Addr</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-37" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-37', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-38" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-38', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-39" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-39', 'value', 'link-30');">value</a></tt><tt class="py-op">.</tt><tt id="link-40" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-40', 'strategy', 'link-10');">strategy</a></tt> </tt> +<a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"> <tt id="link-41" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-41', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-42" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-42', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-43" class="py-name" targets="Variable netaddr.address.Addr.addr_type=netaddr.address.Addr-class.html#addr_type,Variable netaddr.address.CIDR.addr_type=netaddr.address.CIDR-class.html#addr_type,Variable netaddr.address.EUI.addr_type=netaddr.address.EUI-class.html#addr_type,Variable netaddr.address.IP.addr_type=netaddr.address.IP-class.html#addr_type,Variable netaddr.address.IPRange.addr_type=netaddr.address.IPRange-class.html#addr_type,Variable netaddr.address.Wildcard.addr_type=netaddr.address.Wildcard-class.html#addr_type"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-43', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-44" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-44', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">:</tt> </tt> +<a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"> <tt class="py-comment"># Select a strategy object for this address.</tt> </tt> +<a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">for</tt> <tt id="link-45" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-45', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt id="link-46" class="py-name" targets="Variable netaddr.address.Addr.STRATEGIES=netaddr.address.Addr-class.html#STRATEGIES,Variable netaddr.address.CIDR.STRATEGIES=netaddr.address.CIDR-class.html#STRATEGIES,Variable netaddr.address.EUI.STRATEGIES=netaddr.address.EUI-class.html#STRATEGIES,Variable netaddr.address.IP.STRATEGIES=netaddr.address.IP-class.html#STRATEGIES,Variable netaddr.address.IPRange.STRATEGIES=netaddr.address.IPRange-class.html#STRATEGIES,Variable netaddr.address.Wildcard.STRATEGIES=netaddr.address.Wildcard-class.html#STRATEGIES"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-42', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt><tt class="py-op">:</tt> </tt> -<a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-43" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-46', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt><tt class="py-op">:</tt> </tt> +<a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-47" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-43', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-44" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_str()=netaddr.strategy.AddrStrategy-class.html#valid_str,Method netaddr.strategy.EUI48Strategy.valid_str()=netaddr.strategy.EUI48Strategy-class.html#valid_str,Method netaddr.strategy.IPv6Strategy.valid_str()=netaddr.strategy.IPv6Strategy-class.html#valid_str"><a title="netaddr.strategy.AddrStrategy.valid_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-47', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-48" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_str()=netaddr.strategy.AddrStrategy-class.html#valid_str,Method netaddr.strategy.EUI48Strategy.valid_str()=netaddr.strategy.EUI48Strategy-class.html#valid_str,Method netaddr.strategy.IPv4StrategyOpt.valid_str()=netaddr.strategy.IPv4StrategyOpt-class.html#valid_str,Method netaddr.strategy.IPv6Strategy.valid_str()=netaddr.strategy.IPv6Strategy-class.html#valid_str"><a title="netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-44', 'valid_str', 'link-44');">valid_str</a></tt><tt class="py-op">(</tt><tt id="link-45" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-45', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-46" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-48', 'valid_str', 'link-48');">valid_str</a></tt><tt class="py-op">(</tt><tt id="link-49" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-49', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-50" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-46', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-47" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-50', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-51" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-47', 'strategy', 'link-10');">strategy</a></tt> </tt> -<a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> -<a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"> </tt> -<a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"> <tt class="py-comment"># Make sure we picked up a strategy object.</tt> </tt> -<a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-48" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-51', 'strategy', 'link-10');">strategy</a></tt> </tt> +<a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> +<a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"> </tt> +<a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"> <tt class="py-comment"># Make sure we picked up a strategy object.</tt> </tt> +<a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-52" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-48', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-49" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-49', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a recognised address '</tt> \ </tt> -<a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"> <tt class="py-string">'format!'</tt> <tt class="py-op">%</tt> <tt id="link-50" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-50', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"> </tt> -<a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-51" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-51', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"> <tt class="py-comment"># Calculate the integer value for this address.</tt> </tt> -<a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-52" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-52', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-53" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-52', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-53" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-53', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a supported address '</tt> \ </tt> +<a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"> <tt class="py-string">'format!'</tt> <tt class="py-op">%</tt> <tt id="link-54" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-54', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"> </tt> +<a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-55" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-55', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"> <tt class="py-comment"># Calculate the integer value for this address.</tt> </tt> +<a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-56" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-56', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-57" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-53', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-54" class="py-name" targets="Method netaddr.strategy.AddrStrategy.str_to_int()=netaddr.strategy.AddrStrategy-class.html#str_to_int,Method netaddr.strategy.IPv4StrategyOpt.str_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int,Method netaddr.strategy.IPv6Strategy.str_to_int()=netaddr.strategy.IPv6Strategy-class.html#str_to_int"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-57', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-58" class="py-name" targets="Method netaddr.strategy.AddrStrategy.str_to_int()=netaddr.strategy.AddrStrategy-class.html#str_to_int,Method netaddr.strategy.EUI48Strategy.str_to_int()=netaddr.strategy.EUI48Strategy-class.html#str_to_int,Method netaddr.strategy.IPv4StrategyOpt.str_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int,Method netaddr.strategy.IPv6Strategy.str_to_int()=netaddr.strategy.IPv6Strategy-class.html#str_to_int"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.EUI48Strategy.str_to_int netaddr.strategy.IPv4StrategyOpt.str_to_int -netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-54', 'str_to_int', 'link-54');">str_to_int</a></tt><tt class="py-op">(</tt><tt id="link-55" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-55', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-56" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-56', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-57" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-57', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-58" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_int()=netaddr.strategy.AddrStrategy-class.html#valid_int"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-58', 'valid_int', 'link-58');">valid_int</a></tt><tt class="py-op">(</tt><tt id="link-59" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-59', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">OverflowError</tt><tt class="py-op">(</tt><tt class="py-string">'value %r cannot be represented '</tt> \ </tt> -<a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"> <tt class="py-string">'in %d bit(s)!'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-60" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-60', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-61" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-61', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is an unsupported type!'</tt> <tt class="py-op">%</tt> <tt id="link-62" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-62', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"> </tt> -<a name="L100"></a><tt class="py-lineno"> 100</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-63" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-63', 'value', 'link-26');">value</a></tt> </tt> -</div></div><a name="L101"></a><tt class="py-lineno"> 101</tt> <tt class="py-line"> </tt> -<a name="L102"></a><tt class="py-lineno"> 102</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="StrategyDescriptor"></a><div id="StrategyDescriptor-def"><a name="L103"></a><tt class="py-lineno"> 103</tt> <a class="py-toggle" href="#" id="StrategyDescriptor-toggle" onclick="return toggle('StrategyDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.StrategyDescriptor-class.html">StrategyDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="StrategyDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="StrategyDescriptor-expanded"><a name="L104"></a><tt class="py-lineno"> 104</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L105"></a><tt class="py-lineno"> 105</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks strategy property assignments for validity and</tt> </tt> -<a name="L106"></a><tt class="py-lineno"> 106</tt> <tt class="py-line"><tt class="py-docstring"> also keeps the addr_type property in sync with any changes made.</tt> </tt> -<a name="L107"></a><tt class="py-lineno"> 107</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="StrategyDescriptor.__init__"></a><div id="StrategyDescriptor.__init__-def"><a name="L108"></a><tt class="py-lineno"> 108</tt> <a class="py-toggle" href="#" id="StrategyDescriptor.__init__-toggle" onclick="return toggle('StrategyDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.StrategyDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">strategies</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="StrategyDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="StrategyDescriptor.__init__-expanded"><a name="L109"></a><tt class="py-lineno"> 109</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L110"></a><tt class="py-lineno"> 110</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L111"></a><tt class="py-lineno"> 111</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L112"></a><tt class="py-lineno"> 112</tt> <tt class="py-line"><tt class="py-docstring"> @param strategies: a list of strategy objects that are acceptable for</tt> </tt> -<a name="L113"></a><tt class="py-lineno"> 113</tt> <tt class="py-line"><tt class="py-docstring"> assignment to the strategy property.</tt> </tt> -<a name="L114"></a><tt class="py-lineno"> 114</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L115"></a><tt class="py-lineno"> 115</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">strategies</tt> <tt class="py-op">=</tt> <tt class="py-name">strategies</tt> </tt> -</div><a name="L116"></a><tt class="py-lineno"> 116</tt> <tt class="py-line"> </tt> -<a name="StrategyDescriptor.__set__"></a><div id="StrategyDescriptor.__set__-def"><a name="L117"></a><tt class="py-lineno"> 117</tt> <a class="py-toggle" href="#" id="StrategyDescriptor.__set__-toggle" onclick="return toggle('StrategyDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.StrategyDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="StrategyDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="StrategyDescriptor.__set__-expanded"><a name="L118"></a><tt class="py-lineno"> 118</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-64" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-64', 'value', 'link-26');">value</a></tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">strategies</tt><tt class="py-op">:</tt> </tt> -<a name="L119"></a><tt class="py-lineno"> 119</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">Exception</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a supported strategy!'</tt> <tt class="py-op">%</tt> <tt id="link-65" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-65', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L120"></a><tt class="py-lineno"> 120</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'strategy'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-66" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-66', 'value', 'link-26');">value</a></tt> </tt> -<a name="L121"></a><tt class="py-lineno"> 121</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'addr_type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-67" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-67', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-68" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-68', 'addr_type', 'link-39');">addr_type</a></tt> </tt> -</div></div><a name="L122"></a><tt class="py-lineno"> 122</tt> <tt class="py-line"> </tt> -<a name="L123"></a><tt class="py-lineno"> 123</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="PrefixLenDescriptor"></a><div id="PrefixLenDescriptor-def"><a name="L124"></a><tt class="py-lineno"> 124</tt> <a class="py-toggle" href="#" id="PrefixLenDescriptor-toggle" onclick="return toggle('PrefixLenDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.PrefixLenDescriptor-class.html">PrefixLenDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="PrefixLenDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="PrefixLenDescriptor-expanded"><a name="L125"></a><tt class="py-lineno"> 125</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L126"></a><tt class="py-lineno"> 126</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks prefixlen property assignments for validity based</tt> </tt> -<a name="L127"></a><tt class="py-lineno"> 127</tt> <tt class="py-line"><tt class="py-docstring"> on address type. Also accepts subnet masks which can easily be converted</tt> </tt> -<a name="L128"></a><tt class="py-lineno"> 128</tt> <tt class="py-line"><tt class="py-docstring"> to the equivalent prefixlen integer.</tt> </tt> -<a name="L129"></a><tt class="py-lineno"> 129</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="PrefixLenDescriptor.__init__"></a><div id="PrefixLenDescriptor.__init__-def"><a name="L130"></a><tt class="py-lineno"> 130</tt> <a class="py-toggle" href="#" id="PrefixLenDescriptor.__init__-toggle" onclick="return toggle('PrefixLenDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.PrefixLenDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">class_id</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="PrefixLenDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="PrefixLenDescriptor.__init__-expanded"><a name="L131"></a><tt class="py-lineno"> 131</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L132"></a><tt class="py-lineno"> 132</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L133"></a><tt class="py-lineno"> 133</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L134"></a><tt class="py-lineno"> 134</tt> <tt class="py-line"><tt class="py-docstring"> @param class_id: (optional) the name of the class that uses this</tt> </tt> -<a name="L135"></a><tt class="py-lineno"> 135</tt> <tt class="py-line"><tt class="py-docstring"> descriptor.</tt> </tt> -<a name="L136"></a><tt class="py-lineno"> 136</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L137"></a><tt class="py-lineno"> 137</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">class_id</tt> <tt class="py-op">=</tt> <tt class="py-name">class_id</tt> </tt> -</div><a name="L138"></a><tt class="py-lineno"> 138</tt> <tt class="py-line"> </tt> -<a name="PrefixLenDescriptor.__set__"></a><div id="PrefixLenDescriptor.__set__-def"><a name="L139"></a><tt class="py-lineno"> 139</tt> <a class="py-toggle" href="#" id="PrefixLenDescriptor.__set__-toggle" onclick="return toggle('PrefixLenDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.PrefixLenDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="PrefixLenDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="PrefixLenDescriptor.__set__-expanded"><a name="L140"></a><tt class="py-lineno"> 140</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L141"></a><tt class="py-lineno"> 141</tt> <tt class="py-line"> <tt class="py-comment"># Basic integer subnet prefix.</tt> </tt> -<a name="L142"></a><tt class="py-lineno"> 142</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-69" class="py-name" targets="Variable netaddr.address.CIDR.prefixlen=netaddr.address.CIDR-class.html#prefixlen,Variable netaddr.address.IP.prefixlen=netaddr.address.IP-class.html#prefixlen"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-69', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-70" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-70', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L143"></a><tt class="py-lineno"> 143</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L144"></a><tt class="py-lineno"> 144</tt> <tt class="py-line"> <tt class="py-comment"># Convert possible subnet mask to integer subnet prefix.</tt> </tt> -<a name="L145"></a><tt class="py-lineno"> 145</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">ip</tt> <tt class="py-op">=</tt> <tt id="link-71" class="py-name" targets="Class netaddr.address.IP=netaddr.address.IP-class.html"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-71', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt id="link-72" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-72', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L146"></a><tt class="py-lineno"> 146</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-73" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-73', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">ip</tt><tt class="py-op">.</tt><tt id="link-74" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-74', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-58', 'str_to_int', 'link-58');">str_to_int</a></tt><tt class="py-op">(</tt><tt id="link-59" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-59', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-60" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-60', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-61" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-61', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-62" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_int()=netaddr.strategy.AddrStrategy-class.html#valid_int"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-62', 'valid_int', 'link-62');">valid_int</a></tt><tt class="py-op">(</tt><tt id="link-63" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-63', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">OverflowError</tt><tt class="py-op">(</tt><tt class="py-string">'value %r cannot be represented '</tt> \ </tt> +<a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"> <tt class="py-string">'in %d bit(s)!'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-64" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-64', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-65" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-65', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is an unsupported type!'</tt> <tt class="py-op">%</tt> <tt id="link-66" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-66', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"> </tt> +<a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-67" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-67', 'value', 'link-30');">value</a></tt> </tt> +</div></div><a name="L100"></a><tt class="py-lineno"> 100</tt> <tt class="py-line"> </tt> +<a name="L101"></a><tt class="py-lineno"> 101</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="StrategyDescriptor"></a><div id="StrategyDescriptor-def"><a name="L102"></a><tt class="py-lineno"> 102</tt> <a class="py-toggle" href="#" id="StrategyDescriptor-toggle" onclick="return toggle('StrategyDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.StrategyDescriptor-class.html">StrategyDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="StrategyDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="StrategyDescriptor-expanded"><a name="L103"></a><tt class="py-lineno"> 103</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L104"></a><tt class="py-lineno"> 104</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks strategy property assignments for validity and</tt> </tt> +<a name="L105"></a><tt class="py-lineno"> 105</tt> <tt class="py-line"><tt class="py-docstring"> also keeps the addr_type property in sync with any changes made.</tt> </tt> +<a name="L106"></a><tt class="py-lineno"> 106</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="StrategyDescriptor.__init__"></a><div id="StrategyDescriptor.__init__-def"><a name="L107"></a><tt class="py-lineno"> 107</tt> <a class="py-toggle" href="#" id="StrategyDescriptor.__init__-toggle" onclick="return toggle('StrategyDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.StrategyDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">strategies</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="StrategyDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="StrategyDescriptor.__init__-expanded"><a name="L108"></a><tt class="py-lineno"> 108</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L109"></a><tt class="py-lineno"> 109</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L110"></a><tt class="py-lineno"> 110</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L111"></a><tt class="py-lineno"> 111</tt> <tt class="py-line"><tt class="py-docstring"> @param strategies: a list of strategy objects that are acceptable for</tt> </tt> +<a name="L112"></a><tt class="py-lineno"> 112</tt> <tt class="py-line"><tt class="py-docstring"> assignment to the strategy property.</tt> </tt> +<a name="L113"></a><tt class="py-lineno"> 113</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L114"></a><tt class="py-lineno"> 114</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">strategies</tt> <tt class="py-op">=</tt> <tt class="py-name">strategies</tt> </tt> +</div><a name="L115"></a><tt class="py-lineno"> 115</tt> <tt class="py-line"> </tt> +<a name="StrategyDescriptor.__set__"></a><div id="StrategyDescriptor.__set__-def"><a name="L116"></a><tt class="py-lineno"> 116</tt> <a class="py-toggle" href="#" id="StrategyDescriptor.__set__-toggle" onclick="return toggle('StrategyDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.StrategyDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="StrategyDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="StrategyDescriptor.__set__-expanded"><a name="L117"></a><tt class="py-lineno"> 117</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-68" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-68', 'value', 'link-30');">value</a></tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">strategies</tt><tt class="py-op">:</tt> </tt> +<a name="L118"></a><tt class="py-lineno"> 118</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">Exception</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a supported strategy!'</tt> <tt class="py-op">%</tt> <tt id="link-69" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-69', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L119"></a><tt class="py-lineno"> 119</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'strategy'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-70" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-70', 'value', 'link-30');">value</a></tt> </tt> +<a name="L120"></a><tt class="py-lineno"> 120</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'addr_type'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-71" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-71', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-72" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-72', 'addr_type', 'link-43');">addr_type</a></tt> </tt> +</div></div><a name="L121"></a><tt class="py-lineno"> 121</tt> <tt class="py-line"> </tt> +<a name="L122"></a><tt class="py-lineno"> 122</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="PrefixLenDescriptor"></a><div id="PrefixLenDescriptor-def"><a name="L123"></a><tt class="py-lineno"> 123</tt> <a class="py-toggle" href="#" id="PrefixLenDescriptor-toggle" onclick="return toggle('PrefixLenDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.PrefixLenDescriptor-class.html">PrefixLenDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="PrefixLenDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="PrefixLenDescriptor-expanded"><a name="L124"></a><tt class="py-lineno"> 124</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L125"></a><tt class="py-lineno"> 125</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks prefixlen property assignments for validity based</tt> </tt> +<a name="L126"></a><tt class="py-lineno"> 126</tt> <tt class="py-line"><tt class="py-docstring"> on address type. Also accepts netmasks and hostmasks which can easily be</tt> </tt> +<a name="L127"></a><tt class="py-lineno"> 127</tt> <tt class="py-line"><tt class="py-docstring"> converted to the equivalent prefixlen integer.</tt> </tt> +<a name="L128"></a><tt class="py-lineno"> 128</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="PrefixLenDescriptor.__init__"></a><div id="PrefixLenDescriptor.__init__-def"><a name="L129"></a><tt class="py-lineno"> 129</tt> <a class="py-toggle" href="#" id="PrefixLenDescriptor.__init__-toggle" onclick="return toggle('PrefixLenDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.PrefixLenDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">class_id</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="PrefixLenDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="PrefixLenDescriptor.__init__-expanded"><a name="L130"></a><tt class="py-lineno"> 130</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L131"></a><tt class="py-lineno"> 131</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L132"></a><tt class="py-lineno"> 132</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L133"></a><tt class="py-lineno"> 133</tt> <tt class="py-line"><tt class="py-docstring"> @param class_id: (optional) the name of the class that uses this</tt> </tt> +<a name="L134"></a><tt class="py-lineno"> 134</tt> <tt class="py-line"><tt class="py-docstring"> descriptor.</tt> </tt> +<a name="L135"></a><tt class="py-lineno"> 135</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L136"></a><tt class="py-lineno"> 136</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">class_id</tt> <tt class="py-op">=</tt> <tt class="py-name">class_id</tt> </tt> +</div><a name="L137"></a><tt class="py-lineno"> 137</tt> <tt class="py-line"> </tt> +<a name="PrefixLenDescriptor.__set__"></a><div id="PrefixLenDescriptor.__set__-def"><a name="L138"></a><tt class="py-lineno"> 138</tt> <a class="py-toggle" href="#" id="PrefixLenDescriptor.__set__-toggle" onclick="return toggle('PrefixLenDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.PrefixLenDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="PrefixLenDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="PrefixLenDescriptor.__set__-expanded"><a name="L139"></a><tt class="py-lineno"> 139</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L140"></a><tt class="py-lineno"> 140</tt> <tt class="py-line"> <tt class="py-comment"># Basic integer subnet prefix.</tt> </tt> +<a name="L141"></a><tt class="py-lineno"> 141</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-73" class="py-name" targets="Variable netaddr.address.CIDR.prefixlen=netaddr.address.CIDR-class.html#prefixlen,Variable netaddr.address.IP.prefixlen=netaddr.address.IP-class.html#prefixlen"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-73', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-74" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-74', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L142"></a><tt class="py-lineno"> 142</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L143"></a><tt class="py-lineno"> 143</tt> <tt class="py-line"> <tt class="py-comment"># Convert possible subnet mask to integer subnet prefix.</tt> </tt> +<a name="L144"></a><tt class="py-lineno"> 144</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-75" class="py-name" targets="Package netaddr.ip=netaddr.ip-module.html"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-75', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">=</tt> <tt id="link-76" class="py-name" targets="Class netaddr.address.IP=netaddr.address.IP-class.html"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-76', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt id="link-77" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-77', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L145"></a><tt class="py-lineno"> 145</tt> <tt class="py-line"> </tt> +<a name="L146"></a><tt class="py-lineno"> 146</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-78" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-78', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt id="link-79" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-79', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-80" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-80', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> <a name="L147"></a><tt class="py-lineno"> 147</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'address and netmask type mismatch!'</tt><tt class="py-op">)</tt> </tt> -<a name="L148"></a><tt class="py-lineno"> 148</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">ip</tt><tt class="py-op">.</tt><tt id="link-75" class="py-name" targets="Method netaddr.address.IP.is_netmask()=netaddr.address.IP-class.html#is_netmask"><a title="netaddr.address.IP.is_netmask" class="py-name" href="#" onclick="return doclink('link-75', 'is_netmask', 'link-75');">is_netmask</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L149"></a><tt class="py-lineno"> 149</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%s is not a valid netmask!'</tt> <tt class="py-op">%</tt> <tt class="py-name">ip</tt><tt class="py-op">)</tt> </tt> -<a name="L150"></a><tt class="py-lineno"> 150</tt> <tt class="py-line"> <tt id="link-76" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-76', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">ip</tt><tt class="py-op">.</tt><tt id="link-77" class="py-name" targets="Method netaddr.address.IP.netmask_bits()=netaddr.address.IP-class.html#netmask_bits"><a title="netaddr.address.IP.netmask_bits" class="py-name" href="#" onclick="return doclink('link-77', 'netmask_bits', 'link-77');">netmask_bits</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L151"></a><tt class="py-lineno"> 151</tt> <tt class="py-line"> </tt> -<a name="L152"></a><tt class="py-lineno"> 152</tt> <tt class="py-line"> <tt class="py-comment"># Validate subnet prefix.</tt> </tt> -<a name="L153"></a><tt class="py-lineno"> 153</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt id="link-78" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-78', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-79" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-79', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> -<a name="L154"></a><tt class="py-lineno"> 154</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%d is an invalid prefix for an %s CIDR!'</tt> \ </tt> -<a name="L155"></a><tt class="py-lineno"> 155</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-80" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-80', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">,</tt> <tt id="link-81" class="py-name"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-81', 'AT_NAMES', 'link-8');">AT_NAMES</a></tt><tt class="py-op">[</tt><tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-82" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-82', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L156"></a><tt class="py-lineno"> 156</tt> <tt class="py-line"> </tt> -<a name="L157"></a><tt class="py-lineno"> 157</tt> <tt class="py-line"> <tt class="py-comment"># Make sure instance is not a subnet mask trying to set a prefix!</tt> </tt> -<a name="L158"></a><tt class="py-lineno"> 158</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">instance</tt><tt class="py-op">,</tt> <tt id="link-83" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-83', 'IP', 'link-71');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L159"></a><tt class="py-lineno"> 159</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-84" class="py-name"><a title="netaddr.address.IP.is_netmask" class="py-name" href="#" onclick="return doclink('link-84', 'is_netmask', 'link-75');">is_netmask</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-85" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-85', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-86" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-86', 'AT_INET', 'link-4');">AT_INET</a></tt> \ </tt> -<a name="L160"></a><tt class="py-lineno"> 160</tt> <tt class="py-line"> <tt class="py-keyword">and</tt> <tt id="link-87" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-87', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">!=</tt> <tt class="py-number">32</tt><tt class="py-op">:</tt> </tt> -<a name="L161"></a><tt class="py-lineno"> 161</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'IPv4 netmasks must have a prefix of /32!'</tt><tt class="py-op">)</tt> </tt> -<a name="L162"></a><tt class="py-lineno"> 162</tt> <tt class="py-line"> </tt> -<a name="L163"></a><tt class="py-lineno"> 163</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'prefixlen'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-88" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-88', 'prefixlen', 'link-69');">prefixlen</a></tt> </tt> -<a name="L164"></a><tt class="py-lineno"> 164</tt> <tt class="py-line"> </tt> -<a name="L165"></a><tt class="py-lineno"> 165</tt> <tt class="py-line"> <tt class="py-comment"># Don't run this on a CIDR that is initialising itself.</tt> </tt> -<a name="L166"></a><tt class="py-lineno"> 166</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">class_id</tt> <tt class="py-op">==</tt> <tt class="py-string">'CIDR'</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'first'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">:</tt> </tt> -<a name="L167"></a><tt class="py-lineno"> 167</tt> <tt class="py-line"> <tt id="link-89" class="py-name" targets="Variable netaddr.address.AddrRange.first=netaddr.address.AddrRange-class.html#first"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-89', 'first', 'link-89');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'first'</tt><tt class="py-op">]</tt> </tt> -<a name="L168"></a><tt class="py-lineno"> 168</tt> <tt class="py-line"> <tt id="link-90" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-90', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'strategy'</tt><tt class="py-op">]</tt> </tt> -<a name="L169"></a><tt class="py-lineno"> 169</tt> <tt class="py-line"> <tt id="link-91" class="py-name" targets="Method netaddr.address.CIDR.hostmask()=netaddr.address.CIDR-class.html#hostmask"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-91', 'hostmask', 'link-91');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt id="link-92" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-92', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt id="link-93" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-93', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> -<a name="L170"></a><tt class="py-lineno"> 170</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'first'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-94" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-94', 'first', 'link-89');">first</a></tt> <tt class="py-op">|</tt> <tt id="link-95" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-95', 'hostmask', 'link-91');">hostmask</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-96" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-96', 'hostmask', 'link-91');">hostmask</a></tt> </tt> -<a name="L171"></a><tt class="py-lineno"> 171</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'last'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-97" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-97', 'first', 'link-89');">first</a></tt> <tt class="py-op">|</tt> <tt id="link-98" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-98', 'hostmask', 'link-91');">hostmask</a></tt> </tt> -</div></div><a name="L172"></a><tt class="py-lineno"> 172</tt> <tt class="py-line"> </tt> -<a name="L173"></a><tt class="py-lineno"> 173</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="KlassDescriptor"></a><div id="KlassDescriptor-def"><a name="L174"></a><tt class="py-lineno"> 174</tt> <a class="py-toggle" href="#" id="KlassDescriptor-toggle" onclick="return toggle('KlassDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.KlassDescriptor-class.html">KlassDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="KlassDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="KlassDescriptor-expanded"><a name="L175"></a><tt class="py-lineno"> 175</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L176"></a><tt class="py-lineno"> 176</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks klass (data flavour) property assignments for</tt> </tt> -<a name="L177"></a><tt class="py-lineno"> 177</tt> <tt class="py-line"><tt class="py-docstring"> validity.</tt> </tt> -<a name="L178"></a><tt class="py-lineno"> 178</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="KlassDescriptor.__init__"></a><div id="KlassDescriptor.__init__-def"><a name="L179"></a><tt class="py-lineno"> 179</tt> <a class="py-toggle" href="#" id="KlassDescriptor.__init__-toggle" onclick="return toggle('KlassDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.KlassDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">default_klass</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="KlassDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="KlassDescriptor.__init__-expanded"><a name="L180"></a><tt class="py-lineno"> 180</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L181"></a><tt class="py-lineno"> 181</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L182"></a><tt class="py-lineno"> 182</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L183"></a><tt class="py-lineno"> 183</tt> <tt class="py-line"><tt class="py-docstring"> @param default_klass: the default class to use if klass property is</tt> </tt> -<a name="L184"></a><tt class="py-lineno"> 184</tt> <tt class="py-line"><tt class="py-docstring"> set to None.</tt> </tt> -<a name="L185"></a><tt class="py-lineno"> 185</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L186"></a><tt class="py-lineno"> 186</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_klass</tt> <tt class="py-op">=</tt> <tt class="py-name">default_klass</tt> </tt> -</div><a name="L187"></a><tt class="py-lineno"> 187</tt> <tt class="py-line"> </tt> -<a name="KlassDescriptor.__set__"></a><div id="KlassDescriptor.__set__-def"><a name="L188"></a><tt class="py-lineno"> 188</tt> <a class="py-toggle" href="#" id="KlassDescriptor.__set__-toggle" onclick="return toggle('KlassDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.KlassDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="KlassDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="KlassDescriptor.__set__-expanded"><a name="L189"></a><tt class="py-lineno"> 189</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-99" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-99', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">type</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L190"></a><tt class="py-lineno"> 190</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-100" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-100', 'value', 'link-26');">value</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L191"></a><tt class="py-lineno"> 191</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L192"></a><tt class="py-lineno"> 192</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt id="link-101" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-101', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt id="link-102" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-102', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L193"></a><tt class="py-lineno"> 193</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L194"></a><tt class="py-lineno"> 194</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L195"></a><tt class="py-lineno"> 195</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">"%r is an unsupported klass type!"</tt> <tt class="py-op">%</tt> <tt id="link-103" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-103', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L196"></a><tt class="py-lineno"> 196</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-104" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-104', 'value', 'link-26');">value</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">hex</tt><tt class="py-op">:</tt> </tt> -<a name="L197"></a><tt class="py-lineno"> 197</tt> <tt class="py-line"> <tt class="py-comment"># hex() is a BIF, not a type, so do a separate check for it.</tt> </tt> -<a name="L198"></a><tt class="py-lineno"> 198</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">pass</tt> </tt> -<a name="L199"></a><tt class="py-lineno"> 199</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-105" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-105', 'value', 'link-26');">value</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L200"></a><tt class="py-lineno"> 200</tt> <tt class="py-line"> <tt class="py-comment"># Use default class in None is specified.</tt> </tt> -<a name="L201"></a><tt class="py-lineno"> 201</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-106" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-106', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default_klass</tt> </tt> -<a name="L202"></a><tt class="py-lineno"> 202</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L203"></a><tt class="py-lineno"> 203</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">"%r is not a supported type, BIF or class!"</tt> \ </tt> -<a name="L204"></a><tt class="py-lineno"> 204</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt id="link-107" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-107', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L205"></a><tt class="py-lineno"> 205</tt> <tt class="py-line"> </tt> -<a name="L206"></a><tt class="py-lineno"> 206</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'klass'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-108" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-108', 'value', 'link-26');">value</a></tt> </tt> -</div></div><a name="L207"></a><tt class="py-lineno"> 207</tt> <tt class="py-line"> </tt> -<a name="L208"></a><tt class="py-lineno"> 208</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L209"></a><tt class="py-lineno"> 209</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Address classes.</tt> </tt> -<a name="L210"></a><tt class="py-lineno"> 210</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L211"></a><tt class="py-lineno"> 211</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="Addr"></a><div id="Addr-def"><a name="L212"></a><tt class="py-lineno"> 212</tt> <a class="py-toggle" href="#" id="Addr-toggle" onclick="return toggle('Addr');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html">Addr</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Addr-expanded"><a name="L213"></a><tt class="py-lineno"> 213</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L214"></a><tt class="py-lineno"> 214</tt> <tt class="py-line"><tt class="py-docstring"> The base class containing common functionality for all subclasses</tt> </tt> -<a name="L215"></a><tt class="py-lineno"> 215</tt> <tt class="py-line"><tt class="py-docstring"> representing various network address types.</tt> </tt> -<a name="L216"></a><tt class="py-lineno"> 216</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L217"></a><tt class="py-lineno"> 217</tt> <tt class="py-line"><tt class="py-docstring"> It is a fully functioning class (as opposed to a virtual class) with a</tt> </tt> -<a name="L218"></a><tt class="py-lineno"> 218</tt> <tt class="py-line"><tt class="py-docstring"> heuristic constructor that detects the type of address via the first</tt> </tt> -<a name="L219"></a><tt class="py-lineno"> 219</tt> <tt class="py-line"><tt class="py-docstring"> argument if it is a string and sets itself up accordingly. If the first</tt> </tt> -<a name="L220"></a><tt class="py-lineno"> 220</tt> <tt class="py-line"><tt class="py-docstring"> argument is an integer, then a constant must be provided via the second</tt> </tt> -<a name="L221"></a><tt class="py-lineno"> 221</tt> <tt class="py-line"><tt class="py-docstring"> argument indicating the address type explicitly.</tt> </tt> -<a name="L222"></a><tt class="py-lineno"> 222</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L223"></a><tt class="py-lineno"> 223</tt> <tt class="py-line"><tt class="py-docstring"> Objects of this class behave differently dependent upon the type of address</tt> </tt> -<a name="L224"></a><tt class="py-lineno"> 224</tt> <tt class="py-line"><tt class="py-docstring"> they represent.</tt> </tt> -<a name="L225"></a><tt class="py-lineno"> 225</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L226"></a><tt class="py-lineno"> 226</tt> <tt class="py-line"> <tt id="link-109" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +<a name="L148"></a><tt class="py-lineno"> 148</tt> <tt class="py-line"> </tt> +<a name="L149"></a><tt class="py-lineno"> 149</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-81" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-81', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-82" class="py-name" targets="Method netaddr.address.IP.is_netmask()=netaddr.address.IP-class.html#is_netmask"><a title="netaddr.address.IP.is_netmask" class="py-name" href="#" onclick="return doclink('link-82', 'is_netmask', 'link-82');">is_netmask</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L150"></a><tt class="py-lineno"> 150</tt> <tt class="py-line"> <tt class="py-comment"># prefixlen is a netmask address.</tt> </tt> +<a name="L151"></a><tt class="py-lineno"> 151</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-83" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-83', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-84" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-84', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-85" class="py-name" targets="Method netaddr.address.IP.netmask_bits()=netaddr.address.IP-class.html#netmask_bits"><a title="netaddr.address.IP.netmask_bits" class="py-name" href="#" onclick="return doclink('link-85', 'netmask_bits', 'link-85');">netmask_bits</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L152"></a><tt class="py-lineno"> 152</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-86" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-86', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-87" class="py-name" targets="Method netaddr.address.IP.is_hostmask()=netaddr.address.IP-class.html#is_hostmask"><a title="netaddr.address.IP.is_hostmask" class="py-name" href="#" onclick="return doclink('link-87', 'is_hostmask', 'link-87');">is_hostmask</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L153"></a><tt class="py-lineno"> 153</tt> <tt class="py-line"> <tt class="py-comment"># prefixlen is an ACL (hostmask) address.</tt> </tt> +<a name="L154"></a><tt class="py-lineno"> 154</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-88" class="py-name" targets="Variable netaddr.address.CIDR.netmask=netaddr.address.CIDR-class.html#netmask"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-88', 'netmask', 'link-88');">netmask</a></tt> <tt class="py-op">=</tt> <tt id="link-89" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-89', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt id="link-90" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-90', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-91" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-91', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">^</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-92" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-92', 'ip', 'link-75');">ip</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt id="link-93" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-93', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-94" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-94', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L155"></a><tt class="py-lineno"> 155</tt> <tt class="py-line"> <tt id="link-95" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-95', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-96" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-96', 'netmask', 'link-88');">netmask</a></tt><tt class="py-op">.</tt><tt id="link-97" class="py-name"><a title="netaddr.address.IP.netmask_bits" class="py-name" href="#" onclick="return doclink('link-97', 'netmask_bits', 'link-85');">netmask_bits</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L156"></a><tt class="py-lineno"> 156</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L157"></a><tt class="py-lineno"> 157</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%s is not a valid netmask/hostmask!'</tt> <tt class="py-op">%</tt> <tt id="link-98" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-98', 'ip', 'link-75');">ip</a></tt><tt class="py-op">)</tt> </tt> +<a name="L158"></a><tt class="py-lineno"> 158</tt> <tt class="py-line"> </tt> +<a name="L159"></a><tt class="py-lineno"> 159</tt> <tt class="py-line"> <tt class="py-comment"># Validate subnet prefix.</tt> </tt> +<a name="L160"></a><tt class="py-lineno"> 160</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt id="link-99" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-99', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-100" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-100', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> +<a name="L161"></a><tt class="py-lineno"> 161</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%d is an invalid prefix for an %s CIDR!'</tt> \ </tt> +<a name="L162"></a><tt class="py-lineno"> 162</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-101" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-101', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">,</tt> <tt id="link-102" class="py-name"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-102', 'AT_NAMES', 'link-8');">AT_NAMES</a></tt><tt class="py-op">[</tt><tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-103" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-103', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L163"></a><tt class="py-lineno"> 163</tt> <tt class="py-line"> </tt> +<a name="L164"></a><tt class="py-lineno"> 164</tt> <tt class="py-line"> <tt class="py-comment"># Make sure instance is not a subnet mask trying to set a prefix!</tt> </tt> +<a name="L165"></a><tt class="py-lineno"> 165</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">instance</tt><tt class="py-op">,</tt> <tt id="link-104" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-104', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L166"></a><tt class="py-lineno"> 166</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-105" class="py-name"><a title="netaddr.address.IP.is_netmask" class="py-name" href="#" onclick="return doclink('link-105', 'is_netmask', 'link-82');">is_netmask</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt id="link-106" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-106', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-107" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-107', 'AT_INET', 'link-4');">AT_INET</a></tt> \ </tt> +<a name="L167"></a><tt class="py-lineno"> 167</tt> <tt class="py-line"> <tt class="py-keyword">and</tt> <tt id="link-108" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-108', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">!=</tt> <tt class="py-number">32</tt><tt class="py-op">:</tt> </tt> +<a name="L168"></a><tt class="py-lineno"> 168</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'IPv4 netmasks must have a prefix of /32!'</tt><tt class="py-op">)</tt> </tt> +<a name="L169"></a><tt class="py-lineno"> 169</tt> <tt class="py-line"> </tt> +<a name="L170"></a><tt class="py-lineno"> 170</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'prefixlen'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-109" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-109', 'prefixlen', 'link-73');">prefixlen</a></tt> </tt> +<a name="L171"></a><tt class="py-lineno"> 171</tt> <tt class="py-line"> </tt> +<a name="L172"></a><tt class="py-lineno"> 172</tt> <tt class="py-line"> <tt class="py-comment"># Don't run this on a CIDR that is initialising itself.</tt> </tt> +<a name="L173"></a><tt class="py-lineno"> 173</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">class_id</tt> <tt class="py-op">==</tt> <tt class="py-string">'CIDR'</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'first'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">:</tt> </tt> +<a name="L174"></a><tt class="py-lineno"> 174</tt> <tt class="py-line"> <tt id="link-110" class="py-name" targets="Variable netaddr.address.IPRange.first=netaddr.address.IPRange-class.html#first"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-110', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'first'</tt><tt class="py-op">]</tt> </tt> +<a name="L175"></a><tt class="py-lineno"> 175</tt> <tt class="py-line"> <tt id="link-111" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-111', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'strategy'</tt><tt class="py-op">]</tt> </tt> +<a name="L176"></a><tt class="py-lineno"> 176</tt> <tt class="py-line"> <tt id="link-112" class="py-name" targets="Variable netaddr.address.CIDR.hostmask=netaddr.address.CIDR-class.html#hostmask"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-112', 'hostmask', 'link-112');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt id="link-113" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-113', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt id="link-114" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-114', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L177"></a><tt class="py-lineno"> 177</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'first'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-115" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-115', 'first', 'link-110');">first</a></tt> <tt class="py-op">|</tt> <tt id="link-116" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-116', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-117" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-117', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +<a name="L178"></a><tt class="py-lineno"> 178</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'last'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-118" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-118', 'first', 'link-110');">first</a></tt> <tt class="py-op">|</tt> <tt id="link-119" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-119', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +</div></div><a name="L179"></a><tt class="py-lineno"> 179</tt> <tt class="py-line"> </tt> +<a name="L180"></a><tt class="py-lineno"> 180</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="FormatDescriptor"></a><div id="FormatDescriptor-def"><a name="L181"></a><tt class="py-lineno"> 181</tt> <a class="py-toggle" href="#" id="FormatDescriptor-toggle" onclick="return toggle('FormatDescriptor');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.FormatDescriptor-class.html">FormatDescriptor</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="FormatDescriptor-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="FormatDescriptor-expanded"><a name="L182"></a><tt class="py-lineno"> 182</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L183"></a><tt class="py-lineno"> 183</tt> <tt class="py-line"><tt class="py-docstring"> A descriptor that checks formatter property assignments for validity.</tt> </tt> +<a name="L184"></a><tt class="py-lineno"> 184</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="FormatDescriptor.__init__"></a><div id="FormatDescriptor.__init__-def"><a name="L185"></a><tt class="py-lineno"> 185</tt> <a class="py-toggle" href="#" id="FormatDescriptor.__init__-toggle" onclick="return toggle('FormatDescriptor.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.FormatDescriptor-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">default</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="FormatDescriptor.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="FormatDescriptor.__init__-expanded"><a name="L186"></a><tt class="py-lineno"> 186</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L187"></a><tt class="py-lineno"> 187</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L188"></a><tt class="py-lineno"> 188</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L189"></a><tt class="py-lineno"> 189</tt> <tt class="py-line"><tt class="py-docstring"> @param default: the default callable to use if the formatter</tt> </tt> +<a name="L190"></a><tt class="py-lineno"> 190</tt> <tt class="py-line"><tt class="py-docstring"> property is None.</tt> </tt> +<a name="L191"></a><tt class="py-lineno"> 191</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L192"></a><tt class="py-lineno"> 192</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default</tt> <tt class="py-op">=</tt> <tt class="py-name">default</tt> </tt> +</div><a name="L193"></a><tt class="py-lineno"> 193</tt> <tt class="py-line"> </tt> +<a name="FormatDescriptor.__set__"></a><div id="FormatDescriptor.__set__-def"><a name="L194"></a><tt class="py-lineno"> 194</tt> <a class="py-toggle" href="#" id="FormatDescriptor.__set__-toggle" onclick="return toggle('FormatDescriptor.__set__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.FormatDescriptor-class.html#__set__">__set__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">instance</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="FormatDescriptor.__set__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="FormatDescriptor.__set__-expanded"><a name="L195"></a><tt class="py-lineno"> 195</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">callable</tt><tt class="py-op">(</tt><tt id="link-120" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-120', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> \ </tt> +<a name="L196"></a><tt class="py-lineno"> 196</tt> <tt class="py-line"> <tt id="link-121" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-121', 'value', 'link-30');">value</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">int</tt><tt class="py-op">,</tt> <tt id="link-122" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-122', 'Addr', 'link-36');">Addr</a></tt><tt class="py-op">,</tt> <tt id="link-123" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-123', 'IP', 'link-76');">IP</a></tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">,</tt> <tt class="py-name">hex</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L197"></a><tt class="py-lineno"> 197</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L198"></a><tt class="py-lineno"> 198</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-124" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-124', 'value', 'link-30');">value</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L199"></a><tt class="py-lineno"> 199</tt> <tt class="py-line"> <tt class="py-comment"># Use default.</tt> </tt> +<a name="L200"></a><tt class="py-lineno"> 200</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-125" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-125', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">default</tt> </tt> +<a name="L201"></a><tt class="py-lineno"> 201</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L202"></a><tt class="py-lineno"> 202</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">"unsupported formatter callable: %r!"</tt> <tt class="py-op">%</tt> <tt id="link-126" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-126', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L203"></a><tt class="py-lineno"> 203</tt> <tt class="py-line"> </tt> +<a name="L204"></a><tt class="py-lineno"> 204</tt> <tt class="py-line"> <tt class="py-name">instance</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'fmt'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-127" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-127', 'value', 'link-30');">value</a></tt> </tt> +</div></div><a name="L205"></a><tt class="py-lineno"> 205</tt> <tt class="py-line"> </tt> +<a name="L206"></a><tt class="py-lineno"> 206</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="Addr"></a><div id="Addr-def"><a name="L207"></a><tt class="py-lineno"> 207</tt> <a class="py-toggle" href="#" id="Addr-toggle" onclick="return toggle('Addr');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html">Addr</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Addr-expanded"><a name="L208"></a><tt class="py-lineno"> 208</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L209"></a><tt class="py-lineno"> 209</tt> <tt class="py-line"><tt class="py-docstring"> The base class containing common functionality for all subclasses</tt> </tt> +<a name="L210"></a><tt class="py-lineno"> 210</tt> <tt class="py-line"><tt class="py-docstring"> representing various network address types.</tt> </tt> +<a name="L211"></a><tt class="py-lineno"> 211</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L212"></a><tt class="py-lineno"> 212</tt> <tt class="py-line"><tt class="py-docstring"> It is a fully functioning class (as opposed to a virtual class) with a</tt> </tt> +<a name="L213"></a><tt class="py-lineno"> 213</tt> <tt class="py-line"><tt class="py-docstring"> heuristic constructor that detects the type of address via the first</tt> </tt> +<a name="L214"></a><tt class="py-lineno"> 214</tt> <tt class="py-line"><tt class="py-docstring"> argument if it is a string and sets itself up accordingly. If the first</tt> </tt> +<a name="L215"></a><tt class="py-lineno"> 215</tt> <tt class="py-line"><tt class="py-docstring"> argument is an integer, then a constant must be provided via the second</tt> </tt> +<a name="L216"></a><tt class="py-lineno"> 216</tt> <tt class="py-line"><tt class="py-docstring"> argument indicating the address type explicitly.</tt> </tt> +<a name="L217"></a><tt class="py-lineno"> 217</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L218"></a><tt class="py-lineno"> 218</tt> <tt class="py-line"><tt class="py-docstring"> Objects of this class behave differently dependent upon the type of address</tt> </tt> +<a name="L219"></a><tt class="py-lineno"> 219</tt> <tt class="py-line"><tt class="py-docstring"> they represent.</tt> </tt> +<a name="L220"></a><tt class="py-lineno"> 220</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L221"></a><tt class="py-lineno"> 221</tt> <tt class="py-line"> <tt id="link-128" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-109', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-110" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-110', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-111" class="py-name"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-111', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">,</tt> <tt id="link-112" class="py-name"><a title="netaddr.ST_EUI48 -netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-112', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">,</tt> <tt id="link-113" class="py-name"><a title="netaddr.ST_EUI64 -netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-113', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">)</tt> </tt> -<a name="L227"></a><tt class="py-lineno"> 227</tt> <tt class="py-line"> <tt id="link-114" class="py-name" targets="Variable netaddr.address.Addr.ADDR_TYPES=netaddr.address.Addr-class.html#ADDR_TYPES,Variable netaddr.address.AddrRange.ADDR_TYPES=netaddr.address.AddrRange-class.html#ADDR_TYPES,Variable netaddr.address.CIDR.ADDR_TYPES=netaddr.address.CIDR-class.html#ADDR_TYPES,Variable netaddr.address.EUI.ADDR_TYPES=netaddr.address.EUI-class.html#ADDR_TYPES,Variable netaddr.address.IP.ADDR_TYPES=netaddr.address.IP-class.html#ADDR_TYPES,Variable netaddr.address.Wildcard.ADDR_TYPES=netaddr.address.Wildcard-class.html#ADDR_TYPES"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-128', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-129" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-129', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-130" class="py-name"><a title="netaddr.ST_IPV6 +netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-130', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">,</tt> <tt id="link-131" class="py-name"><a title="netaddr.ST_EUI48 +netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-131', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">,</tt> <tt id="link-132" class="py-name"><a title="netaddr.ST_EUI64 +netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-132', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">)</tt> </tt> +<a name="L222"></a><tt class="py-lineno"> 222</tt> <tt class="py-line"> <tt id="link-133" class="py-name" targets="Variable netaddr.address.Addr.ADDR_TYPES=netaddr.address.Addr-class.html#ADDR_TYPES,Variable netaddr.address.CIDR.ADDR_TYPES=netaddr.address.CIDR-class.html#ADDR_TYPES,Variable netaddr.address.EUI.ADDR_TYPES=netaddr.address.EUI-class.html#ADDR_TYPES,Variable netaddr.address.IP.ADDR_TYPES=netaddr.address.IP-class.html#ADDR_TYPES,Variable netaddr.address.IPRange.ADDR_TYPES=netaddr.address.IPRange-class.html#ADDR_TYPES,Variable netaddr.address.Wildcard.ADDR_TYPES=netaddr.address.Wildcard-class.html#ADDR_TYPES"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-114', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-115" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-115', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-116" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-116', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-117" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-117', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">,</tt> <tt id="link-118" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-118', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-119" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-119', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt><tt class="py-op">)</tt> </tt> -<a name="L228"></a><tt class="py-lineno"> 228</tt> <tt class="py-line"> </tt> -<a name="L229"></a><tt class="py-lineno"> 229</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> -<a name="L230"></a><tt class="py-lineno"> 230</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-120" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-120', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt id="link-121" class="py-name" targets="Class netaddr.address.AddrValueDescriptor=netaddr.address.AddrValueDescriptor-class.html"><a title="netaddr.address.AddrValueDescriptor" class="py-name" href="#" onclick="return doclink('link-121', 'AddrValueDescriptor', 'link-121');">AddrValueDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'value'</tt><tt class="py-op">)</tt> </tt> -<a name="L231"></a><tt class="py-lineno"> 231</tt> <tt class="py-line"> <tt id="link-122" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-133', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-134" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-134', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-135" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-135', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-136" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-136', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">,</tt> <tt id="link-137" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-137', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-138" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-138', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt><tt class="py-op">)</tt> </tt> +<a name="L223"></a><tt class="py-lineno"> 223</tt> <tt class="py-line"> </tt> +<a name="L224"></a><tt class="py-lineno"> 224</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> +<a name="L225"></a><tt class="py-lineno"> 225</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-139" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-139', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt id="link-140" class="py-name" targets="Class netaddr.address.AddrValueDescriptor=netaddr.address.AddrValueDescriptor-class.html"><a title="netaddr.address.AddrValueDescriptor" class="py-name" href="#" onclick="return doclink('link-140', 'AddrValueDescriptor', 'link-140');">AddrValueDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'value'</tt><tt class="py-op">)</tt> </tt> +<a name="L226"></a><tt class="py-lineno"> 226</tt> <tt class="py-line"> <tt id="link-141" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-122', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-123" class="py-name" targets="Class netaddr.address.StrategyDescriptor=netaddr.address.StrategyDescriptor-class.html"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-123', 'StrategyDescriptor', 'link-123');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-124" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-141', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-142" class="py-name" targets="Class netaddr.address.StrategyDescriptor=netaddr.address.StrategyDescriptor-class.html"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-142', 'StrategyDescriptor', 'link-142');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-143" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-124', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L232"></a><tt class="py-lineno"> 232</tt> <tt class="py-line"> <tt id="link-125" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-143', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L227"></a><tt class="py-lineno"> 227</tt> <tt class="py-line"> <tt id="link-144" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-125', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-126" class="py-name" targets="Class netaddr.address.AddrTypeDescriptor=netaddr.address.AddrTypeDescriptor-class.html"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-126', 'AddrTypeDescriptor', 'link-126');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-127" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-144', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-145" class="py-name" targets="Class netaddr.address.AddrTypeDescriptor=netaddr.address.AddrTypeDescriptor-class.html"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-145', 'AddrTypeDescriptor', 'link-145');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-146" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-127', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L233"></a><tt class="py-lineno"> 233</tt> <tt class="py-line"> </tt> -<a name="Addr.__init__"></a><div id="Addr.__init__-def"><a name="L234"></a><tt class="py-lineno"> 234</tt> <a class="py-toggle" href="#" id="Addr.__init__-toggle" onclick="return toggle('Addr.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">,</tt> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-128" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-128', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__init__-expanded"><a name="L235"></a><tt class="py-lineno"> 235</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L236"></a><tt class="py-lineno"> 236</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L237"></a><tt class="py-lineno"> 237</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L238"></a><tt class="py-lineno"> 238</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: the string form of a network address, or a network byte</tt> </tt> -<a name="L239"></a><tt class="py-lineno"> 239</tt> <tt class="py-line"><tt class="py-docstring"> order integer within the supported range for the address type.</tt> </tt> -<a name="L240"></a><tt class="py-lineno"> 240</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L241"></a><tt class="py-lineno"> 241</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_type: (optional) the network address type. If addr is an</tt> </tt> -<a name="L242"></a><tt class="py-lineno"> 242</tt> <tt class="py-line"><tt class="py-docstring"> integer, this argument becomes mandatory.</tt> </tt> -<a name="L243"></a><tt class="py-lineno"> 243</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L244"></a><tt class="py-lineno"> 244</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-129" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-146', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L228"></a><tt class="py-lineno"> 228</tt> <tt class="py-line"> </tt> +<a name="Addr.__init__"></a><div id="Addr.__init__-def"><a name="L229"></a><tt class="py-lineno"> 229</tt> <a class="py-toggle" href="#" id="Addr.__init__-toggle" onclick="return toggle('Addr.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">,</tt> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-147" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-147', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__init__-expanded"><a name="L230"></a><tt class="py-lineno"> 230</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L231"></a><tt class="py-lineno"> 231</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L232"></a><tt class="py-lineno"> 232</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L233"></a><tt class="py-lineno"> 233</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: the string form of a network address, or a network byte</tt> </tt> +<a name="L234"></a><tt class="py-lineno"> 234</tt> <tt class="py-line"><tt class="py-docstring"> order integer within the supported range for the address type.</tt> </tt> +<a name="L235"></a><tt class="py-lineno"> 235</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L236"></a><tt class="py-lineno"> 236</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_type: (optional) the network address type. If addr is an</tt> </tt> +<a name="L237"></a><tt class="py-lineno"> 237</tt> <tt class="py-line"><tt class="py-docstring"> integer, this argument becomes mandatory.</tt> </tt> +<a name="L238"></a><tt class="py-lineno"> 238</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L239"></a><tt class="py-lineno"> 239</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-148" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-129', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-130" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-148', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-149" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-130', 'addr_type', 'link-39');">addr_type</a></tt> </tt> -<a name="L245"></a><tt class="py-lineno"> 245</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-131" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-131', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt> </tt> -</div><a name="L246"></a><tt class="py-lineno"> 246</tt> <tt class="py-line"> </tt> -<a name="Addr.__hash__"></a><div id="Addr.__hash__-def"><a name="L247"></a><tt class="py-lineno"> 247</tt> <a class="py-toggle" href="#" id="Addr.__hash__-toggle" onclick="return toggle('Addr.__hash__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__hash__">__hash__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__hash__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__hash__-expanded"><a name="L248"></a><tt class="py-lineno"> 248</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L249"></a><tt class="py-lineno"> 249</tt> <tt class="py-line"><tt class="py-docstring"> @return: The hash of this address. Allows it to be used in sets and</tt> </tt> -<a name="L250"></a><tt class="py-lineno"> 250</tt> <tt class="py-line"><tt class="py-docstring"> as a key in dictionaries.</tt> </tt> -<a name="L251"></a><tt class="py-lineno"> 251</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L252"></a><tt class="py-lineno"> 252</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hash</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-132" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-132', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-133" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-149', 'addr_type', 'link-43');">addr_type</a></tt> </tt> +<a name="L240"></a><tt class="py-lineno"> 240</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-150" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-150', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt> </tt> +</div><a name="L241"></a><tt class="py-lineno"> 241</tt> <tt class="py-line"> </tt> +<a name="Addr.__hash__"></a><div id="Addr.__hash__-def"><a name="L242"></a><tt class="py-lineno"> 242</tt> <a class="py-toggle" href="#" id="Addr.__hash__-toggle" onclick="return toggle('Addr.__hash__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__hash__">__hash__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__hash__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__hash__-expanded"><a name="L243"></a><tt class="py-lineno"> 243</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: hash of this address suitable for dict keys, sets etc"""</tt> </tt> +<a name="L244"></a><tt class="py-lineno"> 244</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hash</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-151" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-151', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-152" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-133', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-152', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L245"></a><tt class="py-lineno"> 245</tt> <tt class="py-line"> </tt> +<a name="Addr.__int__"></a><div id="Addr.__int__-def"><a name="L246"></a><tt class="py-lineno"> 246</tt> <a class="py-toggle" href="#" id="Addr.__int__-toggle" onclick="return toggle('Addr.__int__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__int__">__int__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__int__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__int__-expanded"><a name="L247"></a><tt class="py-lineno"> 247</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: value of this address as a network byte order integer"""</tt> </tt> +<a name="L248"></a><tt class="py-lineno"> 248</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-153" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-153', 'value', 'link-30');">value</a></tt> </tt> +</div><a name="L249"></a><tt class="py-lineno"> 249</tt> <tt class="py-line"> </tt> +<a name="Addr.__long__"></a><div id="Addr.__long__-def"><a name="L250"></a><tt class="py-lineno"> 250</tt> <a class="py-toggle" href="#" id="Addr.__long__-toggle" onclick="return toggle('Addr.__long__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__long__">__long__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__long__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__long__-expanded"><a name="L251"></a><tt class="py-lineno"> 251</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: value of this address as a network byte order integer"""</tt> </tt> +<a name="L252"></a><tt class="py-lineno"> 252</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-154" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-154', 'value', 'link-30');">value</a></tt> </tt> </div><a name="L253"></a><tt class="py-lineno"> 253</tt> <tt class="py-line"> </tt> -<a name="Addr.__int__"></a><div id="Addr.__int__-def"><a name="L254"></a><tt class="py-lineno"> 254</tt> <a class="py-toggle" href="#" id="Addr.__int__-toggle" onclick="return toggle('Addr.__int__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__int__">__int__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__int__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__int__-expanded"><a name="L255"></a><tt class="py-lineno"> 255</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L256"></a><tt class="py-lineno"> 256</tt> <tt class="py-line"><tt class="py-docstring"> @return: The value of this address as an network byte order integer.</tt> </tt> -<a name="L257"></a><tt class="py-lineno"> 257</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L258"></a><tt class="py-lineno"> 258</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-134" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-134', 'value', 'link-26');">value</a></tt> </tt> -</div><a name="L259"></a><tt class="py-lineno"> 259</tt> <tt class="py-line"> </tt> -<a name="Addr.__long__"></a><div id="Addr.__long__-def"><a name="L260"></a><tt class="py-lineno"> 260</tt> <a class="py-toggle" href="#" id="Addr.__long__-toggle" onclick="return toggle('Addr.__long__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__long__">__long__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__long__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__long__-expanded"><a name="L261"></a><tt class="py-lineno"> 261</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L262"></a><tt class="py-lineno"> 262</tt> <tt class="py-line"><tt class="py-docstring"> @return: The value of this address as an network byte order integer.</tt> </tt> -<a name="L263"></a><tt class="py-lineno"> 263</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L264"></a><tt class="py-lineno"> 264</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-135" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-135', 'value', 'link-26');">value</a></tt> </tt> -</div><a name="L265"></a><tt class="py-lineno"> 265</tt> <tt class="py-line"> </tt> -<a name="Addr.__str__"></a><div id="Addr.__str__-def"><a name="L266"></a><tt class="py-lineno"> 266</tt> <a class="py-toggle" href="#" id="Addr.__str__-toggle" onclick="return toggle('Addr.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__str__-expanded"><a name="L267"></a><tt class="py-lineno"> 267</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L268"></a><tt class="py-lineno"> 268</tt> <tt class="py-line"><tt class="py-docstring"> @return: The common string representation for this address type.</tt> </tt> -<a name="L269"></a><tt class="py-lineno"> 269</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L270"></a><tt class="py-lineno"> 270</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-136" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +<a name="Addr.__str__"></a><div id="Addr.__str__-def"><a name="L254"></a><tt class="py-lineno"> 254</tt> <a class="py-toggle" href="#" id="Addr.__str__-toggle" onclick="return toggle('Addr.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__str__-expanded"><a name="L255"></a><tt class="py-lineno"> 255</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: common string representation of this address"""</tt> </tt> +<a name="L256"></a><tt class="py-lineno"> 256</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-155" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-136', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-137" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_str()=netaddr.strategy.AddrStrategy-class.html#int_to_str,Method netaddr.strategy.EUI48Strategy.int_to_str()=netaddr.strategy.EUI48Strategy-class.html#int_to_str,Method netaddr.strategy.IPv4StrategyOpt.int_to_str()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str,Method netaddr.strategy.IPv6Strategy.int_to_str()=netaddr.strategy.IPv6Strategy-class.html#int_to_str"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-155', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-156" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_str()=netaddr.strategy.AddrStrategy-class.html#int_to_str,Method netaddr.strategy.EUI48Strategy.int_to_str()=netaddr.strategy.EUI48Strategy-class.html#int_to_str,Method netaddr.strategy.IPv4StrategyOpt.int_to_str()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str,Method netaddr.strategy.IPv6Strategy.int_to_str()=netaddr.strategy.IPv6Strategy-class.html#int_to_str"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-137', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-138" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-138', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L271"></a><tt class="py-lineno"> 271</tt> <tt class="py-line"> </tt> -<a name="Addr.__repr__"></a><div id="Addr.__repr__-def"><a name="L272"></a><tt class="py-lineno"> 272</tt> <a class="py-toggle" href="#" id="Addr.__repr__-toggle" onclick="return toggle('Addr.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__repr__-expanded"><a name="L273"></a><tt class="py-lineno"> 273</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L274"></a><tt class="py-lineno"> 274</tt> <tt class="py-line"><tt class="py-docstring"> @return: An executable Python statement that can recreate an object</tt> </tt> -<a name="L275"></a><tt class="py-lineno"> 275</tt> <tt class="py-line"><tt class="py-docstring"> with an equivalent state.</tt> </tt> -<a name="L276"></a><tt class="py-lineno"> 276</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L277"></a><tt class="py-lineno"> 277</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s(%r)"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L278"></a><tt class="py-lineno"> 278</tt> <tt class="py-line"> </tt> -<a name="Addr.bits"></a><div id="Addr.bits-def"><a name="L279"></a><tt class="py-lineno"> 279</tt> <a class="py-toggle" href="#" id="Addr.bits-toggle" onclick="return toggle('Addr.bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#bits">bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.bits-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.bits-expanded"><a name="L280"></a><tt class="py-lineno"> 280</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L281"></a><tt class="py-lineno"> 281</tt> <tt class="py-line"><tt class="py-docstring"> @return: A human-readable binary digit string for this address type.</tt> </tt> -<a name="L282"></a><tt class="py-lineno"> 282</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L283"></a><tt class="py-lineno"> 283</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-139" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-139', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-140" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_bits()=netaddr.strategy.AddrStrategy-class.html#int_to_bits"><a title="netaddr.strategy.AddrStrategy.int_to_bits" class="py-name" href="#" onclick="return doclink('link-140', 'int_to_bits', 'link-140');">int_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-141" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-141', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L284"></a><tt class="py-lineno"> 284</tt> <tt class="py-line"> </tt> -<a name="Addr.__len__"></a><div id="Addr.__len__-def"><a name="L285"></a><tt class="py-lineno"> 285</tt> <a class="py-toggle" href="#" id="Addr.__len__-toggle" onclick="return toggle('Addr.__len__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__len__">__len__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__len__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__len__-expanded"><a name="L286"></a><tt class="py-lineno"> 286</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L287"></a><tt class="py-lineno"> 287</tt> <tt class="py-line"><tt class="py-docstring"> @return: The size of this address (in bits).</tt> </tt> -<a name="L288"></a><tt class="py-lineno"> 288</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L289"></a><tt class="py-lineno"> 289</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-142" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-156', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-157" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-157', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L257"></a><tt class="py-lineno"> 257</tt> <tt class="py-line"> </tt> +<a name="Addr.__repr__"></a><div id="Addr.__repr__-def"><a name="L258"></a><tt class="py-lineno"> 258</tt> <a class="py-toggle" href="#" id="Addr.__repr__-toggle" onclick="return toggle('Addr.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__repr__-expanded"><a name="L259"></a><tt class="py-lineno"> 259</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object"""</tt> </tt> +<a name="L260"></a><tt class="py-lineno"> 260</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s(%r)"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L261"></a><tt class="py-lineno"> 261</tt> <tt class="py-line"> </tt> +<a name="Addr.bits"></a><div id="Addr.bits-def"><a name="L262"></a><tt class="py-lineno"> 262</tt> <a class="py-toggle" href="#" id="Addr.bits-toggle" onclick="return toggle('Addr.bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#bits">bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.bits-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.bits-expanded"><a name="L263"></a><tt class="py-lineno"> 263</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: human-readable binary digit string of this address"""</tt> </tt> +<a name="L264"></a><tt class="py-lineno"> 264</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-158" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-142', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> </tt> -</div><a name="L290"></a><tt class="py-lineno"> 290</tt> <tt class="py-line"> </tt> -<a name="Addr.__iter__"></a><div id="Addr.__iter__-def"><a name="L291"></a><tt class="py-lineno"> 291</tt> <a class="py-toggle" href="#" id="Addr.__iter__-toggle" onclick="return toggle('Addr.__iter__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__iter__">__iter__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__iter__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__iter__-expanded"><a name="L292"></a><tt class="py-lineno"> 292</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L293"></a><tt class="py-lineno"> 293</tt> <tt class="py-line"><tt class="py-docstring"> @return: An iterator over individual words in this address.</tt> </tt> -<a name="L294"></a><tt class="py-lineno"> 294</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L295"></a><tt class="py-lineno"> 295</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">iter</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-143" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-158', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-159" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_bits()=netaddr.strategy.AddrStrategy-class.html#int_to_bits"><a title="netaddr.strategy.AddrStrategy.int_to_bits" class="py-name" href="#" onclick="return doclink('link-159', 'int_to_bits', 'link-159');">int_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-160" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-160', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L265"></a><tt class="py-lineno"> 265</tt> <tt class="py-line"> </tt> +<a name="Addr.packed"></a><div id="Addr.packed-def"><a name="L266"></a><tt class="py-lineno"> 266</tt> <a class="py-toggle" href="#" id="Addr.packed-toggle" onclick="return toggle('Addr.packed');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#packed">packed</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.packed-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.packed-expanded"><a name="L267"></a><tt class="py-lineno"> 267</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: binary packed string of this address"""</tt> </tt> +<a name="L268"></a><tt class="py-lineno"> 268</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-161" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-143', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-144" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_words()=netaddr.strategy.AddrStrategy-class.html#int_to_words,Method netaddr.strategy.IPv4StrategyOpt.int_to_words()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-144', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-145" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-145', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L296"></a><tt class="py-lineno"> 296</tt> <tt class="py-line"> </tt> -<a name="Addr.__getitem__"></a><div id="Addr.__getitem__-def"><a name="L297"></a><tt class="py-lineno"> 297</tt> <a class="py-toggle" href="#" id="Addr.__getitem__-toggle" onclick="return toggle('Addr.__getitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__getitem__">__getitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__getitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__getitem__-expanded"><a name="L298"></a><tt class="py-lineno"> 298</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L299"></a><tt class="py-lineno"> 299</tt> <tt class="py-line"><tt class="py-docstring"> @return: The integer value of the word indicated by index. Raises an</tt> </tt> -<a name="L300"></a><tt class="py-lineno"> 300</tt> <tt class="py-line"><tt class="py-docstring"> C{IndexError} if index is wrong size for address type. Full</tt> </tt> -<a name="L301"></a><tt class="py-lineno"> 301</tt> <tt class="py-line"><tt class="py-docstring"> slicing is also supported.</tt> </tt> -<a name="L302"></a><tt class="py-lineno"> 302</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L303"></a><tt class="py-lineno"> 303</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L304"></a><tt class="py-lineno"> 304</tt> <tt class="py-line"> <tt class="py-comment"># Indexing, including negative indexing goodness.</tt> </tt> -<a name="L305"></a><tt class="py-lineno"> 305</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">word_count</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-146" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-161', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-162" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_packed()=netaddr.strategy.AddrStrategy-class.html#int_to_packed"><a title="netaddr.strategy.AddrStrategy.int_to_packed" class="py-name" href="#" onclick="return doclink('link-162', 'int_to_packed', 'link-162');">int_to_packed</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-163" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-163', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L269"></a><tt class="py-lineno"> 269</tt> <tt class="py-line"> </tt> +<a name="Addr.bin"></a><div id="Addr.bin-def"><a name="L270"></a><tt class="py-lineno"> 270</tt> <a class="py-toggle" href="#" id="Addr.bin-toggle" onclick="return toggle('Addr.bin');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#bin">bin</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.bin-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.bin-expanded"><a name="L271"></a><tt class="py-lineno"> 271</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L272"></a><tt class="py-lineno"> 272</tt> <tt class="py-line"><tt class="py-docstring"> @return: standard Python binary representation of this address. A back</tt> </tt> +<a name="L273"></a><tt class="py-lineno"> 273</tt> <tt class="py-line"><tt class="py-docstring"> port of the format provided by the builtin bin() type available in</tt> </tt> +<a name="L274"></a><tt class="py-lineno"> 274</tt> <tt class="py-line"><tt class="py-docstring"> Python 2.6.x and higher."""</tt> </tt> +<a name="L275"></a><tt class="py-lineno"> 275</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-164" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-146', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt> </tt> -<a name="L306"></a><tt class="py-lineno"> 306</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-op">-</tt><tt class="py-name">word_count</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">word_count</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L307"></a><tt class="py-lineno"> 307</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'index out range for address type!'</tt><tt class="py-op">)</tt> </tt> -<a name="L308"></a><tt class="py-lineno"> 308</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-147" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-164', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-165" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_bin()=netaddr.strategy.AddrStrategy-class.html#int_to_bin"><a title="netaddr.strategy.AddrStrategy.int_to_bin" class="py-name" href="#" onclick="return doclink('link-165', 'int_to_bin', 'link-165');">int_to_bin</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-166" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-166', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L276"></a><tt class="py-lineno"> 276</tt> <tt class="py-line"> </tt> +<a name="Addr.__len__"></a><div id="Addr.__len__-def"><a name="L277"></a><tt class="py-lineno"> 277</tt> <a class="py-toggle" href="#" id="Addr.__len__-toggle" onclick="return toggle('Addr.__len__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__len__">__len__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__len__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__len__-expanded"><a name="L278"></a><tt class="py-lineno"> 278</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: The size (width) of this address in bits"""</tt> </tt> +<a name="L279"></a><tt class="py-lineno"> 279</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-167" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-147', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-148" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-148', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-149" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-149', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">]</tt> </tt> -<a name="L309"></a><tt class="py-lineno"> 309</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">slice</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L310"></a><tt class="py-lineno"> 310</tt> <tt class="py-line"> <tt class="py-comment"># Slicing baby!</tt> </tt> -<a name="L311"></a><tt class="py-lineno"> 311</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-150" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-167', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> </tt> +</div><a name="L280"></a><tt class="py-lineno"> 280</tt> <tt class="py-line"> </tt> +<a name="Addr.__iter__"></a><div id="Addr.__iter__-def"><a name="L281"></a><tt class="py-lineno"> 281</tt> <a class="py-toggle" href="#" id="Addr.__iter__-toggle" onclick="return toggle('Addr.__iter__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__iter__">__iter__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__iter__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__iter__-expanded"><a name="L282"></a><tt class="py-lineno"> 282</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: An iterator over individual words in this address"""</tt> </tt> +<a name="L283"></a><tt class="py-lineno"> 283</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">iter</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-168" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-150', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-151" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-151', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-152" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-152', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L312"></a><tt class="py-lineno"> 312</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-op">*</tt><tt class="py-name">index</tt><tt class="py-op">.</tt><tt class="py-name">indices</tt><tt class="py-op">(</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L313"></a><tt class="py-lineno"> 313</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L314"></a><tt class="py-lineno"> 314</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported type %r!'</tt> <tt class="py-op">%</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> -</div><a name="L315"></a><tt class="py-lineno"> 315</tt> <tt class="py-line"> </tt> -<a name="Addr.__setitem__"></a><div id="Addr.__setitem__-def"><a name="L316"></a><tt class="py-lineno"> 316</tt> <a class="py-toggle" href="#" id="Addr.__setitem__-toggle" onclick="return toggle('Addr.__setitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__setitem__">__setitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__setitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__setitem__-expanded"><a name="L317"></a><tt class="py-lineno"> 317</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L318"></a><tt class="py-lineno"> 318</tt> <tt class="py-line"><tt class="py-docstring"> Sets the value of the word of this address indicated by index.</tt> </tt> -<a name="L319"></a><tt class="py-lineno"> 319</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L320"></a><tt class="py-lineno"> 320</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">slice</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L321"></a><tt class="py-lineno"> 321</tt> <tt class="py-line"> <tt class="py-comment"># TODO - settable slices.</tt> </tt> -<a name="L322"></a><tt class="py-lineno"> 322</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">raise</tt> <tt class="py-name">NotImplementedError</tt><tt class="py-op">(</tt><tt class="py-string">'settable slices not yet supported!'</tt><tt class="py-op">)</tt> </tt> -<a name="L323"></a><tt class="py-lineno"> 323</tt> <tt class="py-line"> </tt> -<a name="L324"></a><tt class="py-lineno"> 324</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L325"></a><tt class="py-lineno"> 325</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'index not an integer!'</tt><tt class="py-op">)</tt> </tt> -<a name="L326"></a><tt class="py-lineno"> 326</tt> <tt class="py-line"> </tt> -<a name="L327"></a><tt class="py-lineno"> 327</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-153" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-168', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-169" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_words()=netaddr.strategy.AddrStrategy-class.html#int_to_words,Method netaddr.strategy.IPv4StrategyOpt.int_to_words()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-169', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-170" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-170', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L284"></a><tt class="py-lineno"> 284</tt> <tt class="py-line"> </tt> +<a name="Addr.__getitem__"></a><div id="Addr.__getitem__-def"><a name="L285"></a><tt class="py-lineno"> 285</tt> <a class="py-toggle" href="#" id="Addr.__getitem__-toggle" onclick="return toggle('Addr.__getitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__getitem__">__getitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__getitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__getitem__-expanded"><a name="L286"></a><tt class="py-lineno"> 286</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L287"></a><tt class="py-lineno"> 287</tt> <tt class="py-line"><tt class="py-docstring"> @return: The integer value of the word referenced by index (both</tt> </tt> +<a name="L288"></a><tt class="py-lineno"> 288</tt> <tt class="py-line"><tt class="py-docstring"> positive and negative). Raises C{IndexError} if index is out</tt> </tt> +<a name="L289"></a><tt class="py-lineno"> 289</tt> <tt class="py-line"><tt class="py-docstring"> of bounds. Also supports Python list slices for accessing</tt> </tt> +<a name="L290"></a><tt class="py-lineno"> 290</tt> <tt class="py-line"><tt class="py-docstring"> word groups.</tt> </tt> +<a name="L291"></a><tt class="py-lineno"> 291</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L292"></a><tt class="py-lineno"> 292</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L293"></a><tt class="py-lineno"> 293</tt> <tt class="py-line"> <tt class="py-comment"># Indexing, including negative indexing goodness.</tt> </tt> +<a name="L294"></a><tt class="py-lineno"> 294</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">num_words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-171" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-171', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt> </tt> +<a name="L295"></a><tt class="py-lineno"> 295</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-op">-</tt><tt class="py-name">num_words</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">num_words</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L296"></a><tt class="py-lineno"> 296</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'index out range for address type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L297"></a><tt class="py-lineno"> 297</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-172" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-153', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L328"></a><tt class="py-lineno"> 328</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'index %d outside address type boundary!'</tt> <tt class="py-op">%</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> -<a name="L329"></a><tt class="py-lineno"> 329</tt> <tt class="py-line"> </tt> -<a name="L330"></a><tt class="py-lineno"> 330</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-154" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-154', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L331"></a><tt class="py-lineno"> 331</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'value not an integer!'</tt><tt class="py-op">)</tt> </tt> -<a name="L332"></a><tt class="py-lineno"> 332</tt> <tt class="py-line"> </tt> -<a name="L333"></a><tt class="py-lineno"> 333</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt id="link-155" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-155', 'value', 'link-26');">value</a></tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-156" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-172', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-173" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-173', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-174" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-174', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">]</tt> </tt> +<a name="L298"></a><tt class="py-lineno"> 298</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">slice</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L299"></a><tt class="py-lineno"> 299</tt> <tt class="py-line"> <tt class="py-comment"># Slicing baby!</tt> </tt> +<a name="L300"></a><tt class="py-lineno"> 300</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-175" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-156', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L334"></a><tt class="py-lineno"> 334</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'value %d outside word size maximum of %d bits!'</tt> </tt> -<a name="L335"></a><tt class="py-lineno"> 335</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-157" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-157', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-158" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-175', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-176" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-176', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-177" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-177', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L301"></a><tt class="py-lineno"> 301</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-op">*</tt><tt class="py-name">index</tt><tt class="py-op">.</tt><tt class="py-name">indices</tt><tt class="py-op">(</tt><tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> +<a name="L302"></a><tt class="py-lineno"> 302</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L303"></a><tt class="py-lineno"> 303</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported type %r!'</tt> <tt class="py-op">%</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> +</div><a name="L304"></a><tt class="py-lineno"> 304</tt> <tt class="py-line"> </tt> +<a name="Addr.__setitem__"></a><div id="Addr.__setitem__-def"><a name="L305"></a><tt class="py-lineno"> 305</tt> <a class="py-toggle" href="#" id="Addr.__setitem__-toggle" onclick="return toggle('Addr.__setitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__setitem__">__setitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">,</tt> <tt class="py-param">value</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__setitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__setitem__-expanded"><a name="L306"></a><tt class="py-lineno"> 306</tt> <tt class="py-line"> <tt class="py-docstring">"""Sets the value of the word referenced by index in this address"""</tt> </tt> +<a name="L307"></a><tt class="py-lineno"> 307</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">slice</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L308"></a><tt class="py-lineno"> 308</tt> <tt class="py-line"> <tt class="py-comment"># TODO - settable slices.</tt> </tt> +<a name="L309"></a><tt class="py-lineno"> 309</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">raise</tt> <tt class="py-name">NotImplementedError</tt><tt class="py-op">(</tt><tt class="py-string">'settable slices not yet supported!'</tt><tt class="py-op">)</tt> </tt> +<a name="L310"></a><tt class="py-lineno"> 310</tt> <tt class="py-line"> </tt> +<a name="L311"></a><tt class="py-lineno"> 311</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L312"></a><tt class="py-lineno"> 312</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'index not an integer!'</tt><tt class="py-op">)</tt> </tt> +<a name="L313"></a><tt class="py-lineno"> 313</tt> <tt class="py-line"> </tt> +<a name="L314"></a><tt class="py-lineno"> 314</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-178" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-158', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L336"></a><tt class="py-lineno"> 336</tt> <tt class="py-line"> </tt> -<a name="L337"></a><tt class="py-lineno"> 337</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-159" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-178', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L315"></a><tt class="py-lineno"> 315</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'index %d outside address type boundary!'</tt> <tt class="py-op">%</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> +<a name="L316"></a><tt class="py-lineno"> 316</tt> <tt class="py-line"> </tt> +<a name="L317"></a><tt class="py-lineno"> 317</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-179" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-179', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L318"></a><tt class="py-lineno"> 318</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'value not an integer!'</tt><tt class="py-op">)</tt> </tt> +<a name="L319"></a><tt class="py-lineno"> 319</tt> <tt class="py-line"> </tt> +<a name="L320"></a><tt class="py-lineno"> 320</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt id="link-180" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-180', 'value', 'link-30');">value</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-181" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-159', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-160" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-160', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-161" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-161', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L338"></a><tt class="py-lineno"> 338</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-162" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-162', 'value', 'link-26');">value</a></tt> </tt> -<a name="L339"></a><tt class="py-lineno"> 339</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-163" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-163', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-164" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-181', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> +<a name="L321"></a><tt class="py-lineno"> 321</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'value %d outside word size maximum of %d bits!'</tt> </tt> +<a name="L322"></a><tt class="py-lineno"> 322</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-182" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-182', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-183" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-164', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-165" class="py-name" targets="Method netaddr.strategy.AddrStrategy.words_to_int()=netaddr.strategy.AddrStrategy-class.html#words_to_int,Method netaddr.strategy.IPv4StrategyOpt.words_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int"><a title="netaddr.strategy.AddrStrategy.words_to_int -netaddr.strategy.IPv4StrategyOpt.words_to_int" class="py-name" href="#" onclick="return doclink('link-165', 'words_to_int', 'link-165');">words_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L340"></a><tt class="py-lineno"> 340</tt> <tt class="py-line"> </tt> -<a name="Addr.__hex__"></a><div id="Addr.__hex__-def"><a name="L341"></a><tt class="py-lineno"> 341</tt> <a class="py-toggle" href="#" id="Addr.__hex__-toggle" onclick="return toggle('Addr.__hex__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__hex__">__hex__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__hex__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__hex__-expanded"><a name="L342"></a><tt class="py-lineno"> 342</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L343"></a><tt class="py-lineno"> 343</tt> <tt class="py-line"><tt class="py-docstring"> @return: The value of this address as a network byte order hexadecimal</tt> </tt> -<a name="L344"></a><tt class="py-lineno"> 344</tt> <tt class="py-line"><tt class="py-docstring"> number.</tt> </tt> -<a name="L345"></a><tt class="py-lineno"> 345</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L346"></a><tt class="py-lineno"> 346</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-166" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-166', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-string">'L'</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -</div><a name="L347"></a><tt class="py-lineno"> 347</tt> <tt class="py-line"> </tt> -<a name="Addr.__iadd__"></a><div id="Addr.__iadd__-def"><a name="L348"></a><tt class="py-lineno"> 348</tt> <a class="py-toggle" href="#" id="Addr.__iadd__-toggle" onclick="return toggle('Addr.__iadd__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__iadd__">__iadd__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">i</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__iadd__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__iadd__-expanded"><a name="L349"></a><tt class="py-lineno"> 349</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L350"></a><tt class="py-lineno"> 350</tt> <tt class="py-line"><tt class="py-docstring"> Increments network address by specified value.</tt> </tt> -<a name="L351"></a><tt class="py-lineno"> 351</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L352"></a><tt class="py-lineno"> 352</tt> <tt class="py-line"><tt class="py-docstring"> If the result exceeds address type maximum, it rolls around the</tt> </tt> -<a name="L353"></a><tt class="py-lineno"> 353</tt> <tt class="py-line"><tt class="py-docstring"> minimum boundary.</tt> </tt> -<a name="L354"></a><tt class="py-lineno"> 354</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L355"></a><tt class="py-lineno"> 355</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L356"></a><tt class="py-lineno"> 356</tt> <tt class="py-line"> <tt class="py-name">new_value</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-167" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-167', 'value', 'link-26');">value</a></tt> <tt class="py-op">+</tt> <tt class="py-name">i</tt> </tt> -<a name="L357"></a><tt class="py-lineno"> 357</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_value</tt> <tt class="py-op">></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-168" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-183', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L323"></a><tt class="py-lineno"> 323</tt> <tt class="py-line"> </tt> +<a name="L324"></a><tt class="py-lineno"> 324</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-184" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-168', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">:</tt> </tt> -<a name="L358"></a><tt class="py-lineno"> 358</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-169" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-169', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-170" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-184', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-185" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-185', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-186" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-186', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L325"></a><tt class="py-lineno"> 325</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-187" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-187', 'value', 'link-30');">value</a></tt> </tt> +<a name="L326"></a><tt class="py-lineno"> 326</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-188" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-188', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-189" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-170', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L359"></a><tt class="py-lineno"> 359</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L360"></a><tt class="py-lineno"> 360</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-171" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-171', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> </tt> -<a name="L361"></a><tt class="py-lineno"> 361</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L362"></a><tt class="py-lineno"> 362</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Increment value must be an integer!'</tt><tt class="py-op">)</tt> </tt> -<a name="L363"></a><tt class="py-lineno"> 363</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> -</div><a name="L364"></a><tt class="py-lineno"> 364</tt> <tt class="py-line"> </tt> -<a name="Addr.__isub__"></a><div id="Addr.__isub__-def"><a name="L365"></a><tt class="py-lineno"> 365</tt> <a class="py-toggle" href="#" id="Addr.__isub__-toggle" onclick="return toggle('Addr.__isub__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__isub__">__isub__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">i</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__isub__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__isub__-expanded"><a name="L366"></a><tt class="py-lineno"> 366</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L367"></a><tt class="py-lineno"> 367</tt> <tt class="py-line"><tt class="py-docstring"> Decrements network address by specified value.</tt> </tt> -<a name="L368"></a><tt class="py-lineno"> 368</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L369"></a><tt class="py-lineno"> 369</tt> <tt class="py-line"><tt class="py-docstring"> If the result exceeds address type minimum, it rolls around the</tt> </tt> -<a name="L370"></a><tt class="py-lineno"> 370</tt> <tt class="py-line"><tt class="py-docstring"> maximum boundary.</tt> </tt> -<a name="L371"></a><tt class="py-lineno"> 371</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L372"></a><tt class="py-lineno"> 372</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L373"></a><tt class="py-lineno"> 373</tt> <tt class="py-line"> <tt class="py-name">new_value</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-172" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-172', 'value', 'link-26');">value</a></tt> <tt class="py-op">-</tt> <tt class="py-name">i</tt> </tt> -<a name="L374"></a><tt class="py-lineno"> 374</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_value</tt> <tt class="py-op"><</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-173" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-189', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-190" class="py-name" targets="Method netaddr.strategy.AddrStrategy.words_to_int()=netaddr.strategy.AddrStrategy-class.html#words_to_int,Method netaddr.strategy.IPv4StrategyOpt.words_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int"><a title="netaddr.strategy.AddrStrategy.words_to_int +netaddr.strategy.IPv4StrategyOpt.words_to_int" class="py-name" href="#" onclick="return doclink('link-190', 'words_to_int', 'link-190');">words_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> +</div><a name="L327"></a><tt class="py-lineno"> 327</tt> <tt class="py-line"> </tt> +<a name="Addr.__hex__"></a><div id="Addr.__hex__-def"><a name="L328"></a><tt class="py-lineno"> 328</tt> <a class="py-toggle" href="#" id="Addr.__hex__-toggle" onclick="return toggle('Addr.__hex__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__hex__">__hex__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__hex__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__hex__-expanded"><a name="L329"></a><tt class="py-lineno"> 329</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: network byte order hexadecimal string of this address"""</tt> </tt> +<a name="L330"></a><tt class="py-lineno"> 330</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-191" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-191', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-string">'L'</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L331"></a><tt class="py-lineno"> 331</tt> <tt class="py-line"> </tt> +<a name="Addr.__iadd__"></a><div id="Addr.__iadd__-def"><a name="L332"></a><tt class="py-lineno"> 332</tt> <a class="py-toggle" href="#" id="Addr.__iadd__-toggle" onclick="return toggle('Addr.__iadd__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__iadd__">__iadd__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">num</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__iadd__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__iadd__-expanded"><a name="L333"></a><tt class="py-lineno"> 333</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L334"></a><tt class="py-lineno"> 334</tt> <tt class="py-line"><tt class="py-docstring"> Increment value of network address by specified amount. Behaves like</tt> </tt> +<a name="L335"></a><tt class="py-lineno"> 335</tt> <tt class="py-line"><tt class="py-docstring"> an unsigned integer, rolling over to zero when it reaches the maximum</tt> </tt> +<a name="L336"></a><tt class="py-lineno"> 336</tt> <tt class="py-line"><tt class="py-docstring"> value threshold.</tt> </tt> +<a name="L337"></a><tt class="py-lineno"> 337</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L338"></a><tt class="py-lineno"> 338</tt> <tt class="py-line"><tt class="py-docstring"> @param num: size of increment</tt> </tt> +<a name="L339"></a><tt class="py-lineno"> 339</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L340"></a><tt class="py-lineno"> 340</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L341"></a><tt class="py-lineno"> 341</tt> <tt class="py-line"> <tt class="py-name">new_value</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-192" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-192', 'value', 'link-30');">value</a></tt> <tt class="py-op">+</tt> <tt class="py-name">num</tt> </tt> +<a name="L342"></a><tt class="py-lineno"> 342</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_value</tt> <tt class="py-op">></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-193" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-173', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">min_int</tt><tt class="py-op">:</tt> </tt> -<a name="L375"></a><tt class="py-lineno"> 375</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-174" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-174', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-175" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-193', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">:</tt> </tt> +<a name="L343"></a><tt class="py-lineno"> 343</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-194" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-194', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-195" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-175', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L376"></a><tt class="py-lineno"> 376</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L377"></a><tt class="py-lineno"> 377</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-176" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-176', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> </tt> -<a name="L378"></a><tt class="py-lineno"> 378</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L379"></a><tt class="py-lineno"> 379</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Decrement value must be an integer!'</tt><tt class="py-op">)</tt> </tt> -<a name="L380"></a><tt class="py-lineno"> 380</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> -</div><a name="L381"></a><tt class="py-lineno"> 381</tt> <tt class="py-line"> </tt> -<a name="Addr.__eq__"></a><div id="Addr.__eq__-def"><a name="L382"></a><tt class="py-lineno"> 382</tt> <a class="py-toggle" href="#" id="Addr.__eq__-toggle" onclick="return toggle('Addr.__eq__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__eq__">__eq__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__eq__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__eq__-expanded"><a name="L383"></a><tt class="py-lineno"> 383</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L384"></a><tt class="py-lineno"> 384</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this network address instance has the same</tt> </tt> -<a name="L385"></a><tt class="py-lineno"> 385</tt> <tt class="py-line"><tt class="py-docstring"> numerical value as another, C{False} otherwise.</tt> </tt> -<a name="L386"></a><tt class="py-lineno"> 386</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L387"></a><tt class="py-lineno"> 387</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L388"></a><tt class="py-lineno"> 388</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-177" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-195', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L344"></a><tt class="py-lineno"> 344</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L345"></a><tt class="py-lineno"> 345</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-196" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-196', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> </tt> +<a name="L346"></a><tt class="py-lineno"> 346</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L347"></a><tt class="py-lineno"> 347</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Increment value must be an integer!'</tt><tt class="py-op">)</tt> </tt> +<a name="L348"></a><tt class="py-lineno"> 348</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> +</div><a name="L349"></a><tt class="py-lineno"> 349</tt> <tt class="py-line"> </tt> +<a name="Addr.__isub__"></a><div id="Addr.__isub__-def"><a name="L350"></a><tt class="py-lineno"> 350</tt> <a class="py-toggle" href="#" id="Addr.__isub__-toggle" onclick="return toggle('Addr.__isub__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__isub__">__isub__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">num</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__isub__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__isub__-expanded"><a name="L351"></a><tt class="py-lineno"> 351</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L352"></a><tt class="py-lineno"> 352</tt> <tt class="py-line"><tt class="py-docstring"> Decrement value of network address by specified amount. Behaves like</tt> </tt> +<a name="L353"></a><tt class="py-lineno"> 353</tt> <tt class="py-line"><tt class="py-docstring"> an unsigned integer, rolling over to maximum value when it goes below</tt> </tt> +<a name="L354"></a><tt class="py-lineno"> 354</tt> <tt class="py-line"><tt class="py-docstring"> zero.</tt> </tt> +<a name="L355"></a><tt class="py-lineno"> 355</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L356"></a><tt class="py-lineno"> 356</tt> <tt class="py-line"><tt class="py-docstring"> @param num: size of decrement</tt> </tt> +<a name="L357"></a><tt class="py-lineno"> 357</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L358"></a><tt class="py-lineno"> 358</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L359"></a><tt class="py-lineno"> 359</tt> <tt class="py-line"> <tt class="py-name">new_value</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-197" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-197', 'value', 'link-30');">value</a></tt> <tt class="py-op">-</tt> <tt class="py-name">num</tt> </tt> +<a name="L360"></a><tt class="py-lineno"> 360</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_value</tt> <tt class="py-op"><</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L361"></a><tt class="py-lineno"> 361</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-198" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-198', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-199" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-199', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L362"></a><tt class="py-lineno"> 362</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L363"></a><tt class="py-lineno"> 363</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-200" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-200', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_value</tt> </tt> +<a name="L364"></a><tt class="py-lineno"> 364</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L365"></a><tt class="py-lineno"> 365</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Decrement value must be an integer!'</tt><tt class="py-op">)</tt> </tt> +<a name="L366"></a><tt class="py-lineno"> 366</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> +</div><a name="L367"></a><tt class="py-lineno"> 367</tt> <tt class="py-line"> </tt> +<a name="Addr.__add__"></a><div id="Addr.__add__-def"><a name="L368"></a><tt class="py-lineno"> 368</tt> <a class="py-toggle" href="#" id="Addr.__add__-toggle" onclick="return toggle('Addr.__add__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__add__">__add__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__add__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__add__-expanded"><a name="L369"></a><tt class="py-lineno"> 369</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L370"></a><tt class="py-lineno"> 370</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an integer or int-like object.</tt> </tt> +<a name="L371"></a><tt class="py-lineno"> 371</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L372"></a><tt class="py-lineno"> 372</tt> <tt class="py-line"><tt class="py-docstring"> @return: A new (potentially larger) Addr class/subclass instance.</tt> </tt> +<a name="L373"></a><tt class="py-lineno"> 373</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L374"></a><tt class="py-lineno"> 374</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-201" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-201', 'value', 'link-30');">value</a></tt> <tt class="py-op">+</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-202" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-177', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-178" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-178', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-179" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-202', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L375"></a><tt class="py-lineno"> 375</tt> <tt class="py-line"> </tt> +<a name="Addr.__sub__"></a><div id="Addr.__sub__-def"><a name="L376"></a><tt class="py-lineno"> 376</tt> <a class="py-toggle" href="#" id="Addr.__sub__-toggle" onclick="return toggle('Addr.__sub__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__sub__">__sub__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__sub__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__sub__-expanded"><a name="L377"></a><tt class="py-lineno"> 377</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L378"></a><tt class="py-lineno"> 378</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an integer or int-like object.</tt> </tt> +<a name="L379"></a><tt class="py-lineno"> 379</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L380"></a><tt class="py-lineno"> 380</tt> <tt class="py-line"><tt class="py-docstring"> @return: A new (potentially smaller) Addr class/subclass instance.</tt> </tt> +<a name="L381"></a><tt class="py-lineno"> 381</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L382"></a><tt class="py-lineno"> 382</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-203" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-203', 'value', 'link-30');">value</a></tt> <tt class="py-op">-</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-204" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-179', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-180" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-180', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L389"></a><tt class="py-lineno"> 389</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L390"></a><tt class="py-lineno"> 390</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L391"></a><tt class="py-lineno"> 391</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L392"></a><tt class="py-lineno"> 392</tt> <tt class="py-line"> </tt> -<a name="L393"></a><tt class="py-lineno"> 393</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L394"></a><tt class="py-lineno"> 394</tt> <tt class="py-line"> </tt> -<a name="Addr.__ne__"></a><div id="Addr.__ne__-def"><a name="L395"></a><tt class="py-lineno"> 395</tt> <a class="py-toggle" href="#" id="Addr.__ne__-toggle" onclick="return toggle('Addr.__ne__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__ne__">__ne__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__ne__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__ne__-expanded"><a name="L396"></a><tt class="py-lineno"> 396</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L397"></a><tt class="py-lineno"> 397</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this network address instance does not have the</tt> </tt> -<a name="L398"></a><tt class="py-lineno"> 398</tt> <tt class="py-line"><tt class="py-docstring"> same numerical value as another, C{False} otherwise.</tt> </tt> -<a name="L399"></a><tt class="py-lineno"> 399</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L400"></a><tt class="py-lineno"> 400</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L401"></a><tt class="py-lineno"> 401</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-181" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-204', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L383"></a><tt class="py-lineno"> 383</tt> <tt class="py-line"> </tt> +<a name="Addr.__eq__"></a><div id="Addr.__eq__-def"><a name="L384"></a><tt class="py-lineno"> 384</tt> <a class="py-toggle" href="#" id="Addr.__eq__-toggle" onclick="return toggle('Addr.__eq__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__eq__">__eq__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__eq__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__eq__-expanded"><a name="L385"></a><tt class="py-lineno"> 385</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L386"></a><tt class="py-lineno"> 386</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is numerically the same as other,</tt> </tt> +<a name="L387"></a><tt class="py-lineno"> 387</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> +<a name="L388"></a><tt class="py-lineno"> 388</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L389"></a><tt class="py-lineno"> 389</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L390"></a><tt class="py-lineno"> 390</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-205" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-181', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-182" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-182', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-183" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-205', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-206" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-206', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-207" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-183', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-184" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-184', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L402"></a><tt class="py-lineno"> 402</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L403"></a><tt class="py-lineno"> 403</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L404"></a><tt class="py-lineno"> 404</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L405"></a><tt class="py-lineno"> 405</tt> <tt class="py-line"> </tt> -<a name="L406"></a><tt class="py-lineno"> 406</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L407"></a><tt class="py-lineno"> 407</tt> <tt class="py-line"> </tt> -<a name="Addr.__lt__"></a><div id="Addr.__lt__-def"><a name="L408"></a><tt class="py-lineno"> 408</tt> <a class="py-toggle" href="#" id="Addr.__lt__-toggle" onclick="return toggle('Addr.__lt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__lt__">__lt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__lt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__lt__-expanded"><a name="L409"></a><tt class="py-lineno"> 409</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L410"></a><tt class="py-lineno"> 410</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this network address instance has a lower</tt> </tt> -<a name="L411"></a><tt class="py-lineno"> 411</tt> <tt class="py-line"><tt class="py-docstring"> numerical value than another, C{False} otherwise.</tt> </tt> -<a name="L412"></a><tt class="py-lineno"> 412</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L413"></a><tt class="py-lineno"> 413</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L414"></a><tt class="py-lineno"> 414</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-185" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-207', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-208" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-208', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L391"></a><tt class="py-lineno"> 391</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L392"></a><tt class="py-lineno"> 392</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L393"></a><tt class="py-lineno"> 393</tt> <tt class="py-line"> </tt> +<a name="Addr.__ne__"></a><div id="Addr.__ne__-def"><a name="L394"></a><tt class="py-lineno"> 394</tt> <a class="py-toggle" href="#" id="Addr.__ne__-toggle" onclick="return toggle('Addr.__ne__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__ne__">__ne__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__ne__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__ne__-expanded"><a name="L395"></a><tt class="py-lineno"> 395</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L396"></a><tt class="py-lineno"> 396</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is not numerically the same other,</tt> </tt> +<a name="L397"></a><tt class="py-lineno"> 397</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> +<a name="L398"></a><tt class="py-lineno"> 398</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L399"></a><tt class="py-lineno"> 399</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L400"></a><tt class="py-lineno"> 400</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-209" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-185', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-186" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-186', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op"><</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-187" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-209', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-210" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-210', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-211" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-187', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-188" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-188', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L415"></a><tt class="py-lineno"> 415</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L416"></a><tt class="py-lineno"> 416</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L417"></a><tt class="py-lineno"> 417</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L418"></a><tt class="py-lineno"> 418</tt> <tt class="py-line"> </tt> -<a name="L419"></a><tt class="py-lineno"> 419</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L420"></a><tt class="py-lineno"> 420</tt> <tt class="py-line"> </tt> -<a name="Addr.__le__"></a><div id="Addr.__le__-def"><a name="L421"></a><tt class="py-lineno"> 421</tt> <a class="py-toggle" href="#" id="Addr.__le__-toggle" onclick="return toggle('Addr.__le__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__le__">__le__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__le__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__le__-expanded"><a name="L422"></a><tt class="py-lineno"> 422</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L423"></a><tt class="py-lineno"> 423</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this network address instance has a lower or</tt> </tt> -<a name="L424"></a><tt class="py-lineno"> 424</tt> <tt class="py-line"><tt class="py-docstring"> equivalent numerical value than another, C{False} otherwise.</tt> </tt> -<a name="L425"></a><tt class="py-lineno"> 425</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L426"></a><tt class="py-lineno"> 426</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L427"></a><tt class="py-lineno"> 427</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-189" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-211', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-212" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-212', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L401"></a><tt class="py-lineno"> 401</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L402"></a><tt class="py-lineno"> 402</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L403"></a><tt class="py-lineno"> 403</tt> <tt class="py-line"> </tt> +<a name="Addr.__lt__"></a><div id="Addr.__lt__-def"><a name="L404"></a><tt class="py-lineno"> 404</tt> <a class="py-toggle" href="#" id="Addr.__lt__-toggle" onclick="return toggle('Addr.__lt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__lt__">__lt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__lt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__lt__-expanded"><a name="L405"></a><tt class="py-lineno"> 405</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L406"></a><tt class="py-lineno"> 406</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is numerically lower in value than</tt> </tt> +<a name="L407"></a><tt class="py-lineno"> 407</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> +<a name="L408"></a><tt class="py-lineno"> 408</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L409"></a><tt class="py-lineno"> 409</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L410"></a><tt class="py-lineno"> 410</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-213" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-189', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-190" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-190', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-191" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-213', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-214" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-214', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op"><</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-215" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-191', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-192" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-192', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L428"></a><tt class="py-lineno"> 428</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L429"></a><tt class="py-lineno"> 429</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L430"></a><tt class="py-lineno"> 430</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L431"></a><tt class="py-lineno"> 431</tt> <tt class="py-line"> </tt> -<a name="L432"></a><tt class="py-lineno"> 432</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L433"></a><tt class="py-lineno"> 433</tt> <tt class="py-line"> </tt> -<a name="Addr.__gt__"></a><div id="Addr.__gt__-def"><a name="L434"></a><tt class="py-lineno"> 434</tt> <a class="py-toggle" href="#" id="Addr.__gt__-toggle" onclick="return toggle('Addr.__gt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__gt__">__gt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__gt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__gt__-expanded"><a name="L435"></a><tt class="py-lineno"> 435</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L436"></a><tt class="py-lineno"> 436</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this network address instance has a higher</tt> </tt> -<a name="L437"></a><tt class="py-lineno"> 437</tt> <tt class="py-line"><tt class="py-docstring"> numerical value than another, C{False} otherwise.</tt> </tt> -<a name="L438"></a><tt class="py-lineno"> 438</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L439"></a><tt class="py-lineno"> 439</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L440"></a><tt class="py-lineno"> 440</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-193" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-215', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-216" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-216', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L411"></a><tt class="py-lineno"> 411</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L412"></a><tt class="py-lineno"> 412</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L413"></a><tt class="py-lineno"> 413</tt> <tt class="py-line"> </tt> +<a name="Addr.__le__"></a><div id="Addr.__le__-def"><a name="L414"></a><tt class="py-lineno"> 414</tt> <a class="py-toggle" href="#" id="Addr.__le__-toggle" onclick="return toggle('Addr.__le__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__le__">__le__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__le__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__le__-expanded"><a name="L415"></a><tt class="py-lineno"> 415</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L416"></a><tt class="py-lineno"> 416</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is numerically lower or equal in</tt> </tt> +<a name="L417"></a><tt class="py-lineno"> 417</tt> <tt class="py-line"><tt class="py-docstring"> value to other, C{False} otherwise.</tt> </tt> +<a name="L418"></a><tt class="py-lineno"> 418</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L419"></a><tt class="py-lineno"> 419</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L420"></a><tt class="py-lineno"> 420</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-217" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-193', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-194" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-194', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-195" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-217', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-218" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-218', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-219" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-195', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-196" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-196', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L441"></a><tt class="py-lineno"> 441</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L442"></a><tt class="py-lineno"> 442</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L443"></a><tt class="py-lineno"> 443</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L444"></a><tt class="py-lineno"> 444</tt> <tt class="py-line"> </tt> -<a name="L445"></a><tt class="py-lineno"> 445</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L446"></a><tt class="py-lineno"> 446</tt> <tt class="py-line"> </tt> -<a name="Addr.__ge__"></a><div id="Addr.__ge__-def"><a name="L447"></a><tt class="py-lineno"> 447</tt> <a class="py-toggle" href="#" id="Addr.__ge__-toggle" onclick="return toggle('Addr.__ge__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__ge__">__ge__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Addr.__ge__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__ge__-expanded"><a name="L448"></a><tt class="py-lineno"> 448</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L449"></a><tt class="py-lineno"> 449</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this network address instance has a higher or</tt> </tt> -<a name="L450"></a><tt class="py-lineno"> 450</tt> <tt class="py-line"><tt class="py-docstring"> equivalent numerical value than another, C{False} otherwise.</tt> </tt> -<a name="L451"></a><tt class="py-lineno"> 451</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L452"></a><tt class="py-lineno"> 452</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L453"></a><tt class="py-lineno"> 453</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-197" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-219', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-220" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-220', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L421"></a><tt class="py-lineno"> 421</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L422"></a><tt class="py-lineno"> 422</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L423"></a><tt class="py-lineno"> 423</tt> <tt class="py-line"> </tt> +<a name="Addr.__gt__"></a><div id="Addr.__gt__-def"><a name="L424"></a><tt class="py-lineno"> 424</tt> <a class="py-toggle" href="#" id="Addr.__gt__-toggle" onclick="return toggle('Addr.__gt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__gt__">__gt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__gt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__gt__-expanded"><a name="L425"></a><tt class="py-lineno"> 425</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L426"></a><tt class="py-lineno"> 426</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is numerically greater in value than</tt> </tt> +<a name="L427"></a><tt class="py-lineno"> 427</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> +<a name="L428"></a><tt class="py-lineno"> 428</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L429"></a><tt class="py-lineno"> 429</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L430"></a><tt class="py-lineno"> 430</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-221" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-197', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-198" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-198', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">>=</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-199" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-221', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-222" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-222', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-223" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-199', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-200" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-200', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L454"></a><tt class="py-lineno"> 454</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L455"></a><tt class="py-lineno"> 455</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L456"></a><tt class="py-lineno"> 456</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L457"></a><tt class="py-lineno"> 457</tt> <tt class="py-line"> </tt> -<a name="L458"></a><tt class="py-lineno"> 458</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div></div><a name="L459"></a><tt class="py-lineno"> 459</tt> <tt class="py-line"> </tt> -<a name="L460"></a><tt class="py-lineno"> 460</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="EUI"></a><div id="EUI-def"><a name="L461"></a><tt class="py-lineno"> 461</tt> <a class="py-toggle" href="#" id="EUI-toggle" onclick="return toggle('EUI');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html">EUI</a><tt class="py-op">(</tt><tt class="py-base-class">Addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="EUI-expanded"><a name="L462"></a><tt class="py-lineno"> 462</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L463"></a><tt class="py-lineno"> 463</tt> <tt class="py-line"><tt class="py-docstring"> EUI objects represent IEEE Extended Unique Identifiers. Input parsing is</tt> </tt> -<a name="L464"></a><tt class="py-lineno"> 464</tt> <tt class="py-line"><tt class="py-docstring"> flexible, supporting EUI-48, EUI-64 and all MAC (Media Access Control)</tt> </tt> -<a name="L465"></a><tt class="py-lineno"> 465</tt> <tt class="py-line"><tt class="py-docstring"> address flavours.</tt> </tt> -<a name="L466"></a><tt class="py-lineno"> 466</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L467"></a><tt class="py-lineno"> 467</tt> <tt class="py-line"> <tt id="link-201" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-223', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-224" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-224', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L431"></a><tt class="py-lineno"> 431</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L432"></a><tt class="py-lineno"> 432</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L433"></a><tt class="py-lineno"> 433</tt> <tt class="py-line"> </tt> +<a name="Addr.__ge__"></a><div id="Addr.__ge__-def"><a name="L434"></a><tt class="py-lineno"> 434</tt> <a class="py-toggle" href="#" id="Addr.__ge__-toggle" onclick="return toggle('Addr.__ge__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__ge__">__ge__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__ge__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__ge__-expanded"><a name="L435"></a><tt class="py-lineno"> 435</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L436"></a><tt class="py-lineno"> 436</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is numerically greater or equal in</tt> </tt> +<a name="L437"></a><tt class="py-lineno"> 437</tt> <tt class="py-line"><tt class="py-docstring"> value to other, C{False} otherwise.</tt> </tt> +<a name="L438"></a><tt class="py-lineno"> 438</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L439"></a><tt class="py-lineno"> 439</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L440"></a><tt class="py-lineno"> 440</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-225" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-225', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-226" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-226', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> <tt class="py-op">>=</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-227" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-227', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-228" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-228', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L441"></a><tt class="py-lineno"> 441</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L442"></a><tt class="py-lineno"> 442</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="Addr.__or__"></a><div id="Addr.__or__-def"><a name="L443"></a><tt class="py-lineno"> 443</tt> <a class="py-toggle" href="#" id="Addr.__or__-toggle" onclick="return toggle('Addr.__or__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__or__">__or__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__or__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__or__-expanded"><a name="L444"></a><tt class="py-lineno"> 444</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L445"></a><tt class="py-lineno"> 445</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an integer or int-like object.</tt> </tt> +<a name="L446"></a><tt class="py-lineno"> 446</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L447"></a><tt class="py-lineno"> 447</tt> <tt class="py-line"><tt class="py-docstring"> @return: bitwise OR (x | y) of self.value with other.value.</tt> </tt> +<a name="L448"></a><tt class="py-lineno"> 448</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L449"></a><tt class="py-lineno"> 449</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-229" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-229', 'value', 'link-30');">value</a></tt> <tt class="py-op">|</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-230" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-230', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-231" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-231', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L450"></a><tt class="py-lineno"> 450</tt> <tt class="py-line"> </tt> +<a name="Addr.__and__"></a><div id="Addr.__and__-def"><a name="L451"></a><tt class="py-lineno"> 451</tt> <a class="py-toggle" href="#" id="Addr.__and__-toggle" onclick="return toggle('Addr.__and__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__and__">__and__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__and__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__and__-expanded"><a name="L452"></a><tt class="py-lineno"> 452</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L453"></a><tt class="py-lineno"> 453</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an integer or int-like object.</tt> </tt> +<a name="L454"></a><tt class="py-lineno"> 454</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L455"></a><tt class="py-lineno"> 455</tt> <tt class="py-line"><tt class="py-docstring"> @return: bitwise AND (x & y) of self.value with other.value.</tt> </tt> +<a name="L456"></a><tt class="py-lineno"> 456</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L457"></a><tt class="py-lineno"> 457</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-232" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-232', 'value', 'link-30');">value</a></tt> <tt class="py-op">|</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-233" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-233', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-234" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-234', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L458"></a><tt class="py-lineno"> 458</tt> <tt class="py-line"> </tt> +<a name="Addr.__xor__"></a><div id="Addr.__xor__-def"><a name="L459"></a><tt class="py-lineno"> 459</tt> <a class="py-toggle" href="#" id="Addr.__xor__-toggle" onclick="return toggle('Addr.__xor__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__xor__">__xor__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__xor__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__xor__-expanded"><a name="L460"></a><tt class="py-lineno"> 460</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L461"></a><tt class="py-lineno"> 461</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an integer or int-like object.</tt> </tt> +<a name="L462"></a><tt class="py-lineno"> 462</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L463"></a><tt class="py-lineno"> 463</tt> <tt class="py-line"><tt class="py-docstring"> @return: bitwise exclusive OR (x ^ y) of self.value with other.value.</tt> </tt> +<a name="L464"></a><tt class="py-lineno"> 464</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L465"></a><tt class="py-lineno"> 465</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-235" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-235', 'value', 'link-30');">value</a></tt> <tt class="py-op">^</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-236" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-236', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-237" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-237', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L466"></a><tt class="py-lineno"> 466</tt> <tt class="py-line"> </tt> +<a name="Addr.__lshift__"></a><div id="Addr.__lshift__-def"><a name="L467"></a><tt class="py-lineno"> 467</tt> <a class="py-toggle" href="#" id="Addr.__lshift__-toggle" onclick="return toggle('Addr.__lshift__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__lshift__">__lshift__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">numbits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__lshift__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__lshift__-expanded"><a name="L468"></a><tt class="py-lineno"> 468</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L469"></a><tt class="py-lineno"> 469</tt> <tt class="py-line"><tt class="py-docstring"> @param numbits: size of shift (in bits).</tt> </tt> +<a name="L470"></a><tt class="py-lineno"> 470</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L471"></a><tt class="py-lineno"> 471</tt> <tt class="py-line"><tt class="py-docstring"> @return: integer value of this IP address shifted left by x bits.</tt> </tt> +<a name="L472"></a><tt class="py-lineno"> 472</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L473"></a><tt class="py-lineno"> 473</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-238" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-238', 'value', 'link-30');">value</a></tt> <tt class="py-op"><<</tt> <tt class="py-name">numbits</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-239" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-239', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L474"></a><tt class="py-lineno"> 474</tt> <tt class="py-line"> </tt> +<a name="Addr.__rshift__"></a><div id="Addr.__rshift__-def"><a name="L475"></a><tt class="py-lineno"> 475</tt> <a class="py-toggle" href="#" id="Addr.__rshift__-toggle" onclick="return toggle('Addr.__rshift__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__rshift__">__rshift__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">numbits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__rshift__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__rshift__-expanded"><a name="L476"></a><tt class="py-lineno"> 476</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L477"></a><tt class="py-lineno"> 477</tt> <tt class="py-line"><tt class="py-docstring"> @param numbits: size of shift (in bits).</tt> </tt> +<a name="L478"></a><tt class="py-lineno"> 478</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L479"></a><tt class="py-lineno"> 479</tt> <tt class="py-line"><tt class="py-docstring"> @return: integer value of this IP address right shifted by x bits.</tt> </tt> +<a name="L480"></a><tt class="py-lineno"> 480</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L481"></a><tt class="py-lineno"> 481</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-240" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-240', 'value', 'link-30');">value</a></tt> <tt class="py-op">>></tt> <tt class="py-name">numbits</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-241" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-241', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L482"></a><tt class="py-lineno"> 482</tt> <tt class="py-line"> </tt> +<a name="Addr.__invert__"></a><div id="Addr.__invert__-def"><a name="L483"></a><tt class="py-lineno"> 483</tt> <a class="py-toggle" href="#" id="Addr.__invert__-toggle" onclick="return toggle('Addr.__invert__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Addr-class.html#__invert__">__invert__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Addr.__invert__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Addr.__invert__-expanded"><a name="L484"></a><tt class="py-lineno"> 484</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L485"></a><tt class="py-lineno"> 485</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an integer or int-like object.</tt> </tt> +<a name="L486"></a><tt class="py-lineno"> 486</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L487"></a><tt class="py-lineno"> 487</tt> <tt class="py-line"><tt class="py-docstring"> @return: inversion (~x) of self.value.</tt> </tt> +<a name="L488"></a><tt class="py-lineno"> 488</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L489"></a><tt class="py-lineno"> 489</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-op">~</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-242" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-242', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L490"></a><tt class="py-lineno"> 490</tt> <tt class="py-line"> </tt> +<a name="L491"></a><tt class="py-lineno"> 491</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="EUI"></a><div id="EUI-def"><a name="L492"></a><tt class="py-lineno"> 492</tt> <a class="py-toggle" href="#" id="EUI-toggle" onclick="return toggle('EUI');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html">EUI</a><tt class="py-op">(</tt><tt class="py-base-class">Addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="EUI-expanded"><a name="L493"></a><tt class="py-lineno"> 493</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L494"></a><tt class="py-lineno"> 494</tt> <tt class="py-line"><tt class="py-docstring"> Represents an IEEE EUI (Extended Unique Identifier) indentifier.</tt> </tt> +<a name="L495"></a><tt class="py-lineno"> 495</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L496"></a><tt class="py-lineno"> 496</tt> <tt class="py-line"><tt class="py-docstring"> Input parser is flexible, supporting EUI-48 (including the many Media</tt> </tt> +<a name="L497"></a><tt class="py-lineno"> 497</tt> <tt class="py-line"><tt class="py-docstring"> Access Control variants) and EUI-64.</tt> </tt> +<a name="L498"></a><tt class="py-lineno"> 498</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L499"></a><tt class="py-lineno"> 499</tt> <tt class="py-line"> <tt id="link-243" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-201', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-202" class="py-name"><a title="netaddr.ST_EUI48 -netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-202', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">,</tt> <tt id="link-203" class="py-name"><a title="netaddr.ST_EUI64 -netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-203', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">)</tt> </tt> -<a name="L468"></a><tt class="py-lineno"> 468</tt> <tt class="py-line"> <tt id="link-204" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-243', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-244" class="py-name"><a title="netaddr.ST_EUI48 +netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-244', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">,</tt> <tt id="link-245" class="py-name"><a title="netaddr.ST_EUI64 +netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-245', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">)</tt> </tt> +<a name="L500"></a><tt class="py-lineno"> 500</tt> <tt class="py-line"> <tt id="link-246" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-204', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-205" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-205', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-206" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-206', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-207" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-207', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt><tt class="py-op">)</tt> </tt> -<a name="L469"></a><tt class="py-lineno"> 469</tt> <tt class="py-line"> </tt> -<a name="L470"></a><tt class="py-lineno"> 470</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> -<a name="L471"></a><tt class="py-lineno"> 471</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-208" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-246', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-247" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-247', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-248" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-248', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-249" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-249', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt><tt class="py-op">)</tt> </tt> +<a name="L501"></a><tt class="py-lineno"> 501</tt> <tt class="py-line"> </tt> +<a name="L502"></a><tt class="py-lineno"> 502</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> +<a name="L503"></a><tt class="py-lineno"> 503</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-250" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-208', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-209" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-209', 'StrategyDescriptor', 'link-123');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-210" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-250', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-251" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-251', 'StrategyDescriptor', 'link-142');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-252" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-210', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L472"></a><tt class="py-lineno"> 472</tt> <tt class="py-line"> <tt id="link-211" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-252', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L504"></a><tt class="py-lineno"> 504</tt> <tt class="py-line"> <tt id="link-253" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-211', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-212" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-212', 'AddrTypeDescriptor', 'link-126');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-213" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-253', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-254" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-254', 'AddrTypeDescriptor', 'link-145');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-255" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-213', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L473"></a><tt class="py-lineno"> 473</tt> <tt class="py-line"> </tt> -<a name="EUI.__init__"></a><div id="EUI.__init__-def"><a name="L474"></a><tt class="py-lineno"> 474</tt> <a class="py-toggle" href="#" id="EUI.__init__-toggle" onclick="return toggle('EUI.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">,</tt> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-214" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-214', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.__init__-expanded"><a name="L475"></a><tt class="py-lineno"> 475</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L476"></a><tt class="py-lineno"> 476</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L477"></a><tt class="py-lineno"> 477</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L478"></a><tt class="py-lineno"> 478</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: an EUI/MAC address string or a network byte order</tt> </tt> -<a name="L479"></a><tt class="py-lineno"> 479</tt> <tt class="py-line"><tt class="py-docstring"> integer.</tt> </tt> -<a name="L480"></a><tt class="py-lineno"> 480</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L481"></a><tt class="py-lineno"> 481</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_type: (optional) the specific EUI address type (C{AT_LINK}</tt> </tt> -<a name="L482"></a><tt class="py-lineno"> 482</tt> <tt class="py-line"><tt class="py-docstring"> or C{AT_EUI64}). If addr is an integer, this argument is mandatory.</tt> </tt> -<a name="L483"></a><tt class="py-lineno"> 483</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L484"></a><tt class="py-lineno"> 484</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-215" class="py-name" targets="Class netaddr.address.EUI=netaddr.address.EUI-class.html"><a title="netaddr.address.EUI" class="py-name" href="#" onclick="return doclink('link-215', 'EUI', 'link-215');">EUI</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-216" class="py-name" targets="Method netaddr.address.Addr.__init__()=netaddr.address.Addr-class.html#__init__,Method netaddr.address.AddrRange.__init__()=netaddr.address.AddrRange-class.html#__init__,Method netaddr.address.AddrTypeDescriptor.__init__()=netaddr.address.AddrTypeDescriptor-class.html#__init__,Method netaddr.address.AddrValueDescriptor.__init__()=netaddr.address.AddrValueDescriptor-class.html#__init__,Method netaddr.address.CIDR.__init__()=netaddr.address.CIDR-class.html#__init__,Method netaddr.address.EUI.__init__()=netaddr.address.EUI-class.html#__init__,Method netaddr.address.IP.__init__()=netaddr.address.IP-class.html#__init__,Method netaddr.address.KlassDescriptor.__init__()=netaddr.address.KlassDescriptor-class.html#__init__,Method netaddr.address.PrefixLenDescriptor.__init__()=netaddr.address.PrefixLenDescriptor-class.html#__init__,Method netaddr.address.StrategyDescriptor.__init__()=netaddr.address.StrategyDescriptor-class.html#__init__,Method netaddr.address.Wildcard.__init__()=netaddr.address.Wildcard-class.html#__init__,Method netaddr.strategy.AddrStrategy.__init__()=netaddr.strategy.AddrStrategy-class.html#__init__,Method netaddr.strategy.EUI48Strategy.__init__()=netaddr.strategy.EUI48Strategy-class.html#__init__,Method netaddr.strategy.IPv4StrategyOpt.__init__()=netaddr.strategy.IPv4StrategyOpt-class.html#__init__,Method netaddr.strategy.IPv4StrategyStd.__init__()=netaddr.strategy.IPv4StrategyStd-class.html#__init__,Method netaddr.strategy.IPv6Strategy.__init__()=netaddr.strategy.IPv6Strategy-class.html#__init__"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-255', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L505"></a><tt class="py-lineno"> 505</tt> <tt class="py-line"> </tt> +<a name="EUI.__init__"></a><div id="EUI.__init__-def"><a name="L506"></a><tt class="py-lineno"> 506</tt> <a class="py-toggle" href="#" id="EUI.__init__-toggle" onclick="return toggle('EUI.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">,</tt> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-256" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-256', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.__init__-expanded"><a name="L507"></a><tt class="py-lineno"> 507</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L508"></a><tt class="py-lineno"> 508</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L509"></a><tt class="py-lineno"> 509</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L510"></a><tt class="py-lineno"> 510</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: an EUI-48 (MAC) or EUI-64 address string or a network</tt> </tt> +<a name="L511"></a><tt class="py-lineno"> 511</tt> <tt class="py-line"><tt class="py-docstring"> byte order integer.</tt> </tt> +<a name="L512"></a><tt class="py-lineno"> 512</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L513"></a><tt class="py-lineno"> 513</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_type: (optional) the specific EUI address type (C{AT_LINK}</tt> </tt> +<a name="L514"></a><tt class="py-lineno"> 514</tt> <tt class="py-line"><tt class="py-docstring"> or C{AT_EUI64}). If addr is an integer, this argument is mandatory.</tt> </tt> +<a name="L515"></a><tt class="py-lineno"> 515</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L516"></a><tt class="py-lineno"> 516</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-257" class="py-name" targets="Class netaddr.address.EUI=netaddr.address.EUI-class.html"><a title="netaddr.address.EUI" class="py-name" href="#" onclick="return doclink('link-257', 'EUI', 'link-257');">EUI</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-258" class="py-name" targets="Method netaddr.address.Addr.__init__()=netaddr.address.Addr-class.html#__init__,Method netaddr.address.AddrTypeDescriptor.__init__()=netaddr.address.AddrTypeDescriptor-class.html#__init__,Method netaddr.address.AddrValueDescriptor.__init__()=netaddr.address.AddrValueDescriptor-class.html#__init__,Method netaddr.address.CIDR.__init__()=netaddr.address.CIDR-class.html#__init__,Method netaddr.address.EUI.__init__()=netaddr.address.EUI-class.html#__init__,Method netaddr.address.FormatDescriptor.__init__()=netaddr.address.FormatDescriptor-class.html#__init__,Method netaddr.address.IP.__init__()=netaddr.address.IP-class.html#__init__,Method netaddr.address.IPRange.__init__()=netaddr.address.IPRange-class.html#__init__,Method netaddr.address.IPRangeSet.__init__()=netaddr.address.IPRangeSet-class.html#__init__,Method netaddr.address.PrefixLenDescriptor.__init__()=netaddr.address.PrefixLenDescriptor-class.html#__init__,Method netaddr.address.StrategyDescriptor.__init__()=netaddr.address.StrategyDescriptor-class.html#__init__,Method netaddr.address.Wildcard.__init__()=netaddr.address.Wildcard-class.html#__init__,Method netaddr.core.PrettyPrinter.__init__()=netaddr.core.PrettyPrinter-class.html#__init__,Method netaddr.core.Publisher.__init__()=netaddr.core.Publisher-class.html#__init__,Method netaddr.eui.FileIndexer.__init__()=netaddr.eui.FileIndexer-class.html#__init__,Method netaddr.eui.IAB.__init__()=netaddr.eui.IAB-class.html#__init__,Method netaddr.eui.IABIndexParser.__init__()=netaddr.eui.IABIndexParser-class.html#__init__,Method netaddr.eui.OUI.__init__()=netaddr.eui.OUI-class.html#__init__,Method netaddr.eui.OUIIndexParser.__init__()=netaddr.eui.OUIIndexParser-class.html#__init__,Method netaddr.ip.DictUpdater.__init__()=netaddr.ip.DictUpdater-class.html#__init__,Method netaddr.ip.IPv4Parser.__init__()=netaddr.ip.IPv4Parser-class.html#__init__,Method netaddr.ip.IPv6Parser.__init__()=netaddr.ip.IPv6Parser-class.html#__init__,Method netaddr.ip.LineRecordParser.__init__()=netaddr.ip.LineRecordParser-class.html#__init__,Method netaddr.ip.MulticastParser.__init__()=netaddr.ip.MulticastParser-class.html#__init__,Method netaddr.strategy.AddrStrategy.__init__()=netaddr.strategy.AddrStrategy-class.html#__init__,Method netaddr.strategy.EUI48Strategy.__init__()=netaddr.strategy.EUI48Strategy-class.html#__init__,Method netaddr.strategy.IPv4StrategyOpt.__init__()=netaddr.strategy.IPv4StrategyOpt-class.html#__init__,Method netaddr.strategy.IPv4StrategyStd.__init__()=netaddr.strategy.IPv4StrategyStd-class.html#__init__,Method netaddr.strategy.IPv6Strategy.__init__()=netaddr.strategy.IPv6Strategy-class.html#__init__"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-216', '__init__', 'link-216');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-217" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-217', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L485"></a><tt class="py-lineno"> 485</tt> <tt class="py-line"> </tt> -<a name="EUI.oui"></a><div id="EUI.oui-def"><a name="L486"></a><tt class="py-lineno"> 486</tt> <a class="py-toggle" href="#" id="EUI.oui-toggle" onclick="return toggle('EUI.oui');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#oui">oui</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI.oui-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.oui-expanded"><a name="L487"></a><tt class="py-lineno"> 487</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L488"></a><tt class="py-lineno"> 488</tt> <tt class="py-line"><tt class="py-docstring"> @return: The OUI (Organisationally Unique Identifier) for this EUI.</tt> </tt> -<a name="L489"></a><tt class="py-lineno"> 489</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L490"></a><tt class="py-lineno"> 490</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -</div><a name="L491"></a><tt class="py-lineno"> 491</tt> <tt class="py-line"> </tt> -<a name="EUI.ei"></a><div id="EUI.ei-def"><a name="L492"></a><tt class="py-lineno"> 492</tt> <a class="py-toggle" href="#" id="EUI.ei-toggle" onclick="return toggle('EUI.ei');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#ei">ei</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI.ei-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.ei-expanded"><a name="L493"></a><tt class="py-lineno"> 493</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L494"></a><tt class="py-lineno"> 494</tt> <tt class="py-line"><tt class="py-docstring"> @return: The EI (Extension Identifier) for this EUI.</tt> </tt> -<a name="L495"></a><tt class="py-lineno"> 495</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L496"></a><tt class="py-lineno"> 496</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-218" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-218', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">==</tt> <tt id="link-219" class="py-name"><a title="netaddr.ST_EUI48 -netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-219', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">:</tt> </tt> -<a name="L497"></a><tt class="py-lineno"> 497</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L498"></a><tt class="py-lineno"> 498</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-220" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-220', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">==</tt> <tt id="link-221" class="py-name"><a title="netaddr.ST_EUI64 -netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-221', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">:</tt> </tt> -<a name="L499"></a><tt class="py-lineno"> 499</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">8</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -</div><a name="L500"></a><tt class="py-lineno"> 500</tt> <tt class="py-line"> </tt> -<a name="EUI.eui64"></a><div id="EUI.eui64-def"><a name="L501"></a><tt class="py-lineno"> 501</tt> <a class="py-toggle" href="#" id="EUI.eui64-toggle" onclick="return toggle('EUI.eui64');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#eui64">eui64</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI.eui64-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.eui64-expanded"><a name="L502"></a><tt class="py-lineno"> 502</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L503"></a><tt class="py-lineno"> 503</tt> <tt class="py-line"><tt class="py-docstring"> @return: The value of this EUI object as a new 64-bit EUI object.</tt> </tt> -<a name="L504"></a><tt class="py-lineno"> 504</tt> <tt class="py-line"><tt class="py-docstring"> - If this object represents an EUI-48 it is converted to EUI-64 as</tt> </tt> -<a name="L505"></a><tt class="py-lineno"> 505</tt> <tt class="py-line"><tt class="py-docstring"> per the standard.</tt> </tt> -<a name="L506"></a><tt class="py-lineno"> 506</tt> <tt class="py-line"><tt class="py-docstring"> - If this object is already and EUI-64, it just returns a new,</tt> </tt> -<a name="L507"></a><tt class="py-lineno"> 507</tt> <tt class="py-line"><tt class="py-docstring"> numerically equivalent object is returned instead.</tt> </tt> -<a name="L508"></a><tt class="py-lineno"> 508</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L509"></a><tt class="py-lineno"> 509</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-222" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-222', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-223" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-223', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">:</tt> </tt> -<a name="L510"></a><tt class="py-lineno"> 510</tt> <tt class="py-line"> <tt class="py-name">eui64_words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'ff'</tt><tt class="py-op">,</tt> <tt class="py-string">'fe'</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> \ </tt> -<a name="L511"></a><tt class="py-lineno"> 511</tt> <tt class="py-line"> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> -<a name="L512"></a><tt class="py-lineno"> 512</tt> <tt class="py-line"> </tt> -<a name="L513"></a><tt class="py-lineno"> 513</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">eui64_words</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L514"></a><tt class="py-lineno"> 514</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L515"></a><tt class="py-lineno"> 515</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-224" class="py-name"><a title="netaddr.address.EUI" class="py-name" href="#" onclick="return doclink('link-224', 'EUI', 'link-215');">EUI</a></tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L516"></a><tt class="py-lineno"> 516</tt> <tt class="py-line"> </tt> -<a name="EUI.ipv6_link_local"></a><div id="EUI.ipv6_link_local-def"><a name="L517"></a><tt class="py-lineno"> 517</tt> <a class="py-toggle" href="#" id="EUI.ipv6_link_local-toggle" onclick="return toggle('EUI.ipv6_link_local');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#ipv6_link_local">ipv6_link_local</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI.ipv6_link_local-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.ipv6_link_local-expanded"><a name="L518"></a><tt class="py-lineno"> 518</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L519"></a><tt class="py-lineno"> 519</tt> <tt class="py-line"><tt class="py-docstring"> @return: An IPv6 L{IP} object initialised using the value of this</tt> </tt> -<a name="L520"></a><tt class="py-lineno"> 520</tt> <tt class="py-line"><tt class="py-docstring"> L{EUI}.</tt> </tt> -<a name="L521"></a><tt class="py-lineno"> 521</tt> <tt class="py-line"><tt class="py-docstring"> - B{See RFC 4921 for details}.</tt> </tt> -<a name="L522"></a><tt class="py-lineno"> 522</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L523"></a><tt class="py-lineno"> 523</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-string">'fe80:0000:0000:0000:'</tt> </tt> -<a name="L524"></a><tt class="py-lineno"> 524</tt> <tt class="py-line"> </tt> -<a name="L525"></a><tt class="py-lineno"> 525</tt> <tt class="py-line"> <tt class="py-comment"># Add 2 to the first octet of this EUI address (temporarily).</tt> </tt> -<a name="L526"></a><tt class="py-lineno"> 526</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">+=</tt> <tt class="py-number">2</tt> </tt> -<a name="L527"></a><tt class="py-lineno"> 527</tt> <tt class="py-line"> </tt> -<a name="L528"></a><tt class="py-lineno"> 528</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-225" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-225', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-226" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-226', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">:</tt> </tt> -<a name="L529"></a><tt class="py-lineno"> 529</tt> <tt class="py-line"> <tt class="py-comment"># Modify MAC to make it an EUI-64.</tt> </tt> -<a name="L530"></a><tt class="py-lineno"> 530</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'ff'</tt><tt class="py-op">,</tt> <tt class="py-string">'fe'</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> \ </tt> -<a name="L531"></a><tt class="py-lineno"> 531</tt> <tt class="py-line"> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> -<a name="L532"></a><tt class="py-lineno"> 532</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L533"></a><tt class="py-lineno"> 533</tt> <tt class="py-line"> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L534"></a><tt class="py-lineno"> 534</tt> <tt class="py-line"> </tt> -<a name="L535"></a><tt class="py-lineno"> 535</tt> <tt class="py-line"> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x%02x"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">x</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">x</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">x</tt> <tt class="py-keyword">in</tt> \ </tt> -<a name="L536"></a><tt class="py-lineno"> 536</tt> <tt class="py-line"> <tt class="py-name">zip</tt><tt class="py-op">(</tt><tt class="py-name">suffix</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">suffix</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">:</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L537"></a><tt class="py-lineno"> 537</tt> <tt class="py-line"> </tt> -<a name="L538"></a><tt class="py-lineno"> 538</tt> <tt class="py-line"> <tt class="py-comment"># Subtract 2 again to return EUI to its original value.</tt> </tt> -<a name="L539"></a><tt class="py-lineno"> 539</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">-=</tt> <tt class="py-number">2</tt> </tt> -<a name="L540"></a><tt class="py-lineno"> 540</tt> <tt class="py-line"> </tt> -<a name="L541"></a><tt class="py-lineno"> 541</tt> <tt class="py-line"> <tt id="link-227" class="py-name" targets="Method netaddr.address.EUI.eui64()=netaddr.address.EUI-class.html#eui64"><a title="netaddr.address.EUI.eui64" class="py-name" href="#" onclick="return doclink('link-227', 'eui64', 'link-227');">eui64</a></tt> <tt class="py-op">=</tt> <tt class="py-string">':'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">suffix</tt><tt class="py-op">)</tt> </tt> -<a name="L542"></a><tt class="py-lineno"> 542</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">prefix</tt> <tt class="py-op">+</tt> <tt id="link-228" class="py-name"><a title="netaddr.address.EUI.eui64" class="py-name" href="#" onclick="return doclink('link-228', 'eui64', 'link-227');">eui64</a></tt> </tt> -<a name="L543"></a><tt class="py-lineno"> 543</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-229" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-229', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L544"></a><tt class="py-lineno"> 544</tt> <tt class="py-line"> </tt> -<a name="L545"></a><tt class="py-lineno"> 545</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="IP"></a><div id="IP-def"><a name="L546"></a><tt class="py-lineno"> 546</tt> <a class="py-toggle" href="#" id="IP-toggle" onclick="return toggle('IP');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.IP-class.html">IP</a><tt class="py-op">(</tt><tt class="py-base-class">Addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="IP-expanded"><a name="L547"></a><tt class="py-lineno"> 547</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L548"></a><tt class="py-lineno"> 548</tt> <tt class="py-line"><tt class="py-docstring"> A class whose objects represent Internet Protocol network addresses. Both</tt> </tt> -<a name="L549"></a><tt class="py-lineno"> 549</tt> <tt class="py-line"><tt class="py-docstring"> IPv4 and IPv6 are fully supported and also permit the inclusion of bitmask</tt> </tt> -<a name="L550"></a><tt class="py-lineno"> 550</tt> <tt class="py-line"><tt class="py-docstring"> prefix or subnet mask address indicating the size/extent of the subnet,</tt> </tt> -<a name="L551"></a><tt class="py-lineno"> 551</tt> <tt class="py-line"><tt class="py-docstring"> for example ::</tt> </tt> -<a name="L552"></a><tt class="py-lineno"> 552</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L553"></a><tt class="py-lineno"> 553</tt> <tt class="py-line"><tt class="py-docstring"> IPv4</tt> </tt> -<a name="L554"></a><tt class="py-lineno"> 554</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L555"></a><tt class="py-lineno"> 555</tt> <tt class="py-line"><tt class="py-docstring"> 192.168.0.1/24</tt> </tt> -<a name="L556"></a><tt class="py-lineno"> 556</tt> <tt class="py-line"><tt class="py-docstring"> 192.168.0.1/255.255.255.0</tt> </tt> -<a name="L557"></a><tt class="py-lineno"> 557</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L558"></a><tt class="py-lineno"> 558</tt> <tt class="py-line"><tt class="py-docstring"> IPv6</tt> </tt> -<a name="L559"></a><tt class="py-lineno"> 559</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L560"></a><tt class="py-lineno"> 560</tt> <tt class="py-line"><tt class="py-docstring"> fe80::20f:1fff:fe12:e733/64</tt> </tt> -<a name="L561"></a><tt class="py-lineno"> 561</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L562"></a><tt class="py-lineno"> 562</tt> <tt class="py-line"> <tt id="link-230" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-258', '__init__', 'link-258');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-259" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-259', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L517"></a><tt class="py-lineno"> 517</tt> <tt class="py-line"> </tt> +<a name="EUI.oui"></a><div id="EUI.oui-def"><a name="L518"></a><tt class="py-lineno"> 518</tt> <a class="py-toggle" href="#" id="EUI.oui-toggle" onclick="return toggle('EUI.oui');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#oui">oui</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt id="link-260" class="py-name"><a title="netaddr.eui.OUI" class="py-name" href="#" onclick="return doclink('link-260', 'OUI', 'link-18');">OUI</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.oui-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.oui-expanded"><a name="L519"></a><tt class="py-lineno"> 519</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L520"></a><tt class="py-lineno"> 520</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: callable used on return values. Default: L{OUI} object.</tt> </tt> +<a name="L521"></a><tt class="py-lineno"> 521</tt> <tt class="py-line"><tt class="py-docstring"> Also Supports str(), unicode(), int() and long().</tt> </tt> +<a name="L522"></a><tt class="py-lineno"> 522</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L523"></a><tt class="py-lineno"> 523</tt> <tt class="py-line"><tt class="py-docstring"> @return: The OUI (Organisationally Unique Identifier) for this EUI.</tt> </tt> +<a name="L524"></a><tt class="py-lineno"> 524</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L525"></a><tt class="py-lineno"> 525</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">callable</tt><tt class="py-op">(</tt><tt id="link-261" class="py-name" targets="Variable netaddr.address.CIDR.fmt=netaddr.address.CIDR-class.html#fmt,Variable netaddr.address.IPRange.fmt=netaddr.address.IPRange-class.html#fmt,Variable netaddr.address.Wildcard.fmt=netaddr.address.Wildcard-class.html#fmt"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-261', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt id="link-262" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-262', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt id="link-263" class="py-name"><a title="netaddr.eui.OUI" class="py-name" href="#" onclick="return doclink('link-263', 'OUI', 'link-18');">OUI</a></tt><tt class="py-op">,</tt> <tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L526"></a><tt class="py-lineno"> 526</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-264" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-264', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-265" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-265', 'value', 'link-30');">value</a></tt> <tt class="py-op">>></tt> <tt class="py-number">24</tt><tt class="py-op">)</tt> </tt> +<a name="L527"></a><tt class="py-lineno"> 527</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">callable</tt><tt class="py-op">(</tt><tt id="link-266" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-266', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt id="link-267" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-267', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L528"></a><tt class="py-lineno"> 528</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L529"></a><tt class="py-lineno"> 529</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L530"></a><tt class="py-lineno"> 530</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">"unsupported formatter callable: %r!"</tt> <tt class="py-op">%</tt> <tt id="link-268" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-268', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L531"></a><tt class="py-lineno"> 531</tt> <tt class="py-line"> </tt> +<a name="EUI.ei"></a><div id="EUI.ei-def"><a name="L532"></a><tt class="py-lineno"> 532</tt> <a class="py-toggle" href="#" id="EUI.ei-toggle" onclick="return toggle('EUI.ei');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#ei">ei</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.ei-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.ei-expanded"><a name="L533"></a><tt class="py-lineno"> 533</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: The EI (Extension Identifier) for this EUI"""</tt> </tt> +<a name="L534"></a><tt class="py-lineno"> 534</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-269" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-269', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">==</tt> <tt id="link-270" class="py-name"><a title="netaddr.ST_EUI48 +netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-270', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">:</tt> </tt> +<a name="L535"></a><tt class="py-lineno"> 535</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L536"></a><tt class="py-lineno"> 536</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-271" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-271', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">==</tt> <tt id="link-272" class="py-name"><a title="netaddr.ST_EUI64 +netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-272', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">:</tt> </tt> +<a name="L537"></a><tt class="py-lineno"> 537</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">8</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L538"></a><tt class="py-lineno"> 538</tt> <tt class="py-line"> </tt> +<a name="EUI.isiab"></a><div id="EUI.isiab-def"><a name="L539"></a><tt class="py-lineno"> 539</tt> <a class="py-toggle" href="#" id="EUI.isiab-toggle" onclick="return toggle('EUI.isiab');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#isiab">isiab</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.isiab-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.isiab-expanded"><a name="L540"></a><tt class="py-lineno"> 540</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: True if this EUI is an IAB address, False otherwise"""</tt> </tt> +<a name="L541"></a><tt class="py-lineno"> 541</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">0x50c2000</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-273" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-273', 'value', 'link-30');">value</a></tt> <tt class="py-op">>></tt> <tt class="py-number">12</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-number">0x50c2fff</tt> </tt> +</div><a name="L542"></a><tt class="py-lineno"> 542</tt> <tt class="py-line"> </tt> +<a name="EUI.iab"></a><div id="EUI.iab-def"><a name="L543"></a><tt class="py-lineno"> 543</tt> <a class="py-toggle" href="#" id="EUI.iab-toggle" onclick="return toggle('EUI.iab');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#iab">iab</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt id="link-274" class="py-name"><a title="netaddr.eui.IAB" class="py-name" href="#" onclick="return doclink('link-274', 'IAB', 'link-19');">IAB</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.iab-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.iab-expanded"><a name="L544"></a><tt class="py-lineno"> 544</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L545"></a><tt class="py-lineno"> 545</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: callable used on return values. Default: L{IAB} object.</tt> </tt> +<a name="L546"></a><tt class="py-lineno"> 546</tt> <tt class="py-line"><tt class="py-docstring"> Also Supports str(), unicode(), int() and long().</tt> </tt> +<a name="L547"></a><tt class="py-lineno"> 547</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L548"></a><tt class="py-lineno"> 548</tt> <tt class="py-line"><tt class="py-docstring"> @return: If isiab() is True, the IAB (Individual Address Block)</tt> </tt> +<a name="L549"></a><tt class="py-lineno"> 549</tt> <tt class="py-line"><tt class="py-docstring"> is returned, None otherwise.</tt> </tt> +<a name="L550"></a><tt class="py-lineno"> 550</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L551"></a><tt class="py-lineno"> 551</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-275" class="py-name" targets="Method netaddr.address.EUI.isiab()=netaddr.address.EUI-class.html#isiab"><a title="netaddr.address.EUI.isiab" class="py-name" href="#" onclick="return doclink('link-275', 'isiab', 'link-275');">isiab</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L552"></a><tt class="py-lineno"> 552</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">callable</tt><tt class="py-op">(</tt><tt id="link-276" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-276', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt id="link-277" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-277', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt id="link-278" class="py-name"><a title="netaddr.eui.IAB" class="py-name" href="#" onclick="return doclink('link-278', 'IAB', 'link-19');">IAB</a></tt><tt class="py-op">,</tt> <tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L553"></a><tt class="py-lineno"> 553</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-279" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-279', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-280" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-280', 'value', 'link-30');">value</a></tt> <tt class="py-op">>></tt> <tt class="py-number">12</tt><tt class="py-op">)</tt> </tt> +<a name="L554"></a><tt class="py-lineno"> 554</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">callable</tt><tt class="py-op">(</tt><tt id="link-281" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-281', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt id="link-282" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-282', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">,</tt> <tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L555"></a><tt class="py-lineno"> 555</tt> <tt class="py-line"> <tt class="py-name">usermask</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-283" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-283', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-number">36</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L556"></a><tt class="py-lineno"> 556</tt> <tt class="py-line"> <tt class="py-name">last_eui</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-284" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-284', 'value', 'link-30');">value</a></tt> <tt class="py-op">|</tt> <tt class="py-name">usermask</tt> </tt> +<a name="L557"></a><tt class="py-lineno"> 557</tt> <tt class="py-line"> <tt class="py-name">first_eui</tt> <tt class="py-op">=</tt> <tt class="py-name">last_eui</tt> <tt class="py-op">-</tt> <tt class="py-name">usermask</tt> </tt> +<a name="L558"></a><tt class="py-lineno"> 558</tt> <tt class="py-line"> <tt class="py-name">iab_words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-285" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-285', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-286" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-286', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">first_eui</tt><tt class="py-op">)</tt> </tt> +<a name="L559"></a><tt class="py-lineno"> 559</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">iab_words</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L560"></a><tt class="py-lineno"> 560</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L561"></a><tt class="py-lineno"> 561</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">"unsupported formatter callable: %r!"</tt> <tt class="py-op">%</tt> <tt id="link-287" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-287', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L562"></a><tt class="py-lineno"> 562</tt> <tt class="py-line"> </tt> +<a name="EUI.eui64"></a><div id="EUI.eui64-def"><a name="L563"></a><tt class="py-lineno"> 563</tt> <a class="py-toggle" href="#" id="EUI.eui64-toggle" onclick="return toggle('EUI.eui64');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#eui64">eui64</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.eui64-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.eui64-expanded"><a name="L564"></a><tt class="py-lineno"> 564</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L565"></a><tt class="py-lineno"> 565</tt> <tt class="py-line"><tt class="py-docstring"> @return: The value of this EUI object as a new 64-bit EUI object.</tt> </tt> +<a name="L566"></a><tt class="py-lineno"> 566</tt> <tt class="py-line"><tt class="py-docstring"> - If this object represents an EUI-48 it is converted to EUI-64</tt> </tt> +<a name="L567"></a><tt class="py-lineno"> 567</tt> <tt class="py-line"><tt class="py-docstring"> as per the standard.</tt> </tt> +<a name="L568"></a><tt class="py-lineno"> 568</tt> <tt class="py-line"><tt class="py-docstring"> - If this object is already and EUI-64, it just returns a new,</tt> </tt> +<a name="L569"></a><tt class="py-lineno"> 569</tt> <tt class="py-line"><tt class="py-docstring"> numerically equivalent object is returned instead.</tt> </tt> +<a name="L570"></a><tt class="py-lineno"> 570</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L571"></a><tt class="py-lineno"> 571</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-288" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-288', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-289" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-289', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">:</tt> </tt> +<a name="L572"></a><tt class="py-lineno"> 572</tt> <tt class="py-line"> <tt class="py-name">eui64_words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'ff'</tt><tt class="py-op">,</tt> <tt class="py-string">'fe'</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> \ </tt> +<a name="L573"></a><tt class="py-lineno"> 573</tt> <tt class="py-line"> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> +<a name="L574"></a><tt class="py-lineno"> 574</tt> <tt class="py-line"> </tt> +<a name="L575"></a><tt class="py-lineno"> 575</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">eui64_words</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L576"></a><tt class="py-lineno"> 576</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L577"></a><tt class="py-lineno"> 577</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-290" class="py-name"><a title="netaddr.address.EUI" class="py-name" href="#" onclick="return doclink('link-290', 'EUI', 'link-257');">EUI</a></tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L578"></a><tt class="py-lineno"> 578</tt> <tt class="py-line"> </tt> +<a name="EUI.ipv6_link_local"></a><div id="EUI.ipv6_link_local-def"><a name="L579"></a><tt class="py-lineno"> 579</tt> <a class="py-toggle" href="#" id="EUI.ipv6_link_local-toggle" onclick="return toggle('EUI.ipv6_link_local');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#ipv6_link_local">ipv6_link_local</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.ipv6_link_local-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.ipv6_link_local-expanded"><a name="L580"></a><tt class="py-lineno"> 580</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L581"></a><tt class="py-lineno"> 581</tt> <tt class="py-line"><tt class="py-docstring"> @return: new link local IPv6 L{IP} object based on this L{EUI} using</tt> </tt> +<a name="L582"></a><tt class="py-lineno"> 582</tt> <tt class="py-line"><tt class="py-docstring"> technique described in RFC 4291. B{Please Note:} this technique</tt> </tt> +<a name="L583"></a><tt class="py-lineno"> 583</tt> <tt class="py-line"><tt class="py-docstring"> poses security risks in certain scenarios. Please read RFC 4941 for</tt> </tt> +<a name="L584"></a><tt class="py-lineno"> 584</tt> <tt class="py-line"><tt class="py-docstring"> details. Reference: RFCs 4291 and 4941.</tt> </tt> +<a name="L585"></a><tt class="py-lineno"> 585</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L586"></a><tt class="py-lineno"> 586</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-string">'fe80:0000:0000:0000:'</tt> </tt> +<a name="L587"></a><tt class="py-lineno"> 587</tt> <tt class="py-line"> </tt> +<a name="L588"></a><tt class="py-lineno"> 588</tt> <tt class="py-line"> <tt class="py-comment"># Add 2 to the first octet of this EUI address (temporarily).</tt> </tt> +<a name="L589"></a><tt class="py-lineno"> 589</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">+=</tt> <tt class="py-number">2</tt> </tt> +<a name="L590"></a><tt class="py-lineno"> 590</tt> <tt class="py-line"> </tt> +<a name="L591"></a><tt class="py-lineno"> 591</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-291" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-291', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-292" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-292', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">:</tt> </tt> +<a name="L592"></a><tt class="py-lineno"> 592</tt> <tt class="py-line"> <tt class="py-comment"># Modify MAC to make it an EUI-64.</tt> </tt> +<a name="L593"></a><tt class="py-lineno"> 593</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">3</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'ff'</tt><tt class="py-op">,</tt> <tt class="py-string">'fe'</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> \ </tt> +<a name="L594"></a><tt class="py-lineno"> 594</tt> <tt class="py-line"> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">3</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> +<a name="L595"></a><tt class="py-lineno"> 595</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L596"></a><tt class="py-lineno"> 596</tt> <tt class="py-line"> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> +<a name="L597"></a><tt class="py-lineno"> 597</tt> <tt class="py-line"> </tt> +<a name="L598"></a><tt class="py-lineno"> 598</tt> <tt class="py-line"> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%02x%02x"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">x</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">x</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">x</tt> <tt class="py-keyword">in</tt> \ </tt> +<a name="L599"></a><tt class="py-lineno"> 599</tt> <tt class="py-line"> <tt class="py-name">zip</tt><tt class="py-op">(</tt><tt class="py-name">suffix</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">suffix</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">:</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> +<a name="L600"></a><tt class="py-lineno"> 600</tt> <tt class="py-line"> </tt> +<a name="L601"></a><tt class="py-lineno"> 601</tt> <tt class="py-line"> <tt class="py-comment"># Subtract 2 again to return EUI to its original value.</tt> </tt> +<a name="L602"></a><tt class="py-lineno"> 602</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">-=</tt> <tt class="py-number">2</tt> </tt> +<a name="L603"></a><tt class="py-lineno"> 603</tt> <tt class="py-line"> </tt> +<a name="L604"></a><tt class="py-lineno"> 604</tt> <tt class="py-line"> <tt id="link-293" class="py-name" targets="Method netaddr.address.EUI.eui64()=netaddr.address.EUI-class.html#eui64"><a title="netaddr.address.EUI.eui64" class="py-name" href="#" onclick="return doclink('link-293', 'eui64', 'link-293');">eui64</a></tt> <tt class="py-op">=</tt> <tt class="py-string">':'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">suffix</tt><tt class="py-op">)</tt> </tt> +<a name="L605"></a><tt class="py-lineno"> 605</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">prefix</tt> <tt class="py-op">+</tt> <tt id="link-294" class="py-name"><a title="netaddr.address.EUI.eui64" class="py-name" href="#" onclick="return doclink('link-294', 'eui64', 'link-293');">eui64</a></tt> </tt> +<a name="L606"></a><tt class="py-lineno"> 606</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-295" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-295', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +</div><a name="L607"></a><tt class="py-lineno"> 607</tt> <tt class="py-line"> </tt> +<a name="EUI.info"></a><div id="EUI.info-def"><a name="L608"></a><tt class="py-lineno"> 608</tt> <a class="py-toggle" href="#" id="EUI.info-toggle" onclick="return toggle('EUI.info');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.EUI-class.html#info">info</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI.info-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="EUI.info-expanded"><a name="L609"></a><tt class="py-lineno"> 609</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L610"></a><tt class="py-lineno"> 610</tt> <tt class="py-line"><tt class="py-docstring"> @return: A record dict containing IEEE registration details for this</tt> </tt> +<a name="L611"></a><tt class="py-lineno"> 611</tt> <tt class="py-line"><tt class="py-docstring"> EUI (MAC-48) if available, None otherwise.</tt> </tt> +<a name="L612"></a><tt class="py-lineno"> 612</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L613"></a><tt class="py-lineno"> 613</tt> <tt class="py-line"> <tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-string">'OUI'</tt><tt class="py-op">:</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-296" class="py-name" targets="Method netaddr.address.EUI.oui()=netaddr.address.EUI-class.html#oui"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-296', 'oui', 'link-296');">oui</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-297" class="py-name" targets="Method netaddr.eui.IAB.registration()=netaddr.eui.IAB-class.html#registration,Method netaddr.eui.OUI.registration()=netaddr.eui.OUI-class.html#registration"><a title="netaddr.eui.IAB.registration +netaddr.eui.OUI.registration" class="py-name" href="#" onclick="return doclink('link-297', 'registration', 'link-297');">registration</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">}</tt> </tt> +<a name="L614"></a><tt class="py-lineno"> 614</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-298" class="py-name"><a title="netaddr.address.EUI.isiab" class="py-name" href="#" onclick="return doclink('link-298', 'isiab', 'link-275');">isiab</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L615"></a><tt class="py-lineno"> 615</tt> <tt class="py-line"> <tt class="py-name">data</tt><tt class="py-op">[</tt><tt class="py-string">'IAB'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-299" class="py-name" targets="Method netaddr.address.EUI.iab()=netaddr.address.EUI-class.html#iab"><a title="netaddr.address.EUI.iab" class="py-name" href="#" onclick="return doclink('link-299', 'iab', 'link-299');">iab</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-300" class="py-name"><a title="netaddr.eui.IAB.registration +netaddr.eui.OUI.registration" class="py-name" href="#" onclick="return doclink('link-300', 'registration', 'link-297');">registration</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L616"></a><tt class="py-lineno"> 616</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">data</tt> </tt> +</div></div><a name="L617"></a><tt class="py-lineno"> 617</tt> <tt class="py-line"> </tt> +<a name="L618"></a><tt class="py-lineno"> 618</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IP"></a><div id="IP-def"><a name="L619"></a><tt class="py-lineno"> 619</tt> <a class="py-toggle" href="#" id="IP-toggle" onclick="return toggle('IP');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.IP-class.html">IP</a><tt class="py-op">(</tt><tt class="py-base-class">Addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="IP-expanded"><a name="L620"></a><tt class="py-lineno"> 620</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L621"></a><tt class="py-lineno"> 621</tt> <tt class="py-line"><tt class="py-docstring"> Represents B{individual} IPv4 and IPv6 addresses.</tt> </tt> +<a name="L622"></a><tt class="py-lineno"> 622</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L623"></a><tt class="py-lineno"> 623</tt> <tt class="py-line"><tt class="py-docstring"> B{Please Note:} this class is intended to provide low-level functionality</tt> </tt> +<a name="L624"></a><tt class="py-lineno"> 624</tt> <tt class="py-line"><tt class="py-docstring"> to individual IP addresses such as octet/hextet access, integer/hex/binary</tt> </tt> +<a name="L625"></a><tt class="py-lineno"> 625</tt> <tt class="py-line"><tt class="py-docstring"> conversions, etc. If you are coming from other libraries you may expect to</tt> </tt> +<a name="L626"></a><tt class="py-lineno"> 626</tt> <tt class="py-line"><tt class="py-docstring"> find much higher level networking operations here. While the inclusion of</tt> </tt> +<a name="L627"></a><tt class="py-lineno"> 627</tt> <tt class="py-line"><tt class="py-docstring"> a bitmask prefix or netmask to indicate subnet membership is permitted by</tt> </tt> +<a name="L628"></a><tt class="py-lineno"> 628</tt> <tt class="py-line"><tt class="py-docstring"> the class constructor they are provided only as a convenience to the user.</tt> </tt> +<a name="L629"></a><tt class="py-lineno"> 629</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L630"></a><tt class="py-lineno"> 630</tt> <tt class="py-line"><tt class="py-docstring"> All higher level subnet and network operations can be found in objects of</tt> </tt> +<a name="L631"></a><tt class="py-lineno"> 631</tt> <tt class="py-line"><tt class="py-docstring"> classes L{CIDR}, L{IPRange} and L{Wildcard}. There are handy helper methods</tt> </tt> +<a name="L632"></a><tt class="py-lineno"> 632</tt> <tt class="py-line"><tt class="py-docstring"> here, (C{.cidr()}, C{.iprange()} and C{.wildcard()}) that return pre-initialised</tt> </tt> +<a name="L633"></a><tt class="py-lineno"> 633</tt> <tt class="py-line"><tt class="py-docstring"> objects of those classes without you having to call them explicitly.</tt> </tt> +<a name="L634"></a><tt class="py-lineno"> 634</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L635"></a><tt class="py-lineno"> 635</tt> <tt class="py-line"><tt class="py-docstring"> Example usage ::</tt> </tt> +<a name="L636"></a><tt class="py-lineno"> 636</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L637"></a><tt class="py-lineno"> 637</tt> <tt class="py-line"><tt class="py-docstring"> >>> ip = IP('10.0.0.1')</tt> </tt> +<a name="L638"></a><tt class="py-lineno"> 638</tt> <tt class="py-line"><tt class="py-docstring"> >>> list(ip) == [10, 0, 0, 1]</tt> </tt> +<a name="L639"></a><tt class="py-lineno"> 639</tt> <tt class="py-line"><tt class="py-docstring"> True</tt> </tt> +<a name="L640"></a><tt class="py-lineno"> 640</tt> <tt class="py-line"><tt class="py-docstring"> >>> ip += 1</tt> </tt> +<a name="L641"></a><tt class="py-lineno"> 641</tt> <tt class="py-line"><tt class="py-docstring"> >>> str(ip) == '10.0.0.2'</tt> </tt> +<a name="L642"></a><tt class="py-lineno"> 642</tt> <tt class="py-line"><tt class="py-docstring"> True</tt> </tt> +<a name="L643"></a><tt class="py-lineno"> 643</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L644"></a><tt class="py-lineno"> 644</tt> <tt class="py-line"><tt class="py-docstring"> >>> IP('10.0.0.0/28').iprange()</tt> </tt> +<a name="L645"></a><tt class="py-lineno"> 645</tt> <tt class="py-line"><tt class="py-docstring"> IPRange('10.0.0.0', '10.0.0.15')</tt> </tt> +<a name="L646"></a><tt class="py-lineno"> 646</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L647"></a><tt class="py-lineno"> 647</tt> <tt class="py-line"><tt class="py-docstring"> >>> IP('10.0.0.64/24').cidr()</tt> </tt> +<a name="L648"></a><tt class="py-lineno"> 648</tt> <tt class="py-line"><tt class="py-docstring"> CIDR('10.0.0.0/24')</tt> </tt> +<a name="L649"></a><tt class="py-lineno"> 649</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L650"></a><tt class="py-lineno"> 650</tt> <tt class="py-line"><tt class="py-docstring"> >>> IP('192.168.0.1/255.255.253.0').wildcard()</tt> </tt> +<a name="L651"></a><tt class="py-lineno"> 651</tt> <tt class="py-line"><tt class="py-docstring"> Wildcard('192.168.0-1.*')</tt> </tt> +<a name="L652"></a><tt class="py-lineno"> 652</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L653"></a><tt class="py-lineno"> 653</tt> <tt class="py-line"><tt class="py-docstring"> >>> ipv6 = IP('fe80::20f:1fff:fe12:e733')</tt> </tt> +<a name="L654"></a><tt class="py-lineno"> 654</tt> <tt class="py-line"><tt class="py-docstring"> >>> ipv6[0:4]</tt> </tt> +<a name="L655"></a><tt class="py-lineno"> 655</tt> <tt class="py-line"><tt class="py-docstring"> [65152, 0, 0, 0]</tt> </tt> +<a name="L656"></a><tt class="py-lineno"> 656</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L657"></a><tt class="py-lineno"> 657</tt> <tt class="py-line"><tt class="py-docstring"> >>> IP('fe80::20f:1fff:fe12:e733/64').cidr()</tt> </tt> +<a name="L658"></a><tt class="py-lineno"> 658</tt> <tt class="py-line"><tt class="py-docstring"> CIDR('fe80::/64')</tt> </tt> +<a name="L659"></a><tt class="py-lineno"> 659</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L660"></a><tt class="py-lineno"> 660</tt> <tt class="py-line"><tt class="py-docstring"> See those classes for details on the functionality they provide.</tt> </tt> +<a name="L661"></a><tt class="py-lineno"> 661</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L662"></a><tt class="py-lineno"> 662</tt> <tt class="py-line"> <tt id="link-301" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-230', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-231" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-231', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-232" class="py-name"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-232', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L563"></a><tt class="py-lineno"> 563</tt> <tt class="py-line"> <tt id="link-233" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-301', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-302" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-302', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-303" class="py-name"><a title="netaddr.ST_IPV6 +netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-303', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L663"></a><tt class="py-lineno"> 663</tt> <tt class="py-line"> <tt id="link-304" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-233', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-234" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-234', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-235" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-235', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-236" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-236', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L564"></a><tt class="py-lineno"> 564</tt> <tt class="py-line"> <tt id="link-237" class="py-name" targets="Variable netaddr.address.IP.TRANSLATE_STR=netaddr.address.IP-class.html#TRANSLATE_STR"><a title="netaddr.address.IP.TRANSLATE_STR" class="py-name" href="#" onclick="return doclink('link-237', 'TRANSLATE_STR', 'link-237');">TRANSLATE_STR</a></tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">chr</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">256</tt><tt class="py-op">)</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -<a name="L565"></a><tt class="py-lineno"> 565</tt> <tt class="py-line"> <tt class="py-keyword">del</tt> <tt class="py-name">i</tt> </tt> -<a name="L566"></a><tt class="py-lineno"> 566</tt> <tt class="py-line"> </tt> -<a name="L567"></a><tt class="py-lineno"> 567</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> -<a name="L568"></a><tt class="py-lineno"> 568</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-238" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-304', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-305" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-305', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-306" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-306', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-307" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-307', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L664"></a><tt class="py-lineno"> 664</tt> <tt class="py-line"> <tt id="link-308" class="py-name" targets="Variable netaddr.address.IP.TRANSLATE_STR=netaddr.address.IP-class.html#TRANSLATE_STR"><a title="netaddr.address.IP.TRANSLATE_STR" class="py-name" href="#" onclick="return doclink('link-308', 'TRANSLATE_STR', 'link-308');">TRANSLATE_STR</a></tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">chr</tt><tt class="py-op">(</tt><tt id="link-309" class="py-name" targets="Variable netaddr.address.IP._=netaddr.address.IP-class.html#_,Variable netaddr.strategy.EUI48Strategy._=netaddr.strategy.EUI48Strategy-class.html#_"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-309', '_', 'link-309');">_</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt id="link-310" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-310', '_', 'link-309');">_</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">256</tt><tt class="py-op">)</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> <tt class="py-comment">#FIXME: replace this</tt> </tt> +<a name="L665"></a><tt class="py-lineno"> 665</tt> <tt class="py-line"> </tt> +<a name="L666"></a><tt class="py-lineno"> 666</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> +<a name="L667"></a><tt class="py-lineno"> 667</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-311" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-238', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-239" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-239', 'StrategyDescriptor', 'link-123');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-240" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-311', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-312" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-312', 'StrategyDescriptor', 'link-142');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-313" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-240', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L569"></a><tt class="py-lineno"> 569</tt> <tt class="py-line"> <tt id="link-241" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-313', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L668"></a><tt class="py-lineno"> 668</tt> <tt class="py-line"> <tt id="link-314" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-241', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-242" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-242', 'AddrTypeDescriptor', 'link-126');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-243" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-314', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-315" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-315', 'AddrTypeDescriptor', 'link-145');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-316" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-243', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L570"></a><tt class="py-lineno"> 570</tt> <tt class="py-line"> <tt id="link-244" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-244', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-245" class="py-name" targets="Class netaddr.address.PrefixLenDescriptor=netaddr.address.PrefixLenDescriptor-class.html"><a title="netaddr.address.PrefixLenDescriptor" class="py-name" href="#" onclick="return doclink('link-245', 'PrefixLenDescriptor', 'link-245');">PrefixLenDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L571"></a><tt class="py-lineno"> 571</tt> <tt class="py-line"> </tt> -<a name="IP.__init__"></a><div id="IP.__init__-def"><a name="L572"></a><tt class="py-lineno"> 572</tt> <a class="py-toggle" href="#" id="IP.__init__-toggle" onclick="return toggle('IP.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">,</tt> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-246" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-246', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.__init__-expanded"><a name="L573"></a><tt class="py-lineno"> 573</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L574"></a><tt class="py-lineno"> 574</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L575"></a><tt class="py-lineno"> 575</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L576"></a><tt class="py-lineno"> 576</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: an IPv4 or IPv6 address string with an optional subnet</tt> </tt> -<a name="L577"></a><tt class="py-lineno"> 577</tt> <tt class="py-line"><tt class="py-docstring"> prefix or a network byte order integer.</tt> </tt> -<a name="L578"></a><tt class="py-lineno"> 578</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L579"></a><tt class="py-lineno"> 579</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_type: (optional) the IP address type (C{AT_INET} or</tt> </tt> -<a name="L580"></a><tt class="py-lineno"> 580</tt> <tt class="py-line"><tt class="py-docstring"> C{AT_INET6}). If L{addr} is an integer, this argument is mandatory.</tt> </tt> -<a name="L581"></a><tt class="py-lineno"> 581</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L582"></a><tt class="py-lineno"> 582</tt> <tt class="py-line"> <tt id="link-247" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-247', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> -<a name="L583"></a><tt class="py-lineno"> 583</tt> <tt class="py-line"> <tt class="py-comment"># Check for prefix in address and split it out.</tt> </tt> -<a name="L584"></a><tt class="py-lineno"> 584</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L585"></a><tt class="py-lineno"> 585</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'/'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L586"></a><tt class="py-lineno"> 586</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-248" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-248', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L587"></a><tt class="py-lineno"> 587</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L588"></a><tt class="py-lineno"> 588</tt> <tt class="py-line"> <tt class="py-comment"># addr is an int - let it pass through.</tt> </tt> -<a name="L589"></a><tt class="py-lineno"> 589</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">pass</tt> </tt> -<a name="L590"></a><tt class="py-lineno"> 590</tt> <tt class="py-line"> </tt> -<a name="L591"></a><tt class="py-lineno"> 591</tt> <tt class="py-line"> <tt class="py-comment"># Call superclass constructor before processing subnet prefix to</tt> </tt> -<a name="L592"></a><tt class="py-lineno"> 592</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># assign the strategyn object.</tt> </tt> -<a name="L593"></a><tt class="py-lineno"> 593</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-249" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-249', 'IP', 'link-71');">IP</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-250" class="py-name"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-316', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L669"></a><tt class="py-lineno"> 669</tt> <tt class="py-line"> <tt id="link-317" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-317', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-318" class="py-name" targets="Class netaddr.address.PrefixLenDescriptor=netaddr.address.PrefixLenDescriptor-class.html"><a title="netaddr.address.PrefixLenDescriptor" class="py-name" href="#" onclick="return doclink('link-318', 'PrefixLenDescriptor', 'link-318');">PrefixLenDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L670"></a><tt class="py-lineno"> 670</tt> <tt class="py-line"> </tt> +<a name="IP.__init__"></a><div id="IP.__init__-def"><a name="L671"></a><tt class="py-lineno"> 671</tt> <a class="py-toggle" href="#" id="IP.__init__-toggle" onclick="return toggle('IP.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">,</tt> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-319" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-319', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.__init__-expanded"><a name="L672"></a><tt class="py-lineno"> 672</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L673"></a><tt class="py-lineno"> 673</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L674"></a><tt class="py-lineno"> 674</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L675"></a><tt class="py-lineno"> 675</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: an IPv4 or IPv6 address string with an optional subnet</tt> </tt> +<a name="L676"></a><tt class="py-lineno"> 676</tt> <tt class="py-line"><tt class="py-docstring"> prefix or a network byte order integer.</tt> </tt> +<a name="L677"></a><tt class="py-lineno"> 677</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L678"></a><tt class="py-lineno"> 678</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_type: (optional) the IP address type (C{AT_INET} or</tt> </tt> +<a name="L679"></a><tt class="py-lineno"> 679</tt> <tt class="py-line"><tt class="py-docstring"> C{AT_INET6}). If L{addr} is an integer, this argument is mandatory.</tt> </tt> +<a name="L680"></a><tt class="py-lineno"> 680</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L681"></a><tt class="py-lineno"> 681</tt> <tt class="py-line"> <tt id="link-320" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-320', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L682"></a><tt class="py-lineno"> 682</tt> <tt class="py-line"> <tt class="py-comment"># Check for prefix in address and split it out.</tt> </tt> +<a name="L683"></a><tt class="py-lineno"> 683</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L684"></a><tt class="py-lineno"> 684</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'/'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L685"></a><tt class="py-lineno"> 685</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-321" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-321', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L686"></a><tt class="py-lineno"> 686</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L687"></a><tt class="py-lineno"> 687</tt> <tt class="py-line"> <tt class="py-comment"># addr is an int - let it pass through.</tt> </tt> +<a name="L688"></a><tt class="py-lineno"> 688</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">pass</tt> </tt> +<a name="L689"></a><tt class="py-lineno"> 689</tt> <tt class="py-line"> </tt> +<a name="L690"></a><tt class="py-lineno"> 690</tt> <tt class="py-line"> <tt class="py-comment"># Call superclass constructor before processing subnet prefix to</tt> </tt> +<a name="L691"></a><tt class="py-lineno"> 691</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># assign the strategyn object.</tt> </tt> +<a name="L692"></a><tt class="py-lineno"> 692</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-322" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-322', 'IP', 'link-76');">IP</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-323" class="py-name"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-250', '__init__', 'link-216');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-251" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-323', '__init__', 'link-258');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-324" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-251', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -<a name="L594"></a><tt class="py-lineno"> 594</tt> <tt class="py-line"> </tt> -<a name="L595"></a><tt class="py-lineno"> 595</tt> <tt class="py-line"> <tt class="py-comment"># Set the subnet prefix.</tt> </tt> -<a name="L596"></a><tt class="py-lineno"> 596</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt id="link-252" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-252', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L597"></a><tt class="py-lineno"> 597</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-253" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-253', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-254" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-324', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L693"></a><tt class="py-lineno"> 693</tt> <tt class="py-line"> </tt> +<a name="L694"></a><tt class="py-lineno"> 694</tt> <tt class="py-line"> <tt class="py-comment"># Set the subnet prefix.</tt> </tt> +<a name="L695"></a><tt class="py-lineno"> 695</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt id="link-325" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-325', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L696"></a><tt class="py-lineno"> 696</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-string">'prefixlen'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-326" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-254', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> </tt> -<a name="L598"></a><tt class="py-lineno"> 598</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L599"></a><tt class="py-lineno"> 599</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-255" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-255', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-256" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-256', 'prefixlen', 'link-69');">prefixlen</a></tt> </tt> -</div><a name="L600"></a><tt class="py-lineno"> 600</tt> <tt class="py-line"> </tt> -<a name="IP.is_netmask"></a><div id="IP.is_netmask-def"><a name="L601"></a><tt class="py-lineno"> 601</tt> <a class="py-toggle" href="#" id="IP.is_netmask-toggle" onclick="return toggle('IP.is_netmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_netmask">is_netmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.is_netmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_netmask-expanded"><a name="L602"></a><tt class="py-lineno"> 602</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L603"></a><tt class="py-lineno"> 603</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this addr is a mask that would return a host id,</tt> </tt> -<a name="L604"></a><tt class="py-lineno"> 604</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> -<a name="L605"></a><tt class="py-lineno"> 605</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L606"></a><tt class="py-lineno"> 606</tt> <tt class="py-line"> <tt class="py-comment"># There is probably a better way to do this.</tt> </tt> -<a name="L607"></a><tt class="py-lineno"> 607</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Change at will, just don't break the unit tests :-)</tt> </tt> -<a name="L608"></a><tt class="py-lineno"> 608</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-257" class="py-name" targets="Method netaddr.address.Addr.bits()=netaddr.address.Addr-class.html#bits"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-257', 'bits', 'link-257');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-258" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-258', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-259" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_bits" class="py-name" href="#" onclick="return doclink('link-259', 'int_to_bits', 'link-140');">int_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-260" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-260', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> -<a name="L609"></a><tt class="py-lineno"> 609</tt> <tt class="py-line"> </tt> -<a name="L610"></a><tt class="py-lineno"> 610</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-261" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-261', 'bits', 'link-257');">bits</a></tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-string">'1'</tt><tt class="py-op">:</tt> </tt> -<a name="L611"></a><tt class="py-lineno"> 611</tt> <tt class="py-line"> <tt class="py-comment"># Fail fast, if possible.</tt> </tt> -<a name="L612"></a><tt class="py-lineno"> 612</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L613"></a><tt class="py-lineno"> 613</tt> <tt class="py-line"> </tt> -<a name="L614"></a><tt class="py-lineno"> 614</tt> <tt class="py-line"> <tt class="py-comment"># Trim our search a bit.</tt> </tt> -<a name="L615"></a><tt class="py-lineno"> 615</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-262" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-262', 'bits', 'link-257');">bits</a></tt> <tt class="py-op">=</tt> <tt id="link-263" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-263', 'bits', 'link-257');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">lstrip</tt><tt class="py-op">(</tt><tt class="py-string">'1'</tt><tt class="py-op">)</tt> </tt> -<a name="L616"></a><tt class="py-lineno"> 616</tt> <tt class="py-line"> </tt> -<a name="L617"></a><tt class="py-lineno"> 617</tt> <tt class="py-line"> <tt class="py-name">seen_zero</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L618"></a><tt class="py-lineno"> 618</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt id="link-264" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-264', 'bits', 'link-257');">bits</a></tt><tt class="py-op">:</tt> </tt> -<a name="L619"></a><tt class="py-lineno"> 619</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">i</tt> <tt class="py-op">==</tt> <tt class="py-string">'0'</tt> <tt class="py-keyword">and</tt> <tt class="py-name">seen_zero</tt> <tt class="py-keyword">is</tt> <tt class="py-name">False</tt><tt class="py-op">:</tt> </tt> -<a name="L620"></a><tt class="py-lineno"> 620</tt> <tt class="py-line"> <tt class="py-name">seen_zero</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L621"></a><tt class="py-lineno"> 621</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">i</tt> <tt class="py-op">==</tt> <tt class="py-string">'1'</tt> <tt class="py-keyword">and</tt> <tt class="py-name">seen_zero</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L622"></a><tt class="py-lineno"> 622</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L623"></a><tt class="py-lineno"> 623</tt> <tt class="py-line"> </tt> -<a name="L624"></a><tt class="py-lineno"> 624</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L625"></a><tt class="py-lineno"> 625</tt> <tt class="py-line"> </tt> -<a name="IP.netmask_bits"></a><div id="IP.netmask_bits-def"><a name="L626"></a><tt class="py-lineno"> 626</tt> <a class="py-toggle" href="#" id="IP.netmask_bits-toggle" onclick="return toggle('IP.netmask_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#netmask_bits">netmask_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.netmask_bits-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.netmask_bits-expanded"><a name="L627"></a><tt class="py-lineno"> 627</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L628"></a><tt class="py-lineno"> 628</tt> <tt class="py-line"><tt class="py-docstring"> @return: If this address is a valid netmask, the number of non-zero</tt> </tt> -<a name="L629"></a><tt class="py-lineno"> 629</tt> <tt class="py-line"><tt class="py-docstring"> bits are returned, otherwise it returns the width (in bits) for the</tt> </tt> -<a name="L630"></a><tt class="py-lineno"> 630</tt> <tt class="py-line"><tt class="py-docstring"> given address type (IPv4: 32, IPv6: 128).</tt> </tt> -<a name="L631"></a><tt class="py-lineno"> 631</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L632"></a><tt class="py-lineno"> 632</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-265" class="py-name"><a title="netaddr.address.IP.is_netmask" class="py-name" href="#" onclick="return doclink('link-265', 'is_netmask', 'link-75');">is_netmask</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L633"></a><tt class="py-lineno"> 633</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-266" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-266', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> </tt> -<a name="L634"></a><tt class="py-lineno"> 634</tt> <tt class="py-line"> </tt> -<a name="L635"></a><tt class="py-lineno"> 635</tt> <tt class="py-line"> <tt id="link-267" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-267', 'bits', 'link-257');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-268" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-268', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-269" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_bits" class="py-name" href="#" onclick="return doclink('link-269', 'int_to_bits', 'link-140');">int_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-270" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-270', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L636"></a><tt class="py-lineno"> 636</tt> <tt class="py-line"> <tt class="py-name">mask_bits</tt> <tt class="py-op">=</tt> <tt id="link-271" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-271', 'bits', 'link-257');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">translate</tt><tt class="py-op">(</tt><tt id="link-272" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-272', 'IP', 'link-71');">IP</a></tt><tt class="py-op">.</tt><tt id="link-273" class="py-name"><a title="netaddr.address.IP.TRANSLATE_STR" class="py-name" href="#" onclick="return doclink('link-273', 'TRANSLATE_STR', 'link-237');">TRANSLATE_STR</a></tt><tt class="py-op">,</tt> <tt class="py-string">':.0'</tt><tt class="py-op">)</tt> </tt> -<a name="L637"></a><tt class="py-lineno"> 637</tt> <tt class="py-line"> <tt class="py-name">mask_length</tt> <tt class="py-op">=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">mask_bits</tt><tt class="py-op">)</tt> </tt> -<a name="L638"></a><tt class="py-lineno"> 638</tt> <tt class="py-line"> </tt> -<a name="L639"></a><tt class="py-lineno"> 639</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">1</tt> <tt class="py-op"><=</tt> <tt class="py-name">mask_length</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-274" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-274', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> -<a name="L640"></a><tt class="py-lineno"> 640</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'Unexpected mask length %d for address type!'</tt> \ </tt> -<a name="L641"></a><tt class="py-lineno"> 641</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">mask_length</tt><tt class="py-op">)</tt> </tt> -<a name="L642"></a><tt class="py-lineno"> 642</tt> <tt class="py-line"> </tt> -<a name="L643"></a><tt class="py-lineno"> 643</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">mask_length</tt> </tt> -</div><a name="L644"></a><tt class="py-lineno"> 644</tt> <tt class="py-line"> </tt> -<a name="IP.reverse_dns"></a><div id="IP.reverse_dns-def"><a name="L645"></a><tt class="py-lineno"> 645</tt> <a class="py-toggle" href="#" id="IP.reverse_dns-toggle" onclick="return toggle('IP.reverse_dns');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#reverse_dns">reverse_dns</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.reverse_dns-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.reverse_dns-expanded"><a name="L646"></a><tt class="py-lineno"> 646</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L647"></a><tt class="py-lineno"> 647</tt> <tt class="py-line"><tt class="py-docstring"> @return: The reverse DNS lookup string for this IP address.</tt> </tt> -<a name="L648"></a><tt class="py-lineno"> 648</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L649"></a><tt class="py-lineno"> 649</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-275" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-275', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-276" class="py-name" targets="Method netaddr.strategy.IPv4StrategyStd.int_to_arpa()=netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa,Method netaddr.strategy.IPv6Strategy.int_to_arpa()=netaddr.strategy.IPv6Strategy-class.html#int_to_arpa"><a title="netaddr.strategy.IPv4StrategyStd.int_to_arpa -netaddr.strategy.IPv6Strategy.int_to_arpa" class="py-name" href="#" onclick="return doclink('link-276', 'int_to_arpa', 'link-276');">int_to_arpa</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-277" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-277', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L650"></a><tt class="py-lineno"> 650</tt> <tt class="py-line"> </tt> -<a name="IP.is_hostmask"></a><div id="IP.is_hostmask-def"><a name="L651"></a><tt class="py-lineno"> 651</tt> <a class="py-toggle" href="#" id="IP.is_hostmask-toggle" onclick="return toggle('IP.is_hostmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_hostmask">is_hostmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.is_hostmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_hostmask-expanded"><a name="L652"></a><tt class="py-lineno"> 652</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L653"></a><tt class="py-lineno"> 653</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is a mask that would return a host</tt> </tt> -<a name="L654"></a><tt class="py-lineno"> 654</tt> <tt class="py-line"><tt class="py-docstring"> id, C{False} otherwise.</tt> </tt> -<a name="L655"></a><tt class="py-lineno"> 655</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L656"></a><tt class="py-lineno"> 656</tt> <tt class="py-line"> <tt class="py-comment"># There is probably a better way to do this.</tt> </tt> -<a name="L657"></a><tt class="py-lineno"> 657</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Change at will, just don't break the unit tests :-)</tt> </tt> -<a name="L658"></a><tt class="py-lineno"> 658</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-278" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-278', 'bits', 'link-257');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-279" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-279', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-280" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_bits" class="py-name" href="#" onclick="return doclink('link-280', 'int_to_bits', 'link-140');">int_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-281" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-281', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> -<a name="L659"></a><tt class="py-lineno"> 659</tt> <tt class="py-line"> </tt> -<a name="L660"></a><tt class="py-lineno"> 660</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-282" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-282', 'bits', 'link-257');">bits</a></tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-string">'0'</tt><tt class="py-op">:</tt> </tt> -<a name="L661"></a><tt class="py-lineno"> 661</tt> <tt class="py-line"> <tt class="py-comment"># Fail fast, if possible.</tt> </tt> -<a name="L662"></a><tt class="py-lineno"> 662</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L663"></a><tt class="py-lineno"> 663</tt> <tt class="py-line"> </tt> -<a name="L664"></a><tt class="py-lineno"> 664</tt> <tt class="py-line"> <tt class="py-comment"># Trim our search a bit.</tt> </tt> -<a name="L665"></a><tt class="py-lineno"> 665</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-283" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-283', 'bits', 'link-257');">bits</a></tt> <tt class="py-op">=</tt> <tt id="link-284" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-284', 'bits', 'link-257');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">lstrip</tt><tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">)</tt> </tt> -<a name="L666"></a><tt class="py-lineno"> 666</tt> <tt class="py-line"> </tt> -<a name="L667"></a><tt class="py-lineno"> 667</tt> <tt class="py-line"> <tt class="py-name">seen_one</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L668"></a><tt class="py-lineno"> 668</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt id="link-285" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-285', 'bits', 'link-257');">bits</a></tt><tt class="py-op">:</tt> </tt> -<a name="L669"></a><tt class="py-lineno"> 669</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">i</tt> <tt class="py-op">==</tt> <tt class="py-string">'1'</tt> <tt class="py-keyword">and</tt> <tt class="py-name">seen_one</tt> <tt class="py-keyword">is</tt> <tt class="py-name">False</tt><tt class="py-op">:</tt> </tt> -<a name="L670"></a><tt class="py-lineno"> 670</tt> <tt class="py-line"> <tt class="py-name">seen_one</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L671"></a><tt class="py-lineno"> 671</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">i</tt> <tt class="py-op">==</tt> <tt class="py-string">'0'</tt> <tt class="py-keyword">and</tt> <tt class="py-name">seen_one</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L672"></a><tt class="py-lineno"> 672</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L673"></a><tt class="py-lineno"> 673</tt> <tt class="py-line"> </tt> -<a name="L674"></a><tt class="py-lineno"> 674</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L675"></a><tt class="py-lineno"> 675</tt> <tt class="py-line"> </tt> -<a name="IP.hostname"></a><div id="IP.hostname-def"><a name="L676"></a><tt class="py-lineno"> 676</tt> <a class="py-toggle" href="#" id="IP.hostname-toggle" onclick="return toggle('IP.hostname');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#hostname">hostname</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.hostname-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.hostname-expanded"><a name="L677"></a><tt class="py-lineno"> 677</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L678"></a><tt class="py-lineno"> 678</tt> <tt class="py-line"><tt class="py-docstring"> @return: Returns the FQDN for this IP address via a DNS query</tt> </tt> -<a name="L679"></a><tt class="py-lineno"> 679</tt> <tt class="py-line"><tt class="py-docstring"> using gethostbyaddr() Python's socket module.</tt> </tt> -<a name="L680"></a><tt class="py-lineno"> 680</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L681"></a><tt class="py-lineno"> 681</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L682"></a><tt class="py-lineno"> 682</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">gethostbyaddr</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> -<a name="L683"></a><tt class="py-lineno"> 683</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> -<a name="L684"></a><tt class="py-lineno"> 684</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> -</div><a name="L685"></a><tt class="py-lineno"> 685</tt> <tt class="py-line"> </tt> -<a name="IP.cidr"></a><div id="IP.cidr-def"><a name="L686"></a><tt class="py-lineno"> 686</tt> <a class="py-toggle" href="#" id="IP.cidr-toggle" onclick="return toggle('IP.cidr');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#cidr">cidr</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.cidr-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.cidr-expanded"><a name="L687"></a><tt class="py-lineno"> 687</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L688"></a><tt class="py-lineno"> 688</tt> <tt class="py-line"><tt class="py-docstring"> @return: A valid L{CIDR} object for this IP address.</tt> </tt> -<a name="L689"></a><tt class="py-lineno"> 689</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L690"></a><tt class="py-lineno"> 690</tt> <tt class="py-line"> <tt id="link-286" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-286', 'hostmask', 'link-91');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-287" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-326', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> </tt> +<a name="L697"></a><tt class="py-lineno"> 697</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L698"></a><tt class="py-lineno"> 698</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-327" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-327', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-328" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-328', 'prefixlen', 'link-73');">prefixlen</a></tt> </tt> +</div><a name="L699"></a><tt class="py-lineno"> 699</tt> <tt class="py-line"> </tt> +<a name="IP.is_netmask"></a><div id="IP.is_netmask-def"><a name="L700"></a><tt class="py-lineno"> 700</tt> <a class="py-toggle" href="#" id="IP.is_netmask-toggle" onclick="return toggle('IP.is_netmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_netmask">is_netmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_netmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_netmask-expanded"><a name="L701"></a><tt class="py-lineno"> 701</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L702"></a><tt class="py-lineno"> 702</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this addr is a mask that would return a host id,</tt> </tt> +<a name="L703"></a><tt class="py-lineno"> 703</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> +<a name="L704"></a><tt class="py-lineno"> 704</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L705"></a><tt class="py-lineno"> 705</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-329" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-329', 'value', 'link-30');">value</a></tt> <tt class="py-op">^</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-330" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-330', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt> +<a name="L706"></a><tt class="py-lineno"> 706</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-op">(</tt><tt class="py-name">int_val</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> </tt> +</div><a name="L707"></a><tt class="py-lineno"> 707</tt> <tt class="py-line"> </tt> +<a name="IP.netmask_bits"></a><div id="IP.netmask_bits-def"><a name="L708"></a><tt class="py-lineno"> 708</tt> <a class="py-toggle" href="#" id="IP.netmask_bits-toggle" onclick="return toggle('IP.netmask_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#netmask_bits">netmask_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> <tt class="py-comment">#FIXME: replace this</tt> </tt> +</div><a name="L709"></a><tt class="py-lineno"> 709</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L710"></a><tt class="py-lineno"> 710</tt> <tt class="py-line"><tt class="py-docstring"> @return: If this address is a valid netmask, the number of non-zero</tt> </tt> +<a name="L711"></a><tt class="py-lineno"> 711</tt> <tt class="py-line"><tt class="py-docstring"> bits are returned, otherwise it returns the width in bits for</tt> </tt> +<a name="L712"></a><tt class="py-lineno"> 712</tt> <tt class="py-line"><tt class="py-docstring"> based on the version, 32 for IPv4 and 128 for IPv6.</tt> </tt> +<a name="L713"></a><tt class="py-lineno"> 713</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L714"></a><tt class="py-lineno"> 714</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-331" class="py-name"><a title="netaddr.address.IP.is_netmask" class="py-name" href="#" onclick="return doclink('link-331', 'is_netmask', 'link-82');">is_netmask</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L715"></a><tt class="py-lineno"> 715</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-332" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-332', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> </tt> +<a name="L716"></a><tt class="py-lineno"> 716</tt> <tt class="py-line"> </tt> +<a name="L717"></a><tt class="py-lineno"> 717</tt> <tt class="py-line"> <tt id="link-333" class="py-name" targets="Method netaddr.address.Addr.bits()=netaddr.address.Addr-class.html#bits"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-333', 'bits', 'link-333');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-334" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-334', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-335" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_bits" class="py-name" href="#" onclick="return doclink('link-335', 'int_to_bits', 'link-159');">int_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-336" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-336', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L718"></a><tt class="py-lineno"> 718</tt> <tt class="py-line"> <tt class="py-name">mask_bits</tt> <tt class="py-op">=</tt> <tt id="link-337" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-337', 'bits', 'link-333');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">translate</tt><tt class="py-op">(</tt><tt id="link-338" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-338', 'IP', 'link-76');">IP</a></tt><tt class="py-op">.</tt><tt id="link-339" class="py-name"><a title="netaddr.address.IP.TRANSLATE_STR" class="py-name" href="#" onclick="return doclink('link-339', 'TRANSLATE_STR', 'link-308');">TRANSLATE_STR</a></tt><tt class="py-op">,</tt> <tt class="py-string">':.0'</tt><tt class="py-op">)</tt> </tt> +<a name="L719"></a><tt class="py-lineno"> 719</tt> <tt class="py-line"> <tt class="py-name">mask_length</tt> <tt class="py-op">=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">mask_bits</tt><tt class="py-op">)</tt> </tt> +<a name="L720"></a><tt class="py-lineno"> 720</tt> <tt class="py-line"> </tt> +<a name="L721"></a><tt class="py-lineno"> 721</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">1</tt> <tt class="py-op"><=</tt> <tt class="py-name">mask_length</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-340" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-340', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> +<a name="L722"></a><tt class="py-lineno"> 722</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'Unexpected mask length %d for address type!'</tt> \ </tt> +<a name="L723"></a><tt class="py-lineno"> 723</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">mask_length</tt><tt class="py-op">)</tt> </tt> +<a name="L724"></a><tt class="py-lineno"> 724</tt> <tt class="py-line"> </tt> +<a name="L725"></a><tt class="py-lineno"> 725</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">mask_length</tt> </tt> +</div><a name="L726"></a><tt class="py-lineno"> 726</tt> <tt class="py-line"> </tt> +<a name="IP.reverse_dns"></a><div id="IP.reverse_dns-def"><a name="L727"></a><tt class="py-lineno"> 727</tt> <a class="py-toggle" href="#" id="IP.reverse_dns-toggle" onclick="return toggle('IP.reverse_dns');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#reverse_dns">reverse_dns</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.reverse_dns-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.reverse_dns-expanded"><a name="L728"></a><tt class="py-lineno"> 728</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: The reverse DNS lookup string for this IP address"""</tt> </tt> +<a name="L729"></a><tt class="py-lineno"> 729</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-341" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-341', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-342" class="py-name" targets="Method netaddr.strategy.IPv4StrategyStd.int_to_arpa()=netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa,Method netaddr.strategy.IPv6Strategy.int_to_arpa()=netaddr.strategy.IPv6Strategy-class.html#int_to_arpa"><a title="netaddr.strategy.IPv4StrategyStd.int_to_arpa +netaddr.strategy.IPv6Strategy.int_to_arpa" class="py-name" href="#" onclick="return doclink('link-342', 'int_to_arpa', 'link-342');">int_to_arpa</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-343" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-343', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L730"></a><tt class="py-lineno"> 730</tt> <tt class="py-line"> </tt> +<a name="IP.is_hostmask"></a><div id="IP.is_hostmask-def"><a name="L731"></a><tt class="py-lineno"> 731</tt> <a class="py-toggle" href="#" id="IP.is_hostmask-toggle" onclick="return toggle('IP.is_hostmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_hostmask">is_hostmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_hostmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_hostmask-expanded"><a name="L732"></a><tt class="py-lineno"> 732</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L733"></a><tt class="py-lineno"> 733</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is a mask that would return a host</tt> </tt> +<a name="L734"></a><tt class="py-lineno"> 734</tt> <tt class="py-line"><tt class="py-docstring"> id, C{False} otherwise.</tt> </tt> +<a name="L735"></a><tt class="py-lineno"> 735</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L736"></a><tt class="py-lineno"> 736</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-344" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-344', 'value', 'link-30');">value</a></tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt> +<a name="L737"></a><tt class="py-lineno"> 737</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> </tt> +</div><a name="L738"></a><tt class="py-lineno"> 738</tt> <tt class="py-line"> </tt> +<a name="IP.hostname"></a><div id="IP.hostname-def"><a name="L739"></a><tt class="py-lineno"> 739</tt> <a class="py-toggle" href="#" id="IP.hostname-toggle" onclick="return toggle('IP.hostname');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#hostname">hostname</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.hostname-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.hostname-expanded"><a name="L740"></a><tt class="py-lineno"> 740</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L741"></a><tt class="py-lineno"> 741</tt> <tt class="py-line"><tt class="py-docstring"> @return: Returns the FQDN for this IP address via a DNS query</tt> </tt> +<a name="L742"></a><tt class="py-lineno"> 742</tt> <tt class="py-line"><tt class="py-docstring"> using gethostbyaddr() Python's socket module.</tt> </tt> +<a name="L743"></a><tt class="py-lineno"> 743</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L744"></a><tt class="py-lineno"> 744</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L745"></a><tt class="py-lineno"> 745</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">gethostbyaddr</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L746"></a><tt class="py-lineno"> 746</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L747"></a><tt class="py-lineno"> 747</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> +</div><a name="L748"></a><tt class="py-lineno"> 748</tt> <tt class="py-line"> </tt> +<a name="IP.cidr"></a><div id="IP.cidr-def"><a name="L749"></a><tt class="py-lineno"> 749</tt> <a class="py-toggle" href="#" id="IP.cidr-toggle" onclick="return toggle('IP.cidr');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#cidr">cidr</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.cidr-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.cidr-expanded"><a name="L750"></a><tt class="py-lineno"> 750</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: A L{CIDR} object based on this IP address"""</tt> </tt> +<a name="L751"></a><tt class="py-lineno"> 751</tt> <tt class="py-line"> <tt id="link-345" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-345', 'hostmask', 'link-112');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-346" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-287', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-288" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-288', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> -<a name="L691"></a><tt class="py-lineno"> 691</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-289" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-289', 'value', 'link-26');">value</a></tt> <tt class="py-op">|</tt> <tt id="link-290" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-290', 'hostmask', 'link-91');">hostmask</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-291" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-291', 'hostmask', 'link-91');">hostmask</a></tt> </tt> -<a name="L692"></a><tt class="py-lineno"> 692</tt> <tt class="py-line"> <tt class="py-name">network</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-292" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-346', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-347" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-347', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L752"></a><tt class="py-lineno"> 752</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-348" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-348', 'value', 'link-30');">value</a></tt> <tt class="py-op">|</tt> <tt id="link-349" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-349', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-350" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-350', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +<a name="L753"></a><tt class="py-lineno"> 753</tt> <tt class="py-line"> <tt id="link-351" class="py-name" targets="Variable netaddr.address.CIDR.network=netaddr.address.CIDR-class.html#network"><a title="netaddr.address.CIDR.network" class="py-name" href="#" onclick="return doclink('link-351', 'network', 'link-351');">network</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-352" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-292', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-293" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-352', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-353" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-293', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> -<a name="L693"></a><tt class="py-lineno"> 693</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-294" class="py-name" targets="Class netaddr.address.CIDR=netaddr.address.CIDR-class.html"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-294', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">"%s/%d"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">network</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-295" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-295', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L694"></a><tt class="py-lineno"> 694</tt> <tt class="py-line"> </tt> -<a name="IP.ipv4"></a><div id="IP.ipv4-def"><a name="L695"></a><tt class="py-lineno"> 695</tt> <a class="py-toggle" href="#" id="IP.ipv4-toggle" onclick="return toggle('IP.ipv4');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#ipv4">ipv4</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.ipv4-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.ipv4-expanded"><a name="L696"></a><tt class="py-lineno"> 696</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L697"></a><tt class="py-lineno"> 697</tt> <tt class="py-line"><tt class="py-docstring"> @return: A new L{IP} object numerically equivalent this address.</tt> </tt> -<a name="L698"></a><tt class="py-lineno"> 698</tt> <tt class="py-line"><tt class="py-docstring"> - If its address type is IPv4.</tt> </tt> -<a name="L699"></a><tt class="py-lineno"> 699</tt> <tt class="py-line"><tt class="py-docstring"> - If object's address type is IPv6 and its value is mappable to</tt> </tt> -<a name="L700"></a><tt class="py-lineno"> 700</tt> <tt class="py-line"><tt class="py-docstring"> IPv4, a new IPv4 L{IP} object is returned instead.</tt> </tt> -<a name="L701"></a><tt class="py-lineno"> 701</tt> <tt class="py-line"><tt class="py-docstring"> - Raises an L{AddrConversionError} if IPv6 address is not mappable</tt> </tt> -<a name="L702"></a><tt class="py-lineno"> 702</tt> <tt class="py-line"><tt class="py-docstring"> to IPv4.</tt> </tt> -<a name="L703"></a><tt class="py-lineno"> 703</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L704"></a><tt class="py-lineno"> 704</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> -<a name="L705"></a><tt class="py-lineno"> 705</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-296" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-296', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-297" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-297', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> -<a name="L706"></a><tt class="py-lineno"> 706</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-298" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-298', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-299" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-299', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt id="link-300" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-300', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">)</tt> </tt> -<a name="L707"></a><tt class="py-lineno"> 707</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-301" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-301', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-302" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-302', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> -<a name="L708"></a><tt class="py-lineno"> 708</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-303" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-303', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-304" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-304', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-305" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-305', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -<a name="L709"></a><tt class="py-lineno"> 709</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L710"></a><tt class="py-lineno"> 710</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-306" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-306', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-307" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-307', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt id="link-308" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-308', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">)</tt> </tt> -<a name="L711"></a><tt class="py-lineno"> 711</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">0</tt><tt class="py-op">,</tt><tt class="py-number">65535</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L712"></a><tt class="py-lineno"> 712</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-309" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-309', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-310" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-310', 'value', 'link-26');">value</a></tt> <tt class="py-op">-</tt> <tt class="py-number">0xffff00000000</tt><tt class="py-op">,</tt> <tt id="link-311" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-311', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">)</tt> </tt> -<a name="L713"></a><tt class="py-lineno"> 713</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L714"></a><tt class="py-lineno"> 714</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-312" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-312', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'IPv6 address %s too large for '</tt> \ </tt> -<a name="L715"></a><tt class="py-lineno"> 715</tt> <tt class="py-line"> <tt class="py-string">'conversion to IPv4!'</tt> <tt class="py-op">%</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt> </tt> -<a name="L716"></a><tt class="py-lineno"> 716</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">ip_addr</tt> </tt> -</div><a name="L717"></a><tt class="py-lineno"> 717</tt> <tt class="py-line"> </tt> -<a name="IP.ipv6"></a><div id="IP.ipv6-def"><a name="L718"></a><tt class="py-lineno"> 718</tt> <a class="py-toggle" href="#" id="IP.ipv6-toggle" onclick="return toggle('IP.ipv6');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#ipv6">ipv6</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.ipv6-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.ipv6-expanded"><a name="L719"></a><tt class="py-lineno"> 719</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L720"></a><tt class="py-lineno"> 720</tt> <tt class="py-line"><tt class="py-docstring"> @return: A new L{IP} object numerically equivalent this address.</tt> </tt> -<a name="L721"></a><tt class="py-lineno"> 721</tt> <tt class="py-line"><tt class="py-docstring"> - If object's address type is IPv6.</tt> </tt> -<a name="L722"></a><tt class="py-lineno"> 722</tt> <tt class="py-line"><tt class="py-docstring"> - If object's address type is IPv4 a new IPv6 L{IP} object, as a</tt> </tt> -<a name="L723"></a><tt class="py-lineno"> 723</tt> <tt class="py-line"><tt class="py-docstring"> IPv4 mapped address is returned instead. Uses the preferred IPv4</tt> </tt> -<a name="L724"></a><tt class="py-lineno"> 724</tt> <tt class="py-line"><tt class="py-docstring"> embedded in IPv6 form - C{::ffff:x.x.x.x} ('mapped' address) over</tt> </tt> -<a name="L725"></a><tt class="py-lineno"> 725</tt> <tt class="py-line"><tt class="py-docstring"> the (now deprecated) form - C{::x.x.x.x} ('compatible' address).</tt> </tt> -<a name="L726"></a><tt class="py-lineno"> 726</tt> <tt class="py-line"><tt class="py-docstring"> B{See RFC 4921 for details}.</tt> </tt> -<a name="L727"></a><tt class="py-lineno"> 727</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L728"></a><tt class="py-lineno"> 728</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> -<a name="L729"></a><tt class="py-lineno"> 729</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-313" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-313', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-314" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-314', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> -<a name="L730"></a><tt class="py-lineno"> 730</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-315" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-315', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-316" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-316', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt id="link-317" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-317', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L731"></a><tt class="py-lineno"> 731</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-318" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-318', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-319" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-319', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> -<a name="L732"></a><tt class="py-lineno"> 732</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-320" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-320', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-321" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-321', 'value', 'link-26');">value</a></tt><tt class="py-op">,</tt> <tt id="link-322" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-322', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L733"></a><tt class="py-lineno"> 733</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt><tt class="py-op">[</tt><tt class="py-number">5</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-number">0xffff</tt> </tt> -<a name="L734"></a><tt class="py-lineno"> 734</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">ip_addr</tt> </tt> -</div><a name="L735"></a><tt class="py-lineno"> 735</tt> <tt class="py-line"> </tt> -<a name="IP.is_unicast"></a><div id="IP.is_unicast-def"><a name="L736"></a><tt class="py-lineno"> 736</tt> <a class="py-toggle" href="#" id="IP.is_unicast-toggle" onclick="return toggle('IP.is_unicast');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_unicast">is_unicast</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.is_unicast-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_unicast-expanded"><a name="L737"></a><tt class="py-lineno"> 737</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L738"></a><tt class="py-lineno"> 738</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is unicast, C{False} otherwise.</tt> </tt> -<a name="L739"></a><tt class="py-lineno"> 739</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L740"></a><tt class="py-lineno"> 740</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-323" class="py-name" targets="Method netaddr.address.IP.is_multicast()=netaddr.address.IP-class.html#is_multicast"><a title="netaddr.address.IP.is_multicast" class="py-name" href="#" onclick="return doclink('link-323', 'is_multicast', 'link-323');">is_multicast</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L741"></a><tt class="py-lineno"> 741</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L742"></a><tt class="py-lineno"> 742</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L743"></a><tt class="py-lineno"> 743</tt> <tt class="py-line"> </tt> -<a name="IP.is_multicast"></a><div id="IP.is_multicast-def"><a name="L744"></a><tt class="py-lineno"> 744</tt> <a class="py-toggle" href="#" id="IP.is_multicast-toggle" onclick="return toggle('IP.is_multicast');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_multicast">is_multicast</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.is_multicast-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_multicast-expanded"><a name="L745"></a><tt class="py-lineno"> 745</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L746"></a><tt class="py-lineno"> 746</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this address is multicast, C{False} otherwise.</tt> </tt> -<a name="L747"></a><tt class="py-lineno"> 747</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L748"></a><tt class="py-lineno"> 748</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-324" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-324', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-325" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-325', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> -<a name="L749"></a><tt class="py-lineno"> 749</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0xe0000000</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-326" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-326', 'value', 'link-26');">value</a></tt> <tt class="py-op"><=</tt> <tt class="py-number">0xefffffff</tt><tt class="py-op">:</tt> </tt> -<a name="L750"></a><tt class="py-lineno"> 750</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L751"></a><tt class="py-lineno"> 751</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-327" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-327', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-328" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-328', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> -<a name="L752"></a><tt class="py-lineno"> 752</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0xff000000000000000000000000000000</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-329" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-329', 'value', 'link-26');">value</a></tt> <tt class="py-op"><=</tt> \ </tt> -<a name="L753"></a><tt class="py-lineno"> 753</tt> <tt class="py-line"> <tt class="py-number">0xffffffffffffffffffffffffffffffff</tt><tt class="py-op">:</tt> </tt> -<a name="L754"></a><tt class="py-lineno"> 754</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L755"></a><tt class="py-lineno"> 755</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L756"></a><tt class="py-lineno"> 756</tt> <tt class="py-line"> </tt> -<a name="IP.__str__"></a><div id="IP.__str__-def"><a name="L757"></a><tt class="py-lineno"> 757</tt> <a class="py-toggle" href="#" id="IP.__str__-toggle" onclick="return toggle('IP.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.__str__-expanded"><a name="L758"></a><tt class="py-lineno"> 758</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L759"></a><tt class="py-lineno"> 759</tt> <tt class="py-line"><tt class="py-docstring"> @return: The common string representation for this IP address.</tt> </tt> -<a name="L760"></a><tt class="py-lineno"> 760</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L761"></a><tt class="py-lineno"> 761</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-330" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-353', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> +<a name="L754"></a><tt class="py-lineno"> 754</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-354" class="py-name" targets="Class netaddr.address.CIDR=netaddr.address.CIDR-class.html"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-354', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">"%s/%d"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-355" class="py-name"><a title="netaddr.address.CIDR.network" class="py-name" href="#" onclick="return doclink('link-355', 'network', 'link-351');">network</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-356" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-356', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L755"></a><tt class="py-lineno"> 755</tt> <tt class="py-line"> </tt> +<a name="IP.wildcard"></a><div id="IP.wildcard-def"><a name="L756"></a><tt class="py-lineno"> 756</tt> <a class="py-toggle" href="#" id="IP.wildcard-toggle" onclick="return toggle('IP.wildcard');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#wildcard">wildcard</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.wildcard-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.wildcard-expanded"><a name="L757"></a><tt class="py-lineno"> 757</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: A L{Wildcard} object based on this IP address"""</tt> </tt> +<a name="L758"></a><tt class="py-lineno"> 758</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-357" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-357', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-358" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-358', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L759"></a><tt class="py-lineno"> 759</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-359" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-359', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'wildcards not support by IPv6!'</tt><tt class="py-op">)</tt> </tt> +<a name="L760"></a><tt class="py-lineno"> 760</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-360" class="py-name" targets="Method netaddr.address.IP.iprange()=netaddr.address.IP-class.html#iprange,Method netaddr.address.IPRange.iprange()=netaddr.address.IPRange-class.html#iprange"><a title="netaddr.address.IP.iprange +netaddr.address.IPRange.iprange" class="py-name" href="#" onclick="return doclink('link-360', 'iprange', 'link-360');">iprange</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-361" class="py-name" targets="Method netaddr.address.IP.wildcard()=netaddr.address.IP-class.html#wildcard,Method netaddr.address.IPRange.wildcard()=netaddr.address.IPRange-class.html#wildcard"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-361', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L761"></a><tt class="py-lineno"> 761</tt> <tt class="py-line"> </tt> +<a name="IP.iprange"></a><div id="IP.iprange-def"><a name="L762"></a><tt class="py-lineno"> 762</tt> <a class="py-toggle" href="#" id="IP.iprange-toggle" onclick="return toggle('IP.iprange');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#iprange">iprange</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.iprange-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.iprange-expanded"><a name="L763"></a><tt class="py-lineno"> 763</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: A L{CIDR} object based on this IP address"""</tt> </tt> +<a name="L764"></a><tt class="py-lineno"> 764</tt> <tt class="py-line"> <tt id="link-362" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-362', 'hostmask', 'link-112');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-363" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-363', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-364" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-364', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L765"></a><tt class="py-lineno"> 765</tt> <tt class="py-line"> <tt id="link-365" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-365', 'netmask', 'link-88');">netmask</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-366" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-330', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-331" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-366', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">^</tt> <tt id="link-367" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-367', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +<a name="L766"></a><tt class="py-lineno"> 766</tt> <tt class="py-line"> <tt id="link-368" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-368', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-369" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-369', 'value', 'link-30');">value</a></tt> <tt class="py-op">|</tt> <tt id="link-370" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-370', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-371" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-371', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +<a name="L767"></a><tt class="py-lineno"> 767</tt> <tt class="py-line"> <tt id="link-372" class="py-name" targets="Variable netaddr.address.IPRange.last=netaddr.address.IPRange-class.html#last"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-372', 'last', 'link-372');">last</a></tt> <tt class="py-op">=</tt> <tt id="link-373" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-373', 'first', 'link-110');">first</a></tt> <tt class="py-op">|</tt> <tt id="link-374" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-374', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +<a name="L768"></a><tt class="py-lineno"> 768</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-375" class="py-name" targets="Class netaddr.address.IPRange=netaddr.address.IPRange-class.html"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-375', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-376" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-376', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-377" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-331', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-332" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-332', 'value', 'link-26');">value</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L762"></a><tt class="py-lineno"> 762</tt> <tt class="py-line"> </tt> -<a name="IP.__repr__"></a><div id="IP.__repr__-def"><a name="L763"></a><tt class="py-lineno"> 763</tt> <a class="py-toggle" href="#" id="IP.__repr__-toggle" onclick="return toggle('IP.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IP.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.__repr__-expanded"><a name="L764"></a><tt class="py-lineno"> 764</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L765"></a><tt class="py-lineno"> 765</tt> <tt class="py-line"><tt class="py-docstring"> @return: An executable Python statement that can recreate an object</tt> </tt> -<a name="L766"></a><tt class="py-lineno"> 766</tt> <tt class="py-line"><tt class="py-docstring"> with an equivalent state.</tt> </tt> -<a name="L767"></a><tt class="py-lineno"> 767</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L768"></a><tt class="py-lineno"> 768</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-333" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-333', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-334" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-334', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> -<a name="L769"></a><tt class="py-lineno"> 769</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s('%s')"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> </tt> -<a name="L770"></a><tt class="py-lineno"> 770</tt> <tt class="py-line"> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L771"></a><tt class="py-lineno"> 771</tt> <tt class="py-line"> </tt> -<a name="L772"></a><tt class="py-lineno"> 772</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s('%s/%d')"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> </tt> -<a name="L773"></a><tt class="py-lineno"> 773</tt> <tt class="py-line"> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-335" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-335', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L774"></a><tt class="py-lineno"> 774</tt> <tt class="py-line"> </tt> -<a name="L775"></a><tt class="py-lineno"> 775</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L776"></a><tt class="py-lineno"> 776</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Address aggregate classes.</tt> </tt> -<a name="L777"></a><tt class="py-lineno"> 777</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L778"></a><tt class="py-lineno"> 778</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="nrange"></a><div id="nrange-def"><a name="L779"></a><tt class="py-lineno"> 779</tt> <a class="py-toggle" href="#" id="nrange-toggle" onclick="return toggle('nrange');">-</a><tt class="py-line"><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address-module.html#nrange">nrange</a><tt class="py-op">(</tt><tt class="py-param">start</tt><tt class="py-op">,</tt> <tt class="py-param">stop</tt><tt class="py-op">,</tt> <tt class="py-param">step</tt><tt class="py-op">=</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> <tt class="py-param">klass</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="nrange-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="nrange-expanded"><a name="L780"></a><tt class="py-lineno"> 780</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L781"></a><tt class="py-lineno"> 781</tt> <tt class="py-line"><tt class="py-docstring"> A generator producing sequences of network addresses based on start and</tt> </tt> -<a name="L782"></a><tt class="py-lineno"> 782</tt> <tt class="py-line"><tt class="py-docstring"> stop values, in intervals of step.</tt> </tt> -<a name="L783"></a><tt class="py-lineno"> 783</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L784"></a><tt class="py-lineno"> 784</tt> <tt class="py-line"><tt class="py-docstring"> @param start: first network address as string or instance of L{Addr}</tt> </tt> -<a name="L785"></a><tt class="py-lineno"> 785</tt> <tt class="py-line"><tt class="py-docstring"> (sub)class.</tt> </tt> -<a name="L786"></a><tt class="py-lineno"> 786</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L787"></a><tt class="py-lineno"> 787</tt> <tt class="py-line"><tt class="py-docstring"> @param stop: last network address as string or instance of L{Addr}</tt> </tt> -<a name="L788"></a><tt class="py-lineno"> 788</tt> <tt class="py-line"><tt class="py-docstring"> (sub)class.</tt> </tt> -<a name="L789"></a><tt class="py-lineno"> 789</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L790"></a><tt class="py-lineno"> 790</tt> <tt class="py-line"><tt class="py-docstring"> @param step: (optional) size of step between addresses in range.</tt> </tt> -<a name="L791"></a><tt class="py-lineno"> 791</tt> <tt class="py-line"><tt class="py-docstring"> Default is 1.</tt> </tt> -<a name="L792"></a><tt class="py-lineno"> 792</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L793"></a><tt class="py-lineno"> 793</tt> <tt class="py-line"><tt class="py-docstring"> @param klass: (optional) the class used to create objects returned.</tt> </tt> -<a name="L794"></a><tt class="py-lineno"> 794</tt> <tt class="py-line"><tt class="py-docstring"> Default: L{Addr} class.</tt> </tt> -<a name="L795"></a><tt class="py-lineno"> 795</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L796"></a><tt class="py-lineno"> 796</tt> <tt class="py-line"><tt class="py-docstring"> - C{str} returns string representation of network address</tt> </tt> -<a name="L797"></a><tt class="py-lineno"> 797</tt> <tt class="py-line"><tt class="py-docstring"> - C{int}, C{long} and C{hex} return expected values</tt> </tt> -<a name="L798"></a><tt class="py-lineno"> 798</tt> <tt class="py-line"><tt class="py-docstring"> - L{Addr} (sub)class or duck type* return objects of that class. If</tt> </tt> -<a name="L799"></a><tt class="py-lineno"> 799</tt> <tt class="py-line"><tt class="py-docstring"> you use your own duck class, make sure you handle both arguments</tt> </tt> -<a name="L800"></a><tt class="py-lineno"> 800</tt> <tt class="py-line"><tt class="py-docstring"> C{(addr_value, addr_type)} passed to the constructor.</tt> </tt> -<a name="L801"></a><tt class="py-lineno"> 801</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L802"></a><tt class="py-lineno"> 802</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt id="link-336" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-336', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L803"></a><tt class="py-lineno"> 803</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L804"></a><tt class="py-lineno"> 804</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt id="link-337" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-337', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> -<a name="L805"></a><tt class="py-lineno"> 805</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L806"></a><tt class="py-lineno"> 806</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'start is not recognised address in string '</tt> \ </tt> -<a name="L807"></a><tt class="py-lineno"> 807</tt> <tt class="py-line"> <tt class="py-string">'format or an that is a (sub)class of Addr!'</tt><tt class="py-op">)</tt> </tt> -<a name="L808"></a><tt class="py-lineno"> 808</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L809"></a><tt class="py-lineno"> 809</tt> <tt class="py-line"> <tt class="py-comment"># Make klass the same class as start object.</tt> </tt> -<a name="L810"></a><tt class="py-lineno"> 810</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt id="link-338" class="py-name" targets="Variable netaddr.address.AddrRange.klass=netaddr.address.AddrRange-class.html#klass,Variable netaddr.address.CIDR.klass=netaddr.address.CIDR-class.html#klass,Variable netaddr.address.Wildcard.klass=netaddr.address.Wildcard-class.html#klass"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-338', 'klass', 'link-338');">klass</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L811"></a><tt class="py-lineno"> 811</tt> <tt class="py-line"> <tt id="link-339" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-339', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt> </tt> -<a name="L812"></a><tt class="py-lineno"> 812</tt> <tt class="py-line"> </tt> -<a name="L813"></a><tt class="py-lineno"> 813</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt id="link-340" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-340', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L814"></a><tt class="py-lineno"> 814</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L815"></a><tt class="py-lineno"> 815</tt> <tt class="py-line"> <tt class="py-name">stop</tt> <tt class="py-op">=</tt> <tt id="link-341" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-341', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">)</tt> </tt> -<a name="L816"></a><tt class="py-lineno"> 816</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L817"></a><tt class="py-lineno"> 817</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'stop is not recognised address in string '</tt> \ </tt> -<a name="L818"></a><tt class="py-lineno"> 818</tt> <tt class="py-line"> <tt class="py-string">'format or an that is a (sub)class of Addr!'</tt><tt class="py-op">)</tt> </tt> -<a name="L819"></a><tt class="py-lineno"> 819</tt> <tt class="py-line"> </tt> -<a name="L820"></a><tt class="py-lineno"> 820</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">step</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L821"></a><tt class="py-lineno"> 821</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'step must be type int|long, not %s!'</tt> <tt class="py-op">%</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">step</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L822"></a><tt class="py-lineno"> 822</tt> <tt class="py-line"> </tt> -<a name="L823"></a><tt class="py-lineno"> 823</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt id="link-342" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-342', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">stop</tt><tt class="py-op">.</tt><tt id="link-343" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-343', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">:</tt> </tt> -<a name="L824"></a><tt class="py-lineno"> 824</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'start and stop are not the same address type!'</tt><tt class="py-op">)</tt> </tt> -<a name="L825"></a><tt class="py-lineno"> 825</tt> <tt class="py-line"> </tt> -<a name="L826"></a><tt class="py-lineno"> 826</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">step</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> -<a name="L827"></a><tt class="py-lineno"> 827</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'step argument cannot be zero'</tt><tt class="py-op">)</tt> </tt> -<a name="L828"></a><tt class="py-lineno"> 828</tt> <tt class="py-line"> </tt> -<a name="L829"></a><tt class="py-lineno"> 829</tt> <tt class="py-line"> <tt class="py-name">negative_step</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L830"></a><tt class="py-lineno"> 830</tt> <tt class="py-line"> <tt id="link-344" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-344', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt id="link-345" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-345', 'addr_type', 'link-39');">addr_type</a></tt> </tt> -<a name="L831"></a><tt class="py-lineno"> 831</tt> <tt class="py-line"> </tt> -<a name="L832"></a><tt class="py-lineno"> 832</tt> <tt class="py-line"> <tt class="py-comment"># We don't need objects from here onwards. Basic integer values will do</tt> </tt> -<a name="L833"></a><tt class="py-lineno"> 833</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># just fine.</tt> </tt> -<a name="L834"></a><tt class="py-lineno"> 834</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">start_klass</tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt> </tt> -<a name="L835"></a><tt class="py-lineno"> 835</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> -<a name="L836"></a><tt class="py-lineno"> 836</tt> <tt class="py-line"> <tt class="py-name">stop</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">)</tt> </tt> -<a name="L837"></a><tt class="py-lineno"> 837</tt> <tt class="py-line"> </tt> -<a name="L838"></a><tt class="py-lineno"> 838</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">step</tt> <tt class="py-op"><</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> -<a name="L839"></a><tt class="py-lineno"> 839</tt> <tt class="py-line"> <tt class="py-name">negative_step</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L840"></a><tt class="py-lineno"> 840</tt> <tt class="py-line"> </tt> -<a name="L841"></a><tt class="py-lineno"> 841</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt> <tt class="py-op">-</tt> <tt class="py-name">step</tt> </tt> -<a name="L842"></a><tt class="py-lineno"> 842</tt> <tt class="py-line"> </tt> -<a name="L843"></a><tt class="py-lineno"> 843</tt> <tt class="py-line"> <tt class="py-comment"># Set default klass value.</tt> </tt> -<a name="L844"></a><tt class="py-lineno"> 844</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt id="link-346" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-346', 'klass', 'link-338');">klass</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L845"></a><tt class="py-lineno"> 845</tt> <tt class="py-line"> <tt id="link-347" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-347', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">=</tt> <tt id="link-348" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-348', 'Addr', 'link-32');">Addr</a></tt> </tt> -<a name="L846"></a><tt class="py-lineno"> 846</tt> <tt class="py-line"> </tt> -<a name="L847"></a><tt class="py-lineno"> 847</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-349" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-349', 'klass', 'link-338');">klass</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">,</tt> <tt class="py-name">hex</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L848"></a><tt class="py-lineno"> 848</tt> <tt class="py-line"> <tt class="py-comment"># Yield network address integer values.</tt> </tt> -<a name="L849"></a><tt class="py-lineno"> 849</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L850"></a><tt class="py-lineno"> 850</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">+=</tt> <tt class="py-name">step</tt> </tt> -<a name="L851"></a><tt class="py-lineno"> 851</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">negative_step</tt><tt class="py-op">:</tt> </tt> -<a name="L852"></a><tt class="py-lineno"> 852</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op">>=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> -<a name="L853"></a><tt class="py-lineno"> 853</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> -<a name="L854"></a><tt class="py-lineno"> 854</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L855"></a><tt class="py-lineno"> 855</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> -<a name="L856"></a><tt class="py-lineno"> 856</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> -<a name="L857"></a><tt class="py-lineno"> 857</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt id="link-350" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-350', 'klass', 'link-338');">klass</a></tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> -<a name="L858"></a><tt class="py-lineno"> 858</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-351" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-351', 'klass', 'link-338');">klass</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L859"></a><tt class="py-lineno"> 859</tt> <tt class="py-line"> <tt class="py-comment"># Yield address string values.</tt> </tt> -<a name="L860"></a><tt class="py-lineno"> 860</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L861"></a><tt class="py-lineno"> 861</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">+=</tt> <tt class="py-name">step</tt> </tt> -<a name="L862"></a><tt class="py-lineno"> 862</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">negative_step</tt><tt class="py-op">:</tt> </tt> -<a name="L863"></a><tt class="py-lineno"> 863</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op">>=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> -<a name="L864"></a><tt class="py-lineno"> 864</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> -<a name="L865"></a><tt class="py-lineno"> 865</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L866"></a><tt class="py-lineno"> 866</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> -<a name="L867"></a><tt class="py-lineno"> 867</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> -<a name="L868"></a><tt class="py-lineno"> 868</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">start_klass</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt id="link-352" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-352', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L869"></a><tt class="py-lineno"> 869</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L870"></a><tt class="py-lineno"> 870</tt> <tt class="py-line"> <tt class="py-comment"># Yield network address objects.</tt> </tt> -<a name="L871"></a><tt class="py-lineno"> 871</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L872"></a><tt class="py-lineno"> 872</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">+=</tt> <tt class="py-name">step</tt> </tt> -<a name="L873"></a><tt class="py-lineno"> 873</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">negative_step</tt><tt class="py-op">:</tt> </tt> -<a name="L874"></a><tt class="py-lineno"> 874</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op">>=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> -<a name="L875"></a><tt class="py-lineno"> 875</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> -<a name="L876"></a><tt class="py-lineno"> 876</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L877"></a><tt class="py-lineno"> 877</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> -<a name="L878"></a><tt class="py-lineno"> 878</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> -<a name="L879"></a><tt class="py-lineno"> 879</tt> <tt class="py-line"> </tt> -<a name="L880"></a><tt class="py-lineno"> 880</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt id="link-353" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-353', 'klass', 'link-338');">klass</a></tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt id="link-354" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-354', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L881"></a><tt class="py-lineno"> 881</tt> <tt class="py-line"> </tt> -<a name="L882"></a><tt class="py-lineno"> 882</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="AddrRange"></a><div id="AddrRange-def"><a name="L883"></a><tt class="py-lineno"> 883</tt> <a class="py-toggle" href="#" id="AddrRange-toggle" onclick="return toggle('AddrRange');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html">AddrRange</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="AddrRange-expanded"><a name="L884"></a><tt class="py-lineno"> 884</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L885"></a><tt class="py-lineno"> 885</tt> <tt class="py-line"><tt class="py-docstring"> A block of contiguous network addresses bounded by an arbitrary start and</tt> </tt> -<a name="L886"></a><tt class="py-lineno"> 886</tt> <tt class="py-line"><tt class="py-docstring"> stop address. There is no requirement that they fall on strict bit mask</tt> </tt> -<a name="L887"></a><tt class="py-lineno"> 887</tt> <tt class="py-line"><tt class="py-docstring"> boundaries, unlike L{CIDR} addresses.</tt> </tt> -<a name="L888"></a><tt class="py-lineno"> 888</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L889"></a><tt class="py-lineno"> 889</tt> <tt class="py-line"><tt class="py-docstring"> This is the only network address aggregate supporting all network address</tt> </tt> -<a name="L890"></a><tt class="py-lineno"> 890</tt> <tt class="py-line"><tt class="py-docstring"> types. Most AddrRange subclasses usually only support a subset of address</tt> </tt> -<a name="L891"></a><tt class="py-lineno"> 891</tt> <tt class="py-line"><tt class="py-docstring"> types.</tt> </tt> -<a name="L892"></a><tt class="py-lineno"> 892</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L893"></a><tt class="py-lineno"> 893</tt> <tt class="py-line"><tt class="py-docstring"> A sequence of address ranges sort first by address type then by magnitude.</tt> </tt> -<a name="L894"></a><tt class="py-lineno"> 894</tt> <tt class="py-line"><tt class="py-docstring"> So for a list containing ranges of all currently supported address types,</tt> </tt> -<a name="L895"></a><tt class="py-lineno"> 895</tt> <tt class="py-line"><tt class="py-docstring"> IPv4 ranges come first, then IPv6, EUI-48 and lastly EUI-64.</tt> </tt> -<a name="L896"></a><tt class="py-lineno"> 896</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L897"></a><tt class="py-lineno"> 897</tt> <tt class="py-line"> <tt id="link-355" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-377', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt id="link-378" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-378', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L769"></a><tt class="py-lineno"> 769</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-379" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-379', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-380" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.EUI48Strategy.int_to_str +netaddr.strategy.IPv4StrategyOpt.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-380', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt id="link-381" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-381', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L770"></a><tt class="py-lineno"> 770</tt> <tt class="py-line"> </tt> +<a name="IP.ipv4"></a><div id="IP.ipv4-def"><a name="L771"></a><tt class="py-lineno"> 771</tt> <a class="py-toggle" href="#" id="IP.ipv4-toggle" onclick="return toggle('IP.ipv4');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#ipv4">ipv4</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.ipv4-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.ipv4-expanded"><a name="L772"></a><tt class="py-lineno"> 772</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L773"></a><tt class="py-lineno"> 773</tt> <tt class="py-line"><tt class="py-docstring"> @return: A new version 4 L{IP} object numerically equivalent this</tt> </tt> +<a name="L774"></a><tt class="py-lineno"> 774</tt> <tt class="py-line"><tt class="py-docstring"> address. If this object is already IPv4 then a copy is returned. If</tt> </tt> +<a name="L775"></a><tt class="py-lineno"> 775</tt> <tt class="py-line"><tt class="py-docstring"> this object is IPv6 and its value is compatible with IPv4, a new IPv4</tt> </tt> +<a name="L776"></a><tt class="py-lineno"> 776</tt> <tt class="py-line"><tt class="py-docstring"> L{IP} object is returned.</tt> </tt> +<a name="L777"></a><tt class="py-lineno"> 777</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L778"></a><tt class="py-lineno"> 778</tt> <tt class="py-line"><tt class="py-docstring"> Raises an L{AddrConversionError} is IPv6 address cannot be converted.</tt> </tt> +<a name="L779"></a><tt class="py-lineno"> 779</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L780"></a><tt class="py-lineno"> 780</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L781"></a><tt class="py-lineno"> 781</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-382" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-382', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-383" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-383', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L782"></a><tt class="py-lineno"> 782</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-384" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-384', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-385" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-385', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt id="link-386" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-386', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">)</tt> </tt> +<a name="L783"></a><tt class="py-lineno"> 783</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-387" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-387', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-388" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-388', 'prefixlen', 'link-73');">prefixlen</a></tt> </tt> +<a name="L784"></a><tt class="py-lineno"> 784</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-389" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-389', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-390" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-390', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L785"></a><tt class="py-lineno"> 785</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-391" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-391', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-392" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-392', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-393" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-393', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +<a name="L786"></a><tt class="py-lineno"> 786</tt> <tt class="py-line"> <tt class="py-comment">#TODO: Replace these with bit shifts.</tt> </tt> +<a name="L787"></a><tt class="py-lineno"> 787</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L788"></a><tt class="py-lineno"> 788</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-394" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-394', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-395" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-395', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt id="link-396" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-396', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">)</tt> </tt> +<a name="L789"></a><tt class="py-lineno"> 789</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-397" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-397', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-398" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-398', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">-</tt> <tt class="py-number">96</tt> </tt> +<a name="L790"></a><tt class="py-lineno"> 790</tt> <tt class="py-line"> <tt class="py-comment">#TODO: Replace these with bit shifts.</tt> </tt> +<a name="L791"></a><tt class="py-lineno"> 791</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">elif</tt> <tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">6</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">0xffff</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L792"></a><tt class="py-lineno"> 792</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-399" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-399', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-400" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-400', 'value', 'link-30');">value</a></tt> <tt class="py-op">-</tt> <tt class="py-number">0xffff00000000</tt><tt class="py-op">,</tt> <tt id="link-401" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-401', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">)</tt> </tt> +<a name="L793"></a><tt class="py-lineno"> 793</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-402" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-402', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-403" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-403', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">+</tt> <tt class="py-number">96</tt> </tt> +<a name="L794"></a><tt class="py-lineno"> 794</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L795"></a><tt class="py-lineno"> 795</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-404" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-404', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'IPv6 address %s not suitable for'</tt> \ </tt> +<a name="L796"></a><tt class="py-lineno"> 796</tt> <tt class="py-line"> <tt class="py-string">'IPv4 conversion!'</tt> <tt class="py-op">%</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt> </tt> +<a name="L797"></a><tt class="py-lineno"> 797</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">ip_addr</tt> </tt> +</div><a name="L798"></a><tt class="py-lineno"> 798</tt> <tt class="py-line"> </tt> +<a name="IP.ipv6"></a><div id="IP.ipv6-def"><a name="L799"></a><tt class="py-lineno"> 799</tt> <a class="py-toggle" href="#" id="IP.ipv6-toggle" onclick="return toggle('IP.ipv6');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#ipv6">ipv6</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">ipv4_compatible</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.ipv6-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.ipv6-expanded"><a name="L800"></a><tt class="py-lineno"> 800</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L801"></a><tt class="py-lineno"> 801</tt> <tt class="py-line"><tt class="py-docstring"> B{Please Note:} the IPv4-Mapped IPv6 address format is now considered</tt> </tt> +<a name="L802"></a><tt class="py-lineno"> 802</tt> <tt class="py-line"><tt class="py-docstring"> deprecated. Reference: RFC 4291</tt> </tt> +<a name="L803"></a><tt class="py-lineno"> 803</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L804"></a><tt class="py-lineno"> 804</tt> <tt class="py-line"><tt class="py-docstring"> @param ipv4_compatible: If C{True} returns an IPv4-Mapped address</tt> </tt> +<a name="L805"></a><tt class="py-lineno"> 805</tt> <tt class="py-line"><tt class="py-docstring"> (::ffff:x.x.x.x), an IPv4-Compatible (::x.x.x.x) address</tt> </tt> +<a name="L806"></a><tt class="py-lineno"> 806</tt> <tt class="py-line"><tt class="py-docstring"> otherwise. Default: False (IPv4-Mapped).</tt> </tt> +<a name="L807"></a><tt class="py-lineno"> 807</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L808"></a><tt class="py-lineno"> 808</tt> <tt class="py-line"><tt class="py-docstring"> @return: A new L{IP} version 6 object that is numerically equivalent</tt> </tt> +<a name="L809"></a><tt class="py-lineno"> 809</tt> <tt class="py-line"><tt class="py-docstring"> this address. If this object is already IPv6 then a copy of this</tt> </tt> +<a name="L810"></a><tt class="py-lineno"> 810</tt> <tt class="py-line"><tt class="py-docstring"> object is returned. If this object is IPv4, a new version 6 L{IP}</tt> </tt> +<a name="L811"></a><tt class="py-lineno"> 811</tt> <tt class="py-line"><tt class="py-docstring"> object is returned.</tt> </tt> +<a name="L812"></a><tt class="py-lineno"> 812</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L813"></a><tt class="py-lineno"> 813</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L814"></a><tt class="py-lineno"> 814</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-405" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-405', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-406" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-406', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L815"></a><tt class="py-lineno"> 815</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-407" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-407', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-408" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-408', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt id="link-409" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-409', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L816"></a><tt class="py-lineno"> 816</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-410" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-410', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-411" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-411', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">-</tt> <tt class="py-number">96</tt> </tt> +<a name="L817"></a><tt class="py-lineno"> 817</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-412" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-412', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-413" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-413', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L818"></a><tt class="py-lineno"> 818</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt> <tt class="py-op">=</tt> <tt id="link-414" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-414', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-415" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-415', 'value', 'link-30');">value</a></tt><tt class="py-op">,</tt> <tt id="link-416" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-416', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L819"></a><tt class="py-lineno"> 819</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ipv4_compatible</tt><tt class="py-op">:</tt> </tt> +<a name="L820"></a><tt class="py-lineno"> 820</tt> <tt class="py-line"> <tt class="py-comment"># IPv4-Compatible IPv6 address</tt> </tt> +<a name="L821"></a><tt class="py-lineno"> 821</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">ip_addr</tt><tt class="py-op">[</tt><tt class="py-number">5</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> +<a name="L822"></a><tt class="py-lineno"> 822</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L823"></a><tt class="py-lineno"> 823</tt> <tt class="py-line"> <tt class="py-comment"># IPv4-Mapped IPv6 address</tt> </tt> +<a name="L824"></a><tt class="py-lineno"> 824</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">ip_addr</tt><tt class="py-op">[</tt><tt class="py-number">5</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-number">0xffff</tt> </tt> +<a name="L825"></a><tt class="py-lineno"> 825</tt> <tt class="py-line"> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-417" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-417', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-418" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-418', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">+</tt> <tt class="py-number">96</tt> </tt> +<a name="L826"></a><tt class="py-lineno"> 826</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">ip_addr</tt> </tt> +</div><a name="L827"></a><tt class="py-lineno"> 827</tt> <tt class="py-line"> </tt> +<a name="IP.is_unicast"></a><div id="IP.is_unicast-def"><a name="L828"></a><tt class="py-lineno"> 828</tt> <a class="py-toggle" href="#" id="IP.is_unicast-toggle" onclick="return toggle('IP.is_unicast');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_unicast">is_unicast</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_unicast-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_unicast-expanded"><a name="L829"></a><tt class="py-lineno"> 829</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: C{True} if this IP is unicast, C{False} otherwise"""</tt> </tt> +<a name="L830"></a><tt class="py-lineno"> 830</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-419" class="py-name" targets="Method netaddr.address.IP.is_multicast()=netaddr.address.IP-class.html#is_multicast"><a title="netaddr.address.IP.is_multicast" class="py-name" href="#" onclick="return doclink('link-419', 'is_multicast', 'link-419');">is_multicast</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L831"></a><tt class="py-lineno"> 831</tt> <tt class="py-line"> </tt> +<a name="IP.is_loopback"></a><div id="IP.is_loopback-def"><a name="L832"></a><tt class="py-lineno"> 832</tt> <a class="py-toggle" href="#" id="IP.is_loopback-toggle" onclick="return toggle('IP.is_loopback');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_loopback">is_loopback</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_loopback-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_loopback-expanded"><a name="L833"></a><tt class="py-lineno"> 833</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L834"></a><tt class="py-lineno"> 834</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this IP is loopback address (not for network</tt> </tt> +<a name="L835"></a><tt class="py-lineno"> 835</tt> <tt class="py-line"><tt class="py-docstring"> transmission), C{False} otherwise.</tt> </tt> +<a name="L836"></a><tt class="py-lineno"> 836</tt> <tt class="py-line"><tt class="py-docstring"> References: RFC 3330 and 4291.</tt> </tt> +<a name="L837"></a><tt class="py-lineno"> 837</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L838"></a><tt class="py-lineno"> 838</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-420" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-420', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-421" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-421', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L839"></a><tt class="py-lineno"> 839</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-422" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-422', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'127/8'</tt><tt class="py-op">)</tt> </tt> +<a name="L840"></a><tt class="py-lineno"> 840</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-423" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-423', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-424" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-424', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L841"></a><tt class="py-lineno"> 841</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> <tt class="py-op">==</tt> <tt id="link-425" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-425', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-string">'::1'</tt><tt class="py-op">)</tt> </tt> +</div><a name="L842"></a><tt class="py-lineno"> 842</tt> <tt class="py-line"> </tt> +<a name="IP.is_multicast"></a><div id="IP.is_multicast-def"><a name="L843"></a><tt class="py-lineno"> 843</tt> <a class="py-toggle" href="#" id="IP.is_multicast-toggle" onclick="return toggle('IP.is_multicast');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_multicast">is_multicast</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_multicast-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_multicast-expanded"><a name="L844"></a><tt class="py-lineno"> 844</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: C{True} if this IP is multicast, C{False} otherwise"""</tt> </tt> +<a name="L845"></a><tt class="py-lineno"> 845</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-426" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-426', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-427" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-427', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L846"></a><tt class="py-lineno"> 846</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-428" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-428', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'224/4'</tt><tt class="py-op">)</tt> </tt> +<a name="L847"></a><tt class="py-lineno"> 847</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-429" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-429', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-430" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-430', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L848"></a><tt class="py-lineno"> 848</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-431" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-431', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'ff00::/8'</tt><tt class="py-op">)</tt> </tt> +</div><a name="L849"></a><tt class="py-lineno"> 849</tt> <tt class="py-line"> </tt> +<a name="IP.is_private"></a><div id="IP.is_private-def"><a name="L850"></a><tt class="py-lineno"> 850</tt> <a class="py-toggle" href="#" id="IP.is_private-toggle" onclick="return toggle('IP.is_private');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_private">is_private</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_private-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_private-expanded"><a name="L851"></a><tt class="py-lineno"> 851</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L852"></a><tt class="py-lineno"> 852</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this IP is for internal/private use only</tt> </tt> +<a name="L853"></a><tt class="py-lineno"> 853</tt> <tt class="py-line"><tt class="py-docstring"> (i.e. non-public), C{False} otherwise. Reference: RFCs 1918,</tt> </tt> +<a name="L854"></a><tt class="py-lineno"> 854</tt> <tt class="py-line"><tt class="py-docstring"> 3330, 4193, 3879 and 2365.</tt> </tt> +<a name="L855"></a><tt class="py-lineno"> 855</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L856"></a><tt class="py-lineno"> 856</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-432" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-432', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-433" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-433', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L857"></a><tt class="py-lineno"> 857</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-434" class="py-name" targets="Method netaddr.address.IP.cidr()=netaddr.address.IP-class.html#cidr"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-434', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt id="link-435" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-435', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'192.168/16'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt id="link-436" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-436', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'10/8'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt><tt id="link-437" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-437', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'172.16/12'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L858"></a><tt class="py-lineno"> 858</tt> <tt class="py-line"> <tt id="link-438" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-438', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'192.0.2.0/24'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt id="link-439" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-439', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'239.192/14'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L859"></a><tt class="py-lineno"> 859</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-440" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-440', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">:</tt> </tt> +<a name="L860"></a><tt class="py-lineno"> 860</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L861"></a><tt class="py-lineno"> 861</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-441" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-441', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-442" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-442', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L862"></a><tt class="py-lineno"> 862</tt> <tt class="py-line"> <tt class="py-comment"># Please Note: FEC0::/10 has been deprecated! See RFC 3879.</tt> </tt> +<a name="L863"></a><tt class="py-lineno"> 863</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-443" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-443', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'fc00::/7'</tt><tt class="py-op">)</tt> <tt class="py-comment"># ULAs - Unique Local Addresses</tt> </tt> +<a name="L864"></a><tt class="py-lineno"> 864</tt> <tt class="py-line"> </tt> +<a name="L865"></a><tt class="py-lineno"> 865</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-444" class="py-name" targets="Method netaddr.address.IP.is_link_local()=netaddr.address.IP-class.html#is_link_local"><a title="netaddr.address.IP.is_link_local" class="py-name" href="#" onclick="return doclink('link-444', 'is_link_local', 'link-444');">is_link_local</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L866"></a><tt class="py-lineno"> 866</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L867"></a><tt class="py-lineno"> 867</tt> <tt class="py-line"> </tt> +<a name="L868"></a><tt class="py-lineno"> 868</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L869"></a><tt class="py-lineno"> 869</tt> <tt class="py-line"> </tt> +<a name="IP.is_link_local"></a><div id="IP.is_link_local-def"><a name="L870"></a><tt class="py-lineno"> 870</tt> <a class="py-toggle" href="#" id="IP.is_link_local-toggle" onclick="return toggle('IP.is_link_local');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_link_local">is_link_local</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_link_local-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_link_local-expanded"><a name="L871"></a><tt class="py-lineno"> 871</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L872"></a><tt class="py-lineno"> 872</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this IP is link-local address C{False} otherwise.</tt> </tt> +<a name="L873"></a><tt class="py-lineno"> 873</tt> <tt class="py-line"><tt class="py-docstring"> Reference: RFCs 3927 and 4291.</tt> </tt> +<a name="L874"></a><tt class="py-lineno"> 874</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L875"></a><tt class="py-lineno"> 875</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-445" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-445', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-446" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-446', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L876"></a><tt class="py-lineno"> 876</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-447" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-447', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'169.254/16'</tt><tt class="py-op">)</tt> </tt> +<a name="L877"></a><tt class="py-lineno"> 877</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-448" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-448', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-449" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-449', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L878"></a><tt class="py-lineno"> 878</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-450" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-450', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'fe80::/10'</tt><tt class="py-op">)</tt> </tt> +</div><a name="L879"></a><tt class="py-lineno"> 879</tt> <tt class="py-line"> </tt> +<a name="IP.is_reserved"></a><div id="IP.is_reserved-def"><a name="L880"></a><tt class="py-lineno"> 880</tt> <a class="py-toggle" href="#" id="IP.is_reserved-toggle" onclick="return toggle('IP.is_reserved');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_reserved">is_reserved</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_reserved-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_reserved-expanded"><a name="L881"></a><tt class="py-lineno"> 881</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L882"></a><tt class="py-lineno"> 882</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this IP is in IANA reserved range, C{False}</tt> </tt> +<a name="L883"></a><tt class="py-lineno"> 883</tt> <tt class="py-line"><tt class="py-docstring"> otherwise. Reference: RFCs 3330 and 3171.</tt> </tt> +<a name="L884"></a><tt class="py-lineno"> 884</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L885"></a><tt class="py-lineno"> 885</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-451" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-451', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-452" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-452', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L886"></a><tt class="py-lineno"> 886</tt> <tt class="py-line"> <tt class="py-comment"># Use of wildcards here much more concise than CIDR...</tt> </tt> +<a name="L887"></a><tt class="py-lineno"> 887</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">for</tt> <tt id="link-453" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-453', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt id="link-454" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-454', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'240/4'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt id="link-455" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-455', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'234/7'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt id="link-456" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-456', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'236/7'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L888"></a><tt class="py-lineno"> 888</tt> <tt class="py-line"> <tt id="link-457" class="py-name" targets="Class netaddr.address.Wildcard=netaddr.address.Wildcard-class.html"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-457', 'Wildcard', 'link-457');">Wildcard</a></tt><tt class="py-op">(</tt><tt class="py-string">'225-231.*.*.*'</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt id="link-458" class="py-name"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-458', 'Wildcard', 'link-457');">Wildcard</a></tt><tt class="py-op">(</tt><tt class="py-string">'234-238.*.*.*'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L889"></a><tt class="py-lineno"> 889</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt> <tt class="py-keyword">in</tt> <tt id="link-459" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-459', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">:</tt> </tt> +<a name="L890"></a><tt class="py-lineno"> 890</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L891"></a><tt class="py-lineno"> 891</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L892"></a><tt class="py-lineno"> 892</tt> <tt class="py-line"> </tt> +<a name="IP.is_ipv4_mapped"></a><div id="IP.is_ipv4_mapped-def"><a name="L893"></a><tt class="py-lineno"> 893</tt> <a class="py-toggle" href="#" id="IP.is_ipv4_mapped-toggle" onclick="return toggle('IP.is_ipv4_mapped');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_ipv4_mapped">is_ipv4_mapped</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_ipv4_mapped-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_ipv4_mapped-expanded"><a name="L894"></a><tt class="py-lineno"> 894</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L895"></a><tt class="py-lineno"> 895</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this IP is IPv4-compatible IPv6 address, C{False}</tt> </tt> +<a name="L896"></a><tt class="py-lineno"> 896</tt> <tt class="py-line"><tt class="py-docstring"> otherwise.</tt> </tt> +<a name="L897"></a><tt class="py-lineno"> 897</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L898"></a><tt class="py-lineno"> 898</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-460" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-460', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-461" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-461', 'AT_INET6', 'link-5');">AT_INET6</a></tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-462" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-462', 'value', 'link-30');">value</a></tt> <tt class="py-op">>></tt> <tt class="py-number">32</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">0xffff</tt> </tt> +</div><a name="L899"></a><tt class="py-lineno"> 899</tt> <tt class="py-line"> </tt> +<a name="IP.is_ipv4_compat"></a><div id="IP.is_ipv4_compat-def"><a name="L900"></a><tt class="py-lineno"> 900</tt> <a class="py-toggle" href="#" id="IP.is_ipv4_compat-toggle" onclick="return toggle('IP.is_ipv4_compat');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#is_ipv4_compat">is_ipv4_compat</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.is_ipv4_compat-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.is_ipv4_compat-expanded"><a name="L901"></a><tt class="py-lineno"> 901</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L902"></a><tt class="py-lineno"> 902</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if this IP is IPv4-mapped IPv6 address, C{False}</tt> </tt> +<a name="L903"></a><tt class="py-lineno"> 903</tt> <tt class="py-line"><tt class="py-docstring"> otherwise.</tt> </tt> +<a name="L904"></a><tt class="py-lineno"> 904</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L905"></a><tt class="py-lineno"> 905</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-463" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-463', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-464" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-464', 'AT_INET6', 'link-5');">AT_INET6</a></tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-465" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-465', 'value', 'link-30');">value</a></tt> <tt class="py-op">>></tt> <tt class="py-number">32</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt> </tt> +</div><a name="L906"></a><tt class="py-lineno"> 906</tt> <tt class="py-line"> </tt> +<a name="IP.info"></a><div id="IP.info-def"><a name="L907"></a><tt class="py-lineno"> 907</tt> <a class="py-toggle" href="#" id="IP.info-toggle" onclick="return toggle('IP.info');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#info">info</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.info-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.info-expanded"><a name="L908"></a><tt class="py-lineno"> 908</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L909"></a><tt class="py-lineno"> 909</tt> <tt class="py-line"><tt class="py-docstring"> @return: A record dict containing IANA registration details for this</tt> </tt> +<a name="L910"></a><tt class="py-lineno"> 910</tt> <tt class="py-line"><tt class="py-docstring"> IP address if available, None otherwise.</tt> </tt> +<a name="L911"></a><tt class="py-lineno"> 911</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L912"></a><tt class="py-lineno"> 912</tt> <tt class="py-line"> <tt class="py-comment"># This import is placed here for efficiency. If you don't call this</tt> </tt> +<a name="L913"></a><tt class="py-lineno"> 913</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># method, you don't take the (small), one time, import start up</tt> </tt> +<a name="L914"></a><tt class="py-lineno"> 914</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># penalty. Also gets around a nasty module dependency issue.</tt> </tt> +<a name="L915"></a><tt class="py-lineno"> 915</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Two birds, one stone ...</tt> </tt> +<a name="L916"></a><tt class="py-lineno"> 916</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">import</tt> <tt id="link-466" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-466', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-467" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-467', 'ip', 'link-75');">ip</a></tt> </tt> +<a name="L917"></a><tt class="py-lineno"> 917</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-468" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-468', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-469" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-469', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-470" class="py-name" targets="Function netaddr.ip.query()=netaddr.ip-module.html#query"><a title="netaddr.ip.query" class="py-name" href="#" onclick="return doclink('link-470', 'query', 'link-470');">query</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt> +</div><a name="L918"></a><tt class="py-lineno"> 918</tt> <tt class="py-line"> </tt> +<a name="IP.__str__"></a><div id="IP.__str__-def"><a name="L919"></a><tt class="py-lineno"> 919</tt> <a class="py-toggle" href="#" id="IP.__str__-toggle" onclick="return toggle('IP.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.__str__-expanded"><a name="L920"></a><tt class="py-lineno"> 920</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: common string representation for this IP address"""</tt> </tt> +<a name="L921"></a><tt class="py-lineno"> 921</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-471" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-471', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-472" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.EUI48Strategy.int_to_str +netaddr.strategy.IPv4StrategyOpt.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-472', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-473" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-473', 'value', 'link-30');">value</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L922"></a><tt class="py-lineno"> 922</tt> <tt class="py-line"> </tt> +<a name="IP.__repr__"></a><div id="IP.__repr__-def"><a name="L923"></a><tt class="py-lineno"> 923</tt> <a class="py-toggle" href="#" id="IP.__repr__-toggle" onclick="return toggle('IP.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IP-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IP.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IP.__repr__-expanded"><a name="L924"></a><tt class="py-lineno"> 924</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object."""</tt> </tt> +<a name="L925"></a><tt class="py-lineno"> 925</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-474" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-474', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-475" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-475', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> +<a name="L926"></a><tt class="py-lineno"> 926</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s('%s')"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L927"></a><tt class="py-lineno"> 927</tt> <tt class="py-line"> </tt> +<a name="L928"></a><tt class="py-lineno"> 928</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s('%s/%d')"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L929"></a><tt class="py-lineno"> 929</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-476" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-476', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L930"></a><tt class="py-lineno"> 930</tt> <tt class="py-line"> </tt> +<a name="L931"></a><tt class="py-lineno"> 931</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="nrange"></a><div id="nrange-def"><a name="L932"></a><tt class="py-lineno"> 932</tt> <a class="py-toggle" href="#" id="nrange-toggle" onclick="return toggle('nrange');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address-module.html#nrange">nrange</a><tt class="py-op">(</tt><tt class="py-param">start</tt><tt class="py-op">,</tt> <tt class="py-param">stop</tt><tt class="py-op">,</tt> <tt class="py-param">step</tt><tt class="py-op">=</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="nrange-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="nrange-expanded"><a name="L933"></a><tt class="py-lineno"> 933</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L934"></a><tt class="py-lineno"> 934</tt> <tt class="py-line"><tt class="py-docstring"> An xrange work alike generator that produces sequences of IP addresses</tt> </tt> +<a name="L935"></a><tt class="py-lineno"> 935</tt> <tt class="py-line"><tt class="py-docstring"> based on start and stop addresses, in intervals of step size.</tt> </tt> +<a name="L936"></a><tt class="py-lineno"> 936</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L937"></a><tt class="py-lineno"> 937</tt> <tt class="py-line"><tt class="py-docstring"> @param start: first IP address string or L{IP} object in range.</tt> </tt> +<a name="L938"></a><tt class="py-lineno"> 938</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L939"></a><tt class="py-lineno"> 939</tt> <tt class="py-line"><tt class="py-docstring"> @param stop: last IP address string or L{IP} object in range</tt> </tt> +<a name="L940"></a><tt class="py-lineno"> 940</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L941"></a><tt class="py-lineno"> 941</tt> <tt class="py-line"><tt class="py-docstring"> @param step: (optional) size of step between address in range.</tt> </tt> +<a name="L942"></a><tt class="py-lineno"> 942</tt> <tt class="py-line"><tt class="py-docstring"> (Default: 1)</tt> </tt> +<a name="L943"></a><tt class="py-lineno"> 943</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L944"></a><tt class="py-lineno"> 944</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: (optional) callable used on addresses returned.</tt> </tt> +<a name="L945"></a><tt class="py-lineno"> 945</tt> <tt class="py-line"><tt class="py-docstring"> (Default: None - L{IP} objects). Supported options :-</tt> </tt> +<a name="L946"></a><tt class="py-lineno"> 946</tt> <tt class="py-line"><tt class="py-docstring"> - C{str} - IP address strings</tt> </tt> +<a name="L947"></a><tt class="py-lineno"> 947</tt> <tt class="py-line"><tt class="py-docstring"> - C{int}, C{long} - IP address integer (network byte order)</tt> </tt> +<a name="L948"></a><tt class="py-lineno"> 948</tt> <tt class="py-line"><tt class="py-docstring"> - C{hex} - IP address as a hexadecimal number</tt> </tt> +<a name="L949"></a><tt class="py-lineno"> 949</tt> <tt class="py-line"><tt class="py-docstring"> - L{IP} class/subclass or callable that accepts C{addr_value} and</tt> </tt> +<a name="L950"></a><tt class="py-lineno"> 950</tt> <tt class="py-line"><tt class="py-docstring"> C{addr_type} arguments.</tt> </tt> +<a name="L951"></a><tt class="py-lineno"> 951</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L952"></a><tt class="py-lineno"> 952</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt id="link-477" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-477', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L953"></a><tt class="py-lineno"> 953</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L954"></a><tt class="py-lineno"> 954</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt id="link-478" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-478', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> +<a name="L955"></a><tt class="py-lineno"> 955</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L956"></a><tt class="py-lineno"> 956</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'start is not recognised address in string '</tt> \ </tt> +<a name="L957"></a><tt class="py-lineno"> 957</tt> <tt class="py-line"> <tt class="py-string">'format or IP class/subclass instance!'</tt><tt class="py-op">)</tt> </tt> +<a name="L958"></a><tt class="py-lineno"> 958</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L959"></a><tt class="py-lineno"> 959</tt> <tt class="py-line"> <tt class="py-comment"># Use start object's constructor as formatter.</tt> </tt> +<a name="L960"></a><tt class="py-lineno"> 960</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt id="link-479" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-479', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L961"></a><tt class="py-lineno"> 961</tt> <tt class="py-line"> <tt id="link-480" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-480', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt> </tt> +<a name="L962"></a><tt class="py-lineno"> 962</tt> <tt class="py-line"> </tt> +<a name="L963"></a><tt class="py-lineno"> 963</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">,</tt> <tt id="link-481" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-481', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L964"></a><tt class="py-lineno"> 964</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L965"></a><tt class="py-lineno"> 965</tt> <tt class="py-line"> <tt class="py-name">stop</tt> <tt class="py-op">=</tt> <tt id="link-482" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-482', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">)</tt> </tt> +<a name="L966"></a><tt class="py-lineno"> 966</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L967"></a><tt class="py-lineno"> 967</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'stop is not recognised address string '</tt> \ </tt> +<a name="L968"></a><tt class="py-lineno"> 968</tt> <tt class="py-line"> <tt class="py-string">'or IP class/subclass instance!'</tt><tt class="py-op">)</tt> </tt> +<a name="L969"></a><tt class="py-lineno"> 969</tt> <tt class="py-line"> </tt> +<a name="L970"></a><tt class="py-lineno"> 970</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">step</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L971"></a><tt class="py-lineno"> 971</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'step must be type int|long, not %s!'</tt> <tt class="py-op">%</tt> <tt class="py-name">type</tt><tt class="py-op">(</tt><tt class="py-name">step</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L972"></a><tt class="py-lineno"> 972</tt> <tt class="py-line"> </tt> +<a name="L973"></a><tt class="py-lineno"> 973</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt id="link-483" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-483', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">stop</tt><tt class="py-op">.</tt><tt id="link-484" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-484', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +<a name="L974"></a><tt class="py-lineno"> 974</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'start and stop are not the same address type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L975"></a><tt class="py-lineno"> 975</tt> <tt class="py-line"> </tt> +<a name="L976"></a><tt class="py-lineno"> 976</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">step</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L977"></a><tt class="py-lineno"> 977</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'step argument cannot be zero'</tt><tt class="py-op">)</tt> </tt> +<a name="L978"></a><tt class="py-lineno"> 978</tt> <tt class="py-line"> </tt> +<a name="L979"></a><tt class="py-lineno"> 979</tt> <tt class="py-line"> <tt class="py-name">negative_step</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L980"></a><tt class="py-lineno"> 980</tt> <tt class="py-line"> <tt id="link-485" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-485', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt id="link-486" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-486', 'addr_type', 'link-43');">addr_type</a></tt> </tt> +<a name="L981"></a><tt class="py-lineno"> 981</tt> <tt class="py-line"> </tt> +<a name="L982"></a><tt class="py-lineno"> 982</tt> <tt class="py-line"> <tt class="py-comment"># We don't need objects from here onwards. Basic integer values will do</tt> </tt> +<a name="L983"></a><tt class="py-lineno"> 983</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># just fine.</tt> </tt> +<a name="L984"></a><tt class="py-lineno"> 984</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">start_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt> </tt> +<a name="L985"></a><tt class="py-lineno"> 985</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> +<a name="L986"></a><tt class="py-lineno"> 986</tt> <tt class="py-line"> <tt class="py-name">stop</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">stop</tt><tt class="py-op">)</tt> </tt> +<a name="L987"></a><tt class="py-lineno"> 987</tt> <tt class="py-line"> </tt> +<a name="L988"></a><tt class="py-lineno"> 988</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">step</tt> <tt class="py-op"><</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L989"></a><tt class="py-lineno"> 989</tt> <tt class="py-line"> <tt class="py-name">negative_step</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L990"></a><tt class="py-lineno"> 990</tt> <tt class="py-line"> </tt> +<a name="L991"></a><tt class="py-lineno"> 991</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">=</tt> <tt class="py-name">start</tt> <tt class="py-op">-</tt> <tt class="py-name">step</tt> </tt> +<a name="L992"></a><tt class="py-lineno"> 992</tt> <tt class="py-line"> </tt> +<a name="L993"></a><tt class="py-lineno"> 993</tt> <tt class="py-line"> <tt class="py-comment"># Default formatter.</tt> </tt> +<a name="L994"></a><tt class="py-lineno"> 994</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt id="link-487" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-487', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L995"></a><tt class="py-lineno"> 995</tt> <tt class="py-line"> <tt id="link-488" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-488', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">=</tt> <tt id="link-489" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-489', 'IP', 'link-76');">IP</a></tt> </tt> +<a name="L996"></a><tt class="py-lineno"> 996</tt> <tt class="py-line"> </tt> +<a name="L997"></a><tt class="py-lineno"> 997</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-490" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-490', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">,</tt> <tt class="py-name">hex</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L998"></a><tt class="py-lineno"> 998</tt> <tt class="py-line"> <tt class="py-comment"># Yield network address integer values.</tt> </tt> +<a name="L999"></a><tt class="py-lineno"> 999</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L1000"></a><tt class="py-lineno">1000</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">+=</tt> <tt class="py-name">step</tt> </tt> +<a name="L1001"></a><tt class="py-lineno">1001</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">negative_step</tt><tt class="py-op">:</tt> </tt> +<a name="L1002"></a><tt class="py-lineno">1002</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op">>=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> +<a name="L1003"></a><tt class="py-lineno">1003</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> +<a name="L1004"></a><tt class="py-lineno">1004</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1005"></a><tt class="py-lineno">1005</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> +<a name="L1006"></a><tt class="py-lineno">1006</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> +<a name="L1007"></a><tt class="py-lineno">1007</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt id="link-491" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-491', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> +<a name="L1008"></a><tt class="py-lineno">1008</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-492" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-492', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1009"></a><tt class="py-lineno">1009</tt> <tt class="py-line"> <tt class="py-comment"># Yield address string values.</tt> </tt> +<a name="L1010"></a><tt class="py-lineno">1010</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L1011"></a><tt class="py-lineno">1011</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">+=</tt> <tt class="py-name">step</tt> </tt> +<a name="L1012"></a><tt class="py-lineno">1012</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">negative_step</tt><tt class="py-op">:</tt> </tt> +<a name="L1013"></a><tt class="py-lineno">1013</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op">>=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> +<a name="L1014"></a><tt class="py-lineno">1014</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> +<a name="L1015"></a><tt class="py-lineno">1015</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1016"></a><tt class="py-lineno">1016</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> +<a name="L1017"></a><tt class="py-lineno">1017</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> +<a name="L1018"></a><tt class="py-lineno">1018</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">start_fmt</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt id="link-493" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-493', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1019"></a><tt class="py-lineno">1019</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1020"></a><tt class="py-lineno">1020</tt> <tt class="py-line"> <tt class="py-comment"># Yield network address objects.</tt> </tt> +<a name="L1021"></a><tt class="py-lineno">1021</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L1022"></a><tt class="py-lineno">1022</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">+=</tt> <tt class="py-name">step</tt> </tt> +<a name="L1023"></a><tt class="py-lineno">1023</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">negative_step</tt><tt class="py-op">:</tt> </tt> +<a name="L1024"></a><tt class="py-lineno">1024</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op">>=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> +<a name="L1025"></a><tt class="py-lineno">1025</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> +<a name="L1026"></a><tt class="py-lineno">1026</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1027"></a><tt class="py-lineno">1027</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-name">stop</tt><tt class="py-op">:</tt> </tt> +<a name="L1028"></a><tt class="py-lineno">1028</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> </tt> +<a name="L1029"></a><tt class="py-lineno">1029</tt> <tt class="py-line"> </tt> +<a name="L1030"></a><tt class="py-lineno">1030</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt id="link-494" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-494', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt id="link-495" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-495', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L1031"></a><tt class="py-lineno">1031</tt> <tt class="py-line"> </tt> +<a name="L1032"></a><tt class="py-lineno">1032</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IPRange"></a><div id="IPRange-def"><a name="L1033"></a><tt class="py-lineno">1033</tt> <a class="py-toggle" href="#" id="IPRange-toggle" onclick="return toggle('IPRange');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html">IPRange</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="IPRange-expanded"><a name="L1034"></a><tt class="py-lineno">1034</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1035"></a><tt class="py-lineno">1035</tt> <tt class="py-line"><tt class="py-docstring"> Represents arbitrary contiguous blocks of IPv4 and IPv6 addresses using</tt> </tt> +<a name="L1036"></a><tt class="py-lineno">1036</tt> <tt class="py-line"><tt class="py-docstring"> only a lower and upper bound IP address.</tt> </tt> +<a name="L1037"></a><tt class="py-lineno">1037</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1038"></a><tt class="py-lineno">1038</tt> <tt class="py-line"><tt class="py-docstring"> It is the base class for more specialised block types such as L{CIDR()}</tt> </tt> +<a name="L1039"></a><tt class="py-lineno">1039</tt> <tt class="py-line"><tt class="py-docstring"> and L{Wildcard()}. There is no requirement that the boundary IP addresses</tt> </tt> +<a name="L1040"></a><tt class="py-lineno">1040</tt> <tt class="py-line"><tt class="py-docstring"> fall on strict bitmask boundaries.</tt> </tt> +<a name="L1041"></a><tt class="py-lineno">1041</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1042"></a><tt class="py-lineno">1042</tt> <tt class="py-line"><tt class="py-docstring"> The sort order for sequence of mixed version L{IPRange} objects is IPv4</tt> </tt> +<a name="L1043"></a><tt class="py-lineno">1043</tt> <tt class="py-line"><tt class="py-docstring"> followed by IPv6, based on the range's magnitude (size).</tt> </tt> +<a name="L1044"></a><tt class="py-lineno">1044</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1045"></a><tt class="py-lineno">1045</tt> <tt class="py-line"> <tt id="link-496" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-355', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-356" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-356', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-357" class="py-name"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-357', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">,</tt> <tt id="link-358" class="py-name"><a title="netaddr.ST_EUI48 -netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-358', 'ST_EUI48', 'link-13');">ST_EUI48</a></tt><tt class="py-op">,</tt> <tt id="link-359" class="py-name"><a title="netaddr.ST_EUI64 -netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-359', 'ST_EUI64', 'link-14');">ST_EUI64</a></tt><tt class="py-op">)</tt> </tt> -<a name="L898"></a><tt class="py-lineno"> 898</tt> <tt class="py-line"> <tt id="link-360" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-496', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-497" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-497', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-498" class="py-name"><a title="netaddr.ST_IPV6 +netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-498', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1046"></a><tt class="py-lineno">1046</tt> <tt class="py-line"> <tt id="link-499" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-360', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-361" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-361', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-362" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-362', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-363" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-363', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">,</tt> <tt id="link-364" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-364', 'AT_LINK', 'link-6');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-365" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-365', 'AT_EUI64', 'link-7');">AT_EUI64</a></tt><tt class="py-op">)</tt> </tt> -<a name="L899"></a><tt class="py-lineno"> 899</tt> <tt class="py-line"> </tt> -<a name="L900"></a><tt class="py-lineno"> 900</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> -<a name="L901"></a><tt class="py-lineno"> 901</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-366" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-499', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-500" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-500', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-501" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-501', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-502" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-502', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1047"></a><tt class="py-lineno">1047</tt> <tt class="py-line"> </tt> +<a name="L1048"></a><tt class="py-lineno">1048</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> +<a name="L1049"></a><tt class="py-lineno">1049</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-503" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-366', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-367" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-367', 'StrategyDescriptor', 'link-123');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-368" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-503', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-504" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-504', 'StrategyDescriptor', 'link-142');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-505" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-368', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L902"></a><tt class="py-lineno"> 902</tt> <tt class="py-line"> <tt id="link-369" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-505', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1050"></a><tt class="py-lineno">1050</tt> <tt class="py-line"> <tt id="link-506" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-369', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-370" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-370', 'AddrTypeDescriptor', 'link-126');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-371" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-506', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-507" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-507', 'AddrTypeDescriptor', 'link-145');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-508" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-371', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L903"></a><tt class="py-lineno"> 903</tt> <tt class="py-line"> <tt id="link-372" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-372', 'first', 'link-89');">first</a></tt> <tt class="py-op">=</tt> <tt id="link-373" class="py-name"><a title="netaddr.address.AddrValueDescriptor" class="py-name" href="#" onclick="return doclink('link-373', 'AddrValueDescriptor', 'link-121');">AddrValueDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'first'</tt><tt class="py-op">)</tt> </tt> -<a name="L904"></a><tt class="py-lineno"> 904</tt> <tt class="py-line"> <tt id="link-374" class="py-name" targets="Variable netaddr.address.AddrRange.last=netaddr.address.AddrRange-class.html#last"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-374', 'last', 'link-374');">last</a></tt> <tt class="py-op">=</tt> <tt id="link-375" class="py-name"><a title="netaddr.address.AddrValueDescriptor" class="py-name" href="#" onclick="return doclink('link-375', 'AddrValueDescriptor', 'link-121');">AddrValueDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'last'</tt><tt class="py-op">)</tt> </tt> -<a name="L905"></a><tt class="py-lineno"> 905</tt> <tt class="py-line"> <tt id="link-376" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-376', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">=</tt> <tt id="link-377" class="py-name" targets="Class netaddr.address.KlassDescriptor=netaddr.address.KlassDescriptor-class.html"><a title="netaddr.address.KlassDescriptor" class="py-name" href="#" onclick="return doclink('link-377', 'KlassDescriptor', 'link-377');">KlassDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-378" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-378', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">)</tt> </tt> -<a name="L906"></a><tt class="py-lineno"> 906</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__init__"></a><div id="AddrRange.__init__-def"><a name="L907"></a><tt class="py-lineno"> 907</tt> <a class="py-toggle" href="#" id="AddrRange.__init__-toggle" onclick="return toggle('AddrRange.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">first</tt><tt class="py-op">,</tt> <tt class="py-param">last</tt><tt class="py-op">,</tt> <tt class="py-param">klass</tt><tt class="py-op">=</tt><tt id="link-379" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-379', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__init__-expanded"><a name="L908"></a><tt class="py-lineno"> 908</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L909"></a><tt class="py-lineno"> 909</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L910"></a><tt class="py-lineno"> 910</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L911"></a><tt class="py-lineno"> 911</tt> <tt class="py-line"><tt class="py-docstring"> @param first: start address for this network address range.</tt> </tt> -<a name="L912"></a><tt class="py-lineno"> 912</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L913"></a><tt class="py-lineno"> 913</tt> <tt class="py-line"><tt class="py-docstring"> @param last: stop address for this network address range.</tt> </tt> -<a name="L914"></a><tt class="py-lineno"> 914</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L915"></a><tt class="py-lineno"> 915</tt> <tt class="py-line"><tt class="py-docstring"> @param klass: (optional) class used to create each object returned.</tt> </tt> -<a name="L916"></a><tt class="py-lineno"> 916</tt> <tt class="py-line"><tt class="py-docstring"> Default: L{Addr()} objects. See L{nrange()} documentations for</tt> </tt> -<a name="L917"></a><tt class="py-lineno"> 917</tt> <tt class="py-line"><tt class="py-docstring"> additional details on options.</tt> </tt> -<a name="L918"></a><tt class="py-lineno"> 918</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L919"></a><tt class="py-lineno"> 919</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-380" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-380', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-381" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-381', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt> </tt> -<a name="L920"></a><tt class="py-lineno"> 920</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-382" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-382', 'first', 'link-89');">first</a></tt> <tt class="py-op">=</tt> <tt id="link-383" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-383', 'first', 'link-89');">first</a></tt> </tt> -<a name="L921"></a><tt class="py-lineno"> 921</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-384" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-384', 'last', 'link-374');">last</a></tt> <tt class="py-op">=</tt> <tt id="link-385" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-385', 'last', 'link-374');">last</a></tt> </tt> -<a name="L922"></a><tt class="py-lineno"> 922</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-386" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-386', 'last', 'link-374');">last</a></tt> <tt class="py-op"><</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-387" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-387', 'first', 'link-89');">first</a></tt><tt class="py-op">:</tt> </tt> -<a name="L923"></a><tt class="py-lineno"> 923</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'start address is greater than stop address!'</tt><tt class="py-op">)</tt> </tt> -<a name="L924"></a><tt class="py-lineno"> 924</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-388" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-388', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">=</tt> <tt id="link-389" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-389', 'klass', 'link-338');">klass</a></tt> </tt> -</div><a name="L925"></a><tt class="py-lineno"> 925</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__hash__"></a><div id="AddrRange.__hash__-def"><a name="L926"></a><tt class="py-lineno"> 926</tt> <a class="py-toggle" href="#" id="AddrRange.__hash__-toggle" onclick="return toggle('AddrRange.__hash__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__hash__">__hash__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__hash__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__hash__-expanded"><a name="L927"></a><tt class="py-lineno"> 927</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L928"></a><tt class="py-lineno"> 928</tt> <tt class="py-line"><tt class="py-docstring"> @return: The hash of this address range. Allow them to be used in sets</tt> </tt> -<a name="L929"></a><tt class="py-lineno"> 929</tt> <tt class="py-line"><tt class="py-docstring"> and as keys in dictionaries.</tt> </tt> -<a name="L930"></a><tt class="py-lineno"> 930</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L931"></a><tt class="py-lineno"> 931</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hash</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-390" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-390', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-391" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-391', 'last', 'link-374');">last</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-392" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-392', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L932"></a><tt class="py-lineno"> 932</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__len__"></a><div id="AddrRange.__len__-def"><a name="L933"></a><tt class="py-lineno"> 933</tt> <a class="py-toggle" href="#" id="AddrRange.__len__-toggle" onclick="return toggle('AddrRange.__len__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__len__">__len__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__len__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__len__-expanded"><a name="L934"></a><tt class="py-lineno"> 934</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L935"></a><tt class="py-lineno"> 935</tt> <tt class="py-line"><tt class="py-docstring"> @return: The total number of network addresses in this range.</tt> </tt> -<a name="L936"></a><tt class="py-lineno"> 936</tt> <tt class="py-line"><tt class="py-docstring"> - Use this method only for ranges that contain less than</tt> </tt> -<a name="L937"></a><tt class="py-lineno"> 937</tt> <tt class="py-line"><tt class="py-docstring"> C{2^31} addresses or try the L{size()} method. Raises an</tt> </tt> -<a name="L938"></a><tt class="py-lineno"> 938</tt> <tt class="py-line"><tt class="py-docstring"> C{IndexError} if size is exceeded.</tt> </tt> -<a name="L939"></a><tt class="py-lineno"> 939</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L940"></a><tt class="py-lineno"> 940</tt> <tt class="py-line"> <tt id="link-393" class="py-name" targets="Method netaddr.address.AddrRange.size()=netaddr.address.AddrRange-class.html#size"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-393', 'size', 'link-393');">size</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-394" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-394', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L941"></a><tt class="py-lineno"> 941</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-395" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-395', 'size', 'link-393');">size</a></tt> <tt class="py-op">></tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-number">31</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L942"></a><tt class="py-lineno"> 942</tt> <tt class="py-line"> <tt class="py-comment"># Use size() method in this class instead as len() will b0rk!</tt> </tt> -<a name="L943"></a><tt class="py-lineno"> 943</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">"range contains more than 2^31 addresses! "</tt> \ </tt> -<a name="L944"></a><tt class="py-lineno"> 944</tt> <tt class="py-line"> <tt class="py-string">"Use size() method instead."</tt><tt class="py-op">)</tt> </tt> -<a name="L945"></a><tt class="py-lineno"> 945</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-396" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-396', 'size', 'link-393');">size</a></tt> </tt> -</div><a name="L946"></a><tt class="py-lineno"> 946</tt> <tt class="py-line"> </tt> -<a name="AddrRange.size"></a><div id="AddrRange.size-def"><a name="L947"></a><tt class="py-lineno"> 947</tt> <a class="py-toggle" href="#" id="AddrRange.size-toggle" onclick="return toggle('AddrRange.size');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#size">size</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.size-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.size-expanded"><a name="L948"></a><tt class="py-lineno"> 948</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L949"></a><tt class="py-lineno"> 949</tt> <tt class="py-line"><tt class="py-docstring"> @return: The total number of network addresses in this range.</tt> </tt> -<a name="L950"></a><tt class="py-lineno"> 950</tt> <tt class="py-line"><tt class="py-docstring"> - Use this method in preference to L{__len__()} when size of</tt> </tt> -<a name="L951"></a><tt class="py-lineno"> 951</tt> <tt class="py-line"><tt class="py-docstring"> ranges exceeds C{2^31} addresses.</tt> </tt> -<a name="L952"></a><tt class="py-lineno"> 952</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L953"></a><tt class="py-lineno"> 953</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-397" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-397', 'last', 'link-374');">last</a></tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-398" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-398', 'first', 'link-89');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt> -</div><a name="L954"></a><tt class="py-lineno"> 954</tt> <tt class="py-line"> </tt> -<a name="AddrRange.data_flavour"></a><div id="AddrRange.data_flavour-def"><a name="L955"></a><tt class="py-lineno"> 955</tt> <a class="py-toggle" href="#" id="AddrRange.data_flavour-toggle" onclick="return toggle('AddrRange.data_flavour');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#data_flavour">data_flavour</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.data_flavour-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.data_flavour-expanded"><a name="L956"></a><tt class="py-lineno"> 956</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L957"></a><tt class="py-lineno"> 957</tt> <tt class="py-line"><tt class="py-docstring"> @param int_addr: an network address as a network byte order integer.</tt> </tt> -<a name="L958"></a><tt class="py-lineno"> 958</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L959"></a><tt class="py-lineno"> 959</tt> <tt class="py-line"><tt class="py-docstring"> @return: a network address in whatever 'flavour' is required based on</tt> </tt> -<a name="L960"></a><tt class="py-lineno"> 960</tt> <tt class="py-line"><tt class="py-docstring"> the value of the klass property.</tt> </tt> -<a name="L961"></a><tt class="py-lineno"> 961</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L962"></a><tt class="py-lineno"> 962</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-399" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-399', 'klass', 'link-338');">klass</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L963"></a><tt class="py-lineno"> 963</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-400" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-400', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-401" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-508', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1051"></a><tt class="py-lineno">1051</tt> <tt class="py-line"> <tt id="link-509" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-509', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt id="link-510" class="py-name"><a title="netaddr.address.AddrValueDescriptor" class="py-name" href="#" onclick="return doclink('link-510', 'AddrValueDescriptor', 'link-140');">AddrValueDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'first'</tt><tt class="py-op">)</tt> </tt> +<a name="L1052"></a><tt class="py-lineno">1052</tt> <tt class="py-line"> <tt id="link-511" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-511', 'last', 'link-372');">last</a></tt> <tt class="py-op">=</tt> <tt id="link-512" class="py-name"><a title="netaddr.address.AddrValueDescriptor" class="py-name" href="#" onclick="return doclink('link-512', 'AddrValueDescriptor', 'link-140');">AddrValueDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'last'</tt><tt class="py-op">)</tt> </tt> +<a name="L1053"></a><tt class="py-lineno">1053</tt> <tt class="py-line"> <tt id="link-513" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-513', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">=</tt> <tt id="link-514" class="py-name" targets="Class netaddr.address.FormatDescriptor=netaddr.address.FormatDescriptor-class.html"><a title="netaddr.address.FormatDescriptor" class="py-name" href="#" onclick="return doclink('link-514', 'FormatDescriptor', 'link-514');">FormatDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-515" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-515', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1054"></a><tt class="py-lineno">1054</tt> <tt class="py-line"> </tt> +<a name="IPRange.__init__"></a><div id="IPRange.__init__-def"><a name="L1055"></a><tt class="py-lineno">1055</tt> <a class="py-toggle" href="#" id="IPRange.__init__-toggle" onclick="return toggle('IPRange.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">first</tt><tt class="py-op">,</tt> <tt class="py-param">last</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt id="link-516" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-516', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__init__-expanded"><a name="L1056"></a><tt class="py-lineno">1056</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1057"></a><tt class="py-lineno">1057</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L1058"></a><tt class="py-lineno">1058</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1059"></a><tt class="py-lineno">1059</tt> <tt class="py-line"><tt class="py-docstring"> @param first: start address for this IP address range.</tt> </tt> +<a name="L1060"></a><tt class="py-lineno">1060</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1061"></a><tt class="py-lineno">1061</tt> <tt class="py-line"><tt class="py-docstring"> @param last: stop address for this IP address range.</tt> </tt> +<a name="L1062"></a><tt class="py-lineno">1062</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1063"></a><tt class="py-lineno">1063</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: (optional) callable used to create return values.</tt> </tt> +<a name="L1064"></a><tt class="py-lineno">1064</tt> <tt class="py-line"><tt class="py-docstring"> Default: L{IP()} objects. See L{nrange()} documentations for</tt> </tt> +<a name="L1065"></a><tt class="py-lineno">1065</tt> <tt class="py-line"><tt class="py-docstring"> more details on the various options.</tt> </tt> +<a name="L1066"></a><tt class="py-lineno">1066</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1067"></a><tt class="py-lineno">1067</tt> <tt class="py-line"> <tt class="py-comment">#TODO: this can be optimised, consider accepting addr_type via the</tt> </tt> +<a name="L1068"></a><tt class="py-lineno">1068</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#TODO: constructor.</tt> </tt> +<a name="L1069"></a><tt class="py-lineno">1069</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-517" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-517', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-518" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-518', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt> </tt> +<a name="L1070"></a><tt class="py-lineno">1070</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-519" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-519', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt id="link-520" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-520', 'first', 'link-110');">first</a></tt> </tt> +<a name="L1071"></a><tt class="py-lineno">1071</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-521" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-521', 'last', 'link-372');">last</a></tt> <tt class="py-op">=</tt> <tt id="link-522" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-522', 'last', 'link-372');">last</a></tt> </tt> +<a name="L1072"></a><tt class="py-lineno">1072</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-523" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-523', 'last', 'link-372');">last</a></tt> <tt class="py-op"><</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-524" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-524', 'first', 'link-110');">first</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1073"></a><tt class="py-lineno">1073</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'start address is greater than stop address!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1074"></a><tt class="py-lineno">1074</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-525" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-525', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">=</tt> <tt id="link-526" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-526', 'fmt', 'link-261');">fmt</a></tt> </tt> +</div><a name="L1075"></a><tt class="py-lineno">1075</tt> <tt class="py-line"> </tt> +<a name="IPRange.__hash__"></a><div id="IPRange.__hash__-def"><a name="L1076"></a><tt class="py-lineno">1076</tt> <a class="py-toggle" href="#" id="IPRange.__hash__-toggle" onclick="return toggle('IPRange.__hash__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__hash__">__hash__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__hash__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__hash__-expanded"><a name="L1077"></a><tt class="py-lineno">1077</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1078"></a><tt class="py-lineno">1078</tt> <tt class="py-line"><tt class="py-docstring"> @return: The hash of this address range. Allow them to be used in sets</tt> </tt> +<a name="L1079"></a><tt class="py-lineno">1079</tt> <tt class="py-line"><tt class="py-docstring"> and as keys in dictionaries.</tt> </tt> +<a name="L1080"></a><tt class="py-lineno">1080</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1081"></a><tt class="py-lineno">1081</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hash</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-527" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-527', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-528" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-528', 'last', 'link-372');">last</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-529" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-529', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L1082"></a><tt class="py-lineno">1082</tt> <tt class="py-line"> </tt> +<a name="IPRange.__len__"></a><div id="IPRange.__len__-def"><a name="L1083"></a><tt class="py-lineno">1083</tt> <a class="py-toggle" href="#" id="IPRange.__len__-toggle" onclick="return toggle('IPRange.__len__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__len__">__len__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__len__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__len__-expanded"><a name="L1084"></a><tt class="py-lineno">1084</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1085"></a><tt class="py-lineno">1085</tt> <tt class="py-line"><tt class="py-docstring"> @return: The total number of network addresses in this range.</tt> </tt> +<a name="L1086"></a><tt class="py-lineno">1086</tt> <tt class="py-line"><tt class="py-docstring"> - Use this method only for ranges that contain less than</tt> </tt> +<a name="L1087"></a><tt class="py-lineno">1087</tt> <tt class="py-line"><tt class="py-docstring"> C{2^31} addresses or try the L{size()} method. Raises an</tt> </tt> +<a name="L1088"></a><tt class="py-lineno">1088</tt> <tt class="py-line"><tt class="py-docstring"> C{IndexError} if size is exceeded.</tt> </tt> +<a name="L1089"></a><tt class="py-lineno">1089</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1090"></a><tt class="py-lineno">1090</tt> <tt class="py-line"> <tt id="link-530" class="py-name" targets="Method netaddr.address.IPRange.size()=netaddr.address.IPRange-class.html#size"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-530', 'size', 'link-530');">size</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-531" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-531', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L1091"></a><tt class="py-lineno">1091</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-532" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-532', 'size', 'link-530');">size</a></tt> <tt class="py-op">></tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-number">31</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1092"></a><tt class="py-lineno">1092</tt> <tt class="py-line"> <tt class="py-comment"># Use size() method in this class instead as len() will b0rk!</tt> </tt> +<a name="L1093"></a><tt class="py-lineno">1093</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">"range contains greater than 2^31 addresses! "</tt> \ </tt> +<a name="L1094"></a><tt class="py-lineno">1094</tt> <tt class="py-line"> <tt class="py-string">"Use obj.size() instead."</tt><tt class="py-op">)</tt> </tt> +<a name="L1095"></a><tt class="py-lineno">1095</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-533" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-533', 'size', 'link-530');">size</a></tt> </tt> +</div><a name="L1096"></a><tt class="py-lineno">1096</tt> <tt class="py-line"> </tt> +<a name="IPRange.size"></a><div id="IPRange.size-def"><a name="L1097"></a><tt class="py-lineno">1097</tt> <a class="py-toggle" href="#" id="IPRange.size-toggle" onclick="return toggle('IPRange.size');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#size">size</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.size-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.size-expanded"><a name="L1098"></a><tt class="py-lineno">1098</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1099"></a><tt class="py-lineno">1099</tt> <tt class="py-line"><tt class="py-docstring"> @return: The total number of network addresses in this range.</tt> </tt> +<a name="L1100"></a><tt class="py-lineno">1100</tt> <tt class="py-line"><tt class="py-docstring"> - Use this method in preference to L{__len__()} when size of</tt> </tt> +<a name="L1101"></a><tt class="py-lineno">1101</tt> <tt class="py-line"><tt class="py-docstring"> ranges potentially exceeds C{2^31} addresses.</tt> </tt> +<a name="L1102"></a><tt class="py-lineno">1102</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1103"></a><tt class="py-lineno">1103</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-534" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-534', 'last', 'link-372');">last</a></tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-535" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-535', 'first', 'link-110');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt> +</div><a name="L1104"></a><tt class="py-lineno">1104</tt> <tt class="py-line"> </tt> +<a name="IPRange.format"></a><div id="IPRange.format-def"><a name="L1105"></a><tt class="py-lineno">1105</tt> <a class="py-toggle" href="#" id="IPRange.format-toggle" onclick="return toggle('IPRange.format');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#format">format</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_addr</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.format-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.format-expanded"><a name="L1106"></a><tt class="py-lineno">1106</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1107"></a><tt class="py-lineno">1107</tt> <tt class="py-line"><tt class="py-docstring"> @param int_addr: a network address integer (network byte order).</tt> </tt> +<a name="L1108"></a><tt class="py-lineno">1108</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1109"></a><tt class="py-lineno">1109</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: (optional) a callable used on return values.</tt> </tt> +<a name="L1110"></a><tt class="py-lineno">1110</tt> <tt class="py-line"><tt class="py-docstring"> Default: None. If set to None, this method uses the self.fmt</tt> </tt> +<a name="L1111"></a><tt class="py-lineno">1111</tt> <tt class="py-line"><tt class="py-docstring"> setting instead. The argument is provided as an override option.</tt> </tt> +<a name="L1112"></a><tt class="py-lineno">1112</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1113"></a><tt class="py-lineno">1113</tt> <tt class="py-line"><tt class="py-docstring"> @return: a network address in the format returned after passing it</tt> </tt> +<a name="L1114"></a><tt class="py-lineno">1114</tt> <tt class="py-line"><tt class="py-docstring"> through this object's fmt property callable.</tt> </tt> +<a name="L1115"></a><tt class="py-lineno">1115</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1116"></a><tt class="py-lineno">1116</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-536" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-536', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L1117"></a><tt class="py-lineno">1117</tt> <tt class="py-line"> <tt id="link-537" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-537', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-538" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-538', 'fmt', 'link-261');">fmt</a></tt> </tt> +<a name="L1118"></a><tt class="py-lineno">1118</tt> <tt class="py-line"> </tt> +<a name="L1119"></a><tt class="py-lineno">1119</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-539" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-539', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1120"></a><tt class="py-lineno">1120</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-540" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-540', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-541" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-401', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int_addr</tt><tt class="py-op">)</tt> </tt> -<a name="L964"></a><tt class="py-lineno"> 964</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-402" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-402', 'klass', 'link-338');">klass</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">,</tt> <tt class="py-name">hex</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L965"></a><tt class="py-lineno"> 965</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-403" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-403', 'klass', 'link-338');">klass</a></tt><tt class="py-op">(</tt><tt class="py-name">int_addr</tt><tt class="py-op">)</tt> </tt> -<a name="L966"></a><tt class="py-lineno"> 966</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L967"></a><tt class="py-lineno"> 967</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-404" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-404', 'klass', 'link-338');">klass</a></tt><tt class="py-op">(</tt><tt class="py-name">int_addr</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-405" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-405', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L968"></a><tt class="py-lineno"> 968</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__getitem__"></a><div id="AddrRange.__getitem__-def"><a name="L969"></a><tt class="py-lineno"> 969</tt> <a class="py-toggle" href="#" id="AddrRange.__getitem__-toggle" onclick="return toggle('AddrRange.__getitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__getitem__">__getitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__getitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__getitem__-expanded"><a name="L970"></a><tt class="py-lineno"> 970</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L971"></a><tt class="py-lineno"> 971</tt> <tt class="py-line"><tt class="py-docstring"> @return: The network address(es) in this address range indicated by</tt> </tt> -<a name="L972"></a><tt class="py-lineno"> 972</tt> <tt class="py-line"><tt class="py-docstring"> index/slice. Slicing objects can produce large sequences so</tt> </tt> -<a name="L973"></a><tt class="py-lineno"> 973</tt> <tt class="py-line"><tt class="py-docstring"> generator objects are returned instead to the usual sequences.</tt> </tt> -<a name="L974"></a><tt class="py-lineno"> 974</tt> <tt class="py-line"><tt class="py-docstring"> Wrapping a raw slice with C{list()} or C{tuple()} may be required</tt> </tt> -<a name="L975"></a><tt class="py-lineno"> 975</tt> <tt class="py-line"><tt class="py-docstring"> dependent on context.</tt> </tt> -<a name="L976"></a><tt class="py-lineno"> 976</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L977"></a><tt class="py-lineno"> 977</tt> <tt class="py-line"> </tt> -<a name="L978"></a><tt class="py-lineno"> 978</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L979"></a><tt class="py-lineno"> 979</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-406" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-406', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> -<a name="L980"></a><tt class="py-lineno"> 980</tt> <tt class="py-line"> <tt class="py-comment"># negative index.</tt> </tt> -<a name="L981"></a><tt class="py-lineno"> 981</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-407" class="py-name" targets="Method netaddr.address.AddrRange.data_flavour()=netaddr.address.AddrRange-class.html#data_flavour"><a title="netaddr.address.AddrRange.data_flavour" class="py-name" href="#" onclick="return doclink('link-407', 'data_flavour', 'link-407');">data_flavour</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-408" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-408', 'last', 'link-374');">last</a></tt> <tt class="py-op">+</tt> <tt class="py-name">index</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L982"></a><tt class="py-lineno"> 982</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-409" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-409', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L983"></a><tt class="py-lineno"> 983</tt> <tt class="py-line"> <tt class="py-comment"># Positive index or zero index.</tt> </tt> -<a name="L984"></a><tt class="py-lineno"> 984</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-410" class="py-name"><a title="netaddr.address.AddrRange.data_flavour" class="py-name" href="#" onclick="return doclink('link-410', 'data_flavour', 'link-407');">data_flavour</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-411" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-411', 'first', 'link-89');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> -<a name="L985"></a><tt class="py-lineno"> 985</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L986"></a><tt class="py-lineno"> 986</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'index out range for address range size!'</tt><tt class="py-op">)</tt> </tt> -<a name="L987"></a><tt class="py-lineno"> 987</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">slice</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L988"></a><tt class="py-lineno"> 988</tt> <tt class="py-line"> <tt class="py-comment"># slices</tt> </tt> -<a name="L989"></a><tt class="py-lineno"> 989</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: IPv6 breaks the .indices() method on the slice object</tt> </tt> -<a name="L990"></a><tt class="py-lineno"> 990</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># spectacularly. We'll have to work out the start, stop and</tt> </tt> -<a name="L991"></a><tt class="py-lineno"> 991</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># step ourselves :-(</tt> </tt> -<a name="L992"></a><tt class="py-lineno"> 992</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#</tt> </tt> -<a name="L993"></a><tt class="py-lineno"> 993</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># see PySlice_GetIndicesEx function in Python SVN repository for</tt> </tt> -<a name="L994"></a><tt class="py-lineno"> 994</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># implementation details :-</tt> </tt> -<a name="L995"></a><tt class="py-lineno"> 995</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># http://svn.python.org/view/python/trunk/Objects/sliceobject.c</tt> </tt> -<a name="L996"></a><tt class="py-lineno"> 996</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">stop</tt><tt class="py-op">,</tt> <tt class="py-name">step</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">index</tt><tt class="py-op">.</tt><tt class="py-name">indices</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-412" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-412', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L997"></a><tt class="py-lineno"> 997</tt> <tt class="py-line"> </tt> -<a name="L998"></a><tt class="py-lineno"> 998</tt> <tt class="py-line"> <tt class="py-name">start_addr</tt> <tt class="py-op">=</tt> <tt id="link-413" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-413', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-414" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-414', 'first', 'link-89');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-415" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-415', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -<a name="L999"></a><tt class="py-lineno"> 999</tt> <tt class="py-line"> <tt class="py-name">end_addr</tt> <tt class="py-op">=</tt> <tt id="link-416" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-416', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-417" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-417', 'first', 'link-89');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-name">stop</tt> <tt class="py-op">-</tt> <tt class="py-name">step</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-418" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-418', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1000"></a><tt class="py-lineno">1000</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-419" class="py-name" targets="Function netaddr.address.nrange()=netaddr.address-module.html#nrange"><a title="netaddr.address.nrange" class="py-name" href="#" onclick="return doclink('link-419', 'nrange', 'link-419');">nrange</a></tt><tt class="py-op">(</tt><tt class="py-name">start_addr</tt><tt class="py-op">,</tt> <tt class="py-name">end_addr</tt><tt class="py-op">,</tt> <tt class="py-name">step</tt><tt class="py-op">,</tt> <tt id="link-420" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-420', 'klass', 'link-338');">klass</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-421" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-421', 'klass', 'link-338');">klass</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1001"></a><tt class="py-lineno">1001</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1002"></a><tt class="py-lineno">1002</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported type %r!'</tt> <tt class="py-op">%</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> -</div><a name="L1003"></a><tt class="py-lineno">1003</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__iter__"></a><div id="AddrRange.__iter__-def"><a name="L1004"></a><tt class="py-lineno">1004</tt> <a class="py-toggle" href="#" id="AddrRange.__iter__-toggle" onclick="return toggle('AddrRange.__iter__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__iter__">__iter__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__iter__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__iter__-expanded"><a name="L1005"></a><tt class="py-lineno">1005</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1006"></a><tt class="py-lineno">1006</tt> <tt class="py-line"><tt class="py-docstring"> @return: An iterator object providing access to all network addresses</tt> </tt> -<a name="L1007"></a><tt class="py-lineno">1007</tt> <tt class="py-line"><tt class="py-docstring"> within this range.</tt> </tt> -<a name="L1008"></a><tt class="py-lineno">1008</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1009"></a><tt class="py-lineno">1009</tt> <tt class="py-line"> <tt class="py-name">start_addr</tt> <tt class="py-op">=</tt> <tt id="link-422" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-422', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-423" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-423', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-424" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-424', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1010"></a><tt class="py-lineno">1010</tt> <tt class="py-line"> <tt class="py-name">end_addr</tt> <tt class="py-op">=</tt> <tt id="link-425" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-425', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-426" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-426', 'last', 'link-374');">last</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-427" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-427', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1011"></a><tt class="py-lineno">1011</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-428" class="py-name"><a title="netaddr.address.nrange" class="py-name" href="#" onclick="return doclink('link-428', 'nrange', 'link-419');">nrange</a></tt><tt class="py-op">(</tt><tt class="py-name">start_addr</tt><tt class="py-op">,</tt> <tt class="py-name">end_addr</tt><tt class="py-op">,</tt> <tt id="link-429" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-429', 'klass', 'link-338');">klass</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-430" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-430', 'klass', 'link-338');">klass</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L1012"></a><tt class="py-lineno">1012</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__contains__"></a><div id="AddrRange.__contains__-def"><a name="L1013"></a><tt class="py-lineno">1013</tt> <a class="py-toggle" href="#" id="AddrRange.__contains__-toggle" onclick="return toggle('AddrRange.__contains__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__contains__">__contains__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__contains__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__contains__-expanded"><a name="L1014"></a><tt class="py-lineno">1014</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1015"></a><tt class="py-lineno">1015</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: object of Addr/AddrRange (sub)class or a network address</tt> </tt> -<a name="L1016"></a><tt class="py-lineno">1016</tt> <tt class="py-line"><tt class="py-docstring"> string to be compared.</tt> </tt> -<a name="L1017"></a><tt class="py-lineno">1017</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1018"></a><tt class="py-lineno">1018</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if given address or range falls within this range,</tt> </tt> -<a name="L1019"></a><tt class="py-lineno">1019</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> -<a name="L1020"></a><tt class="py-lineno">1020</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1021"></a><tt class="py-lineno">1021</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1022"></a><tt class="py-lineno">1022</tt> <tt class="py-line"> <tt class="py-comment"># string address or address range.</tt> </tt> -<a name="L1023"></a><tt class="py-lineno">1023</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">c_addr</tt> <tt class="py-op">=</tt> <tt id="link-431" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-431', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L1024"></a><tt class="py-lineno">1024</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">c_addr</tt><tt class="py-op">.</tt><tt id="link-432" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-432', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-433" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-433', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">:</tt> </tt> -<a name="L1025"></a><tt class="py-lineno">1025</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-434" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-434', 'first', 'link-89');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">c_addr</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-435" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-435', 'last', 'link-374');">last</a></tt><tt class="py-op">:</tt> </tt> -<a name="L1026"></a><tt class="py-lineno">1026</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1027"></a><tt class="py-lineno">1027</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt id="link-436" class="py-name"><a title="netaddr.address.Addr" class="py-name" href="#" onclick="return doclink('link-436', 'Addr', 'link-32');">Addr</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1028"></a><tt class="py-lineno">1028</tt> <tt class="py-line"> <tt class="py-comment"># Single value check.</tt> </tt> -<a name="L1029"></a><tt class="py-lineno">1029</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-437" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-437', 'first', 'link-89');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-438" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-438', 'last', 'link-374');">last</a></tt><tt class="py-op">:</tt> </tt> -<a name="L1030"></a><tt class="py-lineno">1030</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1031"></a><tt class="py-lineno">1031</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt id="link-439" class="py-name" targets="Class netaddr.address.AddrRange=netaddr.address.AddrRange-class.html"><a title="netaddr.address.AddrRange" class="py-name" href="#" onclick="return doclink('link-439', 'AddrRange', 'link-439');">AddrRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1032"></a><tt class="py-lineno">1032</tt> <tt class="py-line"> <tt class="py-comment"># Range value check.</tt> </tt> -<a name="L1033"></a><tt class="py-lineno">1033</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt id="link-440" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-440', 'first', 'link-89');">first</a></tt> <tt class="py-op">>=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-441" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-441', 'first', 'link-89');">first</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt id="link-442" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-442', 'last', 'link-374');">last</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-443" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-443', 'last', 'link-374');">last</a></tt><tt class="py-op">:</tt> </tt> -<a name="L1034"></a><tt class="py-lineno">1034</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1035"></a><tt class="py-lineno">1035</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1036"></a><tt class="py-lineno">1036</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is an unsupported type or class!'</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L1037"></a><tt class="py-lineno">1037</tt> <tt class="py-line"> </tt> -<a name="L1038"></a><tt class="py-lineno">1038</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L1039"></a><tt class="py-lineno">1039</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__eq__"></a><div id="AddrRange.__eq__-def"><a name="L1040"></a><tt class="py-lineno">1040</tt> <a class="py-toggle" href="#" id="AddrRange.__eq__-toggle" onclick="return toggle('AddrRange.__eq__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__eq__">__eq__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__eq__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__eq__-expanded"><a name="L1041"></a><tt class="py-lineno">1041</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1042"></a><tt class="py-lineno">1042</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> -<a name="L1043"></a><tt class="py-lineno">1043</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1044"></a><tt class="py-lineno">1044</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are the same as</tt> </tt> -<a name="L1045"></a><tt class="py-lineno">1045</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> -<a name="L1046"></a><tt class="py-lineno">1046</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1047"></a><tt class="py-lineno">1047</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1048"></a><tt class="py-lineno">1048</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-444" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-444', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-445" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-445', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-446" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-446', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> \ </tt> -<a name="L1049"></a><tt class="py-lineno">1049</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-447" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-447', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-448" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-448', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-449" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-449', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1050"></a><tt class="py-lineno">1050</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1051"></a><tt class="py-lineno">1051</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1052"></a><tt class="py-lineno">1052</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1053"></a><tt class="py-lineno">1053</tt> <tt class="py-line"> </tt> -<a name="L1054"></a><tt class="py-lineno">1054</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L1055"></a><tt class="py-lineno">1055</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__ne__"></a><div id="AddrRange.__ne__-def"><a name="L1056"></a><tt class="py-lineno">1056</tt> <a class="py-toggle" href="#" id="AddrRange.__ne__-toggle" onclick="return toggle('AddrRange.__ne__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__ne__">__ne__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__ne__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__ne__-expanded"><a name="L1057"></a><tt class="py-lineno">1057</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1058"></a><tt class="py-lineno">1058</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> -<a name="L1059"></a><tt class="py-lineno">1059</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1060"></a><tt class="py-lineno">1060</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are not the same as</tt> </tt> -<a name="L1061"></a><tt class="py-lineno">1061</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> -<a name="L1062"></a><tt class="py-lineno">1062</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1063"></a><tt class="py-lineno">1063</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1064"></a><tt class="py-lineno">1064</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-450" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-450', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-451" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-451', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-452" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-452', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> \ </tt> -<a name="L1065"></a><tt class="py-lineno">1065</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-453" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-453', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-454" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-454', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-455" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-455', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1066"></a><tt class="py-lineno">1066</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1067"></a><tt class="py-lineno">1067</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1068"></a><tt class="py-lineno">1068</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1069"></a><tt class="py-lineno">1069</tt> <tt class="py-line"> </tt> -<a name="L1070"></a><tt class="py-lineno">1070</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L1071"></a><tt class="py-lineno">1071</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__lt__"></a><div id="AddrRange.__lt__-def"><a name="L1072"></a><tt class="py-lineno">1072</tt> <a class="py-toggle" href="#" id="AddrRange.__lt__-toggle" onclick="return toggle('AddrRange.__lt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__lt__">__lt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__lt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__lt__-expanded"><a name="L1073"></a><tt class="py-lineno">1073</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1074"></a><tt class="py-lineno">1074</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> -<a name="L1075"></a><tt class="py-lineno">1075</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1076"></a><tt class="py-lineno">1076</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are less than other,</tt> </tt> -<a name="L1077"></a><tt class="py-lineno">1077</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> -<a name="L1078"></a><tt class="py-lineno">1078</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1079"></a><tt class="py-lineno">1079</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1080"></a><tt class="py-lineno">1080</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-456" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-456', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-457" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-457', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-458" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-458', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op"><</tt> \ </tt> -<a name="L1081"></a><tt class="py-lineno">1081</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-459" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-459', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-460" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-460', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-461" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-461', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1082"></a><tt class="py-lineno">1082</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1083"></a><tt class="py-lineno">1083</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1084"></a><tt class="py-lineno">1084</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1085"></a><tt class="py-lineno">1085</tt> <tt class="py-line"> </tt> -<a name="L1086"></a><tt class="py-lineno">1086</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L1087"></a><tt class="py-lineno">1087</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__le__"></a><div id="AddrRange.__le__-def"><a name="L1088"></a><tt class="py-lineno">1088</tt> <a class="py-toggle" href="#" id="AddrRange.__le__-toggle" onclick="return toggle('AddrRange.__le__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__le__">__le__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__le__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__le__-expanded"><a name="L1089"></a><tt class="py-lineno">1089</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1090"></a><tt class="py-lineno">1090</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> -<a name="L1091"></a><tt class="py-lineno">1091</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1092"></a><tt class="py-lineno">1092</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are less or equal to</tt> </tt> -<a name="L1093"></a><tt class="py-lineno">1093</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> -<a name="L1094"></a><tt class="py-lineno">1094</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1095"></a><tt class="py-lineno">1095</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1096"></a><tt class="py-lineno">1096</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-462" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-462', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-463" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-463', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-464" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-464', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> \ </tt> -<a name="L1097"></a><tt class="py-lineno">1097</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-465" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-465', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-466" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-466', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-467" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-467', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1098"></a><tt class="py-lineno">1098</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1099"></a><tt class="py-lineno">1099</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1100"></a><tt class="py-lineno">1100</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1101"></a><tt class="py-lineno">1101</tt> <tt class="py-line"> </tt> -<a name="L1102"></a><tt class="py-lineno">1102</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L1103"></a><tt class="py-lineno">1103</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__gt__"></a><div id="AddrRange.__gt__-def"><a name="L1104"></a><tt class="py-lineno">1104</tt> <a class="py-toggle" href="#" id="AddrRange.__gt__-toggle" onclick="return toggle('AddrRange.__gt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__gt__">__gt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__gt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__gt__-expanded"><a name="L1105"></a><tt class="py-lineno">1105</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1106"></a><tt class="py-lineno">1106</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> -<a name="L1107"></a><tt class="py-lineno">1107</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1108"></a><tt class="py-lineno">1108</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are greater than</tt> </tt> -<a name="L1109"></a><tt class="py-lineno">1109</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> -<a name="L1110"></a><tt class="py-lineno">1110</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1111"></a><tt class="py-lineno">1111</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1112"></a><tt class="py-lineno">1112</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-468" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-468', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-469" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-469', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-470" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-470', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">></tt> \ </tt> -<a name="L1113"></a><tt class="py-lineno">1113</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-471" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-471', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-472" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-472', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-473" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-473', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1114"></a><tt class="py-lineno">1114</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1115"></a><tt class="py-lineno">1115</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1116"></a><tt class="py-lineno">1116</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1117"></a><tt class="py-lineno">1117</tt> <tt class="py-line"> </tt> -<a name="L1118"></a><tt class="py-lineno">1118</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L1119"></a><tt class="py-lineno">1119</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__ge__"></a><div id="AddrRange.__ge__-def"><a name="L1120"></a><tt class="py-lineno">1120</tt> <a class="py-toggle" href="#" id="AddrRange.__ge__-toggle" onclick="return toggle('AddrRange.__ge__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__ge__">__ge__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__ge__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__ge__-expanded"><a name="L1121"></a><tt class="py-lineno">1121</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1122"></a><tt class="py-lineno">1122</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> -<a name="L1123"></a><tt class="py-lineno">1123</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1124"></a><tt class="py-lineno">1124</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are greater or equal</tt> </tt> -<a name="L1125"></a><tt class="py-lineno">1125</tt> <tt class="py-line"><tt class="py-docstring"> to other, C{False} otherwise.</tt> </tt> -<a name="L1126"></a><tt class="py-lineno">1126</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1127"></a><tt class="py-lineno">1127</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1128"></a><tt class="py-lineno">1128</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-474" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-474', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-475" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-475', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-476" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-476', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">>=</tt> \ </tt> -<a name="L1129"></a><tt class="py-lineno">1129</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-477" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-477', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-478" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-478', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-479" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-479', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1130"></a><tt class="py-lineno">1130</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L1131"></a><tt class="py-lineno">1131</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1132"></a><tt class="py-lineno">1132</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1133"></a><tt class="py-lineno">1133</tt> <tt class="py-line"> </tt> -<a name="L1134"></a><tt class="py-lineno">1134</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L1135"></a><tt class="py-lineno">1135</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__iadd__"></a><div id="AddrRange.__iadd__-def"><a name="L1136"></a><tt class="py-lineno">1136</tt> <a class="py-toggle" href="#" id="AddrRange.__iadd__-toggle" onclick="return toggle('AddrRange.__iadd__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__iadd__">__iadd__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">i</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__iadd__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__iadd__-expanded"><a name="L1137"></a><tt class="py-lineno">1137</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1138"></a><tt class="py-lineno">1138</tt> <tt class="py-line"><tt class="py-docstring"> Increments start and end addresses of this range by the current size.</tt> </tt> -<a name="L1139"></a><tt class="py-lineno">1139</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1140"></a><tt class="py-lineno">1140</tt> <tt class="py-line"><tt class="py-docstring"> If the result exceeds address type range for the address type an</tt> </tt> -<a name="L1141"></a><tt class="py-lineno">1141</tt> <tt class="py-line"><tt class="py-docstring"> IndexError is raised.</tt> </tt> -<a name="L1142"></a><tt class="py-lineno">1142</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1143"></a><tt class="py-lineno">1143</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1144"></a><tt class="py-lineno">1144</tt> <tt class="py-line"> <tt class="py-name">new_first</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-480" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-480', 'first', 'link-89');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-481" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-481', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> -<a name="L1145"></a><tt class="py-lineno">1145</tt> <tt class="py-line"> <tt class="py-name">new_last</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-482" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-482', 'last', 'link-374');">last</a></tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-483" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-483', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> -<a name="L1146"></a><tt class="py-lineno">1146</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1147"></a><tt class="py-lineno">1147</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Increment value must be an integer!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1148"></a><tt class="py-lineno">1148</tt> <tt class="py-line"> </tt> -<a name="L1149"></a><tt class="py-lineno">1149</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_last</tt> <tt class="py-op">></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-484" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-484', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">:</tt> </tt> -<a name="L1150"></a><tt class="py-lineno">1150</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid increment is outside address boundary!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1151"></a><tt class="py-lineno">1151</tt> <tt class="py-line"> </tt> -<a name="L1152"></a><tt class="py-lineno">1152</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-485" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-485', 'first', 'link-89');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_first</tt> </tt> -<a name="L1153"></a><tt class="py-lineno">1153</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-486" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-486', 'last', 'link-374');">last</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_last</tt> </tt> +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-541', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int_addr</tt><tt class="py-op">)</tt> </tt> +<a name="L1121"></a><tt class="py-lineno">1121</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-542" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-542', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">,</tt> <tt class="py-name">hex</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1122"></a><tt class="py-lineno">1122</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-543" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-543', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">int_addr</tt><tt class="py-op">)</tt> </tt> +<a name="L1123"></a><tt class="py-lineno">1123</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1124"></a><tt class="py-lineno">1124</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-544" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-544', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">int_addr</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-545" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-545', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L1125"></a><tt class="py-lineno">1125</tt> <tt class="py-line"> </tt> +<a name="IPRange.__getitem__"></a><div id="IPRange.__getitem__-def"><a name="L1126"></a><tt class="py-lineno">1126</tt> <a class="py-toggle" href="#" id="IPRange.__getitem__-toggle" onclick="return toggle('IPRange.__getitem__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__getitem__">__getitem__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__getitem__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__getitem__-expanded"><a name="L1127"></a><tt class="py-lineno">1127</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1128"></a><tt class="py-lineno">1128</tt> <tt class="py-line"><tt class="py-docstring"> @return: The IP address(es) in this address range referenced by</tt> </tt> +<a name="L1129"></a><tt class="py-lineno">1129</tt> <tt class="py-line"><tt class="py-docstring"> index/slice. Slicing objects can produce large sequences so</tt> </tt> +<a name="L1130"></a><tt class="py-lineno">1130</tt> <tt class="py-line"><tt class="py-docstring"> generator objects are returned instead of a list. Wrapping a slice</tt> </tt> +<a name="L1131"></a><tt class="py-lineno">1131</tt> <tt class="py-line"><tt class="py-docstring"> with C{list()} or C{tuple()} may be required dependent on context</tt> </tt> +<a name="L1132"></a><tt class="py-lineno">1132</tt> <tt class="py-line"><tt class="py-docstring"> in which it is called.</tt> </tt> +<a name="L1133"></a><tt class="py-lineno">1133</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1134"></a><tt class="py-lineno">1134</tt> <tt class="py-line"> </tt> +<a name="L1135"></a><tt class="py-lineno">1135</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1136"></a><tt class="py-lineno">1136</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-op">(</tt><tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-546" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-546', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L1137"></a><tt class="py-lineno">1137</tt> <tt class="py-line"> <tt class="py-comment"># negative index.</tt> </tt> +<a name="L1138"></a><tt class="py-lineno">1138</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-547" class="py-name" targets="Method netaddr.address.IPRange.format()=netaddr.address.IPRange-class.html#format"><a title="netaddr.address.IPRange.format" class="py-name" href="#" onclick="return doclink('link-547', 'format', 'link-547');">format</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-548" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-548', 'last', 'link-372');">last</a></tt> <tt class="py-op">+</tt> <tt class="py-name">index</tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L1139"></a><tt class="py-lineno">1139</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">index</tt> <tt class="py-op"><=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-549" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-549', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1140"></a><tt class="py-lineno">1140</tt> <tt class="py-line"> <tt class="py-comment"># Positive index or zero index.</tt> </tt> +<a name="L1141"></a><tt class="py-lineno">1141</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-550" class="py-name"><a title="netaddr.address.IPRange.format" class="py-name" href="#" onclick="return doclink('link-550', 'format', 'link-547');">format</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-551" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-551', 'first', 'link-110');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> +<a name="L1142"></a><tt class="py-lineno">1142</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1143"></a><tt class="py-lineno">1143</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'index out range for address range size!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1144"></a><tt class="py-lineno">1144</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">slice</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1145"></a><tt class="py-lineno">1145</tt> <tt class="py-line"> <tt class="py-comment"># slices</tt> </tt> +<a name="L1146"></a><tt class="py-lineno">1146</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: IPv6 breaks the .indices() method on the slice object</tt> </tt> +<a name="L1147"></a><tt class="py-lineno">1147</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: spectacularly. We'll have to work out the start, stop and</tt> </tt> +<a name="L1148"></a><tt class="py-lineno">1148</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: step ourselves :-(</tt> </tt> +<a name="L1149"></a><tt class="py-lineno">1149</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#</tt> </tt> +<a name="L1150"></a><tt class="py-lineno">1150</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: see PySlice_GetIndicesEx function in Python SVN</tt> </tt> +<a name="L1151"></a><tt class="py-lineno">1151</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: repository for implementation details :-</tt> </tt> +<a name="L1152"></a><tt class="py-lineno">1152</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: http://svn.python.org/view/python/trunk/Objects/sliceobject.c</tt> </tt> +<a name="L1153"></a><tt class="py-lineno">1153</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">stop</tt><tt class="py-op">,</tt> <tt class="py-name">step</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">index</tt><tt class="py-op">.</tt><tt class="py-name">indices</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-552" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-552', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> <a name="L1154"></a><tt class="py-lineno">1154</tt> <tt class="py-line"> </tt> -<a name="L1155"></a><tt class="py-lineno">1155</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> -</div><a name="L1156"></a><tt class="py-lineno">1156</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__isub__"></a><div id="AddrRange.__isub__-def"><a name="L1157"></a><tt class="py-lineno">1157</tt> <a class="py-toggle" href="#" id="AddrRange.__isub__-toggle" onclick="return toggle('AddrRange.__isub__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__isub__">__isub__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">i</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__isub__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__isub__-expanded"><a name="L1158"></a><tt class="py-lineno">1158</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1159"></a><tt class="py-lineno">1159</tt> <tt class="py-line"><tt class="py-docstring"> Decrements start and end addresses of this range by the current size.</tt> </tt> -<a name="L1160"></a><tt class="py-lineno">1160</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1161"></a><tt class="py-lineno">1161</tt> <tt class="py-line"><tt class="py-docstring"> If the result less than zero an IndexError is raised.</tt> </tt> -<a name="L1162"></a><tt class="py-lineno">1162</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1163"></a><tt class="py-lineno">1163</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1164"></a><tt class="py-lineno">1164</tt> <tt class="py-line"> <tt class="py-name">new_first</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-487" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-487', 'first', 'link-89');">first</a></tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-488" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-488', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> -<a name="L1165"></a><tt class="py-lineno">1165</tt> <tt class="py-line"> <tt class="py-name">new_last</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-489" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-489', 'last', 'link-374');">last</a></tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-490" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-490', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> -<a name="L1166"></a><tt class="py-lineno">1166</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1167"></a><tt class="py-lineno">1167</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Decrement value must be an integer!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1168"></a><tt class="py-lineno">1168</tt> <tt class="py-line"> </tt> -<a name="L1169"></a><tt class="py-lineno">1169</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_last</tt> <tt class="py-op"><</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-491" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-491', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">min_int</tt><tt class="py-op">:</tt> </tt> -<a name="L1170"></a><tt class="py-lineno">1170</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid decrement is outside address boundary!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1171"></a><tt class="py-lineno">1171</tt> <tt class="py-line"> </tt> -<a name="L1172"></a><tt class="py-lineno">1172</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-492" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-492', 'first', 'link-89');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_first</tt> </tt> -<a name="L1173"></a><tt class="py-lineno">1173</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-493" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-493', 'last', 'link-374');">last</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_last</tt> </tt> -<a name="L1174"></a><tt class="py-lineno">1174</tt> <tt class="py-line"> </tt> -<a name="L1175"></a><tt class="py-lineno">1175</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> -</div><a name="L1176"></a><tt class="py-lineno">1176</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__str__"></a><div id="AddrRange.__str__-def"><a name="L1177"></a><tt class="py-lineno">1177</tt> <a class="py-toggle" href="#" id="AddrRange.__str__-toggle" onclick="return toggle('AddrRange.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__str__-expanded"><a name="L1178"></a><tt class="py-lineno">1178</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s;%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-494" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-494', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-495" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +<a name="L1155"></a><tt class="py-lineno">1155</tt> <tt class="py-line"> <tt class="py-name">start_addr</tt> <tt class="py-op">=</tt> <tt id="link-553" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-553', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-554" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-554', 'first', 'link-110');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-555" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-555', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1156"></a><tt class="py-lineno">1156</tt> <tt class="py-line"> <tt class="py-name">end_addr</tt> <tt class="py-op">=</tt> <tt id="link-556" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-556', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-557" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-557', 'first', 'link-110');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-name">stop</tt> <tt class="py-op">-</tt> <tt class="py-name">step</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-558" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-558', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1157"></a><tt class="py-lineno">1157</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-559" class="py-name" targets="Function netaddr.address.nrange()=netaddr.address-module.html#nrange"><a title="netaddr.address.nrange" class="py-name" href="#" onclick="return doclink('link-559', 'nrange', 'link-559');">nrange</a></tt><tt class="py-op">(</tt><tt class="py-name">start_addr</tt><tt class="py-op">,</tt> <tt class="py-name">end_addr</tt><tt class="py-op">,</tt> <tt class="py-name">step</tt><tt class="py-op">,</tt> <tt id="link-560" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-560', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-561" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-561', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1158"></a><tt class="py-lineno">1158</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1159"></a><tt class="py-lineno">1159</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported type %r!'</tt> <tt class="py-op">%</tt> <tt class="py-name">index</tt><tt class="py-op">)</tt> </tt> +</div><a name="L1160"></a><tt class="py-lineno">1160</tt> <tt class="py-line"> </tt> +<a name="IPRange.__iter__"></a><div id="IPRange.__iter__-def"><a name="L1161"></a><tt class="py-lineno">1161</tt> <a class="py-toggle" href="#" id="IPRange.__iter__-toggle" onclick="return toggle('IPRange.__iter__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__iter__">__iter__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__iter__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__iter__-expanded"><a name="L1162"></a><tt class="py-lineno">1162</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1163"></a><tt class="py-lineno">1163</tt> <tt class="py-line"><tt class="py-docstring"> @return: An iterator object providing access to all network addresses</tt> </tt> +<a name="L1164"></a><tt class="py-lineno">1164</tt> <tt class="py-line"><tt class="py-docstring"> within this range.</tt> </tt> +<a name="L1165"></a><tt class="py-lineno">1165</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1166"></a><tt class="py-lineno">1166</tt> <tt class="py-line"> <tt class="py-name">start_addr</tt> <tt class="py-op">=</tt> <tt id="link-562" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-562', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-563" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-563', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-564" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-564', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1167"></a><tt class="py-lineno">1167</tt> <tt class="py-line"> <tt class="py-name">end_addr</tt> <tt class="py-op">=</tt> <tt id="link-565" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-565', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-566" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-566', 'last', 'link-372');">last</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-567" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-567', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1168"></a><tt class="py-lineno">1168</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-568" class="py-name"><a title="netaddr.address.nrange" class="py-name" href="#" onclick="return doclink('link-568', 'nrange', 'link-559');">nrange</a></tt><tt class="py-op">(</tt><tt class="py-name">start_addr</tt><tt class="py-op">,</tt> <tt class="py-name">end_addr</tt><tt class="py-op">,</tt> <tt id="link-569" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-569', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">=</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-570" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-570', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L1169"></a><tt class="py-lineno">1169</tt> <tt class="py-line"> </tt> +<a name="IPRange.__contains__"></a><div id="IPRange.__contains__-def"><a name="L1170"></a><tt class="py-lineno">1170</tt> <a class="py-toggle" href="#" id="IPRange.__contains__-toggle" onclick="return toggle('IPRange.__contains__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__contains__">__contains__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__contains__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__contains__-expanded"><a name="L1171"></a><tt class="py-lineno">1171</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1172"></a><tt class="py-lineno">1172</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: and IP/IPRange class/subclass instance or IP string value</tt> </tt> +<a name="L1173"></a><tt class="py-lineno">1173</tt> <tt class="py-line"><tt class="py-docstring"> to be compared.</tt> </tt> +<a name="L1174"></a><tt class="py-lineno">1174</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1175"></a><tt class="py-lineno">1175</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if given address or range falls within this range,</tt> </tt> +<a name="L1176"></a><tt class="py-lineno">1176</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> +<a name="L1177"></a><tt class="py-lineno">1177</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1178"></a><tt class="py-lineno">1178</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1179"></a><tt class="py-lineno">1179</tt> <tt class="py-line"> <tt class="py-comment"># string address or address range.</tt> </tt> +<a name="L1180"></a><tt class="py-lineno">1180</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">c_addr</tt> <tt class="py-op">=</tt> <tt id="link-571" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-571', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L1181"></a><tt class="py-lineno">1181</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">c_addr</tt><tt class="py-op">.</tt><tt id="link-572" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-572', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-573" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-573', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1182"></a><tt class="py-lineno">1182</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-574" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-574', 'first', 'link-110');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">c_addr</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-575" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-575', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1183"></a><tt class="py-lineno">1183</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1184"></a><tt class="py-lineno">1184</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-576" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-576', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1185"></a><tt class="py-lineno">1185</tt> <tt class="py-line"> <tt class="py-comment"># Single value check.</tt> </tt> +<a name="L1186"></a><tt class="py-lineno">1186</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-577" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-577', 'first', 'link-110');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-578" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-578', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1187"></a><tt class="py-lineno">1187</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1188"></a><tt class="py-lineno">1188</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">issubclass</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt id="link-579" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-579', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1189"></a><tt class="py-lineno">1189</tt> <tt class="py-line"> <tt class="py-comment"># Range value check.</tt> </tt> +<a name="L1190"></a><tt class="py-lineno">1190</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt id="link-580" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-580', 'first', 'link-110');">first</a></tt> <tt class="py-op">>=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-581" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-581', 'first', 'link-110');">first</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt id="link-582" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-582', 'last', 'link-372');">last</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-583" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-583', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1191"></a><tt class="py-lineno">1191</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1192"></a><tt class="py-lineno">1192</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1193"></a><tt class="py-lineno">1193</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is an unsupported type or class!'</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L1194"></a><tt class="py-lineno">1194</tt> <tt class="py-line"> </tt> +<a name="L1195"></a><tt class="py-lineno">1195</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1196"></a><tt class="py-lineno">1196</tt> <tt class="py-line"> </tt> +<a name="IPRange.__eq__"></a><div id="IPRange.__eq__-def"><a name="L1197"></a><tt class="py-lineno">1197</tt> <a class="py-toggle" href="#" id="IPRange.__eq__-toggle" onclick="return toggle('IPRange.__eq__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__eq__">__eq__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__eq__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__eq__-expanded"><a name="L1198"></a><tt class="py-lineno">1198</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1199"></a><tt class="py-lineno">1199</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> +<a name="L1200"></a><tt class="py-lineno">1200</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1201"></a><tt class="py-lineno">1201</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are the same as</tt> </tt> +<a name="L1202"></a><tt class="py-lineno">1202</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> +<a name="L1203"></a><tt class="py-lineno">1203</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1204"></a><tt class="py-lineno">1204</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1205"></a><tt class="py-lineno">1205</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-584" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-584', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-585" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-585', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-586" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-586', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> \ </tt> +<a name="L1206"></a><tt class="py-lineno">1206</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-587" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-587', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-588" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-588', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-589" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-589', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1207"></a><tt class="py-lineno">1207</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1208"></a><tt class="py-lineno">1208</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1209"></a><tt class="py-lineno">1209</tt> <tt class="py-line"> </tt> +<a name="IPRange.__ne__"></a><div id="IPRange.__ne__-def"><a name="L1210"></a><tt class="py-lineno">1210</tt> <a class="py-toggle" href="#" id="IPRange.__ne__-toggle" onclick="return toggle('IPRange.__ne__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__ne__">__ne__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__ne__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__ne__-expanded"><a name="L1211"></a><tt class="py-lineno">1211</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1212"></a><tt class="py-lineno">1212</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> +<a name="L1213"></a><tt class="py-lineno">1213</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1214"></a><tt class="py-lineno">1214</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are not the same as</tt> </tt> +<a name="L1215"></a><tt class="py-lineno">1215</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> +<a name="L1216"></a><tt class="py-lineno">1216</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1217"></a><tt class="py-lineno">1217</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1218"></a><tt class="py-lineno">1218</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-590" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-590', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-591" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-591', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-592" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-592', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> \ </tt> +<a name="L1219"></a><tt class="py-lineno">1219</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-593" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-593', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-594" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-594', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-595" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-595', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1220"></a><tt class="py-lineno">1220</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1221"></a><tt class="py-lineno">1221</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1222"></a><tt class="py-lineno">1222</tt> <tt class="py-line"> </tt> +<a name="IPRange.__lt__"></a><div id="IPRange.__lt__-def"><a name="L1223"></a><tt class="py-lineno">1223</tt> <a class="py-toggle" href="#" id="IPRange.__lt__-toggle" onclick="return toggle('IPRange.__lt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__lt__">__lt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__lt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__lt__-expanded"><a name="L1224"></a><tt class="py-lineno">1224</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1225"></a><tt class="py-lineno">1225</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> +<a name="L1226"></a><tt class="py-lineno">1226</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1227"></a><tt class="py-lineno">1227</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are less than other,</tt> </tt> +<a name="L1228"></a><tt class="py-lineno">1228</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> +<a name="L1229"></a><tt class="py-lineno">1229</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1230"></a><tt class="py-lineno">1230</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1231"></a><tt class="py-lineno">1231</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-596" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-596', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-597" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-597', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-598" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-598', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op"><</tt> \ </tt> +<a name="L1232"></a><tt class="py-lineno">1232</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-599" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-599', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-600" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-600', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-601" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-601', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1233"></a><tt class="py-lineno">1233</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1234"></a><tt class="py-lineno">1234</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1235"></a><tt class="py-lineno">1235</tt> <tt class="py-line"> </tt> +<a name="IPRange.__le__"></a><div id="IPRange.__le__-def"><a name="L1236"></a><tt class="py-lineno">1236</tt> <a class="py-toggle" href="#" id="IPRange.__le__-toggle" onclick="return toggle('IPRange.__le__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__le__">__le__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__le__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__le__-expanded"><a name="L1237"></a><tt class="py-lineno">1237</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1238"></a><tt class="py-lineno">1238</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> +<a name="L1239"></a><tt class="py-lineno">1239</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1240"></a><tt class="py-lineno">1240</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are less or equal to</tt> </tt> +<a name="L1241"></a><tt class="py-lineno">1241</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> +<a name="L1242"></a><tt class="py-lineno">1242</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1243"></a><tt class="py-lineno">1243</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1244"></a><tt class="py-lineno">1244</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-602" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-602', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-603" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-603', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-604" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-604', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> \ </tt> +<a name="L1245"></a><tt class="py-lineno">1245</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-605" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-605', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-606" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-606', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-607" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-607', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1246"></a><tt class="py-lineno">1246</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1247"></a><tt class="py-lineno">1247</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1248"></a><tt class="py-lineno">1248</tt> <tt class="py-line"> </tt> +<a name="IPRange.__gt__"></a><div id="IPRange.__gt__-def"><a name="L1249"></a><tt class="py-lineno">1249</tt> <a class="py-toggle" href="#" id="IPRange.__gt__-toggle" onclick="return toggle('IPRange.__gt__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__gt__">__gt__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__gt__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__gt__-expanded"><a name="L1250"></a><tt class="py-lineno">1250</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1251"></a><tt class="py-lineno">1251</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> +<a name="L1252"></a><tt class="py-lineno">1252</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1253"></a><tt class="py-lineno">1253</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are greater than</tt> </tt> +<a name="L1254"></a><tt class="py-lineno">1254</tt> <tt class="py-line"><tt class="py-docstring"> other, C{False} otherwise.</tt> </tt> +<a name="L1255"></a><tt class="py-lineno">1255</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1256"></a><tt class="py-lineno">1256</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1257"></a><tt class="py-lineno">1257</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-608" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-608', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-609" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-609', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-610" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-610', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">></tt> \ </tt> +<a name="L1258"></a><tt class="py-lineno">1258</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-611" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-611', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-612" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-612', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-613" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-613', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1259"></a><tt class="py-lineno">1259</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1260"></a><tt class="py-lineno">1260</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1261"></a><tt class="py-lineno">1261</tt> <tt class="py-line"> </tt> +<a name="IPRange.__ge__"></a><div id="IPRange.__ge__-def"><a name="L1262"></a><tt class="py-lineno">1262</tt> <a class="py-toggle" href="#" id="IPRange.__ge__-toggle" onclick="return toggle('IPRange.__ge__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__ge__">__ge__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__ge__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__ge__-expanded"><a name="L1263"></a><tt class="py-lineno">1263</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1264"></a><tt class="py-lineno">1264</tt> <tt class="py-line"><tt class="py-docstring"> @param other: an address object of the same address type as C{self}.</tt> </tt> +<a name="L1265"></a><tt class="py-lineno">1265</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1266"></a><tt class="py-lineno">1266</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if the boundaries of this range are greater or equal</tt> </tt> +<a name="L1267"></a><tt class="py-lineno">1267</tt> <tt class="py-line"><tt class="py-docstring"> to other, C{False} otherwise.</tt> </tt> +<a name="L1268"></a><tt class="py-lineno">1268</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1269"></a><tt class="py-lineno">1269</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1270"></a><tt class="py-lineno">1270</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-614" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-614', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-615" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-615', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-616" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-616', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">>=</tt> \ </tt> +<a name="L1271"></a><tt class="py-lineno">1271</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-617" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-617', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-618" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-618', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-619" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-619', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1272"></a><tt class="py-lineno">1272</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1273"></a><tt class="py-lineno">1273</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1274"></a><tt class="py-lineno">1274</tt> <tt class="py-line"> </tt> +<a name="IPRange.__iadd__"></a><div id="IPRange.__iadd__-def"><a name="L1275"></a><tt class="py-lineno">1275</tt> <a class="py-toggle" href="#" id="IPRange.__iadd__-toggle" onclick="return toggle('IPRange.__iadd__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__iadd__">__iadd__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">i</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__iadd__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__iadd__-expanded"><a name="L1276"></a><tt class="py-lineno">1276</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1277"></a><tt class="py-lineno">1277</tt> <tt class="py-line"><tt class="py-docstring"> Increments start and end addresses of this range by the current size.</tt> </tt> +<a name="L1278"></a><tt class="py-lineno">1278</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1279"></a><tt class="py-lineno">1279</tt> <tt class="py-line"><tt class="py-docstring"> Raises IndexError if the result exceeds address range maximum.</tt> </tt> +<a name="L1280"></a><tt class="py-lineno">1280</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1281"></a><tt class="py-lineno">1281</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1282"></a><tt class="py-lineno">1282</tt> <tt class="py-line"> <tt class="py-name">new_first</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-620" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-620', 'first', 'link-110');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-621" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-621', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> +<a name="L1283"></a><tt class="py-lineno">1283</tt> <tt class="py-line"> <tt class="py-name">new_last</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-622" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-622', 'last', 'link-372');">last</a></tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-623" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-623', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> +<a name="L1284"></a><tt class="py-lineno">1284</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1285"></a><tt class="py-lineno">1285</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Increment value must be an integer!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1286"></a><tt class="py-lineno">1286</tt> <tt class="py-line"> </tt> +<a name="L1287"></a><tt class="py-lineno">1287</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_last</tt> <tt class="py-op">></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-624" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-624', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">:</tt> </tt> +<a name="L1288"></a><tt class="py-lineno">1288</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid increment is outside address boundary!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1289"></a><tt class="py-lineno">1289</tt> <tt class="py-line"> </tt> +<a name="L1290"></a><tt class="py-lineno">1290</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-625" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-625', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_first</tt> </tt> +<a name="L1291"></a><tt class="py-lineno">1291</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-626" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-626', 'last', 'link-372');">last</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_last</tt> </tt> +<a name="L1292"></a><tt class="py-lineno">1292</tt> <tt class="py-line"> </tt> +<a name="L1293"></a><tt class="py-lineno">1293</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> +</div><a name="L1294"></a><tt class="py-lineno">1294</tt> <tt class="py-line"> </tt> +<a name="IPRange.__isub__"></a><div id="IPRange.__isub__-def"><a name="L1295"></a><tt class="py-lineno">1295</tt> <a class="py-toggle" href="#" id="IPRange.__isub__-toggle" onclick="return toggle('IPRange.__isub__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__isub__">__isub__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">i</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__isub__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__isub__-expanded"><a name="L1296"></a><tt class="py-lineno">1296</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1297"></a><tt class="py-lineno">1297</tt> <tt class="py-line"><tt class="py-docstring"> Decrements start and end addresses of this range by the current size.</tt> </tt> +<a name="L1298"></a><tt class="py-lineno">1298</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1299"></a><tt class="py-lineno">1299</tt> <tt class="py-line"><tt class="py-docstring"> Raises IndexError if the result is less than zero.</tt> </tt> +<a name="L1300"></a><tt class="py-lineno">1300</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1301"></a><tt class="py-lineno">1301</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1302"></a><tt class="py-lineno">1302</tt> <tt class="py-line"> <tt class="py-name">new_first</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-627" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-627', 'first', 'link-110');">first</a></tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-628" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-628', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> +<a name="L1303"></a><tt class="py-lineno">1303</tt> <tt class="py-line"> <tt class="py-name">new_last</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-629" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-629', 'last', 'link-372');">last</a></tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-630" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-630', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt><tt class="py-op">)</tt> </tt> +<a name="L1304"></a><tt class="py-lineno">1304</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1305"></a><tt class="py-lineno">1305</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Decrement value must be an integer!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1306"></a><tt class="py-lineno">1306</tt> <tt class="py-line"> </tt> +<a name="L1307"></a><tt class="py-lineno">1307</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_last</tt> <tt class="py-op"><</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L1308"></a><tt class="py-lineno">1308</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid decrement is outside address boundary!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1309"></a><tt class="py-lineno">1309</tt> <tt class="py-line"> </tt> +<a name="L1310"></a><tt class="py-lineno">1310</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-631" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-631', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_first</tt> </tt> +<a name="L1311"></a><tt class="py-lineno">1311</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-632" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-632', 'last', 'link-372');">last</a></tt> <tt class="py-op">=</tt> <tt class="py-name">new_last</tt> </tt> +<a name="L1312"></a><tt class="py-lineno">1312</tt> <tt class="py-line"> </tt> +<a name="L1313"></a><tt class="py-lineno">1313</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt> </tt> +</div><a name="L1314"></a><tt class="py-lineno">1314</tt> <tt class="py-line"> </tt> +<a name="IPRange.iprange"></a><div id="IPRange.iprange-def"><a name="L1315"></a><tt class="py-lineno">1315</tt> <a class="py-toggle" href="#" id="IPRange.iprange-toggle" onclick="return toggle('IPRange.iprange');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#iprange">iprange</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.iprange-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.iprange-expanded"><a name="L1316"></a><tt class="py-lineno">1316</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1317"></a><tt class="py-lineno">1317</tt> <tt class="py-line"><tt class="py-docstring"> @return: A valid L{IPRange} object for this address range.</tt> </tt> +<a name="L1318"></a><tt class="py-lineno">1318</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1319"></a><tt class="py-lineno">1319</tt> <tt class="py-line"> <tt class="py-comment">#TODO: this can be optimised.</tt> </tt> +<a name="L1320"></a><tt class="py-lineno">1320</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">ip_range</tt> <tt class="py-op">=</tt> <tt id="link-633" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-633', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-634" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-634', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-635" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-495', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-496" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-496', 'first', 'link-89');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> -<a name="L1179"></a><tt class="py-lineno">1179</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-497" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-635', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-636" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-636', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1321"></a><tt class="py-lineno">1321</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-637" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-497', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-498" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-637', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-638" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-498', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-499" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-499', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L1180"></a><tt class="py-lineno">1180</tt> <tt class="py-line"> </tt> -<a name="AddrRange.__repr__"></a><div id="AddrRange.__repr__-def"><a name="L1181"></a><tt class="py-lineno">1181</tt> <a class="py-toggle" href="#" id="AddrRange.__repr__-toggle" onclick="return toggle('AddrRange.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.AddrRange-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrRange.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="AddrRange.__repr__-expanded"><a name="L1182"></a><tt class="py-lineno">1182</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1183"></a><tt class="py-lineno">1183</tt> <tt class="py-line"><tt class="py-docstring"> @return: An executable Python statement that can recreate an object</tt> </tt> -<a name="L1184"></a><tt class="py-lineno">1184</tt> <tt class="py-line"><tt class="py-docstring"> with an equivalent state.</tt> </tt> -<a name="L1185"></a><tt class="py-lineno">1185</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1186"></a><tt class="py-lineno">1186</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s(%r, %r)"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> </tt> -<a name="L1187"></a><tt class="py-lineno">1187</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-500" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-638', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-639" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-639', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1322"></a><tt class="py-lineno">1322</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-640" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-640', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">==</tt> <tt class="py-name">str</tt><tt class="py-op">:</tt> </tt> +<a name="L1323"></a><tt class="py-lineno">1323</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">ip_range</tt><tt class="py-op">)</tt> </tt> +<a name="L1324"></a><tt class="py-lineno">1324</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">ip_range</tt> </tt> +</div><a name="L1325"></a><tt class="py-lineno">1325</tt> <tt class="py-line"> </tt> +<a name="IPRange.cidrs"></a><div id="IPRange.cidrs-def"><a name="L1326"></a><tt class="py-lineno">1326</tt> <a class="py-toggle" href="#" id="IPRange.cidrs-toggle" onclick="return toggle('IPRange.cidrs');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#cidrs">cidrs</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.cidrs-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.cidrs-expanded"><a name="L1327"></a><tt class="py-lineno">1327</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1328"></a><tt class="py-lineno">1328</tt> <tt class="py-line"><tt class="py-docstring"> @return: A list of one or more L{CIDR} objects covering this address</tt> </tt> +<a name="L1329"></a><tt class="py-lineno">1329</tt> <tt class="py-line"><tt class="py-docstring"> range. B{Please Note:} a list is returned even if this range maps</tt> </tt> +<a name="L1330"></a><tt class="py-lineno">1330</tt> <tt class="py-line"><tt class="py-docstring"> to a single CIDR because arbitrary ranges may not be aligned with</tt> </tt> +<a name="L1331"></a><tt class="py-lineno">1331</tt> <tt class="py-line"><tt class="py-docstring"> base 2 subnet sizes and will therefore return multiple CIDRs.</tt> </tt> +<a name="L1332"></a><tt class="py-lineno">1332</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1333"></a><tt class="py-lineno">1333</tt> <tt class="py-line"> <tt class="py-comment"># This can probably be tidied up a bit but I'm really proud of this</tt> </tt> +<a name="L1334"></a><tt class="py-lineno">1334</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># method. It is one seriously sweet piece of code!!!</tt> </tt> +<a name="L1335"></a><tt class="py-lineno">1335</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">cidr_list</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L1336"></a><tt class="py-lineno">1336</tt> <tt class="py-line"> </tt> +<a name="L1337"></a><tt class="py-lineno">1337</tt> <tt class="py-line"> <tt class="py-comment"># Get spanning CIDR covering both addresses.</tt> </tt> +<a name="L1338"></a><tt class="py-lineno">1338</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt id="link-641" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-641', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-642" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-642', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-643" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-643', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1339"></a><tt class="py-lineno">1339</tt> <tt class="py-line"> <tt class="py-name">end</tt> <tt class="py-op">=</tt> <tt id="link-644" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-644', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-645" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-645', 'last', 'link-372');">last</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-646" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-646', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1340"></a><tt class="py-lineno">1340</tt> <tt class="py-line"> </tt> +<a name="L1341"></a><tt class="py-lineno">1341</tt> <tt class="py-line"> <tt class="py-name">cidr_span</tt> <tt class="py-op">=</tt> <tt id="link-647" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-647', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">.</tt><tt id="link-648" class="py-name" targets="Static Method netaddr.address.CIDR.span()=netaddr.address.CIDR-class.html#span"><a title="netaddr.address.CIDR.span" class="py-name" href="#" onclick="return doclink('link-648', 'span', 'link-648');">span</a></tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">end</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L1342"></a><tt class="py-lineno">1342</tt> <tt class="py-line"> </tt> +<a name="L1343"></a><tt class="py-lineno">1343</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">cidr_span</tt><tt class="py-op">.</tt><tt id="link-649" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-649', 'first', 'link-110');">first</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-650" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-650', 'first', 'link-110');">first</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">cidr_span</tt><tt class="py-op">.</tt><tt id="link-651" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-651', 'last', 'link-372');">last</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-652" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-652', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1344"></a><tt class="py-lineno">1344</tt> <tt class="py-line"> <tt class="py-comment"># Spanning CIDR matches start and end exactly.</tt> </tt> +<a name="L1345"></a><tt class="py-lineno">1345</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">cidr_list</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">cidr_span</tt><tt class="py-op">]</tt> </tt> +<a name="L1346"></a><tt class="py-lineno">1346</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">cidr_span</tt><tt class="py-op">.</tt><tt id="link-653" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-653', 'last', 'link-372');">last</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-654" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-654', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1347"></a><tt class="py-lineno">1347</tt> <tt class="py-line"> <tt class="py-comment"># Spanning CIDR matches end exactly.</tt> </tt> +<a name="L1348"></a><tt class="py-lineno">1348</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-655" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-655', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">=</tt> <tt id="link-656" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-656', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> +<a name="L1349"></a><tt class="py-lineno">1349</tt> <tt class="py-line"> <tt class="py-name">first_int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-657" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-657', 'ip', 'link-75');">ip</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1350"></a><tt class="py-lineno">1350</tt> <tt class="py-line"> <tt id="link-658" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-658', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">-=</tt> <tt class="py-number">1</tt> </tt> +<a name="L1351"></a><tt class="py-lineno">1351</tt> <tt class="py-line"> <tt class="py-name">cidr_remainder</tt> <tt class="py-op">=</tt> <tt class="py-name">cidr_span</tt> <tt class="py-op">-</tt> <tt id="link-659" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-659', 'ip', 'link-75');">ip</a></tt> </tt> +<a name="L1352"></a><tt class="py-lineno">1352</tt> <tt class="py-line"> </tt> +<a name="L1353"></a><tt class="py-lineno">1353</tt> <tt class="py-line"> <tt class="py-name">first_found</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L1354"></a><tt class="py-lineno">1354</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-660" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-660', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">cidr_remainder</tt><tt class="py-op">:</tt> </tt> +<a name="L1355"></a><tt class="py-lineno">1355</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-661" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-661', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-662" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-662', 'first', 'link-110');">first</a></tt> <tt class="py-op">==</tt> <tt class="py-name">first_int_val</tt><tt class="py-op">:</tt> </tt> +<a name="L1356"></a><tt class="py-lineno">1356</tt> <tt class="py-line"> <tt class="py-name">first_found</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L1357"></a><tt class="py-lineno">1357</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">first_found</tt><tt class="py-op">:</tt> </tt> +<a name="L1358"></a><tt class="py-lineno">1358</tt> <tt class="py-line"> <tt class="py-name">cidr_list</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-663" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-663', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1359"></a><tt class="py-lineno">1359</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">cidr_span</tt><tt class="py-op">.</tt><tt id="link-664" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-664', 'first', 'link-110');">first</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-665" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-665', 'first', 'link-110');">first</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1360"></a><tt class="py-lineno">1360</tt> <tt class="py-line"> <tt class="py-comment"># Spanning CIDR matches start exactly.</tt> </tt> +<a name="L1361"></a><tt class="py-lineno">1361</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-666" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-666', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">=</tt> <tt id="link-667" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-667', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">end</tt><tt class="py-op">)</tt> </tt> +<a name="L1362"></a><tt class="py-lineno">1362</tt> <tt class="py-line"> <tt class="py-name">last_int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-668" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-668', 'ip', 'link-75');">ip</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1363"></a><tt class="py-lineno">1363</tt> <tt class="py-line"> <tt id="link-669" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-669', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt> +<a name="L1364"></a><tt class="py-lineno">1364</tt> <tt class="py-line"> <tt class="py-name">cidr_remainder</tt> <tt class="py-op">=</tt> <tt class="py-name">cidr_span</tt> <tt class="py-op">-</tt> <tt id="link-670" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-670', 'ip', 'link-75');">ip</a></tt> </tt> +<a name="L1365"></a><tt class="py-lineno">1365</tt> <tt class="py-line"> </tt> +<a name="L1366"></a><tt class="py-lineno">1366</tt> <tt class="py-line"> <tt class="py-name">last_found</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L1367"></a><tt class="py-lineno">1367</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-671" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-671', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">cidr_remainder</tt><tt class="py-op">:</tt> </tt> +<a name="L1368"></a><tt class="py-lineno">1368</tt> <tt class="py-line"> <tt class="py-name">cidr_list</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-672" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-672', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1369"></a><tt class="py-lineno">1369</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-673" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-673', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-674" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-674', 'last', 'link-372');">last</a></tt> <tt class="py-op">==</tt> <tt class="py-name">last_int_val</tt><tt class="py-op">:</tt> </tt> +<a name="L1370"></a><tt class="py-lineno">1370</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> +<a name="L1371"></a><tt class="py-lineno">1371</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">cidr_span</tt><tt class="py-op">.</tt><tt id="link-675" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-675', 'first', 'link-110');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-676" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-676', 'first', 'link-110');">first</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">cidr_span</tt><tt class="py-op">.</tt><tt id="link-677" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-677', 'last', 'link-372');">last</a></tt> <tt class="py-op">>=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-678" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-678', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1372"></a><tt class="py-lineno">1372</tt> <tt class="py-line"> <tt class="py-comment"># Spanning CIDR overlaps start and end.</tt> </tt> +<a name="L1373"></a><tt class="py-lineno">1373</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-679" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-679', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">=</tt> <tt id="link-680" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-680', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">)</tt> </tt> +<a name="L1374"></a><tt class="py-lineno">1374</tt> <tt class="py-line"> <tt class="py-name">first_int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-681" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-681', 'ip', 'link-75');">ip</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1375"></a><tt class="py-lineno">1375</tt> <tt class="py-line"> <tt id="link-682" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-682', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">-=</tt> <tt class="py-number">1</tt> </tt> +<a name="L1376"></a><tt class="py-lineno">1376</tt> <tt class="py-line"> <tt class="py-name">cidr_remainder</tt> <tt class="py-op">=</tt> <tt class="py-name">cidr_span</tt> <tt class="py-op">-</tt> <tt id="link-683" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-683', 'ip', 'link-75');">ip</a></tt> </tt> +<a name="L1377"></a><tt class="py-lineno">1377</tt> <tt class="py-line"> </tt> +<a name="L1378"></a><tt class="py-lineno">1378</tt> <tt class="py-line"> <tt class="py-comment"># Fix start.</tt> </tt> +<a name="L1379"></a><tt class="py-lineno">1379</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">first_found</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L1380"></a><tt class="py-lineno">1380</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-684" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-684', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">cidr_remainder</tt><tt class="py-op">:</tt> </tt> +<a name="L1381"></a><tt class="py-lineno">1381</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-685" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-685', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-686" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-686', 'first', 'link-110');">first</a></tt> <tt class="py-op">==</tt> <tt class="py-name">first_int_val</tt><tt class="py-op">:</tt> </tt> +<a name="L1382"></a><tt class="py-lineno">1382</tt> <tt class="py-line"> <tt class="py-name">first_found</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L1383"></a><tt class="py-lineno">1383</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">first_found</tt><tt class="py-op">:</tt> </tt> +<a name="L1384"></a><tt class="py-lineno">1384</tt> <tt class="py-line"> <tt class="py-name">cidr_list</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-687" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-687', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1385"></a><tt class="py-lineno">1385</tt> <tt class="py-line"> </tt> +<a name="L1386"></a><tt class="py-lineno">1386</tt> <tt class="py-line"> <tt class="py-comment"># Fix end.</tt> </tt> +<a name="L1387"></a><tt class="py-lineno">1387</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-688" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-688', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">=</tt> <tt id="link-689" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-689', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">end</tt><tt class="py-op">)</tt> </tt> +<a name="L1388"></a><tt class="py-lineno">1388</tt> <tt class="py-line"> <tt class="py-name">last_int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-690" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-690', 'ip', 'link-75');">ip</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1389"></a><tt class="py-lineno">1389</tt> <tt class="py-line"> <tt id="link-691" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-691', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt> +<a name="L1390"></a><tt class="py-lineno">1390</tt> <tt class="py-line"> <tt class="py-name">cidr_remainder</tt> <tt class="py-op">=</tt> <tt class="py-name">cidr_list</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-692" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-692', 'ip', 'link-75');">ip</a></tt> </tt> +<a name="L1391"></a><tt class="py-lineno">1391</tt> <tt class="py-line"> </tt> +<a name="L1392"></a><tt class="py-lineno">1392</tt> <tt class="py-line"> <tt class="py-name">last_found</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L1393"></a><tt class="py-lineno">1393</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-693" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-693', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">cidr_remainder</tt><tt class="py-op">:</tt> </tt> +<a name="L1394"></a><tt class="py-lineno">1394</tt> <tt class="py-line"> <tt class="py-name">cidr_list</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-694" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-694', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1395"></a><tt class="py-lineno">1395</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-695" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-695', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-696" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-696', 'last', 'link-372');">last</a></tt> <tt class="py-op">==</tt> <tt class="py-name">last_int_val</tt><tt class="py-op">:</tt> </tt> +<a name="L1396"></a><tt class="py-lineno">1396</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> +<a name="L1397"></a><tt class="py-lineno">1397</tt> <tt class="py-line"> </tt> +<a name="L1398"></a><tt class="py-lineno">1398</tt> <tt class="py-line"> <tt class="py-comment"># Return address list in requested format.</tt> </tt> +<a name="L1399"></a><tt class="py-lineno">1399</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-697" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-697', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1400"></a><tt class="py-lineno">1400</tt> <tt class="py-line"> <tt class="py-name">cidr_list</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-698" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-698', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">c</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">c</tt> <tt class="py-keyword">in</tt> <tt class="py-name">cidr_list</tt><tt class="py-op">]</tt> </tt> +<a name="L1401"></a><tt class="py-lineno">1401</tt> <tt class="py-line"> </tt> +<a name="L1402"></a><tt class="py-lineno">1402</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">cidr_list</tt> </tt> +</div><a name="L1403"></a><tt class="py-lineno">1403</tt> <tt class="py-line"> </tt> +<a name="IPRange.wildcard"></a><div id="IPRange.wildcard-def"><a name="L1404"></a><tt class="py-lineno">1404</tt> <a class="py-toggle" href="#" id="IPRange.wildcard-toggle" onclick="return toggle('IPRange.wildcard');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#wildcard">wildcard</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.wildcard-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.wildcard-expanded"><a name="L1405"></a><tt class="py-lineno">1405</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1406"></a><tt class="py-lineno">1406</tt> <tt class="py-line"><tt class="py-docstring"> @return: A L{Wildcard} object equivalent to this CIDR.</tt> </tt> +<a name="L1407"></a><tt class="py-lineno">1407</tt> <tt class="py-line"><tt class="py-docstring"> - If CIDR was initialised with C{fmt=str}, a wildcard string</tt> </tt> +<a name="L1408"></a><tt class="py-lineno">1408</tt> <tt class="py-line"><tt class="py-docstring"> is returned, in all other cases a L{Wildcard} object is</tt> </tt> +<a name="L1409"></a><tt class="py-lineno">1409</tt> <tt class="py-line"><tt class="py-docstring"> returned.</tt> </tt> +<a name="L1410"></a><tt class="py-lineno">1410</tt> <tt class="py-line"><tt class="py-docstring"> - Only supports IPv4 CIDR addresses.</tt> </tt> +<a name="L1411"></a><tt class="py-lineno">1411</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1412"></a><tt class="py-lineno">1412</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-699" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-699', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-700" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-700', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-701" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-701', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1413"></a><tt class="py-lineno">1413</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-702" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-702', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-703" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-703', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-704" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-704', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1414"></a><tt class="py-lineno">1414</tt> <tt class="py-line"> </tt> +<a name="L1415"></a><tt class="py-lineno">1415</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-705" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-705', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt id="link-706" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-706', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1416"></a><tt class="py-lineno">1416</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-707" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-707', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'wildcards only suitable for IPv4 '</tt> \ </tt> +<a name="L1417"></a><tt class="py-lineno">1417</tt> <tt class="py-line"> <tt class="py-string">'ranges!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1418"></a><tt class="py-lineno">1418</tt> <tt class="py-line"> </tt> +<a name="L1419"></a><tt class="py-lineno">1419</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L1420"></a><tt class="py-lineno">1420</tt> <tt class="py-line"> </tt> +<a name="L1421"></a><tt class="py-lineno">1421</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L1422"></a><tt class="py-lineno">1422</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L1423"></a><tt class="py-lineno">1423</tt> <tt class="py-line"> </tt> +<a name="L1424"></a><tt class="py-lineno">1424</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">4</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1425"></a><tt class="py-lineno">1425</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> +<a name="L1426"></a><tt class="py-lineno">1426</tt> <tt class="py-line"> <tt class="py-comment"># A normal octet.</tt> </tt> +<a name="L1427"></a><tt class="py-lineno">1427</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1428"></a><tt class="py-lineno">1428</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">255</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1429"></a><tt class="py-lineno">1429</tt> <tt class="py-line"> <tt class="py-comment"># An asterisk octet.</tt> </tt> +<a name="L1430"></a><tt class="py-lineno">1430</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'*'</tt><tt class="py-op">)</tt> </tt> +<a name="L1431"></a><tt class="py-lineno">1431</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L1432"></a><tt class="py-lineno">1432</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1433"></a><tt class="py-lineno">1433</tt> <tt class="py-line"> <tt class="py-comment"># Create a hyphenated octet - only one allowed per wildcard.</tt> </tt> +<a name="L1434"></a><tt class="py-lineno">1434</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_asterisk</tt><tt class="py-op">:</tt> </tt> +<a name="L1435"></a><tt class="py-lineno">1435</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_hyphen</tt><tt class="py-op">:</tt> </tt> +<a name="L1436"></a><tt class="py-lineno">1436</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'%s-%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1437"></a><tt class="py-lineno">1437</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L1438"></a><tt class="py-lineno">1438</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1439"></a><tt class="py-lineno">1439</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-string">'only one hyphenated octet per '</tt> \ </tt> +<a name="L1440"></a><tt class="py-lineno">1440</tt> <tt class="py-line"> <tt class="py-string">'wildcard permitted!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1441"></a><tt class="py-lineno">1441</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1442"></a><tt class="py-lineno">1442</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-string">"* chars aren't permitted before ' \</tt> </tt> +<a name="L1443"></a><tt class="py-lineno">1443</tt> <tt class="py-line"><tt class="py-string"> 'hyphenated octets!"</tt><tt class="py-op">)</tt> </tt> +<a name="L1444"></a><tt class="py-lineno">1444</tt> <tt class="py-line"> </tt> +<a name="L1445"></a><tt class="py-lineno">1445</tt> <tt class="py-line"> <tt id="link-708" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-708', 'wildcard', 'link-361');">wildcard</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> +<a name="L1446"></a><tt class="py-lineno">1446</tt> <tt class="py-line"> </tt> +<a name="L1447"></a><tt class="py-lineno">1447</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-709" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-709', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">==</tt> <tt class="py-name">str</tt><tt class="py-op">:</tt> </tt> +<a name="L1448"></a><tt class="py-lineno">1448</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-710" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-710', 'wildcard', 'link-361');">wildcard</a></tt> </tt> +<a name="L1449"></a><tt class="py-lineno">1449</tt> <tt class="py-line"> </tt> +<a name="L1450"></a><tt class="py-lineno">1450</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-711" class="py-name"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-711', 'Wildcard', 'link-457');">Wildcard</a></tt><tt class="py-op">(</tt><tt id="link-712" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-712', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L1451"></a><tt class="py-lineno">1451</tt> <tt class="py-line"> </tt> +<a name="IPRange.issubnet"></a><div id="IPRange.issubnet-def"><a name="L1452"></a><tt class="py-lineno">1452</tt> <a class="py-toggle" href="#" id="IPRange.issubnet-toggle" onclick="return toggle('IPRange.issubnet');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#issubnet">issubnet</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.issubnet-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.issubnet-expanded"><a name="L1453"></a><tt class="py-lineno">1453</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1454"></a><tt class="py-lineno">1454</tt> <tt class="py-line"><tt class="py-docstring"> @return: True if other's boundary is equal to or within this range.</tt> </tt> +<a name="L1455"></a><tt class="py-lineno">1455</tt> <tt class="py-line"><tt class="py-docstring"> False otherwise.</tt> </tt> +<a name="L1456"></a><tt class="py-lineno">1456</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1457"></a><tt class="py-lineno">1457</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">,</tt> <tt id="link-713" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-713', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1458"></a><tt class="py-lineno">1458</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1459"></a><tt class="py-lineno">1459</tt> <tt class="py-line"> </tt> +<a name="L1460"></a><tt class="py-lineno">1460</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-714" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-714', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-715" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-715', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1461"></a><tt class="py-lineno">1461</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Ranges must be the same address type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1462"></a><tt class="py-lineno">1462</tt> <tt class="py-line"> </tt> +<a name="L1463"></a><tt class="py-lineno">1463</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-716" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-716', 'first', 'link-110');">first</a></tt> <tt class="py-op">>=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-717" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-717', 'first', 'link-110');">first</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-718" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-718', 'last', 'link-372');">last</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-719" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-719', 'last', 'link-372');">last</a></tt> </tt> +</div><a name="L1464"></a><tt class="py-lineno">1464</tt> <tt class="py-line"> </tt> +<a name="IPRange.issupernet"></a><div id="IPRange.issupernet-def"><a name="L1465"></a><tt class="py-lineno">1465</tt> <a class="py-toggle" href="#" id="IPRange.issupernet-toggle" onclick="return toggle('IPRange.issupernet');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#issupernet">issupernet</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.issupernet-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.issupernet-expanded"><a name="L1466"></a><tt class="py-lineno">1466</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1467"></a><tt class="py-lineno">1467</tt> <tt class="py-line"><tt class="py-docstring"> @return: True if other's boundary is equal to or contains this range.</tt> </tt> +<a name="L1468"></a><tt class="py-lineno">1468</tt> <tt class="py-line"><tt class="py-docstring"> False otherwise.</tt> </tt> +<a name="L1469"></a><tt class="py-lineno">1469</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1470"></a><tt class="py-lineno">1470</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">,</tt> <tt id="link-720" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-720', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1471"></a><tt class="py-lineno">1471</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1472"></a><tt class="py-lineno">1472</tt> <tt class="py-line"> </tt> +<a name="L1473"></a><tt class="py-lineno">1473</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-721" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-721', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-722" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-722', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1474"></a><tt class="py-lineno">1474</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Ranges must be the same address type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1475"></a><tt class="py-lineno">1475</tt> <tt class="py-line"> </tt> +<a name="L1476"></a><tt class="py-lineno">1476</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-723" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-723', 'first', 'link-110');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-724" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-724', 'first', 'link-110');">first</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-725" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-725', 'last', 'link-372');">last</a></tt> <tt class="py-op">>=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-726" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-726', 'last', 'link-372');">last</a></tt> </tt> +</div><a name="L1477"></a><tt class="py-lineno">1477</tt> <tt class="py-line"> </tt> +<a name="IPRange.adjacent"></a><div id="IPRange.adjacent-def"><a name="L1478"></a><tt class="py-lineno">1478</tt> <a class="py-toggle" href="#" id="IPRange.adjacent-toggle" onclick="return toggle('IPRange.adjacent');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#adjacent">adjacent</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.adjacent-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.adjacent-expanded"><a name="L1479"></a><tt class="py-lineno">1479</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1480"></a><tt class="py-lineno">1480</tt> <tt class="py-line"><tt class="py-docstring"> @return: True if other's boundary touches the boundary of this</tt> </tt> +<a name="L1481"></a><tt class="py-lineno">1481</tt> <tt class="py-line"><tt class="py-docstring"> address range, False otherwise.</tt> </tt> +<a name="L1482"></a><tt class="py-lineno">1482</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1483"></a><tt class="py-lineno">1483</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">,</tt> <tt class="py-string">'addr_type'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1484"></a><tt class="py-lineno">1484</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupport type: %r!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1485"></a><tt class="py-lineno">1485</tt> <tt class="py-line"> </tt> +<a name="L1486"></a><tt class="py-lineno">1486</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-727" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-727', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-728" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-728', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1487"></a><tt class="py-lineno">1487</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'addresses must be of the same type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1488"></a><tt class="py-lineno">1488</tt> <tt class="py-line"> </tt> +<a name="L1489"></a><tt class="py-lineno">1489</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">,</tt> <tt id="link-729" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-729', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1490"></a><tt class="py-lineno">1490</tt> <tt class="py-line"> <tt class="py-comment"># Left hand side of this address range.</tt> </tt> +<a name="L1491"></a><tt class="py-lineno">1491</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-730" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-730', 'first', 'link-110');">first</a></tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-731" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-731', 'last', 'link-372');">last</a></tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1492"></a><tt class="py-lineno">1492</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1493"></a><tt class="py-lineno">1493</tt> <tt class="py-line"> </tt> +<a name="L1494"></a><tt class="py-lineno">1494</tt> <tt class="py-line"> <tt class="py-comment"># Right hand side of this address range.</tt> </tt> +<a name="L1495"></a><tt class="py-lineno">1495</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-732" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-732', 'last', 'link-372');">last</a></tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-733" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-733', 'first', 'link-110');">first</a></tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1496"></a><tt class="py-lineno">1496</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1497"></a><tt class="py-lineno">1497</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">,</tt> <tt id="link-734" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-734', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1498"></a><tt class="py-lineno">1498</tt> <tt class="py-line"> <tt class="py-comment"># Left hand side of this address range.</tt> </tt> +<a name="L1499"></a><tt class="py-lineno">1499</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-735" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-735', 'first', 'link-110');">first</a></tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-736" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-736', 'value', 'link-30');">value</a></tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1500"></a><tt class="py-lineno">1500</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1501"></a><tt class="py-lineno">1501</tt> <tt class="py-line"> </tt> +<a name="L1502"></a><tt class="py-lineno">1502</tt> <tt class="py-line"> <tt class="py-comment"># Right hand side of this address range.</tt> </tt> +<a name="L1503"></a><tt class="py-lineno">1503</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-737" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-737', 'last', 'link-372');">last</a></tt> <tt class="py-op">==</tt> <tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-738" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-738', 'value', 'link-30');">value</a></tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1504"></a><tt class="py-lineno">1504</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1505"></a><tt class="py-lineno">1505</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1506"></a><tt class="py-lineno">1506</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unexpected error for argument: %r!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1507"></a><tt class="py-lineno">1507</tt> <tt class="py-line"> </tt> +<a name="L1508"></a><tt class="py-lineno">1508</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1509"></a><tt class="py-lineno">1509</tt> <tt class="py-line"> </tt> +<a name="IPRange.overlaps"></a><div id="IPRange.overlaps-def"><a name="L1510"></a><tt class="py-lineno">1510</tt> <a class="py-toggle" href="#" id="IPRange.overlaps-toggle" onclick="return toggle('IPRange.overlaps');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#overlaps">overlaps</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.overlaps-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.overlaps-expanded"><a name="L1511"></a><tt class="py-lineno">1511</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1512"></a><tt class="py-lineno">1512</tt> <tt class="py-line"><tt class="py-docstring"> @return: True if other's boundary crosses the boundary of this address</tt> </tt> +<a name="L1513"></a><tt class="py-lineno">1513</tt> <tt class="py-line"><tt class="py-docstring"> range, False otherwise.</tt> </tt> +<a name="L1514"></a><tt class="py-lineno">1514</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1515"></a><tt class="py-lineno">1515</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">,</tt> <tt id="link-739" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-739', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1516"></a><tt class="py-lineno">1516</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1517"></a><tt class="py-lineno">1517</tt> <tt class="py-line"> </tt> +<a name="L1518"></a><tt class="py-lineno">1518</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-740" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-740', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-741" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-741', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1519"></a><tt class="py-lineno">1519</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'Ranges must be the same address type!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1520"></a><tt class="py-lineno">1520</tt> <tt class="py-line"> </tt> +<a name="L1521"></a><tt class="py-lineno">1521</tt> <tt class="py-line"> <tt class="py-comment"># Left hand side of this address range.</tt> </tt> +<a name="L1522"></a><tt class="py-lineno">1522</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-742" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-742', 'first', 'link-110');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-743" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-743', 'last', 'link-372');">last</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-744" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-744', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1523"></a><tt class="py-lineno">1523</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1524"></a><tt class="py-lineno">1524</tt> <tt class="py-line"> </tt> +<a name="L1525"></a><tt class="py-lineno">1525</tt> <tt class="py-line"> <tt class="py-comment"># Right hand side of this address range.</tt> </tt> +<a name="L1526"></a><tt class="py-lineno">1526</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-745" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-745', 'first', 'link-110');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-746" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-746', 'first', 'link-110');">first</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-747" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-747', 'last', 'link-372');">last</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1527"></a><tt class="py-lineno">1527</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L1528"></a><tt class="py-lineno">1528</tt> <tt class="py-line"> </tt> +<a name="L1529"></a><tt class="py-lineno">1529</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L1530"></a><tt class="py-lineno">1530</tt> <tt class="py-line"> </tt> +<a name="IPRange.__str__"></a><div id="IPRange.__str__-def"><a name="L1531"></a><tt class="py-lineno">1531</tt> <a class="py-toggle" href="#" id="IPRange.__str__-toggle" onclick="return toggle('IPRange.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__str__-expanded"><a name="L1532"></a><tt class="py-lineno">1532</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s-%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-748" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-748', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-749" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.EUI48Strategy.int_to_str +netaddr.strategy.IPv4StrategyOpt.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-749', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-750" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-750', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1533"></a><tt class="py-lineno">1533</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-751" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-500', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-501" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-751', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-752" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-501', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-502" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-502', 'first', 'link-89');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> -<a name="L1188"></a><tt class="py-lineno">1188</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-503" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-752', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-753" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-753', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L1534"></a><tt class="py-lineno">1534</tt> <tt class="py-line"> </tt> +<a name="IPRange.__repr__"></a><div id="IPRange.__repr__-def"><a name="L1535"></a><tt class="py-lineno">1535</tt> <a class="py-toggle" href="#" id="IPRange.__repr__-toggle" onclick="return toggle('IPRange.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRange-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRange.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRange.__repr__-expanded"><a name="L1536"></a><tt class="py-lineno">1536</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object."""</tt> </tt> +<a name="L1537"></a><tt class="py-lineno">1537</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s(%r, %r)"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> </tt> +<a name="L1538"></a><tt class="py-lineno">1538</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-754" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-503', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-504" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-754', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-755" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-504', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-505" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-505', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L1189"></a><tt class="py-lineno">1189</tt> <tt class="py-line"> </tt> -<a name="L1190"></a><tt class="py-lineno">1190</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="CIDR"></a><div id="CIDR-def"><a name="L1191"></a><tt class="py-lineno">1191</tt> <a class="py-toggle" href="#" id="CIDR-toggle" onclick="return toggle('CIDR');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html">CIDR</a><tt class="py-op">(</tt><tt class="py-base-class">AddrRange</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="CIDR-expanded"><a name="L1192"></a><tt class="py-lineno">1192</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1193"></a><tt class="py-lineno">1193</tt> <tt class="py-line"><tt class="py-docstring"> A block of contiguous IPv4 or IPv6 network addresses defined by a base</tt> </tt> -<a name="L1194"></a><tt class="py-lineno">1194</tt> <tt class="py-line"><tt class="py-docstring"> network address and a bitmask prefix or subnet mask address indicating the</tt> </tt> -<a name="L1195"></a><tt class="py-lineno">1195</tt> <tt class="py-line"><tt class="py-docstring"> size/extent of the subnet.</tt> </tt> -<a name="L1196"></a><tt class="py-lineno">1196</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1197"></a><tt class="py-lineno">1197</tt> <tt class="py-line"><tt class="py-docstring"> By default, this class does not allow any non-zero bits to be set right</tt> </tt> -<a name="L1198"></a><tt class="py-lineno">1198</tt> <tt class="py-line"><tt class="py-docstring"> of the bitmask when it is applied to the supplied base address. Doing so</tt> </tt> -<a name="L1199"></a><tt class="py-lineno">1199</tt> <tt class="py-line"><tt class="py-docstring"> raises an L{AddrFormatError} exception. However, it is now configurable</tt> </tt> -<a name="L1200"></a><tt class="py-lineno">1200</tt> <tt class="py-line"><tt class="py-docstring"> and will allow a less strict base address if you ask for one. Be aware</tt> </tt> -<a name="L1201"></a><tt class="py-lineno">1201</tt> <tt class="py-line"><tt class="py-docstring"> though that the bitmask will be applied to the base address and and</tt> </tt> -<a name="L1202"></a><tt class="py-lineno">1202</tt> <tt class="py-line"><tt class="py-docstring"> trailing non-zero bits removed losing the original address. It will *not*</tt> </tt> -<a name="L1203"></a><tt class="py-lineno">1203</tt> <tt class="py-line"><tt class="py-docstring"> be preserved!</tt> </tt> -<a name="L1204"></a><tt class="py-lineno">1204</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1205"></a><tt class="py-lineno">1205</tt> <tt class="py-line"><tt class="py-docstring"> Contrast this behaviour with the L{IP} class which is less strict and has</tt> </tt> -<a name="L1206"></a><tt class="py-lineno">1206</tt> <tt class="py-line"><tt class="py-docstring"> a cidr() method for returning CIDR objects without any loss of</tt> </tt> -<a name="L1207"></a><tt class="py-lineno">1207</tt> <tt class="py-line"><tt class="py-docstring"> information.</tt> </tt> -<a name="L1208"></a><tt class="py-lineno">1208</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1209"></a><tt class="py-lineno">1209</tt> <tt class="py-line"><tt class="py-docstring"> Examples of supported formats :-</tt> </tt> -<a name="L1210"></a><tt class="py-lineno">1210</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1211"></a><tt class="py-lineno">1211</tt> <tt class="py-line"><tt class="py-docstring"> 1. CIDR address format - C{<address>/<mask_length>}::</tt> </tt> -<a name="L1212"></a><tt class="py-lineno">1212</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1213"></a><tt class="py-lineno">1213</tt> <tt class="py-line"><tt class="py-docstring"> 192.168.0.0/16</tt> </tt> -<a name="L1214"></a><tt class="py-lineno">1214</tt> <tt class="py-line"><tt class="py-docstring"> fe80::/64</tt> </tt> -<a name="L1215"></a><tt class="py-lineno">1215</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1216"></a><tt class="py-lineno">1216</tt> <tt class="py-line"><tt class="py-docstring"> 2. Address and subnet mask combo ::</tt> </tt> -<a name="L1217"></a><tt class="py-lineno">1217</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1218"></a><tt class="py-lineno">1218</tt> <tt class="py-line"><tt class="py-docstring"> 192.168.0.0/255.255.0.0 == 192.168.0.0/16</tt> </tt> -<a name="L1219"></a><tt class="py-lineno">1219</tt> <tt class="py-line"><tt class="py-docstring"> fe80::/ffff:ffff:ffff:ffff:: == fe80::/64</tt> </tt> -<a name="L1220"></a><tt class="py-lineno">1220</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1221"></a><tt class="py-lineno">1221</tt> <tt class="py-line"><tt class="py-docstring"> 3. Partial or abbreviated formats (IPv4 only). Prefixes may be omitted</tt> </tt> -<a name="L1222"></a><tt class="py-lineno">1222</tt> <tt class="py-line"><tt class="py-docstring"> and in this case older class-based default prefixes apply ::</tt> </tt> -<a name="L1223"></a><tt class="py-lineno">1223</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1224"></a><tt class="py-lineno">1224</tt> <tt class="py-line"><tt class="py-docstring"> 10 == 10.0.0.0/8</tt> </tt> -<a name="L1225"></a><tt class="py-lineno">1225</tt> <tt class="py-line"><tt class="py-docstring"> 10.0 == 10.0.0.0/8</tt> </tt> -<a name="L1226"></a><tt class="py-lineno">1226</tt> <tt class="py-line"><tt class="py-docstring"> 10/8 == 10.0.0.0/8</tt> </tt> -<a name="L1227"></a><tt class="py-lineno">1227</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1228"></a><tt class="py-lineno">1228</tt> <tt class="py-line"><tt class="py-docstring"> 128 == 128.0.0.0/16</tt> </tt> -<a name="L1229"></a><tt class="py-lineno">1229</tt> <tt class="py-line"><tt class="py-docstring"> 128.0 == 128.0.0.0/16</tt> </tt> -<a name="L1230"></a><tt class="py-lineno">1230</tt> <tt class="py-line"><tt class="py-docstring"> 128/16 == 128.0.0.0/16</tt> </tt> -<a name="L1231"></a><tt class="py-lineno">1231</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1232"></a><tt class="py-lineno">1232</tt> <tt class="py-line"><tt class="py-docstring"> 192 == 10.0.0.0/24</tt> </tt> -<a name="L1233"></a><tt class="py-lineno">1233</tt> <tt class="py-line"><tt class="py-docstring"> 192.168.0 == 192.168.0.0/24</tt> </tt> -<a name="L1234"></a><tt class="py-lineno">1234</tt> <tt class="py-line"><tt class="py-docstring"> 192.168/16 == 192.168.0.0/16</tt> </tt> -<a name="L1235"></a><tt class="py-lineno">1235</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1236"></a><tt class="py-lineno">1236</tt> <tt class="py-line"> <tt id="link-506" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-755', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-756" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-756', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1539"></a><tt class="py-lineno">1539</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-757" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-757', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-758" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.EUI48Strategy.int_to_str +netaddr.strategy.IPv4StrategyOpt.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-758', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-759" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-759', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L1540"></a><tt class="py-lineno">1540</tt> <tt class="py-line"> </tt> +<a name="L1541"></a><tt class="py-lineno">1541</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="CIDR"></a><div id="CIDR-def"><a name="L1542"></a><tt class="py-lineno">1542</tt> <a class="py-toggle" href="#" id="CIDR-toggle" onclick="return toggle('CIDR');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html">CIDR</a><tt class="py-op">(</tt><tt class="py-base-class">IPRange</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="CIDR-expanded"><a name="L1543"></a><tt class="py-lineno">1543</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1544"></a><tt class="py-lineno">1544</tt> <tt class="py-line"><tt class="py-docstring"> Represents blocks of IPv4 and IPv6 addresses using CIDR (Classless</tt> </tt> +<a name="L1545"></a><tt class="py-lineno">1545</tt> <tt class="py-line"><tt class="py-docstring"> Inter-Domain Routing) notation.</tt> </tt> +<a name="L1546"></a><tt class="py-lineno">1546</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1547"></a><tt class="py-lineno">1547</tt> <tt class="py-line"><tt class="py-docstring"> CIDR is a method of categorising contiguous blocks of both IPv4 and IPv6</tt> </tt> +<a name="L1548"></a><tt class="py-lineno">1548</tt> <tt class="py-line"><tt class="py-docstring"> addresses. It is very scalable allowing for the optimal usage of the IP</tt> </tt> +<a name="L1549"></a><tt class="py-lineno">1549</tt> <tt class="py-line"><tt class="py-docstring"> address space. It permits the aggregation of networks via route</tt> </tt> +<a name="L1550"></a><tt class="py-lineno">1550</tt> <tt class="py-line"><tt class="py-docstring"> summarisation (supernetting) where adjacent routes can be combined into a</tt> </tt> +<a name="L1551"></a><tt class="py-lineno">1551</tt> <tt class="py-line"><tt class="py-docstring"> single route easily. This greatly assists in the reduction of routing</tt> </tt> +<a name="L1552"></a><tt class="py-lineno">1552</tt> <tt class="py-line"><tt class="py-docstring"> table sizes and improves network router efficiency.</tt> </tt> +<a name="L1553"></a><tt class="py-lineno">1553</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1554"></a><tt class="py-lineno">1554</tt> <tt class="py-line"><tt class="py-docstring"> CIDR blocks are represented by a base network address and a prefix</tt> </tt> +<a name="L1555"></a><tt class="py-lineno">1555</tt> <tt class="py-line"><tt class="py-docstring"> indicating the size of the (variable length) subnet mask. These are</tt> </tt> +<a name="L1556"></a><tt class="py-lineno">1556</tt> <tt class="py-line"><tt class="py-docstring"> separated by a single '/' character. Subnet sizes increase in powers of</tt> </tt> +<a name="L1557"></a><tt class="py-lineno">1557</tt> <tt class="py-line"><tt class="py-docstring"> base 2 aligning to bit boundaries.</tt> </tt> +<a name="L1558"></a><tt class="py-lineno">1558</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1559"></a><tt class="py-lineno">1559</tt> <tt class="py-line"><tt class="py-docstring"> It is technically invalid to have non-zero bits in a CIDR address to the</tt> </tt> +<a name="L1560"></a><tt class="py-lineno">1560</tt> <tt class="py-line"><tt class="py-docstring"> right of the implied netmask. For user convenience this is however</tt> </tt> +<a name="L1561"></a><tt class="py-lineno">1561</tt> <tt class="py-line"><tt class="py-docstring"> configurable and can be disabled using a constructor argument.</tt> </tt> +<a name="L1562"></a><tt class="py-lineno">1562</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1563"></a><tt class="py-lineno">1563</tt> <tt class="py-line"><tt class="py-docstring"> The constructor accepts CIDRs expressed in one of 4 different ways :-</tt> </tt> +<a name="L1564"></a><tt class="py-lineno">1564</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1565"></a><tt class="py-lineno">1565</tt> <tt class="py-line"><tt class="py-docstring"> A) Standard CIDR format :-</tt> </tt> +<a name="L1566"></a><tt class="py-lineno">1566</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1567"></a><tt class="py-lineno">1567</tt> <tt class="py-line"><tt class="py-docstring"> IPv4::</tt> </tt> +<a name="L1568"></a><tt class="py-lineno">1568</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1569"></a><tt class="py-lineno">1569</tt> <tt class="py-line"><tt class="py-docstring"> x.x.x.x/y -> 192.0.2.0/24</tt> </tt> +<a name="L1570"></a><tt class="py-lineno">1570</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1571"></a><tt class="py-lineno">1571</tt> <tt class="py-line"><tt class="py-docstring"> where the x's represent the network address and y is the netmask</tt> </tt> +<a name="L1572"></a><tt class="py-lineno">1572</tt> <tt class="py-line"><tt class="py-docstring"> prefix between 0 and 32.</tt> </tt> +<a name="L1573"></a><tt class="py-lineno">1573</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1574"></a><tt class="py-lineno">1574</tt> <tt class="py-line"><tt class="py-docstring"> IPv6::</tt> </tt> +<a name="L1575"></a><tt class="py-lineno">1575</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1576"></a><tt class="py-lineno">1576</tt> <tt class="py-line"><tt class="py-docstring"> x::/y -> fe80::/10</tt> </tt> +<a name="L1577"></a><tt class="py-lineno">1577</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1578"></a><tt class="py-lineno">1578</tt> <tt class="py-line"><tt class="py-docstring"> where the x's represent the network address and y is the netmask</tt> </tt> +<a name="L1579"></a><tt class="py-lineno">1579</tt> <tt class="py-line"><tt class="py-docstring"> prefix between 0 and 128.</tt> </tt> +<a name="L1580"></a><tt class="py-lineno">1580</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1581"></a><tt class="py-lineno">1581</tt> <tt class="py-line"><tt class="py-docstring"> B) Abbreviated CIDR format (IPv4 only)::</tt> </tt> +<a name="L1582"></a><tt class="py-lineno">1582</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1583"></a><tt class="py-lineno">1583</tt> <tt class="py-line"><tt class="py-docstring"> x -> 192</tt> </tt> +<a name="L1584"></a><tt class="py-lineno">1584</tt> <tt class="py-line"><tt class="py-docstring"> x/y -> 10/8</tt> </tt> +<a name="L1585"></a><tt class="py-lineno">1585</tt> <tt class="py-line"><tt class="py-docstring"> x.x/y -> 192.168/16</tt> </tt> +<a name="L1586"></a><tt class="py-lineno">1586</tt> <tt class="py-line"><tt class="py-docstring"> x.x.x/y -> 192.168.0/24</tt> </tt> +<a name="L1587"></a><tt class="py-lineno">1587</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1588"></a><tt class="py-lineno">1588</tt> <tt class="py-line"><tt class="py-docstring"> which are equivalent to::</tt> </tt> +<a name="L1589"></a><tt class="py-lineno">1589</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1590"></a><tt class="py-lineno">1590</tt> <tt class="py-line"><tt class="py-docstring"> x.0.0.0/y -> 192.0.0.0/24</tt> </tt> +<a name="L1591"></a><tt class="py-lineno">1591</tt> <tt class="py-line"><tt class="py-docstring"> x.0.0.0/y -> 10.0.0.0/8</tt> </tt> +<a name="L1592"></a><tt class="py-lineno">1592</tt> <tt class="py-line"><tt class="py-docstring"> x.x.0.0/y -> 192.168.0.0/16</tt> </tt> +<a name="L1593"></a><tt class="py-lineno">1593</tt> <tt class="py-line"><tt class="py-docstring"> x.x.x.0/y -> 192.168.0.0/24</tt> </tt> +<a name="L1594"></a><tt class="py-lineno">1594</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1595"></a><tt class="py-lineno">1595</tt> <tt class="py-line"><tt class="py-docstring"> - The trailing zeros are implicit.</tt> </tt> +<a name="L1596"></a><tt class="py-lineno">1596</tt> <tt class="py-line"><tt class="py-docstring"> - Old classful IP address rules apply if y is omitted.</tt> </tt> +<a name="L1597"></a><tt class="py-lineno">1597</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1598"></a><tt class="py-lineno">1598</tt> <tt class="py-line"><tt class="py-docstring"> C) Hybrid CIDR format (prefix replaced by netmask) :-</tt> </tt> +<a name="L1599"></a><tt class="py-lineno">1599</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1600"></a><tt class="py-lineno">1600</tt> <tt class="py-line"><tt class="py-docstring"> IPv4::</tt> </tt> +<a name="L1601"></a><tt class="py-lineno">1601</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1602"></a><tt class="py-lineno">1602</tt> <tt class="py-line"><tt class="py-docstring"> x.x.x.x/y.y.y.y -> 192.0.2.0/255.255.255.0</tt> </tt> +<a name="L1603"></a><tt class="py-lineno">1603</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1604"></a><tt class="py-lineno">1604</tt> <tt class="py-line"><tt class="py-docstring"> IPv6::</tt> </tt> +<a name="L1605"></a><tt class="py-lineno">1605</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1606"></a><tt class="py-lineno">1606</tt> <tt class="py-line"><tt class="py-docstring"> x::/y:: -> fe80::/ffc0::</tt> </tt> +<a name="L1607"></a><tt class="py-lineno">1607</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1608"></a><tt class="py-lineno">1608</tt> <tt class="py-line"><tt class="py-docstring"> where the y's represent a valid netmask.</tt> </tt> +<a name="L1609"></a><tt class="py-lineno">1609</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1610"></a><tt class="py-lineno">1610</tt> <tt class="py-line"><tt class="py-docstring"> D) ACL-style CIDR format (prefix is replaced by a hostmask) :-</tt> </tt> +<a name="L1611"></a><tt class="py-lineno">1611</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1612"></a><tt class="py-lineno">1612</tt> <tt class="py-line"><tt class="py-docstring"> Akin to Cisco's ACL (Access Control List) bitmasking (reverse</tt> </tt> +<a name="L1613"></a><tt class="py-lineno">1613</tt> <tt class="py-line"><tt class="py-docstring"> netmasks).</tt> </tt> +<a name="L1614"></a><tt class="py-lineno">1614</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1615"></a><tt class="py-lineno">1615</tt> <tt class="py-line"><tt class="py-docstring"> IPv4::</tt> </tt> +<a name="L1616"></a><tt class="py-lineno">1616</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1617"></a><tt class="py-lineno">1617</tt> <tt class="py-line"><tt class="py-docstring"> x.x.x.x/y.y.y.y -> 192.0.2.0/0.0.0.255</tt> </tt> +<a name="L1618"></a><tt class="py-lineno">1618</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1619"></a><tt class="py-lineno">1619</tt> <tt class="py-line"><tt class="py-docstring"> IPv6::</tt> </tt> +<a name="L1620"></a><tt class="py-lineno">1620</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1621"></a><tt class="py-lineno">1621</tt> <tt class="py-line"><tt class="py-docstring"> x::/y:: -> fe80::/3f:ffff:ffff:ffff:ffff:ffff:ffff:ffff</tt> </tt> +<a name="L1622"></a><tt class="py-lineno">1622</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1623"></a><tt class="py-lineno">1623</tt> <tt class="py-line"><tt class="py-docstring"> where the y's represent a valid hostmask.</tt> </tt> +<a name="L1624"></a><tt class="py-lineno">1624</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1625"></a><tt class="py-lineno">1625</tt> <tt class="py-line"><tt class="py-docstring"> Reference: RFCs 1338 and 4632.</tt> </tt> +<a name="L1626"></a><tt class="py-lineno">1626</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1627"></a><tt class="py-lineno">1627</tt> <tt class="py-line"> <tt id="link-760" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-506', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-507" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-507', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-508" class="py-name"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-508', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1237"></a><tt class="py-lineno">1237</tt> <tt class="py-line"> <tt id="link-509" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-760', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-761" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-761', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-762" class="py-name"><a title="netaddr.ST_IPV6 +netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-762', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1628"></a><tt class="py-lineno">1628</tt> <tt class="py-line"> <tt id="link-763" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-509', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-510" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-510', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-511" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-511', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-512" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-512', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1238"></a><tt class="py-lineno">1238</tt> <tt class="py-line"> </tt> -<a name="L1239"></a><tt class="py-lineno">1239</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> -<a name="L1240"></a><tt class="py-lineno">1240</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-513" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-763', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-764" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-764', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-765" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-765', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-766" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-766', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1629"></a><tt class="py-lineno">1629</tt> <tt class="py-line"> </tt> +<a name="L1630"></a><tt class="py-lineno">1630</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> +<a name="L1631"></a><tt class="py-lineno">1631</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-767" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-513', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-514" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-514', 'StrategyDescriptor', 'link-123');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-515" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-767', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-768" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-768', 'StrategyDescriptor', 'link-142');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-769" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-515', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1241"></a><tt class="py-lineno">1241</tt> <tt class="py-line"> <tt id="link-516" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-769', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1632"></a><tt class="py-lineno">1632</tt> <tt class="py-line"> <tt id="link-770" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-516', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-517" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-517', 'AddrTypeDescriptor', 'link-126');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-518" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-770', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-771" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-771', 'AddrTypeDescriptor', 'link-145');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-772" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-518', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1242"></a><tt class="py-lineno">1242</tt> <tt class="py-line"> <tt id="link-519" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-519', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-520" class="py-name"><a title="netaddr.address.PrefixLenDescriptor" class="py-name" href="#" onclick="return doclink('link-520', 'PrefixLenDescriptor', 'link-245');">PrefixLenDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'CIDR'</tt><tt class="py-op">)</tt> </tt> -<a name="L1243"></a><tt class="py-lineno">1243</tt> <tt class="py-line"> <tt id="link-521" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-521', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">=</tt> <tt id="link-522" class="py-name"><a title="netaddr.address.KlassDescriptor" class="py-name" href="#" onclick="return doclink('link-522', 'KlassDescriptor', 'link-377');">KlassDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-523" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-523', 'IP', 'link-71');">IP</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1244"></a><tt class="py-lineno">1244</tt> <tt class="py-line"> </tt> -<a name="CIDR.abbrev_to_verbose"></a><div id="CIDR.abbrev_to_verbose-def"><a name="L1245"></a><tt class="py-lineno">1245</tt> <a class="py-toggle" href="#" id="CIDR.abbrev_to_verbose-toggle" onclick="return toggle('CIDR.abbrev_to_verbose');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#abbrev_to_verbose">abbrev_to_verbose</a><tt class="py-op">(</tt><tt class="py-param">abbrev_cidr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.abbrev_to_verbose-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.abbrev_to_verbose-expanded"><a name="L1246"></a><tt class="py-lineno">1246</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1247"></a><tt class="py-lineno">1247</tt> <tt class="py-line"><tt class="py-docstring"> A statis method that converts abbreviated CIDR addresses into their</tt> </tt> -<a name="L1248"></a><tt class="py-lineno">1248</tt> <tt class="py-line"><tt class="py-docstring"> verbose form.</tt> </tt> -<a name="L1249"></a><tt class="py-lineno">1249</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1250"></a><tt class="py-lineno">1250</tt> <tt class="py-line"><tt class="py-docstring"> @param abbrev_cidr: an abbreviated CIDR network address.</tt> </tt> -<a name="L1251"></a><tt class="py-lineno">1251</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1252"></a><tt class="py-lineno">1252</tt> <tt class="py-line"><tt class="py-docstring"> Uses the old-style classful IP address rules to decide on a default</tt> </tt> -<a name="L1253"></a><tt class="py-lineno">1253</tt> <tt class="py-line"><tt class="py-docstring"> subnet prefix if one is not explicitly provided.</tt> </tt> -<a name="L1254"></a><tt class="py-lineno">1254</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1255"></a><tt class="py-lineno">1255</tt> <tt class="py-line"><tt class="py-docstring"> Only supports IPv4 addresses.</tt> </tt> -<a name="L1256"></a><tt class="py-lineno">1256</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1257"></a><tt class="py-lineno">1257</tt> <tt class="py-line"><tt class="py-docstring"> Examples ::</tt> </tt> -<a name="L1258"></a><tt class="py-lineno">1258</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1259"></a><tt class="py-lineno">1259</tt> <tt class="py-line"><tt class="py-docstring"> 10 - 10.0.0.0/8</tt> </tt> -<a name="L1260"></a><tt class="py-lineno">1260</tt> <tt class="py-line"><tt class="py-docstring"> 10/16 - 10.0.0.0/16</tt> </tt> -<a name="L1261"></a><tt class="py-lineno">1261</tt> <tt class="py-line"><tt class="py-docstring"> 128 - 128.0.0.0/16</tt> </tt> -<a name="L1262"></a><tt class="py-lineno">1262</tt> <tt class="py-line"><tt class="py-docstring"> 128/8 - 128.0.0.0/8</tt> </tt> -<a name="L1263"></a><tt class="py-lineno">1263</tt> <tt class="py-line"><tt class="py-docstring"> 192.168 - 192.168.0.0/16</tt> </tt> -<a name="L1264"></a><tt class="py-lineno">1264</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1265"></a><tt class="py-lineno">1265</tt> <tt class="py-line"><tt class="py-docstring"> @return: A verbose CIDR from an abbreviated CIDR or old-style classful</tt> </tt> -<a name="L1266"></a><tt class="py-lineno">1266</tt> <tt class="py-line"><tt class="py-docstring"> network address, C{None} if format provided was not recognised or</tt> </tt> -<a name="L1267"></a><tt class="py-lineno">1267</tt> <tt class="py-line"><tt class="py-docstring"> supported.</tt> </tt> -<a name="L1268"></a><tt class="py-lineno">1268</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1269"></a><tt class="py-lineno">1269</tt> <tt class="py-line"> <tt class="py-comment"># Internal function that returns a prefix value based on the old IPv4</tt> </tt> -<a name="L1270"></a><tt class="py-lineno">1270</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># classful network scheme that has been superseded (almost) by CIDR.</tt> </tt> -<a name="L1271"></a><tt class="py-lineno">1271</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">def</tt> <tt class="py-def-name">classful_prefix</tt><tt class="py-op">(</tt><tt class="py-param">octet</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1272"></a><tt class="py-lineno">1272</tt> <tt class="py-line"> <tt class="py-name">octet</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">octet</tt><tt class="py-op">)</tt> </tt> -<a name="L1273"></a><tt class="py-lineno">1273</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">32</tt> <tt class="py-comment"># Host address default.</tt> </tt> -<a name="L1274"></a><tt class="py-lineno">1274</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">255</tt><tt class="py-op">:</tt> </tt> -<a name="L1275"></a><tt class="py-lineno">1275</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid octet: %r!'</tt> <tt class="py-op">%</tt> <tt class="py-name">octet</tt><tt class="py-op">)</tt> </tt> -<a name="L1276"></a><tt class="py-lineno">1276</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">127</tt><tt class="py-op">:</tt> </tt> -<a name="L1277"></a><tt class="py-lineno">1277</tt> <tt class="py-line"> <tt class="py-comment"># Class A</tt> </tt> -<a name="L1278"></a><tt class="py-lineno">1278</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">8</tt> </tt> -<a name="L1279"></a><tt class="py-lineno">1279</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">128</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">191</tt><tt class="py-op">:</tt> </tt> -<a name="L1280"></a><tt class="py-lineno">1280</tt> <tt class="py-line"> <tt class="py-comment"># Class B</tt> </tt> -<a name="L1281"></a><tt class="py-lineno">1281</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">16</tt> </tt> -<a name="L1282"></a><tt class="py-lineno">1282</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">192</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">223</tt><tt class="py-op">:</tt> </tt> -<a name="L1283"></a><tt class="py-lineno">1283</tt> <tt class="py-line"> <tt class="py-comment"># Class C</tt> </tt> -<a name="L1284"></a><tt class="py-lineno">1284</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">24</tt> </tt> -<a name="L1285"></a><tt class="py-lineno">1285</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">octet</tt> <tt class="py-op">==</tt> <tt class="py-number">224</tt><tt class="py-op">:</tt> </tt> -<a name="L1286"></a><tt class="py-lineno">1286</tt> <tt class="py-line"> <tt class="py-comment"># Class D (multicast)</tt> </tt> -<a name="L1287"></a><tt class="py-lineno">1287</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">4</tt> </tt> -<a name="L1288"></a><tt class="py-lineno">1288</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">225</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">239</tt><tt class="py-op">:</tt> </tt> -<a name="L1289"></a><tt class="py-lineno">1289</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">8</tt> </tt> -<a name="L1290"></a><tt class="py-lineno">1290</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">prefix</tt> </tt> -</div><a name="L1291"></a><tt class="py-lineno">1291</tt> <tt class="py-line"> </tt> -<a name="L1292"></a><tt class="py-lineno">1292</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt> -<a name="L1293"></a><tt class="py-lineno">1293</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L1294"></a><tt class="py-lineno">1294</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> -<a name="L1295"></a><tt class="py-lineno">1295</tt> <tt class="py-line"> </tt> -<a name="L1296"></a><tt class="py-lineno">1296</tt> <tt class="py-line"> <tt class="py-comment">#FIXME: # Check for IPv4 mapped IPv6 addresses.</tt> </tt> -<a name="L1297"></a><tt class="py-lineno">1297</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">abbrev_cidr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1298"></a><tt class="py-lineno">1298</tt> <tt class="py-line"> <tt class="py-comment">################</tt> </tt> -<a name="L1299"></a><tt class="py-lineno">1299</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Don't support IPv6 for now...</tt> </tt> -<a name="L1300"></a><tt class="py-lineno">1300</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">':'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">abbrev_cidr</tt><tt class="py-op">:</tt> </tt> -<a name="L1301"></a><tt class="py-lineno">1301</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> -<a name="L1302"></a><tt class="py-lineno">1302</tt> <tt class="py-line"> <tt class="py-comment">################</tt> </tt> -<a name="L1303"></a><tt class="py-lineno">1303</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: if abbrev_cidr.startswith('::ffff:'):</tt> </tt> -<a name="L1304"></a><tt class="py-lineno">1304</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: abbrev_cidr = abbrev_cidr.replace('::ffff:', '')</tt> </tt> -<a name="L1305"></a><tt class="py-lineno">1305</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: start = '::ffff:'</tt> </tt> -<a name="L1306"></a><tt class="py-lineno">1306</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: if '/' not in abbrev_cidr:</tt> </tt> -<a name="L1307"></a><tt class="py-lineno">1307</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: prefix = 128</tt> </tt> -<a name="L1308"></a><tt class="py-lineno">1308</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: elif abbrev_cidr.startswith('::'):</tt> </tt> -<a name="L1309"></a><tt class="py-lineno">1309</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: abbrev_cidr = abbrev_cidr.replace('::', '')</tt> </tt> -<a name="L1310"></a><tt class="py-lineno">1310</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: start = '::'</tt> </tt> -<a name="L1311"></a><tt class="py-lineno">1311</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: if '/' not in abbrev_cidr:</tt> </tt> -<a name="L1312"></a><tt class="py-lineno">1312</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: prefix = 128</tt> </tt> -<a name="L1313"></a><tt class="py-lineno">1313</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">################</tt> </tt> -<a name="L1314"></a><tt class="py-lineno">1314</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="L1315"></a><tt class="py-lineno">1315</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1316"></a><tt class="py-lineno">1316</tt> <tt class="py-line"> <tt class="py-comment"># Single octet partial integer or string address.</tt> </tt> -<a name="L1317"></a><tt class="py-lineno">1317</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">i</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">abbrev_cidr</tt><tt class="py-op">)</tt> </tt> -<a name="L1318"></a><tt class="py-lineno">1318</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> -<a name="L1319"></a><tt class="py-lineno">1319</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">classful_prefix</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1320"></a><tt class="py-lineno">1320</tt> <tt class="py-line"> </tt> -<a name="L1321"></a><tt class="py-lineno">1321</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L1322"></a><tt class="py-lineno">1322</tt> <tt class="py-line"> <tt class="py-comment"># Multi octet partial string address with optional prefix.</tt> </tt> -<a name="L1323"></a><tt class="py-lineno">1323</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">part_addr</tt> <tt class="py-op">=</tt> <tt class="py-name">abbrev_cidr</tt> </tt> -<a name="L1324"></a><tt class="py-lineno">1324</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L1325"></a><tt class="py-lineno">1325</tt> <tt class="py-line"> </tt> -<a name="L1326"></a><tt class="py-lineno">1326</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">part_addr</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L1327"></a><tt class="py-lineno">1327</tt> <tt class="py-line"> <tt class="py-comment"># Not a recognisable format.</tt> </tt> -<a name="L1328"></a><tt class="py-lineno">1328</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> -<a name="L1329"></a><tt class="py-lineno">1329</tt> <tt class="py-line"> </tt> -<a name="L1330"></a><tt class="py-lineno">1330</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'/'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">part_addr</tt><tt class="py-op">:</tt> </tt> -<a name="L1331"></a><tt class="py-lineno">1331</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">part_addr</tt><tt class="py-op">,</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">part_addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L1332"></a><tt class="py-lineno">1332</tt> <tt class="py-line"> </tt> -<a name="L1333"></a><tt class="py-lineno">1333</tt> <tt class="py-line"> <tt class="py-comment"># Check prefix for validity.</tt> </tt> -<a name="L1334"></a><tt class="py-lineno">1334</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L1335"></a><tt class="py-lineno">1335</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1336"></a><tt class="py-lineno">1336</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-number">32</tt><tt class="py-op">:</tt> </tt> -<a name="L1337"></a><tt class="py-lineno">1337</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> -<a name="L1338"></a><tt class="py-lineno">1338</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L1339"></a><tt class="py-lineno">1339</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> -<a name="L1340"></a><tt class="py-lineno">1340</tt> <tt class="py-line"> </tt> -<a name="L1341"></a><tt class="py-lineno">1341</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">part_addr</tt><tt class="py-op">:</tt> </tt> -<a name="L1342"></a><tt class="py-lineno">1342</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">part_addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt> </tt> -<a name="L1343"></a><tt class="py-lineno">1343</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1344"></a><tt class="py-lineno">1344</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">part_addr</tt><tt class="py-op">]</tt> </tt> -<a name="L1345"></a><tt class="py-lineno">1345</tt> <tt class="py-line"> </tt> -<a name="L1346"></a><tt class="py-lineno">1346</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">1</tt> <tt class="py-op"><=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-number">4</tt><tt class="py-op">:</tt> </tt> -<a name="L1347"></a><tt class="py-lineno">1347</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">4</tt> <tt class="py-op">-</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1348"></a><tt class="py-lineno">1348</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">)</tt> </tt> -<a name="L1349"></a><tt class="py-lineno">1349</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1350"></a><tt class="py-lineno">1350</tt> <tt class="py-line"> <tt class="py-comment"># Not a recognisable format.</tt> </tt> -<a name="L1351"></a><tt class="py-lineno">1351</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> -<a name="L1352"></a><tt class="py-lineno">1352</tt> <tt class="py-line"> </tt> -<a name="L1353"></a><tt class="py-lineno">1353</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L1354"></a><tt class="py-lineno">1354</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1355"></a><tt class="py-lineno">1355</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">classful_prefix</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -<a name="L1356"></a><tt class="py-lineno">1356</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L1357"></a><tt class="py-lineno">1357</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> -<a name="L1358"></a><tt class="py-lineno">1358</tt> <tt class="py-line"> </tt> -<a name="L1359"></a><tt class="py-lineno">1359</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt> </tt> -<a name="L1360"></a><tt class="py-lineno">1360</tt> <tt class="py-line"> </tt> -<a name="L1361"></a><tt class="py-lineno">1361</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1362"></a><tt class="py-lineno">1362</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1363"></a><tt class="py-lineno">1363</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">IndexError</tt><tt class="py-op">:</tt> </tt> -<a name="L1364"></a><tt class="py-lineno">1364</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1365"></a><tt class="py-lineno">1365</tt> <tt class="py-line"> </tt> -<a name="L1366"></a><tt class="py-lineno">1366</tt> <tt class="py-line"> <tt class="py-comment"># Not a recognisable format.</tt> </tt> -<a name="L1367"></a><tt class="py-lineno">1367</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> -</div><a name="L1368"></a><tt class="py-lineno">1368</tt> <tt class="py-line"> </tt> -<a name="L1369"></a><tt class="py-lineno">1369</tt> <tt class="py-line"> <tt id="link-524" class="py-name" targets="Static Method netaddr.address.CIDR.abbrev_to_verbose()=netaddr.address.CIDR-class.html#abbrev_to_verbose"><a title="netaddr.address.CIDR.abbrev_to_verbose" class="py-name" href="#" onclick="return doclink('link-524', 'abbrev_to_verbose', 'link-524');">abbrev_to_verbose</a></tt> <tt class="py-op">=</tt> <tt class="py-name">staticmethod</tt><tt class="py-op">(</tt><tt id="link-525" class="py-name"><a title="netaddr.address.CIDR.abbrev_to_verbose" class="py-name" href="#" onclick="return doclink('link-525', 'abbrev_to_verbose', 'link-524');">abbrev_to_verbose</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1370"></a><tt class="py-lineno">1370</tt> <tt class="py-line"> </tt> -<a name="CIDR.__init__"></a><div id="CIDR.__init__-def"><a name="L1371"></a><tt class="py-lineno">1371</tt> <a class="py-toggle" href="#" id="CIDR.__init__-toggle" onclick="return toggle('CIDR.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">cidr</tt><tt class="py-op">,</tt> <tt class="py-param">klass</tt><tt class="py-op">=</tt><tt id="link-526" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-526', 'IP', 'link-71');">IP</a></tt><tt class="py-op">,</tt> <tt class="py-param">strict_bitmask</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__init__-expanded"><a name="L1372"></a><tt class="py-lineno">1372</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1373"></a><tt class="py-lineno">1373</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L1374"></a><tt class="py-lineno">1374</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1375"></a><tt class="py-lineno">1375</tt> <tt class="py-line"><tt class="py-docstring"> @param cidr: a valid IPv4/IPv6 CIDR address or abbreviated IPv4</tt> </tt> -<a name="L1376"></a><tt class="py-lineno">1376</tt> <tt class="py-line"><tt class="py-docstring"> network address.</tt> </tt> -<a name="L1377"></a><tt class="py-lineno">1377</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1378"></a><tt class="py-lineno">1378</tt> <tt class="py-line"><tt class="py-docstring"> @param klass: (optional) type, BIF or class used to create each</tt> </tt> -<a name="L1379"></a><tt class="py-lineno">1379</tt> <tt class="py-line"><tt class="py-docstring"> object returned. Default: L{IP} class. See L{nrange()}</tt> </tt> -<a name="L1380"></a><tt class="py-lineno">1380</tt> <tt class="py-line"><tt class="py-docstring"> documentations for additional details on options.</tt> </tt> -<a name="L1381"></a><tt class="py-lineno">1381</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1382"></a><tt class="py-lineno">1382</tt> <tt class="py-line"><tt class="py-docstring"> @param strict_bitmask: (optional) performs a test to ensure</tt> </tt> -<a name="L1383"></a><tt class="py-lineno">1383</tt> <tt class="py-line"><tt class="py-docstring"> there are no non-zero bits to the right of the subnet mask or</tt> </tt> -<a name="L1384"></a><tt class="py-lineno">1384</tt> <tt class="py-line"><tt class="py-docstring"> prefix when it is applied to the base address. (default: True)</tt> </tt> -<a name="L1385"></a><tt class="py-lineno">1385</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1386"></a><tt class="py-lineno">1386</tt> <tt class="py-line"> <tt class="py-name">cidr_arg</tt> <tt class="py-op">=</tt> <tt id="link-527" class="py-name" targets="Method netaddr.address.IP.cidr()=netaddr.address.IP-class.html#cidr,Method netaddr.address.Wildcard.cidr()=netaddr.address.Wildcard-class.html#cidr"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-527', 'cidr', 'link-527');">cidr</a></tt> <tt class="py-comment"># Keep a copy of original argument.</tt> </tt> -<a name="L1387"></a><tt class="py-lineno">1387</tt> <tt class="py-line"> </tt> -<a name="L1388"></a><tt class="py-lineno">1388</tt> <tt class="py-line"> <tt class="py-comment"># Replace an abbreviation with a verbose CIDR.</tt> </tt> -<a name="L1389"></a><tt class="py-lineno">1389</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">verbose_cidr</tt> <tt class="py-op">=</tt> <tt id="link-528" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-528', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">.</tt><tt id="link-529" class="py-name"><a title="netaddr.address.CIDR.abbrev_to_verbose" class="py-name" href="#" onclick="return doclink('link-529', 'abbrev_to_verbose', 'link-524');">abbrev_to_verbose</a></tt><tt class="py-op">(</tt><tt id="link-530" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-530', 'cidr', 'link-527');">cidr</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1390"></a><tt class="py-lineno">1390</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">verbose_cidr</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L1391"></a><tt class="py-lineno">1391</tt> <tt class="py-line"> <tt id="link-531" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-531', 'cidr', 'link-527');">cidr</a></tt> <tt class="py-op">=</tt> <tt class="py-name">verbose_cidr</tt> </tt> -<a name="L1392"></a><tt class="py-lineno">1392</tt> <tt class="py-line"> </tt> -<a name="L1393"></a><tt class="py-lineno">1393</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-532" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-532', 'cidr', 'link-527');">cidr</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1394"></a><tt class="py-lineno">1394</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid CIDR!'</tt> <tt class="py-op">%</tt> <tt id="link-533" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-533', 'cidr', 'link-527');">cidr</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1395"></a><tt class="py-lineno">1395</tt> <tt class="py-line"> </tt> -<a name="L1396"></a><tt class="py-lineno">1396</tt> <tt class="py-line"> <tt class="py-comment"># Check for prefix in address and extract it.</tt> </tt> -<a name="L1397"></a><tt class="py-lineno">1397</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1398"></a><tt class="py-lineno">1398</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">network</tt><tt class="py-op">,</tt> <tt class="py-name">mask</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt id="link-534" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-534', 'cidr', 'link-527');">cidr</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L1399"></a><tt class="py-lineno">1399</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L1400"></a><tt class="py-lineno">1400</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-535" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-535', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a recognised CIDR!'</tt> <tt class="py-op">%</tt> <tt class="py-name">cidr_arg</tt><tt class="py-op">)</tt> </tt> -<a name="L1401"></a><tt class="py-lineno">1401</tt> <tt class="py-line"> </tt> -<a name="L1402"></a><tt class="py-lineno">1402</tt> <tt class="py-line"> <tt id="link-536" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-536', 'first', 'link-89');">first</a></tt> <tt class="py-op">=</tt> <tt id="link-537" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-537', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">network</tt><tt class="py-op">)</tt> </tt> -<a name="L1403"></a><tt class="py-lineno">1403</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-538" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-772', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1633"></a><tt class="py-lineno">1633</tt> <tt class="py-line"> <tt id="link-773" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-773', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-774" class="py-name"><a title="netaddr.address.PrefixLenDescriptor" class="py-name" href="#" onclick="return doclink('link-774', 'PrefixLenDescriptor', 'link-318');">PrefixLenDescriptor</a></tt><tt class="py-op">(</tt><tt class="py-string">'CIDR'</tt><tt class="py-op">)</tt> </tt> +<a name="L1634"></a><tt class="py-lineno">1634</tt> <tt class="py-line"> <tt id="link-775" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-775', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">=</tt> <tt id="link-776" class="py-name"><a title="netaddr.address.FormatDescriptor" class="py-name" href="#" onclick="return doclink('link-776', 'FormatDescriptor', 'link-514');">FormatDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-777" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-777', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1635"></a><tt class="py-lineno">1635</tt> <tt class="py-line"> </tt> +<a name="CIDR.abbrev_to_verbose"></a><div id="CIDR.abbrev_to_verbose-def"><a name="L1636"></a><tt class="py-lineno">1636</tt> <a class="py-toggle" href="#" id="CIDR.abbrev_to_verbose-toggle" onclick="return toggle('CIDR.abbrev_to_verbose');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#abbrev_to_verbose">abbrev_to_verbose</a><tt class="py-op">(</tt><tt class="py-param">abbrev_cidr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.abbrev_to_verbose-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.abbrev_to_verbose-expanded"><a name="L1637"></a><tt class="py-lineno">1637</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1638"></a><tt class="py-lineno">1638</tt> <tt class="py-line"><tt class="py-docstring"> A static method that converts abbreviated IPv4 CIDRs to their more</tt> </tt> +<a name="L1639"></a><tt class="py-lineno">1639</tt> <tt class="py-line"><tt class="py-docstring"> verbose equivalent.</tt> </tt> +<a name="L1640"></a><tt class="py-lineno">1640</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1641"></a><tt class="py-lineno">1641</tt> <tt class="py-line"><tt class="py-docstring"> @param abbrev_cidr: an abbreviated CIDR.</tt> </tt> +<a name="L1642"></a><tt class="py-lineno">1642</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1643"></a><tt class="py-lineno">1643</tt> <tt class="py-line"><tt class="py-docstring"> Uses the old-style classful IP address rules to decide on a default</tt> </tt> +<a name="L1644"></a><tt class="py-lineno">1644</tt> <tt class="py-line"><tt class="py-docstring"> subnet prefix if one is not explicitly provided.</tt> </tt> +<a name="L1645"></a><tt class="py-lineno">1645</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1646"></a><tt class="py-lineno">1646</tt> <tt class="py-line"><tt class="py-docstring"> Only supports IPv4 addresses.</tt> </tt> +<a name="L1647"></a><tt class="py-lineno">1647</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1648"></a><tt class="py-lineno">1648</tt> <tt class="py-line"><tt class="py-docstring"> Examples ::</tt> </tt> +<a name="L1649"></a><tt class="py-lineno">1649</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1650"></a><tt class="py-lineno">1650</tt> <tt class="py-line"><tt class="py-docstring"> 10 - 10.0.0.0/8</tt> </tt> +<a name="L1651"></a><tt class="py-lineno">1651</tt> <tt class="py-line"><tt class="py-docstring"> 10/16 - 10.0.0.0/16</tt> </tt> +<a name="L1652"></a><tt class="py-lineno">1652</tt> <tt class="py-line"><tt class="py-docstring"> 128 - 128.0.0.0/16</tt> </tt> +<a name="L1653"></a><tt class="py-lineno">1653</tt> <tt class="py-line"><tt class="py-docstring"> 128/8 - 128.0.0.0/8</tt> </tt> +<a name="L1654"></a><tt class="py-lineno">1654</tt> <tt class="py-line"><tt class="py-docstring"> 192.168 - 192.168.0.0/16</tt> </tt> +<a name="L1655"></a><tt class="py-lineno">1655</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1656"></a><tt class="py-lineno">1656</tt> <tt class="py-line"><tt class="py-docstring"> @return: A verbose CIDR from an abbreviated CIDR or old-style classful</tt> </tt> +<a name="L1657"></a><tt class="py-lineno">1657</tt> <tt class="py-line"><tt class="py-docstring"> network address, C{None} if format provided was not recognised or</tt> </tt> +<a name="L1658"></a><tt class="py-lineno">1658</tt> <tt class="py-line"><tt class="py-docstring"> supported.</tt> </tt> +<a name="L1659"></a><tt class="py-lineno">1659</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1660"></a><tt class="py-lineno">1660</tt> <tt class="py-line"> <tt class="py-comment"># Internal function that returns a prefix value based on the old IPv4</tt> </tt> +<a name="L1661"></a><tt class="py-lineno">1661</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># classful network scheme that has been superseded (almost) by CIDR.</tt> </tt> +<a name="L1662"></a><tt class="py-lineno">1662</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">def</tt> <tt class="py-def-name">classful_prefix</tt><tt class="py-op">(</tt><tt class="py-param">octet</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1663"></a><tt class="py-lineno">1663</tt> <tt class="py-line"> <tt class="py-name">octet</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">octet</tt><tt class="py-op">)</tt> </tt> +<a name="L1664"></a><tt class="py-lineno">1664</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">255</tt><tt class="py-op">:</tt> </tt> +<a name="L1665"></a><tt class="py-lineno">1665</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'Invalid octet: %r!'</tt> <tt class="py-op">%</tt> <tt class="py-name">octet</tt><tt class="py-op">)</tt> </tt> +<a name="L1666"></a><tt class="py-lineno">1666</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">127</tt><tt class="py-op">:</tt> <tt class="py-comment"># Legacy class 'A' classification.</tt> </tt> +<a name="L1667"></a><tt class="py-lineno">1667</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">8</tt> </tt> +<a name="L1668"></a><tt class="py-lineno">1668</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">128</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">191</tt><tt class="py-op">:</tt> <tt class="py-comment"># Legacy class 'B' classification.</tt> </tt> +<a name="L1669"></a><tt class="py-lineno">1669</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">16</tt> </tt> +<a name="L1670"></a><tt class="py-lineno">1670</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">192</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">223</tt><tt class="py-op">:</tt> <tt class="py-comment"># Legacy class 'C' classification.</tt> </tt> +<a name="L1671"></a><tt class="py-lineno">1671</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">24</tt> </tt> +<a name="L1672"></a><tt class="py-lineno">1672</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">octet</tt> <tt class="py-op">==</tt> <tt class="py-number">224</tt><tt class="py-op">:</tt> <tt class="py-comment"># Multicast address range.</tt> </tt> +<a name="L1673"></a><tt class="py-lineno">1673</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">4</tt> </tt> +<a name="L1674"></a><tt class="py-lineno">1674</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-number">225</tt> <tt class="py-op"><=</tt> <tt class="py-name">octet</tt> <tt class="py-op"><=</tt> <tt class="py-number">239</tt><tt class="py-op">:</tt> <tt class="py-comment"># Reserved.</tt> </tt> +<a name="L1675"></a><tt class="py-lineno">1675</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">8</tt> </tt> +<a name="L1676"></a><tt class="py-lineno">1676</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">32</tt> <tt class="py-comment"># Default.</tt> </tt> +</div><a name="L1677"></a><tt class="py-lineno">1677</tt> <tt class="py-line"> </tt> +<a name="L1678"></a><tt class="py-lineno">1678</tt> <tt class="py-line"> <tt class="py-name">start</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt> </tt> +<a name="L1679"></a><tt class="py-lineno">1679</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L1680"></a><tt class="py-lineno">1680</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L1681"></a><tt class="py-lineno">1681</tt> <tt class="py-line"> </tt> +<a name="L1682"></a><tt class="py-lineno">1682</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">abbrev_cidr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1683"></a><tt class="py-lineno">1683</tt> <tt class="py-line"> <tt class="py-comment"># Don't support IPv6 for now...</tt> </tt> +<a name="L1684"></a><tt class="py-lineno">1684</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">':'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">abbrev_cidr</tt><tt class="py-op">:</tt> </tt> +<a name="L1685"></a><tt class="py-lineno">1685</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> +<a name="L1686"></a><tt class="py-lineno">1686</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1687"></a><tt class="py-lineno">1687</tt> <tt class="py-line"> <tt class="py-comment"># Single octet partial integer or string address.</tt> </tt> +<a name="L1688"></a><tt class="py-lineno">1688</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">i</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">abbrev_cidr</tt><tt class="py-op">)</tt> </tt> +<a name="L1689"></a><tt class="py-lineno">1689</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> +<a name="L1690"></a><tt class="py-lineno">1690</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">classful_prefix</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1691"></a><tt class="py-lineno">1691</tt> <tt class="py-line"> </tt> +<a name="L1692"></a><tt class="py-lineno">1692</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L1693"></a><tt class="py-lineno">1693</tt> <tt class="py-line"> <tt class="py-comment"># Multi octet partial string address with optional prefix.</tt> </tt> +<a name="L1694"></a><tt class="py-lineno">1694</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">part_addr</tt> <tt class="py-op">=</tt> <tt class="py-name">abbrev_cidr</tt> </tt> +<a name="L1695"></a><tt class="py-lineno">1695</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L1696"></a><tt class="py-lineno">1696</tt> <tt class="py-line"> </tt> +<a name="L1697"></a><tt class="py-lineno">1697</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">part_addr</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L1698"></a><tt class="py-lineno">1698</tt> <tt class="py-line"> <tt class="py-comment"># Not a recognisable format.</tt> </tt> +<a name="L1699"></a><tt class="py-lineno">1699</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> +<a name="L1700"></a><tt class="py-lineno">1700</tt> <tt class="py-line"> </tt> +<a name="L1701"></a><tt class="py-lineno">1701</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'/'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">part_addr</tt><tt class="py-op">:</tt> </tt> +<a name="L1702"></a><tt class="py-lineno">1702</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">part_addr</tt><tt class="py-op">,</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">part_addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L1703"></a><tt class="py-lineno">1703</tt> <tt class="py-line"> </tt> +<a name="L1704"></a><tt class="py-lineno">1704</tt> <tt class="py-line"> <tt class="py-comment"># Check prefix for validity.</tt> </tt> +<a name="L1705"></a><tt class="py-lineno">1705</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L1706"></a><tt class="py-lineno">1706</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1707"></a><tt class="py-lineno">1707</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-number">32</tt><tt class="py-op">:</tt> </tt> +<a name="L1708"></a><tt class="py-lineno">1708</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> +<a name="L1709"></a><tt class="py-lineno">1709</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L1710"></a><tt class="py-lineno">1710</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> +<a name="L1711"></a><tt class="py-lineno">1711</tt> <tt class="py-line"> </tt> +<a name="L1712"></a><tt class="py-lineno">1712</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">part_addr</tt><tt class="py-op">:</tt> </tt> +<a name="L1713"></a><tt class="py-lineno">1713</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">part_addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt> </tt> +<a name="L1714"></a><tt class="py-lineno">1714</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1715"></a><tt class="py-lineno">1715</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">part_addr</tt><tt class="py-op">]</tt> </tt> +<a name="L1716"></a><tt class="py-lineno">1716</tt> <tt class="py-line"> </tt> +<a name="L1717"></a><tt class="py-lineno">1717</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">1</tt> <tt class="py-op"><=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-number">4</tt><tt class="py-op">:</tt> </tt> +<a name="L1718"></a><tt class="py-lineno">1718</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">4</tt> <tt class="py-op">-</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1719"></a><tt class="py-lineno">1719</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">)</tt> </tt> +<a name="L1720"></a><tt class="py-lineno">1720</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1721"></a><tt class="py-lineno">1721</tt> <tt class="py-line"> <tt class="py-comment"># Not a recognisable format.</tt> </tt> +<a name="L1722"></a><tt class="py-lineno">1722</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> +<a name="L1723"></a><tt class="py-lineno">1723</tt> <tt class="py-line"> </tt> +<a name="L1724"></a><tt class="py-lineno">1724</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L1725"></a><tt class="py-lineno">1725</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1726"></a><tt class="py-lineno">1726</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">classful_prefix</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L1727"></a><tt class="py-lineno">1727</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L1728"></a><tt class="py-lineno">1728</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> +<a name="L1729"></a><tt class="py-lineno">1729</tt> <tt class="py-line"> </tt> +<a name="L1730"></a><tt class="py-lineno">1730</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt> </tt> +<a name="L1731"></a><tt class="py-lineno">1731</tt> <tt class="py-line"> </tt> +<a name="L1732"></a><tt class="py-lineno">1732</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L1733"></a><tt class="py-lineno">1733</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L1734"></a><tt class="py-lineno">1734</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">IndexError</tt><tt class="py-op">:</tt> </tt> +<a name="L1735"></a><tt class="py-lineno">1735</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L1736"></a><tt class="py-lineno">1736</tt> <tt class="py-line"> </tt> +<a name="L1737"></a><tt class="py-lineno">1737</tt> <tt class="py-line"> <tt class="py-comment"># Not a recognisable format.</tt> </tt> +<a name="L1738"></a><tt class="py-lineno">1738</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">None</tt> </tt> +</div><a name="L1739"></a><tt class="py-lineno">1739</tt> <tt class="py-line"> </tt> +<a name="CIDR.span"></a><div id="CIDR.span-def"><a name="L1740"></a><tt class="py-lineno">1740</tt> <a class="py-toggle" href="#" id="CIDR.span-toggle" onclick="return toggle('CIDR.span');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#span">span</a><tt class="py-op">(</tt><tt class="py-param">addrs</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.span-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.span-expanded"><a name="L1741"></a><tt class="py-lineno">1741</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1742"></a><tt class="py-lineno">1742</tt> <tt class="py-line"><tt class="py-docstring"> Static method that accepts a sequence of IP addresses and/or CIDRs,</tt> </tt> +<a name="L1743"></a><tt class="py-lineno">1743</tt> <tt class="py-line"><tt class="py-docstring"> Wildcards and IPRanges returning a single CIDR that is large enough</tt> </tt> +<a name="L1744"></a><tt class="py-lineno">1744</tt> <tt class="py-line"><tt class="py-docstring"> to span the lowest and highest IP addresses in the sequence (with</tt> </tt> +<a name="L1745"></a><tt class="py-lineno">1745</tt> <tt class="py-line"><tt class="py-docstring"> a possible overlap on either end).</tt> </tt> +<a name="L1746"></a><tt class="py-lineno">1746</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1747"></a><tt class="py-lineno">1747</tt> <tt class="py-line"><tt class="py-docstring"> @param addrs: a sequence of IP, CIDR, Wildcard or IPRange objects</tt> </tt> +<a name="L1748"></a><tt class="py-lineno">1748</tt> <tt class="py-line"><tt class="py-docstring"> and/or their string representations.</tt> </tt> +<a name="L1749"></a><tt class="py-lineno">1749</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1750"></a><tt class="py-lineno">1750</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: (optional) callable used on return values.</tt> </tt> +<a name="L1751"></a><tt class="py-lineno">1751</tt> <tt class="py-line"><tt class="py-docstring"> (Default: None - L{CIDR} object) Also accepts str() and unicode().</tt> </tt> +<a name="L1752"></a><tt class="py-lineno">1752</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1753"></a><tt class="py-lineno">1753</tt> <tt class="py-line"><tt class="py-docstring"> @return: a single CIDR object spanning all addresses.</tt> </tt> +<a name="L1754"></a><tt class="py-lineno">1754</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1755"></a><tt class="py-lineno">1755</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addrs</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> <tt class="py-comment"># Required - DO NOT CHANGE!</tt> </tt> +<a name="L1756"></a><tt class="py-lineno">1756</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'expected address sequence is not iterable!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1757"></a><tt class="py-lineno">1757</tt> <tt class="py-line"> </tt> +<a name="L1758"></a><tt class="py-lineno">1758</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">addrs</tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt> +<a name="L1759"></a><tt class="py-lineno">1759</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'sequence must contain 2 or more elements!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1760"></a><tt class="py-lineno">1760</tt> <tt class="py-line"> </tt> +<a name="L1761"></a><tt class="py-lineno">1761</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-778" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-778', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1762"></a><tt class="py-lineno">1762</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported formatter %r!'</tt> <tt class="py-op">%</tt> <tt id="link-779" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-779', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1763"></a><tt class="py-lineno">1763</tt> <tt class="py-line"> </tt> +<a name="L1764"></a><tt class="py-lineno">1764</tt> <tt class="py-line"> <tt class="py-comment"># List is required.</tt> </tt> +<a name="L1765"></a><tt class="py-lineno">1765</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addrs</tt><tt class="py-op">,</tt> <tt class="py-name">list</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1766"></a><tt class="py-lineno">1766</tt> <tt class="py-line"> <tt class="py-name">addrs</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">addrs</tt><tt class="py-op">)</tt> </tt> +<a name="L1767"></a><tt class="py-lineno">1767</tt> <tt class="py-line"> </tt> +<a name="L1768"></a><tt class="py-lineno">1768</tt> <tt class="py-line"> <tt class="py-comment"># Detect type of string address or address range and create the</tt> </tt> +<a name="L1769"></a><tt class="py-lineno">1769</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># equivalent instance.</tt> </tt> +<a name="L1770"></a><tt class="py-lineno">1770</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enumerate</tt><tt class="py-op">(</tt><tt class="py-name">addrs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1771"></a><tt class="py-lineno">1771</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1772"></a><tt class="py-lineno">1772</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1773"></a><tt class="py-lineno">1773</tt> <tt class="py-line"> <tt class="py-name">obj</tt> <tt class="py-op">=</tt> <tt id="link-780" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-780', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L1774"></a><tt class="py-lineno">1774</tt> <tt class="py-line"> <tt class="py-name">addrs</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">obj</tt> </tt> +<a name="L1775"></a><tt class="py-lineno">1775</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt> +<a name="L1776"></a><tt class="py-lineno">1776</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L1777"></a><tt class="py-lineno">1777</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L1778"></a><tt class="py-lineno">1778</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1779"></a><tt class="py-lineno">1779</tt> <tt class="py-line"> <tt class="py-name">obj</tt> <tt class="py-op">=</tt> <tt id="link-781" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-781', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L1780"></a><tt class="py-lineno">1780</tt> <tt class="py-line"> <tt class="py-name">addrs</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">obj</tt> </tt> +<a name="L1781"></a><tt class="py-lineno">1781</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt> +<a name="L1782"></a><tt class="py-lineno">1782</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L1783"></a><tt class="py-lineno">1783</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L1784"></a><tt class="py-lineno">1784</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1785"></a><tt class="py-lineno">1785</tt> <tt class="py-line"> <tt class="py-name">obj</tt> <tt class="py-op">=</tt> <tt id="link-782" class="py-name"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-782', 'Wildcard', 'link-457');">Wildcard</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L1786"></a><tt class="py-lineno">1786</tt> <tt class="py-line"> <tt class="py-name">addrs</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">obj</tt> </tt> +<a name="L1787"></a><tt class="py-lineno">1787</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt> +<a name="L1788"></a><tt class="py-lineno">1788</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L1789"></a><tt class="py-lineno">1789</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L1790"></a><tt class="py-lineno">1790</tt> <tt class="py-line"> </tt> +<a name="L1791"></a><tt class="py-lineno">1791</tt> <tt class="py-line"> <tt class="py-comment"># Find lowest and highest IP objects in address list.</tt> </tt> +<a name="L1792"></a><tt class="py-lineno">1792</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">addrs</tt><tt class="py-op">.</tt><tt class="py-name">sort</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L1793"></a><tt class="py-lineno">1793</tt> <tt class="py-line"> <tt class="py-name">lowest</tt> <tt class="py-op">=</tt> <tt class="py-name">addrs</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L1794"></a><tt class="py-lineno">1794</tt> <tt class="py-line"> <tt class="py-name">highest</tt> <tt class="py-op">=</tt> <tt class="py-name">addrs</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +<a name="L1795"></a><tt class="py-lineno">1795</tt> <tt class="py-line"> </tt> +<a name="L1796"></a><tt class="py-lineno">1796</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">lowest</tt><tt class="py-op">,</tt> <tt id="link-783" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-783', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1797"></a><tt class="py-lineno">1797</tt> <tt class="py-line"> <tt class="py-comment"># Create new IP as user may be returning address strings.</tt> </tt> +<a name="L1798"></a><tt class="py-lineno">1798</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">lowest</tt> <tt class="py-op">=</tt> <tt id="link-784" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-784', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">lowest</tt><tt class="py-op">.</tt><tt id="link-785" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-785', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">lowest</tt><tt class="py-op">.</tt><tt id="link-786" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-786', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1799"></a><tt class="py-lineno">1799</tt> <tt class="py-line"> </tt> +<a name="L1800"></a><tt class="py-lineno">1800</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">highest</tt><tt class="py-op">,</tt> <tt id="link-787" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-787', 'IPRange', 'link-375');">IPRange</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1801"></a><tt class="py-lineno">1801</tt> <tt class="py-line"> <tt class="py-comment"># Create new IP as user may be returning address strings.</tt> </tt> +<a name="L1802"></a><tt class="py-lineno">1802</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">highest</tt> <tt class="py-op">=</tt> <tt id="link-788" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-788', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">highest</tt><tt class="py-op">.</tt><tt id="link-789" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-789', 'last', 'link-372');">last</a></tt><tt class="py-op">,</tt> <tt class="py-name">highest</tt><tt class="py-op">.</tt><tt id="link-790" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-790', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1803"></a><tt class="py-lineno">1803</tt> <tt class="py-line"> </tt> +<a name="L1804"></a><tt class="py-lineno">1804</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">lowest</tt><tt class="py-op">.</tt><tt id="link-791" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-791', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt class="py-name">highest</tt><tt class="py-op">.</tt><tt id="link-792" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-792', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1805"></a><tt class="py-lineno">1805</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'address types are not the same!'</tt><tt class="py-op">)</tt> </tt> +<a name="L1806"></a><tt class="py-lineno">1806</tt> <tt class="py-line"> </tt> +<a name="L1807"></a><tt class="py-lineno">1807</tt> <tt class="py-line"> <tt id="link-793" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-793', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-op">=</tt> <tt class="py-name">highest</tt><tt class="py-op">.</tt><tt id="link-794" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-794', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L1808"></a><tt class="py-lineno">1808</tt> <tt class="py-line"> </tt> +<a name="L1809"></a><tt class="py-lineno">1809</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt id="link-795" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-795', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-796" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-796', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">></tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L1810"></a><tt class="py-lineno">1810</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">highest</tt> <tt class="py-keyword">in</tt> <tt id="link-797" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-797', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">and</tt> <tt class="py-name">lowest</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt id="link-798" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-798', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">:</tt> </tt> +<a name="L1811"></a><tt class="py-lineno">1811</tt> <tt class="py-line"> <tt id="link-799" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-799', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-800" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-800', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">-=</tt> <tt class="py-number">1</tt> </tt> +<a name="L1812"></a><tt class="py-lineno">1812</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1813"></a><tt class="py-lineno">1813</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> +<a name="L1814"></a><tt class="py-lineno">1814</tt> <tt class="py-line"> </tt> +<a name="L1815"></a><tt class="py-lineno">1815</tt> <tt class="py-line"> <tt class="py-comment"># Return address in string format.</tt> </tt> +<a name="L1816"></a><tt class="py-lineno">1816</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt id="link-801" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-801', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L1817"></a><tt class="py-lineno">1817</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-802" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-802', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt id="link-803" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-803', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1818"></a><tt class="py-lineno">1818</tt> <tt class="py-line"> </tt> +<a name="L1819"></a><tt class="py-lineno">1819</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-804" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-804', 'cidr', 'link-434');">cidr</a></tt> </tt> +</div><a name="L1820"></a><tt class="py-lineno">1820</tt> <tt class="py-line"> </tt> +<a name="L1821"></a><tt class="py-lineno">1821</tt> <tt class="py-line"> <tt id="link-805" class="py-name" targets="Static Method netaddr.address.CIDR.abbrev_to_verbose()=netaddr.address.CIDR-class.html#abbrev_to_verbose"><a title="netaddr.address.CIDR.abbrev_to_verbose" class="py-name" href="#" onclick="return doclink('link-805', 'abbrev_to_verbose', 'link-805');">abbrev_to_verbose</a></tt> <tt class="py-op">=</tt> <tt class="py-name">staticmethod</tt><tt class="py-op">(</tt><tt id="link-806" class="py-name"><a title="netaddr.address.CIDR.abbrev_to_verbose" class="py-name" href="#" onclick="return doclink('link-806', 'abbrev_to_verbose', 'link-805');">abbrev_to_verbose</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1822"></a><tt class="py-lineno">1822</tt> <tt class="py-line"> <tt id="link-807" class="py-name"><a title="netaddr.address.CIDR.span" class="py-name" href="#" onclick="return doclink('link-807', 'span', 'link-648');">span</a></tt> <tt class="py-op">=</tt> <tt class="py-name">staticmethod</tt><tt class="py-op">(</tt><tt id="link-808" class="py-name"><a title="netaddr.address.CIDR.span" class="py-name" href="#" onclick="return doclink('link-808', 'span', 'link-648');">span</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1823"></a><tt class="py-lineno">1823</tt> <tt class="py-line"> </tt> +<a name="CIDR.__init__"></a><div id="CIDR.__init__-def"><a name="L1824"></a><tt class="py-lineno">1824</tt> <a class="py-toggle" href="#" id="CIDR.__init__-toggle" onclick="return toggle('CIDR.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">cidr</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt id="link-809" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-809', 'IP', 'link-76');">IP</a></tt><tt class="py-op">,</tt> <tt class="py-param">strict</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__init__-expanded"><a name="L1825"></a><tt class="py-lineno">1825</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1826"></a><tt class="py-lineno">1826</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L1827"></a><tt class="py-lineno">1827</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1828"></a><tt class="py-lineno">1828</tt> <tt class="py-line"><tt class="py-docstring"> @param cidr: a valid IPv4/IPv6 CIDR address or abbreviated IPv4</tt> </tt> +<a name="L1829"></a><tt class="py-lineno">1829</tt> <tt class="py-line"><tt class="py-docstring"> network address.</tt> </tt> +<a name="L1830"></a><tt class="py-lineno">1830</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1831"></a><tt class="py-lineno">1831</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: (optional) callable used on return values.</tt> </tt> +<a name="L1832"></a><tt class="py-lineno">1832</tt> <tt class="py-line"><tt class="py-docstring"> Default: L{IP} class. See L{nrange()} documentations for</tt> </tt> +<a name="L1833"></a><tt class="py-lineno">1833</tt> <tt class="py-line"><tt class="py-docstring"> more details on the various options.</tt> </tt> +<a name="L1834"></a><tt class="py-lineno">1834</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1835"></a><tt class="py-lineno">1835</tt> <tt class="py-line"><tt class="py-docstring"> @param strict: (optional) performs a test to ensure there are no</tt> </tt> +<a name="L1836"></a><tt class="py-lineno">1836</tt> <tt class="py-line"><tt class="py-docstring"> non-zero bits to the right of the subnet mask or prefix when it is</tt> </tt> +<a name="L1837"></a><tt class="py-lineno">1837</tt> <tt class="py-line"><tt class="py-docstring"> applied to the base address. (default: True)</tt> </tt> +<a name="L1838"></a><tt class="py-lineno">1838</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1839"></a><tt class="py-lineno">1839</tt> <tt class="py-line"> <tt class="py-name">cidr_arg</tt> <tt class="py-op">=</tt> <tt id="link-810" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-810', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-comment"># Keep a copy of original argument.</tt> </tt> +<a name="L1840"></a><tt class="py-lineno">1840</tt> <tt class="py-line"> </tt> +<a name="L1841"></a><tt class="py-lineno">1841</tt> <tt class="py-line"> <tt class="py-comment"># Replace an abbreviation with a verbose CIDR.</tt> </tt> +<a name="L1842"></a><tt class="py-lineno">1842</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">verbose_cidr</tt> <tt class="py-op">=</tt> <tt id="link-811" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-811', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">.</tt><tt id="link-812" class="py-name"><a title="netaddr.address.CIDR.abbrev_to_verbose" class="py-name" href="#" onclick="return doclink('link-812', 'abbrev_to_verbose', 'link-805');">abbrev_to_verbose</a></tt><tt class="py-op">(</tt><tt id="link-813" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-813', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1843"></a><tt class="py-lineno">1843</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">verbose_cidr</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L1844"></a><tt class="py-lineno">1844</tt> <tt class="py-line"> <tt id="link-814" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-814', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-op">=</tt> <tt class="py-name">verbose_cidr</tt> </tt> +<a name="L1845"></a><tt class="py-lineno">1845</tt> <tt class="py-line"> </tt> +<a name="L1846"></a><tt class="py-lineno">1846</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-815" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-815', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L1847"></a><tt class="py-lineno">1847</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid CIDR!'</tt> <tt class="py-op">%</tt> <tt id="link-816" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-816', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1848"></a><tt class="py-lineno">1848</tt> <tt class="py-line"> </tt> +<a name="L1849"></a><tt class="py-lineno">1849</tt> <tt class="py-line"> <tt class="py-comment"># Check for prefix in address and extract it.</tt> </tt> +<a name="L1850"></a><tt class="py-lineno">1850</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L1851"></a><tt class="py-lineno">1851</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt id="link-817" class="py-name"><a title="netaddr.address.CIDR.network" class="py-name" href="#" onclick="return doclink('link-817', 'network', 'link-351');">network</a></tt><tt class="py-op">,</tt> <tt class="py-name">mask</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt id="link-818" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-818', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">,</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L1852"></a><tt class="py-lineno">1852</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L1853"></a><tt class="py-lineno">1853</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-819" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-819', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'CIDR objects %r require a subnet prefix!'</tt> \ </tt> +<a name="L1854"></a><tt class="py-lineno">1854</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">cidr_arg</tt><tt class="py-op">)</tt> </tt> +<a name="L1855"></a><tt class="py-lineno">1855</tt> <tt class="py-line"> </tt> +<a name="L1856"></a><tt class="py-lineno">1856</tt> <tt class="py-line"> <tt class="py-comment">#FIXME: Are IP objects for first and last really necessary?</tt> </tt> +<a name="L1857"></a><tt class="py-lineno">1857</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#FIXME: Should surely just be integer values.</tt> </tt> +<a name="L1858"></a><tt class="py-lineno">1858</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-820" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-820', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt id="link-821" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-821', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt id="link-822" class="py-name"><a title="netaddr.address.CIDR.network" class="py-name" href="#" onclick="return doclink('link-822', 'network', 'link-351');">network</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1859"></a><tt class="py-lineno">1859</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-823" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-538', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-539" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-539', 'first', 'link-89');">first</a></tt><tt class="py-op">.</tt><tt id="link-540" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-823', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-824" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-824', 'first', 'link-110');">first</a></tt><tt class="py-op">.</tt><tt id="link-825" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-540', 'strategy', 'link-10');">strategy</a></tt> </tt> -<a name="L1404"></a><tt class="py-lineno">1404</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-541" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-541', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">mask</tt> </tt> -<a name="L1405"></a><tt class="py-lineno">1405</tt> <tt class="py-line"> </tt> -<a name="L1406"></a><tt class="py-lineno">1406</tt> <tt class="py-line"> <tt id="link-542" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-825', 'strategy', 'link-10');">strategy</a></tt> </tt> +<a name="L1860"></a><tt class="py-lineno">1860</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-826" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-826', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt class="py-name">mask</tt> </tt> +<a name="L1861"></a><tt class="py-lineno">1861</tt> <tt class="py-line"> </tt> +<a name="L1862"></a><tt class="py-lineno">1862</tt> <tt class="py-line"> <tt id="link-827" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-542', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-543" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-543', 'first', 'link-89');">first</a></tt><tt class="py-op">.</tt><tt id="link-544" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-827', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-828" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-828', 'first', 'link-110');">first</a></tt><tt class="py-op">.</tt><tt id="link-829" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-544', 'strategy', 'link-10');">strategy</a></tt> </tt> -<a name="L1407"></a><tt class="py-lineno">1407</tt> <tt class="py-line"> <tt id="link-545" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-829', 'strategy', 'link-10');">strategy</a></tt> </tt> +<a name="L1863"></a><tt class="py-lineno">1863</tt> <tt class="py-line"> <tt id="link-830" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-545', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-546" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-830', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-831" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-546', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-547" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-831', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-832" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-547', 'addr_type', 'link-39');">addr_type</a></tt> </tt> -<a name="L1408"></a><tt class="py-lineno">1408</tt> <tt class="py-line"> </tt> -<a name="L1409"></a><tt class="py-lineno">1409</tt> <tt class="py-line"> <tt id="link-548" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-548', 'hostmask', 'link-91');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt id="link-549" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-832', 'addr_type', 'link-43');">addr_type</a></tt> </tt> +<a name="L1864"></a><tt class="py-lineno">1864</tt> <tt class="py-line"> </tt> +<a name="L1865"></a><tt class="py-lineno">1865</tt> <tt class="py-line"> <tt id="link-833" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-833', 'hostmask', 'link-112');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt id="link-834" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-549', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-550" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-550', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> -<a name="L1410"></a><tt class="py-lineno">1410</tt> <tt class="py-line"> <tt id="link-551" class="py-name" targets="Method netaddr.address.CIDR.netmask()=netaddr.address.CIDR-class.html#netmask"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-551', 'netmask', 'link-551');">netmask</a></tt> <tt class="py-op">=</tt> <tt id="link-552" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-834', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-835" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-835', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L1866"></a><tt class="py-lineno">1866</tt> <tt class="py-line"> </tt> +<a name="L1867"></a><tt class="py-lineno">1867</tt> <tt class="py-line"> <tt id="link-836" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-836', 'last', 'link-372');">last</a></tt> <tt class="py-op">=</tt> <tt id="link-837" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-837', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt id="link-838" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-838', 'first', 'link-110');">first</a></tt><tt class="py-op">.</tt><tt id="link-839" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-839', 'value', 'link-30');">value</a></tt> <tt class="py-op">|</tt> <tt id="link-840" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-840', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">,</tt> <tt id="link-841" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-841', 'addr_type', 'link-43');">addr_type</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1868"></a><tt class="py-lineno">1868</tt> <tt class="py-line"> </tt> +<a name="L1869"></a><tt class="py-lineno">1869</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">strict</tt><tt class="py-op">:</tt> </tt> +<a name="L1870"></a><tt class="py-lineno">1870</tt> <tt class="py-line"> <tt class="py-comment"># Strict CIDRs enabled.</tt> </tt> +<a name="L1871"></a><tt class="py-lineno">1871</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-842" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-842', 'netmask', 'link-88');">netmask</a></tt> <tt class="py-op">=</tt> <tt id="link-843" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-552', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">^</tt> <tt id="link-553" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-553', 'hostmask', 'link-91');">hostmask</a></tt> </tt> -<a name="L1411"></a><tt class="py-lineno">1411</tt> <tt class="py-line"> </tt> -<a name="L1412"></a><tt class="py-lineno">1412</tt> <tt class="py-line"> <tt id="link-554" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-554', 'last', 'link-374');">last</a></tt> <tt class="py-op">=</tt> <tt id="link-555" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-555', 'IP', 'link-71');">IP</a></tt><tt class="py-op">(</tt><tt id="link-556" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-556', 'first', 'link-89');">first</a></tt><tt class="py-op">.</tt><tt id="link-557" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-557', 'value', 'link-26');">value</a></tt> <tt class="py-op">|</tt> <tt id="link-558" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-558', 'hostmask', 'link-91');">hostmask</a></tt><tt class="py-op">,</tt> <tt id="link-559" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-559', 'addr_type', 'link-39');">addr_type</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1413"></a><tt class="py-lineno">1413</tt> <tt class="py-line"> </tt> -<a name="L1414"></a><tt class="py-lineno">1414</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">strict_bitmask</tt><tt class="py-op">:</tt> </tt> -<a name="L1415"></a><tt class="py-lineno">1415</tt> <tt class="py-line"> <tt class="py-comment"># Enable on strict CIDR checking.</tt> </tt> -<a name="L1416"></a><tt class="py-lineno">1416</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">host</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-560" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-560', 'first', 'link-89');">first</a></tt><tt class="py-op">.</tt><tt id="link-561" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-561', 'value', 'link-26');">value</a></tt> <tt class="py-op">|</tt> <tt id="link-562" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-562', 'netmask', 'link-551');">netmask</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-563" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-563', 'netmask', 'link-551');">netmask</a></tt> </tt> -<a name="L1417"></a><tt class="py-lineno">1417</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">host</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> -<a name="L1418"></a><tt class="py-lineno">1418</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%s contains non-zero bits right of the '</tt> \ </tt> -<a name="L1419"></a><tt class="py-lineno">1419</tt> <tt class="py-line"> <tt class="py-string">'%d-bit mask! Did you mean %s instead?'</tt> \ </tt> -<a name="L1420"></a><tt class="py-lineno">1420</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-564" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-564', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-565" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-565', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">,</tt> </tt> -<a name="L1421"></a><tt class="py-lineno">1421</tt> <tt class="py-line"> <tt id="link-566" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-843', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">^</tt> <tt id="link-844" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-844', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +<a name="L1872"></a><tt class="py-lineno">1872</tt> <tt class="py-line"> <tt class="py-name">host</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-845" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-845', 'first', 'link-110');">first</a></tt><tt class="py-op">.</tt><tt id="link-846" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-846', 'value', 'link-30');">value</a></tt> <tt class="py-op">|</tt> <tt id="link-847" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-847', 'netmask', 'link-88');">netmask</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-848" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-848', 'netmask', 'link-88');">netmask</a></tt> </tt> +<a name="L1873"></a><tt class="py-lineno">1873</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">host</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L1874"></a><tt class="py-lineno">1874</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%s contains non-zero bits right of the '</tt> \ </tt> +<a name="L1875"></a><tt class="py-lineno">1875</tt> <tt class="py-line"> <tt class="py-string">'%d-bit mask! Did you mean %s instead?'</tt> \ </tt> +<a name="L1876"></a><tt class="py-lineno">1876</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt id="link-849" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-849', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-850" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-850', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">,</tt> </tt> +<a name="L1877"></a><tt class="py-lineno">1877</tt> <tt class="py-line"> <tt id="link-851" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-566', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-567" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-851', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-852" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-567', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-568" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-568', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-569" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-569', 'hostmask', 'link-91');">hostmask</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1422"></a><tt class="py-lineno">1422</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1423"></a><tt class="py-lineno">1423</tt> <tt class="py-line"> <tt class="py-comment"># Loose CIDR checking.</tt> </tt> -<a name="L1424"></a><tt class="py-lineno">1424</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-570" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-570', 'first', 'link-89');">first</a></tt><tt class="py-op">.</tt><tt id="link-571" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-571', 'value', 'link-26');">value</a></tt> <tt class="py-op">=</tt> <tt id="link-572" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-852', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-853" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-853', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-854" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-854', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1878"></a><tt class="py-lineno">1878</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L1879"></a><tt class="py-lineno">1879</tt> <tt class="py-line"> <tt class="py-comment"># Strict CIDRs disabled.</tt> </tt> +<a name="L1880"></a><tt class="py-lineno">1880</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-855" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-855', 'first', 'link-110');">first</a></tt><tt class="py-op">.</tt><tt id="link-856" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-856', 'value', 'link-30');">value</a></tt> <tt class="py-op">=</tt> <tt id="link-857" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-572', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-573" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-857', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-858" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-573', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-574" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-574', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-575" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-575', 'hostmask', 'link-91');">hostmask</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1425"></a><tt class="py-lineno">1425</tt> <tt class="py-line"> </tt> -<a name="L1426"></a><tt class="py-lineno">1426</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-576" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-576', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-577" class="py-name"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-858', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-859" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-859', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt id="link-860" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-860', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1881"></a><tt class="py-lineno">1881</tt> <tt class="py-line"> </tt> +<a name="L1882"></a><tt class="py-lineno">1882</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-861" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-861', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-862" class="py-name"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-577', '__init__', 'link-216');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-578" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-578', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt id="link-579" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-579', 'last', 'link-374');">last</a></tt><tt class="py-op">,</tt> <tt id="link-580" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-580', 'klass', 'link-338');">klass</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L1427"></a><tt class="py-lineno">1427</tt> <tt class="py-line"> </tt> -<a name="CIDR.__sub__"></a><div id="CIDR.__sub__-def"><a name="L1428"></a><tt class="py-lineno">1428</tt> <a class="py-toggle" href="#" id="CIDR.__sub__-toggle" onclick="return toggle('CIDR.__sub__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__sub__">__sub__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.__sub__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__sub__-expanded"><a name="L1429"></a><tt class="py-lineno">1429</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1430"></a><tt class="py-lineno">1430</tt> <tt class="py-line"><tt class="py-docstring"> Subtract another CIDR from this one.</tt> </tt> -<a name="L1431"></a><tt class="py-lineno">1431</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1432"></a><tt class="py-lineno">1432</tt> <tt class="py-line"><tt class="py-docstring"> @param other: a CIDR object that is greater than or equal to C{self}.</tt> </tt> -<a name="L1433"></a><tt class="py-lineno">1433</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1434"></a><tt class="py-lineno">1434</tt> <tt class="py-line"><tt class="py-docstring"> @return: A list of CIDR objects than remain after subtracting C{other}</tt> </tt> -<a name="L1435"></a><tt class="py-lineno">1435</tt> <tt class="py-line"><tt class="py-docstring"> from C{self}.</tt> </tt> -<a name="L1436"></a><tt class="py-lineno">1436</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1437"></a><tt class="py-lineno">1437</tt> <tt class="py-line"> <tt class="py-name">cidrs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L1438"></a><tt class="py-lineno">1438</tt> <tt class="py-line"> </tt> -<a name="L1439"></a><tt class="py-lineno">1439</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-581" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-581', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-582" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-582', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> -<a name="L1440"></a><tt class="py-lineno">1440</tt> <tt class="py-line"> <tt class="py-comment"># Fail fast. Nothing to do in this case.</tt> </tt> -<a name="L1441"></a><tt class="py-lineno">1441</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">cidrs</tt> </tt> -<a name="L1442"></a><tt class="py-lineno">1442</tt> <tt class="py-line"> </tt> -<a name="L1443"></a><tt class="py-lineno">1443</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-583" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-583', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt> -<a name="L1444"></a><tt class="py-lineno">1444</tt> <tt class="py-line"> <tt class="py-name">i_lower</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-584" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-584', 'first', 'link-89');">first</a></tt> </tt> -<a name="L1445"></a><tt class="py-lineno">1445</tt> <tt class="py-line"> <tt class="py-name">i_upper</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-585" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-585', 'first', 'link-89');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-586" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-586', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1446"></a><tt class="py-lineno">1446</tt> <tt class="py-line"> </tt> -<a name="L1447"></a><tt class="py-lineno">1447</tt> <tt class="py-line"> <tt class="py-name">lower</tt> <tt class="py-op">=</tt> <tt id="link-587" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-587', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-588" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-862', '__init__', 'link-258');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-863" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-863', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt id="link-864" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-864', 'last', 'link-372');">last</a></tt><tt class="py-op">,</tt> <tt id="link-865" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-865', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L1883"></a><tt class="py-lineno">1883</tt> <tt class="py-line"> </tt> +<a name="CIDR.__sub__"></a><div id="CIDR.__sub__-def"><a name="L1884"></a><tt class="py-lineno">1884</tt> <a class="py-toggle" href="#" id="CIDR.__sub__-toggle" onclick="return toggle('CIDR.__sub__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__sub__">__sub__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.__sub__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__sub__-expanded"><a name="L1885"></a><tt class="py-lineno">1885</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1886"></a><tt class="py-lineno">1886</tt> <tt class="py-line"><tt class="py-docstring"> Subtract another CIDR from this one.</tt> </tt> +<a name="L1887"></a><tt class="py-lineno">1887</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1888"></a><tt class="py-lineno">1888</tt> <tt class="py-line"><tt class="py-docstring"> @param other: a CIDR object that is greater than or equal to C{self}.</tt> </tt> +<a name="L1889"></a><tt class="py-lineno">1889</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1890"></a><tt class="py-lineno">1890</tt> <tt class="py-line"><tt class="py-docstring"> @return: A list of CIDR objects than remain after subtracting C{other}</tt> </tt> +<a name="L1891"></a><tt class="py-lineno">1891</tt> <tt class="py-line"><tt class="py-docstring"> from C{self}.</tt> </tt> +<a name="L1892"></a><tt class="py-lineno">1892</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1893"></a><tt class="py-lineno">1893</tt> <tt class="py-line"> <tt id="link-866" class="py-name" targets="Method netaddr.address.CIDR.cidrs()=netaddr.address.CIDR-class.html#cidrs,Method netaddr.address.IPRange.cidrs()=netaddr.address.IPRange-class.html#cidrs"><a title="netaddr.address.CIDR.cidrs +netaddr.address.IPRange.cidrs" class="py-name" href="#" onclick="return doclink('link-866', 'cidrs', 'link-866');">cidrs</a></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L1894"></a><tt class="py-lineno">1894</tt> <tt class="py-line"> </tt> +<a name="L1895"></a><tt class="py-lineno">1895</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-867" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-867', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">==</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-868" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-588', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-589" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-868', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> +<a name="L1896"></a><tt class="py-lineno">1896</tt> <tt class="py-line"> <tt class="py-comment"># Fail fast. Nothing to do in this case.</tt> </tt> +<a name="L1897"></a><tt class="py-lineno">1897</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt id="link-869" class="py-name"><a title="netaddr.address.CIDR.cidrs +netaddr.address.IPRange.cidrs" class="py-name" href="#" onclick="return doclink('link-869', 'cidrs', 'link-866');">cidrs</a></tt> </tt> +<a name="L1898"></a><tt class="py-lineno">1898</tt> <tt class="py-line"> </tt> +<a name="L1899"></a><tt class="py-lineno">1899</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-870" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-870', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">+</tt> <tt class="py-number">1</tt> </tt> +<a name="L1900"></a><tt class="py-lineno">1900</tt> <tt class="py-line"> <tt class="py-name">i_lower</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-871" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-871', 'first', 'link-110');">first</a></tt> </tt> +<a name="L1901"></a><tt class="py-lineno">1901</tt> <tt class="py-line"> <tt class="py-name">i_upper</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-872" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-872', 'first', 'link-110');">first</a></tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-873" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-873', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1902"></a><tt class="py-lineno">1902</tt> <tt class="py-line"> </tt> +<a name="L1903"></a><tt class="py-lineno">1903</tt> <tt class="py-line"> <tt class="py-name">lower</tt> <tt class="py-op">=</tt> <tt id="link-874" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-874', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-875" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-875', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-876" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-589', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_lower</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> -<a name="L1448"></a><tt class="py-lineno">1448</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1449"></a><tt class="py-lineno">1449</tt> <tt class="py-line"> <tt class="py-name">upper</tt> <tt class="py-op">=</tt> <tt id="link-590" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-590', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-591" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-876', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_lower</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1904"></a><tt class="py-lineno">1904</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1905"></a><tt class="py-lineno">1905</tt> <tt class="py-line"> <tt class="py-name">upper</tt> <tt class="py-op">=</tt> <tt id="link-877" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-877', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-878" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-591', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-592" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-878', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-879" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-592', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_upper</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> -<a name="L1450"></a><tt class="py-lineno">1450</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1451"></a><tt class="py-lineno">1451</tt> <tt class="py-line"> </tt> -<a name="L1452"></a><tt class="py-lineno">1452</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-593" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-593', 'prefixlen', 'link-69');">prefixlen</a></tt> <tt class="py-op">>=</tt> <tt class="py-name">new_prefixlen</tt><tt class="py-op">:</tt> </tt> -<a name="L1453"></a><tt class="py-lineno">1453</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">other</tt> <tt class="py-keyword">in</tt> <tt class="py-name">lower</tt><tt class="py-op">:</tt> </tt> -<a name="L1454"></a><tt class="py-lineno">1454</tt> <tt class="py-line"> <tt class="py-name">matched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_lower</tt> </tt> -<a name="L1455"></a><tt class="py-lineno">1455</tt> <tt class="py-line"> <tt class="py-name">unmatched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_upper</tt> </tt> -<a name="L1456"></a><tt class="py-lineno">1456</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">other</tt> <tt class="py-keyword">in</tt> <tt class="py-name">upper</tt><tt class="py-op">:</tt> </tt> -<a name="L1457"></a><tt class="py-lineno">1457</tt> <tt class="py-line"> <tt class="py-name">matched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_upper</tt> </tt> -<a name="L1458"></a><tt class="py-lineno">1458</tt> <tt class="py-line"> <tt class="py-name">unmatched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_lower</tt> </tt> -<a name="L1459"></a><tt class="py-lineno">1459</tt> <tt class="py-line"> </tt> -<a name="L1460"></a><tt class="py-lineno">1460</tt> <tt class="py-line"> <tt id="link-594" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-594', 'cidr', 'link-527');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-595" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-595', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-596" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-879', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_upper</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1906"></a><tt class="py-lineno">1906</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1907"></a><tt class="py-lineno">1907</tt> <tt class="py-line"> </tt> +<a name="L1908"></a><tt class="py-lineno">1908</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">other</tt><tt class="py-op">.</tt><tt id="link-880" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-880', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">>=</tt> <tt class="py-name">new_prefixlen</tt><tt class="py-op">:</tt> </tt> +<a name="L1909"></a><tt class="py-lineno">1909</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">other</tt> <tt class="py-keyword">in</tt> <tt class="py-name">lower</tt><tt class="py-op">:</tt> </tt> +<a name="L1910"></a><tt class="py-lineno">1910</tt> <tt class="py-line"> <tt class="py-name">matched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_lower</tt> </tt> +<a name="L1911"></a><tt class="py-lineno">1911</tt> <tt class="py-line"> <tt class="py-name">unmatched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_upper</tt> </tt> +<a name="L1912"></a><tt class="py-lineno">1912</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">other</tt> <tt class="py-keyword">in</tt> <tt class="py-name">upper</tt><tt class="py-op">:</tt> </tt> +<a name="L1913"></a><tt class="py-lineno">1913</tt> <tt class="py-line"> <tt class="py-name">matched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_upper</tt> </tt> +<a name="L1914"></a><tt class="py-lineno">1914</tt> <tt class="py-line"> <tt class="py-name">unmatched</tt> <tt class="py-op">=</tt> <tt class="py-name">i_lower</tt> </tt> +<a name="L1915"></a><tt class="py-lineno">1915</tt> <tt class="py-line"> </tt> +<a name="L1916"></a><tt class="py-lineno">1916</tt> <tt class="py-line"> <tt id="link-881" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-881', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-882" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-882', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-883" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-596', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-597" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-883', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-884" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-597', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">unmatched</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> -<a name="L1461"></a><tt class="py-lineno">1461</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1462"></a><tt class="py-lineno">1462</tt> <tt class="py-line"> </tt> -<a name="L1463"></a><tt class="py-lineno">1463</tt> <tt class="py-line"> <tt class="py-name">cidrs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-598" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-598', 'cidr', 'link-527');">cidr</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1464"></a><tt class="py-lineno">1464</tt> <tt class="py-line"> </tt> -<a name="L1465"></a><tt class="py-lineno">1465</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt> -<a name="L1466"></a><tt class="py-lineno">1466</tt> <tt class="py-line"> </tt> -<a name="L1467"></a><tt class="py-lineno">1467</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_prefixlen</tt> <tt class="py-op">></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-599" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-884', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">unmatched</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1917"></a><tt class="py-lineno">1917</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1918"></a><tt class="py-lineno">1918</tt> <tt class="py-line"> </tt> +<a name="L1919"></a><tt class="py-lineno">1919</tt> <tt class="py-line"> <tt id="link-885" class="py-name"><a title="netaddr.address.CIDR.cidrs +netaddr.address.IPRange.cidrs" class="py-name" href="#" onclick="return doclink('link-885', 'cidrs', 'link-866');">cidrs</a></tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-886" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-886', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1920"></a><tt class="py-lineno">1920</tt> <tt class="py-line"> </tt> +<a name="L1921"></a><tt class="py-lineno">1921</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt> +<a name="L1922"></a><tt class="py-lineno">1922</tt> <tt class="py-line"> </tt> +<a name="L1923"></a><tt class="py-lineno">1923</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_prefixlen</tt> <tt class="py-op">></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-887" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-599', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> -<a name="L1468"></a><tt class="py-lineno">1468</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> -<a name="L1469"></a><tt class="py-lineno">1469</tt> <tt class="py-line"> </tt> -<a name="L1470"></a><tt class="py-lineno">1470</tt> <tt class="py-line"> <tt class="py-name">i_lower</tt> <tt class="py-op">=</tt> <tt class="py-name">matched</tt> </tt> -<a name="L1471"></a><tt class="py-lineno">1471</tt> <tt class="py-line"> <tt class="py-name">i_upper</tt> <tt class="py-op">=</tt> <tt class="py-name">matched</tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-600" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-887', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> +<a name="L1924"></a><tt class="py-lineno">1924</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> +<a name="L1925"></a><tt class="py-lineno">1925</tt> <tt class="py-line"> </tt> +<a name="L1926"></a><tt class="py-lineno">1926</tt> <tt class="py-line"> <tt class="py-name">i_lower</tt> <tt class="py-op">=</tt> <tt class="py-name">matched</tt> </tt> +<a name="L1927"></a><tt class="py-lineno">1927</tt> <tt class="py-line"> <tt class="py-name">i_upper</tt> <tt class="py-op">=</tt> <tt class="py-name">matched</tt> <tt class="py-op">+</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-888" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-600', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1472"></a><tt class="py-lineno">1472</tt> <tt class="py-line"> </tt> -<a name="L1473"></a><tt class="py-lineno">1473</tt> <tt class="py-line"> <tt class="py-name">lower</tt> <tt class="py-op">=</tt> <tt id="link-601" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-601', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-602" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-888', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1928"></a><tt class="py-lineno">1928</tt> <tt class="py-line"> </tt> +<a name="L1929"></a><tt class="py-lineno">1929</tt> <tt class="py-line"> <tt class="py-name">lower</tt> <tt class="py-op">=</tt> <tt id="link-889" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-889', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-890" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-602', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-603" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-890', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-891" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-603', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_lower</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> -<a name="L1474"></a><tt class="py-lineno">1474</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1475"></a><tt class="py-lineno">1475</tt> <tt class="py-line"> <tt class="py-name">upper</tt> <tt class="py-op">=</tt> <tt id="link-604" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-604', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-605" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-891', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_lower</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1930"></a><tt class="py-lineno">1930</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1931"></a><tt class="py-lineno">1931</tt> <tt class="py-line"> <tt class="py-name">upper</tt> <tt class="py-op">=</tt> <tt id="link-892" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-892', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-893" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-605', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-606" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-893', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-894" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.EUI48Strategy.int_to_str +netaddr.strategy.IPv4StrategyOpt.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-894', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_upper</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L1932"></a><tt class="py-lineno">1932</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L1933"></a><tt class="py-lineno">1933</tt> <tt class="py-line"> </tt> +<a name="L1934"></a><tt class="py-lineno">1934</tt> <tt class="py-line"> <tt id="link-895" class="py-name"><a title="netaddr.address.CIDR.cidrs +netaddr.address.IPRange.cidrs" class="py-name" href="#" onclick="return doclink('link-895', 'cidrs', 'link-866');">cidrs</a></tt><tt class="py-op">.</tt><tt class="py-name">sort</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L1935"></a><tt class="py-lineno">1935</tt> <tt class="py-line"> </tt> +<a name="L1936"></a><tt class="py-lineno">1936</tt> <tt class="py-line"> <tt class="py-comment"># Return string based CIDR address values at user's request.</tt> </tt> +<a name="L1937"></a><tt class="py-lineno">1937</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-896" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-896', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">str</tt><tt class="py-op">:</tt> </tt> +<a name="L1938"></a><tt class="py-lineno">1938</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt id="link-897" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-897', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt id="link-898" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-898', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt id="link-899" class="py-name"><a title="netaddr.address.CIDR.cidrs +netaddr.address.IPRange.cidrs" class="py-name" href="#" onclick="return doclink('link-899', 'cidrs', 'link-866');">cidrs</a></tt><tt class="py-op">]</tt> </tt> +<a name="L1939"></a><tt class="py-lineno">1939</tt> <tt class="py-line"> </tt> +<a name="L1940"></a><tt class="py-lineno">1940</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-900" class="py-name"><a title="netaddr.address.CIDR.cidrs +netaddr.address.IPRange.cidrs" class="py-name" href="#" onclick="return doclink('link-900', 'cidrs', 'link-866');">cidrs</a></tt> </tt> +</div><a name="L1941"></a><tt class="py-lineno">1941</tt> <tt class="py-line"> </tt> +<a name="CIDR.__add__"></a><div id="CIDR.__add__-def"><a name="L1942"></a><tt class="py-lineno">1942</tt> <a class="py-toggle" href="#" id="CIDR.__add__-toggle" onclick="return toggle('CIDR.__add__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__add__">__add__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.__add__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__add__-expanded"><a name="L1943"></a><tt class="py-lineno">1943</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1944"></a><tt class="py-lineno">1944</tt> <tt class="py-line"><tt class="py-docstring"> Add another CIDR to this one returning a CIDR supernet that will</tt> </tt> +<a name="L1945"></a><tt class="py-lineno">1945</tt> <tt class="py-line"><tt class="py-docstring"> contain both in the smallest possible sized range.</tt> </tt> +<a name="L1946"></a><tt class="py-lineno">1946</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1947"></a><tt class="py-lineno">1947</tt> <tt class="py-line"><tt class="py-docstring"> @param other: a CIDR object.</tt> </tt> +<a name="L1948"></a><tt class="py-lineno">1948</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1949"></a><tt class="py-lineno">1949</tt> <tt class="py-line"><tt class="py-docstring"> @return: A new (potentially larger) CIDR object.</tt> </tt> +<a name="L1950"></a><tt class="py-lineno">1950</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1951"></a><tt class="py-lineno">1951</tt> <tt class="py-line"> <tt id="link-901" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-901', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-902" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-902', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">.</tt><tt id="link-903" class="py-name"><a title="netaddr.address.CIDR.span" class="py-name" href="#" onclick="return doclink('link-903', 'span', 'link-648');">span</a></tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">,</tt> <tt class="py-name">other</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L1952"></a><tt class="py-lineno">1952</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-904" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-904', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">str</tt><tt class="py-op">:</tt> </tt> +<a name="L1953"></a><tt class="py-lineno">1953</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt id="link-905" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-905', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1954"></a><tt class="py-lineno">1954</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-906" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-906', 'cidr', 'link-434');">cidr</a></tt> </tt> +</div><a name="L1955"></a><tt class="py-lineno">1955</tt> <tt class="py-line"> </tt> +<a name="CIDR.network"></a><div id="CIDR.network-def"><a name="L1956"></a><tt class="py-lineno">1956</tt> <a class="py-toggle" href="#" id="CIDR.network-toggle" onclick="return toggle('CIDR.network');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#network">network</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.network-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.network-expanded"><a name="L1957"></a><tt class="py-lineno">1957</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: The network (first) address in this CIDR block."""</tt> </tt> +<a name="L1958"></a><tt class="py-lineno">1958</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +</div><a name="L1959"></a><tt class="py-lineno">1959</tt> <tt class="py-line"> </tt> +<a name="CIDR.broadcast"></a><div id="CIDR.broadcast-def"><a name="L1960"></a><tt class="py-lineno">1960</tt> <a class="py-toggle" href="#" id="CIDR.broadcast-toggle" onclick="return toggle('CIDR.broadcast');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#broadcast">broadcast</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.broadcast-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.broadcast-expanded"><a name="L1961"></a><tt class="py-lineno">1961</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1962"></a><tt class="py-lineno">1962</tt> <tt class="py-line"><tt class="py-docstring"> B{Please Note:} although IPv6 doesn't actually recognise the concept of</tt> </tt> +<a name="L1963"></a><tt class="py-lineno">1963</tt> <tt class="py-line"><tt class="py-docstring"> a 'broadcast' address as the last address in a subnet (as in IPv4) so</tt> </tt> +<a name="L1964"></a><tt class="py-lineno">1964</tt> <tt class="py-line"><tt class="py-docstring"> many other libraries do this that it isn't worth trying to resist.</tt> </tt> +<a name="L1965"></a><tt class="py-lineno">1965</tt> <tt class="py-line"><tt class="py-docstring"> This issue raises so many user queries that it is easier to dispense</tt> </tt> +<a name="L1966"></a><tt class="py-lineno">1966</tt> <tt class="py-line"><tt class="py-docstring"> with the theory and be pragmatic instead.</tt> </tt> +<a name="L1967"></a><tt class="py-lineno">1967</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1968"></a><tt class="py-lineno">1968</tt> <tt class="py-line"><tt class="py-docstring"> @return: The broadcast (last) address in this CIDR block.</tt> </tt> +<a name="L1969"></a><tt class="py-lineno">1969</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L1970"></a><tt class="py-lineno">1970</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +</div><a name="L1971"></a><tt class="py-lineno">1971</tt> <tt class="py-line"> </tt> +<a name="CIDR.netmask"></a><div id="CIDR.netmask-def"><a name="L1972"></a><tt class="py-lineno">1972</tt> <a class="py-toggle" href="#" id="CIDR.netmask-toggle" onclick="return toggle('CIDR.netmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#netmask">netmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.netmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.netmask-expanded"><a name="L1973"></a><tt class="py-lineno">1973</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: The subnet mask address of this CIDR block."""</tt> </tt> +<a name="L1974"></a><tt class="py-lineno">1974</tt> <tt class="py-line"> <tt id="link-907" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-907', 'hostmask', 'link-112');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-908" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-908', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-909" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-909', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L1975"></a><tt class="py-lineno">1975</tt> <tt class="py-line"> <tt id="link-910" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-910', 'netmask', 'link-88');">netmask</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-911" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-911', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">^</tt> <tt id="link-912" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-912', 'hostmask', 'link-112');">hostmask</a></tt> </tt> +<a name="L1976"></a><tt class="py-lineno">1976</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-913" class="py-name"><a title="netaddr.address.IPRange.format" class="py-name" href="#" onclick="return doclink('link-913', 'format', 'link-547');">format</a></tt><tt class="py-op">(</tt><tt id="link-914" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-914', 'netmask', 'link-88');">netmask</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L1977"></a><tt class="py-lineno">1977</tt> <tt class="py-line"> </tt> +<a name="CIDR.hostmask"></a><div id="CIDR.hostmask-def"><a name="L1978"></a><tt class="py-lineno">1978</tt> <a class="py-toggle" href="#" id="CIDR.hostmask-toggle" onclick="return toggle('CIDR.hostmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#hostmask">hostmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.hostmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.hostmask-expanded"><a name="L1979"></a><tt class="py-lineno">1979</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: The host mask address of this CIDR block."""</tt> </tt> +<a name="L1980"></a><tt class="py-lineno">1980</tt> <tt class="py-line"> <tt id="link-915" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-915', 'hostmask', 'link-112');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-916" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-916', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-917" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-917', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L1981"></a><tt class="py-lineno">1981</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-918" class="py-name"><a title="netaddr.address.IPRange.format" class="py-name" href="#" onclick="return doclink('link-918', 'format', 'link-547');">format</a></tt><tt class="py-op">(</tt><tt id="link-919" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-919', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L1982"></a><tt class="py-lineno">1982</tt> <tt class="py-line"> </tt> +<a name="L1983"></a><tt class="py-lineno">1983</tt> <tt class="py-line"> <tt id="link-920" class="py-name"><a title="netaddr.address.CIDR.network" class="py-name" href="#" onclick="return doclink('link-920', 'network', 'link-351');">network</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-921" class="py-name"><a title="netaddr.address.CIDR.network" class="py-name" href="#" onclick="return doclink('link-921', 'network', 'link-351');">network</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1984"></a><tt class="py-lineno">1984</tt> <tt class="py-line"> <tt id="link-922" class="py-name" targets="Variable netaddr.address.CIDR.broadcast=netaddr.address.CIDR-class.html#broadcast"><a title="netaddr.address.CIDR.broadcast" class="py-name" href="#" onclick="return doclink('link-922', 'broadcast', 'link-922');">broadcast</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-923" class="py-name"><a title="netaddr.address.CIDR.broadcast" class="py-name" href="#" onclick="return doclink('link-923', 'broadcast', 'link-922');">broadcast</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1985"></a><tt class="py-lineno">1985</tt> <tt class="py-line"> <tt id="link-924" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-924', 'netmask', 'link-88');">netmask</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-925" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-925', 'netmask', 'link-88');">netmask</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1986"></a><tt class="py-lineno">1986</tt> <tt class="py-line"> <tt id="link-926" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-926', 'hostmask', 'link-112');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-name">property</tt><tt class="py-op">(</tt><tt id="link-927" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-927', 'hostmask', 'link-112');">hostmask</a></tt><tt class="py-op">)</tt> </tt> +<a name="L1987"></a><tt class="py-lineno">1987</tt> <tt class="py-line"> </tt> +<a name="CIDR.subnet"></a><div id="CIDR.subnet-def"><a name="L1988"></a><tt class="py-lineno">1988</tt> <a class="py-toggle" href="#" id="CIDR.subnet-toggle" onclick="return toggle('CIDR.subnet');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#subnet">subnet</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">prefixlen</tt><tt class="py-op">,</tt> <tt class="py-param">count</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.subnet-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.subnet-expanded"><a name="L1989"></a><tt class="py-lineno">1989</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L1990"></a><tt class="py-lineno">1990</tt> <tt class="py-line"><tt class="py-docstring"> A generator that returns CIDR subnets based on the current network</tt> </tt> +<a name="L1991"></a><tt class="py-lineno">1991</tt> <tt class="py-line"><tt class="py-docstring"> base address and provided CIDR prefix and count.</tt> </tt> +<a name="L1992"></a><tt class="py-lineno">1992</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1993"></a><tt class="py-lineno">1993</tt> <tt class="py-line"><tt class="py-docstring"> @param prefixlen: a CIDR prefix.</tt> </tt> +<a name="L1994"></a><tt class="py-lineno">1994</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1995"></a><tt class="py-lineno">1995</tt> <tt class="py-line"><tt class="py-docstring"> @param count: number of consecutive CIDRs to be returned.</tt> </tt> +<a name="L1996"></a><tt class="py-lineno">1996</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L1997"></a><tt class="py-lineno">1997</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: callable used on return values.</tt> </tt> +<a name="L1998"></a><tt class="py-lineno">1998</tt> <tt class="py-line"><tt class="py-docstring"> Default: None - L{CIDR} objects. str() and unicode() supported.</tt> </tt> +<a name="L1999"></a><tt class="py-lineno">1999</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2000"></a><tt class="py-lineno">2000</tt> <tt class="py-line"><tt class="py-docstring"> @return: an iterator (as lists could potentially be very large)</tt> </tt> +<a name="L2001"></a><tt class="py-lineno">2001</tt> <tt class="py-line"><tt class="py-docstring"> containing CIDR subnets below this CIDR's base address.</tt> </tt> +<a name="L2002"></a><tt class="py-lineno">2002</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2003"></a><tt class="py-lineno">2003</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-928" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-928', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-929" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-929', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> +<a name="L2004"></a><tt class="py-lineno">2004</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'prefixlen %d out of bounds for address type!'</tt> \ </tt> +<a name="L2005"></a><tt class="py-lineno">2005</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt id="link-930" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-930', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2006"></a><tt class="py-lineno">2006</tt> <tt class="py-line"> </tt> +<a name="L2007"></a><tt class="py-lineno">2007</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-931" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-931', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op"><=</tt> <tt id="link-932" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-932', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">:</tt> </tt> +<a name="L2008"></a><tt class="py-lineno">2008</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'prefixlen less than current CIDR prefixlen!'</tt><tt class="py-op">)</tt> </tt> +<a name="L2009"></a><tt class="py-lineno">2009</tt> <tt class="py-line"> </tt> +<a name="L2010"></a><tt class="py-lineno">2010</tt> <tt class="py-line"> <tt class="py-comment"># Calculate number of subnets to be returned.</tt> </tt> +<a name="L2011"></a><tt class="py-lineno">2011</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">width</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-933" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-933', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> </tt> +<a name="L2012"></a><tt class="py-lineno">2012</tt> <tt class="py-line"> <tt class="py-name">max_count</tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-op">(</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-934" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-934', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt> <tt class="py-op">/</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-op">(</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt id="link-935" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-935', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2013"></a><tt class="py-lineno">2013</tt> <tt class="py-line"> </tt> +<a name="L2014"></a><tt class="py-lineno">2014</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">count</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L2015"></a><tt class="py-lineno">2015</tt> <tt class="py-line"> <tt class="py-name">count</tt> <tt class="py-op">=</tt> <tt class="py-name">max_count</tt> </tt> +<a name="L2016"></a><tt class="py-lineno">2016</tt> <tt class="py-line"> </tt> +<a name="L2017"></a><tt class="py-lineno">2017</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">1</tt> <tt class="py-op"><</tt> <tt class="py-name">count</tt> <tt class="py-op"><</tt> <tt class="py-name">max_count</tt><tt class="py-op">:</tt> </tt> +<a name="L2018"></a><tt class="py-lineno">2018</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'count not within current CIDR boundaries!'</tt><tt class="py-op">)</tt> </tt> +<a name="L2019"></a><tt class="py-lineno">2019</tt> <tt class="py-line"> </tt> +<a name="L2020"></a><tt class="py-lineno">2020</tt> <tt class="py-line"> <tt class="py-name">base_address</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-936" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-936', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-937" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.EUI48Strategy.int_to_str +netaddr.strategy.IPv4StrategyOpt.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-937', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-938" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-938', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2021"></a><tt class="py-lineno">2021</tt> <tt class="py-line"> </tt> +<a name="L2022"></a><tt class="py-lineno">2022</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-939" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-939', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L2023"></a><tt class="py-lineno">2023</tt> <tt class="py-line"> <tt class="py-comment"># Create new CIDR instances for each subnet returned.</tt> </tt> +<a name="L2024"></a><tt class="py-lineno">2024</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">xrange</tt><tt class="py-op">(</tt><tt class="py-name">count</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2025"></a><tt class="py-lineno">2025</tt> <tt class="py-line"> <tt id="link-940" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-940', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-941" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-941', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">base_address</tt><tt class="py-op">,</tt> <tt id="link-942" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-942', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2026"></a><tt class="py-lineno">2026</tt> <tt class="py-line"> <tt id="link-943" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-943', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-944" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-944', 'first', 'link-110');">first</a></tt> <tt class="py-op">+=</tt> <tt id="link-945" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-945', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-946" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-946', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt> </tt> +<a name="L2027"></a><tt class="py-lineno">2027</tt> <tt class="py-line"> <tt id="link-947" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-947', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-948" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-948', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-949" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-949', 'prefixlen', 'link-73');">prefixlen</a></tt> </tt> +<a name="L2028"></a><tt class="py-lineno">2028</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt id="link-950" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-950', 'cidr', 'link-434');">cidr</a></tt> </tt> +<a name="L2029"></a><tt class="py-lineno">2029</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt id="link-951" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-951', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2030"></a><tt class="py-lineno">2030</tt> <tt class="py-line"> <tt class="py-comment"># Keep the same CIDR and just modify it.</tt> </tt> +<a name="L2031"></a><tt class="py-lineno">2031</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-952" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-952', 'cidr', 'link-434');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-953" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-953', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">base_address</tt><tt class="py-op">,</tt> <tt id="link-954" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-954', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2032"></a><tt class="py-lineno">2032</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">xrange</tt><tt class="py-op">(</tt><tt class="py-name">count</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2033"></a><tt class="py-lineno">2033</tt> <tt class="py-line"> <tt id="link-955" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-955', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-956" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-956', 'first', 'link-110');">first</a></tt> <tt class="py-op">+=</tt> <tt id="link-957" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-957', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-958" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-958', 'size', 'link-530');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt> </tt> +<a name="L2034"></a><tt class="py-lineno">2034</tt> <tt class="py-line"> <tt id="link-959" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-959', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-960" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-960', 'prefixlen', 'link-73');">prefixlen</a></tt> <tt class="py-op">=</tt> <tt id="link-961" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-961', 'prefixlen', 'link-73');">prefixlen</a></tt> </tt> +<a name="L2035"></a><tt class="py-lineno">2035</tt> <tt class="py-line"> <tt class="py-keyword">yield</tt> <tt id="link-962" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-962', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt id="link-963" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-963', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2036"></a><tt class="py-lineno">2036</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L2037"></a><tt class="py-lineno">2037</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported fmt callable %r'</tt> <tt class="py-op">%</tt> <tt id="link-964" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-964', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L2038"></a><tt class="py-lineno">2038</tt> <tt class="py-line"> </tt> +<a name="CIDR.cidrs"></a><div id="CIDR.cidrs-def"><a name="L2039"></a><tt class="py-lineno">2039</tt> <a class="py-toggle" href="#" id="CIDR.cidrs-toggle" onclick="return toggle('CIDR.cidrs');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#cidrs">cidrs</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.cidrs-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.cidrs-expanded"><a name="L2040"></a><tt class="py-lineno">2040</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2041"></a><tt class="py-lineno">2041</tt> <tt class="py-line"><tt class="py-docstring"> @return: A list of a copy of this L{CIDR} object. This method is here</tt> </tt> +<a name="L2042"></a><tt class="py-lineno">2042</tt> <tt class="py-line"><tt class="py-docstring"> mainly for compatibility with IPRange interface.</tt> </tt> +<a name="L2043"></a><tt class="py-lineno">2043</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2044"></a><tt class="py-lineno">2044</tt> <tt class="py-line"> <tt class="py-name">cidr_copy</tt> <tt class="py-op">=</tt> <tt id="link-965" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-965', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s/%d'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-966" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-966', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-967" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-606', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">i_upper</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> -<a name="L1476"></a><tt class="py-lineno">1476</tt> <tt class="py-line"> <tt class="py-name">new_prefixlen</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1477"></a><tt class="py-lineno">1477</tt> <tt class="py-line"> </tt> -<a name="L1478"></a><tt class="py-lineno">1478</tt> <tt class="py-line"> <tt class="py-name">cidrs</tt><tt class="py-op">.</tt><tt class="py-name">sort</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L1479"></a><tt class="py-lineno">1479</tt> <tt class="py-line"> </tt> -<a name="L1480"></a><tt class="py-lineno">1480</tt> <tt class="py-line"> <tt class="py-comment"># Return string based CIDR address values at user's request.</tt> </tt> -<a name="L1481"></a><tt class="py-lineno">1481</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-607" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-607', 'klass', 'link-338');">klass</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">str</tt><tt class="py-op">:</tt> </tt> -<a name="L1482"></a><tt class="py-lineno">1482</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt id="link-608" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-608', 'cidr', 'link-527');">cidr</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt id="link-609" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-609', 'cidr', 'link-527');">cidr</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">cidrs</tt><tt class="py-op">]</tt> </tt> -<a name="L1483"></a><tt class="py-lineno">1483</tt> <tt class="py-line"> </tt> -<a name="L1484"></a><tt class="py-lineno">1484</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">cidrs</tt> </tt> -</div><a name="L1485"></a><tt class="py-lineno">1485</tt> <tt class="py-line"> </tt> -<a name="L1486"></a><tt class="py-lineno">1486</tt> <tt class="py-line"><tt class="py-comment">#TODO def __add__(self, other):</tt> </tt> -<a name="L1487"></a><tt class="py-lineno">1487</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO """</tt> </tt> -<a name="L1488"></a><tt class="py-lineno">1488</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO Add another CIDR to this one, but only if it is adjacent and of</tt> </tt> -<a name="L1489"></a><tt class="py-lineno">1489</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO equitable size.</tt> </tt> -<a name="L1490"></a><tt class="py-lineno">1490</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO</tt> </tt> -<a name="L1491"></a><tt class="py-lineno">1491</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO @param other: a CIDR object that is of equal size to C{self}.</tt> </tt> -<a name="L1492"></a><tt class="py-lineno">1492</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO</tt> </tt> -<a name="L1493"></a><tt class="py-lineno">1493</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO @return: A new CIDR object that is double the size of C{self}.</tt> </tt> -<a name="L1494"></a><tt class="py-lineno">1494</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO """</tt> </tt> -<a name="L1495"></a><tt class="py-lineno">1495</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO # Undecided about how to implement this.</tt> </tt> -<a name="L1496"></a><tt class="py-lineno">1496</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#TODO raise NotImplementedError('TODO')</tt> </tt> -<a name="L1497"></a><tt class="py-lineno">1497</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="CIDR.netmask"></a><div id="CIDR.netmask-def"><a name="L1498"></a><tt class="py-lineno">1498</tt> <a class="py-toggle" href="#" id="CIDR.netmask-toggle" onclick="return toggle('CIDR.netmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#netmask">netmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.netmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.netmask-expanded"><a name="L1499"></a><tt class="py-lineno">1499</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1500"></a><tt class="py-lineno">1500</tt> <tt class="py-line"><tt class="py-docstring"> @return: The subnet mask address of this CIDR range.</tt> </tt> -<a name="L1501"></a><tt class="py-lineno">1501</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1502"></a><tt class="py-lineno">1502</tt> <tt class="py-line"> <tt id="link-610" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-610', 'hostmask', 'link-91');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-611" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-611', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-612" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-612', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> -<a name="L1503"></a><tt class="py-lineno">1503</tt> <tt class="py-line"> <tt id="link-613" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-613', 'netmask', 'link-551');">netmask</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-614" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-614', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">^</tt> <tt id="link-615" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-615', 'hostmask', 'link-91');">hostmask</a></tt> </tt> -<a name="L1504"></a><tt class="py-lineno">1504</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-616" class="py-name"><a title="netaddr.address.AddrRange.data_flavour" class="py-name" href="#" onclick="return doclink('link-616', 'data_flavour', 'link-407');">data_flavour</a></tt><tt class="py-op">(</tt><tt id="link-617" class="py-name"><a title="netaddr.address.CIDR.netmask" class="py-name" href="#" onclick="return doclink('link-617', 'netmask', 'link-551');">netmask</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L1505"></a><tt class="py-lineno">1505</tt> <tt class="py-line"> </tt> -<a name="CIDR.hostmask"></a><div id="CIDR.hostmask-def"><a name="L1506"></a><tt class="py-lineno">1506</tt> <a class="py-toggle" href="#" id="CIDR.hostmask-toggle" onclick="return toggle('CIDR.hostmask');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#hostmask">hostmask</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.hostmask-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.hostmask-expanded"><a name="L1507"></a><tt class="py-lineno">1507</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1508"></a><tt class="py-lineno">1508</tt> <tt class="py-line"><tt class="py-docstring"> @return: The host mask address of this CIDR range.</tt> </tt> -<a name="L1509"></a><tt class="py-lineno">1509</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1510"></a><tt class="py-lineno">1510</tt> <tt class="py-line"> <tt id="link-618" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-618', 'hostmask', 'link-91');">hostmask</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">1</tt> <tt class="py-op"><<</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-619" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-619', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-620" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-620', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> -<a name="L1511"></a><tt class="py-lineno">1511</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-621" class="py-name"><a title="netaddr.address.AddrRange.data_flavour" class="py-name" href="#" onclick="return doclink('link-621', 'data_flavour', 'link-407');">data_flavour</a></tt><tt class="py-op">(</tt><tt id="link-622" class="py-name"><a title="netaddr.address.CIDR.hostmask" class="py-name" href="#" onclick="return doclink('link-622', 'hostmask', 'link-91');">hostmask</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L1512"></a><tt class="py-lineno">1512</tt> <tt class="py-line"> </tt> -<a name="CIDR.__str__"></a><div id="CIDR.__str__-def"><a name="L1513"></a><tt class="py-lineno">1513</tt> <a class="py-toggle" href="#" id="CIDR.__str__-toggle" onclick="return toggle('CIDR.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__str__-expanded"><a name="L1514"></a><tt class="py-lineno">1514</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-623" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-623', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-624" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-967', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-968" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-968', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L2045"></a><tt class="py-lineno">2045</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-969" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-969', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2046"></a><tt class="py-lineno">2046</tt> <tt class="py-line"> </tt> +<a name="L2047"></a><tt class="py-lineno">2047</tt> <tt class="py-line"> <tt class="py-comment"># Respect formatting.</tt> </tt> +<a name="L2048"></a><tt class="py-lineno">2048</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-970" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-970', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2049"></a><tt class="py-lineno">2049</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-971" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-971', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">(</tt><tt class="py-name">cidr_copy</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> +<a name="L2050"></a><tt class="py-lineno">2050</tt> <tt class="py-line"> </tt> +<a name="L2051"></a><tt class="py-lineno">2051</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">[</tt><tt class="py-name">cidr_copy</tt><tt class="py-op">]</tt> </tt> +</div><a name="L2052"></a><tt class="py-lineno">2052</tt> <tt class="py-line"> </tt> +<a name="CIDR.__str__"></a><div id="CIDR.__str__-def"><a name="L2053"></a><tt class="py-lineno">2053</tt> <a class="py-toggle" href="#" id="CIDR.__str__-toggle" onclick="return toggle('CIDR.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__str__-expanded"><a name="L2054"></a><tt class="py-lineno">2054</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s/%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-972" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-972', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-973" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-624', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-625" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-625', 'first', 'link-89');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-626" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-626', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L1515"></a><tt class="py-lineno">1515</tt> <tt class="py-line"> </tt> -<a name="CIDR.__repr__"></a><div id="CIDR.__repr__-def"><a name="L1516"></a><tt class="py-lineno">1516</tt> <a class="py-toggle" href="#" id="CIDR.__repr__-toggle" onclick="return toggle('CIDR.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__repr__-expanded"><a name="L1517"></a><tt class="py-lineno">1517</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1518"></a><tt class="py-lineno">1518</tt> <tt class="py-line"><tt class="py-docstring"> @return: An executable Python statement that can recreate an object</tt> </tt> -<a name="L1519"></a><tt class="py-lineno">1519</tt> <tt class="py-line"><tt class="py-docstring"> with an equivalent state.</tt> </tt> -<a name="L1520"></a><tt class="py-lineno">1520</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1521"></a><tt class="py-lineno">1521</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s('%s/%d')"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> </tt> -<a name="L1522"></a><tt class="py-lineno">1522</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-627" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-973', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-974" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-974', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-975" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-975', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L2055"></a><tt class="py-lineno">2055</tt> <tt class="py-line"> </tt> +<a name="CIDR.__repr__"></a><div id="CIDR.__repr__-def"><a name="L2056"></a><tt class="py-lineno">2056</tt> <a class="py-toggle" href="#" id="CIDR.__repr__-toggle" onclick="return toggle('CIDR.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="CIDR.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.__repr__-expanded"><a name="L2057"></a><tt class="py-lineno">2057</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object."""</tt> </tt> +<a name="L2058"></a><tt class="py-lineno">2058</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s('%s/%d')"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> </tt> +<a name="L2059"></a><tt class="py-lineno">2059</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-976" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-627', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-628" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-976', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-977" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-628', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-629" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-629', 'first', 'link-89');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-630" class="py-name"><a title="netaddr.address.CIDR.prefixlen -netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-630', 'prefixlen', 'link-69');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> -</div><a name="L1523"></a><tt class="py-lineno">1523</tt> <tt class="py-line"> </tt> -<a name="CIDR.wildcard"></a><div id="CIDR.wildcard-def"><a name="L1524"></a><tt class="py-lineno">1524</tt> <a class="py-toggle" href="#" id="CIDR.wildcard-toggle" onclick="return toggle('CIDR.wildcard');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.CIDR-class.html#wildcard">wildcard</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="CIDR.wildcard-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="CIDR.wildcard-expanded"><a name="L1525"></a><tt class="py-lineno">1525</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1526"></a><tt class="py-lineno">1526</tt> <tt class="py-line"><tt class="py-docstring"> @return: A L{Wildcard} object equivalent to this CIDR.</tt> </tt> -<a name="L1527"></a><tt class="py-lineno">1527</tt> <tt class="py-line"><tt class="py-docstring"> - If CIDR was initialised with C{klass=str} a wildcard string is</tt> </tt> -<a name="L1528"></a><tt class="py-lineno">1528</tt> <tt class="py-line"><tt class="py-docstring"> returned, in all other cases a L{Wildcard} object is returned.</tt> </tt> -<a name="L1529"></a><tt class="py-lineno">1529</tt> <tt class="py-line"><tt class="py-docstring"> - Only supports IPv4 CIDR addresses.</tt> </tt> -<a name="L1530"></a><tt class="py-lineno">1530</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1531"></a><tt class="py-lineno">1531</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-631" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-631', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-632" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-632', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-633" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-633', 'first', 'link-89');">first</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1532"></a><tt class="py-lineno">1532</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-634" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-634', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-635" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-635', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-636" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-636', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1533"></a><tt class="py-lineno">1533</tt> <tt class="py-line"> </tt> -<a name="L1534"></a><tt class="py-lineno">1534</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-637" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-637', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt id="link-638" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-638', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> -<a name="L1535"></a><tt class="py-lineno">1535</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-639" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-639', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'wildcards only suitable for IPv4 '</tt> \ </tt> -<a name="L1536"></a><tt class="py-lineno">1536</tt> <tt class="py-line"> <tt class="py-string">'ranges!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1537"></a><tt class="py-lineno">1537</tt> <tt class="py-line"> </tt> -<a name="L1538"></a><tt class="py-lineno">1538</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L1539"></a><tt class="py-lineno">1539</tt> <tt class="py-line"> </tt> -<a name="L1540"></a><tt class="py-lineno">1540</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L1541"></a><tt class="py-lineno">1541</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L1542"></a><tt class="py-lineno">1542</tt> <tt class="py-line"> </tt> -<a name="L1543"></a><tt class="py-lineno">1543</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">4</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1544"></a><tt class="py-lineno">1544</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> -<a name="L1545"></a><tt class="py-lineno">1545</tt> <tt class="py-line"> <tt class="py-comment"># A normal octet.</tt> </tt> -<a name="L1546"></a><tt class="py-lineno">1546</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1547"></a><tt class="py-lineno">1547</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">255</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1548"></a><tt class="py-lineno">1548</tt> <tt class="py-line"> <tt class="py-comment"># An asterisk octet.</tt> </tt> -<a name="L1549"></a><tt class="py-lineno">1549</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'*'</tt><tt class="py-op">)</tt> </tt> -<a name="L1550"></a><tt class="py-lineno">1550</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L1551"></a><tt class="py-lineno">1551</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1552"></a><tt class="py-lineno">1552</tt> <tt class="py-line"> <tt class="py-comment"># Create a hyphenated octet - only one allowed per wildcard.</tt> </tt> -<a name="L1553"></a><tt class="py-lineno">1553</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_asterisk</tt><tt class="py-op">:</tt> </tt> -<a name="L1554"></a><tt class="py-lineno">1554</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_hyphen</tt><tt class="py-op">:</tt> </tt> -<a name="L1555"></a><tt class="py-lineno">1555</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'%s-%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1556"></a><tt class="py-lineno">1556</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L1557"></a><tt class="py-lineno">1557</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1558"></a><tt class="py-lineno">1558</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-string">'only one hyphenated octet per '</tt> \ </tt> -<a name="L1559"></a><tt class="py-lineno">1559</tt> <tt class="py-line"> <tt class="py-string">'wildcard permitted!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1560"></a><tt class="py-lineno">1560</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1561"></a><tt class="py-lineno">1561</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">SyntaxError</tt><tt class="py-op">(</tt><tt class="py-string">"* chars aren't permitted before ' \</tt> </tt> -<a name="L1562"></a><tt class="py-lineno">1562</tt> <tt class="py-line"><tt class="py-string"> 'hyphenated octets!"</tt><tt class="py-op">)</tt> </tt> -<a name="L1563"></a><tt class="py-lineno">1563</tt> <tt class="py-line"> </tt> -<a name="L1564"></a><tt class="py-lineno">1564</tt> <tt class="py-line"> <tt id="link-640" class="py-name" targets="Method netaddr.address.CIDR.wildcard()=netaddr.address.CIDR-class.html#wildcard"><a title="netaddr.address.CIDR.wildcard" class="py-name" href="#" onclick="return doclink('link-640', 'wildcard', 'link-640');">wildcard</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -<a name="L1565"></a><tt class="py-lineno">1565</tt> <tt class="py-line"> </tt> -<a name="L1566"></a><tt class="py-lineno">1566</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-641" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-641', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">==</tt> <tt class="py-name">str</tt><tt class="py-op">:</tt> </tt> -<a name="L1567"></a><tt class="py-lineno">1567</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-642" class="py-name"><a title="netaddr.address.CIDR.wildcard" class="py-name" href="#" onclick="return doclink('link-642', 'wildcard', 'link-640');">wildcard</a></tt> </tt> -<a name="L1568"></a><tt class="py-lineno">1568</tt> <tt class="py-line"> </tt> -<a name="L1569"></a><tt class="py-lineno">1569</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-643" class="py-name" targets="Class netaddr.address.Wildcard=netaddr.address.Wildcard-class.html"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-643', 'Wildcard', 'link-643');">Wildcard</a></tt><tt class="py-op">(</tt><tt id="link-644" class="py-name"><a title="netaddr.address.CIDR.wildcard" class="py-name" href="#" onclick="return doclink('link-644', 'wildcard', 'link-640');">wildcard</a></tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L1570"></a><tt class="py-lineno">1570</tt> <tt class="py-line"> </tt> -<a name="L1571"></a><tt class="py-lineno">1571</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="Wildcard"></a><div id="Wildcard-def"><a name="L1572"></a><tt class="py-lineno">1572</tt> <a class="py-toggle" href="#" id="Wildcard-toggle" onclick="return toggle('Wildcard');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html">Wildcard</a><tt class="py-op">(</tt><tt class="py-base-class">AddrRange</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Wildcard-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Wildcard-expanded"><a name="L1573"></a><tt class="py-lineno">1573</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1574"></a><tt class="py-lineno">1574</tt> <tt class="py-line"><tt class="py-docstring"> A block of contiguous IPv4 network addresses defined using a wildcard</tt> </tt> -<a name="L1575"></a><tt class="py-lineno">1575</tt> <tt class="py-line"><tt class="py-docstring"> style syntax.</tt> </tt> -<a name="L1576"></a><tt class="py-lineno">1576</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1577"></a><tt class="py-lineno">1577</tt> <tt class="py-line"><tt class="py-docstring"> Individual octets can be represented using the following shortcuts :</tt> </tt> -<a name="L1578"></a><tt class="py-lineno">1578</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1579"></a><tt class="py-lineno">1579</tt> <tt class="py-line"><tt class="py-docstring"> 1. C{*} - the asterisk octet (represents values 0 through 255)</tt> </tt> -<a name="L1580"></a><tt class="py-lineno">1580</tt> <tt class="py-line"><tt class="py-docstring"> 2. C{'x-y'} - the hyphenated octet (represents values x through y)</tt> </tt> -<a name="L1581"></a><tt class="py-lineno">1581</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1582"></a><tt class="py-lineno">1582</tt> <tt class="py-line"><tt class="py-docstring"> A few basic rules also apply :</tt> </tt> -<a name="L1583"></a><tt class="py-lineno">1583</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1584"></a><tt class="py-lineno">1584</tt> <tt class="py-line"><tt class="py-docstring"> 1. x must always be greater than y, therefore :</tt> </tt> -<a name="L1585"></a><tt class="py-lineno">1585</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1586"></a><tt class="py-lineno">1586</tt> <tt class="py-line"><tt class="py-docstring"> - x can only be 0 through 254</tt> </tt> -<a name="L1587"></a><tt class="py-lineno">1587</tt> <tt class="py-line"><tt class="py-docstring"> - y can only be 1 through 255</tt> </tt> -<a name="L1588"></a><tt class="py-lineno">1588</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1589"></a><tt class="py-lineno">1589</tt> <tt class="py-line"><tt class="py-docstring"> 2. only one hyphenated octet per wildcard is allowed</tt> </tt> -<a name="L1590"></a><tt class="py-lineno">1590</tt> <tt class="py-line"><tt class="py-docstring"> 3. only asterisks are permitted after a hyphenated octet</tt> </tt> -<a name="L1591"></a><tt class="py-lineno">1591</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1592"></a><tt class="py-lineno">1592</tt> <tt class="py-line"><tt class="py-docstring"> Example wildcards ::</tt> </tt> -<a name="L1593"></a><tt class="py-lineno">1593</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1594"></a><tt class="py-lineno">1594</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0.1' # a single address</tt> </tt> -<a name="L1595"></a><tt class="py-lineno">1595</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0.0-31' # 32 addresses</tt> </tt> -<a name="L1596"></a><tt class="py-lineno">1596</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0.*' # 256 addresses</tt> </tt> -<a name="L1597"></a><tt class="py-lineno">1597</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0-1.*' # 512 addresses</tt> </tt> -<a name="L1598"></a><tt class="py-lineno">1598</tt> <tt class="py-line"><tt class="py-docstring"> '192.168-169.*.*' # 131,072 addresses</tt> </tt> -<a name="L1599"></a><tt class="py-lineno">1599</tt> <tt class="py-line"><tt class="py-docstring"> '*.*.*.*' # the whole IPv4 address space</tt> </tt> -<a name="L1600"></a><tt class="py-lineno">1600</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1601"></a><tt class="py-lineno">1601</tt> <tt class="py-line"><tt class="py-docstring"> Aside</tt> </tt> -<a name="L1602"></a><tt class="py-lineno">1602</tt> <tt class="py-line"><tt class="py-docstring"> =====</tt> </tt> -<a name="L1603"></a><tt class="py-lineno">1603</tt> <tt class="py-line"><tt class="py-docstring"> I{Wildcard ranges are not directly equivalent to CIDR ranges as they</tt> </tt> -<a name="L1604"></a><tt class="py-lineno">1604</tt> <tt class="py-line"><tt class="py-docstring"> can represent address ranges that do not fall on strict bit mask</tt> </tt> -<a name="L1605"></a><tt class="py-lineno">1605</tt> <tt class="py-line"><tt class="py-docstring"> boundaries.}</tt> </tt> -<a name="L1606"></a><tt class="py-lineno">1606</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1607"></a><tt class="py-lineno">1607</tt> <tt class="py-line"><tt class="py-docstring"> I{All CIDR ranges can always be represented as wildcard ranges but the</tt> </tt> -<a name="L1608"></a><tt class="py-lineno">1608</tt> <tt class="py-line"><tt class="py-docstring"> reverse isn't true in every case.}</tt> </tt> -<a name="L1609"></a><tt class="py-lineno">1609</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1610"></a><tt class="py-lineno">1610</tt> <tt class="py-line"> <tt id="link-645" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-977', 'int_to_str', 'link-156');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-978" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-978', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-979" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-979', 'prefixlen', 'link-73');">prefixlen</a></tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L2060"></a><tt class="py-lineno">2060</tt> <tt class="py-line"> </tt> +<a name="L2061"></a><tt class="py-lineno">2061</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="Wildcard"></a><div id="Wildcard-def"><a name="L2062"></a><tt class="py-lineno">2062</tt> <a class="py-toggle" href="#" id="Wildcard-toggle" onclick="return toggle('Wildcard');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html">Wildcard</a><tt class="py-op">(</tt><tt class="py-base-class">IPRange</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Wildcard-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="Wildcard-expanded"><a name="L2063"></a><tt class="py-lineno">2063</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2064"></a><tt class="py-lineno">2064</tt> <tt class="py-line"><tt class="py-docstring"> Represents blocks of IPv4 addresses using a wildcard or glob style syntax.</tt> </tt> +<a name="L2065"></a><tt class="py-lineno">2065</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2066"></a><tt class="py-lineno">2066</tt> <tt class="py-line"><tt class="py-docstring"> Individual octets can be represented using the following shortcuts :</tt> </tt> +<a name="L2067"></a><tt class="py-lineno">2067</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2068"></a><tt class="py-lineno">2068</tt> <tt class="py-line"><tt class="py-docstring"> 1. C{*} - the asterisk octet (represents values 0 through 255)</tt> </tt> +<a name="L2069"></a><tt class="py-lineno">2069</tt> <tt class="py-line"><tt class="py-docstring"> 2. C{'x-y'} - the hyphenated octet (represents values x through y)</tt> </tt> +<a name="L2070"></a><tt class="py-lineno">2070</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2071"></a><tt class="py-lineno">2071</tt> <tt class="py-line"><tt class="py-docstring"> A few basic rules also apply :</tt> </tt> +<a name="L2072"></a><tt class="py-lineno">2072</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2073"></a><tt class="py-lineno">2073</tt> <tt class="py-line"><tt class="py-docstring"> 1. x must always be greater than y, therefore :</tt> </tt> +<a name="L2074"></a><tt class="py-lineno">2074</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2075"></a><tt class="py-lineno">2075</tt> <tt class="py-line"><tt class="py-docstring"> - x can only be 0 through 254</tt> </tt> +<a name="L2076"></a><tt class="py-lineno">2076</tt> <tt class="py-line"><tt class="py-docstring"> - y can only be 1 through 255</tt> </tt> +<a name="L2077"></a><tt class="py-lineno">2077</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2078"></a><tt class="py-lineno">2078</tt> <tt class="py-line"><tt class="py-docstring"> 2. only one hyphenated octet per wildcard is allowed</tt> </tt> +<a name="L2079"></a><tt class="py-lineno">2079</tt> <tt class="py-line"><tt class="py-docstring"> 3. only asterisks are permitted after a hyphenated octet</tt> </tt> +<a name="L2080"></a><tt class="py-lineno">2080</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2081"></a><tt class="py-lineno">2081</tt> <tt class="py-line"><tt class="py-docstring"> Example wildcards ::</tt> </tt> +<a name="L2082"></a><tt class="py-lineno">2082</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2083"></a><tt class="py-lineno">2083</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0.1' # a single address</tt> </tt> +<a name="L2084"></a><tt class="py-lineno">2084</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0.0-31' # 32 addresses</tt> </tt> +<a name="L2085"></a><tt class="py-lineno">2085</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0.*' # 256 addresses</tt> </tt> +<a name="L2086"></a><tt class="py-lineno">2086</tt> <tt class="py-line"><tt class="py-docstring"> '192.168.0-1.*' # 512 addresses</tt> </tt> +<a name="L2087"></a><tt class="py-lineno">2087</tt> <tt class="py-line"><tt class="py-docstring"> '192.168-169.*.*' # 131,072 addresses</tt> </tt> +<a name="L2088"></a><tt class="py-lineno">2088</tt> <tt class="py-line"><tt class="py-docstring"> '*.*.*.*' # the whole IPv4 address space</tt> </tt> +<a name="L2089"></a><tt class="py-lineno">2089</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2090"></a><tt class="py-lineno">2090</tt> <tt class="py-line"><tt class="py-docstring"> Aside</tt> </tt> +<a name="L2091"></a><tt class="py-lineno">2091</tt> <tt class="py-line"><tt class="py-docstring"> =====</tt> </tt> +<a name="L2092"></a><tt class="py-lineno">2092</tt> <tt class="py-line"><tt class="py-docstring"> I{Wildcard ranges are not directly equivalent to CIDR blocks as they</tt> </tt> +<a name="L2093"></a><tt class="py-lineno">2093</tt> <tt class="py-line"><tt class="py-docstring"> can represent address ranges that do not fall on strict bit mask</tt> </tt> +<a name="L2094"></a><tt class="py-lineno">2094</tt> <tt class="py-line"><tt class="py-docstring"> boundaries. They are very suitable in configuration files being more</tt> </tt> +<a name="L2095"></a><tt class="py-lineno">2095</tt> <tt class="py-line"><tt class="py-docstring"> obvious and readable than their CIDR equivalents, especially for admins</tt> </tt> +<a name="L2096"></a><tt class="py-lineno">2096</tt> <tt class="py-line"><tt class="py-docstring"> and users without much networking knowledge or experience.}</tt> </tt> +<a name="L2097"></a><tt class="py-lineno">2097</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2098"></a><tt class="py-lineno">2098</tt> <tt class="py-line"><tt class="py-docstring"> I{All CIDR blocks can always be represented as wildcard ranges but the</tt> </tt> +<a name="L2099"></a><tt class="py-lineno">2099</tt> <tt class="py-line"><tt class="py-docstring"> reverse is not true. Wildcards are almost but not quite as flexible</tt> </tt> +<a name="L2100"></a><tt class="py-lineno">2100</tt> <tt class="py-line"><tt class="py-docstring"> as IPRange objects.}</tt> </tt> +<a name="L2101"></a><tt class="py-lineno">2101</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2102"></a><tt class="py-lineno">2102</tt> <tt class="py-line"> <tt id="link-980" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-645', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-646" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-646', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt> <tt id="link-647" class="py-name"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-647', 'ST_IPV6', 'link-12');">ST_IPV6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1611"></a><tt class="py-lineno">1611</tt> <tt class="py-line"> <tt id="link-648" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-980', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-981" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-981', 'ST_IPV4', 'link-11');">ST_IPV4</a></tt><tt class="py-op">,</tt><tt class="py-op">)</tt> </tt> +<a name="L2103"></a><tt class="py-lineno">2103</tt> <tt class="py-line"> <tt id="link-982" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-648', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-649" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-649', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-650" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-650', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-651" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-651', 'AT_INET6', 'link-5');">AT_INET6</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1612"></a><tt class="py-lineno">1612</tt> <tt class="py-line"> </tt> -<a name="L1613"></a><tt class="py-lineno">1613</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> -<a name="L1614"></a><tt class="py-lineno">1614</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-652" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-982', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt id="link-983" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-983', 'AT_UNSPEC', 'link-3');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-984" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-984', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2104"></a><tt class="py-lineno">2104</tt> <tt class="py-line"> </tt> +<a name="L2105"></a><tt class="py-lineno">2105</tt> <tt class="py-line"> <tt class="py-comment"># Descriptor registrations.</tt> </tt> +<a name="L2106"></a><tt class="py-lineno">2106</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-985" class="py-name"><a title="netaddr.address.Addr.strategy netaddr.address.CIDR.strategy netaddr.address.EUI.strategy netaddr.address.IP.strategy +netaddr.address.IPRange.strategy netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-652', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-653" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-653', 'StrategyDescriptor', 'link-123');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-654" class="py-name"><a title="netaddr.address.Addr.STRATEGIES -netaddr.address.AddrRange.STRATEGIES +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-985', 'strategy', 'link-10');">strategy</a></tt> <tt class="py-op">=</tt> <tt id="link-986" class="py-name"><a title="netaddr.address.StrategyDescriptor" class="py-name" href="#" onclick="return doclink('link-986', 'StrategyDescriptor', 'link-142');">StrategyDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-987" class="py-name"><a title="netaddr.address.Addr.STRATEGIES netaddr.address.CIDR.STRATEGIES netaddr.address.EUI.STRATEGIES netaddr.address.IP.STRATEGIES -netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-654', 'STRATEGIES', 'link-42');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1615"></a><tt class="py-lineno">1615</tt> <tt class="py-line"> <tt id="link-655" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.STRATEGIES +netaddr.address.Wildcard.STRATEGIES" class="py-name" href="#" onclick="return doclink('link-987', 'STRATEGIES', 'link-46');">STRATEGIES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2107"></a><tt class="py-lineno">2107</tt> <tt class="py-line"> <tt id="link-988" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-655', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-656" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-656', 'AddrTypeDescriptor', 'link-126');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-657" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES -netaddr.address.AddrRange.ADDR_TYPES +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-988', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-989" class="py-name"><a title="netaddr.address.AddrTypeDescriptor" class="py-name" href="#" onclick="return doclink('link-989', 'AddrTypeDescriptor', 'link-145');">AddrTypeDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-990" class="py-name"><a title="netaddr.address.Addr.ADDR_TYPES netaddr.address.CIDR.ADDR_TYPES netaddr.address.EUI.ADDR_TYPES netaddr.address.IP.ADDR_TYPES -netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-657', 'ADDR_TYPES', 'link-114');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1616"></a><tt class="py-lineno">1616</tt> <tt class="py-line"> <tt id="link-658" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-658', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">=</tt> <tt id="link-659" class="py-name"><a title="netaddr.address.KlassDescriptor" class="py-name" href="#" onclick="return doclink('link-659', 'KlassDescriptor', 'link-377');">KlassDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-660" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-660', 'IP', 'link-71');">IP</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1617"></a><tt class="py-lineno">1617</tt> <tt class="py-line"> </tt> -<a name="Wildcard.is_valid"></a><div id="Wildcard.is_valid-def"><a name="L1618"></a><tt class="py-lineno">1618</tt> <a class="py-toggle" href="#" id="Wildcard.is_valid-toggle" onclick="return toggle('Wildcard.is_valid');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#is_valid">is_valid</a><tt class="py-op">(</tt><tt class="py-param">wildcard</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Wildcard.is_valid-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.is_valid-expanded"><a name="L1619"></a><tt class="py-lineno">1619</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1620"></a><tt class="py-lineno">1620</tt> <tt class="py-line"><tt class="py-docstring"> A static method that validates wildcard address ranges.</tt> </tt> -<a name="L1621"></a><tt class="py-lineno">1621</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1622"></a><tt class="py-lineno">1622</tt> <tt class="py-line"><tt class="py-docstring"> @param wildcard: an IPv4 wildcard address.</tt> </tt> -<a name="L1623"></a><tt class="py-lineno">1623</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1624"></a><tt class="py-lineno">1624</tt> <tt class="py-line"><tt class="py-docstring"> @return: True if wildcard address is valid, False otherwise.</tt> </tt> -<a name="L1625"></a><tt class="py-lineno">1625</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1626"></a><tt class="py-lineno">1626</tt> <tt class="py-line"> <tt class="py-comment">#TODO: Add support for partial wildcards</tt> </tt> -<a name="L1627"></a><tt class="py-lineno">1627</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#TODO: e.g. 192.168.*.* == 192.168.*</tt> </tt> -<a name="L1628"></a><tt class="py-lineno">1628</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#TODO: *.*.*.* == *</tt> </tt> -<a name="L1629"></a><tt class="py-lineno">1629</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L1630"></a><tt class="py-lineno">1630</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L1631"></a><tt class="py-lineno">1631</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1632"></a><tt class="py-lineno">1632</tt> <tt class="py-line"> <tt class="py-name">octets</tt> <tt class="py-op">=</tt> <tt id="link-661" class="py-name"><a title="netaddr.address.CIDR.wildcard" class="py-name" href="#" onclick="return doclink('link-661', 'wildcard', 'link-640');">wildcard</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt> </tt> -<a name="L1633"></a><tt class="py-lineno">1633</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">octets</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">4</tt><tt class="py-op">:</tt> </tt> -<a name="L1634"></a><tt class="py-lineno">1634</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1635"></a><tt class="py-lineno">1635</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">o</tt> <tt class="py-keyword">in</tt> <tt class="py-name">octets</tt><tt class="py-op">:</tt> </tt> -<a name="L1636"></a><tt class="py-lineno">1636</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">o</tt><tt class="py-op">:</tt> </tt> -<a name="L1637"></a><tt class="py-lineno">1637</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_hyphen</tt><tt class="py-op">:</tt> </tt> -<a name="L1638"></a><tt class="py-lineno">1638</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1639"></a><tt class="py-lineno">1639</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L1640"></a><tt class="py-lineno">1640</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_asterisk</tt><tt class="py-op">:</tt> </tt> -<a name="L1641"></a><tt class="py-lineno">1641</tt> <tt class="py-line"> <tt class="py-comment"># Asterisks cannot precede hyphenated octets.</tt> </tt> -<a name="L1642"></a><tt class="py-lineno">1642</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1643"></a><tt class="py-lineno">1643</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">o1</tt><tt class="py-op">,</tt> <tt class="py-name">o2</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L1644"></a><tt class="py-lineno">1644</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">o1</tt> <tt class="py-op">>=</tt> <tt class="py-name">o2</tt><tt class="py-op">:</tt> </tt> -<a name="L1645"></a><tt class="py-lineno">1645</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1646"></a><tt class="py-lineno">1646</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">o1</tt> <tt class="py-op"><=</tt> <tt class="py-number">254</tt><tt class="py-op">:</tt> </tt> -<a name="L1647"></a><tt class="py-lineno">1647</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1648"></a><tt class="py-lineno">1648</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">1</tt> <tt class="py-op"><=</tt> <tt class="py-name">o2</tt> <tt class="py-op"><=</tt> <tt class="py-number">255</tt><tt class="py-op">:</tt> </tt> -<a name="L1649"></a><tt class="py-lineno">1649</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1650"></a><tt class="py-lineno">1650</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">o</tt> <tt class="py-op">==</tt> <tt class="py-string">'*'</tt><tt class="py-op">:</tt> </tt> -<a name="L1651"></a><tt class="py-lineno">1651</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L1652"></a><tt class="py-lineno">1652</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1653"></a><tt class="py-lineno">1653</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_hyphen</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L1654"></a><tt class="py-lineno">1654</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1655"></a><tt class="py-lineno">1655</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_asterisk</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L1656"></a><tt class="py-lineno">1656</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1657"></a><tt class="py-lineno">1657</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-number">255</tt><tt class="py-op">:</tt> </tt> -<a name="L1658"></a><tt class="py-lineno">1658</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1659"></a><tt class="py-lineno">1659</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> -<a name="L1660"></a><tt class="py-lineno">1660</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1661"></a><tt class="py-lineno">1661</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L1662"></a><tt class="py-lineno">1662</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L1663"></a><tt class="py-lineno">1663</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L1664"></a><tt class="py-lineno">1664</tt> <tt class="py-line"> </tt> -<a name="L1665"></a><tt class="py-lineno">1665</tt> <tt class="py-line"> <tt id="link-662" class="py-name" targets="Static Method netaddr.address.Wildcard.is_valid()=netaddr.address.Wildcard-class.html#is_valid"><a title="netaddr.address.Wildcard.is_valid" class="py-name" href="#" onclick="return doclink('link-662', 'is_valid', 'link-662');">is_valid</a></tt> <tt class="py-op">=</tt> <tt class="py-name">staticmethod</tt><tt class="py-op">(</tt><tt id="link-663" class="py-name"><a title="netaddr.address.Wildcard.is_valid" class="py-name" href="#" onclick="return doclink('link-663', 'is_valid', 'link-662');">is_valid</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1666"></a><tt class="py-lineno">1666</tt> <tt class="py-line"> </tt> -<a name="Wildcard.__init__"></a><div id="Wildcard.__init__-def"><a name="L1667"></a><tt class="py-lineno">1667</tt> <a class="py-toggle" href="#" id="Wildcard.__init__-toggle" onclick="return toggle('Wildcard.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">wildcard</tt><tt class="py-op">,</tt> <tt class="py-param">klass</tt><tt class="py-op">=</tt><tt id="link-664" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-664', 'IP', 'link-71');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Wildcard.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.__init__-expanded"><a name="L1668"></a><tt class="py-lineno">1668</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1669"></a><tt class="py-lineno">1669</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> -<a name="L1670"></a><tt class="py-lineno">1670</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1671"></a><tt class="py-lineno">1671</tt> <tt class="py-line"><tt class="py-docstring"> @param wildcard: a valid IPv4 wildcard address</tt> </tt> -<a name="L1672"></a><tt class="py-lineno">1672</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L1673"></a><tt class="py-lineno">1673</tt> <tt class="py-line"><tt class="py-docstring"> @param klass: (optional) class used to create each return object.</tt> </tt> -<a name="L1674"></a><tt class="py-lineno">1674</tt> <tt class="py-line"><tt class="py-docstring"> Default: L{IP} objects. See L{nrange()} documentations for</tt> </tt> -<a name="L1675"></a><tt class="py-lineno">1675</tt> <tt class="py-line"><tt class="py-docstring"> additional details on options.</tt> </tt> -<a name="L1676"></a><tt class="py-lineno">1676</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1677"></a><tt class="py-lineno">1677</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt id="link-665" class="py-name"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-665', 'Wildcard', 'link-643');">Wildcard</a></tt><tt class="py-op">.</tt><tt id="link-666" class="py-name"><a title="netaddr.address.Wildcard.is_valid" class="py-name" href="#" onclick="return doclink('link-666', 'is_valid', 'link-662');">is_valid</a></tt><tt class="py-op">(</tt><tt id="link-667" class="py-name"><a title="netaddr.address.CIDR.wildcard" class="py-name" href="#" onclick="return doclink('link-667', 'wildcard', 'link-640');">wildcard</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1678"></a><tt class="py-lineno">1678</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-668" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-668', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a recognised wildcard address!'</tt> \ </tt> -<a name="L1679"></a><tt class="py-lineno">1679</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt id="link-669" class="py-name"><a title="netaddr.address.CIDR.wildcard" class="py-name" href="#" onclick="return doclink('link-669', 'wildcard', 'link-640');">wildcard</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1680"></a><tt class="py-lineno">1680</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L1681"></a><tt class="py-lineno">1681</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L1682"></a><tt class="py-lineno">1682</tt> <tt class="py-line"> </tt> -<a name="L1683"></a><tt class="py-lineno">1683</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">octet</tt> <tt class="py-keyword">in</tt> <tt id="link-670" class="py-name"><a title="netaddr.address.CIDR.wildcard" class="py-name" href="#" onclick="return doclink('link-670', 'wildcard', 'link-640');">wildcard</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1684"></a><tt class="py-lineno">1684</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">octet</tt><tt class="py-op">:</tt> </tt> -<a name="L1685"></a><tt class="py-lineno">1685</tt> <tt class="py-line"> <tt class="py-name">oct_tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">octet</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt> </tt> -<a name="L1686"></a><tt class="py-lineno">1686</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">oct_tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> -<a name="L1687"></a><tt class="py-lineno">1687</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">oct_tokens</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> -<a name="L1688"></a><tt class="py-lineno">1688</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">octet</tt> <tt class="py-op">==</tt> <tt class="py-string">'*'</tt><tt class="py-op">:</tt> </tt> -<a name="L1689"></a><tt class="py-lineno">1689</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> -<a name="L1690"></a><tt class="py-lineno">1690</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">'255'</tt><tt class="py-op">]</tt> </tt> -<a name="L1691"></a><tt class="py-lineno">1691</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1692"></a><tt class="py-lineno">1692</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">octet</tt><tt class="py-op">]</tt> </tt> -<a name="L1693"></a><tt class="py-lineno">1693</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">octet</tt><tt class="py-op">]</tt> </tt> -<a name="L1694"></a><tt class="py-lineno">1694</tt> <tt class="py-line"> </tt> -<a name="L1695"></a><tt class="py-lineno">1695</tt> <tt class="py-line"> <tt id="link-671" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-671', 'first', 'link-89');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">)</tt> </tt> -<a name="L1696"></a><tt class="py-lineno">1696</tt> <tt class="py-line"> <tt id="link-672" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-672', 'last', 'link-374');">last</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">t2</tt><tt class="py-op">)</tt> </tt> -<a name="L1697"></a><tt class="py-lineno">1697</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-673" class="py-name"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +netaddr.address.IPRange.ADDR_TYPES +netaddr.address.Wildcard.ADDR_TYPES" class="py-name" href="#" onclick="return doclink('link-990', 'ADDR_TYPES', 'link-133');">ADDR_TYPES</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2108"></a><tt class="py-lineno">2108</tt> <tt class="py-line"> <tt id="link-991" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-991', 'fmt', 'link-261');">fmt</a></tt> <tt class="py-op">=</tt> <tt id="link-992" class="py-name"><a title="netaddr.address.FormatDescriptor" class="py-name" href="#" onclick="return doclink('link-992', 'FormatDescriptor', 'link-514');">FormatDescriptor</a></tt><tt class="py-op">(</tt><tt id="link-993" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-993', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2109"></a><tt class="py-lineno">2109</tt> <tt class="py-line"> </tt> +<a name="Wildcard.is_valid"></a><div id="Wildcard.is_valid-def"><a name="L2110"></a><tt class="py-lineno">2110</tt> <a class="py-toggle" href="#" id="Wildcard.is_valid-toggle" onclick="return toggle('Wildcard.is_valid');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#is_valid">is_valid</a><tt class="py-op">(</tt><tt class="py-param">wildcard</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Wildcard.is_valid-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.is_valid-expanded"><a name="L2111"></a><tt class="py-lineno">2111</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2112"></a><tt class="py-lineno">2112</tt> <tt class="py-line"><tt class="py-docstring"> A static method that validates wildcard address ranges.</tt> </tt> +<a name="L2113"></a><tt class="py-lineno">2113</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2114"></a><tt class="py-lineno">2114</tt> <tt class="py-line"><tt class="py-docstring"> @param wildcard: an IPv4 wildcard address.</tt> </tt> +<a name="L2115"></a><tt class="py-lineno">2115</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2116"></a><tt class="py-lineno">2116</tt> <tt class="py-line"><tt class="py-docstring"> @return: True if wildcard address is valid, False otherwise.</tt> </tt> +<a name="L2117"></a><tt class="py-lineno">2117</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2118"></a><tt class="py-lineno">2118</tt> <tt class="py-line"> <tt class="py-comment">#TODO: Add support for abbreviated wildcards</tt> </tt> +<a name="L2119"></a><tt class="py-lineno">2119</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#TODO: e.g. 192.168.*.* == 192.168.*</tt> </tt> +<a name="L2120"></a><tt class="py-lineno">2120</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#TODO: *.*.*.* == *</tt> </tt> +<a name="L2121"></a><tt class="py-lineno">2121</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#TODO: Add strict flag to enable verbose wildcard checking.</tt> </tt> +<a name="L2122"></a><tt class="py-lineno">2122</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L2123"></a><tt class="py-lineno">2123</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L2124"></a><tt class="py-lineno">2124</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L2125"></a><tt class="py-lineno">2125</tt> <tt class="py-line"> <tt class="py-name">octets</tt> <tt class="py-op">=</tt> <tt id="link-994" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-994', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt> </tt> +<a name="L2126"></a><tt class="py-lineno">2126</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">octets</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">4</tt><tt class="py-op">:</tt> </tt> +<a name="L2127"></a><tt class="py-lineno">2127</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2128"></a><tt class="py-lineno">2128</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">o</tt> <tt class="py-keyword">in</tt> <tt class="py-name">octets</tt><tt class="py-op">:</tt> </tt> +<a name="L2129"></a><tt class="py-lineno">2129</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">o</tt><tt class="py-op">:</tt> </tt> +<a name="L2130"></a><tt class="py-lineno">2130</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_hyphen</tt><tt class="py-op">:</tt> </tt> +<a name="L2131"></a><tt class="py-lineno">2131</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2132"></a><tt class="py-lineno">2132</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L2133"></a><tt class="py-lineno">2133</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_asterisk</tt><tt class="py-op">:</tt> </tt> +<a name="L2134"></a><tt class="py-lineno">2134</tt> <tt class="py-line"> <tt class="py-comment"># Asterisks cannot precede hyphenated octets.</tt> </tt> +<a name="L2135"></a><tt class="py-lineno">2135</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2136"></a><tt class="py-lineno">2136</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">o1</tt><tt class="py-op">,</tt> <tt class="py-name">o2</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">o</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> +<a name="L2137"></a><tt class="py-lineno">2137</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">o1</tt> <tt class="py-op">>=</tt> <tt class="py-name">o2</tt><tt class="py-op">:</tt> </tt> +<a name="L2138"></a><tt class="py-lineno">2138</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2139"></a><tt class="py-lineno">2139</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">o1</tt> <tt class="py-op"><=</tt> <tt class="py-number">254</tt><tt class="py-op">:</tt> </tt> +<a name="L2140"></a><tt class="py-lineno">2140</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2141"></a><tt class="py-lineno">2141</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">1</tt> <tt class="py-op"><=</tt> <tt class="py-name">o2</tt> <tt class="py-op"><=</tt> <tt class="py-number">255</tt><tt class="py-op">:</tt> </tt> +<a name="L2142"></a><tt class="py-lineno">2142</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2143"></a><tt class="py-lineno">2143</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">o</tt> <tt class="py-op">==</tt> <tt class="py-string">'*'</tt><tt class="py-op">:</tt> </tt> +<a name="L2144"></a><tt class="py-lineno">2144</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L2145"></a><tt class="py-lineno">2145</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L2146"></a><tt class="py-lineno">2146</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_hyphen</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L2147"></a><tt class="py-lineno">2147</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2148"></a><tt class="py-lineno">2148</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">seen_asterisk</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L2149"></a><tt class="py-lineno">2149</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2150"></a><tt class="py-lineno">2150</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">o</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-number">255</tt><tt class="py-op">:</tt> </tt> +<a name="L2151"></a><tt class="py-lineno">2151</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2152"></a><tt class="py-lineno">2152</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">AttributeError</tt><tt class="py-op">:</tt> </tt> +<a name="L2153"></a><tt class="py-lineno">2153</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2154"></a><tt class="py-lineno">2154</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L2155"></a><tt class="py-lineno">2155</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L2156"></a><tt class="py-lineno">2156</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +</div><a name="L2157"></a><tt class="py-lineno">2157</tt> <tt class="py-line"> </tt> +<a name="L2158"></a><tt class="py-lineno">2158</tt> <tt class="py-line"> <tt id="link-995" class="py-name" targets="Static Method netaddr.address.Wildcard.is_valid()=netaddr.address.Wildcard-class.html#is_valid"><a title="netaddr.address.Wildcard.is_valid" class="py-name" href="#" onclick="return doclink('link-995', 'is_valid', 'link-995');">is_valid</a></tt> <tt class="py-op">=</tt> <tt class="py-name">staticmethod</tt><tt class="py-op">(</tt><tt id="link-996" class="py-name"><a title="netaddr.address.Wildcard.is_valid" class="py-name" href="#" onclick="return doclink('link-996', 'is_valid', 'link-995');">is_valid</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2159"></a><tt class="py-lineno">2159</tt> <tt class="py-line"> </tt> +<a name="Wildcard.__init__"></a><div id="Wildcard.__init__-def"><a name="L2160"></a><tt class="py-lineno">2160</tt> <a class="py-toggle" href="#" id="Wildcard.__init__-toggle" onclick="return toggle('Wildcard.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">wildcard</tt><tt class="py-op">,</tt> <tt class="py-param">fmt</tt><tt class="py-op">=</tt><tt id="link-997" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-997', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Wildcard.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.__init__-expanded"><a name="L2161"></a><tt class="py-lineno">2161</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2162"></a><tt class="py-lineno">2162</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L2163"></a><tt class="py-lineno">2163</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2164"></a><tt class="py-lineno">2164</tt> <tt class="py-line"><tt class="py-docstring"> @param wildcard: a valid IPv4 wildcard address</tt> </tt> +<a name="L2165"></a><tt class="py-lineno">2165</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2166"></a><tt class="py-lineno">2166</tt> <tt class="py-line"><tt class="py-docstring"> @param fmt: (optional) callable used on return values.</tt> </tt> +<a name="L2167"></a><tt class="py-lineno">2167</tt> <tt class="py-line"><tt class="py-docstring"> Default: L{IP} objects. See L{nrange()} documentations for</tt> </tt> +<a name="L2168"></a><tt class="py-lineno">2168</tt> <tt class="py-line"><tt class="py-docstring"> more details on the various options..</tt> </tt> +<a name="L2169"></a><tt class="py-lineno">2169</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2170"></a><tt class="py-lineno">2170</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt id="link-998" class="py-name"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-998', 'Wildcard', 'link-457');">Wildcard</a></tt><tt class="py-op">.</tt><tt id="link-999" class="py-name"><a title="netaddr.address.Wildcard.is_valid" class="py-name" href="#" onclick="return doclink('link-999', 'is_valid', 'link-995');">is_valid</a></tt><tt class="py-op">(</tt><tt id="link-1000" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-1000', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2171"></a><tt class="py-lineno">2171</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-1001" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-1001', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a recognised wildcard address!'</tt> \ </tt> +<a name="L2172"></a><tt class="py-lineno">2172</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt id="link-1002" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-1002', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2173"></a><tt class="py-lineno">2173</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L2174"></a><tt class="py-lineno">2174</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L2175"></a><tt class="py-lineno">2175</tt> <tt class="py-line"> </tt> +<a name="L2176"></a><tt class="py-lineno">2176</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">octet</tt> <tt class="py-keyword">in</tt> <tt id="link-1003" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-1003', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2177"></a><tt class="py-lineno">2177</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">octet</tt><tt class="py-op">:</tt> </tt> +<a name="L2178"></a><tt class="py-lineno">2178</tt> <tt class="py-line"> <tt class="py-name">oct_tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">octet</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt> </tt> +<a name="L2179"></a><tt class="py-lineno">2179</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">oct_tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> +<a name="L2180"></a><tt class="py-lineno">2180</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">oct_tokens</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt> +<a name="L2181"></a><tt class="py-lineno">2181</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">octet</tt> <tt class="py-op">==</tt> <tt class="py-string">'*'</tt><tt class="py-op">:</tt> </tt> +<a name="L2182"></a><tt class="py-lineno">2182</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> +<a name="L2183"></a><tt class="py-lineno">2183</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">'255'</tt><tt class="py-op">]</tt> </tt> +<a name="L2184"></a><tt class="py-lineno">2184</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L2185"></a><tt class="py-lineno">2185</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">octet</tt><tt class="py-op">]</tt> </tt> +<a name="L2186"></a><tt class="py-lineno">2186</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">octet</tt><tt class="py-op">]</tt> </tt> +<a name="L2187"></a><tt class="py-lineno">2187</tt> <tt class="py-line"> </tt> +<a name="L2188"></a><tt class="py-lineno">2188</tt> <tt class="py-line"> <tt id="link-1004" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-1004', 'first', 'link-110');">first</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">)</tt> </tt> +<a name="L2189"></a><tt class="py-lineno">2189</tt> <tt class="py-line"> <tt id="link-1005" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-1005', 'last', 'link-372');">last</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">t2</tt><tt class="py-op">)</tt> </tt> +<a name="L2190"></a><tt class="py-lineno">2190</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-1006" class="py-name"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-1006', 'Wildcard', 'link-457');">Wildcard</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-1007" class="py-name"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-673', '__init__', 'link-216');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-674" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-674', 'first', 'link-89');">first</a></tt><tt class="py-op">,</tt> <tt id="link-675" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-675', 'last', 'link-374');">last</a></tt><tt class="py-op">,</tt> <tt id="link-676" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-676', 'klass', 'link-338');">klass</a></tt><tt class="py-op">=</tt><tt id="link-677" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-677', 'klass', 'link-338');">klass</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1698"></a><tt class="py-lineno">1698</tt> <tt class="py-line"> </tt> -<a name="L1699"></a><tt class="py-lineno">1699</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-678" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type -netaddr.address.CIDR.addr_type -netaddr.address.EUI.addr_type -netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-678', 'addr_type', 'link-39');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt id="link-679" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-679', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> -<a name="L1700"></a><tt class="py-lineno">1700</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-680" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-680', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Wildcard syntax only supports IPv4!'</tt><tt class="py-op">)</tt> </tt> -</div><a name="L1701"></a><tt class="py-lineno">1701</tt> <tt class="py-line"> </tt> -<a name="Wildcard.cidr"></a><div id="Wildcard.cidr-def"><a name="L1702"></a><tt class="py-lineno">1702</tt> <a class="py-toggle" href="#" id="Wildcard.cidr-toggle" onclick="return toggle('Wildcard.cidr');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#cidr">cidr</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Wildcard.cidr-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.cidr-expanded"><a name="L1703"></a><tt class="py-lineno">1703</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1704"></a><tt class="py-lineno">1704</tt> <tt class="py-line"><tt class="py-docstring"> @return: A valid L{CIDR} object for this wildcard. If conversion fails</tt> </tt> -<a name="L1705"></a><tt class="py-lineno">1705</tt> <tt class="py-line"><tt class="py-docstring"> an L{AddrConversionError} is raised as not all wildcards ranges are</tt> </tt> -<a name="L1706"></a><tt class="py-lineno">1706</tt> <tt class="py-line"><tt class="py-docstring"> valid CIDR ranges.</tt> </tt> -<a name="L1707"></a><tt class="py-lineno">1707</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1708"></a><tt class="py-lineno">1708</tt> <tt class="py-line"> <tt id="link-681" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-681', 'size', 'link-393');">size</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-682" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-682', 'size', 'link-393');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L1709"></a><tt class="py-lineno">1709</tt> <tt class="py-line"> </tt> -<a name="L1710"></a><tt class="py-lineno">1710</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-683" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-683', 'size', 'link-393');">size</a></tt> <tt class="py-op">&</tt> <tt class="py-op">(</tt><tt id="link-684" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-684', 'size', 'link-393');">size</a></tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> -<a name="L1711"></a><tt class="py-lineno">1711</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-685" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-685', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s cannot be represented with CIDR'</tt> \ </tt> -<a name="L1712"></a><tt class="py-lineno">1712</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1713"></a><tt class="py-lineno">1713</tt> <tt class="py-line"> </tt> -<a name="L1714"></a><tt class="py-lineno">1714</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">mantissa</tt><tt class="py-op">,</tt> <tt class="py-name">exponent</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">_math</tt><tt class="py-op">.</tt><tt class="py-name">frexp</tt><tt class="py-op">(</tt><tt id="link-686" class="py-name"><a title="netaddr.address.AddrRange.size" class="py-name" href="#" onclick="return doclink('link-686', 'size', 'link-393');">size</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1715"></a><tt class="py-lineno">1715</tt> <tt class="py-line"> </tt> -<a name="L1716"></a><tt class="py-lineno">1716</tt> <tt class="py-line"> <tt class="py-comment"># The check below is only valid up to around 2^53 after which</tt> </tt> -<a name="L1717"></a><tt class="py-lineno">1717</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># rounding on +1 or -1 starts to bite and would cause this logic to</tt> </tt> -<a name="L1718"></a><tt class="py-lineno">1718</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># fail. Fine for our purposes here as we only envisage supporting</tt> </tt> -<a name="L1719"></a><tt class="py-lineno">1719</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># values up to 2^32 (IPv4), for now at least.</tt> </tt> -<a name="L1720"></a><tt class="py-lineno">1720</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">mantissa</tt> <tt class="py-op">!=</tt> <tt class="py-number">0.5</tt><tt class="py-op">:</tt> </tt> -<a name="L1721"></a><tt class="py-lineno">1721</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-687" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-687', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s cannot be represented with CIDR'</tt> \ </tt> -<a name="L1722"></a><tt class="py-lineno">1722</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1723"></a><tt class="py-lineno">1723</tt> <tt class="py-line"> </tt> -<a name="L1724"></a><tt class="py-lineno">1724</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">32</tt> <tt class="py-op">-</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">exponent</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L1725"></a><tt class="py-lineno">1725</tt> <tt class="py-line"> <tt class="py-name">network</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-688" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-688', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-689" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str -netaddr.strategy.EUI48Strategy.int_to_str -netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-689', 'int_to_str', 'link-137');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-690" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-690', 'first', 'link-89');">first</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1726"></a><tt class="py-lineno">1726</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L1727"></a><tt class="py-lineno">1727</tt> <tt class="py-line"> <tt id="link-691" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-691', 'cidr', 'link-527');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-692" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-692', 'CIDR', 'link-294');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">"%s/%d"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">network</tt><tt class="py-op">,</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1728"></a><tt class="py-lineno">1728</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> -<a name="L1729"></a><tt class="py-lineno">1729</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-693" class="py-name"><a title="netaddr.AddrConversionError" class="py-name" href="#" onclick="return doclink('link-693', 'AddrConversionError', 'link-2');">AddrConversionError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%s cannot be represented with CIDR'</tt> \ </tt> -<a name="L1730"></a><tt class="py-lineno">1730</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1731"></a><tt class="py-lineno">1731</tt> <tt class="py-line"> </tt> -<a name="L1732"></a><tt class="py-lineno">1732</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-694" class="py-name"><a title="netaddr.address.AddrRange.klass -netaddr.address.CIDR.klass -netaddr.address.Wildcard.klass" class="py-name" href="#" onclick="return doclink('link-694', 'klass', 'link-338');">klass</a></tt> <tt class="py-op">==</tt> <tt class="py-name">str</tt><tt class="py-op">:</tt> </tt> -<a name="L1733"></a><tt class="py-lineno">1733</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt id="link-695" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-695', 'cidr', 'link-527');">cidr</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1734"></a><tt class="py-lineno">1734</tt> <tt class="py-line"> </tt> -<a name="L1735"></a><tt class="py-lineno">1735</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-696" class="py-name"><a title="netaddr.address.IP.cidr -netaddr.address.Wildcard.cidr" class="py-name" href="#" onclick="return doclink('link-696', 'cidr', 'link-527');">cidr</a></tt> </tt> -</div><a name="L1736"></a><tt class="py-lineno">1736</tt> <tt class="py-line"> </tt> -<a name="Wildcard.__str__"></a><div id="Wildcard.__str__-def"><a name="L1737"></a><tt class="py-lineno">1737</tt> <a class="py-toggle" href="#" id="Wildcard.__str__-toggle" onclick="return toggle('Wildcard.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Wildcard.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.__str__-expanded"><a name="L1738"></a><tt class="py-lineno">1738</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-697" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-697', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-698" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-698', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-699" class="py-name"><a title="netaddr.address.AddrRange.first" class="py-name" href="#" onclick="return doclink('link-699', 'first', 'link-89');">first</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1739"></a><tt class="py-lineno">1739</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-700" class="py-name"><a title="netaddr.address.Addr.strategy -netaddr.address.AddrRange.strategy -netaddr.address.CIDR.strategy -netaddr.address.EUI.strategy -netaddr.address.IP.strategy -netaddr.address.Wildcard.strategy -netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-700', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-701" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-701', 'int_to_words', 'link-144');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-702" class="py-name"><a title="netaddr.address.AddrRange.last" class="py-name" href="#" onclick="return doclink('link-702', 'last', 'link-374');">last</a></tt><tt class="py-op">)</tt> </tt> -<a name="L1740"></a><tt class="py-lineno">1740</tt> <tt class="py-line"> </tt> -<a name="L1741"></a><tt class="py-lineno">1741</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L1742"></a><tt class="py-lineno">1742</tt> <tt class="py-line"> </tt> -<a name="L1743"></a><tt class="py-lineno">1743</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L1744"></a><tt class="py-lineno">1744</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L1745"></a><tt class="py-lineno">1745</tt> <tt class="py-line"> </tt> -<a name="L1746"></a><tt class="py-lineno">1746</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">4</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1747"></a><tt class="py-lineno">1747</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> -<a name="L1748"></a><tt class="py-lineno">1748</tt> <tt class="py-line"> <tt class="py-comment"># A normal octet.</tt> </tt> -<a name="L1749"></a><tt class="py-lineno">1749</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1750"></a><tt class="py-lineno">1750</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">255</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L1751"></a><tt class="py-lineno">1751</tt> <tt class="py-line"> <tt class="py-comment"># An asterisk octet.</tt> </tt> -<a name="L1752"></a><tt class="py-lineno">1752</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'*'</tt><tt class="py-op">)</tt> </tt> -<a name="L1753"></a><tt class="py-lineno">1753</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L1754"></a><tt class="py-lineno">1754</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1755"></a><tt class="py-lineno">1755</tt> <tt class="py-line"> <tt class="py-comment"># Create a hyphenated octet - only one allowed per wildcard.</tt> </tt> -<a name="L1756"></a><tt class="py-lineno">1756</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_asterisk</tt><tt class="py-op">:</tt> </tt> -<a name="L1757"></a><tt class="py-lineno">1757</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_hyphen</tt><tt class="py-op">:</tt> </tt> -<a name="L1758"></a><tt class="py-lineno">1758</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'%s-%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L1759"></a><tt class="py-lineno">1759</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L1760"></a><tt class="py-lineno">1760</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1761"></a><tt class="py-lineno">1761</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-703" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-703', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'only one hyphenated octet '</tt> \ </tt> -<a name="L1762"></a><tt class="py-lineno">1762</tt> <tt class="py-line"> <tt class="py-string">' per wildcard allowed!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1763"></a><tt class="py-lineno">1763</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L1764"></a><tt class="py-lineno">1764</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-704" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-704', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'asterisks not permitted before '</tt> \ </tt> -<a name="L1765"></a><tt class="py-lineno">1765</tt> <tt class="py-line"> <tt class="py-string">'hyphenated octets!'</tt><tt class="py-op">)</tt> </tt> -<a name="L1766"></a><tt class="py-lineno">1766</tt> <tt class="py-line"> </tt> -<a name="L1767"></a><tt class="py-lineno">1767</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -</div><a name="L1768"></a><tt class="py-lineno">1768</tt> <tt class="py-line"> </tt> -<a name="Wildcard.__repr__"></a><div id="Wildcard.__repr__-def"><a name="L1769"></a><tt class="py-lineno">1769</tt> <a class="py-toggle" href="#" id="Wildcard.__repr__-toggle" onclick="return toggle('Wildcard.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="Wildcard.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.__repr__-expanded"><a name="L1770"></a><tt class="py-lineno">1770</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L1771"></a><tt class="py-lineno">1771</tt> <tt class="py-line"><tt class="py-docstring"> @return: An executable Python statement that can recreate an object</tt> </tt> -<a name="L1772"></a><tt class="py-lineno">1772</tt> <tt class="py-line"><tt class="py-docstring"> with an equivalent state.</tt> </tt> -<a name="L1773"></a><tt class="py-lineno">1773</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L1774"></a><tt class="py-lineno">1774</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s(%r)"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L1775"></a><tt class="py-lineno">1775</tt> <tt class="py-line"> </tt> -<a name="L1776"></a><tt class="py-lineno">1776</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L1777"></a><tt class="py-lineno">1777</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">if</tt> <tt class="py-name">__name__</tt> <tt class="py-op">==</tt> <tt class="py-string">'__main__'</tt><tt class="py-op">:</tt> </tt> -<a name="L1778"></a><tt class="py-lineno">1778</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L1779"></a><tt class="py-lineno">1779</tt> <tt class="py-line"> </tt><script type="text/javascript"> +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-1007', '__init__', 'link-258');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-1008" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-1008', 'first', 'link-110');">first</a></tt><tt class="py-op">,</tt> <tt id="link-1009" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-1009', 'last', 'link-372');">last</a></tt><tt class="py-op">,</tt> <tt id="link-1010" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-1010', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">=</tt><tt id="link-1011" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-1011', 'fmt', 'link-261');">fmt</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2191"></a><tt class="py-lineno">2191</tt> <tt class="py-line"> </tt> +<a name="L2192"></a><tt class="py-lineno">2192</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-1012" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-1012', 'addr_type', 'link-43');">addr_type</a></tt> <tt class="py-op">!=</tt> <tt id="link-1013" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-1013', 'AT_INET', 'link-4');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L2193"></a><tt class="py-lineno">2193</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-1014" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-1014', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'Wildcard syntax only supports IPv4!'</tt><tt class="py-op">)</tt> </tt> +</div><a name="L2194"></a><tt class="py-lineno">2194</tt> <tt class="py-line"> </tt> +<a name="Wildcard.__str__"></a><div id="Wildcard.__str__-def"><a name="L2195"></a><tt class="py-lineno">2195</tt> <a class="py-toggle" href="#" id="Wildcard.__str__-toggle" onclick="return toggle('Wildcard.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Wildcard.__str__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.__str__-expanded"><a name="L2196"></a><tt class="py-lineno">2196</tt> <tt class="py-line"> <tt class="py-name">t1</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-1015" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-1015', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-1016" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-1016', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-1017" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-1017', 'first', 'link-110');">first</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2197"></a><tt class="py-lineno">2197</tt> <tt class="py-line"> <tt class="py-name">t2</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-1018" class="py-name"><a title="netaddr.address.Addr.strategy +netaddr.address.CIDR.strategy +netaddr.address.EUI.strategy +netaddr.address.IP.strategy +netaddr.address.IPRange.strategy +netaddr.address.Wildcard.strategy +netaddr.strategy" class="py-name" href="#" onclick="return doclink('link-1018', 'strategy', 'link-10');">strategy</a></tt><tt class="py-op">.</tt><tt id="link-1019" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-1019', 'int_to_words', 'link-169');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-1020" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-1020', 'last', 'link-372');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2198"></a><tt class="py-lineno">2198</tt> <tt class="py-line"> </tt> +<a name="L2199"></a><tt class="py-lineno">2199</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L2200"></a><tt class="py-lineno">2200</tt> <tt class="py-line"> </tt> +<a name="L2201"></a><tt class="py-lineno">2201</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L2202"></a><tt class="py-lineno">2202</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L2203"></a><tt class="py-lineno">2203</tt> <tt class="py-line"> </tt> +<a name="L2204"></a><tt class="py-lineno">2204</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">4</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2205"></a><tt class="py-lineno">2205</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> +<a name="L2206"></a><tt class="py-lineno">2206</tt> <tt class="py-line"> <tt class="py-comment"># A normal octet.</tt> </tt> +<a name="L2207"></a><tt class="py-lineno">2207</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2208"></a><tt class="py-lineno">2208</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-op">(</tt><tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-number">255</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2209"></a><tt class="py-lineno">2209</tt> <tt class="py-line"> <tt class="py-comment"># An asterisk octet.</tt> </tt> +<a name="L2210"></a><tt class="py-lineno">2210</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'*'</tt><tt class="py-op">)</tt> </tt> +<a name="L2211"></a><tt class="py-lineno">2211</tt> <tt class="py-line"> <tt class="py-name">seen_asterisk</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L2212"></a><tt class="py-lineno">2212</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L2213"></a><tt class="py-lineno">2213</tt> <tt class="py-line"> <tt class="py-comment"># Create a hyphenated octet - only one allowed per wildcard.</tt> </tt> +<a name="L2214"></a><tt class="py-lineno">2214</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_asterisk</tt><tt class="py-op">:</tt> </tt> +<a name="L2215"></a><tt class="py-lineno">2215</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">seen_hyphen</tt><tt class="py-op">:</tt> </tt> +<a name="L2216"></a><tt class="py-lineno">2216</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'%s-%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">t1</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">t2</tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2217"></a><tt class="py-lineno">2217</tt> <tt class="py-line"> <tt class="py-name">seen_hyphen</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L2218"></a><tt class="py-lineno">2218</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L2219"></a><tt class="py-lineno">2219</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-1021" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-1021', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'only one hyphenated octet '</tt> \ </tt> +<a name="L2220"></a><tt class="py-lineno">2220</tt> <tt class="py-line"> <tt class="py-string">' per wildcard allowed!'</tt><tt class="py-op">)</tt> </tt> +<a name="L2221"></a><tt class="py-lineno">2221</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L2222"></a><tt class="py-lineno">2222</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-1022" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-1022', 'AddrFormatError', 'link-1');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'asterisks not permitted before '</tt> \ </tt> +<a name="L2223"></a><tt class="py-lineno">2223</tt> <tt class="py-line"> <tt class="py-string">'hyphenated octets!'</tt><tt class="py-op">)</tt> </tt> +<a name="L2224"></a><tt class="py-lineno">2224</tt> <tt class="py-line"> </tt> +<a name="L2225"></a><tt class="py-lineno">2225</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> +</div><a name="L2226"></a><tt class="py-lineno">2226</tt> <tt class="py-line"> </tt> +<a name="Wildcard.__repr__"></a><div id="Wildcard.__repr__-def"><a name="L2227"></a><tt class="py-lineno">2227</tt> <a class="py-toggle" href="#" id="Wildcard.__repr__-toggle" onclick="return toggle('Wildcard.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.Wildcard-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="Wildcard.__repr__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="Wildcard.__repr__-expanded"><a name="L2228"></a><tt class="py-lineno">2228</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object."""</tt> </tt> +<a name="L2229"></a><tt class="py-lineno">2229</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s(%r)"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L2230"></a><tt class="py-lineno">2230</tt> <tt class="py-line"> </tt> +<a name="L2231"></a><tt class="py-lineno">2231</tt> <tt class="py-line"> </tt> +<a name="L2232"></a><tt class="py-lineno">2232</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IPRangeSet"></a><div id="IPRangeSet-def"><a name="L2233"></a><tt class="py-lineno">2233</tt> <a class="py-toggle" href="#" id="IPRangeSet-toggle" onclick="return toggle('IPRangeSet');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.address.IPRangeSet-class.html">IPRangeSet</a><tt class="py-op">(</tt><tt class="py-base-class">set</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRangeSet-collapsed" style="display:none;" pad="++++" indent="++++"></div><div id="IPRangeSet-expanded"><a name="L2234"></a><tt class="py-lineno">2234</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2235"></a><tt class="py-lineno">2235</tt> <tt class="py-line"><tt class="py-docstring"> B{*EXPERIMENTAL*} A customised Python set class that deals with collections</tt> </tt> +<a name="L2236"></a><tt class="py-lineno">2236</tt> <tt class="py-line"><tt class="py-docstring"> of IPRange class and subclass instances.</tt> </tt> +<a name="L2237"></a><tt class="py-lineno">2237</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="IPRangeSet.__init__"></a><div id="IPRangeSet.__init__-def"><a name="L2238"></a><tt class="py-lineno">2238</tt> <a class="py-toggle" href="#" id="IPRangeSet.__init__-toggle" onclick="return toggle('IPRangeSet.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRangeSet-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addrs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRangeSet.__init__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRangeSet.__init__-expanded"><a name="L2239"></a><tt class="py-lineno">2239</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2240"></a><tt class="py-lineno">2240</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L2241"></a><tt class="py-lineno">2241</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2242"></a><tt class="py-lineno">2242</tt> <tt class="py-line"><tt class="py-docstring"> @param addrs: A sequence of IPRange class/subclass instances used to</tt> </tt> +<a name="L2243"></a><tt class="py-lineno">2243</tt> <tt class="py-line"><tt class="py-docstring"> pre-populate the set. Individual CIDR objects can be added and</tt> </tt> +<a name="L2244"></a><tt class="py-lineno">2244</tt> <tt class="py-line"><tt class="py-docstring"> removed after instantiation with the usual set methods, add() and</tt> </tt> +<a name="L2245"></a><tt class="py-lineno">2245</tt> <tt class="py-line"><tt class="py-docstring"> remove().</tt> </tt> +<a name="L2246"></a><tt class="py-lineno">2246</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2247"></a><tt class="py-lineno">2247</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">addr</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addrs</tt><tt class="py-op">:</tt> </tt> +<a name="L2248"></a><tt class="py-lineno">2248</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt id="link-1023" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-1023', 'IP', 'link-76');">IP</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2249"></a><tt class="py-lineno">2249</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">add</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">.</tt><tt id="link-1024" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-1024', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2250"></a><tt class="py-lineno">2250</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L2251"></a><tt class="py-lineno">2251</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L2252"></a><tt class="py-lineno">2252</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">add</tt><tt class="py-op">(</tt><tt id="link-1025" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-1025', 'CIDR', 'link-354');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2253"></a><tt class="py-lineno">2253</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L2254"></a><tt class="py-lineno">2254</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L2255"></a><tt class="py-lineno">2255</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L2256"></a><tt class="py-lineno">2256</tt> <tt class="py-line"> <tt id="link-1026" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-1026', 'ip', 'link-75');">ip</a></tt> <tt class="py-op">=</tt> <tt id="link-1027" class="py-name"><a title="netaddr.address.IP" class="py-name" href="#" onclick="return doclink('link-1027', 'IP', 'link-76');">IP</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L2257"></a><tt class="py-lineno">2257</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">add</tt><tt class="py-op">(</tt><tt id="link-1028" class="py-name"><a title="netaddr.ip" class="py-name" href="#" onclick="return doclink('link-1028', 'ip', 'link-75');">ip</a></tt><tt class="py-op">.</tt><tt id="link-1029" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-1029', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2258"></a><tt class="py-lineno">2258</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L2259"></a><tt class="py-lineno">2259</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L2260"></a><tt class="py-lineno">2260</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L2261"></a><tt class="py-lineno">2261</tt> <tt class="py-line"> <tt id="link-1030" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-1030', 'wildcard', 'link-361');">wildcard</a></tt> <tt class="py-op">=</tt> <tt id="link-1031" class="py-name"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-1031', 'Wildcard', 'link-457');">Wildcard</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L2262"></a><tt class="py-lineno">2262</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L2263"></a><tt class="py-lineno">2263</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">add</tt><tt class="py-op">(</tt><tt id="link-1032" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-1032', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">.</tt><tt id="link-1033" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-1033', 'cidr', 'link-434');">cidr</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L2264"></a><tt class="py-lineno">2264</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L2265"></a><tt class="py-lineno">2265</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">add</tt><tt class="py-op">(</tt><tt id="link-1034" class="py-name"><a title="netaddr.address.IP.wildcard +netaddr.address.IPRange.wildcard" class="py-name" href="#" onclick="return doclink('link-1034', 'wildcard', 'link-361');">wildcard</a></tt><tt class="py-op">)</tt> </tt> +<a name="L2266"></a><tt class="py-lineno">2266</tt> <tt class="py-line"> <tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L2267"></a><tt class="py-lineno">2267</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L2268"></a><tt class="py-lineno">2268</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L2269"></a><tt class="py-lineno">2269</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">add</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +</div><a name="L2270"></a><tt class="py-lineno">2270</tt> <tt class="py-line"> </tt> +<a name="IPRangeSet.__contains__"></a><div id="IPRangeSet.__contains__-def"><a name="L2271"></a><tt class="py-lineno">2271</tt> <a class="py-toggle" href="#" id="IPRangeSet.__contains__-toggle" onclick="return toggle('IPRangeSet.__contains__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRangeSet-class.html#__contains__">__contains__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRangeSet.__contains__-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRangeSet.__contains__-expanded"><a name="L2272"></a><tt class="py-lineno">2272</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2273"></a><tt class="py-lineno">2273</tt> <tt class="py-line"><tt class="py-docstring"> @return: True if C{other} IP or IPRange class/subclass instance</tt> </tt> +<a name="L2274"></a><tt class="py-lineno">2274</tt> <tt class="py-line"><tt class="py-docstring"> matches any of the members in this IPRangeSet, False otherwise.</tt> </tt> +<a name="L2275"></a><tt class="py-lineno">2275</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2276"></a><tt class="py-lineno">2276</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">addr</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt> +<a name="L2277"></a><tt class="py-lineno">2277</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">other</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L2278"></a><tt class="py-lineno">2278</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +</div><a name="L2279"></a><tt class="py-lineno">2279</tt> <tt class="py-line"> </tt> +<a name="IPRangeSet.any_match"></a><div id="IPRangeSet.any_match-def"><a name="L2280"></a><tt class="py-lineno">2280</tt> <a class="py-toggle" href="#" id="IPRangeSet.any_match-toggle" onclick="return toggle('IPRangeSet.any_match');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRangeSet-class.html#any_match">any_match</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRangeSet.any_match-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRangeSet.any_match-expanded"><a name="L2281"></a><tt class="py-lineno">2281</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2282"></a><tt class="py-lineno">2282</tt> <tt class="py-line"><tt class="py-docstring"> @param other: An IP or IPRange class/subclass instance.</tt> </tt> +<a name="L2283"></a><tt class="py-lineno">2283</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2284"></a><tt class="py-lineno">2284</tt> <tt class="py-line"><tt class="py-docstring"> @return: The first IP or IPRange class/subclass instance object that</tt> </tt> +<a name="L2285"></a><tt class="py-lineno">2285</tt> <tt class="py-line"><tt class="py-docstring"> matches C{other} from any of the members in this IPRangeSet, None</tt> </tt> +<a name="L2286"></a><tt class="py-lineno">2286</tt> <tt class="py-line"><tt class="py-docstring"> otherwise.</tt> </tt> +<a name="L2287"></a><tt class="py-lineno">2287</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2288"></a><tt class="py-lineno">2288</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">addr</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt> +<a name="L2289"></a><tt class="py-lineno">2289</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">other</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L2290"></a><tt class="py-lineno">2290</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt> </tt> +</div><a name="L2291"></a><tt class="py-lineno">2291</tt> <tt class="py-line"> </tt> +<a name="IPRangeSet.all_matches"></a><div id="IPRangeSet.all_matches-def"><a name="L2292"></a><tt class="py-lineno">2292</tt> <a class="py-toggle" href="#" id="IPRangeSet.all_matches-toggle" onclick="return toggle('IPRangeSet.all_matches');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRangeSet-class.html#all_matches">all_matches</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRangeSet.all_matches-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRangeSet.all_matches-expanded"><a name="L2293"></a><tt class="py-lineno">2293</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2294"></a><tt class="py-lineno">2294</tt> <tt class="py-line"><tt class="py-docstring"> @param other: An IP or IPRange class/subclass instance.</tt> </tt> +<a name="L2295"></a><tt class="py-lineno">2295</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2296"></a><tt class="py-lineno">2296</tt> <tt class="py-line"><tt class="py-docstring"> @return: All IP or IPRange class/subclass instances matching C{other}</tt> </tt> +<a name="L2297"></a><tt class="py-lineno">2297</tt> <tt class="py-line"><tt class="py-docstring"> from this IPRangeSet, an empty list otherwise.</tt> </tt> +<a name="L2298"></a><tt class="py-lineno">2298</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2299"></a><tt class="py-lineno">2299</tt> <tt class="py-line"> <tt class="py-name">addrs</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L2300"></a><tt class="py-lineno">2300</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">addr</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">:</tt> </tt> +<a name="L2301"></a><tt class="py-lineno">2301</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">other</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L2302"></a><tt class="py-lineno">2302</tt> <tt class="py-line"> <tt class="py-name">addrs</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L2303"></a><tt class="py-lineno">2303</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addrs</tt> </tt> +</div><a name="L2304"></a><tt class="py-lineno">2304</tt> <tt class="py-line"> </tt> +<a name="IPRangeSet.min_match"></a><div id="IPRangeSet.min_match-def"><a name="L2305"></a><tt class="py-lineno">2305</tt> <a class="py-toggle" href="#" id="IPRangeSet.min_match-toggle" onclick="return toggle('IPRangeSet.min_match');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRangeSet-class.html#min_match">min_match</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRangeSet.min_match-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRangeSet.min_match-expanded"><a name="L2306"></a><tt class="py-lineno">2306</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2307"></a><tt class="py-lineno">2307</tt> <tt class="py-line"><tt class="py-docstring"> @param other: An IP or IPRange class/subclass instance.</tt> </tt> +<a name="L2308"></a><tt class="py-lineno">2308</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2309"></a><tt class="py-lineno">2309</tt> <tt class="py-line"><tt class="py-docstring"> @return: The smallest IP or IPRange class/subclass instance matching</tt> </tt> +<a name="L2310"></a><tt class="py-lineno">2310</tt> <tt class="py-line"><tt class="py-docstring"> C{other} from this IPRangeSet, None otherwise.</tt> </tt> +<a name="L2311"></a><tt class="py-lineno">2311</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2312"></a><tt class="py-lineno">2312</tt> <tt class="py-line"> <tt class="py-name">addrs</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-1035" class="py-name" targets="Method netaddr.address.IPRangeSet.all_matches()=netaddr.address.IPRangeSet-class.html#all_matches"><a title="netaddr.address.IPRangeSet.all_matches" class="py-name" href="#" onclick="return doclink('link-1035', 'all_matches', 'link-1035');">all_matches</a></tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">)</tt> </tt> +<a name="L2313"></a><tt class="py-lineno">2313</tt> <tt class="py-line"> <tt class="py-name">addrs</tt><tt class="py-op">.</tt><tt class="py-name">sort</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L2314"></a><tt class="py-lineno">2314</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addrs</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +</div><a name="L2315"></a><tt class="py-lineno">2315</tt> <tt class="py-line"> </tt> +<a name="L2316"></a><tt class="py-lineno">2316</tt> <tt class="py-line"> </tt> +<a name="IPRangeSet.max_match"></a><div id="IPRangeSet.max_match-def"><a name="L2317"></a><tt class="py-lineno">2317</tt> <a class="py-toggle" href="#" id="IPRangeSet.max_match-toggle" onclick="return toggle('IPRangeSet.max_match');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.address.IPRangeSet-class.html#max_match">max_match</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">other</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPRangeSet.max_match-collapsed" style="display:none;" pad="++++" indent="++++++++"></div><div id="IPRangeSet.max_match-expanded"><a name="L2318"></a><tt class="py-lineno">2318</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L2319"></a><tt class="py-lineno">2319</tt> <tt class="py-line"><tt class="py-docstring"> @param other: An IP or IPRange class/subclass instance.</tt> </tt> +<a name="L2320"></a><tt class="py-lineno">2320</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L2321"></a><tt class="py-lineno">2321</tt> <tt class="py-line"><tt class="py-docstring"> @return: The largest IP or IPRange class/subclass instance matching</tt> </tt> +<a name="L2322"></a><tt class="py-lineno">2322</tt> <tt class="py-line"><tt class="py-docstring"> C{other} from this IPRangeSet, None otherwise.</tt> </tt> +<a name="L2323"></a><tt class="py-lineno">2323</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L2324"></a><tt class="py-lineno">2324</tt> <tt class="py-line"> <tt class="py-name">addrs</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-1036" class="py-name"><a title="netaddr.address.IPRangeSet.all_matches" class="py-name" href="#" onclick="return doclink('link-1036', 'all_matches', 'link-1035');">all_matches</a></tt><tt class="py-op">(</tt><tt class="py-name">other</tt><tt class="py-op">)</tt> </tt> +<a name="L2325"></a><tt class="py-lineno">2325</tt> <tt class="py-line"> <tt class="py-name">addrs</tt><tt class="py-op">.</tt><tt class="py-name">sort</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L2326"></a><tt class="py-lineno">2326</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addrs</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +</div></div><a name="L2327"></a><tt class="py-lineno">2327</tt> <tt class="py-line"> </tt><script type="text/javascript"> <!-- expandto(location.href); // --> @@ -3118,7 +4050,7 @@ expandto(location.href); <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:25 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:24 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.Addr-class.html b/docs/api/netaddr.address.Addr-class.html index 3ea10f2..ca261de 100755 --- a/docs/api/netaddr.address.Addr-class.html +++ b/docs/api/netaddr.address.Addr-class.html @@ -118,7 +118,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__hash__" class="summary-sig-name">__hash__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The hash of this address.</td> + hash of this address suitable for dict keys, sets etc</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__hash__">source code</a></span> @@ -136,7 +136,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__int__" class="summary-sig-name">__int__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The value of this address as an network byte order integer.</td> + value of this address as a network byte order integer</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__int__">source code</a></span> @@ -154,7 +154,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__long__" class="summary-sig-name">__long__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The value of this address as an network byte order integer.</td> + value of this address as a network byte order integer</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__long__">source code</a></span> @@ -172,7 +172,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The common string representation for this address type.</td> + common string representation of this address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__str__">source code</a></span> @@ -190,8 +190,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - An executable Python statement that can recreate an object with an - equivalent state.</td> + executable Python string to recreate equivalent object</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__repr__">source code</a></span> @@ -209,7 +208,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#bits" class="summary-sig-name">bits</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - A human-readable binary digit string for this address type.</td> + human-readable binary digit string of this address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.bits">source code</a></span> @@ -225,9 +224,45 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#packed" class="summary-sig-name">packed</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + binary packed string of this address</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.packed">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#bin" class="summary-sig-name">bin</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + standard Python binary representation of this address.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.bin">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__len__" class="summary-sig-name">__len__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The size of this address (in bits).</td> + The size (width) of this address in bits</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__len__">source code</a></span> @@ -245,7 +280,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__iter__" class="summary-sig-name">__iter__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - An iterator over individual words in this address.</td> + An iterator over individual words in this address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__iter__">source code</a></span> @@ -264,7 +299,8 @@ object --+ <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__getitem__" class="summary-sig-name">__getitem__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">index</span>)</span><br /> Returns: - The integer value of the word indicated by index.</td> + The integer value of the word referenced by index (both positive and + negative).</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__getitem__">source code</a></span> @@ -283,7 +319,7 @@ object --+ <td><span class="summary-sig"><a name="__setitem__"></a><span class="summary-sig-name">__setitem__</span>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">index</span>, <span class="summary-sig-arg">value</span>)</span><br /> - Sets the value of the word of this address indicated by index.</td> + Sets the value of the word referenced by index in this address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__setitem__">source code</a></span> @@ -301,7 +337,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__hex__" class="summary-sig-name">__hex__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The value of this address as a network byte order hexadecimal number.</td> + network byte order hexadecimal string of this address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__hex__">source code</a></span> @@ -318,8 +354,8 @@ object --+ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__iadd__" class="summary-sig-name">__iadd__</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">i</span>)</span><br /> - Increments network address by specified value.</td> + <span class="summary-sig-arg">num</span>)</span><br /> + Increment value of network address by specified amount.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__iadd__">source code</a></span> @@ -336,8 +372,8 @@ object --+ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__isub__" class="summary-sig-name">__isub__</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">i</span>)</span><br /> - Decrements network address by specified value.</td> + <span class="summary-sig-arg">num</span>)</span><br /> + Decrement value of network address by specified amount.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__isub__">source code</a></span> @@ -353,11 +389,49 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__add__" class="summary-sig-name">__add__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + A new (potentially larger) Addr class/subclass instance.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__add__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__sub__" class="summary-sig-name">__sub__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + A new (potentially smaller) Addr class/subclass instance.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__sub__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__eq__" class="summary-sig-name">__eq__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: - <code>True</code> if this network address instance has the same - numerical value as another, <code>False</code> otherwise.</td> + <code>True</code> if this address is numerically the same as other, + <code>False</code> otherwise.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__eq__">source code</a></span> @@ -376,8 +450,8 @@ object --+ <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__ne__" class="summary-sig-name">__ne__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: - <code>True</code> if this network address instance does not have the - same numerical value as another, <code>False</code> otherwise.</td> + <code>True</code> if this address is not numerically the same other, + <code>False</code> otherwise.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__ne__">source code</a></span> @@ -396,8 +470,8 @@ object --+ <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__lt__" class="summary-sig-name">__lt__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: - <code>True</code> if this network address instance has a lower - numerical value than another, <code>False</code> otherwise.</td> + <code>True</code> if this address is numerically lower in value than + other, <code>False</code> otherwise.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__lt__">source code</a></span> @@ -416,9 +490,8 @@ object --+ <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__le__" class="summary-sig-name">__le__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: - <code>True</code> if this network address instance has a lower or - equivalent numerical value than another, <code>False</code> - otherwise.</td> + <code>True</code> if this address is numerically lower or equal in + value to other, <code>False</code> otherwise.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__le__">source code</a></span> @@ -437,8 +510,8 @@ object --+ <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__gt__" class="summary-sig-name">__gt__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: - <code>True</code> if this network address instance has a higher - numerical value than another, <code>False</code> otherwise.</td> + <code>True</code> if this address is numerically greater in value + than other, <code>False</code> otherwise.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__gt__">source code</a></span> @@ -457,9 +530,8 @@ object --+ <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__ge__" class="summary-sig-name">__ge__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: - <code>True</code> if this network address instance has a higher or - equivalent numerical value than another, <code>False</code> - otherwise.</td> + <code>True</code> if this address is numerically greater or equal in + value to other, <code>False</code> otherwise.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__ge__">source code</a></span> @@ -469,6 +541,120 @@ object --+ </td> </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__or__" class="summary-sig-name">__or__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + bitwise OR (x | y) of self.value with other.value.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__or__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__and__" class="summary-sig-name">__and__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + bitwise AND (x & y) of self.value with other.value.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__and__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__xor__" class="summary-sig-name">__xor__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + bitwise exclusive OR (x ^ y) of self.value with other.value.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__xor__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__lshift__" class="summary-sig-name">__lshift__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">numbits</span>)</span><br /> + Returns: + integer value of this IP address shifted left by x bits.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__lshift__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__rshift__" class="summary-sig-name">__rshift__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">numbits</span>)</span><br /> + Returns: + integer value of this IP address right shifted by x bits.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__rshift__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.Addr-class.html#__invert__" class="summary-sig-name">__invert__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + inversion (~x) of self.value.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__invert__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> <tr> <td colspan="2" class="summary"> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: @@ -494,10 +680,10 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.Addr-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False), - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False), - netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True), - netaddr.address.AddrStrategy(64, 8, '-', 64, True, True))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, F<code class="variable-ellipsis">...</code></code> + <a href="netaddr.address.Addr-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False), + netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False), + netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True), + netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 1<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> @@ -604,8 +790,7 @@ object --+ <p>hash(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>The hash of this address. Allows it to be used in sets and as a - key in dictionaries.</dd> + <dd>hash of this address suitable for dict keys, sets etc</dd> <dt>Overrides: object.__hash__ </dt> @@ -629,7 +814,7 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>The value of this address as an network byte order integer.</dd> + <dd>value of this address as a network byte order integer</dd> </dl> </td></tr></table> </div> @@ -650,7 +835,7 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>The value of this address as an network byte order integer.</dd> + <dd>value of this address as a network byte order integer</dd> </dl> </td></tr></table> </div> @@ -672,7 +857,7 @@ object --+ <p>str(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>The common string representation for this address type.</dd> + <dd>common string representation of this address</dd> <dt>Overrides: object.__str__ </dt> @@ -697,8 +882,7 @@ object --+ <p>repr(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>An executable Python statement that can recreate an object with - an equivalent state.</dd> + <dd>executable Python string to recreate equivalent object</dd> <dt>Overrides: object.__repr__ </dt> @@ -722,7 +906,51 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>A human-readable binary digit string for this address type.</dd> + <dd>human-readable binary digit string of this address</dd> + </dl> +</td></tr></table> +</div> +<a name="packed"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">packed</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.packed">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>binary packed string of this address</dd> + </dl> +</td></tr></table> +</div> +<a name="bin"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">bin</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.bin">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>standard Python binary representation of this address. A back + port of the format provided by the builtin bin() type available + in Python 2.6.x and higher.</dd> </dl> </td></tr></table> </div> @@ -744,7 +972,7 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>The size of this address (in bits).</dd> + <dd>The size (width) of this address in bits</dd> </dl> </td></tr></table> </div> @@ -765,7 +993,7 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>An iterator over individual words in this address.</dd> + <dd>An iterator over individual words in this address</dd> </dl> </td></tr></table> </div> @@ -788,9 +1016,10 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>The integer value of the word indicated by index. Raises an - <code>IndexError</code> if index is wrong size for address type. - Full slicing is also supported.</dd> + <dd>The integer value of the word referenced by index (both positive + and negative). Raises <code>IndexError</code> if index is out of + bounds. Also supports Python list slices for accessing word + groups.</dd> </dl> </td></tr></table> </div> @@ -811,8 +1040,7 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>The value of this address as a network byte order hexadecimal - number.</dd> + <dd>network byte order hexadecimal string of this address</dd> </dl> </td></tr></table> </div> @@ -824,17 +1052,21 @@ object --+ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">__iadd__</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">i</span>)</span> + <span class="sig-arg">num</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__iadd__">source code</a></span> </td> </tr></table> - <p>Increments network address by specified value.</p> - <p>If the result exceeds address type maximum, it rolls around the - minimum boundary.</p> + <p>Increment value of network address by specified amount. Behaves like + an unsigned integer, rolling over to zero when it reaches the maximum + value threshold.</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>num</code></strong> - size of increment</li> + </ul></dd> </dl> </td></tr></table> </div> @@ -846,17 +1078,75 @@ object --+ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">__isub__</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">i</span>)</span> + <span class="sig-arg">num</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__isub__">source code</a></span> </td> </tr></table> - <p>Decrements network address by specified value.</p> - <p>If the result exceeds address type minimum, it rolls around the - maximum boundary.</p> + <p>Decrement value of network address by specified amount. Behaves like + an unsigned integer, rolling over to maximum value when it goes below + zero.</p> + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>num</code></strong> - size of decrement</li> + </ul></dd> + </dl> +</td></tr></table> +</div> +<a name="__add__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__add__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + <br /><em class="fname">(Addition operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__add__">source code</a></span> + </td> + </tr></table> + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - an integer or int-like object.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>A new (potentially larger) Addr class/subclass instance.</dd> + </dl> +</td></tr></table> +</div> +<a name="__sub__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__sub__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + <br /><em class="fname">(Subtraction operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__sub__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - an integer or int-like object.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>A new (potentially smaller) Addr class/subclass instance.</dd> </dl> </td></tr></table> </div> @@ -879,8 +1169,8 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this network address instance has the same - numerical value as another, <code>False</code> otherwise.</dd> + <dd><code>True</code> if this address is numerically the same as + other, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> @@ -902,9 +1192,8 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this network address instance does not have - the same numerical value as another, <code>False</code> - otherwise.</dd> + <dd><code>True</code> if this address is not numerically the same + other, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> @@ -927,8 +1216,8 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this network address instance has a lower - numerical value than another, <code>False</code> otherwise.</dd> + <dd><code>True</code> if this address is numerically lower in value + than other, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> @@ -951,9 +1240,8 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this network address instance has a lower or - equivalent numerical value than another, <code>False</code> - otherwise.</dd> + <dd><code>True</code> if this address is numerically lower or equal + in value to other, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> @@ -976,8 +1264,8 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this network address instance has a higher - numerical value than another, <code>False</code> otherwise.</dd> + <dd><code>True</code> if this address is numerically greater in value + than other, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> @@ -1000,9 +1288,167 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this network address instance has a higher - or equivalent numerical value than another, <code>False</code> - otherwise.</dd> + <dd><code>True</code> if this address is numerically greater or equal + in value to other, <code>False</code> otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="__or__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__or__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + <br /><em class="fname">(Or operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__or__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - an integer or int-like object.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>bitwise OR (x | y) of self.value with other.value.</dd> + </dl> +</td></tr></table> +</div> +<a name="__and__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__and__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + <br /><em class="fname">(And operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__and__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - an integer or int-like object.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>bitwise AND (x & y) of self.value with other.value.</dd> + </dl> +</td></tr></table> +</div> +<a name="__xor__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__xor__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + <br /><em class="fname">(Exclusive-Or operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__xor__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - an integer or int-like object.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>bitwise exclusive OR (x ^ y) of self.value with other.value.</dd> + </dl> +</td></tr></table> +</div> +<a name="__lshift__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__lshift__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">numbits</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__lshift__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>numbits</code></strong> - size of shift (in bits).</li> + </ul></dd> + <dt>Returns:</dt> + <dd>integer value of this IP address shifted left by x bits.</dd> + </dl> +</td></tr></table> +</div> +<a name="__rshift__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__rshift__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">numbits</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__rshift__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>numbits</code></strong> - size of shift (in bits).</li> + </ul></dd> + <dt>Returns:</dt> + <dd>integer value of this IP address right shifted by x bits.</dd> + </dl> +</td></tr></table> +</div> +<a name="__invert__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__invert__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#Addr.__invert__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - an integer or int-like object.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>inversion (~x) of self.value.</dd> </dl> </td></tr></table> </div> @@ -1028,10 +1474,10 @@ object --+ <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)<code class="variable-op">,</code> - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)<code class="variable-op">,</code> - netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True)<code class="variable-op">,</code> - netaddr.address.AddrStrategy(64, 8, '-', 64, True, True)<code class="variable-group">)</code> +<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False)<code class="variable-op">,</code> + netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False)<code class="variable-op">,</code> + netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True)<code class="variable-op">,</code> + netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)<code class="variable-group">)</code> </pre></td></tr></table> </dd> </dl> @@ -1069,7 +1515,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.AddrTypeDescriptor-class.html b/docs/api/netaddr.address.AddrTypeDescriptor-class.html index 11e1eb3..d7bb8e8 100644 --- a/docs/api/netaddr.address.AddrTypeDescriptor-class.html +++ b/docs/api/netaddr.address.AddrTypeDescriptor-class.html @@ -216,7 +216,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.AddrValueDescriptor-class.html b/docs/api/netaddr.address.AddrValueDescriptor-class.html index b3810bc..eaccd78 100644 --- a/docs/api/netaddr.address.AddrValueDescriptor-class.html +++ b/docs/api/netaddr.address.AddrValueDescriptor-class.html @@ -219,7 +219,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.CIDR-class.html b/docs/api/netaddr.address.CIDR-class.html index 579bf70..16e94b7 100755 --- a/docs/api/netaddr.address.CIDR-class.html +++ b/docs/api/netaddr.address.CIDR-class.html @@ -63,62 +63,82 @@ <pre class="base-tree"> object --+ | - <a href="netaddr.address.AddrRange-class.html">AddrRange</a> --+ + <a href="netaddr.address.IPRange-class.html">IPRange</a> --+ | <strong class="uidshort">CIDR</strong> </pre> <hr /> -<p>A block of contiguous IPv4 or IPv6 network addresses defined by a base - network address and a bitmask prefix or subnet mask address indicating - the size/extent of the subnet.</p> - <p>By default, this class does not allow any non-zero bits to be set - right of the bitmask when it is applied to the supplied base address. - Doing so raises an <a href="netaddr.AddrFormatError-class.html" - class="link">AddrFormatError</a> exception. However, it is now - configurable and will allow a less strict base address if you ask for - one. Be aware though that the bitmask will be applied to the base address - and and trailing non-zero bits removed losing the original address. It - will *not* be preserved!</p> - <p>Contrast this behaviour with the <a - href="netaddr.address.IP-class.html" class="link">IP</a> class which is - less strict and has a cidr() method for returning CIDR objects without - any loss of information.</p> - <p>Examples of supported formats :-</p> - <ol start="1"> - <li> - CIDR address format - - <code><address>/<mask_length></code>: +<p>Represents blocks of IPv4 and IPv6 addresses using CIDR (Classless + Inter-Domain Routing) notation.</p> + <p>CIDR is a method of categorising contiguous blocks of both IPv4 and + IPv6 addresses. It is very scalable allowing for the optimal usage of the + IP address space. It permits the aggregation of networks via route + summarisation (supernetting) where adjacent routes can be combined into a + single route easily. This greatly assists in the reduction of routing + table sizes and improves network router efficiency.</p> + <p>CIDR blocks are represented by a base network address and a prefix + indicating the size of the (variable length) subnet mask. These are + separated by a single '/' character. Subnet sizes increase in powers of + base 2 aligning to bit boundaries.</p> + <p>It is technically invalid to have non-zero bits in a CIDR address to + the right of the implied netmask. For user convenience this is however + configurable and can be disabled using a constructor argument.</p> + <p>The constructor accepts CIDRs expressed in one of 4 different ways + :-</p> + <p>A) Standard CIDR format :-</p> + <p>IPv4:</p> <pre class="literalblock"> - 192.168.0.0/16 - fe80::/64 + x.x.x.x/y -> 192.0.2.0/24 </pre> - </li> - <li> - Address and subnet mask combo : + <p>where the x's represent the network address and y is the netmask + prefix between 0 and 32.</p> + <p>IPv6:</p> <pre class="literalblock"> - 192.168.0.0/255.255.0.0 == 192.168.0.0/16 - fe80::/ffff:ffff:ffff:ffff:: == fe80::/64 + x::/y -> fe80::/10 </pre> - </li> - <li> - Partial or abbreviated formats (IPv4 only). Prefixes may be omitted - and in this case older class-based default prefixes apply : + <p>where the x's represent the network address and y is the netmask + prefix between 0 and 128.</p> + <p>B) Abbreviated CIDR format (IPv4 only):</p> <pre class="literalblock"> -10 == 10.0.0.0/8 -10.0 == 10.0.0.0/8 -10/8 == 10.0.0.0/8 - -128 == 128.0.0.0/16 -128.0 == 128.0.0.0/16 -128/16 == 128.0.0.0/16 + x -> 192 + x/y -> 10/8 + x.x/y -> 192.168/16 + x.x.x/y -> 192.168.0/24 +</pre> + <p>which are equivalent to:</p> +<pre class="literalblock"> + x.0.0.0/y -> 192.0.0.0/24 + x.0.0.0/y -> 10.0.0.0/8 + x.x.0.0/y -> 192.168.0.0/16 + x.x.x.0/y -> 192.168.0.0/24 -192 == 10.0.0.0/24 -192.168.0 == 192.168.0.0/24 -192.168/16 == 192.168.0.0/16 + - The trailing zeros are implicit. + - Old classful IP address rules apply if y is omitted. +</pre> + <p>C) Hybrid CIDR format (prefix replaced by netmask) :-</p> + <p>IPv4:</p> +<pre class="literalblock"> + x.x.x.x/y.y.y.y -> 192.0.2.0/255.255.255.0 </pre> - </li> - </ol> + <p>IPv6:</p> +<pre class="literalblock"> + x::/y:: -> fe80::/ffc0:: +</pre> + <p>where the y's represent a valid netmask.</p> + <p>D) ACL-style CIDR format (prefix is replaced by a hostmask) :-</p> + <p>Akin to Cisco's ACL (Access Control List) bitmasking (reverse + netmasks).</p> + <p>IPv4:</p> +<pre class="literalblock"> + x.x.x.x/y.y.y.y -> 192.0.2.0/0.0.0.255 +</pre> + <p>IPv6:</p> +<pre class="literalblock"> + x::/y:: -> fe80::/3f:ffff:ffff:ffff:ffff:ffff:ffff:ffff +</pre> + <p>where the y's represent a valid hostmask.</p> + <p>Reference: RFCs 1338 and 4632.</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -136,8 +156,8 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">cidr</span>, - <span class="summary-sig-arg">klass</span>=<span class="summary-sig-default"><class 'netaddr.address.IP'></span>, - <span class="summary-sig-arg">strict_bitmask</span>=<span class="summary-sig-default">True</span>)</span><br /> + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default"><class 'netaddr.address.IP'></span>, + <span class="summary-sig-arg">strict</span>=<span class="summary-sig-default">True</span>)</span><br /> Constructor.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.__init__">source code</a></span> @@ -172,11 +192,12 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#netmask" class="summary-sig-name">netmask</a>(<span class="summary-sig-arg">self</span>)</span><br /> - Returns: - The subnet mask address of this CIDR range.</td> + <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#__add__" class="summary-sig-name">__add__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Add another CIDR to this one returning a CIDR supernet that will + contain both in the smallest possible sized range.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.netmask">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.__add__">source code</a></span> </td> </tr> @@ -190,11 +211,14 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#hostmask" class="summary-sig-name">hostmask</a>(<span class="summary-sig-arg">self</span>)</span><br /> - Returns: - The host mask address of this CIDR range.</td> + <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#subnet" class="summary-sig-name">subnet</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">prefixlen</span>, + <span class="summary-sig-arg">count</span>=<span class="summary-sig-default">None</span>, + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default">None</span>)</span><br /> + A generator that returns CIDR subnets based on the current network + base address and provided CIDR prefix and count.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.hostmask">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.subnet">source code</a></span> </td> </tr> @@ -208,10 +232,12 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> - str(x)</td> + <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#cidrs" class="summary-sig-name">cidrs</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A list of a copy of this <a href="netaddr.address.CIDR-class.html" + class="link">CIDR</a> object.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.__str__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.cidrs">source code</a></span> </td> </tr> @@ -225,12 +251,10 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> - Returns: - An executable Python statement that can recreate an object with an - equivalent state.</td> + <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + str(x)</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.__repr__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.__str__">source code</a></span> </td> </tr> @@ -244,12 +268,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#wildcard" class="summary-sig-name">wildcard</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - A <a href="netaddr.address.Wildcard-class.html" - class="link">Wildcard</a> object equivalent to this CIDR.</td> + executable Python string to recreate equivalent object.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.wildcard">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.__repr__">source code</a></span> </td> </tr> @@ -259,22 +282,28 @@ object --+ </tr> <tr> <td colspan="2" class="summary"> - <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.AddrRange-class.html">AddrRange</a></code></b>: - <code><a href="netaddr.address.AddrRange-class.html#__contains__">__contains__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__eq__">__eq__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__ge__">__ge__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__getitem__">__getitem__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__gt__">__gt__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__hash__">__hash__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__iadd__">__iadd__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__isub__">__isub__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__iter__">__iter__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__le__">__le__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__len__">__len__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__lt__">__lt__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__ne__">__ne__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#data_flavour">data_flavour</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#size">size</a></code> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.IPRange-class.html">IPRange</a></code></b>: + <code><a href="netaddr.address.IPRange-class.html#__contains__">__contains__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__eq__">__eq__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__ge__">__ge__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__getitem__">__getitem__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__gt__">__gt__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__hash__">__hash__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__iadd__">__iadd__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__isub__">__isub__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__iter__">__iter__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__le__">__le__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__len__">__len__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__lt__">__lt__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__ne__">__ne__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#adjacent">adjacent</a></code>, + <code><a href="netaddr.address.IPRange-class.html#format">format</a></code>, + <code><a href="netaddr.address.IPRange-class.html#iprange">iprange</a></code>, + <code><a href="netaddr.address.IPRange-class.html#issubnet">issubnet</a></code>, + <code><a href="netaddr.address.IPRange-class.html#issupernet">issupernet</a></code>, + <code><a href="netaddr.address.IPRange-class.html#overlaps">overlaps</a></code>, + <code><a href="netaddr.address.IPRange-class.html#size">size</a></code>, + <code><a href="netaddr.address.IPRange-class.html#wildcard">wildcard</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -302,8 +331,8 @@ object --+ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#abbrev_to_verbose" class="summary-sig-name">abbrev_to_verbose</a>(<span class="summary-sig-arg">abbrev_cidr</span>)</span><br /> - A statis method that converts abbreviated CIDR addresses into their - verbose form.</td> + A static method that converts abbreviated IPv4 CIDRs to their more + verbose equivalent.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.abbrev_to_verbose">source code</a></span> @@ -313,6 +342,27 @@ object --+ </td> </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.CIDR-class.html#span" class="summary-sig-name">span</a>(<span class="summary-sig-arg">addrs</span>, + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default">None</span>)</span><br /> + Static method that accepts a sequence of IP addresses and/or CIDRs, + Wildcards and IPRanges returning a single CIDR that is large enough + to span the lowest and highest IP addresses in the sequence (with a + possible overlap on either end).</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.span">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> </table> <!-- ==================== CLASS VARIABLES ==================== --> <a name="section-ClassVariables"></a> @@ -326,15 +376,14 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.CIDR-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False), - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, F<code class="variable-ellipsis">...</code></code> + <a name="STRATEGIES"></a><span class="summary-name">STRATEGIES</span> = <code title="ST_IPV4, ST_IPV6">ST_IPV4, ST_IPV6</code> </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a name="ADDR_TYPES"></a><span class="summary-name">ADDR_TYPES</span> = <code title="(0, 4, 6)"><code class="variable-group">(</code>0<code class="variable-op">, </code>4<code class="variable-op">, </code>6<code class="variable-group">)</code></code> + <a name="ADDR_TYPES"></a><span class="summary-name">ADDR_TYPES</span> = <code title="AT_UNSPEC, AT_INET, AT_INET6">AT_UNSPEC, AT_INET, AT_INET6</code> </td> </tr> <tr> @@ -362,14 +411,14 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a name="klass"></a><span class="summary-name">klass</span> = <code title="KlassDescriptor(IP)">KlassDescriptor(IP)</code> + <a name="fmt"></a><span class="summary-name">fmt</span> = <code title="FormatDescriptor(IP)">FormatDescriptor(IP)</code> </td> </tr> <tr> <td colspan="2" class="summary"> - <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.AddrRange-class.html">AddrRange</a></code></b>: - <code><a href="netaddr.address.AddrRange-class.html#first">first</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#last">last</a></code> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.IPRange-class.html">IPRange</a></code></b>: + <code><a href="netaddr.address.IPRange-class.html#first">first</a></code>, + <code><a href="netaddr.address.IPRange-class.html#last">last</a></code> </p> </td> </tr> @@ -382,6 +431,38 @@ object --+ <td align="left" colspan="2" class="table-header"> <span class="table-header">Properties</span></td> </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.address.CIDR-class.html#network" class="summary-name">network</a> + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.address.CIDR-class.html#broadcast" class="summary-name">broadcast</a><br /> + <b>Please Note:</b> although IPv6 doesn't actually recognise the + concept of a 'broadcast' address as the last address in a subnet (as + in IPv4) so many other libraries do this that it isn't worth trying + to resist. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.address.CIDR-class.html#netmask" class="summary-name">netmask</a> + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.address.CIDR-class.html#hostmask" class="summary-name">hostmask</a> + </td> + </tr> <tr> <td colspan="2" class="summary"> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: @@ -414,12 +495,12 @@ object --+ </td> </tr></table> - <p>A statis method that converts abbreviated CIDR addresses into their - verbose form.</p> + <p>A static method that converts abbreviated IPv4 CIDRs to their more + verbose equivalent.</p> <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>abbrev_cidr</code></strong> - an abbreviated CIDR network address. + <li><strong class="pname"><code>abbrev_cidr</code></strong> - an abbreviated CIDR. <p>Uses the old-style classful IP address rules to decide on a default subnet prefix if one is not explicitly provided.</p> <p>Only supports IPv4 addresses.</p> @@ -439,6 +520,40 @@ object --+ </dl> </td></tr></table> </div> +<a name="span"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">span</span>(<span class="sig-arg">addrs</span>, + <span class="sig-arg">fmt</span>=<span class="sig-default">None</span>)</span> + <br /><em class="fname">Static Method</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.span">source code</a></span> + </td> + </tr></table> + + <p>Static method that accepts a sequence of IP addresses and/or CIDRs, + Wildcards and IPRanges returning a single CIDR that is large enough to + span the lowest and highest IP addresses in the sequence (with a possible + overlap on either end).</p> + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>addrs</code></strong> - a sequence of IP, CIDR, Wildcard or IPRange objects and/or their + string representations.</li> + <li><strong class="pname"><code>fmt</code></strong> - (optional) callable used on return values. (Default: None - <a + href="netaddr.address.CIDR-class.html" class="link">CIDR</a> + object) Also accepts str() and unicode().</li> + </ul></dd> + <dt>Returns:</dt> + <dd>a single CIDR object spanning all addresses.</dd> + </dl> +</td></tr></table> +</div> <a name="__init__"></a> <div> <table class="details" border="1" cellpadding="3" @@ -448,8 +563,8 @@ object --+ <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, <span class="sig-arg">cidr</span>, - <span class="sig-arg">klass</span>=<span class="sig-default"><class 'netaddr.address.IP'></span>, - <span class="sig-arg">strict_bitmask</span>=<span class="sig-default">True</span>)</span> + <span class="sig-arg">fmt</span>=<span class="sig-default"><class 'netaddr.address.IP'></span>, + <span class="sig-arg">strict</span>=<span class="sig-default">True</span>)</span> <br /><em class="fname">(Constructor)</em> </h3> </td><td align="right" valign="top" @@ -463,13 +578,12 @@ object --+ <dd><ul class="nomargin-top"> <li><strong class="pname"><code>cidr</code></strong> - a valid IPv4/IPv6 CIDR address or abbreviated IPv4 network address.</li> - <li><strong class="pname"><code>klass</code></strong> - (optional) type, BIF or class used to create each object - returned. Default: <a href="netaddr.address.IP-class.html" - class="link">IP</a> class. See <a - href="netaddr.address-module.html#nrange" - class="link">nrange()</a> documentations for additional details - on options.</li> - <li><strong class="pname"><code>strict_bitmask</code></strong> - (optional) performs a test to ensure there are no non-zero bits + <li><strong class="pname"><code>fmt</code></strong> - (optional) callable used on return values. Default: <a + href="netaddr.address.IP-class.html" class="link">IP</a> class. + See <a href="netaddr.address-module.html#nrange" + class="link">nrange()</a> documentations for more details on the + various options.</li> + <li><strong class="pname"><code>strict</code></strong> - (optional) performs a test to ensure there are no non-zero bits to the right of the subnet mask or prefix when it is applied to the base address. (default: True)</li> </ul></dd> @@ -507,45 +621,92 @@ object --+ </dl> </td></tr></table> </div> -<a name="netmask"></a> +<a name="__add__"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">netmask</span>(<span class="sig-arg">self</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__add__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + <br /><em class="fname">(Addition operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.netmask">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.__add__">source code</a></span> </td> </tr></table> + <p>Add another CIDR to this one returning a CIDR supernet that will + contain both in the smallest possible sized range.</p> + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - a CIDR object.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>A new (potentially larger) CIDR object.</dd> + </dl> +</td></tr></table> +</div> +<a name="subnet"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">subnet</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">prefixlen</span>, + <span class="sig-arg">count</span>=<span class="sig-default">None</span>, + <span class="sig-arg">fmt</span>=<span class="sig-default">None</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.subnet">source code</a></span> + </td> + </tr></table> + <p>A generator that returns CIDR subnets based on the current network + base address and provided CIDR prefix and count.</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>prefixlen</code></strong> - a CIDR prefix.</li> + <li><strong class="pname"><code>count</code></strong> - number of consecutive CIDRs to be returned.</li> + <li><strong class="pname"><code>fmt</code></strong> - callable used on return values. Default: None - <a + href="netaddr.address.CIDR-class.html" class="link">CIDR</a> + objects. str() and unicode() supported.</li> + </ul></dd> <dt>Returns:</dt> - <dd>The subnet mask address of this CIDR range.</dd> + <dd>an iterator (as lists could potentially be very large) containing + CIDR subnets below this CIDR's base address.</dd> </dl> </td></tr></table> </div> -<a name="hostmask"></a> +<a name="cidrs"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">hostmask</span>(<span class="sig-arg">self</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">cidrs</span>(<span class="sig-arg">self</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.hostmask">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.cidrs">source code</a></span> </td> </tr></table> <dl class="fields"> <dt>Returns:</dt> - <dd>The host mask address of this CIDR range.</dd> + <dd>A list of a copy of this <a + href="netaddr.address.CIDR-class.html" class="link">CIDR</a> + object. This method is here mainly for compatibility with IPRange + interface.</dd> + <dt>Overrides: + <a href="netaddr.address.IPRange-class.html#cidrs">IPRange.cidrs</a> + </dt> </dl> </td></tr></table> </div> @@ -591,73 +752,89 @@ object --+ <p>repr(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>An executable Python statement that can recreate an object with - an equivalent state.</dd> + <dd>executable Python string to recreate equivalent object.</dd> <dt>Overrides: object.__repr__ </dt> </dl> </td></tr></table> </div> -<a name="wildcard"></a> +<br /> +<!-- ==================== PROPERTY DETAILS ==================== --> +<a name="section-PropertyDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Property Details</span></td> +</tr> +</table> +<a name="network"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">wildcard</span>(<span class="sig-arg">self</span>)</span> - </h3> - </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#CIDR.wildcard">source code</a></span> - </td> - </tr></table> - + <h3 class="epydoc">network</h3> <dl class="fields"> - <dt>Returns:</dt> - <dd>A <a href="netaddr.address.Wildcard-class.html" - class="link">Wildcard</a> object equivalent to this CIDR. - <ul> - <li> - If CIDR was initialised with <code>klass=str</code> a - wildcard string is returned, in all other cases a <a - href="netaddr.address.Wildcard-class.html" - class="link">Wildcard</a> object is returned. - </li> - <li> - Only supports IPv4 CIDR addresses. - </li> - </ul></dd> + <dt>Get Method:</dt> + <dd class="value"><span class="summary-sig"><i>unreachable</i>.network(<span class="summary-sig-arg">self</span>)</span> + - Returns: +The network (first) address in this CIDR block. + </dd> </dl> </td></tr></table> </div> -<br /> -<!-- ==================== CLASS VARIABLE DETAILS ==================== --> -<a name="section-ClassVariableDetails"></a> +<a name="broadcast"></a> +<div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> -<tr bgcolor="#70b0f0" class="table-header"> - <td align="left" colspan="2" class="table-header"> - <span class="table-header">Class Variable Details</span></td> -</tr> -</table> -<a name="STRATEGIES"></a> +<tr><td> + <h3 class="epydoc">broadcast</h3> + <p><b>Please Note:</b> although IPv6 doesn't actually recognise the + concept of a 'broadcast' address as the last address in a subnet (as in + IPv4) so many other libraries do this that it isn't worth trying to + resist. This issue raises so many user queries that it is easier to + dispense with the theory and be pragmatic instead.</p> + <dl class="fields"> + <dt>Get Method:</dt> + <dd class="value"><span class="summary-sig"><i>unreachable</i>.broadcast(<span class="summary-sig-arg">self</span>)</span> + - <b>Please Note:</b> although IPv6 doesn't actually recognise the concept of +a 'broadcast' address as the last address in a subnet (as in IPv4) so many +other libraries do this that it isn't worth trying to resist. + </dd> + </dl> +</td></tr></table> +</div> +<a name="netmask"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> - <h3 class="epydoc">STRATEGIES</h3> + <h3 class="epydoc">netmask</h3> <dl class="fields"> + <dt>Get Method:</dt> + <dd class="value"><span class="summary-sig"><i>unreachable</i>.netmask(<span class="summary-sig-arg">self</span>)</span> + - Returns: +The subnet mask address of this CIDR block. + </dd> </dl> +</td></tr></table> +</div> +<a name="hostmask"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">hostmask</h3> + <dl class="fields"> - <dt>Value:</dt> - <dd><table><tr><td><pre class="variable"> -<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)<code class="variable-op">,</code> - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)<code class="variable-group">)</code> -</pre></td></tr></table> -</dd> + <dt>Get Method:</dt> + <dd class="value"><span class="summary-sig"><i>unreachable</i>.hostmask(<span class="summary-sig-arg">self</span>)</span> + - Returns: +The host mask address of this CIDR block. + </dd> </dl> </td></tr></table> </div> @@ -693,7 +870,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.EUI-class.html b/docs/api/netaddr.address.EUI-class.html index 270cb0e..0f99e50 100755 --- a/docs/api/netaddr.address.EUI-class.html +++ b/docs/api/netaddr.address.EUI-class.html @@ -69,9 +69,9 @@ object --+ </pre> <hr /> -<p>EUI objects represent IEEE Extended Unique Identifiers. Input parsing - is flexible, supporting EUI-48, EUI-64 and all MAC (Media Access Control) - address flavours.</p> +<p>Represents an IEEE EUI (Extended Unique Identifier) indentifier.</p> + <p>Input parser is flexible, supporting EUI-48 (including the many Media + Access Control variants) and EUI-64.</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -106,7 +106,8 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#oui" class="summary-sig-name">oui</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#oui" class="summary-sig-name">oui</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default"><class 'netaddr.eui.OUI'></span>)</span><br /> Returns: The OUI (Organisationally Unique Identifier) for this EUI.</td> <td align="right" valign="top"> @@ -126,7 +127,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#ei" class="summary-sig-name">ei</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The EI (Extension Identifier) for this EUI.</td> + The EI (Extension Identifier) for this EUI</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#EUI.ei">source code</a></span> @@ -142,6 +143,44 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> + <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#isiab" class="summary-sig-name">isiab</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + True if this EUI is an IAB address, False otherwise</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#EUI.isiab">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#iab" class="summary-sig-name">iab</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default"><class 'netaddr.eui.IAB'></span>)</span><br /> + Returns: + If isiab() is True, the IAB (Individual Address Block) is returned, + None otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#EUI.iab">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#eui64" class="summary-sig-name">eui64</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: The value of this EUI object as a new 64-bit EUI object.</td> @@ -162,9 +201,10 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#ipv6_link_local" class="summary-sig-name">ipv6_link_local</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - An IPv6 <a href="netaddr.address.IP-class.html" class="link">IP</a> - object initialised using the value of this <a - href="netaddr.address.EUI-class.html" class="link">EUI</a>.</td> + new link local IPv6 <a href="netaddr.address.IP-class.html" + class="link">IP</a> object based on this <a + href="netaddr.address.EUI-class.html" class="link">EUI</a> using + technique described in RFC 4291.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#EUI.ipv6_link_local">source code</a></span> @@ -174,9 +214,30 @@ object --+ </td> </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.EUI-class.html#info" class="summary-sig-name">info</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A record dict containing IEEE registration details for this EUI + (MAC-48) if available, None otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#EUI.info">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> <tr> <td colspan="2" class="summary"> <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.Addr-class.html">Addr</a></code></b>: + <code><a href="netaddr.address.Addr-class.html#__add__">__add__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__and__">__and__</a></code>, <code><a href="netaddr.address.Addr-class.html#__eq__">__eq__</a></code>, <code><a href="netaddr.address.Addr-class.html#__ge__">__ge__</a></code>, <code><a href="netaddr.address.Addr-class.html#__getitem__">__getitem__</a></code>, @@ -185,17 +246,25 @@ object --+ <code><a href="netaddr.address.Addr-class.html#__hex__">__hex__</a></code>, <code><a href="netaddr.address.Addr-class.html#__iadd__">__iadd__</a></code>, <code><a href="netaddr.address.Addr-class.html#__int__">__int__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__invert__">__invert__</a></code>, <code><a href="netaddr.address.Addr-class.html#__isub__">__isub__</a></code>, <code><a href="netaddr.address.Addr-class.html#__iter__">__iter__</a></code>, <code><a href="netaddr.address.Addr-class.html#__le__">__le__</a></code>, <code><a href="netaddr.address.Addr-class.html#__len__">__len__</a></code>, <code><a href="netaddr.address.Addr-class.html#__long__">__long__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__lshift__">__lshift__</a></code>, <code><a href="netaddr.address.Addr-class.html#__lt__">__lt__</a></code>, <code><a href="netaddr.address.Addr-class.html#__ne__">__ne__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__or__">__or__</a></code>, <code><a href="netaddr.address.Addr-class.html#__repr__">__repr__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__rshift__">__rshift__</a></code>, <code><a href="netaddr.address.Addr-class.html#__setitem__">__setitem__</a></code>, <code><a href="netaddr.address.Addr-class.html#__str__">__str__</a></code>, - <code><a href="netaddr.address.Addr-class.html#bits">bits</a></code> + <code><a href="netaddr.address.Addr-class.html#__sub__">__sub__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__xor__">__xor__</a></code>, + <code><a href="netaddr.address.Addr-class.html#bin">bin</a></code>, + <code><a href="netaddr.address.Addr-class.html#bits">bits</a></code>, + <code><a href="netaddr.address.Addr-class.html#packed">packed</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -220,8 +289,8 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.EUI-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True), - netaddr.address.AddrStrategy(64, 8, '-', 64, True, True))"><code class="variable-group">(</code>netaddr.address.EUI48Strategy(48, 8, '-', 48, Tr<code class="variable-ellipsis">...</code></code> + <a href="netaddr.address.EUI-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True), + netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True))"><code class="variable-group">(</code>netaddr.address.EUI48Strategy(48, 8, '-', 48, 16<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> @@ -299,7 +368,8 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>addr</code></strong> - an EUI/MAC address string or a network byte order integer.</li> + <li><strong class="pname"><code>addr</code></strong> - an EUI-48 (MAC) or EUI-64 address string or a network byte order + integer.</li> <li><strong class="pname"><code>addr_type</code></strong> - (optional) the specific EUI address type (<code>AT_LINK</code> or <code>AT_EUI64</code>). If addr is an integer, this argument is mandatory.</li> @@ -317,7 +387,8 @@ object --+ <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">oui</span>(<span class="sig-arg">self</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">oui</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">fmt</span>=<span class="sig-default"><class 'netaddr.eui.OUI'></span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.address-pysrc.html#EUI.oui">source code</a></span> @@ -326,6 +397,12 @@ object --+ <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>fmt</code></strong> - callable used on return values. Default: <a + href="netaddr.eui.OUI-class.html" class="link">OUI</a> object. + Also Supports str(), unicode(), int() and long().</li> + </ul></dd> <dt>Returns:</dt> <dd>The OUI (Organisationally Unique Identifier) for this EUI.</dd> </dl> @@ -348,7 +425,57 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>The EI (Extension Identifier) for this EUI.</dd> + <dd>The EI (Extension Identifier) for this EUI</dd> + </dl> +</td></tr></table> +</div> +<a name="isiab"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">isiab</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#EUI.isiab">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>True if this EUI is an IAB address, False otherwise</dd> + </dl> +</td></tr></table> +</div> +<a name="iab"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">iab</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">fmt</span>=<span class="sig-default"><class 'netaddr.eui.IAB'></span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#EUI.iab">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>fmt</code></strong> - callable used on return values. Default: <a + href="netaddr.eui.IAB-class.html" class="link">IAB</a> object. + Also Supports str(), unicode(), int() and long().</li> + </ul></dd> + <dt>Returns:</dt> + <dd>If isiab() is True, the IAB (Individual Address Block) is + returned, None otherwise.</dd> </dl> </td></tr></table> </div> @@ -400,14 +527,34 @@ object --+ <dl class="fields"> <dt>Returns:</dt> - <dd>An IPv6 <a href="netaddr.address.IP-class.html" - class="link">IP</a> object initialised using the value of this <a - href="netaddr.address.EUI-class.html" class="link">EUI</a>. - <ul> - <li> - <b>See RFC 4921 for details</b>. - </li> - </ul></dd> + <dd>new link local IPv6 <a href="netaddr.address.IP-class.html" + class="link">IP</a> object based on this <a + href="netaddr.address.EUI-class.html" class="link">EUI</a> using + technique described in RFC 4291. <b>Please Note:</b> this + technique poses security risks in certain scenarios. Please read + RFC 4941 for details. Reference: RFCs 4291 and 4941.</dd> + </dl> +</td></tr></table> +</div> +<a name="info"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">info</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#EUI.info">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>A record dict containing IEEE registration details for this EUI + (MAC-48) if available, None otherwise.</dd> </dl> </td></tr></table> </div> @@ -433,8 +580,8 @@ object --+ <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -<code class="variable-group">(</code>netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True)<code class="variable-op">,</code> - netaddr.address.AddrStrategy(64, 8, '-', 64, True, True)<code class="variable-group">)</code> +<code class="variable-group">(</code>netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True)<code class="variable-op">,</code> + netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)<code class="variable-group">)</code> </pre></td></tr></table> </dd> </dl> @@ -472,7 +619,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.KlassDescriptor-class.html b/docs/api/netaddr.address.FormatDescriptor-class.html index c1066de..a59bd4a 100644 --- a/docs/api/netaddr.address.KlassDescriptor-class.html +++ b/docs/api/netaddr.address.FormatDescriptor-class.html @@ -3,7 +3,7 @@ "DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> - <title>netaddr.address.KlassDescriptor</title> + <title>netaddr.address.FormatDescriptor</title> <link rel="stylesheet" href="epydoc.css" type="text/css" /> <script type="text/javascript" src="epydoc.js"></script> </head> @@ -44,7 +44,7 @@ <span class="breadcrumbs"> <a href="netaddr-module.html">Package netaddr</a> :: <a href="netaddr.address-module.html" onclick="show_private();">Module address</a> :: - Class KlassDescriptor + Class FormatDescriptor </span> </td> <td> @@ -52,22 +52,22 @@ <!-- hide/show private --> <tr><td align="right"><span class="options" >[<a href="frames.html" target="_top">frames</a - >] | <a href="netaddr.address.KlassDescriptor-class.html" + >] | <a href="netaddr.address.FormatDescriptor-class.html" target="_top">no frames</a>]</span></td></tr> </table> </td> </tr> </table> <!-- ==================== CLASS DESCRIPTION ==================== --> -<h1 class="epydoc">Class KlassDescriptor</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.address-pysrc.html#KlassDescriptor">source code</a></span></p> +<h1 class="epydoc">Class FormatDescriptor</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.address-pysrc.html#FormatDescriptor">source code</a></span></p> <pre class="base-tree"> object --+ | - <strong class="uidshort">KlassDescriptor</strong> + <strong class="uidshort">FormatDescriptor</strong> </pre> <hr /> -<p>A descriptor that checks klass (data flavour) property assignments for +<p>A descriptor that checks formatter property assignments for validity.</p> <!-- ==================== INSTANCE METHODS ==================== --> @@ -84,11 +84,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.KlassDescriptor-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">default_klass</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.FormatDescriptor-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">default</span>)</span><br /> Constructor.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#KlassDescriptor.__init__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#FormatDescriptor.__init__">source code</a></span> </td> </tr> @@ -106,7 +106,7 @@ object --+ <span class="summary-sig-arg">instance</span>, <span class="summary-sig-arg">value</span>)</span></td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#KlassDescriptor.__set__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#FormatDescriptor.__set__">source code</a></span> </td> </tr> @@ -163,11 +163,11 @@ object --+ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">default_klass</span>)</span> + <span class="sig-arg">default</span>)</span> <br /><em class="fname">(Constructor)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#KlassDescriptor.__init__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#FormatDescriptor.__init__">source code</a></span> </td> </tr></table> @@ -175,7 +175,7 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>default_klass</code></strong> - the default class to use if klass property is set to None.</li> + <li><strong class="pname"><code>default</code></strong> - the default callable to use if the formatter property is None.</li> </ul></dd> <dt>Overrides: object.__init__ @@ -215,7 +215,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.IP-class.html b/docs/api/netaddr.address.IP-class.html index 01052d5..11989f7 100755 --- a/docs/api/netaddr.address.IP-class.html +++ b/docs/api/netaddr.address.IP-class.html @@ -69,20 +69,49 @@ object --+ </pre> <hr /> -<p>A class whose objects represent Internet Protocol network addresses. - Both IPv4 and IPv6 are fully supported and also permit the inclusion of - bitmask prefix or subnet mask address indicating the size/extent of the - subnet, for example :</p> +<p>Represents <b>individual</b> IPv4 and IPv6 addresses.</p> + <p><b>Please Note:</b> this class is intended to provide low-level + functionality to individual IP addresses such as octet/hextet access, + integer/hex/binary conversions, etc. If you are coming from other + libraries you may expect to find much higher level networking operations + here. While the inclusion of a bitmask prefix or netmask to indicate + subnet membership is permitted by the class constructor they are provided + only as a convenience to the user.</p> + <p>All higher level subnet and network operations can be found in objects + of classes <a href="netaddr.address.CIDR-class.html" + class="link">CIDR</a>, <a href="netaddr.address.IPRange-class.html" + class="link">IPRange</a> and <a + href="netaddr.address.Wildcard-class.html" class="link">Wildcard</a>. + There are handy helper methods here, (<code>.cidr()</code>, + <code>.iprange()</code> and <code>.wildcard()</code>) that return + pre-initialised objects of those classes without you having to call them + explicitly.</p> + <p>Example usage :</p> <pre class="literalblock"> - IPv4 + >>> ip = IP('10.0.0.1') + >>> list(ip) == [10, 0, 0, 1] + True + >>> ip += 1 + >>> str(ip) == '10.0.0.2' + True - 192.168.0.1/24 - 192.168.0.1/255.255.255.0 + >>> IP('10.0.0.0/28').iprange() + IPRange('10.0.0.0', '10.0.0.15') - IPv6 + >>> IP('10.0.0.64/24').cidr() + CIDR('10.0.0.0/24') - fe80::20f:1fff:fe12:e733/64 + >>> IP('192.168.0.1/255.255.253.0').wildcard() + Wildcard('192.168.0-1.*') + + >>> ipv6 = IP('fe80::20f:1fff:fe12:e733') + >>> ipv6[0:4] + [65152, 0, 0, 0] + + >>> IP('fe80::20f:1fff:fe12:e733/64').cidr() + CIDR('fe80::/64') </pre> + <p>See those classes for details on the functionality they provide.</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -139,8 +168,8 @@ object --+ <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#netmask_bits" class="summary-sig-name">netmask_bits</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: If this address is a valid netmask, the number of non-zero bits are - returned, otherwise it returns the width (in bits) for the given - address type (IPv4: 32, IPv6: 128).</td> + returned, otherwise it returns the width in bits for based on the + version, 32 for IPv4 and 128 for IPv6.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.netmask_bits">source code</a></span> @@ -158,7 +187,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#reverse_dns" class="summary-sig-name">reverse_dns</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The reverse DNS lookup string for this IP address.</td> + The reverse DNS lookup string for this IP address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.reverse_dns">source code</a></span> @@ -214,8 +243,8 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#cidr" class="summary-sig-name">cidr</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - A valid <a href="netaddr.address.CIDR-class.html" - class="link">CIDR</a> object for this IP address.</td> + A <a href="netaddr.address.CIDR-class.html" class="link">CIDR</a> + object based on this IP address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.cidr">source code</a></span> @@ -231,10 +260,48 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#wildcard" class="summary-sig-name">wildcard</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A <a href="netaddr.address.Wildcard-class.html" + class="link">Wildcard</a> object based on this IP address</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.wildcard">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#iprange" class="summary-sig-name">iprange</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A <a href="netaddr.address.CIDR-class.html" class="link">CIDR</a> + object based on this IP address</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.iprange">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#ipv4" class="summary-sig-name">ipv4</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - A new <a href="netaddr.address.IP-class.html" class="link">IP</a> - object numerically equivalent this address.</td> + A new version 4 <a href="netaddr.address.IP-class.html" + class="link">IP</a> object numerically equivalent this address.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.ipv4">source code</a></span> @@ -250,10 +317,10 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#ipv6" class="summary-sig-name">ipv6</a>(<span class="summary-sig-arg">self</span>)</span><br /> - Returns: - A new <a href="netaddr.address.IP-class.html" class="link">IP</a> - object numerically equivalent this address.</td> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#ipv6" class="summary-sig-name">ipv6</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">ipv4_compatible</span>=<span class="summary-sig-default">False</span>)</span><br /> + <b>Please Note:</b> the IPv4-Mapped IPv6 address format is now + considered deprecated.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.ipv6">source code</a></span> @@ -271,8 +338,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_unicast" class="summary-sig-name">is_unicast</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - <code>True</code> if this address is unicast, <code>False</code> - otherwise.</td> + <code>True</code> if this IP is unicast, <code>False</code> otherwise</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_unicast">source code</a></span> @@ -288,10 +354,29 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_loopback" class="summary-sig-name">is_loopback</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + <code>True</code> if this IP is loopback address (not for network + transmission), <code>False</code> otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_loopback">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_multicast" class="summary-sig-name">is_multicast</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - <code>True</code> if this address is multicast, <code>False</code> - otherwise.</td> + <code>True</code> if this IP is multicast, <code>False</code> + otherwise</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_multicast">source code</a></span> @@ -307,9 +392,122 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_private" class="summary-sig-name">is_private</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + <code>True</code> if this IP is for internal/private use only (i.e.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_private">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_link_local" class="summary-sig-name">is_link_local</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + <code>True</code> if this IP is link-local address <code>False</code> + otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_link_local">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_reserved" class="summary-sig-name">is_reserved</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + <code>True</code> if this IP is in IANA reserved range, + <code>False</code> otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_reserved">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_ipv4_mapped" class="summary-sig-name">is_ipv4_mapped</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + <code>True</code> if this IP is IPv4-compatible IPv6 address, + <code>False</code> otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_ipv4_mapped">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#is_ipv4_compat" class="summary-sig-name">is_ipv4_compat</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + <code>True</code> if this IP is IPv4-mapped IPv6 address, + <code>False</code> otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_ipv4_compat">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#info" class="summary-sig-name">info</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A record dict containing IANA registration details for this IP + address if available, None otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IP.info">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - The common string representation for this IP address.</td> + common string representation for this IP address</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.__str__">source code</a></span> @@ -327,8 +525,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.IP-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - An executable Python statement that can recreate an object with an - equivalent state.</td> + executable Python string to recreate equivalent object.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#IP.__repr__">source code</a></span> @@ -341,6 +538,8 @@ object --+ <tr> <td colspan="2" class="summary"> <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.Addr-class.html">Addr</a></code></b>: + <code><a href="netaddr.address.Addr-class.html#__add__">__add__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__and__">__and__</a></code>, <code><a href="netaddr.address.Addr-class.html#__eq__">__eq__</a></code>, <code><a href="netaddr.address.Addr-class.html#__ge__">__ge__</a></code>, <code><a href="netaddr.address.Addr-class.html#__getitem__">__getitem__</a></code>, @@ -349,15 +548,23 @@ object --+ <code><a href="netaddr.address.Addr-class.html#__hex__">__hex__</a></code>, <code><a href="netaddr.address.Addr-class.html#__iadd__">__iadd__</a></code>, <code><a href="netaddr.address.Addr-class.html#__int__">__int__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__invert__">__invert__</a></code>, <code><a href="netaddr.address.Addr-class.html#__isub__">__isub__</a></code>, <code><a href="netaddr.address.Addr-class.html#__iter__">__iter__</a></code>, <code><a href="netaddr.address.Addr-class.html#__le__">__le__</a></code>, <code><a href="netaddr.address.Addr-class.html#__len__">__len__</a></code>, <code><a href="netaddr.address.Addr-class.html#__long__">__long__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__lshift__">__lshift__</a></code>, <code><a href="netaddr.address.Addr-class.html#__lt__">__lt__</a></code>, <code><a href="netaddr.address.Addr-class.html#__ne__">__ne__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__or__">__or__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__rshift__">__rshift__</a></code>, <code><a href="netaddr.address.Addr-class.html#__setitem__">__setitem__</a></code>, - <code><a href="netaddr.address.Addr-class.html#bits">bits</a></code> + <code><a href="netaddr.address.Addr-class.html#__sub__">__sub__</a></code>, + <code><a href="netaddr.address.Addr-class.html#__xor__">__xor__</a></code>, + <code><a href="netaddr.address.Addr-class.html#bin">bin</a></code>, + <code><a href="netaddr.address.Addr-class.html#bits">bits</a></code>, + <code><a href="netaddr.address.Addr-class.html#packed">packed</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -382,8 +589,8 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.IP-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False), - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, F<code class="variable-ellipsis">...</code></code> + <a href="netaddr.address.IP-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False), + netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 1<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> @@ -429,6 +636,13 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <a name="prefixlen"></a><span class="summary-name">prefixlen</span> = <code title="PrefixLenDescriptor()">PrefixLenDescriptor()</code> </td> </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a name="_"></a><span class="summary-name">_</span> = <code title="255">255</code> + </td> + </tr> <tr> <td colspan="2" class="summary"> <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.Addr-class.html">Addr</a></code></b>: @@ -535,8 +749,8 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <dl class="fields"> <dt>Returns:</dt> <dd>If this address is a valid netmask, the number of non-zero bits - are returned, otherwise it returns the width (in bits) for the - given address type (IPv4: 32, IPv6: 128).</dd> + are returned, otherwise it returns the width in bits for based on + the version, 32 for IPv4 and 128 for IPv6.</dd> </dl> </td></tr></table> </div> @@ -557,7 +771,7 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <dl class="fields"> <dt>Returns:</dt> - <dd>The reverse DNS lookup string for this IP address.</dd> + <dd>The reverse DNS lookup string for this IP address</dd> </dl> </td></tr></table> </div> @@ -622,8 +836,52 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <dl class="fields"> <dt>Returns:</dt> - <dd>A valid <a href="netaddr.address.CIDR-class.html" - class="link">CIDR</a> object for this IP address.</dd> + <dd>A <a href="netaddr.address.CIDR-class.html" class="link">CIDR</a> + object based on this IP address</dd> + </dl> +</td></tr></table> +</div> +<a name="wildcard"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">wildcard</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.wildcard">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>A <a href="netaddr.address.Wildcard-class.html" + class="link">Wildcard</a> object based on this IP address</dd> + </dl> +</td></tr></table> +</div> +<a name="iprange"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">iprange</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.iprange">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>A <a href="netaddr.address.CIDR-class.html" class="link">CIDR</a> + object based on this IP address</dd> </dl> </td></tr></table> </div> @@ -644,23 +902,15 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <dl class="fields"> <dt>Returns:</dt> - <dd>A new <a href="netaddr.address.IP-class.html" class="link">IP</a> - object numerically equivalent this address. - <ul> - <li> - If its address type is IPv4. - </li> - <li> - If object's address type is IPv6 and its value is mappable to - IPv4, a new IPv4 <a href="netaddr.address.IP-class.html" - class="link">IP</a> object is returned instead. - </li> - <li> - Raises an <a href="netaddr.AddrConversionError-class.html" - class="link">AddrConversionError</a> if IPv6 address is not - mappable to IPv4. - </li> - </ul></dd> + <dd>A new version 4 <a href="netaddr.address.IP-class.html" + class="link">IP</a> object numerically equivalent this address. + If this object is already IPv4 then a copy is returned. If this + object is IPv6 and its value is compatible with IPv4, a new IPv4 + <a href="netaddr.address.IP-class.html" class="link">IP</a> + object is returned. + <p>Raises an <a href="netaddr.AddrConversionError-class.html" + class="link">AddrConversionError</a> is IPv6 address cannot be + converted.</p></dd> </dl> </td></tr></table> </div> @@ -671,32 +921,30 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">ipv6</span>(<span class="sig-arg">self</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">ipv6</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">ipv4_compatible</span>=<span class="sig-default">False</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.ipv6">source code</a></span> </td> </tr></table> - + <p><b>Please Note:</b> the IPv4-Mapped IPv6 address format is now + considered deprecated. Reference: RFC 4291</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>ipv4_compatible</code></strong> - If <code>True</code> returns an IPv4-Mapped address + (::ffff:x.x.x.x), an IPv4-Compatible (::x.x.x.x) address + otherwise. Default: False (IPv4-Mapped).</li> + </ul></dd> <dt>Returns:</dt> <dd>A new <a href="netaddr.address.IP-class.html" class="link">IP</a> - object numerically equivalent this address. - <ul> - <li> - If object's address type is IPv6. - </li> - <li> - If object's address type is IPv4 a new IPv6 <a - href="netaddr.address.IP-class.html" class="link">IP</a> - object, as a IPv4 mapped address is returned instead. Uses - the preferred IPv4 embedded in IPv6 form - - <code>::ffff:x.x.x.x</code> ('mapped' address) over the (now - deprecated) form - <code>::x.x.x.x</code> ('compatible' - address). <b>See RFC 4921 for details</b>. - </li> - </ul></dd> + version 6 object that is numerically equivalent this address. If + this object is already IPv6 then a copy of this object is + returned. If this object is IPv4, a new version 6 <a + href="netaddr.address.IP-class.html" class="link">IP</a> object + is returned.</dd> </dl> </td></tr></table> </div> @@ -717,8 +965,31 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this address is unicast, <code>False</code> - otherwise.</dd> + <dd><code>True</code> if this IP is unicast, <code>False</code> + otherwise</dd> + </dl> +</td></tr></table> +</div> +<a name="is_loopback"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">is_loopback</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_loopback">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd><code>True</code> if this IP is loopback address (not for network + transmission), <code>False</code> otherwise. References: RFC 3330 + and 4291.</dd> </dl> </td></tr></table> </div> @@ -739,11 +1010,144 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <dl class="fields"> <dt>Returns:</dt> - <dd><code>True</code> if this address is multicast, + <dd><code>True</code> if this IP is multicast, <code>False</code> + otherwise</dd> + </dl> +</td></tr></table> +</div> +<a name="is_private"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">is_private</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_private">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd><code>True</code> if this IP is for internal/private use only + (i.e. non-public), <code>False</code> otherwise. Reference: RFCs + 1918, 3330, 4193, 3879 and 2365.</dd> + </dl> +</td></tr></table> +</div> +<a name="is_link_local"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">is_link_local</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_link_local">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd><code>True</code> if this IP is link-local address + <code>False</code> otherwise. Reference: RFCs 3927 and 4291.</dd> + </dl> +</td></tr></table> +</div> +<a name="is_reserved"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">is_reserved</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_reserved">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd><code>True</code> if this IP is in IANA reserved range, + <code>False</code> otherwise. Reference: RFCs 3330 and 3171.</dd> + </dl> +</td></tr></table> +</div> +<a name="is_ipv4_mapped"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">is_ipv4_mapped</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_ipv4_mapped">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd><code>True</code> if this IP is IPv4-compatible IPv6 address, + <code>False</code> otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="is_ipv4_compat"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">is_ipv4_compat</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.is_ipv4_compat">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd><code>True</code> if this IP is IPv4-mapped IPv6 address, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> +<a name="info"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">info</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IP.info">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>A record dict containing IANA registration details for this IP + address if available, None otherwise.</dd> + </dl> +</td></tr></table> +</div> <a name="__str__"></a> <div> <table class="details" border="1" cellpadding="3" @@ -762,7 +1166,7 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <p>str(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>The common string representation for this IP address.</dd> + <dd>common string representation for this IP address</dd> <dt>Overrides: object.__str__ </dt> @@ -787,8 +1191,7 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <p>repr(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>An executable Python statement that can recreate an object with - an equivalent state.</dd> + <dd>executable Python string to recreate equivalent object.</dd> <dt>Overrides: object.__repr__ </dt> @@ -817,8 +1220,8 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)<code class="variable-op">,</code> - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)<code class="variable-group">)</code> +<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False)<code class="variable-op">,</code> + netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False)<code class="variable-group">)</code> </pre></td></tr></table> </dd> </dl> @@ -882,7 +1285,7 @@ xbb\xbc\xbd\xbe\xbf\xc0\xc1\xc2\xc3\xc4\xc5\xc6\xc7\xc8\xc9\xca\xcb\xc\ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.AddrRange-class.html b/docs/api/netaddr.address.IPRange-class.html index a6ef78a..9514013 100755..100644 --- a/docs/api/netaddr.address.AddrRange-class.html +++ b/docs/api/netaddr.address.IPRange-class.html @@ -3,7 +3,7 @@ "DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> - <title>netaddr.address.AddrRange</title> + <title>netaddr.address.IPRange</title> <link rel="stylesheet" href="epydoc.css" type="text/css" /> <script type="text/javascript" src="epydoc.js"></script> </head> @@ -44,7 +44,7 @@ <span class="breadcrumbs"> <a href="netaddr-module.html">Package netaddr</a> :: <a href="netaddr.address-module.html" onclick="show_private();">Module address</a> :: - Class AddrRange + Class IPRange </span> </td> <td> @@ -52,18 +52,18 @@ <!-- hide/show private --> <tr><td align="right"><span class="options" >[<a href="frames.html" target="_top">frames</a - >] | <a href="netaddr.address.AddrRange-class.html" + >] | <a href="netaddr.address.IPRange-class.html" target="_top">no frames</a>]</span></td></tr> </table> </td> </tr> </table> <!-- ==================== CLASS DESCRIPTION ==================== --> -<h1 class="epydoc">Class AddrRange</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange">source code</a></span></p> +<h1 class="epydoc">Class IPRange</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange">source code</a></span></p> <pre class="base-tree"> object --+ | - <strong class="uidshort">AddrRange</strong> + <strong class="uidshort">IPRange</strong> </pre> <dl><dt>Known Subclasses:</dt> @@ -73,17 +73,17 @@ object --+ </dd></dl> <hr /> -<p>A block of contiguous network addresses bounded by an arbitrary start - and stop address. There is no requirement that they fall on strict bit - mask boundaries, unlike <a href="netaddr.address.CIDR-class.html" - class="link">CIDR</a> addresses.</p> - <p>This is the only network address aggregate supporting all network - address types. Most AddrRange subclasses usually only support a subset of - address types.</p> - <p>A sequence of address ranges sort first by address type then by - magnitude. So for a list containing ranges of all currently supported - address types, IPv4 ranges come first, then IPv6, EUI-48 and lastly - EUI-64.</p> +<p>Represents arbitrary contiguous blocks of IPv4 and IPv6 addresses + using only a lower and upper bound IP address.</p> + <p>It is the base class for more specialised block types such as <a + href="netaddr.address.CIDR-class.html" class="link">CIDR()</a> and <a + href="netaddr.address.Wildcard-class.html" class="link">Wildcard()</a>. + There is no requirement that the boundary IP addresses fall on strict + bitmask boundaries.</p> + <p>The sort order for sequence of mixed version <a + href="netaddr.address.IPRange-class.html" class="link">IPRange</a> + objects is IPv4 followed by IPv6, based on the range's magnitude + (size).</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -99,13 +99,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">first</span>, <span class="summary-sig-arg">last</span>, - <span class="summary-sig-arg">klass</span>=<span class="summary-sig-default"><class 'netaddr.address.Addr'></span>)</span><br /> + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default"><class 'netaddr.address.IP'></span>)</span><br /> Constructor.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__init__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__init__">source code</a></span> </td> </tr> @@ -119,11 +119,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__hash__" class="summary-sig-name">__hash__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__hash__" class="summary-sig-name">__hash__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: The hash of this address range.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__hash__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__hash__">source code</a></span> </td> </tr> @@ -137,11 +137,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__len__" class="summary-sig-name">__len__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__len__" class="summary-sig-name">__len__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: The total number of network addresses in this range.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__len__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__len__">source code</a></span> </td> </tr> @@ -155,11 +155,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#size" class="summary-sig-name">size</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#size" class="summary-sig-name">size</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: The total number of network addresses in this range.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.size">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.size">source code</a></span> </td> </tr> @@ -173,13 +173,14 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#data_flavour" class="summary-sig-name">data_flavour</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">int_addr</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#format" class="summary-sig-name">format</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">int_addr</span>, + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default">None</span>)</span><br /> Returns: - a network address in whatever 'flavour' is required based on the - value of the klass property.</td> + a network address in the format returned after passing it through + this object's fmt property callable.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.data_flavour">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.format">source code</a></span> </td> </tr> @@ -193,13 +194,12 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__getitem__" class="summary-sig-name">__getitem__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__getitem__" class="summary-sig-name">__getitem__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">index</span>)</span><br /> Returns: - The network address(es) in this address range indicated by - index/slice.</td> + The IP address(es) in this address range referenced by index/slice.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__getitem__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__getitem__">source code</a></span> </td> </tr> @@ -213,12 +213,12 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__iter__" class="summary-sig-name">__iter__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__iter__" class="summary-sig-name">__iter__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: An iterator object providing access to all network addresses within this range.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__iter__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__iter__">source code</a></span> </td> </tr> @@ -232,13 +232,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__contains__" class="summary-sig-name">__contains__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__contains__" class="summary-sig-name">__contains__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">addr</span>)</span><br /> Returns: <code>True</code> if given address or range falls within this range, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__contains__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__contains__">source code</a></span> </td> </tr> @@ -252,13 +252,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__eq__" class="summary-sig-name">__eq__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__eq__" class="summary-sig-name">__eq__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: <code>True</code> if the boundaries of this range are the same as other, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__eq__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__eq__">source code</a></span> </td> </tr> @@ -272,13 +272,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__ne__" class="summary-sig-name">__ne__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__ne__" class="summary-sig-name">__ne__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: <code>True</code> if the boundaries of this range are not the same as other, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__ne__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__ne__">source code</a></span> </td> </tr> @@ -292,13 +292,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__lt__" class="summary-sig-name">__lt__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__lt__" class="summary-sig-name">__lt__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: <code>True</code> if the boundaries of this range are less than other, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__lt__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__lt__">source code</a></span> </td> </tr> @@ -312,13 +312,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__le__" class="summary-sig-name">__le__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__le__" class="summary-sig-name">__le__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: <code>True</code> if the boundaries of this range are less or equal to other, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__le__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__le__">source code</a></span> </td> </tr> @@ -332,13 +332,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__gt__" class="summary-sig-name">__gt__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__gt__" class="summary-sig-name">__gt__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: <code>True</code> if the boundaries of this range are greater than other, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__gt__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__gt__">source code</a></span> </td> </tr> @@ -352,13 +352,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__ge__" class="summary-sig-name">__ge__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__ge__" class="summary-sig-name">__ge__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">other</span>)</span><br /> Returns: <code>True</code> if the boundaries of this range are greater or equal to other, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__ge__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__ge__">source code</a></span> </td> </tr> @@ -372,11 +372,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__iadd__" class="summary-sig-name">__iadd__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__iadd__" class="summary-sig-name">__iadd__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">i</span>)</span><br /> Increments start and end addresses of this range by the current size.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__iadd__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__iadd__">source code</a></span> </td> </tr> @@ -390,11 +390,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__isub__" class="summary-sig-name">__isub__</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__isub__" class="summary-sig-name">__isub__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">i</span>)</span><br /> Decrements start and end addresses of this range by the current size.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__isub__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__isub__">source code</a></span> </td> </tr> @@ -408,10 +408,145 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#iprange" class="summary-sig-name">iprange</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A valid <a href="netaddr.address.IPRange-class.html" + class="link">IPRange</a> object for this address range.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.iprange">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#cidrs" class="summary-sig-name">cidrs</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A list of one or more <a href="netaddr.address.CIDR-class.html" + class="link">CIDR</a> objects covering this address range.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.cidrs">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#wildcard" class="summary-sig-name">wildcard</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + A <a href="netaddr.address.Wildcard-class.html" + class="link">Wildcard</a> object equivalent to this CIDR.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.wildcard">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#issubnet" class="summary-sig-name">issubnet</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + True if other's boundary is equal to or within this range.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.issubnet">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#issupernet" class="summary-sig-name">issupernet</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + True if other's boundary is equal to or contains this range.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.issupernet">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#adjacent" class="summary-sig-name">adjacent</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + True if other's boundary touches the boundary of this address range, + False otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.adjacent">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#overlaps" class="summary-sig-name">overlaps</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + True if other's boundary crosses the boundary of this address range, + False otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.overlaps">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> str(x)</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__str__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__str__">source code</a></span> </td> </tr> @@ -425,12 +560,11 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.AddrRange-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.address.IPRange-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - An executable Python statement that can recreate an object with an - equivalent state.</td> + executable Python string to recreate equivalent object.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__repr__">source code</a></span> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__repr__">source code</a></span> </td> </tr> @@ -463,17 +597,15 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.AddrRange-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False), - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False), - netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True), - netaddr.address.AddrStrategy(64, 8, '-', 64, True, True))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, F<code class="variable-ellipsis">...</code></code> + <a href="netaddr.address.IPRange-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False), + netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 1<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a name="ADDR_TYPES"></a><span class="summary-name">ADDR_TYPES</span> = <code title="(0, 4, 6, 48, 64)"><code class="variable-group">(</code>0<code class="variable-op">, </code>4<code class="variable-op">, </code>6<code class="variable-op">, </code>48<code class="variable-op">, </code>64<code class="variable-group">)</code></code> + <a name="ADDR_TYPES"></a><span class="summary-name">ADDR_TYPES</span> = <code title="(0, 4, 6)"><code class="variable-group">(</code>0<code class="variable-op">, </code>4<code class="variable-op">, </code>6<code class="variable-group">)</code></code> </td> </tr> <tr> @@ -508,7 +640,7 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a name="klass"></a><span class="summary-name">klass</span> = <code title="KlassDescriptor(Addr)">KlassDescriptor(Addr)</code> + <a name="fmt"></a><span class="summary-name">fmt</span> = <code title="FormatDescriptor(IP)">FormatDescriptor(IP)</code> </td> </tr> </table> @@ -547,11 +679,11 @@ object --+ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, <span class="sig-arg">first</span>, <span class="sig-arg">last</span>, - <span class="sig-arg">klass</span>=<span class="sig-default"><class 'netaddr.address.Addr'></span>)</span> + <span class="sig-arg">fmt</span>=<span class="sig-default"><class 'netaddr.address.IP'></span>)</span> <br /><em class="fname">(Constructor)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__init__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__init__">source code</a></span> </td> </tr></table> @@ -559,13 +691,13 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>first</code></strong> - start address for this network address range.</li> - <li><strong class="pname"><code>last</code></strong> - stop address for this network address range.</li> - <li><strong class="pname"><code>klass</code></strong> - (optional) class used to create each object returned. Default: <a - href="netaddr.address.Addr-class.html" class="link">Addr()</a> + <li><strong class="pname"><code>first</code></strong> - start address for this IP address range.</li> + <li><strong class="pname"><code>last</code></strong> - stop address for this IP address range.</li> + <li><strong class="pname"><code>fmt</code></strong> - (optional) callable used to create return values. Default: <a + href="netaddr.address.IP-class.html" class="link">IP()</a> objects. See <a href="netaddr.address-module.html#nrange" - class="link">nrange()</a> documentations for additional details - on options.</li> + class="link">nrange()</a> documentations for more details on the + various options.</li> </ul></dd> <dt>Overrides: object.__init__ @@ -584,7 +716,7 @@ object --+ <br /><em class="fname">(Hashing function)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__hash__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__hash__">source code</a></span> </td> </tr></table> @@ -610,7 +742,7 @@ object --+ <br /><em class="fname">(Length operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__len__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__len__">source code</a></span> </td> </tr></table> @@ -622,7 +754,7 @@ object --+ <li> Use this method only for ranges that contain less than <code>2^31</code> addresses or try the <a - href="netaddr.address.AddrRange-class.html#size" + href="netaddr.address.IPRange-class.html#size" class="link">size()</a> method. Raises an <code>IndexError</code> if size is exceeded. </li> @@ -640,7 +772,7 @@ object --+ <h3 class="epydoc"><span class="sig"><span class="sig-name">size</span>(<span class="sig-arg">self</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.size">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.size">source code</a></span> </td> </tr></table> @@ -651,26 +783,27 @@ object --+ <ul> <li> Use this method in preference to <a - href="netaddr.address.AddrRange-class.html#__len__" - class="link">__len__()</a> when size of ranges exceeds - <code>2^31</code> addresses. + href="netaddr.address.IPRange-class.html#__len__" + class="link">__len__()</a> when size of ranges potentially + exceeds <code>2^31</code> addresses. </li> </ul></dd> </dl> </td></tr></table> </div> -<a name="data_flavour"></a> +<a name="format"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">data_flavour</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">int_addr</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">format</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">int_addr</span>, + <span class="sig-arg">fmt</span>=<span class="sig-default">None</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.data_flavour">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.format">source code</a></span> </td> </tr></table> @@ -678,11 +811,14 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>int_addr</code></strong> - an network address as a network byte order integer.</li> + <li><strong class="pname"><code>int_addr</code></strong> - a network address integer (network byte order).</li> + <li><strong class="pname"><code>fmt</code></strong> - (optional) a callable used on return values. Default: None. If + set to None, this method uses the self.fmt setting instead. The + argument is provided as an override option.</li> </ul></dd> <dt>Returns:</dt> - <dd>a network address in whatever 'flavour' is required based on the - value of the klass property.</dd> + <dd>a network address in the format returned after passing it through + this object's fmt property callable.</dd> </dl> </td></tr></table> </div> @@ -698,18 +834,18 @@ object --+ <br /><em class="fname">(Indexing operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__getitem__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__getitem__">source code</a></span> </td> </tr></table> <dl class="fields"> <dt>Returns:</dt> - <dd>The network address(es) in this address range indicated by + <dd>The IP address(es) in this address range referenced by index/slice. Slicing objects can produce large sequences so - generator objects are returned instead to the usual sequences. - Wrapping a raw slice with <code>list()</code> or - <code>tuple()</code> may be required dependent on context.</dd> + generator objects are returned instead of a list. Wrapping a + slice with <code>list()</code> or <code>tuple()</code> may be + required dependent on context in which it is called.</dd> </dl> </td></tr></table> </div> @@ -723,7 +859,7 @@ object --+ <h3 class="epydoc"><span class="sig"><span class="sig-name">__iter__</span>(<span class="sig-arg">self</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__iter__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__iter__">source code</a></span> </td> </tr></table> @@ -747,7 +883,7 @@ object --+ <br /><em class="fname">(In operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__contains__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__contains__">source code</a></span> </td> </tr></table> @@ -755,8 +891,8 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>addr</code></strong> - object of Addr/AddrRange (sub)class or a network address string - to be compared.</li> + <li><strong class="pname"><code>addr</code></strong> - and IP/IPRange class/subclass instance or IP string value to be + compared.</li> </ul></dd> <dt>Returns:</dt> <dd><code>True</code> if given address or range falls within this @@ -776,7 +912,7 @@ object --+ <br /><em class="fname">(Equality operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__eq__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__eq__">source code</a></span> </td> </tr></table> @@ -803,7 +939,7 @@ object --+ <span class="sig-arg">other</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__ne__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__ne__">source code</a></span> </td> </tr></table> @@ -831,7 +967,7 @@ object --+ <br /><em class="fname">(Less-than operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__lt__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__lt__">source code</a></span> </td> </tr></table> @@ -859,7 +995,7 @@ object --+ <br /><em class="fname">(Less-than-or-equals operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__le__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__le__">source code</a></span> </td> </tr></table> @@ -887,7 +1023,7 @@ object --+ <br /><em class="fname">(Greater-than operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__gt__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__gt__">source code</a></span> </td> </tr></table> @@ -915,7 +1051,7 @@ object --+ <br /><em class="fname">(Greater-than-or-equals operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__ge__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__ge__">source code</a></span> </td> </tr></table> @@ -942,14 +1078,13 @@ object --+ <span class="sig-arg">i</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__iadd__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__iadd__">source code</a></span> </td> </tr></table> <p>Increments start and end addresses of this range by the current size.</p> - <p>If the result exceeds address type range for the address type an - IndexError is raised.</p> + <p>Raises IndexError if the result exceeds address range maximum.</p> <dl class="fields"> </dl> </td></tr></table> @@ -965,14 +1100,186 @@ object --+ <span class="sig-arg">i</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__isub__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__isub__">source code</a></span> </td> </tr></table> <p>Decrements start and end addresses of this range by the current size.</p> - <p>If the result less than zero an IndexError is raised.</p> + <p>Raises IndexError if the result is less than zero.</p> + <dl class="fields"> + </dl> +</td></tr></table> +</div> +<a name="iprange"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">iprange</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.iprange">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>A valid <a href="netaddr.address.IPRange-class.html" + class="link">IPRange</a> object for this address range.</dd> + </dl> +</td></tr></table> +</div> +<a name="cidrs"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">cidrs</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.cidrs">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>A list of one or more <a href="netaddr.address.CIDR-class.html" + class="link">CIDR</a> objects covering this address range. + <b>Please Note:</b> a list is returned even if this range maps to + a single CIDR because arbitrary ranges may not be aligned with + base 2 subnet sizes and will therefore return multiple CIDRs.</dd> + </dl> +</td></tr></table> +</div> +<a name="wildcard"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">wildcard</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.wildcard">source code</a></span> + </td> + </tr></table> + + <dl class="fields"> + <dt>Returns:</dt> + <dd>A <a href="netaddr.address.Wildcard-class.html" + class="link">Wildcard</a> object equivalent to this CIDR. + <ul> + <li> + If CIDR was initialised with <code>fmt=str</code>, a wildcard + string is returned, in all other cases a <a + href="netaddr.address.Wildcard-class.html" + class="link">Wildcard</a> object is returned. + </li> + <li> + Only supports IPv4 CIDR addresses. + </li> + </ul></dd> + </dl> +</td></tr></table> +</div> +<a name="issubnet"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">issubnet</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.issubnet">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>True if other's boundary is equal to or within this range. False + otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="issupernet"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">issupernet</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.issupernet">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>True if other's boundary is equal to or contains this range. + False otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="adjacent"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">adjacent</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.adjacent">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>True if other's boundary touches the boundary of this address + range, False otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="overlaps"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">overlaps</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.overlaps">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>True if other's boundary crosses the boundary of this address + range, False otherwise.</dd> </dl> </td></tr></table> </div> @@ -987,7 +1294,7 @@ object --+ <br /><em class="fname">(Informal representation operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__str__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__str__">source code</a></span> </td> </tr></table> @@ -1011,15 +1318,14 @@ object --+ <br /><em class="fname">(Representation operator)</em> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#AddrRange.__repr__">source code</a></span> + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRange.__repr__">source code</a></span> </td> </tr></table> <p>repr(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>An executable Python statement that can recreate an object with - an equivalent state.</dd> + <dd>executable Python string to recreate equivalent object.</dd> <dt>Overrides: object.__repr__ </dt> @@ -1048,10 +1354,8 @@ object --+ <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)<code class="variable-op">,</code> - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)<code class="variable-op">,</code> - netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True)<code class="variable-op">,</code> - netaddr.address.AddrStrategy(64, 8, '-', 64, True, True)<code class="variable-group">)</code> +<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False)<code class="variable-op">,</code> + netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False)<code class="variable-group">)</code> </pre></td></tr></table> </dd> </dl> @@ -1089,7 +1393,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.IPRangeSet-class.html b/docs/api/netaddr.address.IPRangeSet-class.html new file mode 100644 index 0000000..eea6811 --- /dev/null +++ b/docs/api/netaddr.address.IPRangeSet-class.html @@ -0,0 +1,500 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.address.IPRangeSet</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.address-module.html" onclick="show_private();">Module address</a> :: + Class IPRangeSet + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.address.IPRangeSet-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class IPRangeSet</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet">source code</a></span></p> +<pre class="base-tree"> +object --+ + | + set --+ + | + <strong class="uidshort">IPRangeSet</strong> +</pre> + +<hr /> +<p><b>*EXPERIMENTAL*</b> A customised Python set class that deals with + collections of IPRange class and subclass instances.</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRangeSet-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">addrs</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRangeSet-class.html#__contains__" class="summary-sig-name">__contains__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + True if <code>other</code> IP or IPRange class/subclass instance + matches any of the members in this IPRangeSet, False otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.__contains__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRangeSet-class.html#any_match" class="summary-sig-name">any_match</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + The first IP or IPRange class/subclass instance object that matches + <code>other</code> from any of the members in this IPRangeSet, None + otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.any_match">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRangeSet-class.html#all_matches" class="summary-sig-name">all_matches</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + All IP or IPRange class/subclass instances matching + <code>other</code> from this IPRangeSet, an empty list otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.all_matches">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRangeSet-class.html#min_match" class="summary-sig-name">min_match</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + The smallest IP or IPRange class/subclass instance matching + <code>other</code> from this IPRangeSet, None otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.min_match">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.address.IPRangeSet-class.html#max_match" class="summary-sig-name">max_match</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">other</span>)</span><br /> + Returns: + The largest IP or IPRange class/subclass instance matching + <code>other</code> from this IPRangeSet, None otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.max_match">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>set</code></b>: + <code>__and__</code>, + <code>__cmp__</code>, + <code>__eq__</code>, + <code>__ge__</code>, + <code>__getattribute__</code>, + <code>__gt__</code>, + <code>__hash__</code>, + <code>__iand__</code>, + <code>__ior__</code>, + <code>__isub__</code>, + <code>__iter__</code>, + <code>__ixor__</code>, + <code>__le__</code>, + <code>__len__</code>, + <code>__lt__</code>, + <code>__ne__</code>, + <code>__new__</code>, + <code>__or__</code>, + <code>__rand__</code>, + <code>__reduce__</code>, + <code>__repr__</code>, + <code>__ror__</code>, + <code>__rsub__</code>, + <code>__rxor__</code>, + <code>__sub__</code>, + <code>__xor__</code>, + <code>add</code>, + <code>clear</code>, + <code>copy</code>, + <code>difference</code>, + <code>difference_update</code>, + <code>discard</code>, + <code>intersection</code>, + <code>intersection_update</code>, + <code>issubset</code>, + <code>issuperset</code>, + <code>pop</code>, + <code>remove</code>, + <code>symmetric_difference</code>, + <code>symmetric_difference_update</code>, + <code>union</code>, + <code>update</code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__reduce_ex__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">addrs</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>addrs</code></strong> - A sequence of IPRange class/subclass instances used to + pre-populate the set. Individual CIDR objects can be added and + removed after instantiation with the usual set methods, add() and + remove().</li> + </ul></dd> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="__contains__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__contains__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + <br /><em class="fname">(In operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.__contains__">source code</a></span> + </td> + </tr></table> + + <p>y in x.</p> + <dl class="fields"> + <dt>Returns:</dt> + <dd>True if <code>other</code> IP or IPRange class/subclass instance + matches any of the members in this IPRangeSet, False otherwise.</dd> + <dt>Overrides: + set.__contains__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="any_match"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">any_match</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.any_match">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - An IP or IPRange class/subclass instance.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>The first IP or IPRange class/subclass instance object that + matches <code>other</code> from any of the members in this + IPRangeSet, None otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="all_matches"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">all_matches</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.all_matches">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - An IP or IPRange class/subclass instance.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>All IP or IPRange class/subclass instances matching + <code>other</code> from this IPRangeSet, an empty list otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="min_match"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">min_match</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.min_match">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - An IP or IPRange class/subclass instance.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>The smallest IP or IPRange class/subclass instance matching + <code>other</code> from this IPRangeSet, None otherwise.</dd> + </dl> +</td></tr></table> +</div> +<a name="max_match"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">max_match</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">other</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.address-pysrc.html#IPRangeSet.max_match">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>other</code></strong> - An IP or IPRange class/subclass instance.</li> + </ul></dd> + <dt>Returns:</dt> + <dd>The largest IP or IPRange class/subclass instance matching + <code>other</code> from this IPRangeSet, None otherwise.</dd> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.address.PrefixLenDescriptor-class.html b/docs/api/netaddr.address.PrefixLenDescriptor-class.html index ced1fde..467f67b 100644 --- a/docs/api/netaddr.address.PrefixLenDescriptor-class.html +++ b/docs/api/netaddr.address.PrefixLenDescriptor-class.html @@ -68,8 +68,8 @@ object --+ <hr /> <p>A descriptor that checks prefixlen property assignments for validity - based on address type. Also accepts subnet masks which can easily be - converted to the equivalent prefixlen integer.</p> + based on address type. Also accepts netmasks and hostmasks which can + easily be converted to the equivalent prefixlen integer.</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -216,7 +216,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.StrategyDescriptor-class.html b/docs/api/netaddr.address.StrategyDescriptor-class.html index 1020a74..a24522c 100644 --- a/docs/api/netaddr.address.StrategyDescriptor-class.html +++ b/docs/api/netaddr.address.StrategyDescriptor-class.html @@ -216,7 +216,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.address.Wildcard-class.html b/docs/api/netaddr.address.Wildcard-class.html index 31912a0..4564cf3 100755 --- a/docs/api/netaddr.address.Wildcard-class.html +++ b/docs/api/netaddr.address.Wildcard-class.html @@ -63,14 +63,14 @@ <pre class="base-tree"> object --+ | - <a href="netaddr.address.AddrRange-class.html">AddrRange</a> --+ + <a href="netaddr.address.IPRange-class.html">IPRange</a> --+ | <strong class="uidshort">Wildcard</strong> </pre> <hr /> -<p>A block of contiguous IPv4 network addresses defined using a wildcard - style syntax.</p> +<p>Represents blocks of IPv4 addresses using a wildcard or glob style + syntax.</p> <p>Individual octets can be represented using the following shortcuts :</p> <ol start="1"> @@ -112,11 +112,14 @@ object --+ '*.*.*.*' # the whole IPv4 address space </pre> <h1 class="heading">Aside</h1> - <p><i>Wildcard ranges are not directly equivalent to CIDR ranges as + <p><i>Wildcard ranges are not directly equivalent to CIDR blocks as they can represent address ranges that do not fall on strict bit mask - boundaries.</i></p> - <p><i>All CIDR ranges can always be represented as wildcard ranges but - the reverse isn't true in every case.</i></p> + boundaries. They are very suitable in configuration files being more + obvious and readable than their CIDR equivalents, especially for admins + and users without much networking knowledge or experience.</i></p> + <p><i>All CIDR blocks can always be represented as wildcard ranges but + the reverse is not true. Wildcards are almost but not quite as flexible + as IPRange objects.</i></p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -134,7 +137,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Wildcard-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">wildcard</span>, - <span class="summary-sig-arg">klass</span>=<span class="summary-sig-default"><class 'netaddr.address.IP'></span>)</span><br /> + <span class="summary-sig-arg">fmt</span>=<span class="summary-sig-default"><class 'netaddr.address.IP'></span>)</span><br /> Constructor.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Wildcard.__init__">source code</a></span> @@ -151,25 +154,6 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.address.Wildcard-class.html#cidr" class="summary-sig-name">cidr</a>(<span class="summary-sig-arg">self</span>)</span><br /> - Returns: - A valid <a href="netaddr.address.CIDR-class.html" - class="link">CIDR</a> object for this wildcard.</td> - <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.address-pysrc.html#Wildcard.cidr">source code</a></span> - - </td> - </tr> - </table> - - </td> - </tr> -<tr> - <td width="15%" align="right" valign="top" class="summary"> - <span class="summary-type"> </span> - </td><td class="summary"> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr> <td><span class="summary-sig"><a href="netaddr.address.Wildcard-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> str(x)</td> <td align="right" valign="top"> @@ -189,8 +173,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.address.Wildcard-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - An executable Python statement that can recreate an object with an - equivalent state.</td> + executable Python string to recreate equivalent object.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.address-pysrc.html#Wildcard.__repr__">source code</a></span> @@ -202,22 +185,29 @@ object --+ </tr> <tr> <td colspan="2" class="summary"> - <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.AddrRange-class.html">AddrRange</a></code></b>: - <code><a href="netaddr.address.AddrRange-class.html#__contains__">__contains__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__eq__">__eq__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__ge__">__ge__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__getitem__">__getitem__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__gt__">__gt__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__hash__">__hash__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__iadd__">__iadd__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__isub__">__isub__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__iter__">__iter__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__le__">__le__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__len__">__len__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__lt__">__lt__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#__ne__">__ne__</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#data_flavour">data_flavour</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#size">size</a></code> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.IPRange-class.html">IPRange</a></code></b>: + <code><a href="netaddr.address.IPRange-class.html#__contains__">__contains__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__eq__">__eq__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__ge__">__ge__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__getitem__">__getitem__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__gt__">__gt__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__hash__">__hash__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__iadd__">__iadd__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__isub__">__isub__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__iter__">__iter__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__le__">__le__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__len__">__len__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__lt__">__lt__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#__ne__">__ne__</a></code>, + <code><a href="netaddr.address.IPRange-class.html#adjacent">adjacent</a></code>, + <code><a href="netaddr.address.IPRange-class.html#cidrs">cidrs</a></code>, + <code><a href="netaddr.address.IPRange-class.html#format">format</a></code>, + <code><a href="netaddr.address.IPRange-class.html#iprange">iprange</a></code>, + <code><a href="netaddr.address.IPRange-class.html#issubnet">issubnet</a></code>, + <code><a href="netaddr.address.IPRange-class.html#issupernet">issupernet</a></code>, + <code><a href="netaddr.address.IPRange-class.html#overlaps">overlaps</a></code>, + <code><a href="netaddr.address.IPRange-class.html#size">size</a></code>, + <code><a href="netaddr.address.IPRange-class.html#wildcard">wildcard</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -268,15 +258,14 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.address.Wildcard-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False), - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, F<code class="variable-ellipsis">...</code></code> + <a href="netaddr.address.Wildcard-class.html#STRATEGIES" class="summary-name">STRATEGIES</a> = <code title="(netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False))"><code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 1<code class="variable-ellipsis">...</code></code> </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a name="ADDR_TYPES"></a><span class="summary-name">ADDR_TYPES</span> = <code title="(0, 4, 6)"><code class="variable-group">(</code>0<code class="variable-op">, </code>4<code class="variable-op">, </code>6<code class="variable-group">)</code></code> + <a name="ADDR_TYPES"></a><span class="summary-name">ADDR_TYPES</span> = <code title="(0, 4)"><code class="variable-group">(</code>0<code class="variable-op">, </code>4<code class="variable-group">)</code></code> </td> </tr> <tr> @@ -297,14 +286,14 @@ object --+ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a name="klass"></a><span class="summary-name">klass</span> = <code title="KlassDescriptor(IP)">KlassDescriptor(IP)</code> + <a name="fmt"></a><span class="summary-name">fmt</span> = <code title="FormatDescriptor(IP)">FormatDescriptor(IP)</code> </td> </tr> <tr> <td colspan="2" class="summary"> - <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.AddrRange-class.html">AddrRange</a></code></b>: - <code><a href="netaddr.address.AddrRange-class.html#first">first</a></code>, - <code><a href="netaddr.address.AddrRange-class.html#last">last</a></code> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.address.IPRange-class.html">IPRange</a></code></b>: + <code><a href="netaddr.address.IPRange-class.html#first">first</a></code>, + <code><a href="netaddr.address.IPRange-class.html#last">last</a></code> </p> </td> </tr> @@ -369,7 +358,7 @@ object --+ <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, <span class="sig-arg">wildcard</span>, - <span class="sig-arg">klass</span>=<span class="sig-default"><class 'netaddr.address.IP'></span>)</span> + <span class="sig-arg">fmt</span>=<span class="sig-default"><class 'netaddr.address.IP'></span>)</span> <br /><em class="fname">(Constructor)</em> </h3> </td><td align="right" valign="top" @@ -382,11 +371,11 @@ object --+ <dt>Parameters:</dt> <dd><ul class="nomargin-top"> <li><strong class="pname"><code>wildcard</code></strong> - a valid IPv4 wildcard address</li> - <li><strong class="pname"><code>klass</code></strong> - (optional) class used to create each return object. Default: <a + <li><strong class="pname"><code>fmt</code></strong> - (optional) callable used on return values. Default: <a href="netaddr.address.IP-class.html" class="link">IP</a> objects. See <a href="netaddr.address-module.html#nrange" - class="link">nrange()</a> documentations for additional details - on options.</li> + class="link">nrange()</a> documentations for more details on the + various options..</li> </ul></dd> <dt>Overrides: object.__init__ @@ -394,31 +383,6 @@ object --+ </dl> </td></tr></table> </div> -<a name="cidr"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">cidr</span>(<span class="sig-arg">self</span>)</span> - </h3> - </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.address-pysrc.html#Wildcard.cidr">source code</a></span> - </td> - </tr></table> - - - <dl class="fields"> - <dt>Returns:</dt> - <dd>A valid <a href="netaddr.address.CIDR-class.html" - class="link">CIDR</a> object for this wildcard. If conversion - fails an <a href="netaddr.AddrConversionError-class.html" - class="link">AddrConversionError</a> is raised as not all - wildcards ranges are valid CIDR ranges.</dd> - </dl> -</td></tr></table> -</div> <a name="__str__"></a> <div> <table class="details" border="1" cellpadding="3" @@ -461,8 +425,7 @@ object --+ <p>repr(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>An executable Python statement that can recreate an object with - an equivalent state.</dd> + <dd>executable Python string to recreate equivalent object.</dd> <dt>Overrides: object.__repr__ </dt> @@ -491,8 +454,7 @@ object --+ <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)<code class="variable-op">,</code> - netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)<code class="variable-group">)</code> +<code class="variable-group">(</code>netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False)<code class="variable-group">)</code> </pre></td></tr></table> </dd> </dl> @@ -530,7 +492,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.core-module.html b/docs/api/netaddr.core-module.html new file mode 100644 index 0000000..8a335bf --- /dev/null +++ b/docs/api/netaddr.core-module.html @@ -0,0 +1,152 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.core</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Module core + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.core-module.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== MODULE DESCRIPTION ==================== --> +<h1 class="epydoc">Module core</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.core-pysrc.html">source code</a></span></p> +<p>Classes and routines that are common to various netaddr sub + modules.</p> + +<!-- ==================== CLASSES ==================== --> +<a name="section-Classes"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Classes</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.core.Subscriber-class.html" class="summary-name">Subscriber</a><br /> + Abstract class defining interface expected by a Publisher that + concrete subclass instances register with to receive updates from. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.core.PrettyPrinter-class.html" class="summary-name">PrettyPrinter</a><br /> + Concrete Subscriber that uses the pprint module to format all data + from updates received writing them to any file-like object. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.core.Publisher-class.html" class="summary-name">Publisher</a><br /> + A 'push' publisher that maintains a list of Subscriber objects + notifying them of state changes when its subclasses encounter + events of interest. + </td> + </tr> +</table> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.core-pysrc.html b/docs/api/netaddr.core-pysrc.html new file mode 100644 index 0000000..1428624 --- /dev/null +++ b/docs/api/netaddr.core-pysrc.html @@ -0,0 +1,203 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.core</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Module core + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.core-pysrc.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<h1 class="epydoc">Source Code for <a href="netaddr.core-module.html" onclick="show_private();">Module netaddr.core</a></h1> +<pre class="py-src"> +<a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python
</tt> </tt> +<a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Copyright (c) 2008, David P. D. Moss. All rights reserved.
</tt> </tt> +<a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#
</tt> </tt> +<a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Released under the BSD license. See the LICENSE file for details.
</tt> </tt> +<a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-docstring">"""
</tt> </tt> +<a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">Classes and routines that are common to various netaddr sub modules.
</tt> </tt> +<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
+<a name="L10"></a><tt class="py-lineno">10</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">sys</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_sys</tt> </tt>
+<a name="L11"></a><tt class="py-lineno">11</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">pprint</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_pprint</tt> </tt>
+<a name="L12"></a><tt class="py-lineno">12</tt> <tt class="py-line">
</tt> +<a name="L13"></a><tt class="py-lineno">13</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="Subscriber"></a><div id="Subscriber-def"><a name="L14"></a><tt class="py-lineno">14</tt> <a class="py-toggle" href="#" id="Subscriber-toggle" onclick="return toggle('Subscriber');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.core.Subscriber-class.html">Subscriber</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Subscriber-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="Subscriber-expanded"><a name="L15"></a><tt class="py-lineno">15</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L16"></a><tt class="py-lineno">16</tt> <tt class="py-line"><tt class="py-docstring"> Abstract class defining interface expected by a Publisher that concrete
</tt> </tt> +<a name="L17"></a><tt class="py-lineno">17</tt> <tt class="py-line"><tt class="py-docstring"> subclass instances register with to receive updates from.
</tt> </tt> +<a name="L18"></a><tt class="py-lineno">18</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="Subscriber.update"></a><div id="Subscriber.update-def"><a name="L19"></a><tt class="py-lineno">19</tt> <a class="py-toggle" href="#" id="Subscriber.update-toggle" onclick="return toggle('Subscriber.update');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.core.Subscriber-class.html#update">update</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Subscriber.update-collapsed" style="display:none;" pad="++" indent="++++++++"></div><div id="Subscriber.update-expanded"><a name="L20"></a><tt class="py-lineno">20</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L21"></a><tt class="py-lineno">21</tt> <tt class="py-line"><tt class="py-docstring"> Callback function used by Publisher to notify this Subscriber about
</tt> </tt> +<a name="L22"></a><tt class="py-lineno">22</tt> <tt class="py-line"><tt class="py-docstring"> an update.
</tt> </tt> +<a name="L23"></a><tt class="py-lineno">23</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L24"></a><tt class="py-lineno">24</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">NotImplementedError</tt><tt class="py-op">(</tt><tt class="py-string">'cannot invoke virtual method!'</tt><tt class="py-op">)</tt> </tt>
+</div></div><a name="L25"></a><tt class="py-lineno">25</tt> <tt class="py-line">
</tt> +<a name="L26"></a><tt class="py-lineno">26</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="PrettyPrinter"></a><div id="PrettyPrinter-def"><a name="L27"></a><tt class="py-lineno">27</tt> <a class="py-toggle" href="#" id="PrettyPrinter-toggle" onclick="return toggle('PrettyPrinter');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.core.PrettyPrinter-class.html">PrettyPrinter</a><tt class="py-op">(</tt><tt class="py-base-class">Subscriber</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="PrettyPrinter-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="PrettyPrinter-expanded"><a name="L28"></a><tt class="py-lineno">28</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L29"></a><tt class="py-lineno">29</tt> <tt class="py-line"><tt class="py-docstring"> Concrete Subscriber that uses the pprint module to format all data from
</tt> </tt> +<a name="L30"></a><tt class="py-lineno">30</tt> <tt class="py-line"><tt class="py-docstring"> updates received writing them to any file-like object. Useful for
</tt> </tt> +<a name="L31"></a><tt class="py-lineno">31</tt> <tt class="py-line"><tt class="py-docstring"> debugging.
</tt> </tt> +<a name="L32"></a><tt class="py-lineno">32</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="PrettyPrinter.__init__"></a><div id="PrettyPrinter.__init__-def"><a name="L33"></a><tt class="py-lineno">33</tt> <a class="py-toggle" href="#" id="PrettyPrinter.__init__-toggle" onclick="return toggle('PrettyPrinter.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.core.PrettyPrinter-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">fh</tt><tt class="py-op">=</tt><tt class="py-name">_sys</tt><tt class="py-op">.</tt><tt class="py-name">stdout</tt><tt class="py-op">,</tt> <tt class="py-param">write_eol</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="PrettyPrinter.__init__-collapsed" style="display:none;" pad="++" indent="++++++++"></div><div id="PrettyPrinter.__init__-expanded"><a name="L34"></a><tt class="py-lineno">34</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L35"></a><tt class="py-lineno">35</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.
</tt> </tt> +<a name="L36"></a><tt class="py-lineno">36</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L37"></a><tt class="py-lineno">37</tt> <tt class="py-line"><tt class="py-docstring"> fh - file or file like object to write to. Default: sys.stdout.
</tt> </tt> +<a name="L38"></a><tt class="py-lineno">38</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L39"></a><tt class="py-lineno">39</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt> <tt class="py-op">=</tt> <tt class="py-name">fh</tt> </tt>
+<a name="L40"></a><tt class="py-lineno">40</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">write_eol</tt> <tt class="py-op">=</tt> <tt class="py-name">write_eol</tt> </tt>
+</div><a name="L41"></a><tt class="py-lineno">41</tt> <tt class="py-line">
</tt> +<a name="PrettyPrinter.update"></a><div id="PrettyPrinter.update-def"><a name="L42"></a><tt class="py-lineno">42</tt> <a class="py-toggle" href="#" id="PrettyPrinter.update-toggle" onclick="return toggle('PrettyPrinter.update');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.core.PrettyPrinter-class.html#update">update</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="PrettyPrinter.update-collapsed" style="display:none;" pad="++" indent="++++++++"></div><div id="PrettyPrinter.update-expanded"><a name="L43"></a><tt class="py-lineno">43</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L44"></a><tt class="py-lineno">44</tt> <tt class="py-line"><tt class="py-docstring"> Callback function used by Publisher to notify this Subscriber about
</tt> </tt> +<a name="L45"></a><tt class="py-lineno">45</tt> <tt class="py-line"><tt class="py-docstring"> an update.
</tt> </tt> +<a name="L46"></a><tt class="py-lineno">46</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L47"></a><tt class="py-lineno">47</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">write</tt><tt class="py-op">(</tt><tt class="py-name">_pprint</tt><tt class="py-op">.</tt><tt class="py-name">pformat</tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L48"></a><tt class="py-lineno">48</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">write_eol</tt><tt class="py-op">:</tt> </tt>
+<a name="L49"></a><tt class="py-lineno">49</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">write</tt><tt class="py-op">(</tt><tt class="py-string">"\n"</tt><tt class="py-op">)</tt> </tt>
+</div></div><a name="L50"></a><tt class="py-lineno">50</tt> <tt class="py-line">
</tt> +<a name="L51"></a><tt class="py-lineno">51</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="Publisher"></a><div id="Publisher-def"><a name="L52"></a><tt class="py-lineno">52</tt> <a class="py-toggle" href="#" id="Publisher-toggle" onclick="return toggle('Publisher');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.core.Publisher-class.html">Publisher</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Publisher-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="Publisher-expanded"><a name="L53"></a><tt class="py-lineno">53</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L54"></a><tt class="py-lineno">54</tt> <tt class="py-line"><tt class="py-docstring"> A 'push' publisher that maintains a list of Subscriber objects notifying
</tt> </tt> +<a name="L55"></a><tt class="py-lineno">55</tt> <tt class="py-line"><tt class="py-docstring"> them of state changes when its subclasses encounter events of interest.
</tt> </tt> +<a name="L56"></a><tt class="py-lineno">56</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="Publisher.__init__"></a><div id="Publisher.__init__-def"><a name="L57"></a><tt class="py-lineno">57</tt> <a class="py-toggle" href="#" id="Publisher.__init__-toggle" onclick="return toggle('Publisher.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.core.Publisher-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Publisher.__init__-collapsed" style="display:none;" pad="++" indent="++++++++"></div><div id="Publisher.__init__-expanded"><a name="L58"></a><tt class="py-lineno">58</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor"""</tt> </tt>
+<a name="L59"></a><tt class="py-lineno">59</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">subscribers</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt>
+</div><a name="L60"></a><tt class="py-lineno">60</tt> <tt class="py-line">
</tt> +<a name="Publisher.attach"></a><div id="Publisher.attach-def"><a name="L61"></a><tt class="py-lineno">61</tt> <a class="py-toggle" href="#" id="Publisher.attach-toggle" onclick="return toggle('Publisher.attach');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.core.Publisher-class.html#attach">attach</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">subscriber</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Publisher.attach-collapsed" style="display:none;" pad="++" indent="++++++++"></div><div id="Publisher.attach-expanded"><a name="L62"></a><tt class="py-lineno">62</tt> <tt class="py-line"> <tt class="py-docstring">"""Add a new subscriber"""</tt> </tt>
+<a name="L63"></a><tt class="py-lineno">63</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt class="py-name">subscriber</tt><tt class="py-op">,</tt> <tt class="py-string">'update'</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> \
</tt> +<a name="L64"></a><tt class="py-lineno">64</tt> <tt class="py-line"> <tt class="py-name">callable</tt><tt class="py-op">(</tt><tt class="py-name">eval</tt><tt class="py-op">(</tt><tt class="py-string">'subscriber.update'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+<a name="L65"></a><tt class="py-lineno">65</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">subscriber</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">subscribers</tt><tt class="py-op">:</tt> </tt>
+<a name="L66"></a><tt class="py-lineno">66</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">subscribers</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">subscriber</tt><tt class="py-op">)</tt> </tt>
+<a name="L67"></a><tt class="py-lineno">67</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L68"></a><tt class="py-lineno">68</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r does not support required interface!'</tt> \
</tt> +<a name="L69"></a><tt class="py-lineno">69</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">subscriber</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L70"></a><tt class="py-lineno">70</tt> <tt class="py-line">
</tt> +<a name="Publisher.detach"></a><div id="Publisher.detach-def"><a name="L71"></a><tt class="py-lineno">71</tt> <a class="py-toggle" href="#" id="Publisher.detach-toggle" onclick="return toggle('Publisher.detach');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.core.Publisher-class.html#detach">detach</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">subscriber</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Publisher.detach-collapsed" style="display:none;" pad="++" indent="++++++++"></div><div id="Publisher.detach-expanded"><a name="L72"></a><tt class="py-lineno">72</tt> <tt class="py-line"> <tt class="py-docstring">"""Remove an existing subscriber"""</tt> </tt>
+<a name="L73"></a><tt class="py-lineno">73</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt>
+<a name="L74"></a><tt class="py-lineno">74</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">subscribers</tt><tt class="py-op">.</tt><tt class="py-name">remove</tt><tt class="py-op">(</tt><tt class="py-name">subscriber</tt><tt class="py-op">)</tt> </tt>
+<a name="L75"></a><tt class="py-lineno">75</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt>
+<a name="L76"></a><tt class="py-lineno">76</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt>
+</div><a name="L77"></a><tt class="py-lineno">77</tt> <tt class="py-line">
</tt> +<a name="Publisher.notify"></a><div id="Publisher.notify-def"><a name="L78"></a><tt class="py-lineno">78</tt> <a class="py-toggle" href="#" id="Publisher.notify-toggle" onclick="return toggle('Publisher.notify');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.core.Publisher-class.html#notify">notify</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="Publisher.notify-collapsed" style="display:none;" pad="++" indent="++++++++"></div><div id="Publisher.notify-expanded"><a name="L79"></a><tt class="py-lineno">79</tt> <tt class="py-line"> <tt class="py-docstring">"""Send notification message to all registered subscribers"""</tt> </tt>
+<a name="L80"></a><tt class="py-lineno">80</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">subscriber</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">subscribers</tt><tt class="py-op">:</tt> </tt>
+<a name="L81"></a><tt class="py-lineno">81</tt> <tt class="py-line"> <tt class="py-name">subscriber</tt><tt class="py-op">.</tt><tt id="link-0" class="py-name" targets="Method netaddr.core.PrettyPrinter.update()=netaddr.core.PrettyPrinter-class.html#update,Method netaddr.core.Subscriber.update()=netaddr.core.Subscriber-class.html#update,Method netaddr.eui.FileIndexer.update()=netaddr.eui.FileIndexer-class.html#update,Method netaddr.ip.DictUpdater.update()=netaddr.ip.DictUpdater-class.html#update"><a title="netaddr.core.PrettyPrinter.update +netaddr.core.Subscriber.update +netaddr.eui.FileIndexer.update +netaddr.ip.DictUpdater.update" class="py-name" href="#" onclick="return doclink('link-0', 'update', 'link-0');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L82"></a><tt class="py-lineno">82</tt> <tt class="py-line"> </tt><script type="text/javascript"> +<!-- +expandto(location.href); +// --> +</script> +</pre> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:24 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.core.PrettyPrinter-class.html b/docs/api/netaddr.core.PrettyPrinter-class.html new file mode 100644 index 0000000..ad2b0d3 --- /dev/null +++ b/docs/api/netaddr.core.PrettyPrinter-class.html @@ -0,0 +1,264 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.core.PrettyPrinter</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.core-module.html" onclick="show_private();">Module core</a> :: + Class PrettyPrinter + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.core.PrettyPrinter-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class PrettyPrinter</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.core-pysrc.html#PrettyPrinter">source code</a></span></p> +<pre class="base-tree"> +object --+ + | +<a href="netaddr.core.Subscriber-class.html">Subscriber</a> --+ + | + <strong class="uidshort">PrettyPrinter</strong> +</pre> + +<hr /> +<p>Concrete Subscriber that uses the pprint module to format all data + from updates received writing them to any file-like object. Useful for + debugging.</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.core.PrettyPrinter-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">fh</span>=<span class="summary-sig-default">_sys.stdout</span>, + <span class="summary-sig-arg">write_eol</span>=<span class="summary-sig-default">True</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.core-pysrc.html#PrettyPrinter.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.core.PrettyPrinter-class.html#update" class="summary-sig-name">update</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">data</span>)</span><br /> + Callback function used by Publisher to notify this Subscriber about + an update.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.core-pysrc.html#PrettyPrinter.update">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">fh</span>=<span class="sig-default">_sys.stdout</span>, + <span class="sig-arg">write_eol</span>=<span class="sig-default">True</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.core-pysrc.html#PrettyPrinter.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>fh - file or file like object to write to. Default: sys.stdout.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="update"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">update</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">data</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.core-pysrc.html#PrettyPrinter.update">source code</a></span> + </td> + </tr></table> + + <p>Callback function used by Publisher to notify this Subscriber about an + update.</p> + <dl class="fields"> + <dt>Overrides: + <a href="netaddr.core.Subscriber-class.html#update">Subscriber.update</a> + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.core.Publisher-class.html b/docs/api/netaddr.core.Publisher-class.html new file mode 100644 index 0000000..f9bf04b --- /dev/null +++ b/docs/api/netaddr.core.Publisher-class.html @@ -0,0 +1,274 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.core.Publisher</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.core-module.html" onclick="show_private();">Module core</a> :: + Class Publisher + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.core.Publisher-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class Publisher</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.core-pysrc.html#Publisher">source code</a></span></p> +<pre class="base-tree"> +object --+ + | + <strong class="uidshort">Publisher</strong> +</pre> + +<dl><dt>Known Subclasses:</dt> +<dd> + <ul class="subclass-list"> +<li><a href="netaddr.eui.IABIndexParser-class.html">eui.IABIndexParser</a></li><li>, <a href="netaddr.eui.OUIIndexParser-class.html">eui.OUIIndexParser</a></li><li>, <a href="netaddr.ip.LineRecordParser-class.html">ip.LineRecordParser</a></li> </ul> +</dd></dl> + +<hr /> +<p>A 'push' publisher that maintains a list of Subscriber objects + notifying them of state changes when its subclasses encounter events of + interest.</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.core.Publisher-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Constructor</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.core-pysrc.html#Publisher.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="attach"></a><span class="summary-sig-name">attach</span>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">subscriber</span>)</span><br /> + Add a new subscriber</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.core-pysrc.html#Publisher.attach">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="detach"></a><span class="summary-sig-name">detach</span>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">subscriber</span>)</span><br /> + Remove an existing subscriber</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.core-pysrc.html#Publisher.detach">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="notify"></a><span class="summary-sig-name">notify</span>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">data</span>)</span><br /> + Send notification message to all registered subscribers</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.core-pysrc.html#Publisher.notify">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.core-pysrc.html#Publisher.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.core.Subscriber-class.html b/docs/api/netaddr.core.Subscriber-class.html new file mode 100644 index 0000000..f0a389d --- /dev/null +++ b/docs/api/netaddr.core.Subscriber-class.html @@ -0,0 +1,189 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.core.Subscriber</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.core-module.html" onclick="show_private();">Module core</a> :: + Class Subscriber + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.core.Subscriber-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class Subscriber</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.core-pysrc.html#Subscriber">source code</a></span></p> +<pre class="base-tree"> +object --+ + | + <strong class="uidshort">Subscriber</strong> +</pre> + +<dl><dt>Known Subclasses:</dt> +<dd> + <ul class="subclass-list"> +<li><a href="netaddr.core.PrettyPrinter-class.html">PrettyPrinter</a></li><li>, <a href="netaddr.eui.FileIndexer-class.html">eui.FileIndexer</a></li><li>, <a href="netaddr.ip.DictUpdater-class.html">ip.DictUpdater</a></li> </ul> +</dd></dl> + +<hr /> +<p>Abstract class defining interface expected by a Publisher that + concrete subclass instances register with to receive updates from.</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="update"></a><span class="summary-sig-name">update</span>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">data</span>)</span><br /> + Callback function used by Publisher to notify this Subscriber about + an update.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.core-pysrc.html#Subscriber.update">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__init__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui-module.html b/docs/api/netaddr.eui-module.html new file mode 100644 index 0000000..176954c --- /dev/null +++ b/docs/api/netaddr.eui-module.html @@ -0,0 +1,437 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Package eui + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui-module.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== PACKAGE DESCRIPTION ==================== --> +<h1 class="epydoc">Package eui</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.eui-pysrc.html">source code</a></span></p> +<p>Provides access to public network address information published by the + IEEE.</p> + <p>More details can be found at the following URLs :-</p> + <p>Institute of Electrical and Electronics Engineers (IEEE)</p> + <ul> + <li> + http://www.ieee.org/ + </li> + <li> + http://standards.ieee.org/regauth/oui/ + </li> + </ul> + +<!-- ==================== CLASSES ==================== --> +<a name="section-Classes"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Classes</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.NotRegisteredError-class.html" class="summary-name">NotRegisteredError</a><br /> + An Exception indicating that an OUI or IAB was not found in the + IEEE Registry. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.FileIndexer-class.html" class="summary-name">FileIndexer</a><br /> + Stores index data found by a parser in a CSV file + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.OUIIndexParser-class.html" class="summary-name">OUIIndexParser</a><br /> + A parser that processes OUI (Organisationally Unique Identifier) + registration file data published by the IEEE. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.IABIndexParser-class.html" class="summary-name">IABIndexParser</a><br /> + A parser that processes IAB (Individual Address Block) registration + file data published by the IEEE. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.OUI-class.html" class="summary-name">OUI</a><br /> + Represents an individual IEEE OUI (Organisationally Unique + Identifier) identifier. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui.IAB-class.html" class="summary-name">IAB</a><br /> + Represents an individual IEEE IAB (Individual Address Block) + identifier. + </td> + </tr> +</table> +<!-- ==================== FUNCTIONS ==================== --> +<a name="section-Functions"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Functions</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="create_ieee_indices"></a><span class="summary-sig-name">create_ieee_indices</span>()</span><br /> + Create indices for OUI and IAB file based lookups</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#create_ieee_indices">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="load_ieee_indices"></a><span class="summary-sig-name">load_ieee_indices</span>()</span><br /> + Load OUI and IAB indices into memory</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#load_ieee_indices">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +</table> +<!-- ==================== VARIABLES ==================== --> +<a name="section-Variables"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Variables</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui-module.html#IEEE_OUI_REGISTRY" class="summary-name">IEEE_OUI_REGISTRY</a> = <code title="'/cygdrive/z/netaddr/trunk/netaddr/eui/oui.txt'"><code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/oui</code><code class="variable-ellipsis">...</code></code><br /> + Path to local copy of IEEE OUI Registry data file. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui-module.html#IEEE_OUI_METADATA" class="summary-name">IEEE_OUI_METADATA</a> = <code title="'/cygdrive/z/netaddr/trunk/netaddr/eui/oui.idx'"><code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/oui</code><code class="variable-ellipsis">...</code></code><br /> + Path to netaddr OUI index file. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui-module.html#IEEE_OUI_INDEX" class="summary-name">IEEE_OUI_INDEX</a> = <code title="{0: [(61, 154)], + 1: [(215, 178)], + 2: [(393, 178)], + 3: [(571, 187)], + 4: [(758, 179)], + 5: [(937, 178)], + 6: [(1115, 179)], + 7: [(1294, 178)], +..."><code class="variable-group">{</code>0<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>61<code class="variable-op">, </code>154<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">, </code>1<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>215<code class="variable-op">, </code>178<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">, </code>2<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>393<code class="variable-op">, </code>1<code class="variable-ellipsis">...</code></code><br /> + OUI index lookup dictionary. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui-module.html#IEEE_IAB_REGISTRY" class="summary-name">IEEE_IAB_REGISTRY</a> = <code title="'/cygdrive/z/netaddr/trunk/netaddr/eui/iab.txt'"><code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/iab</code><code class="variable-ellipsis">...</code></code><br /> + Path to local copy of IEEE IAB Registry data file. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui-module.html#IEEE_IAB_METADATA" class="summary-name">IEEE_IAB_METADATA</a> = <code title="'/cygdrive/z/netaddr/trunk/netaddr/eui/iab.idx'"><code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/iab</code><code class="variable-ellipsis">...</code></code><br /> + Path to netaddr IAB index file. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.eui-module.html#IEEE_IAB_INDEX" class="summary-name">IEEE_IAB_INDEX</a> = <code title="{84680704: [(68, 133)], + 84680705: [(201, 140)], + 84680706: [(341, 172)], + 84680707: [(513, 139)], + 84680708: [(652, 141)], + 84680709: [(793, 144)], + 84680710: [(937, 195)], + 84680711: [(1132, 166)], +..."><code class="variable-group">{</code>84680704<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>68<code class="variable-op">, </code>133<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">, </code>84680705<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>201<code class="variable-op">, </code>140<code class="variable-group">)</code><code class="variable-ellipsis">...</code></code><br /> + IAB index lookup dictionary. + </td> + </tr> +</table> +<!-- ==================== VARIABLES DETAILS ==================== --> +<a name="section-VariablesDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Variables Details</span></td> +</tr> +</table> +<a name="IEEE_OUI_REGISTRY"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">IEEE_OUI_REGISTRY</h3> + <p>Path to local copy of IEEE OUI Registry data file.</p> + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/oui.txt</code><code class="variable-quote">'</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<a name="IEEE_OUI_METADATA"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">IEEE_OUI_METADATA</h3> + <p>Path to netaddr OUI index file.</p> + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/oui.idx</code><code class="variable-quote">'</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<a name="IEEE_OUI_INDEX"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">IEEE_OUI_INDEX</h3> + <p>OUI index lookup dictionary.</p> + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-group">{</code>0<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>61<code class="variable-op">, </code>154<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 1<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>215<code class="variable-op">, </code>178<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 2<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>393<code class="variable-op">, </code>178<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 3<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>571<code class="variable-op">, </code>187<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 4<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>758<code class="variable-op">, </code>179<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 5<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>937<code class="variable-op">, </code>178<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 6<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>1115<code class="variable-op">, </code>179<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 7<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>1294<code class="variable-op">, </code>178<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> +<code class="variable-ellipsis">...</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<a name="IEEE_IAB_REGISTRY"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">IEEE_IAB_REGISTRY</h3> + <p>Path to local copy of IEEE IAB Registry data file.</p> + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/iab.txt</code><code class="variable-quote">'</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<a name="IEEE_IAB_METADATA"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">IEEE_IAB_METADATA</h3> + <p>Path to netaddr IAB index file.</p> + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-quote">'</code><code class="variable-string">/cygdrive/z/netaddr/trunk/netaddr/eui/iab.idx</code><code class="variable-quote">'</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<a name="IEEE_IAB_INDEX"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">IEEE_IAB_INDEX</h3> + <p>IAB index lookup dictionary.</p> + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-group">{</code>84680704<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>68<code class="variable-op">, </code>133<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 84680705<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>201<code class="variable-op">, </code>140<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 84680706<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>341<code class="variable-op">, </code>172<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 84680707<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>513<code class="variable-op">, </code>139<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 84680708<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>652<code class="variable-op">, </code>141<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 84680709<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>793<code class="variable-op">, </code>144<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 84680710<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>937<code class="variable-op">, </code>195<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> + 84680711<code class="variable-op">: </code><code class="variable-group">[</code><code class="variable-group">(</code>1132<code class="variable-op">, </code>166<code class="variable-group">)</code><code class="variable-group">]</code><code class="variable-op">,</code> +<code class="variable-ellipsis">...</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui-pysrc.html b/docs/api/netaddr.eui-pysrc.html new file mode 100644 index 0000000..6c6948e --- /dev/null +++ b/docs/api/netaddr.eui-pysrc.html @@ -0,0 +1,690 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Package eui + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui-pysrc.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<h1 class="epydoc">Source Code for <a href="netaddr.eui-module.html" onclick="show_private();">Package netaddr.eui</a></h1> +<pre class="py-src"> +<a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python</tt> </tt> +<a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Copyright (c) 2008, David P. D. Moss. All rights reserved.</tt> </tt> +<a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt> +<a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Released under the BSD license. See the LICENSE file for details.</tt> </tt> +<a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-docstring">"""</tt> </tt> +<a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">Provides access to public network address information published by the IEEE.</tt> </tt> +<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-docstring">More details can be found at the following URLs :-</tt> </tt> +<a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-docstring">Institute of Electrical and Electronics Engineers (IEEE)</tt> </tt> +<a name="L13"></a><tt class="py-lineno"> 13</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt class="py-docstring"> - http://www.ieee.org/</tt> </tt> +<a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"><tt class="py-docstring"> - http://standards.ieee.org/regauth/oui/</tt> </tt> +<a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> +<a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"> </tt> +<a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">sys</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_sys</tt> </tt> +<a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">os</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_os</tt> </tt> +<a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">path</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_path</tt> </tt> +<a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">csv</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_csv</tt> </tt> +<a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"> </tt> +<a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">pprint</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_pprint</tt> </tt> +<a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"> </tt> +<a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-0" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-0', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-1" class="py-name" targets="Module netaddr.core=netaddr.core-module.html"><a title="netaddr.core" class="py-name" href="#" onclick="return doclink('link-1', 'core', 'link-1');">core</a></tt> <tt class="py-keyword">import</tt> <tt id="link-2" class="py-name" targets="Class netaddr.core.Subscriber=netaddr.core.Subscriber-class.html"><a title="netaddr.core.Subscriber" class="py-name" href="#" onclick="return doclink('link-2', 'Subscriber', 'link-2');">Subscriber</a></tt><tt class="py-op">,</tt> <tt id="link-3" class="py-name" targets="Class netaddr.core.Publisher=netaddr.core.Publisher-class.html"><a title="netaddr.core.Publisher" class="py-name" href="#" onclick="return doclink('link-3', 'Publisher', 'link-3');">Publisher</a></tt> </tt> +<a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"> </tt> +<a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Constants.</tt> </tt> +<a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-comment">#: Path to local copy of IEEE OUI Registry data file.</tt> </tt> +<a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-4" class="py-name" targets="Variable netaddr.eui.IEEE_OUI_REGISTRY=netaddr.eui-module.html#IEEE_OUI_REGISTRY"><a title="netaddr.eui.IEEE_OUI_REGISTRY" class="py-name" href="#" onclick="return doclink('link-4', 'IEEE_OUI_REGISTRY', 'link-4');">IEEE_OUI_REGISTRY</a></tt> <tt class="py-op">=</tt> <tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">dirname</tt><tt class="py-op">(</tt><tt class="py-name">__file__</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'oui.txt'</tt><tt class="py-op">)</tt> </tt> +<a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"><tt class="py-comment">#: Path to netaddr OUI index file.</tt> </tt> +<a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-5" class="py-name" targets="Variable netaddr.eui.IEEE_OUI_METADATA=netaddr.eui-module.html#IEEE_OUI_METADATA"><a title="netaddr.eui.IEEE_OUI_METADATA" class="py-name" href="#" onclick="return doclink('link-5', 'IEEE_OUI_METADATA', 'link-5');">IEEE_OUI_METADATA</a></tt> <tt class="py-op">=</tt> <tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">dirname</tt><tt class="py-op">(</tt><tt class="py-name">__file__</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'oui.idx'</tt><tt class="py-op">)</tt> </tt> +<a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"> </tt> +<a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"><tt class="py-comment">#: OUI index lookup dictionary.</tt> </tt> +<a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-6" class="py-name" targets="Variable netaddr.eui.IEEE_OUI_INDEX=netaddr.eui-module.html#IEEE_OUI_INDEX"><a title="netaddr.eui.IEEE_OUI_INDEX" class="py-name" href="#" onclick="return doclink('link-6', 'IEEE_OUI_INDEX', 'link-6');">IEEE_OUI_INDEX</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt> +<a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"> </tt> +<a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"><tt class="py-comment">#: Path to local copy of IEEE IAB Registry data file.</tt> </tt> +<a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-7" class="py-name" targets="Variable netaddr.eui.IEEE_IAB_REGISTRY=netaddr.eui-module.html#IEEE_IAB_REGISTRY"><a title="netaddr.eui.IEEE_IAB_REGISTRY" class="py-name" href="#" onclick="return doclink('link-7', 'IEEE_IAB_REGISTRY', 'link-7');">IEEE_IAB_REGISTRY</a></tt> <tt class="py-op">=</tt> <tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">dirname</tt><tt class="py-op">(</tt><tt class="py-name">__file__</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'iab.txt'</tt><tt class="py-op">)</tt> </tt> +<a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"> </tt> +<a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt class="py-comment">#: Path to netaddr IAB index file.</tt> </tt> +<a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-8" class="py-name" targets="Variable netaddr.eui.IEEE_IAB_METADATA=netaddr.eui-module.html#IEEE_IAB_METADATA"><a title="netaddr.eui.IEEE_IAB_METADATA" class="py-name" href="#" onclick="return doclink('link-8', 'IEEE_IAB_METADATA', 'link-8');">IEEE_IAB_METADATA</a></tt> <tt class="py-op">=</tt> <tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">dirname</tt><tt class="py-op">(</tt><tt class="py-name">__file__</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-string">'iab.idx'</tt><tt class="py-op">)</tt> </tt> +<a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"> </tt> +<a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"><tt class="py-comment">#: IAB index lookup dictionary.</tt> </tt> +<a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-9" class="py-name" targets="Variable netaddr.eui.IEEE_IAB_INDEX=netaddr.eui-module.html#IEEE_IAB_INDEX"><a title="netaddr.eui.IEEE_IAB_INDEX" class="py-name" href="#" onclick="return doclink('link-9', 'IEEE_IAB_INDEX', 'link-9');">IEEE_IAB_INDEX</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt> +<a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"> </tt> +<a name="NotRegisteredError"></a><div id="NotRegisteredError-def"><a name="L48"></a><tt class="py-lineno"> 48</tt> <a class="py-toggle" href="#" id="NotRegisteredError-toggle" onclick="return toggle('NotRegisteredError');">-</a><tt class="py-line"><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.eui.NotRegisteredError-class.html">NotRegisteredError</a><tt class="py-op">(</tt><tt class="py-base-class">Exception</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="NotRegisteredError-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="NotRegisteredError-expanded"><a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"><tt class="py-docstring"> An Exception indicating that an OUI or IAB was not found in the IEEE</tt> </tt> +<a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"><tt class="py-docstring"> Registry.</tt> </tt> +<a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +</div><a name="L54"></a><tt class="py-lineno"> 54</tt> <tt class="py-line"> </tt> +<a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="FileIndexer"></a><div id="FileIndexer-def"><a name="L56"></a><tt class="py-lineno"> 56</tt> <a class="py-toggle" href="#" id="FileIndexer-toggle" onclick="return toggle('FileIndexer');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.eui.FileIndexer-class.html">FileIndexer</a><tt class="py-op">(</tt><tt class="py-base-class">Subscriber</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="FileIndexer-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="FileIndexer-expanded"><a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"> <tt class="py-docstring">"""Stores index data found by a parser in a CSV file"""</tt> </tt> +<a name="FileIndexer.__init__"></a><div id="FileIndexer.__init__-def"><a name="L58"></a><tt class="py-lineno"> 58</tt> <a class="py-toggle" href="#" id="FileIndexer.__init__-toggle" onclick="return toggle('FileIndexer.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.FileIndexer-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">filename</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="FileIndexer.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="FileIndexer.__init__-expanded"><a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"><tt class="py-docstring"> filename - location of CSV index file.</tt> </tt> +<a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-string">'w'</tt><tt class="py-op">)</tt> </tt> +<a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">writer</tt> <tt class="py-op">=</tt> <tt class="py-name">_csv</tt><tt class="py-op">.</tt><tt class="py-name">writer</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">,</tt> <tt class="py-name">lineterminator</tt><tt class="py-op">=</tt><tt class="py-string">"\n"</tt><tt class="py-op">)</tt> </tt> +</div><a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"> </tt> +<a name="FileIndexer.update"></a><div id="FileIndexer.update-def"><a name="L67"></a><tt class="py-lineno"> 67</tt> <a class="py-toggle" href="#" id="FileIndexer.update-toggle" onclick="return toggle('FileIndexer.update');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.FileIndexer-class.html#update">update</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="FileIndexer.update-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="FileIndexer.update-expanded"><a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"><tt class="py-docstring"> Write received record to a CSV file</tt> </tt> +<a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"><tt class="py-docstring"> @param data: record containing offset record information.</tt> </tt> +<a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">writer</tt><tt class="py-op">.</tt><tt class="py-name">writerow</tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"> </tt> +<a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="OUIIndexParser"></a><div id="OUIIndexParser-def"><a name="L76"></a><tt class="py-lineno"> 76</tt> <a class="py-toggle" href="#" id="OUIIndexParser-toggle" onclick="return toggle('OUIIndexParser');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.eui.OUIIndexParser-class.html">OUIIndexParser</a><tt class="py-op">(</tt><tt class="py-base-class">Publisher</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUIIndexParser-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="OUIIndexParser-expanded"><a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"><tt class="py-docstring"> A parser that processes OUI (Organisationally Unique Identifier)</tt> </tt> +<a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"><tt class="py-docstring"> registration file data published by the IEEE.</tt> </tt> +<a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"><tt class="py-docstring"> It sends out notifications to registered subscribers for each record it</tt> </tt> +<a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"><tt class="py-docstring"> encounters, passing on the record's position relative to file start</tt> </tt> +<a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"><tt class="py-docstring"> (offset) and the size of the record (in bytes).</tt> </tt> +<a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"><tt class="py-docstring"> The file is available online here :-</tt> </tt> +<a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"><tt class="py-docstring"> http://standards.ieee.org/regauth/oui/oui.txt</tt> </tt> +<a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"><tt class="py-docstring"> Sample record::</tt> </tt> +<a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"><tt class="py-docstring"> 00-CA-FE (hex) ACME CORPORATION</tt> </tt> +<a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"><tt class="py-docstring"> 00CAFE (base 16) ACME CORPORATION</tt> </tt> +<a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"><tt class="py-docstring"> 1 MAIN STREET</tt> </tt> +<a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"><tt class="py-docstring"> SPRINGFIELD</tt> </tt> +<a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"><tt class="py-docstring"> UNITED STATES</tt> </tt> +<a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="OUIIndexParser.__init__"></a><div id="OUIIndexParser.__init__-def"><a name="L97"></a><tt class="py-lineno"> 97</tt> <a class="py-toggle" href="#" id="OUIIndexParser.__init__-toggle" onclick="return toggle('OUIIndexParser.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUIIndexParser-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">filename</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUIIndexParser.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUIIndexParser.__init__-expanded"><a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L100"></a><tt class="py-lineno">100</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L101"></a><tt class="py-lineno">101</tt> <tt class="py-line"><tt class="py-docstring"> filename - location of file containing OUI records.</tt> </tt> +<a name="L102"></a><tt class="py-lineno">102</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L103"></a><tt class="py-lineno">103</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-10" class="py-name" targets="Class netaddr.eui.OUIIndexParser=netaddr.eui.OUIIndexParser-class.html"><a title="netaddr.eui.OUIIndexParser" class="py-name" href="#" onclick="return doclink('link-10', 'OUIIndexParser', 'link-10');">OUIIndexParser</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-11" class="py-name" targets="Method netaddr.address.Addr.__init__()=netaddr.address.Addr-class.html#__init__,Method netaddr.address.AddrTypeDescriptor.__init__()=netaddr.address.AddrTypeDescriptor-class.html#__init__,Method netaddr.address.AddrValueDescriptor.__init__()=netaddr.address.AddrValueDescriptor-class.html#__init__,Method netaddr.address.CIDR.__init__()=netaddr.address.CIDR-class.html#__init__,Method netaddr.address.EUI.__init__()=netaddr.address.EUI-class.html#__init__,Method netaddr.address.FormatDescriptor.__init__()=netaddr.address.FormatDescriptor-class.html#__init__,Method netaddr.address.IP.__init__()=netaddr.address.IP-class.html#__init__,Method netaddr.address.IPRange.__init__()=netaddr.address.IPRange-class.html#__init__,Method netaddr.address.IPRangeSet.__init__()=netaddr.address.IPRangeSet-class.html#__init__,Method netaddr.address.PrefixLenDescriptor.__init__()=netaddr.address.PrefixLenDescriptor-class.html#__init__,Method netaddr.address.StrategyDescriptor.__init__()=netaddr.address.StrategyDescriptor-class.html#__init__,Method netaddr.address.Wildcard.__init__()=netaddr.address.Wildcard-class.html#__init__,Method netaddr.core.PrettyPrinter.__init__()=netaddr.core.PrettyPrinter-class.html#__init__,Method netaddr.core.Publisher.__init__()=netaddr.core.Publisher-class.html#__init__,Method netaddr.eui.FileIndexer.__init__()=netaddr.eui.FileIndexer-class.html#__init__,Method netaddr.eui.IAB.__init__()=netaddr.eui.IAB-class.html#__init__,Method netaddr.eui.IABIndexParser.__init__()=netaddr.eui.IABIndexParser-class.html#__init__,Method netaddr.eui.OUI.__init__()=netaddr.eui.OUI-class.html#__init__,Method netaddr.eui.OUIIndexParser.__init__()=netaddr.eui.OUIIndexParser-class.html#__init__,Method netaddr.ip.DictUpdater.__init__()=netaddr.ip.DictUpdater-class.html#__init__,Method netaddr.ip.IPv4Parser.__init__()=netaddr.ip.IPv4Parser-class.html#__init__,Method netaddr.ip.IPv6Parser.__init__()=netaddr.ip.IPv6Parser-class.html#__init__,Method netaddr.ip.LineRecordParser.__init__()=netaddr.ip.LineRecordParser-class.html#__init__,Method netaddr.ip.MulticastParser.__init__()=netaddr.ip.MulticastParser-class.html#__init__,Method netaddr.strategy.AddrStrategy.__init__()=netaddr.strategy.AddrStrategy-class.html#__init__,Method netaddr.strategy.EUI48Strategy.__init__()=netaddr.strategy.EUI48Strategy-class.html#__init__,Method netaddr.strategy.IPv4StrategyOpt.__init__()=netaddr.strategy.IPv4StrategyOpt-class.html#__init__,Method netaddr.strategy.IPv4StrategyStd.__init__()=netaddr.strategy.IPv4StrategyStd-class.html#__init__,Method netaddr.strategy.IPv6Strategy.__init__()=netaddr.strategy.IPv6Strategy-class.html#__init__"><a title="netaddr.address.Addr.__init__ +netaddr.address.AddrTypeDescriptor.__init__ +netaddr.address.AddrValueDescriptor.__init__ +netaddr.address.CIDR.__init__ +netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ +netaddr.address.IP.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ +netaddr.address.PrefixLenDescriptor.__init__ +netaddr.address.StrategyDescriptor.__init__ +netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ +netaddr.strategy.AddrStrategy.__init__ +netaddr.strategy.EUI48Strategy.__init__ +netaddr.strategy.IPv4StrategyOpt.__init__ +netaddr.strategy.IPv4StrategyStd.__init__ +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-11', '__init__', 'link-11');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L104"></a><tt class="py-lineno">104</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-string">'rb'</tt><tt class="py-op">)</tt> </tt> +</div><a name="L105"></a><tt class="py-lineno">105</tt> <tt class="py-line"> </tt> +<a name="OUIIndexParser.parse"></a><div id="OUIIndexParser.parse-def"><a name="L106"></a><tt class="py-lineno">106</tt> <a class="py-toggle" href="#" id="OUIIndexParser.parse-toggle" onclick="return toggle('OUIIndexParser.parse');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUIIndexParser-class.html#parse">parse</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUIIndexParser.parse-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUIIndexParser.parse-expanded"><a name="L107"></a><tt class="py-lineno">107</tt> <tt class="py-line"> <tt class="py-docstring">"""Parse an OUI registration file for records notifying subscribers"""</tt> </tt> +<a name="L108"></a><tt class="py-lineno">108</tt> <tt class="py-line"> <tt class="py-name">skip_header</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L109"></a><tt class="py-lineno">109</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L110"></a><tt class="py-lineno">110</tt> <tt class="py-line"> <tt id="link-12" class="py-name" targets="Method netaddr.address.IPRange.size()=netaddr.address.IPRange-class.html#size"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-12', 'size', 'link-12');">size</a></tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> +<a name="L111"></a><tt class="py-lineno">111</tt> <tt class="py-line"> </tt> +<a name="L112"></a><tt class="py-lineno">112</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L113"></a><tt class="py-lineno">113</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">readline</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-comment"># unbuffered to obtain correct offsets</tt> </tt> +<a name="L114"></a><tt class="py-lineno">114</tt> <tt class="py-line"> </tt> +<a name="L115"></a><tt class="py-lineno">115</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L116"></a><tt class="py-lineno">116</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> <tt class="py-comment"># EOF, we're done</tt> </tt> +<a name="L117"></a><tt class="py-lineno">117</tt> <tt class="py-line"> </tt> +<a name="L118"></a><tt class="py-lineno">118</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">skip_header</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'(hex)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L119"></a><tt class="py-lineno">119</tt> <tt class="py-line"> <tt class="py-name">skip_header</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L120"></a><tt class="py-lineno">120</tt> <tt class="py-line"> </tt> +<a name="L121"></a><tt class="py-lineno">121</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">skip_header</tt><tt class="py-op">:</tt> </tt> +<a name="L122"></a><tt class="py-lineno">122</tt> <tt class="py-line"> <tt class="py-comment"># ignoring header section</tt> </tt> +<a name="L123"></a><tt class="py-lineno">123</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">continue</tt> </tt> +<a name="L124"></a><tt class="py-lineno">124</tt> <tt class="py-line"> </tt> +<a name="L125"></a><tt class="py-lineno">125</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'(hex)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L126"></a><tt class="py-lineno">126</tt> <tt class="py-line"> <tt class="py-comment"># record start</tt> </tt> +<a name="L127"></a><tt class="py-lineno">127</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">record</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L128"></a><tt class="py-lineno">128</tt> <tt class="py-line"> <tt class="py-comment"># a complete record.</tt> </tt> +<a name="L129"></a><tt class="py-lineno">129</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">record</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-13" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-13', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L130"></a><tt class="py-lineno">130</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-14" class="py-name" targets="Method netaddr.core.Publisher.notify()=netaddr.core.Publisher-class.html#notify"><a title="netaddr.core.Publisher.notify" class="py-name" href="#" onclick="return doclink('link-14', 'notify', 'link-14');">notify</a></tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +<a name="L131"></a><tt class="py-lineno">131</tt> <tt class="py-line"> </tt> +<a name="L132"></a><tt class="py-lineno">132</tt> <tt class="py-line"> <tt id="link-15" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-15', 'size', 'link-12');">size</a></tt> <tt class="py-op">=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt> +<a name="L133"></a><tt class="py-lineno">133</tt> <tt class="py-line"> <tt class="py-name">offset</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">tell</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L134"></a><tt class="py-lineno">134</tt> <tt class="py-line"> <tt id="link-16" class="py-name" targets="Method netaddr.address.EUI.oui()=netaddr.address.EUI-class.html#oui"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-16', 'oui', 'link-16');">oui</a></tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L135"></a><tt class="py-lineno">135</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-17" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-17', 'oui', 'link-16');">oui</a></tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L136"></a><tt class="py-lineno">136</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">offset</tt><tt class="py-op">]</tt> </tt> +<a name="L137"></a><tt class="py-lineno">137</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L138"></a><tt class="py-lineno">138</tt> <tt class="py-line"> <tt class="py-comment"># within record</tt> </tt> +<a name="L139"></a><tt class="py-lineno">139</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-18" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-18', 'size', 'link-12');">size</a></tt> <tt class="py-op">+=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt> +<a name="L140"></a><tt class="py-lineno">140</tt> <tt class="py-line"> </tt> +<a name="L141"></a><tt class="py-lineno">141</tt> <tt class="py-line"> <tt class="py-comment"># process final record on loop exit</tt> </tt> +<a name="L142"></a><tt class="py-lineno">142</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">record</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-19" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-19', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L143"></a><tt class="py-lineno">143</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-20" class="py-name"><a title="netaddr.core.Publisher.notify" class="py-name" href="#" onclick="return doclink('link-20', 'notify', 'link-14');">notify</a></tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L144"></a><tt class="py-lineno">144</tt> <tt class="py-line"> </tt> +<a name="L145"></a><tt class="py-lineno">145</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IABIndexParser"></a><div id="IABIndexParser-def"><a name="L146"></a><tt class="py-lineno">146</tt> <a class="py-toggle" href="#" id="IABIndexParser-toggle" onclick="return toggle('IABIndexParser');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.eui.IABIndexParser-class.html">IABIndexParser</a><tt class="py-op">(</tt><tt class="py-base-class">Publisher</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IABIndexParser-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IABIndexParser-expanded"><a name="L147"></a><tt class="py-lineno">147</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L148"></a><tt class="py-lineno">148</tt> <tt class="py-line"><tt class="py-docstring"> A parser that processes IAB (Individual Address Block) registration file</tt> </tt> +<a name="L149"></a><tt class="py-lineno">149</tt> <tt class="py-line"><tt class="py-docstring"> data published by the IEEE.</tt> </tt> +<a name="L150"></a><tt class="py-lineno">150</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L151"></a><tt class="py-lineno">151</tt> <tt class="py-line"><tt class="py-docstring"> It sends out notifications to registered Subscriber objects for each</tt> </tt> +<a name="L152"></a><tt class="py-lineno">152</tt> <tt class="py-line"><tt class="py-docstring"> record it encounters, passing on the record's position relative to file</tt> </tt> +<a name="L153"></a><tt class="py-lineno">153</tt> <tt class="py-line"><tt class="py-docstring"> start (offset) and the size of the record (in bytes).</tt> </tt> +<a name="L154"></a><tt class="py-lineno">154</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L155"></a><tt class="py-lineno">155</tt> <tt class="py-line"><tt class="py-docstring"> The file is available online here :-</tt> </tt> +<a name="L156"></a><tt class="py-lineno">156</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L157"></a><tt class="py-lineno">157</tt> <tt class="py-line"><tt class="py-docstring"> http://standards.ieee.org/regauth/iab/iab.txt</tt> </tt> +<a name="L158"></a><tt class="py-lineno">158</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L159"></a><tt class="py-lineno">159</tt> <tt class="py-line"><tt class="py-docstring"> Sample record::</tt> </tt> +<a name="L160"></a><tt class="py-lineno">160</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L161"></a><tt class="py-lineno">161</tt> <tt class="py-line"><tt class="py-docstring"> 00-50-C2 (hex) ACME CORPORATION</tt> </tt> +<a name="L162"></a><tt class="py-lineno">162</tt> <tt class="py-line"><tt class="py-docstring"> ABC000-ABCFFF (base 16) ACME CORPORATION</tt> </tt> +<a name="L163"></a><tt class="py-lineno">163</tt> <tt class="py-line"><tt class="py-docstring"> 1 MAIN STREET</tt> </tt> +<a name="L164"></a><tt class="py-lineno">164</tt> <tt class="py-line"><tt class="py-docstring"> SPRINGFIELD</tt> </tt> +<a name="L165"></a><tt class="py-lineno">165</tt> <tt class="py-line"><tt class="py-docstring"> UNITED STATES</tt> </tt> +<a name="L166"></a><tt class="py-lineno">166</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="IABIndexParser.__init__"></a><div id="IABIndexParser.__init__-def"><a name="L167"></a><tt class="py-lineno">167</tt> <a class="py-toggle" href="#" id="IABIndexParser.__init__-toggle" onclick="return toggle('IABIndexParser.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IABIndexParser-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">filename</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IABIndexParser.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IABIndexParser.__init__-expanded"><a name="L168"></a><tt class="py-lineno">168</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L169"></a><tt class="py-lineno">169</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L170"></a><tt class="py-lineno">170</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L171"></a><tt class="py-lineno">171</tt> <tt class="py-line"><tt class="py-docstring"> filename - location of file containing IAB records.</tt> </tt> +<a name="L172"></a><tt class="py-lineno">172</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L173"></a><tt class="py-lineno">173</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-21" class="py-name" targets="Class netaddr.eui.IABIndexParser=netaddr.eui.IABIndexParser-class.html"><a title="netaddr.eui.IABIndexParser" class="py-name" href="#" onclick="return doclink('link-21', 'IABIndexParser', 'link-21');">IABIndexParser</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-22" class="py-name"><a title="netaddr.address.Addr.__init__ +netaddr.address.AddrTypeDescriptor.__init__ +netaddr.address.AddrValueDescriptor.__init__ +netaddr.address.CIDR.__init__ +netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ +netaddr.address.IP.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ +netaddr.address.PrefixLenDescriptor.__init__ +netaddr.address.StrategyDescriptor.__init__ +netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ +netaddr.strategy.AddrStrategy.__init__ +netaddr.strategy.EUI48Strategy.__init__ +netaddr.strategy.IPv4StrategyOpt.__init__ +netaddr.strategy.IPv4StrategyStd.__init__ +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-22', '__init__', 'link-11');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L174"></a><tt class="py-lineno">174</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">filename</tt><tt class="py-op">,</tt> <tt class="py-string">'rb'</tt><tt class="py-op">)</tt> </tt> +</div><a name="L175"></a><tt class="py-lineno">175</tt> <tt class="py-line"> </tt> +<a name="IABIndexParser.parse"></a><div id="IABIndexParser.parse-def"><a name="L176"></a><tt class="py-lineno">176</tt> <a class="py-toggle" href="#" id="IABIndexParser.parse-toggle" onclick="return toggle('IABIndexParser.parse');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IABIndexParser-class.html#parse">parse</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IABIndexParser.parse-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IABIndexParser.parse-expanded"><a name="L177"></a><tt class="py-lineno">177</tt> <tt class="py-line"> <tt class="py-docstring">"""Parse an IAB registration file for records notifying subscribers"""</tt> </tt> +<a name="L178"></a><tt class="py-lineno">178</tt> <tt class="py-line"> <tt class="py-name">skip_header</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L179"></a><tt class="py-lineno">179</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L180"></a><tt class="py-lineno">180</tt> <tt class="py-line"> <tt id="link-23" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-23', 'size', 'link-12');">size</a></tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> +<a name="L181"></a><tt class="py-lineno">181</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L182"></a><tt class="py-lineno">182</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">readline</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-comment"># unbuffered</tt> </tt> +<a name="L183"></a><tt class="py-lineno">183</tt> <tt class="py-line"> </tt> +<a name="L184"></a><tt class="py-lineno">184</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L185"></a><tt class="py-lineno">185</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> <tt class="py-comment"># EOF, we're done</tt> </tt> +<a name="L186"></a><tt class="py-lineno">186</tt> <tt class="py-line"> </tt> +<a name="L187"></a><tt class="py-lineno">187</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">skip_header</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'(hex)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L188"></a><tt class="py-lineno">188</tt> <tt class="py-line"> <tt class="py-name">skip_header</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L189"></a><tt class="py-lineno">189</tt> <tt class="py-line"> </tt> +<a name="L190"></a><tt class="py-lineno">190</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">skip_header</tt><tt class="py-op">:</tt> </tt> +<a name="L191"></a><tt class="py-lineno">191</tt> <tt class="py-line"> <tt class="py-comment"># ignoring header section</tt> </tt> +<a name="L192"></a><tt class="py-lineno">192</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">continue</tt> </tt> +<a name="L193"></a><tt class="py-lineno">193</tt> <tt class="py-line"> </tt> +<a name="L194"></a><tt class="py-lineno">194</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'(hex)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L195"></a><tt class="py-lineno">195</tt> <tt class="py-line"> <tt class="py-comment"># record start</tt> </tt> +<a name="L196"></a><tt class="py-lineno">196</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">record</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L197"></a><tt class="py-lineno">197</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-24" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-24', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L198"></a><tt class="py-lineno">198</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-25" class="py-name"><a title="netaddr.core.Publisher.notify" class="py-name" href="#" onclick="return doclink('link-25', 'notify', 'link-14');">notify</a></tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +<a name="L199"></a><tt class="py-lineno">199</tt> <tt class="py-line"> </tt> +<a name="L200"></a><tt class="py-lineno">200</tt> <tt class="py-line"> <tt class="py-name">offset</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">tell</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L201"></a><tt class="py-lineno">201</tt> <tt class="py-line"> <tt class="py-name">iab_prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L202"></a><tt class="py-lineno">202</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">=</tt> <tt class="py-name">iab_prefix</tt> </tt> +<a name="L203"></a><tt class="py-lineno">203</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">,</tt> <tt class="py-name">offset</tt><tt class="py-op">]</tt> </tt> +<a name="L204"></a><tt class="py-lineno">204</tt> <tt class="py-line"> <tt id="link-26" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-26', 'size', 'link-12');">size</a></tt> <tt class="py-op">=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt> +<a name="L205"></a><tt class="py-lineno">205</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'(base 16)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L206"></a><tt class="py-lineno">206</tt> <tt class="py-line"> <tt class="py-comment"># within record</tt> </tt> +<a name="L207"></a><tt class="py-lineno">207</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-27" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-27', 'size', 'link-12');">size</a></tt> <tt class="py-op">+=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt> +<a name="L208"></a><tt class="py-lineno">208</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> +<a name="L209"></a><tt class="py-lineno">209</tt> <tt class="py-line"> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L210"></a><tt class="py-lineno">210</tt> <tt class="py-line"> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">suffix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L211"></a><tt class="py-lineno">211</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt> <tt class="py-op">+</tt> <tt class="py-name">suffix</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">>></tt> <tt class="py-number">12</tt> </tt> +<a name="L212"></a><tt class="py-lineno">212</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L213"></a><tt class="py-lineno">213</tt> <tt class="py-line"> <tt class="py-comment"># within record</tt> </tt> +<a name="L214"></a><tt class="py-lineno">214</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-28" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-28', 'size', 'link-12');">size</a></tt> <tt class="py-op">+=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt> +<a name="L215"></a><tt class="py-lineno">215</tt> <tt class="py-line"> </tt> +<a name="L216"></a><tt class="py-lineno">216</tt> <tt class="py-line"> <tt class="py-comment"># process final record on loop exit</tt> </tt> +<a name="L217"></a><tt class="py-lineno">217</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">record</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-29" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-29', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L218"></a><tt class="py-lineno">218</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-30" class="py-name"><a title="netaddr.core.Publisher.notify" class="py-name" href="#" onclick="return doclink('link-30', 'notify', 'link-14');">notify</a></tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L219"></a><tt class="py-lineno">219</tt> <tt class="py-line"> </tt> +<a name="L220"></a><tt class="py-lineno">220</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="OUI"></a><div id="OUI-def"><a name="L221"></a><tt class="py-lineno">221</tt> <a class="py-toggle" href="#" id="OUI-toggle" onclick="return toggle('OUI');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html">OUI</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="OUI-expanded"><a name="L222"></a><tt class="py-lineno">222</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L223"></a><tt class="py-lineno">223</tt> <tt class="py-line"><tt class="py-docstring"> Represents an individual IEEE OUI (Organisationally Unique Identifier)</tt> </tt> +<a name="L224"></a><tt class="py-lineno">224</tt> <tt class="py-line"><tt class="py-docstring"> identifier.</tt> </tt> +<a name="L225"></a><tt class="py-lineno">225</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L226"></a><tt class="py-lineno">226</tt> <tt class="py-line"><tt class="py-docstring"> For online details see - http://standards.ieee.org/regauth/oui/</tt> </tt> +<a name="L227"></a><tt class="py-lineno">227</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="OUI.__init__"></a><div id="OUI.__init__-def"><a name="L228"></a><tt class="py-lineno">228</tt> <a class="py-toggle" href="#" id="OUI.__init__-toggle" onclick="return toggle('OUI.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">oui</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.__init__-expanded"><a name="L229"></a><tt class="py-lineno">229</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L230"></a><tt class="py-lineno">230</tt> <tt class="py-line"><tt class="py-docstring"> Constructor</tt> </tt> +<a name="L231"></a><tt class="py-lineno">231</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L232"></a><tt class="py-lineno">232</tt> <tt class="py-line"><tt class="py-docstring"> @param oui: an OUI string C{XX-XX-XX} or a network byte order integer.</tt> </tt> +<a name="L233"></a><tt class="py-lineno">233</tt> <tt class="py-line"><tt class="py-docstring"> Also accepts and parses full MAC/EUI-48 address strings (but not</tt> </tt> +<a name="L234"></a><tt class="py-lineno">234</tt> <tt class="py-line"><tt class="py-docstring"> MAC/EUI-48 integers)!</tt> </tt> +<a name="L235"></a><tt class="py-lineno">235</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L236"></a><tt class="py-lineno">236</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-31" class="py-name" targets="Variable netaddr.address.Addr.value=netaddr.address.Addr-class.html#value"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-31', 'value', 'link-31');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L237"></a><tt class="py-lineno">237</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">records</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L238"></a><tt class="py-lineno">238</tt> <tt class="py-line"> </tt> +<a name="L239"></a><tt class="py-lineno">239</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-32" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-32', 'oui', 'link-16');">oui</a></tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L240"></a><tt class="py-lineno">240</tt> <tt class="py-line"><tt class="py-comment">#FIXME: Improve string parsing here. Accept full MAC/EUI-48 addressse as</tt> </tt> +<a name="L241"></a><tt class="py-lineno">241</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#FIXME: well as XX-XX-XX and just take /16 (see IAB for details)!</tt> </tt> +<a name="L242"></a><tt class="py-lineno">242</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-33" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-33', 'value', 'link-31');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-34" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-34', 'oui', 'link-16');">oui</a></tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L243"></a><tt class="py-lineno">243</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-35" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-35', 'oui', 'link-16');">oui</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L244"></a><tt class="py-lineno">244</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt id="link-36" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-36', 'oui', 'link-16');">oui</a></tt> <tt class="py-op"><=</tt> <tt class="py-number">0xffffff</tt><tt class="py-op">:</tt> </tt> +<a name="L245"></a><tt class="py-lineno">245</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-37" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-37', 'value', 'link-31');">value</a></tt> <tt class="py-op">=</tt> <tt id="link-38" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-38', 'oui', 'link-16');">oui</a></tt> </tt> +<a name="L246"></a><tt class="py-lineno">246</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L247"></a><tt class="py-lineno">247</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'OUI int outside expected range: %r'</tt> <tt class="py-op">%</tt> <tt id="link-39" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-39', 'oui', 'link-16');">oui</a></tt><tt class="py-op">)</tt> </tt> +<a name="L248"></a><tt class="py-lineno">248</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L249"></a><tt class="py-lineno">249</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unexpected OUI format: %r'</tt> <tt class="py-op">%</tt> <tt id="link-40" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-40', 'oui', 'link-16');">oui</a></tt><tt class="py-op">)</tt> </tt> +<a name="L250"></a><tt class="py-lineno">250</tt> <tt class="py-line"> </tt> +<a name="L251"></a><tt class="py-lineno">251</tt> <tt class="py-line"> <tt class="py-comment"># Discover offsets.</tt> </tt> +<a name="L252"></a><tt class="py-lineno">252</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-41" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-41', 'value', 'link-31');">value</a></tt> <tt class="py-keyword">in</tt> <tt id="link-42" class="py-name"><a title="netaddr.eui.IEEE_OUI_INDEX" class="py-name" href="#" onclick="return doclink('link-42', 'IEEE_OUI_INDEX', 'link-6');">IEEE_OUI_INDEX</a></tt><tt class="py-op">:</tt> </tt> +<a name="L253"></a><tt class="py-lineno">253</tt> <tt class="py-line"> <tt class="py-name">fh</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt id="link-43" class="py-name"><a title="netaddr.eui.IEEE_OUI_REGISTRY" class="py-name" href="#" onclick="return doclink('link-43', 'IEEE_OUI_REGISTRY', 'link-4');">IEEE_OUI_REGISTRY</a></tt><tt class="py-op">,</tt> <tt class="py-string">'rb'</tt><tt class="py-op">)</tt> </tt> +<a name="L254"></a><tt class="py-lineno">254</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-44" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-44', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt id="link-45" class="py-name"><a title="netaddr.eui.IEEE_OUI_INDEX" class="py-name" href="#" onclick="return doclink('link-45', 'IEEE_OUI_INDEX', 'link-6');">IEEE_OUI_INDEX</a></tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-46" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-46', 'value', 'link-31');">value</a></tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> +<a name="L255"></a><tt class="py-lineno">255</tt> <tt class="py-line"> <tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">seek</tt><tt class="py-op">(</tt><tt class="py-name">offset</tt><tt class="py-op">)</tt> </tt> +<a name="L256"></a><tt class="py-lineno">256</tt> <tt class="py-line"> <tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt id="link-47" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-47', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L257"></a><tt class="py-lineno">257</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_parse_data</tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">,</tt> <tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-48" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-48', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L258"></a><tt class="py-lineno">258</tt> <tt class="py-line"> <tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L259"></a><tt class="py-lineno">259</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L260"></a><tt class="py-lineno">260</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-49" class="py-name" targets="Class netaddr.eui.NotRegisteredError=netaddr.eui.NotRegisteredError-class.html"><a title="netaddr.eui.NotRegisteredError" class="py-name" href="#" onclick="return doclink('link-49', 'NotRegisteredError', 'link-49');">NotRegisteredError</a></tt><tt class="py-op">(</tt><tt class="py-string">'OUI %r not registered!'</tt> <tt class="py-op">%</tt> <tt id="link-50" class="py-name"><a title="netaddr.address.EUI.oui" class="py-name" href="#" onclick="return doclink('link-50', 'oui', 'link-16');">oui</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L261"></a><tt class="py-lineno">261</tt> <tt class="py-line"> </tt> +<a name="OUI._parse_data"></a><div id="OUI._parse_data-def"><a name="L262"></a><tt class="py-lineno">262</tt> <a class="py-toggle" href="#" id="OUI._parse_data-toggle" onclick="return toggle('OUI._parse_data');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#_parse_data">_parse_data</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">,</tt> <tt class="py-param">offset</tt><tt class="py-op">,</tt> <tt class="py-param">size</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI._parse_data-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI._parse_data-expanded"><a name="L263"></a><tt class="py-lineno">263</tt> <tt class="py-line"> <tt class="py-docstring">"""Returns a dict record from raw OUI record data"""</tt> </tt> +<a name="L264"></a><tt class="py-lineno">264</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt> +<a name="L265"></a><tt class="py-lineno">265</tt> <tt class="py-line"> <tt class="py-string">'idx'</tt><tt class="py-op">:</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> </tt> +<a name="L266"></a><tt class="py-lineno">266</tt> <tt class="py-line"> <tt class="py-string">'oui'</tt><tt class="py-op">:</tt> <tt class="py-string">''</tt><tt class="py-op">,</tt> </tt> +<a name="L267"></a><tt class="py-lineno">267</tt> <tt class="py-line"> <tt class="py-string">'org'</tt><tt class="py-op">:</tt> <tt class="py-string">''</tt><tt class="py-op">,</tt> </tt> +<a name="L268"></a><tt class="py-lineno">268</tt> <tt class="py-line"> <tt class="py-string">'address'</tt> <tt class="py-op">:</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt> +<a name="L269"></a><tt class="py-lineno">269</tt> <tt class="py-line"> <tt class="py-string">'offset'</tt><tt class="py-op">:</tt> <tt class="py-name">offset</tt><tt class="py-op">,</tt> </tt> +<a name="L270"></a><tt class="py-lineno">270</tt> <tt class="py-line"> <tt class="py-string">'size'</tt><tt class="py-op">:</tt> <tt id="link-51" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-51', 'size', 'link-12');">size</a></tt><tt class="py-op">,</tt> </tt> +<a name="L271"></a><tt class="py-lineno">271</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt> +<a name="L272"></a><tt class="py-lineno">272</tt> <tt class="py-line"> </tt> +<a name="L273"></a><tt class="py-lineno">273</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">data</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">"\n"</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L274"></a><tt class="py-lineno">274</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L275"></a><tt class="py-lineno">275</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">line</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L276"></a><tt class="py-lineno">276</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt> +<a name="L277"></a><tt class="py-lineno">277</tt> <tt class="py-line"> </tt> +<a name="L278"></a><tt class="py-lineno">278</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'(hex)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L279"></a><tt class="py-lineno">279</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'idx'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-52" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-52', 'value', 'link-31');">value</a></tt> </tt> +<a name="L280"></a><tt class="py-lineno">280</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'org'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">' '</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L281"></a><tt class="py-lineno">281</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'oui'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt> +<a name="L282"></a><tt class="py-lineno">282</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'(base 16)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L283"></a><tt class="py-lineno">283</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt> +<a name="L284"></a><tt class="py-lineno">284</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L285"></a><tt class="py-lineno">285</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'address'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt> +<a name="L286"></a><tt class="py-lineno">286</tt> <tt class="py-line"> </tt> +<a name="L287"></a><tt class="py-lineno">287</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">records</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +</div><a name="L288"></a><tt class="py-lineno">288</tt> <tt class="py-line"> </tt> +<a name="OUI.org_count"></a><div id="OUI.org_count-def"><a name="L289"></a><tt class="py-lineno">289</tt> <a class="py-toggle" href="#" id="OUI.org_count-toggle" onclick="return toggle('OUI.org_count');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#org_count">org_count</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.org_count-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.org_count-expanded"><a name="L290"></a><tt class="py-lineno">290</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: number of organisations with this OUI"""</tt> </tt> +<a name="L291"></a><tt class="py-lineno">291</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">records</tt><tt class="py-op">)</tt> </tt> +</div><a name="L292"></a><tt class="py-lineno">292</tt> <tt class="py-line"> </tt> +<a name="OUI.address"></a><div id="OUI.address-def"><a name="L293"></a><tt class="py-lineno">293</tt> <a class="py-toggle" href="#" id="OUI.address-toggle" onclick="return toggle('OUI.address');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#address">address</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.address-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.address-expanded"><a name="L294"></a><tt class="py-lineno">294</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L295"></a><tt class="py-lineno">295</tt> <tt class="py-line"><tt class="py-docstring"> @param index: the index of record (multiple registrations)</tt> </tt> +<a name="L296"></a><tt class="py-lineno">296</tt> <tt class="py-line"><tt class="py-docstring"> (Default: 0 - first registration)</tt> </tt> +<a name="L297"></a><tt class="py-lineno">297</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L298"></a><tt class="py-lineno">298</tt> <tt class="py-line"><tt class="py-docstring"> @return: registered address of organisation linked to OUI</tt> </tt> +<a name="L299"></a><tt class="py-lineno">299</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L300"></a><tt class="py-lineno">300</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">records</tt><tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'address'</tt><tt class="py-op">]</tt> </tt> +</div><a name="L301"></a><tt class="py-lineno">301</tt> <tt class="py-line"> </tt> +<a name="OUI.org"></a><div id="OUI.org-def"><a name="L302"></a><tt class="py-lineno">302</tt> <a class="py-toggle" href="#" id="OUI.org-toggle" onclick="return toggle('OUI.org');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#org">org</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">index</tt><tt class="py-op">=</tt><tt class="py-number">0</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.org-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.org-expanded"><a name="L303"></a><tt class="py-lineno">303</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L304"></a><tt class="py-lineno">304</tt> <tt class="py-line"><tt class="py-docstring"> @param index: the index of record (multiple registrations)</tt> </tt> +<a name="L305"></a><tt class="py-lineno">305</tt> <tt class="py-line"><tt class="py-docstring"> (Default: 0 - first registration)</tt> </tt> +<a name="L306"></a><tt class="py-lineno">306</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L307"></a><tt class="py-lineno">307</tt> <tt class="py-line"><tt class="py-docstring"> @return: the name of organisation linked to OUI</tt> </tt> +<a name="L308"></a><tt class="py-lineno">308</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L309"></a><tt class="py-lineno">309</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">records</tt><tt class="py-op">[</tt><tt class="py-name">index</tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-string">'org'</tt><tt class="py-op">]</tt> </tt> +</div><a name="L310"></a><tt class="py-lineno">310</tt> <tt class="py-line"> </tt> +<a name="L311"></a><tt class="py-lineno">311</tt> <tt class="py-line"> <tt class="py-name">organisation</tt> <tt class="py-op">=</tt> <tt id="link-53" class="py-name" targets="Method netaddr.eui.IAB.org()=netaddr.eui.IAB-class.html#org,Method netaddr.eui.OUI.org()=netaddr.eui.OUI-class.html#org"><a title="netaddr.eui.IAB.org +netaddr.eui.OUI.org" class="py-name" href="#" onclick="return doclink('link-53', 'org', 'link-53');">org</a></tt> </tt> +<a name="L312"></a><tt class="py-lineno">312</tt> <tt class="py-line"> </tt> +<a name="OUI.__int__"></a><div id="OUI.__int__-def"><a name="L313"></a><tt class="py-lineno">313</tt> <a class="py-toggle" href="#" id="OUI.__int__-toggle" onclick="return toggle('OUI.__int__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#__int__">__int__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.__int__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.__int__-expanded"><a name="L314"></a><tt class="py-lineno">314</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: integer representation of this OUI"""</tt> </tt> +<a name="L315"></a><tt class="py-lineno">315</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-54" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-54', 'value', 'link-31');">value</a></tt> </tt> +</div><a name="L316"></a><tt class="py-lineno">316</tt> <tt class="py-line"> </tt> +<a name="OUI.__hex__"></a><div id="OUI.__hex__-def"><a name="L317"></a><tt class="py-lineno">317</tt> <a class="py-toggle" href="#" id="OUI.__hex__-toggle" onclick="return toggle('OUI.__hex__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#__hex__">__hex__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.__hex__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.__hex__-expanded"><a name="L318"></a><tt class="py-lineno">318</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: network byte order hexadecimal string of this OUI"""</tt> </tt> +<a name="L319"></a><tt class="py-lineno">319</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-55" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-55', 'value', 'link-31');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-string">'L'</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L320"></a><tt class="py-lineno">320</tt> <tt class="py-line"> </tt> +<a name="OUI.__str__"></a><div id="OUI.__str__-def"><a name="L321"></a><tt class="py-lineno">321</tt> <a class="py-toggle" href="#" id="OUI.__str__-toggle" onclick="return toggle('OUI.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.__str__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.__str__-expanded"><a name="L322"></a><tt class="py-lineno">322</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: string representation of this OUI"""</tt> </tt> +<a name="L323"></a><tt class="py-lineno">323</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-56" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-56', 'value', 'link-31');">value</a></tt> </tt> +<a name="L324"></a><tt class="py-lineno">324</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L325"></a><tt class="py-lineno">325</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-57" class="py-name" targets="Variable netaddr.address.IP._=netaddr.address.IP-class.html#_,Variable netaddr.strategy.EUI48Strategy._=netaddr.strategy.EUI48Strategy-class.html#_"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-57', '_', 'link-57');">_</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">3</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L326"></a><tt class="py-lineno">326</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-number">0xff</tt> </tt> +<a name="L327"></a><tt class="py-lineno">327</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'%02x'</tt> <tt class="py-op">%</tt> <tt class="py-name">word</tt><tt class="py-op">)</tt> </tt> +<a name="L328"></a><tt class="py-lineno">328</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-number">8</tt> </tt> +<a name="L329"></a><tt class="py-lineno">329</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L330"></a><tt class="py-lineno">330</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L331"></a><tt class="py-lineno">331</tt> <tt class="py-line"> </tt> +<a name="OUI.registration"></a><div id="OUI.registration-def"><a name="L332"></a><tt class="py-lineno">332</tt> <a class="py-toggle" href="#" id="OUI.registration-toggle" onclick="return toggle('OUI.registration');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#registration">registration</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.registration-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.registration-expanded"><a name="L333"></a><tt class="py-lineno">333</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: registration details for this IAB"""</tt> </tt> +<a name="L334"></a><tt class="py-lineno">334</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">records</tt> </tt> +</div><a name="L335"></a><tt class="py-lineno">335</tt> <tt class="py-line"> </tt> +<a name="OUI.__repr__"></a><div id="OUI.__repr__-def"><a name="L336"></a><tt class="py-lineno">336</tt> <a class="py-toggle" href="#" id="OUI.__repr__-toggle" onclick="return toggle('OUI.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.OUI-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="OUI.__repr__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="OUI.__repr__-expanded"><a name="L337"></a><tt class="py-lineno">337</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object."""</tt> </tt> +<a name="L338"></a><tt class="py-lineno">338</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'%s(%r)'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L339"></a><tt class="py-lineno">339</tt> <tt class="py-line"> </tt> +<a name="L340"></a><tt class="py-lineno">340</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IAB"></a><div id="IAB-def"><a name="L341"></a><tt class="py-lineno">341</tt> <a class="py-toggle" href="#" id="IAB-toggle" onclick="return toggle('IAB');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html">IAB</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IAB-expanded"><a name="L342"></a><tt class="py-lineno">342</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L343"></a><tt class="py-lineno">343</tt> <tt class="py-line"><tt class="py-docstring"> Represents an individual IEEE IAB (Individual Address Block) identifier.</tt> </tt> +<a name="L344"></a><tt class="py-lineno">344</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L345"></a><tt class="py-lineno">345</tt> <tt class="py-line"><tt class="py-docstring"> For online details see - http://standards.ieee.org/regauth/oui/</tt> </tt> +<a name="L346"></a><tt class="py-lineno">346</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="IAB.split_iab_mac"></a><div id="IAB.split_iab_mac-def"><a name="L347"></a><tt class="py-lineno">347</tt> <a class="py-toggle" href="#" id="IAB.split_iab_mac-toggle" onclick="return toggle('IAB.split_iab_mac');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#split_iab_mac">split_iab_mac</a><tt class="py-op">(</tt><tt class="py-param">eui_int</tt><tt class="py-op">,</tt> <tt class="py-param">strict</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.split_iab_mac-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.split_iab_mac-expanded"><a name="L348"></a><tt class="py-lineno">348</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L349"></a><tt class="py-lineno">349</tt> <tt class="py-line"><tt class="py-docstring"> @param eui_int: a MAC IAB integer value in network byte order.</tt> </tt> +<a name="L350"></a><tt class="py-lineno">350</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L351"></a><tt class="py-lineno">351</tt> <tt class="py-line"><tt class="py-docstring"> @param strict: If True, raises a ValueError if the last 12 bits of</tt> </tt> +<a name="L352"></a><tt class="py-lineno">352</tt> <tt class="py-line"><tt class="py-docstring"> IAB MAC/EUI-48 address are non-zero, ignores them otherwise.</tt> </tt> +<a name="L353"></a><tt class="py-lineno">353</tt> <tt class="py-line"><tt class="py-docstring"> (Default: False)</tt> </tt> +<a name="L354"></a><tt class="py-lineno">354</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L355"></a><tt class="py-lineno">355</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0x50c2000</tt> <tt class="py-op"><=</tt> <tt class="py-name">eui_int</tt> <tt class="py-op"><=</tt> <tt class="py-number">0x50c2fff</tt><tt class="py-op">:</tt> </tt> +<a name="L356"></a><tt class="py-lineno">356</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">eui_int</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt> </tt> +<a name="L357"></a><tt class="py-lineno">357</tt> <tt class="py-line"> </tt> +<a name="L358"></a><tt class="py-lineno">358</tt> <tt class="py-line"> <tt class="py-name">user_mask</tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-number">12</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L359"></a><tt class="py-lineno">359</tt> <tt class="py-line"> <tt class="py-name">iab_mask</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-number">48</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> <tt class="py-op">^</tt> <tt class="py-name">user_mask</tt> </tt> +<a name="L360"></a><tt class="py-lineno">360</tt> <tt class="py-line"> <tt class="py-name">iab_bits</tt> <tt class="py-op">=</tt> <tt class="py-name">eui_int</tt> <tt class="py-op">>></tt> <tt class="py-number">12</tt> </tt> +<a name="L361"></a><tt class="py-lineno">361</tt> <tt class="py-line"> <tt class="py-name">user_bits</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">eui_int</tt> <tt class="py-op">|</tt> <tt class="py-name">iab_mask</tt><tt class="py-op">)</tt> <tt class="py-op">-</tt> <tt class="py-name">iab_mask</tt> </tt> +<a name="L362"></a><tt class="py-lineno">362</tt> <tt class="py-line"> </tt> +<a name="L363"></a><tt class="py-lineno">363</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0x50c2000</tt> <tt class="py-op"><=</tt> <tt class="py-name">iab_bits</tt> <tt class="py-op"><=</tt> <tt class="py-number">0x50c2fff</tt><tt class="py-op">:</tt> </tt> +<a name="L364"></a><tt class="py-lineno">364</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">strict</tt> <tt class="py-keyword">and</tt> <tt class="py-name">user_bits</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L365"></a><tt class="py-lineno">365</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a strict IAB!'</tt> <tt class="py-op">%</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">user_bits</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L366"></a><tt class="py-lineno">366</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L367"></a><tt class="py-lineno">367</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not an IAB address!'</tt> <tt class="py-op">%</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">eui_int</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L368"></a><tt class="py-lineno">368</tt> <tt class="py-line"> </tt> +<a name="L369"></a><tt class="py-lineno">369</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">iab_bits</tt><tt class="py-op">,</tt> <tt class="py-name">user_bits</tt> </tt> +</div><a name="L370"></a><tt class="py-lineno">370</tt> <tt class="py-line"> </tt> +<a name="L371"></a><tt class="py-lineno">371</tt> <tt class="py-line"> <tt id="link-58" class="py-name" targets="Static Method netaddr.eui.IAB.split_iab_mac()=netaddr.eui.IAB-class.html#split_iab_mac"><a title="netaddr.eui.IAB.split_iab_mac" class="py-name" href="#" onclick="return doclink('link-58', 'split_iab_mac', 'link-58');">split_iab_mac</a></tt> <tt class="py-op">=</tt> <tt class="py-name">staticmethod</tt><tt class="py-op">(</tt><tt id="link-59" class="py-name"><a title="netaddr.eui.IAB.split_iab_mac" class="py-name" href="#" onclick="return doclink('link-59', 'split_iab_mac', 'link-58');">split_iab_mac</a></tt><tt class="py-op">)</tt> </tt> +<a name="L372"></a><tt class="py-lineno">372</tt> <tt class="py-line"> </tt> +<a name="IAB.__init__"></a><div id="IAB.__init__-def"><a name="L373"></a><tt class="py-lineno">373</tt> <a class="py-toggle" href="#" id="IAB.__init__-toggle" onclick="return toggle('IAB.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">iab</tt><tt class="py-op">,</tt> <tt class="py-param">strict</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.__init__-expanded"><a name="L374"></a><tt class="py-lineno">374</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L375"></a><tt class="py-lineno">375</tt> <tt class="py-line"><tt class="py-docstring"> Constructor</tt> </tt> +<a name="L376"></a><tt class="py-lineno">376</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L377"></a><tt class="py-lineno">377</tt> <tt class="py-line"><tt class="py-docstring"> @param iab: an IAB string C{00-50-C2-XX-X0-00} or a network byte order</tt> </tt> +<a name="L378"></a><tt class="py-lineno">378</tt> <tt class="py-line"><tt class="py-docstring"> integer. This address looks like an EUI-48 but it should not have</tt> </tt> +<a name="L379"></a><tt class="py-lineno">379</tt> <tt class="py-line"><tt class="py-docstring"> any non-zero bits in the last 3 bytes.</tt> </tt> +<a name="L380"></a><tt class="py-lineno">380</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L381"></a><tt class="py-lineno">381</tt> <tt class="py-line"><tt class="py-docstring"> @param strict: If True, raises a ValueError if the last 12 bits of</tt> </tt> +<a name="L382"></a><tt class="py-lineno">382</tt> <tt class="py-line"><tt class="py-docstring"> IAB MAC/EUI-48 address are non-zero, ignores them otherwise.</tt> </tt> +<a name="L383"></a><tt class="py-lineno">383</tt> <tt class="py-line"><tt class="py-docstring"> (Default: False)</tt> </tt> +<a name="L384"></a><tt class="py-lineno">384</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L385"></a><tt class="py-lineno">385</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-60" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-60', 'value', 'link-31');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L386"></a><tt class="py-lineno">386</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt> +<a name="L387"></a><tt class="py-lineno">387</tt> <tt class="py-line"> <tt class="py-string">'idx'</tt><tt class="py-op">:</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> </tt> +<a name="L388"></a><tt class="py-lineno">388</tt> <tt class="py-line"> <tt class="py-string">'iab'</tt><tt class="py-op">:</tt> <tt class="py-string">''</tt><tt class="py-op">,</tt> </tt> +<a name="L389"></a><tt class="py-lineno">389</tt> <tt class="py-line"> <tt class="py-string">'org'</tt><tt class="py-op">:</tt> <tt class="py-string">''</tt><tt class="py-op">,</tt> </tt> +<a name="L390"></a><tt class="py-lineno">390</tt> <tt class="py-line"> <tt class="py-string">'address'</tt> <tt class="py-op">:</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> </tt> +<a name="L391"></a><tt class="py-lineno">391</tt> <tt class="py-line"> <tt class="py-string">'offset'</tt><tt class="py-op">:</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> </tt> +<a name="L392"></a><tt class="py-lineno">392</tt> <tt class="py-line"> <tt class="py-string">'size'</tt><tt class="py-op">:</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> </tt> +<a name="L393"></a><tt class="py-lineno">393</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt> +<a name="L394"></a><tt class="py-lineno">394</tt> <tt class="py-line"> </tt> +<a name="L395"></a><tt class="py-lineno">395</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-61" class="py-name" targets="Method netaddr.address.EUI.iab()=netaddr.address.EUI-class.html#iab"><a title="netaddr.address.EUI.iab" class="py-name" href="#" onclick="return doclink('link-61', 'iab', 'link-61');">iab</a></tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L396"></a><tt class="py-lineno">396</tt> <tt class="py-line"><tt class="py-comment">#FIXME: Improve string parsing here !!! '00-50-C2' is actually invalid.</tt> </tt> +<a name="L397"></a><tt class="py-lineno">397</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#FIXME: Should be '00-50-C2-00-00-00' (i.e. a full MAC/EUI-48)</tt> </tt> +<a name="L398"></a><tt class="py-lineno">398</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-62" class="py-name"><a title="netaddr.address.EUI.iab" class="py-name" href="#" onclick="return doclink('link-62', 'iab', 'link-61');">iab</a></tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L399"></a><tt class="py-lineno">399</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">iab_int</tt><tt class="py-op">,</tt> <tt class="py-name">user_int</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt id="link-63" class="py-name" targets="Class netaddr.eui.IAB=netaddr.eui.IAB-class.html"><a title="netaddr.eui.IAB" class="py-name" href="#" onclick="return doclink('link-63', 'IAB', 'link-63');">IAB</a></tt><tt class="py-op">.</tt><tt id="link-64" class="py-name"><a title="netaddr.eui.IAB.split_iab_mac" class="py-name" href="#" onclick="return doclink('link-64', 'split_iab_mac', 'link-58');">split_iab_mac</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">,</tt> <tt class="py-name">strict</tt><tt class="py-op">)</tt> </tt> +<a name="L400"></a><tt class="py-lineno">400</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-65" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-65', 'value', 'link-31');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">iab_int</tt> </tt> +<a name="L401"></a><tt class="py-lineno">401</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-66" class="py-name"><a title="netaddr.address.EUI.iab" class="py-name" href="#" onclick="return doclink('link-66', 'iab', 'link-61');">iab</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L402"></a><tt class="py-lineno">402</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">iab_int</tt><tt class="py-op">,</tt> <tt class="py-name">user_int</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt id="link-67" class="py-name"><a title="netaddr.eui.IAB" class="py-name" href="#" onclick="return doclink('link-67', 'IAB', 'link-63');">IAB</a></tt><tt class="py-op">.</tt><tt id="link-68" class="py-name"><a title="netaddr.eui.IAB.split_iab_mac" class="py-name" href="#" onclick="return doclink('link-68', 'split_iab_mac', 'link-58');">split_iab_mac</a></tt><tt class="py-op">(</tt><tt id="link-69" class="py-name"><a title="netaddr.address.EUI.iab" class="py-name" href="#" onclick="return doclink('link-69', 'iab', 'link-61');">iab</a></tt><tt class="py-op">,</tt> <tt class="py-name">strict</tt><tt class="py-op">)</tt> </tt> +<a name="L403"></a><tt class="py-lineno">403</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-70" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-70', 'value', 'link-31');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">iab_int</tt> </tt> +<a name="L404"></a><tt class="py-lineno">404</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L405"></a><tt class="py-lineno">405</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'unexpected IAB format: %r!'</tt> <tt class="py-op">%</tt> <tt id="link-71" class="py-name"><a title="netaddr.address.EUI.iab" class="py-name" href="#" onclick="return doclink('link-71', 'iab', 'link-61');">iab</a></tt><tt class="py-op">)</tt> </tt> +<a name="L406"></a><tt class="py-lineno">406</tt> <tt class="py-line"> </tt> +<a name="L407"></a><tt class="py-lineno">407</tt> <tt class="py-line"> <tt class="py-comment"># Discover offsets.</tt> </tt> +<a name="L408"></a><tt class="py-lineno">408</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-72" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-72', 'value', 'link-31');">value</a></tt> <tt class="py-keyword">in</tt> <tt id="link-73" class="py-name"><a title="netaddr.eui.IEEE_IAB_INDEX" class="py-name" href="#" onclick="return doclink('link-73', 'IEEE_IAB_INDEX', 'link-9');">IEEE_IAB_INDEX</a></tt><tt class="py-op">:</tt> </tt> +<a name="L409"></a><tt class="py-lineno">409</tt> <tt class="py-line"> <tt class="py-name">fh</tt> <tt class="py-op">=</tt> <tt class="py-name">open</tt><tt class="py-op">(</tt><tt id="link-74" class="py-name"><a title="netaddr.eui.IEEE_IAB_REGISTRY" class="py-name" href="#" onclick="return doclink('link-74', 'IEEE_IAB_REGISTRY', 'link-7');">IEEE_IAB_REGISTRY</a></tt><tt class="py-op">,</tt> <tt class="py-string">'rb'</tt><tt class="py-op">)</tt> </tt> +<a name="L410"></a><tt class="py-lineno">410</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-75" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-75', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt id="link-76" class="py-name"><a title="netaddr.eui.IEEE_IAB_INDEX" class="py-name" href="#" onclick="return doclink('link-76', 'IEEE_IAB_INDEX', 'link-9');">IEEE_IAB_INDEX</a></tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-77" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-77', 'value', 'link-31');">value</a></tt><tt class="py-op">]</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L411"></a><tt class="py-lineno">411</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'offset'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">offset</tt> </tt> +<a name="L412"></a><tt class="py-lineno">412</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'size'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-78" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-78', 'size', 'link-12');">size</a></tt> </tt> +<a name="L413"></a><tt class="py-lineno">413</tt> <tt class="py-line"> <tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">seek</tt><tt class="py-op">(</tt><tt class="py-name">offset</tt><tt class="py-op">)</tt> </tt> +<a name="L414"></a><tt class="py-lineno">414</tt> <tt class="py-line"> <tt class="py-name">data</tt> <tt class="py-op">=</tt> <tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">read</tt><tt class="py-op">(</tt><tt id="link-79" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-79', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L415"></a><tt class="py-lineno">415</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">_parse_data</tt><tt class="py-op">(</tt><tt class="py-name">data</tt><tt class="py-op">,</tt> <tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-80" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-80', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> </tt> +<a name="L416"></a><tt class="py-lineno">416</tt> <tt class="py-line"> <tt class="py-name">fh</tt><tt class="py-op">.</tt><tt class="py-name">close</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L417"></a><tt class="py-lineno">417</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L418"></a><tt class="py-lineno">418</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-81" class="py-name"><a title="netaddr.eui.NotRegisteredError" class="py-name" href="#" onclick="return doclink('link-81', 'NotRegisteredError', 'link-49');">NotRegisteredError</a></tt><tt class="py-op">(</tt><tt class="py-string">'IAB %r not unregistered!'</tt> <tt class="py-op">%</tt> <tt id="link-82" class="py-name"><a title="netaddr.address.EUI.iab" class="py-name" href="#" onclick="return doclink('link-82', 'iab', 'link-61');">iab</a></tt><tt class="py-op">)</tt> </tt> +</div><a name="L419"></a><tt class="py-lineno">419</tt> <tt class="py-line"> </tt> +<a name="IAB._parse_data"></a><div id="IAB._parse_data-def"><a name="L420"></a><tt class="py-lineno">420</tt> <a class="py-toggle" href="#" id="IAB._parse_data-toggle" onclick="return toggle('IAB._parse_data');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#_parse_data">_parse_data</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">,</tt> <tt class="py-param">offset</tt><tt class="py-op">,</tt> <tt class="py-param">size</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB._parse_data-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB._parse_data-expanded"><a name="L421"></a><tt class="py-lineno">421</tt> <tt class="py-line"> <tt class="py-docstring">"""Returns a dict record from raw IAB record data"""</tt> </tt> +<a name="L422"></a><tt class="py-lineno">422</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">data</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">"\n"</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L423"></a><tt class="py-lineno">423</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L424"></a><tt class="py-lineno">424</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">line</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L425"></a><tt class="py-lineno">425</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt> +<a name="L426"></a><tt class="py-lineno">426</tt> <tt class="py-line"> </tt> +<a name="L427"></a><tt class="py-lineno">427</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'(hex)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L428"></a><tt class="py-lineno">428</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'idx'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-83" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-83', 'value', 'link-31');">value</a></tt> </tt> +<a name="L429"></a><tt class="py-lineno">429</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'org'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">' '</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L430"></a><tt class="py-lineno">430</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'iab'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt> </tt> +<a name="L431"></a><tt class="py-lineno">431</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'(base 16)'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">line</tt><tt class="py-op">:</tt> </tt> +<a name="L432"></a><tt class="py-lineno">432</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt> +<a name="L433"></a><tt class="py-lineno">433</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L434"></a><tt class="py-lineno">434</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'address'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt> +</div><a name="L435"></a><tt class="py-lineno">435</tt> <tt class="py-line"> </tt> +<a name="IAB.address"></a><div id="IAB.address-def"><a name="L436"></a><tt class="py-lineno">436</tt> <a class="py-toggle" href="#" id="IAB.address-toggle" onclick="return toggle('IAB.address');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#address">address</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.address-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.address-expanded"><a name="L437"></a><tt class="py-lineno">437</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: registered address of organisation"""</tt> </tt> +<a name="L438"></a><tt class="py-lineno">438</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'address'</tt><tt class="py-op">]</tt> </tt> +</div><a name="L439"></a><tt class="py-lineno">439</tt> <tt class="py-line"> </tt> +<a name="IAB.org"></a><div id="IAB.org-def"><a name="L440"></a><tt class="py-lineno">440</tt> <a class="py-toggle" href="#" id="IAB.org-toggle" onclick="return toggle('IAB.org');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#org">org</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.org-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.org-expanded"><a name="L441"></a><tt class="py-lineno">441</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: the name of organisation"""</tt> </tt> +<a name="L442"></a><tt class="py-lineno">442</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'org'</tt><tt class="py-op">]</tt> </tt> +</div><a name="L443"></a><tt class="py-lineno">443</tt> <tt class="py-line"> </tt> +<a name="L444"></a><tt class="py-lineno">444</tt> <tt class="py-line"> <tt class="py-name">organisation</tt> <tt class="py-op">=</tt> <tt id="link-84" class="py-name"><a title="netaddr.eui.IAB.org +netaddr.eui.OUI.org" class="py-name" href="#" onclick="return doclink('link-84', 'org', 'link-53');">org</a></tt> </tt> +<a name="L445"></a><tt class="py-lineno">445</tt> <tt class="py-line"> </tt> +<a name="IAB.__int__"></a><div id="IAB.__int__-def"><a name="L446"></a><tt class="py-lineno">446</tt> <a class="py-toggle" href="#" id="IAB.__int__-toggle" onclick="return toggle('IAB.__int__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#__int__">__int__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.__int__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.__int__-expanded"><a name="L447"></a><tt class="py-lineno">447</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: integer representation of this IAB"""</tt> </tt> +<a name="L448"></a><tt class="py-lineno">448</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-85" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-85', 'value', 'link-31');">value</a></tt> </tt> +</div><a name="L449"></a><tt class="py-lineno">449</tt> <tt class="py-line"> </tt> +<a name="IAB.__hex__"></a><div id="IAB.__hex__-def"><a name="L450"></a><tt class="py-lineno">450</tt> <a class="py-toggle" href="#" id="IAB.__hex__-toggle" onclick="return toggle('IAB.__hex__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#__hex__">__hex__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.__hex__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.__hex__-expanded"><a name="L451"></a><tt class="py-lineno">451</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: network byte order hexadecimal string of this IAB"""</tt> </tt> +<a name="L452"></a><tt class="py-lineno">452</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-86" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-86', 'value', 'link-31');">value</a></tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-string">'L'</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L453"></a><tt class="py-lineno">453</tt> <tt class="py-line"> </tt> +<a name="IAB.__str__"></a><div id="IAB.__str__-def"><a name="L454"></a><tt class="py-lineno">454</tt> <a class="py-toggle" href="#" id="IAB.__str__-toggle" onclick="return toggle('IAB.__str__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#__str__">__str__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.__str__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.__str__-expanded"><a name="L455"></a><tt class="py-lineno">455</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: string representation of this IAB"""</tt> </tt> +<a name="L456"></a><tt class="py-lineno">456</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-87" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-87', 'value', 'link-31');">value</a></tt> <tt class="py-op"><<</tt> <tt class="py-number">12</tt> </tt> +<a name="L457"></a><tt class="py-lineno">457</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L458"></a><tt class="py-lineno">458</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-88" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-88', '_', 'link-57');">_</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">6</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L459"></a><tt class="py-lineno">459</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-number">0xff</tt> </tt> +<a name="L460"></a><tt class="py-lineno">460</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">'%02x'</tt> <tt class="py-op">%</tt> <tt class="py-name">word</tt><tt class="py-op">)</tt> </tt> +<a name="L461"></a><tt class="py-lineno">461</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-number">8</tt> </tt> +<a name="L462"></a><tt class="py-lineno">462</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L463"></a><tt class="py-lineno">463</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L464"></a><tt class="py-lineno">464</tt> <tt class="py-line"> </tt> +<a name="IAB.registration"></a><div id="IAB.registration-def"><a name="L465"></a><tt class="py-lineno">465</tt> <a class="py-toggle" href="#" id="IAB.registration-toggle" onclick="return toggle('IAB.registration');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#registration">registration</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.registration-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.registration-expanded"><a name="L466"></a><tt class="py-lineno">466</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: registration details for this IAB"""</tt> </tt> +<a name="L467"></a><tt class="py-lineno">467</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record</tt> </tt> +</div><a name="L468"></a><tt class="py-lineno">468</tt> <tt class="py-line"> </tt> +<a name="IAB.__repr__"></a><div id="IAB.__repr__-def"><a name="L469"></a><tt class="py-lineno">469</tt> <a class="py-toggle" href="#" id="IAB.__repr__-toggle" onclick="return toggle('IAB.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui.IAB-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IAB.__repr__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IAB.__repr__-expanded"><a name="L470"></a><tt class="py-lineno">470</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object."""</tt> </tt> +<a name="L471"></a><tt class="py-lineno">471</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'%s(%r)'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L472"></a><tt class="py-lineno">472</tt> <tt class="py-line"> </tt> +<a name="L473"></a><tt class="py-lineno">473</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="create_ieee_indices"></a><div id="create_ieee_indices-def"><a name="L474"></a><tt class="py-lineno">474</tt> <a class="py-toggle" href="#" id="create_ieee_indices-toggle" onclick="return toggle('create_ieee_indices');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui-module.html#create_ieee_indices">create_ieee_indices</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="create_ieee_indices-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="create_ieee_indices-expanded"><a name="L475"></a><tt class="py-lineno">475</tt> <tt class="py-line"> <tt class="py-docstring">"""Create indices for OUI and IAB file based lookups"""</tt> </tt> +<a name="L476"></a><tt class="py-lineno">476</tt> <tt class="py-line"> <tt class="py-name">oui_parser</tt> <tt class="py-op">=</tt> <tt id="link-89" class="py-name"><a title="netaddr.eui.OUIIndexParser" class="py-name" href="#" onclick="return doclink('link-89', 'OUIIndexParser', 'link-10');">OUIIndexParser</a></tt><tt class="py-op">(</tt><tt id="link-90" class="py-name"><a title="netaddr.eui.IEEE_OUI_REGISTRY" class="py-name" href="#" onclick="return doclink('link-90', 'IEEE_OUI_REGISTRY', 'link-4');">IEEE_OUI_REGISTRY</a></tt><tt class="py-op">)</tt> </tt> +<a name="L477"></a><tt class="py-lineno">477</tt> <tt class="py-line"> <tt class="py-name">oui_parser</tt><tt class="py-op">.</tt><tt id="link-91" class="py-name" targets="Method netaddr.core.Publisher.attach()=netaddr.core.Publisher-class.html#attach"><a title="netaddr.core.Publisher.attach" class="py-name" href="#" onclick="return doclink('link-91', 'attach', 'link-91');">attach</a></tt><tt class="py-op">(</tt><tt id="link-92" class="py-name" targets="Class netaddr.eui.FileIndexer=netaddr.eui.FileIndexer-class.html"><a title="netaddr.eui.FileIndexer" class="py-name" href="#" onclick="return doclink('link-92', 'FileIndexer', 'link-92');">FileIndexer</a></tt><tt class="py-op">(</tt><tt id="link-93" class="py-name"><a title="netaddr.eui.IEEE_OUI_METADATA" class="py-name" href="#" onclick="return doclink('link-93', 'IEEE_OUI_METADATA', 'link-5');">IEEE_OUI_METADATA</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L478"></a><tt class="py-lineno">478</tt> <tt class="py-line"> <tt class="py-name">oui_parser</tt><tt class="py-op">.</tt><tt id="link-94" class="py-name" targets="Method netaddr.eui.IABIndexParser.parse()=netaddr.eui.IABIndexParser-class.html#parse,Method netaddr.eui.OUIIndexParser.parse()=netaddr.eui.OUIIndexParser-class.html#parse,Method netaddr.ip.LineRecordParser.parse()=netaddr.ip.LineRecordParser-class.html#parse"><a title="netaddr.eui.IABIndexParser.parse +netaddr.eui.OUIIndexParser.parse +netaddr.ip.LineRecordParser.parse" class="py-name" href="#" onclick="return doclink('link-94', 'parse', 'link-94');">parse</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L479"></a><tt class="py-lineno">479</tt> <tt class="py-line"> </tt> +<a name="L480"></a><tt class="py-lineno">480</tt> <tt class="py-line"> <tt class="py-name">iab_parser</tt> <tt class="py-op">=</tt> <tt id="link-95" class="py-name"><a title="netaddr.eui.IABIndexParser" class="py-name" href="#" onclick="return doclink('link-95', 'IABIndexParser', 'link-21');">IABIndexParser</a></tt><tt class="py-op">(</tt><tt id="link-96" class="py-name"><a title="netaddr.eui.IEEE_IAB_REGISTRY" class="py-name" href="#" onclick="return doclink('link-96', 'IEEE_IAB_REGISTRY', 'link-7');">IEEE_IAB_REGISTRY</a></tt><tt class="py-op">)</tt> </tt> +<a name="L481"></a><tt class="py-lineno">481</tt> <tt class="py-line"> <tt class="py-name">iab_parser</tt><tt class="py-op">.</tt><tt id="link-97" class="py-name"><a title="netaddr.core.Publisher.attach" class="py-name" href="#" onclick="return doclink('link-97', 'attach', 'link-91');">attach</a></tt><tt class="py-op">(</tt><tt id="link-98" class="py-name"><a title="netaddr.eui.FileIndexer" class="py-name" href="#" onclick="return doclink('link-98', 'FileIndexer', 'link-92');">FileIndexer</a></tt><tt class="py-op">(</tt><tt id="link-99" class="py-name"><a title="netaddr.eui.IEEE_IAB_METADATA" class="py-name" href="#" onclick="return doclink('link-99', 'IEEE_IAB_METADATA', 'link-8');">IEEE_IAB_METADATA</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L482"></a><tt class="py-lineno">482</tt> <tt class="py-line"> <tt class="py-name">iab_parser</tt><tt class="py-op">.</tt><tt id="link-100" class="py-name"><a title="netaddr.eui.IABIndexParser.parse +netaddr.eui.OUIIndexParser.parse +netaddr.ip.LineRecordParser.parse" class="py-name" href="#" onclick="return doclink('link-100', 'parse', 'link-94');">parse</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L483"></a><tt class="py-lineno">483</tt> <tt class="py-line"> </tt> +<a name="L484"></a><tt class="py-lineno">484</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="load_ieee_indices"></a><div id="load_ieee_indices-def"><a name="L485"></a><tt class="py-lineno">485</tt> <a class="py-toggle" href="#" id="load_ieee_indices-toggle" onclick="return toggle('load_ieee_indices');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.eui-module.html#load_ieee_indices">load_ieee_indices</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="load_ieee_indices-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="load_ieee_indices-expanded"><a name="L486"></a><tt class="py-lineno">486</tt> <tt class="py-line"> <tt class="py-docstring">"""Load OUI and IAB indices into memory"""</tt> </tt> +<a name="L487"></a><tt class="py-lineno">487</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">row</tt> <tt class="py-keyword">in</tt> <tt class="py-name">_csv</tt><tt class="py-op">.</tt><tt class="py-name">reader</tt><tt class="py-op">(</tt><tt class="py-name">open</tt><tt class="py-op">(</tt><tt id="link-101" class="py-name"><a title="netaddr.eui.IEEE_OUI_METADATA" class="py-name" href="#" onclick="return doclink('link-101', 'IEEE_OUI_METADATA', 'link-5');">IEEE_OUI_METADATA</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L488"></a><tt class="py-lineno">488</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-102" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-102', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-103" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-103', '_', 'link-57');">_</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt id="link-104" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-104', '_', 'link-57');">_</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">row</tt><tt class="py-op">]</tt> </tt> +<a name="L489"></a><tt class="py-lineno">489</tt> <tt class="py-line"> <tt id="link-105" class="py-name"><a title="netaddr.eui.IEEE_OUI_INDEX" class="py-name" href="#" onclick="return doclink('link-105', 'IEEE_OUI_INDEX', 'link-6');">IEEE_OUI_INDEX</a></tt><tt class="py-op">.</tt><tt class="py-name">setdefault</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L490"></a><tt class="py-lineno">490</tt> <tt class="py-line"> <tt id="link-106" class="py-name"><a title="netaddr.eui.IEEE_OUI_INDEX" class="py-name" href="#" onclick="return doclink('link-106', 'IEEE_OUI_INDEX', 'link-6');">IEEE_OUI_INDEX</a></tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-107" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-107', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L491"></a><tt class="py-lineno">491</tt> <tt class="py-line"> </tt> +<a name="L492"></a><tt class="py-lineno">492</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">row</tt> <tt class="py-keyword">in</tt> <tt class="py-name">_csv</tt><tt class="py-op">.</tt><tt class="py-name">reader</tt><tt class="py-op">(</tt><tt class="py-name">open</tt><tt class="py-op">(</tt><tt id="link-108" class="py-name"><a title="netaddr.eui.IEEE_IAB_METADATA" class="py-name" href="#" onclick="return doclink('link-108', 'IEEE_IAB_METADATA', 'link-8');">IEEE_IAB_METADATA</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L493"></a><tt class="py-lineno">493</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-109" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-109', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-110" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-110', '_', 'link-57');">_</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt id="link-111" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-111', '_', 'link-57');">_</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">row</tt><tt class="py-op">]</tt> </tt> +<a name="L494"></a><tt class="py-lineno">494</tt> <tt class="py-line"> <tt id="link-112" class="py-name"><a title="netaddr.eui.IEEE_IAB_INDEX" class="py-name" href="#" onclick="return doclink('link-112', 'IEEE_IAB_INDEX', 'link-9');">IEEE_IAB_INDEX</a></tt><tt class="py-op">.</tt><tt class="py-name">setdefault</tt><tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L495"></a><tt class="py-lineno">495</tt> <tt class="py-line"> <tt id="link-113" class="py-name"><a title="netaddr.eui.IEEE_IAB_INDEX" class="py-name" href="#" onclick="return doclink('link-113', 'IEEE_IAB_INDEX', 'link-9');">IEEE_IAB_INDEX</a></tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">offset</tt><tt class="py-op">,</tt> <tt id="link-114" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-114', 'size', 'link-12');">size</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L496"></a><tt class="py-lineno">496</tt> <tt class="py-line"> </tt> +<a name="L497"></a><tt class="py-lineno">497</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L498"></a><tt class="py-lineno">498</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">if</tt> <tt class="py-name">__name__</tt> <tt class="py-op">==</tt> <tt class="py-string">'__main__'</tt><tt class="py-op">:</tt> </tt> +<a name="L499"></a><tt class="py-lineno">499</tt> <tt class="py-line"> <tt class="py-comment"># Generate indices when module is executed as a script.</tt> </tt> +<a name="L500"></a><tt class="py-lineno">500</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-115" class="py-name" targets="Function netaddr.eui.create_ieee_indices()=netaddr.eui-module.html#create_ieee_indices"><a title="netaddr.eui.create_ieee_indices" class="py-name" href="#" onclick="return doclink('link-115', 'create_ieee_indices', 'link-115');">create_ieee_indices</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L501"></a><tt class="py-lineno">501</tt> <tt class="py-line"> </tt> +<a name="L502"></a><tt class="py-lineno">502</tt> <tt class="py-line"><tt class="py-comment"># On module load read indices in memory to enable lookups.</tt> </tt> +<a name="L503"></a><tt class="py-lineno">503</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-116" class="py-name" targets="Function netaddr.eui.load_ieee_indices()=netaddr.eui-module.html#load_ieee_indices"><a title="netaddr.eui.load_ieee_indices" class="py-name" href="#" onclick="return doclink('link-116', 'load_ieee_indices', 'link-116');">load_ieee_indices</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L504"></a><tt class="py-lineno">504</tt> <tt class="py-line"> </tt><script type="text/javascript"> +<!-- +expandto(location.href); +// --> +</script> +</pre> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:24 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui.FileIndexer-class.html b/docs/api/netaddr.eui.FileIndexer-class.html new file mode 100644 index 0000000..706ed2a --- /dev/null +++ b/docs/api/netaddr.eui.FileIndexer-class.html @@ -0,0 +1,262 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui.FileIndexer</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.eui-module.html" onclick="show_private();">Package eui</a> :: + Class FileIndexer + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui.FileIndexer-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class FileIndexer</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.eui-pysrc.html#FileIndexer">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Subscriber-class.html">core.Subscriber</a> --+ + | + <strong class="uidshort">FileIndexer</strong> +</pre> + +<hr /> +<p>Stores index data found by a parser in a CSV file</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.FileIndexer-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">filename</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#FileIndexer.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.FileIndexer-class.html#update" class="summary-sig-name">update</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">data</span>)</span><br /> + Write received record to a CSV file</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#FileIndexer.update">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">filename</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#FileIndexer.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>filename - location of CSV index file.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="update"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">update</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">data</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#FileIndexer.update">source code</a></span> + </td> + </tr></table> + + <p>Write received record to a CSV file</p> + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>data</code></strong> - record containing offset record information.</li> + </ul></dd> + <dt>Overrides: + <a href="netaddr.core.Subscriber-class.html#update">core.Subscriber.update</a> + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui.IAB-class.html b/docs/api/netaddr.eui.IAB-class.html new file mode 100644 index 0000000..ff00ea8 --- /dev/null +++ b/docs/api/netaddr.eui.IAB-class.html @@ -0,0 +1,599 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui.IAB</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.eui-module.html" onclick="show_private();">Package eui</a> :: + Class IAB + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui.IAB-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class IAB</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB">source code</a></span></p> +<pre class="base-tree"> +object --+ + | + <strong class="uidshort">IAB</strong> +</pre> + +<hr /> +<p>Represents an individual IEEE IAB (Individual Address Block) + identifier.</p> + <p>For online details see - http://standards.ieee.org/regauth/oui/</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">iab</span>, + <span class="summary-sig-arg">strict</span>=<span class="summary-sig-default">False</span>)</span><br /> + Constructor</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#address" class="summary-sig-name">address</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + registered address of organisation</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.address">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#org" class="summary-sig-name">org</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + the name of organisation</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.org">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#organisation" class="summary-sig-name">organisation</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + the name of organisation</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.org">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#__int__" class="summary-sig-name">__int__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + integer representation of this IAB</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__int__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#__hex__" class="summary-sig-name">__hex__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + network byte order hexadecimal string of this IAB</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__hex__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + string representation of this IAB</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__str__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#registration" class="summary-sig-name">registration</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + registration details for this IAB</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.registration">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + executable Python string to recreate equivalent object.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__repr__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__setattr__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== STATIC METHODS ==================== --> +<a name="section-StaticMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Static Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IAB-class.html#split_iab_mac" class="summary-sig-name">split_iab_mac</a>(<span class="summary-sig-arg">eui_int</span>, + <span class="summary-sig-arg">strict</span>=<span class="summary-sig-default">False</span>)</span></td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.split_iab_mac">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="split_iab_mac"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">split_iab_mac</span>(<span class="sig-arg">eui_int</span>, + <span class="sig-arg">strict</span>=<span class="sig-default">False</span>)</span> + <br /><em class="fname">Static Method</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.split_iab_mac">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>eui_int</code></strong> - a MAC IAB integer value in network byte order.</li> + <li><strong class="pname"><code>strict</code></strong> - If True, raises a ValueError if the last 12 bits of IAB + MAC/EUI-48 address are non-zero, ignores them otherwise. + (Default: False)</li> + </ul></dd> + </dl> +</td></tr></table> +</div> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">iab</span>, + <span class="sig-arg">strict</span>=<span class="sig-default">False</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor</p> + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>iab</code></strong> - an IAB string <code>00-50-C2-XX-X0-00</code> or a network byte + order integer. This address looks like an EUI-48 but it should + not have any non-zero bits in the last 3 bytes.</li> + <li><strong class="pname"><code>strict</code></strong> - If True, raises a ValueError if the last 12 bits of IAB + MAC/EUI-48 address are non-zero, ignores them otherwise. + (Default: False)</li> + </ul></dd> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="address"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">address</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.address">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>registered address of organisation</dd> + </dl> +</td></tr></table> +</div> +<a name="org"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">org</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.org">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>the name of organisation</dd> + </dl> +</td></tr></table> +</div> +<a name="organisation"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">organisation</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.org">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>the name of organisation</dd> + </dl> +</td></tr></table> +</div> +<a name="__int__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__int__</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__int__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>integer representation of this IAB</dd> + </dl> +</td></tr></table> +</div> +<a name="__hex__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__hex__</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__hex__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>network byte order hexadecimal string of this IAB</dd> + </dl> +</td></tr></table> +</div> +<a name="__str__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__str__</span>(<span class="sig-arg">self</span>)</span> + <br /><em class="fname">(Informal representation operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__str__">source code</a></span> + </td> + </tr></table> + + <p>str(x)</p> + <dl class="fields"> + <dt>Returns:</dt> + <dd>string representation of this IAB</dd> + <dt>Overrides: + object.__str__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="registration"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">registration</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.registration">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>registration details for this IAB</dd> + </dl> +</td></tr></table> +</div> +<a name="__repr__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__repr__</span>(<span class="sig-arg">self</span>)</span> + <br /><em class="fname">(Representation operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IAB.__repr__">source code</a></span> + </td> + </tr></table> + + <p>repr(x)</p> + <dl class="fields"> + <dt>Returns:</dt> + <dd>executable Python string to recreate equivalent object.</dd> + <dt>Overrides: + object.__repr__ + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui.IABIndexParser-class.html b/docs/api/netaddr.eui.IABIndexParser-class.html new file mode 100644 index 0000000..0fb8662 --- /dev/null +++ b/docs/api/netaddr.eui.IABIndexParser-class.html @@ -0,0 +1,253 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui.IABIndexParser</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.eui-module.html" onclick="show_private();">Package eui</a> :: + Class IABIndexParser + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui.IABIndexParser-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class IABIndexParser</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.eui-pysrc.html#IABIndexParser">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Publisher-class.html">core.Publisher</a> --+ + | + <strong class="uidshort">IABIndexParser</strong> +</pre> + +<hr /> +<p>A parser that processes IAB (Individual Address Block) registration + file data published by the IEEE.</p> + <p>It sends out notifications to registered Subscriber objects for each + record it encounters, passing on the record's position relative to file + start (offset) and the size of the record (in bytes).</p> + <p>The file is available online here :-</p> + <p>http://standards.ieee.org/regauth/iab/iab.txt</p> + <p>Sample record:</p> +<pre class="literalblock"> + 00-50-C2 (hex) ACME CORPORATION + ABC000-ABCFFF (base 16) ACME CORPORATION + 1 MAIN STREET + SPRINGFIELD + UNITED STATES +</pre> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.IABIndexParser-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">filename</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IABIndexParser.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="parse"></a><span class="summary-sig-name">parse</span>(<span class="summary-sig-arg">self</span>)</span><br /> + Parse an IAB registration file for records notifying subscribers</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#IABIndexParser.parse">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.core.Publisher-class.html">core.Publisher</a></code></b>: + <code><a href="netaddr.core.Publisher-class.html#attach">attach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#detach">detach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#notify">notify</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">filename</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#IABIndexParser.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>filename - location of file containing IAB records.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui.NotRegisteredError-class.html b/docs/api/netaddr.eui.NotRegisteredError-class.html new file mode 100644 index 0000000..389bd7b --- /dev/null +++ b/docs/api/netaddr.eui.NotRegisteredError-class.html @@ -0,0 +1,179 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui.NotRegisteredError</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.eui-module.html" onclick="show_private();">Package eui</a> :: + Class NotRegisteredError + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui.NotRegisteredError-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class NotRegisteredError</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.eui-pysrc.html#NotRegisteredError">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +exceptions.BaseException --+ + | + exceptions.Exception --+ + | + <strong class="uidshort">NotRegisteredError</strong> +</pre> + +<hr /> +<p>An Exception indicating that an OUI or IAB was not found in the IEEE + Registry.</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>exceptions.Exception</code></b>: + <code>__init__</code>, + <code>__new__</code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>exceptions.BaseException</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__getitem__</code>, + <code>__getslice__</code>, + <code>__reduce__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__setstate__</code>, + <code>__str__</code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__hash__</code>, + <code>__reduce_ex__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>exceptions.BaseException</code></b>: + <code>args</code>, + <code>message</code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui.OUI-class.html b/docs/api/netaddr.eui.OUI-class.html new file mode 100644 index 0000000..6bb1cd7 --- /dev/null +++ b/docs/api/netaddr.eui.OUI-class.html @@ -0,0 +1,600 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui.OUI</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.eui-module.html" onclick="show_private();">Package eui</a> :: + Class OUI + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui.OUI-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class OUI</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI">source code</a></span></p> +<pre class="base-tree"> +object --+ + | + <strong class="uidshort">OUI</strong> +</pre> + +<hr /> +<p>Represents an individual IEEE OUI (Organisationally Unique Identifier) + identifier.</p> + <p>For online details see - http://standards.ieee.org/regauth/oui/</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">oui</span>)</span><br /> + Constructor</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#org_count" class="summary-sig-name">org_count</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + number of organisations with this OUI</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.org_count">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#address" class="summary-sig-name">address</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">index</span>=<span class="summary-sig-default">0</span>)</span><br /> + Returns: + registered address of organisation linked to OUI</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.address">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#org" class="summary-sig-name">org</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">index</span>=<span class="summary-sig-default">0</span>)</span><br /> + Returns: + the name of organisation linked to OUI</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.org">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#organisation" class="summary-sig-name">organisation</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">index</span>=<span class="summary-sig-default">0</span>)</span><br /> + Returns: + the name of organisation linked to OUI</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.org">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#__int__" class="summary-sig-name">__int__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + integer representation of this OUI</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__int__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#__hex__" class="summary-sig-name">__hex__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + network byte order hexadecimal string of this OUI</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__hex__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#__str__" class="summary-sig-name">__str__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + string representation of this OUI</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__str__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#registration" class="summary-sig-name">registration</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + registration details for this IAB</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.registration">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUI-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + Returns: + executable Python string to recreate equivalent object.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__repr__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__setattr__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">oui</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor</p> + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>oui</code></strong> - an OUI string <code>XX-XX-XX</code> or a network byte order + integer. Also accepts and parses full MAC/EUI-48 address strings + (but not MAC/EUI-48 integers)!</li> + </ul></dd> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="org_count"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">org_count</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.org_count">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>number of organisations with this OUI</dd> + </dl> +</td></tr></table> +</div> +<a name="address"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">address</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">index</span>=<span class="sig-default">0</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.address">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>index</code></strong> - the index of record (multiple registrations) (Default: 0 - first + registration)</li> + </ul></dd> + <dt>Returns:</dt> + <dd>registered address of organisation linked to OUI</dd> + </dl> +</td></tr></table> +</div> +<a name="org"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">org</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">index</span>=<span class="sig-default">0</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.org">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>index</code></strong> - the index of record (multiple registrations) (Default: 0 - first + registration)</li> + </ul></dd> + <dt>Returns:</dt> + <dd>the name of organisation linked to OUI</dd> + </dl> +</td></tr></table> +</div> +<a name="organisation"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">organisation</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">index</span>=<span class="sig-default">0</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.org">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>index</code></strong> - the index of record (multiple registrations) (Default: 0 - first + registration)</li> + </ul></dd> + <dt>Returns:</dt> + <dd>the name of organisation linked to OUI</dd> + </dl> +</td></tr></table> +</div> +<a name="__int__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__int__</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__int__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>integer representation of this OUI</dd> + </dl> +</td></tr></table> +</div> +<a name="__hex__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__hex__</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__hex__">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>network byte order hexadecimal string of this OUI</dd> + </dl> +</td></tr></table> +</div> +<a name="__str__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__str__</span>(<span class="sig-arg">self</span>)</span> + <br /><em class="fname">(Informal representation operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__str__">source code</a></span> + </td> + </tr></table> + + <p>str(x)</p> + <dl class="fields"> + <dt>Returns:</dt> + <dd>string representation of this OUI</dd> + <dt>Overrides: + object.__str__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="registration"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">registration</span>(<span class="sig-arg">self</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.registration">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Returns:</dt> + <dd>registration details for this IAB</dd> + </dl> +</td></tr></table> +</div> +<a name="__repr__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__repr__</span>(<span class="sig-arg">self</span>)</span> + <br /><em class="fname">(Representation operator)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUI.__repr__">source code</a></span> + </td> + </tr></table> + + <p>repr(x)</p> + <dl class="fields"> + <dt>Returns:</dt> + <dd>executable Python string to recreate equivalent object.</dd> + <dt>Overrides: + object.__repr__ + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.eui.OUIIndexParser-class.html b/docs/api/netaddr.eui.OUIIndexParser-class.html new file mode 100644 index 0000000..58f10fe --- /dev/null +++ b/docs/api/netaddr.eui.OUIIndexParser-class.html @@ -0,0 +1,253 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.eui.OUIIndexParser</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.eui-module.html" onclick="show_private();">Package eui</a> :: + Class OUIIndexParser + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.eui.OUIIndexParser-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class OUIIndexParser</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.eui-pysrc.html#OUIIndexParser">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Publisher-class.html">core.Publisher</a> --+ + | + <strong class="uidshort">OUIIndexParser</strong> +</pre> + +<hr /> +<p>A parser that processes OUI (Organisationally Unique Identifier) + registration file data published by the IEEE.</p> + <p>It sends out notifications to registered subscribers for each record + it encounters, passing on the record's position relative to file start + (offset) and the size of the record (in bytes).</p> + <p>The file is available online here :-</p> + <p>http://standards.ieee.org/regauth/oui/oui.txt</p> + <p>Sample record:</p> +<pre class="literalblock"> + 00-CA-FE (hex) ACME CORPORATION + 00CAFE (base 16) ACME CORPORATION + 1 MAIN STREET + SPRINGFIELD + UNITED STATES +</pre> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.eui.OUIIndexParser-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">filename</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUIIndexParser.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="parse"></a><span class="summary-sig-name">parse</span>(<span class="summary-sig-arg">self</span>)</span><br /> + Parse an OUI registration file for records notifying subscribers</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.eui-pysrc.html#OUIIndexParser.parse">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.core.Publisher-class.html">core.Publisher</a></code></b>: + <code><a href="netaddr.core.Publisher-class.html#attach">attach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#detach">detach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#notify">notify</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">filename</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.eui-pysrc.html#OUIIndexParser.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>filename - location of file containing OUI records.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.ip-module.html b/docs/api/netaddr.ip-module.html new file mode 100644 index 0000000..078ceb6 --- /dev/null +++ b/docs/api/netaddr.ip-module.html @@ -0,0 +1,284 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.ip</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Package ip + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.ip-module.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== PACKAGE DESCRIPTION ==================== --> +<h1 class="epydoc">Package ip</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.ip-pysrc.html">source code</a></span></p> +<p>Provides access to public network address information published by + IANA.</p> + <p>More details can be found at the following URLs :-</p> + <p>Internet Assigned Numbers Authority (IANA)</p> + <ul> + <li> + http://www.iana.org/ + </li> + <li> + http://www.iana.org/protocols/ + </li> + </ul> + +<!-- ==================== CLASSES ==================== --> +<a name="section-Classes"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Classes</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.ip.LineRecordParser-class.html" class="summary-name">LineRecordParser</a><br /> + A configurable Parser that understands how to parse line based + records. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.ip.IPv4Parser-class.html" class="summary-name">IPv4Parser</a><br /> + A LineRecordParser that understands how to parse and retrieve data + records from the IANA IPv4 address space file. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.ip.IPv6Parser-class.html" class="summary-name">IPv6Parser</a><br /> + A LineRecordParser that understands how to parse and retrieve data + records from the IANA IPv6 address space file. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.ip.MulticastParser-class.html" class="summary-name">MulticastParser</a><br /> + A LineParser that knows how to process the IANA IPv4 multicast + address allocation file. + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.ip.DictUpdater-class.html" class="summary-name">DictUpdater</a><br /> + Concrete Subscriber that inserts records received from a Publisher + into a dictionary. + </td> + </tr> +</table> +<!-- ==================== FUNCTIONS ==================== --> +<a name="section-Functions"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Functions</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="load_iana_info"></a><span class="summary-sig-name">load_iana_info</span>()</span><br /> + Parse and load internal IANA data lookups with the latest information + from data files.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#load_iana_info">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="query"></a><span class="summary-sig-name">query</span>(<span class="summary-sig-arg">ip_addr</span>)</span><br /> + Returns informational data specific to this IP address.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#query">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +</table> +<!-- ==================== VARIABLES ==================== --> +<a name="section-Variables"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Variables</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.ip-module.html#IANA_INFO" class="summary-name">IANA_INFO</a> = <code title="{'IPv4': {CIDR('0.0.0.0/8'): {'date': '1981-09', + 'designation': 'IANA - Local Identificat\ +ion', + 'prefix': '0/8', + 'status': 'Reserved', + 'whois': ''}, + CIDR('1.0.0.0/8'): {'date': '', + 'designation': 'IANA', +..."><code class="variable-group">{</code><code class="variable-quote">'</code><code class="variable-string">IPv4</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-group">{</code>CIDR('0.0.0.0/8')<code class="variable-op">: </code><code class="variable-group">{</code><code class="variable-quote">'</code><code class="variable-string">date</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">1981-09</code><code class="variable-quote">'</code><code class="variable-op">, </code><code class="variable-quote">'</code><code class="variable-ellipsis">...</code></code><br /> + Topic based lookup dictionary for IANA information. + </td> + </tr> +</table> +<!-- ==================== VARIABLES DETAILS ==================== --> +<a name="section-VariablesDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Variables Details</span></td> +</tr> +</table> +<a name="IANA_INFO"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">IANA_INFO</h3> + <p>Topic based lookup dictionary for IANA information.</p> + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-group">{</code><code class="variable-quote">'</code><code class="variable-string">IPv4</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-group">{</code>CIDR('0.0.0.0/8')<code class="variable-op">: </code><code class="variable-group">{</code><code class="variable-quote">'</code><code class="variable-string">date</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">1981-09</code><code class="variable-quote">'</code><code class="variable-op">,</code> + <code class="variable-quote">'</code><code class="variable-string">designation</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">IANA - Local Identificat</code><span class="variable-linewrap"><img src="crarr.png" alt="\" /></span> +<code class="variable-string">ion</code><code class="variable-quote">'</code><code class="variable-op">,</code> + <code class="variable-quote">'</code><code class="variable-string">prefix</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">0/8</code><code class="variable-quote">'</code><code class="variable-op">,</code> + <code class="variable-quote">'</code><code class="variable-string">status</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">Reserved</code><code class="variable-quote">'</code><code class="variable-op">,</code> + <code class="variable-quote">'</code><code class="variable-string">whois</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string"></code><code class="variable-quote">'</code><code class="variable-group">}</code><code class="variable-op">,</code> + CIDR('1.0.0.0/8')<code class="variable-op">: </code><code class="variable-group">{</code><code class="variable-quote">'</code><code class="variable-string">date</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string"></code><code class="variable-quote">'</code><code class="variable-op">,</code> + <code class="variable-quote">'</code><code class="variable-string">designation</code><code class="variable-quote">'</code><code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">IANA</code><code class="variable-quote">'</code><code class="variable-op">,</code> +<code class="variable-ellipsis">...</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.ip-pysrc.html b/docs/api/netaddr.ip-pysrc.html new file mode 100644 index 0000000..be1c419 --- /dev/null +++ b/docs/api/netaddr.ip-pysrc.html @@ -0,0 +1,637 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.ip</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Package ip + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.ip-pysrc.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<h1 class="epydoc">Source Code for <a href="netaddr.ip-module.html">Package netaddr.ip</a></h1> +<pre class="py-src"> +<a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python
</tt> </tt> +<a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Copyright (c) 2008, David P. D. Moss. All rights reserved.
</tt> </tt> +<a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#
</tt> </tt> +<a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Released under the BSD license. See the LICENSE file for details.
</tt> </tt> +<a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-docstring">"""
</tt> </tt> +<a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">Provides access to public network address information published by IANA.
</tt> </tt> +<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-docstring">More details can be found at the following URLs :-
</tt> </tt> +<a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-docstring">Internet Assigned Numbers Authority (IANA)
</tt> </tt> +<a name="L13"></a><tt class="py-lineno"> 13</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt class="py-docstring"> - http://www.iana.org/
</tt> </tt> +<a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"><tt class="py-docstring"> - http://www.iana.org/protocols/</tt> </tt> +<a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt>
+<a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"> </tt> +<a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">os</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_os</tt> </tt> +<a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">os</tt><tt class="py-op">.</tt><tt class="py-name">path</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_path</tt> </tt> +<a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">re</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_re</tt> </tt> +<a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line">
</tt> +<a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-0" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-0', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-1" class="py-name" targets="Module netaddr.core=netaddr.core-module.html"><a title="netaddr.core" class="py-name" href="#" onclick="return doclink('link-1', 'core', 'link-1');">core</a></tt> <tt class="py-keyword">import</tt> <tt id="link-2" class="py-name" targets="Class netaddr.core.Publisher=netaddr.core.Publisher-class.html"><a title="netaddr.core.Publisher" class="py-name" href="#" onclick="return doclink('link-2', 'Publisher', 'link-2');">Publisher</a></tt><tt class="py-op">,</tt> <tt id="link-3" class="py-name" targets="Class netaddr.core.Subscriber=netaddr.core.Subscriber-class.html"><a title="netaddr.core.Subscriber" class="py-name" href="#" onclick="return doclink('link-3', 'Subscriber', 'link-3');">Subscriber</a></tt><tt class="py-op">,</tt> <tt id="link-4" class="py-name" targets="Class netaddr.core.PrettyPrinter=netaddr.core.PrettyPrinter-class.html"><a title="netaddr.core.PrettyPrinter" class="py-name" href="#" onclick="return doclink('link-4', 'PrettyPrinter', 'link-4');">PrettyPrinter</a></tt> </tt>
+<a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-5" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-5', 'netaddr', 'link-0');">netaddr</a></tt> <tt class="py-keyword">import</tt> <tt id="link-6" class="py-name" targets="Variable netaddr.AT_INET=netaddr-module.html#AT_INET"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-6', 'AT_INET', 'link-6');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-7" class="py-name" targets="Variable netaddr.AT_INET6=netaddr-module.html#AT_INET6"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-7', 'AT_INET6', 'link-7');">AT_INET6</a></tt> </tt> +<a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-8" class="py-name"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-8', 'netaddr', 'link-0');">netaddr</a></tt><tt class="py-op">.</tt><tt id="link-9" class="py-name" targets="Module netaddr.address=netaddr.address-module.html,Method netaddr.eui.IAB.address()=netaddr.eui.IAB-class.html#address,Method netaddr.eui.OUI.address()=netaddr.eui.OUI-class.html#address"><a title="netaddr.address +netaddr.eui.IAB.address +netaddr.eui.OUI.address" class="py-name" href="#" onclick="return doclink('link-9', 'address', 'link-9');">address</a></tt> <tt class="py-keyword">import</tt> <tt id="link-10" class="py-name" targets="Class netaddr.address.CIDR=netaddr.address.CIDR-class.html"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-10', 'CIDR', 'link-10');">CIDR</a></tt><tt class="py-op">,</tt> <tt id="link-11" class="py-name" targets="Class netaddr.address.IPRange=netaddr.address.IPRange-class.html"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-11', 'IPRange', 'link-11');">IPRange</a></tt> </tt> +<a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"> </tt> +<a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"><tt class="py-comment">#: Topic based lookup dictionary for IANA information.</tt> </tt> +<a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-12" class="py-name" targets="Variable netaddr.ip.IANA_INFO=netaddr.ip-module.html#IANA_INFO"><a title="netaddr.ip.IANA_INFO" class="py-name" href="#" onclick="return doclink('link-12', 'IANA_INFO', 'link-12');">IANA_INFO</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt> +<a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"> <tt class="py-string">'IPv4'</tt> <tt class="py-op">:</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">,</tt> </tt> +<a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"> <tt class="py-string">'IPv6'</tt> <tt class="py-op">:</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">,</tt> </tt> +<a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"> <tt class="py-string">'multicast'</tt> <tt class="py-op">:</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt><tt class="py-op">,</tt> </tt> +<a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"><tt class="py-op">}</tt> </tt> +<a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line">
</tt> +<a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="LineRecordParser"></a><div id="LineRecordParser-def"><a name="L36"></a><tt class="py-lineno"> 36</tt> <a class="py-toggle" href="#" id="LineRecordParser-toggle" onclick="return toggle('LineRecordParser');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a><tt class="py-op">(</tt><tt class="py-base-class">Publisher</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="LineRecordParser-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="LineRecordParser-expanded"><a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"><tt class="py-docstring"> A configurable Parser that understands how to parse line based records.
</tt> </tt> +<a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="LineRecordParser.__init__"></a><div id="LineRecordParser.__init__-def"><a name="L40"></a><tt class="py-lineno"> 40</tt> <a class="py-toggle" href="#" id="LineRecordParser.__init__-toggle" onclick="return toggle('LineRecordParser.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.LineRecordParser-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">fh</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="LineRecordParser.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="LineRecordParser.__init__-expanded"><a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.
</tt> </tt> +<a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"><tt class="py-docstring"> fh - a valid, open file handle to line based record data.
</tt> </tt> +<a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-13" class="py-name" targets="Class netaddr.ip.LineRecordParser=netaddr.ip.LineRecordParser-class.html"><a title="netaddr.ip.LineRecordParser" class="py-name" href="#" onclick="return doclink('link-13', 'LineRecordParser', 'link-13');">LineRecordParser</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-14" class="py-name" targets="Method netaddr.address.Addr.__init__()=netaddr.address.Addr-class.html#__init__,Method netaddr.address.AddrTypeDescriptor.__init__()=netaddr.address.AddrTypeDescriptor-class.html#__init__,Method netaddr.address.AddrValueDescriptor.__init__()=netaddr.address.AddrValueDescriptor-class.html#__init__,Method netaddr.address.CIDR.__init__()=netaddr.address.CIDR-class.html#__init__,Method netaddr.address.EUI.__init__()=netaddr.address.EUI-class.html#__init__,Method netaddr.address.FormatDescriptor.__init__()=netaddr.address.FormatDescriptor-class.html#__init__,Method netaddr.address.IP.__init__()=netaddr.address.IP-class.html#__init__,Method netaddr.address.IPRange.__init__()=netaddr.address.IPRange-class.html#__init__,Method netaddr.address.IPRangeSet.__init__()=netaddr.address.IPRangeSet-class.html#__init__,Method netaddr.address.PrefixLenDescriptor.__init__()=netaddr.address.PrefixLenDescriptor-class.html#__init__,Method netaddr.address.StrategyDescriptor.__init__()=netaddr.address.StrategyDescriptor-class.html#__init__,Method netaddr.address.Wildcard.__init__()=netaddr.address.Wildcard-class.html#__init__,Method netaddr.core.PrettyPrinter.__init__()=netaddr.core.PrettyPrinter-class.html#__init__,Method netaddr.core.Publisher.__init__()=netaddr.core.Publisher-class.html#__init__,Method netaddr.eui.FileIndexer.__init__()=netaddr.eui.FileIndexer-class.html#__init__,Method netaddr.eui.IAB.__init__()=netaddr.eui.IAB-class.html#__init__,Method netaddr.eui.IABIndexParser.__init__()=netaddr.eui.IABIndexParser-class.html#__init__,Method netaddr.eui.OUI.__init__()=netaddr.eui.OUI-class.html#__init__,Method netaddr.eui.OUIIndexParser.__init__()=netaddr.eui.OUIIndexParser-class.html#__init__,Method netaddr.ip.DictUpdater.__init__()=netaddr.ip.DictUpdater-class.html#__init__,Method netaddr.ip.IPv4Parser.__init__()=netaddr.ip.IPv4Parser-class.html#__init__,Method netaddr.ip.IPv6Parser.__init__()=netaddr.ip.IPv6Parser-class.html#__init__,Method netaddr.ip.LineRecordParser.__init__()=netaddr.ip.LineRecordParser-class.html#__init__,Method netaddr.ip.MulticastParser.__init__()=netaddr.ip.MulticastParser-class.html#__init__,Method netaddr.strategy.AddrStrategy.__init__()=netaddr.strategy.AddrStrategy-class.html#__init__,Method netaddr.strategy.EUI48Strategy.__init__()=netaddr.strategy.EUI48Strategy-class.html#__init__,Method netaddr.strategy.IPv4StrategyOpt.__init__()=netaddr.strategy.IPv4StrategyOpt-class.html#__init__,Method netaddr.strategy.IPv4StrategyStd.__init__()=netaddr.strategy.IPv4StrategyStd-class.html#__init__,Method netaddr.strategy.IPv6Strategy.__init__()=netaddr.strategy.IPv6Strategy-class.html#__init__"><a title="netaddr.address.Addr.__init__ +netaddr.address.AddrTypeDescriptor.__init__ +netaddr.address.AddrValueDescriptor.__init__ +netaddr.address.CIDR.__init__ +netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ +netaddr.address.IP.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ +netaddr.address.PrefixLenDescriptor.__init__ +netaddr.address.StrategyDescriptor.__init__ +netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ +netaddr.strategy.AddrStrategy.__init__ +netaddr.strategy.EUI48Strategy.__init__ +netaddr.strategy.IPv4StrategyOpt.__init__ +netaddr.strategy.IPv4StrategyStd.__init__ +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-14', '__init__', 'link-14');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt> <tt class="py-op">=</tt> <tt class="py-name">fh</tt> </tt>
+<a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line">
</tt> +<a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">.</tt><tt id="link-15" class="py-name" targets="Method netaddr.core.PrettyPrinter.update()=netaddr.core.PrettyPrinter-class.html#update,Method netaddr.core.Subscriber.update()=netaddr.core.Subscriber-class.html#update,Method netaddr.eui.FileIndexer.update()=netaddr.eui.FileIndexer-class.html#update,Method netaddr.ip.DictUpdater.update()=netaddr.ip.DictUpdater-class.html#update"><a title="netaddr.core.PrettyPrinter.update +netaddr.core.Subscriber.update +netaddr.eui.FileIndexer.update +netaddr.ip.DictUpdater.update" class="py-name" href="#" onclick="return doclink('link-15', 'update', 'link-15');">update</a></tt><tt class="py-op">(</tt><tt class="py-name">kwargs</tt><tt class="py-op">)</tt> </tt>
+<a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line">
</tt> +<a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"> <tt class="py-comment"># Regex used to identify start of lines of interest.
</tt> </tt> +<a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">'re_start'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">:</tt> </tt>
+<a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">re_start</tt> <tt class="py-op">=</tt> <tt class="py-string">r'^.*$'</tt> </tt>
+<a name="L54"></a><tt class="py-lineno"> 54</tt> <tt class="py-line">
</tt> +<a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"> <tt class="py-comment"># Regex used to identify line to be parsed within block of interest.
</tt> </tt> +<a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">'re_parse_line'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">:</tt> </tt>
+<a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">re_parse_line</tt> <tt class="py-op">=</tt> <tt class="py-string">r'^.*$'</tt> </tt>
+<a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line">
</tt> +<a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"> <tt class="py-comment"># Regex used to identify end of lines of interest.
</tt> </tt> +<a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">'re_stop'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">:</tt> </tt>
+<a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">re_stop</tt> <tt class="py-op">=</tt> <tt class="py-string">r'^.*$'</tt> </tt>
+<a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line">
</tt> +<a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"> <tt class="py-comment"># If enabled, skips blank lines after being stripped.
</tt> </tt> +<a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">'skip_blank_lines'</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">:</tt> </tt>
+<a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">skip_blank_lines</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
+</div><a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line">
</tt> +<a name="LineRecordParser.parse_line"></a><div id="LineRecordParser.parse_line-def"><a name="L67"></a><tt class="py-lineno"> 67</tt> <a class="py-toggle" href="#" id="LineRecordParser.parse_line-toggle" onclick="return toggle('LineRecordParser.parse_line');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.LineRecordParser-class.html#parse_line">parse_line</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">line</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="LineRecordParser.parse_line-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="LineRecordParser.parse_line-expanded"><a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"><tt class="py-docstring"> This is the callback method invoked for every line considered valid by
</tt> </tt> +<a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"><tt class="py-docstring"> the line parser's settings. It is usually over-ridden by base classes
</tt> </tt> +<a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"><tt class="py-docstring"> to provide specific line parsing and line skipping logic.
</tt> </tt> +<a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"><tt class="py-docstring"> Any line can be vetoed (not passed to registered Subscriber objects)
</tt> </tt> +<a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"><tt class="py-docstring"> by simply returning None.
</tt> </tt> +<a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">line</tt> </tt>
+</div><a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line">
</tt> +<a name="LineRecordParser.parse"></a><div id="LineRecordParser.parse-def"><a name="L78"></a><tt class="py-lineno"> 78</tt> <a class="py-toggle" href="#" id="LineRecordParser.parse-toggle" onclick="return toggle('LineRecordParser.parse');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.LineRecordParser-class.html#parse">parse</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="LineRecordParser.parse-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="LineRecordParser.parse-expanded"><a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"><tt class="py-docstring"> Parse and normalises records, notifying registered subscribers with
</tt> </tt> +<a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"><tt class="py-docstring"> record data as it is encountered.
</tt> </tt> +<a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt>
+<a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"> <tt class="py-name">section_start</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
+<a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"> <tt class="py-name">section_end</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt>
+<a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line">
</tt> +<a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">line</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">fh</tt><tt class="py-op">:</tt> </tt>
+<a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line">
</tt> +<a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"> <tt class="py-comment"># Skip blank lines if required.
</tt> </tt> +<a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">skip_blank_lines</tt> <tt class="py-keyword">and</tt> <tt class="py-name">line</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt>
+<a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
+<a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line">
</tt> +<a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"> <tt class="py-comment"># Entered record section.
</tt> </tt> +<a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">section_start</tt> <tt class="py-keyword">and</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">_re</tt><tt class="py-op">.</tt><tt class="py-name">findall</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">re_start</tt><tt class="py-op">,</tt> <tt class="py-name">line</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
+<a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"> <tt class="py-name">section_start</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
+<a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line">
</tt> +<a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"> <tt class="py-comment"># Exited record section.
</tt> </tt> +<a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">section_start</tt> <tt class="py-keyword">and</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">_re</tt><tt class="py-op">.</tt><tt class="py-name">findall</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">re_stop</tt><tt class="py-op">,</tt> <tt class="py-name">line</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
+<a name="L100"></a><tt class="py-lineno">100</tt> <tt class="py-line"> <tt class="py-name">section_end</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt>
+<a name="L101"></a><tt class="py-lineno">101</tt> <tt class="py-line">
</tt> +<a name="L102"></a><tt class="py-lineno">102</tt> <tt class="py-line"> <tt class="py-comment"># Stop parsing.
</tt> </tt> +<a name="L103"></a><tt class="py-lineno">103</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">section_end</tt><tt class="py-op">:</tt> </tt>
+<a name="L104"></a><tt class="py-lineno">104</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt>
+<a name="L105"></a><tt class="py-lineno">105</tt> <tt class="py-line">
</tt> +<a name="L106"></a><tt class="py-lineno">106</tt> <tt class="py-line"> <tt class="py-comment"># Is this a line of interest?
</tt> </tt> +<a name="L107"></a><tt class="py-lineno">107</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">section_start</tt> <tt class="py-keyword">and</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">_re</tt><tt class="py-op">.</tt><tt class="py-name">findall</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">re_parse_line</tt><tt class="py-op">,</tt> <tt class="py-name">line</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt>
+<a name="L108"></a><tt class="py-lineno">108</tt> <tt class="py-line"> <tt class="py-keyword">continue</tt> </tt>
+<a name="L109"></a><tt class="py-lineno">109</tt> <tt class="py-line">
</tt> +<a name="L110"></a><tt class="py-lineno">110</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">section_start</tt><tt class="py-op">:</tt> </tt>
+<a name="L111"></a><tt class="py-lineno">111</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-16" class="py-name" targets="Method netaddr.ip.IPv4Parser.parse_line()=netaddr.ip.IPv4Parser-class.html#parse_line,Method netaddr.ip.IPv6Parser.parse_line()=netaddr.ip.IPv6Parser-class.html#parse_line,Method netaddr.ip.LineRecordParser.parse_line()=netaddr.ip.LineRecordParser-class.html#parse_line,Method netaddr.ip.MulticastParser.parse_line()=netaddr.ip.MulticastParser-class.html#parse_line"><a title="netaddr.ip.IPv4Parser.parse_line +netaddr.ip.IPv6Parser.parse_line +netaddr.ip.LineRecordParser.parse_line +netaddr.ip.MulticastParser.parse_line" class="py-name" href="#" onclick="return doclink('link-16', 'parse_line', 'link-16');">parse_line</a></tt><tt class="py-op">(</tt><tt class="py-name">line</tt><tt class="py-op">)</tt> </tt>
+<a name="L112"></a><tt class="py-lineno">112</tt> <tt class="py-line">
</tt> +<a name="L113"></a><tt class="py-lineno">113</tt> <tt class="py-line"> <tt class="py-comment"># notify subscribers of final record details.
</tt> </tt> +<a name="L114"></a><tt class="py-lineno">114</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-17" class="py-name" targets="Method netaddr.core.Publisher.notify()=netaddr.core.Publisher-class.html#notify"><a title="netaddr.core.Publisher.notify" class="py-name" href="#" onclick="return doclink('link-17', 'notify', 'link-17');">notify</a></tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt>
+</div></div><a name="L115"></a><tt class="py-lineno">115</tt> <tt class="py-line">
</tt> +<a name="L116"></a><tt class="py-lineno">116</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="IPv4Parser"></a><div id="IPv4Parser-def"><a name="L117"></a><tt class="py-lineno">117</tt> <a class="py-toggle" href="#" id="IPv4Parser-toggle" onclick="return toggle('IPv4Parser');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.ip.IPv4Parser-class.html">IPv4Parser</a><tt class="py-op">(</tt><tt class="py-base-class">LineRecordParser</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="IPv4Parser-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv4Parser-expanded"><a name="L118"></a><tt class="py-lineno">118</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L119"></a><tt class="py-lineno">119</tt> <tt class="py-line"><tt class="py-docstring"> A LineRecordParser that understands how to parse and retrieve data records
</tt> </tt> +<a name="L120"></a><tt class="py-lineno">120</tt> <tt class="py-line"><tt class="py-docstring"> from the IANA IPv4 address space file.
</tt> </tt> +<a name="L121"></a><tt class="py-lineno">121</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L122"></a><tt class="py-lineno">122</tt> <tt class="py-line"><tt class="py-docstring"> It can be found online here :-
</tt> </tt> +<a name="L123"></a><tt class="py-lineno">123</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L124"></a><tt class="py-lineno">124</tt> <tt class="py-line"><tt class="py-docstring"> http://www.iana.org/assignments/ipv4-address-space
</tt> </tt> +<a name="L125"></a><tt class="py-lineno">125</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="IPv4Parser.__init__"></a><div id="IPv4Parser.__init__-def"><a name="L126"></a><tt class="py-lineno">126</tt> <a class="py-toggle" href="#" id="IPv4Parser.__init__-toggle" onclick="return toggle('IPv4Parser.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.IPv4Parser-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">fh</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="IPv4Parser.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4Parser.__init__-expanded"><a name="L127"></a><tt class="py-lineno">127</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L128"></a><tt class="py-lineno">128</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.
</tt> </tt> +<a name="L129"></a><tt class="py-lineno">129</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L130"></a><tt class="py-lineno">130</tt> <tt class="py-line"><tt class="py-docstring"> fh - a valid, open file handle to an OUI Registry data file.
</tt> </tt> +<a name="L131"></a><tt class="py-lineno">131</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L132"></a><tt class="py-lineno">132</tt> <tt class="py-line"><tt class="py-docstring"> kwargs - additional parser options.
</tt> </tt> +<a name="L133"></a><tt class="py-lineno">133</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L134"></a><tt class="py-lineno">134</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L135"></a><tt class="py-lineno">135</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-18" class="py-name" targets="Class netaddr.ip.IPv4Parser=netaddr.ip.IPv4Parser-class.html"><a title="netaddr.ip.IPv4Parser" class="py-name" href="#" onclick="return doclink('link-18', 'IPv4Parser', 'link-18');">IPv4Parser</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-19" class="py-name"><a title="netaddr.address.Addr.__init__ +netaddr.address.AddrTypeDescriptor.__init__ +netaddr.address.AddrValueDescriptor.__init__ +netaddr.address.CIDR.__init__ +netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ +netaddr.address.IP.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ +netaddr.address.PrefixLenDescriptor.__init__ +netaddr.address.StrategyDescriptor.__init__ +netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ +netaddr.strategy.AddrStrategy.__init__ +netaddr.strategy.EUI48Strategy.__init__ +netaddr.strategy.IPv4StrategyOpt.__init__ +netaddr.strategy.IPv4StrategyStd.__init__ +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-19', '__init__', 'link-14');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">fh</tt><tt class="py-op">,</tt>
</tt> +<a name="L136"></a><tt class="py-lineno">136</tt> <tt class="py-line"> <tt class="py-name">re_start</tt><tt class="py-op">=</tt><tt class="py-string">r'^Prefix'</tt><tt class="py-op">,</tt>
</tt> +<a name="L137"></a><tt class="py-lineno">137</tt> <tt class="py-line"> <tt class="py-name">re_parse_line</tt><tt class="py-op">=</tt><tt class="py-string">r'^\d{3}\/\d'</tt><tt class="py-op">,</tt>
</tt> +<a name="L138"></a><tt class="py-lineno">138</tt> <tt class="py-line"> <tt class="py-name">re_stop</tt><tt class="py-op">=</tt><tt class="py-string">r'^Notes\s*$'</tt><tt class="py-op">,</tt>
</tt> +<a name="L139"></a><tt class="py-lineno">139</tt> <tt class="py-line"> <tt class="py-name">skip_blank_lines</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt>
</tt> +<a name="L140"></a><tt class="py-lineno">140</tt> <tt class="py-line"> <tt class="py-op">)</tt> </tt>
+<a name="L141"></a><tt class="py-lineno">141</tt> <tt class="py-line">
</tt> +<a name="L142"></a><tt class="py-lineno">142</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record_widths</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt>
</tt> +<a name="L143"></a><tt class="py-lineno">143</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'prefix'</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">8</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L144"></a><tt class="py-lineno">144</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'designation'</tt><tt class="py-op">,</tt> <tt class="py-number">8</tt><tt class="py-op">,</tt> <tt class="py-number">37</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L145"></a><tt class="py-lineno">145</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'date'</tt><tt class="py-op">,</tt> <tt class="py-number">45</tt><tt class="py-op">,</tt> <tt class="py-number">10</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L146"></a><tt class="py-lineno">146</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'whois'</tt><tt class="py-op">,</tt> <tt class="py-number">55</tt><tt class="py-op">,</tt> <tt class="py-number">20</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L147"></a><tt class="py-lineno">147</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'status'</tt><tt class="py-op">,</tt> <tt class="py-number">75</tt><tt class="py-op">,</tt> <tt class="py-number">19</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L148"></a><tt class="py-lineno">148</tt> <tt class="py-line"> <tt class="py-op">)</tt> </tt>
+</div><a name="L149"></a><tt class="py-lineno">149</tt> <tt class="py-line">
</tt> +<a name="IPv4Parser.parse_line"></a><div id="IPv4Parser.parse_line-def"><a name="L150"></a><tt class="py-lineno">150</tt> <a class="py-toggle" href="#" id="IPv4Parser.parse_line-toggle" onclick="return toggle('IPv4Parser.parse_line');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.IPv4Parser-class.html#parse_line">parse_line</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">line</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="IPv4Parser.parse_line-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4Parser.parse_line-expanded"><a name="L151"></a><tt class="py-lineno">151</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L152"></a><tt class="py-lineno">152</tt> <tt class="py-line"><tt class="py-docstring"> Callback method invoked for every line considered valid by the line
</tt> </tt> +<a name="L153"></a><tt class="py-lineno">153</tt> <tt class="py-line"><tt class="py-docstring"> parser's settings.
</tt> </tt> +<a name="L154"></a><tt class="py-lineno">154</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L155"></a><tt class="py-lineno">155</tt> <tt class="py-line"><tt class="py-docstring"> See base class method for more details.
</tt> </tt> +<a name="L156"></a><tt class="py-lineno">156</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L157"></a><tt class="py-lineno">157</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L158"></a><tt class="py-lineno">158</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">width</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record_widths</tt><tt class="py-op">:</tt> </tt>
+<a name="L159"></a><tt class="py-lineno">159</tt> <tt class="py-line"> <tt id="link-20" class="py-name" targets="Variable netaddr.address.Addr.value=netaddr.address.Addr-class.html#value"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-20', 'value', 'link-20');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">[</tt><tt class="py-name">start</tt><tt class="py-op">:</tt><tt class="py-name">start</tt><tt class="py-op">+</tt><tt class="py-name">width</tt><tt class="py-op">]</tt> </tt>
+<a name="L160"></a><tt class="py-lineno">160</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-21" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-21', 'value', 'link-20');">value</a></tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L161"></a><tt class="py-lineno">161</tt> <tt class="py-line">
</tt> +<a name="L162"></a><tt class="py-lineno">162</tt> <tt class="py-line"> <tt class="py-comment"># Strip leading zeros from octet.
</tt> </tt> +<a name="L163"></a><tt class="py-lineno">163</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">'/'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'prefix'</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt>
+<a name="L164"></a><tt class="py-lineno">164</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">octet</tt><tt class="py-op">,</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'prefix'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'/'</tt><tt class="py-op">)</tt> </tt>
+<a name="L165"></a><tt class="py-lineno">165</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'prefix'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">"%d/%d"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">octet</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L166"></a><tt class="py-lineno">166</tt> <tt class="py-line">
</tt> +<a name="L167"></a><tt class="py-lineno">167</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'status'</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-string">'status'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">capitalize</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L168"></a><tt class="py-lineno">168</tt> <tt class="py-line">
</tt> +<a name="L169"></a><tt class="py-lineno">169</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">record</tt> </tt>
+</div></div><a name="L170"></a><tt class="py-lineno">170</tt> <tt class="py-line">
</tt> +<a name="L171"></a><tt class="py-lineno">171</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="IPv6Parser"></a><div id="IPv6Parser-def"><a name="L172"></a><tt class="py-lineno">172</tt> <a class="py-toggle" href="#" id="IPv6Parser-toggle" onclick="return toggle('IPv6Parser');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.ip.IPv6Parser-class.html">IPv6Parser</a><tt class="py-op">(</tt><tt class="py-base-class">LineRecordParser</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="IPv6Parser-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv6Parser-expanded"><a name="L173"></a><tt class="py-lineno">173</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L174"></a><tt class="py-lineno">174</tt> <tt class="py-line"><tt class="py-docstring"> A LineRecordParser that understands how to parse and retrieve data records
</tt> </tt> +<a name="L175"></a><tt class="py-lineno">175</tt> <tt class="py-line"><tt class="py-docstring"> from the IANA IPv6 address space file.
</tt> </tt> +<a name="L176"></a><tt class="py-lineno">176</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L177"></a><tt class="py-lineno">177</tt> <tt class="py-line"><tt class="py-docstring"> It can be found online here :-
</tt> </tt> +<a name="L178"></a><tt class="py-lineno">178</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L179"></a><tt class="py-lineno">179</tt> <tt class="py-line"><tt class="py-docstring"> http://www.iana.org/assignments/ipv6-address-space
</tt> </tt> +<a name="L180"></a><tt class="py-lineno">180</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="IPv6Parser.__init__"></a><div id="IPv6Parser.__init__-def"><a name="L181"></a><tt class="py-lineno">181</tt> <a class="py-toggle" href="#" id="IPv6Parser.__init__-toggle" onclick="return toggle('IPv6Parser.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.IPv6Parser-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">fh</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="IPv6Parser.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Parser.__init__-expanded"><a name="L182"></a><tt class="py-lineno">182</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L183"></a><tt class="py-lineno">183</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.
</tt> </tt> +<a name="L184"></a><tt class="py-lineno">184</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L185"></a><tt class="py-lineno">185</tt> <tt class="py-line"><tt class="py-docstring"> fh - a valid, open file handle to an OUI Registry data file.
</tt> </tt> +<a name="L186"></a><tt class="py-lineno">186</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L187"></a><tt class="py-lineno">187</tt> <tt class="py-line"><tt class="py-docstring"> kwargs - additional parser options.
</tt> </tt> +<a name="L188"></a><tt class="py-lineno">188</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L189"></a><tt class="py-lineno">189</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L190"></a><tt class="py-lineno">190</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-22" class="py-name" targets="Class netaddr.ip.IPv6Parser=netaddr.ip.IPv6Parser-class.html"><a title="netaddr.ip.IPv6Parser" class="py-name" href="#" onclick="return doclink('link-22', 'IPv6Parser', 'link-22');">IPv6Parser</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-23" class="py-name"><a title="netaddr.address.Addr.__init__ +netaddr.address.AddrTypeDescriptor.__init__ +netaddr.address.AddrValueDescriptor.__init__ +netaddr.address.CIDR.__init__ +netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ +netaddr.address.IP.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ +netaddr.address.PrefixLenDescriptor.__init__ +netaddr.address.StrategyDescriptor.__init__ +netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ +netaddr.strategy.AddrStrategy.__init__ +netaddr.strategy.EUI48Strategy.__init__ +netaddr.strategy.IPv4StrategyOpt.__init__ +netaddr.strategy.IPv4StrategyStd.__init__ +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-23', '__init__', 'link-14');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">fh</tt><tt class="py-op">,</tt>
</tt> +<a name="L191"></a><tt class="py-lineno">191</tt> <tt class="py-line"> <tt class="py-name">re_start</tt><tt class="py-op">=</tt><tt class="py-string">r'^IPv6 Prefix'</tt><tt class="py-op">,</tt>
</tt> +<a name="L192"></a><tt class="py-lineno">192</tt> <tt class="py-line"> <tt class="py-name">re_parse_line</tt><tt class="py-op">=</tt><tt class="py-string">r'^[A-F0-9]+::\/\d+'</tt><tt class="py-op">,</tt>
</tt> +<a name="L193"></a><tt class="py-lineno">193</tt> <tt class="py-line"> <tt class="py-name">re_stop</tt><tt class="py-op">=</tt><tt class="py-string">r'^Notes:\s*$'</tt><tt class="py-op">,</tt>
</tt> +<a name="L194"></a><tt class="py-lineno">194</tt> <tt class="py-line"> <tt class="py-name">skip_blank_lines</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
+<a name="L195"></a><tt class="py-lineno">195</tt> <tt class="py-line">
</tt> +<a name="L196"></a><tt class="py-lineno">196</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record_widths</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt>
</tt> +<a name="L197"></a><tt class="py-lineno">197</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'prefix'</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-number">22</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L198"></a><tt class="py-lineno">198</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'allocation'</tt><tt class="py-op">,</tt> <tt class="py-number">22</tt><tt class="py-op">,</tt> <tt class="py-number">24</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L199"></a><tt class="py-lineno">199</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-string">'reference'</tt><tt class="py-op">,</tt> <tt class="py-number">46</tt><tt class="py-op">,</tt> <tt class="py-number">15</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L200"></a><tt class="py-lineno">200</tt> <tt class="py-line">
</tt> +<a name="IPv6Parser.parse_line"></a><div id="IPv6Parser.parse_line-def"><a name="L201"></a><tt class="py-lineno">201</tt> <a class="py-toggle" href="#" id="IPv6Parser.parse_line-toggle" onclick="return toggle('IPv6Parser.parse_line');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.IPv6Parser-class.html#parse_line">parse_line</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">line</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="IPv6Parser.parse_line-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Parser.parse_line-expanded"><a name="L202"></a><tt class="py-lineno">202</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L203"></a><tt class="py-lineno">203</tt> <tt class="py-line"><tt class="py-docstring"> Callback method invoked for every line considered valid by the line
</tt> </tt> +<a name="L204"></a><tt class="py-lineno">204</tt> <tt class="py-line"><tt class="py-docstring"> parser's settings.
</tt> </tt> +<a name="L205"></a><tt class="py-lineno">205</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L206"></a><tt class="py-lineno">206</tt> <tt class="py-line"><tt class="py-docstring"> See base class method for more details.
</tt> </tt> +<a name="L207"></a><tt class="py-lineno">207</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L208"></a><tt class="py-lineno">208</tt> <tt class="py-line"> <tt class="py-name">record</tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt>
+<a name="L209"></a><tt class="py-lineno">209</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-op">(</tt><tt class="py-name">key</tt><tt class="py-op">,</tt> <tt class="py-name">start</tt><tt class="py-op">,</tt> <tt class="py-name">width</tt><tt class="py-op">)</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">record_widths</tt><tt class="py-op">:</tt> </tt>
+<a name="L210"></a><tt class="py-lineno">210</tt> <tt class="py-line"> <tt id="link-24" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-24', 'value', 'link-20');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">[</tt><tt class="py-name">start</tt><tt class="py-op">:</tt><tt class="py-name">start</tt><tt class="py-op">+</tt><tt class="py-name">width</tt><tt class="py-op">]</tt> </tt>
+<a name="L211"></a><tt class="py-lineno">211</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt id="link-25" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-25', 'value', 'link-20');">value</a></tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L212"></a><tt class="py-lineno">212</tt> <tt class="py-line">
</tt> +<a name="L213"></a><tt class="py-lineno">213</tt> <tt class="py-line"> <tt class="py-comment"># Remove square brackets from reference field.
</tt> </tt> +<a name="L214"></a><tt class="py-lineno">214</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">lstrip</tt><tt class="py-op">(</tt><tt class="py-string">'['</tt><tt class="py-op">)</tt> </tt>
+<a name="L215"></a><tt class="py-lineno">215</tt> <tt class="py-line"> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">record</tt><tt class="py-op">[</tt><tt class="py-name">key</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-string">']'</tt><tt class="py-op">)</tt> </tt>
+<a name="L216"></a><tt class="py-lineno">216</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">record</tt> </tt>
+</div></div><a name="L217"></a><tt class="py-lineno">217</tt> <tt class="py-line">
</tt> +<a name="L218"></a><tt class="py-lineno">218</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------
</tt> </tt> +<a name="MulticastParser"></a><div id="MulticastParser-def"><a name="L219"></a><tt class="py-lineno">219</tt> <a class="py-toggle" href="#" id="MulticastParser-toggle" onclick="return toggle('MulticastParser');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.ip.MulticastParser-class.html">MulticastParser</a><tt class="py-op">(</tt><tt class="py-base-class">LineRecordParser</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="MulticastParser-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="MulticastParser-expanded"><a name="L220"></a><tt class="py-lineno">220</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L221"></a><tt class="py-lineno">221</tt> <tt class="py-line"><tt class="py-docstring"> A LineParser that knows how to process the IANA IPv4 multicast address
</tt> </tt> +<a name="L222"></a><tt class="py-lineno">222</tt> <tt class="py-line"><tt class="py-docstring"> allocation file.
</tt> </tt> +<a name="L223"></a><tt class="py-lineno">223</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L224"></a><tt class="py-lineno">224</tt> <tt class="py-line"><tt class="py-docstring"> It can be found online here :-
</tt> </tt> +<a name="L225"></a><tt class="py-lineno">225</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L226"></a><tt class="py-lineno">226</tt> <tt class="py-line"><tt class="py-docstring"> http://www.iana.org/assignments/multicast-addresses
</tt> </tt> +<a name="L227"></a><tt class="py-lineno">227</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="MulticastParser.__init__"></a><div id="MulticastParser.__init__-def"><a name="L228"></a><tt class="py-lineno">228</tt> <a class="py-toggle" href="#" id="MulticastParser.__init__-toggle" onclick="return toggle('MulticastParser.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.MulticastParser-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">fh</tt><tt class="py-op">,</tt> <tt class="py-op">**</tt><tt class="py-param">kwargs</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="MulticastParser.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="MulticastParser.__init__-expanded"><a name="L229"></a><tt class="py-lineno">229</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L230"></a><tt class="py-lineno">230</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.
</tt> </tt> +<a name="L231"></a><tt class="py-lineno">231</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L232"></a><tt class="py-lineno">232</tt> <tt class="py-line"><tt class="py-docstring"> fh - a valid, open file handle to an OUI Registry data file.
</tt> </tt> +<a name="L233"></a><tt class="py-lineno">233</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L234"></a><tt class="py-lineno">234</tt> <tt class="py-line"><tt class="py-docstring"> kwargs - additional parser options.
</tt> </tt> +<a name="L235"></a><tt class="py-lineno">235</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L236"></a><tt class="py-lineno">236</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L237"></a><tt class="py-lineno">237</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-26" class="py-name" targets="Class netaddr.ip.MulticastParser=netaddr.ip.MulticastParser-class.html"><a title="netaddr.ip.MulticastParser" class="py-name" href="#" onclick="return doclink('link-26', 'MulticastParser', 'link-26');">MulticastParser</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-27" class="py-name"><a title="netaddr.address.Addr.__init__ +netaddr.address.AddrTypeDescriptor.__init__ +netaddr.address.AddrValueDescriptor.__init__ +netaddr.address.CIDR.__init__ +netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ +netaddr.address.IP.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ +netaddr.address.PrefixLenDescriptor.__init__ +netaddr.address.StrategyDescriptor.__init__ +netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ +netaddr.strategy.AddrStrategy.__init__ +netaddr.strategy.EUI48Strategy.__init__ +netaddr.strategy.IPv4StrategyOpt.__init__ +netaddr.strategy.IPv4StrategyStd.__init__ +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-27', '__init__', 'link-14');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">fh</tt><tt class="py-op">,</tt>
</tt> +<a name="L238"></a><tt class="py-lineno">238</tt> <tt class="py-line"> <tt class="py-name">re_start</tt><tt class="py-op">=</tt><tt class="py-string">r'^Registry:'</tt><tt class="py-op">,</tt>
</tt> +<a name="L239"></a><tt class="py-lineno">239</tt> <tt class="py-line"> <tt class="py-name">re_parse_line</tt><tt class="py-op">=</tt><tt class="py-string">r'^\d+\.\d+\.\d+\.\d+'</tt><tt class="py-op">,</tt>
</tt> +<a name="L240"></a><tt class="py-lineno">240</tt> <tt class="py-line"> <tt class="py-name">re_stop</tt><tt class="py-op">=</tt><tt class="py-string">r'^Relative'</tt><tt class="py-op">,</tt>
</tt> +<a name="L241"></a><tt class="py-lineno">241</tt> <tt class="py-line"> <tt class="py-name">skip_blank_lines</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L242"></a><tt class="py-lineno">242</tt> <tt class="py-line">
</tt> +<a name="MulticastParser.normalise_addr"></a><div id="MulticastParser.normalise_addr-def"><a name="L243"></a><tt class="py-lineno">243</tt> <a class="py-toggle" href="#" id="MulticastParser.normalise_addr-toggle" onclick="return toggle('MulticastParser.normalise_addr');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.MulticastParser-class.html#normalise_addr">normalise_addr</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="MulticastParser.normalise_addr-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="MulticastParser.normalise_addr-expanded"><a name="L244"></a><tt class="py-lineno">244</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L245"></a><tt class="py-lineno">245</tt> <tt class="py-line"><tt class="py-docstring"> Removes variations from address entries found in this particular file.
</tt> </tt> +<a name="L246"></a><tt class="py-lineno">246</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L247"></a><tt class="py-lineno">247</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt>
+<a name="L248"></a><tt class="py-lineno">248</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">a1</tt><tt class="py-op">,</tt> <tt class="py-name">a2</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt> </tt>
+<a name="L249"></a><tt class="py-lineno">249</tt> <tt class="py-line"> <tt class="py-name">o1</tt> <tt class="py-op">=</tt> <tt class="py-name">a1</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt> </tt>
+<a name="L250"></a><tt class="py-lineno">250</tt> <tt class="py-line"> <tt class="py-name">o2</tt> <tt class="py-op">=</tt> <tt class="py-name">a2</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt> </tt>
+<a name="L251"></a><tt class="py-lineno">251</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"%s-%s"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">o1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">,</tt>
</tt> +<a name="L252"></a><tt class="py-lineno">252</tt> <tt class="py-line"> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">o2</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L253"></a><tt class="py-lineno">253</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt>
+<a name="L254"></a><tt class="py-lineno">254</tt> <tt class="py-line"> <tt class="py-name">o1</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt> </tt>
+<a name="L255"></a><tt class="py-lineno">255</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">o1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt>
+</div><a name="L256"></a><tt class="py-lineno">256</tt> <tt class="py-line">
</tt> +<a name="MulticastParser.parse_line"></a><div id="MulticastParser.parse_line-def"><a name="L257"></a><tt class="py-lineno">257</tt> <a class="py-toggle" href="#" id="MulticastParser.parse_line-toggle" onclick="return toggle('MulticastParser.parse_line');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.MulticastParser-class.html#parse_line">parse_line</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">line</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt>
+</div><div id="MulticastParser.parse_line-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="MulticastParser.parse_line-expanded"><a name="L258"></a><tt class="py-lineno">258</tt> <tt class="py-line"> <tt class="py-docstring">"""
</tt> </tt> +<a name="L259"></a><tt class="py-lineno">259</tt> <tt class="py-line"><tt class="py-docstring"> Callback method invoked for every line considered valid by the line
</tt> </tt> +<a name="L260"></a><tt class="py-lineno">260</tt> <tt class="py-line"><tt class="py-docstring"> parser's settings.
</tt> </tt> +<a name="L261"></a><tt class="py-lineno">261</tt> <tt class="py-line"><tt class="py-docstring">
</tt> </tt> +<a name="L262"></a><tt class="py-lineno">262</tt> <tt class="py-line"><tt class="py-docstring"> See base class method for more details.
</tt> </tt> +<a name="L263"></a><tt class="py-lineno">263</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt>
+<a name="L264"></a><tt class="py-lineno">264</tt> <tt class="py-line"> <tt class="py-name">index</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">.</tt><tt class="py-name">find</tt><tt class="py-op">(</tt><tt class="py-string">'['</tt><tt class="py-op">)</tt> </tt>
+<a name="L265"></a><tt class="py-lineno">265</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">index</tt> <tt class="py-op">!=</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">:</tt> </tt>
+<a name="L266"></a><tt class="py-lineno">266</tt> <tt class="py-line"> <tt class="py-name">line</tt> <tt class="py-op">=</tt> <tt class="py-name">line</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-name">index</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt>
+<a name="L267"></a><tt class="py-lineno">267</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-name">descr</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">.</tt><tt class="py-name">strip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">_re</tt><tt class="py-op">.</tt><tt class="py-name">findall</tt><tt class="py-op">(</tt>
</tt> +<a name="L268"></a><tt class="py-lineno">268</tt> <tt class="py-line"> <tt class="py-string">r'^([\d.]+(?:\s*-\s*[\d.]+)?)\s+(.+)$'</tt><tt class="py-op">,</tt> <tt class="py-name">line</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">]</tt> </tt>
+<a name="L269"></a><tt class="py-lineno">269</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-28" class="py-name" targets="Method netaddr.ip.MulticastParser.normalise_addr()=netaddr.ip.MulticastParser-class.html#normalise_addr"><a title="netaddr.ip.MulticastParser.normalise_addr" class="py-name" href="#" onclick="return doclink('link-28', 'normalise_addr', 'link-28');">normalise_addr</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt>
+<a name="L270"></a><tt class="py-lineno">270</tt> <tt class="py-line"> <tt class="py-name">descr</tt> <tt class="py-op">=</tt> <tt class="py-string">' '</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">descr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt>
+<a name="L271"></a><tt class="py-lineno">271</tt> <tt class="py-line"> <tt class="py-name">descr</tt> <tt class="py-op">=</tt> <tt class="py-name">descr</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">'Date registered'</tt> <tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L272"></a><tt class="py-lineno">272</tt> <tt class="py-line"> </tt> +<a name="L273"></a><tt class="py-lineno">273</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">dict</tt><tt class="py-op">(</tt><tt id="link-29" class="py-name"><a title="netaddr.address +netaddr.eui.IAB.address +netaddr.eui.OUI.address" class="py-name" href="#" onclick="return doclink('link-29', 'address', 'link-9');">address</a></tt><tt class="py-op">=</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-name">descr</tt><tt class="py-op">=</tt><tt class="py-name">descr</tt><tt class="py-op">)</tt> </tt>
+</div></div><a name="L274"></a><tt class="py-lineno">274</tt> <tt class="py-line">
</tt> +<a name="L275"></a><tt class="py-lineno">275</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="DictUpdater"></a><div id="DictUpdater-def"><a name="L276"></a><tt class="py-lineno">276</tt> <a class="py-toggle" href="#" id="DictUpdater-toggle" onclick="return toggle('DictUpdater');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.ip.DictUpdater-class.html">DictUpdater</a><tt class="py-op">(</tt><tt class="py-base-class">Subscriber</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="DictUpdater-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="DictUpdater-expanded"><a name="L277"></a><tt class="py-lineno">277</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L278"></a><tt class="py-lineno">278</tt> <tt class="py-line"><tt class="py-docstring"> Concrete Subscriber that inserts records received from a Publisher into a</tt> </tt> +<a name="L279"></a><tt class="py-lineno">279</tt> <tt class="py-line"><tt class="py-docstring"> dictionary.</tt> </tt> +<a name="L280"></a><tt class="py-lineno">280</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="DictUpdater.__init__"></a><div id="DictUpdater.__init__-def"><a name="L281"></a><tt class="py-lineno">281</tt> <a class="py-toggle" href="#" id="DictUpdater.__init__-toggle" onclick="return toggle('DictUpdater.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.DictUpdater-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">dct</tt><tt class="py-op">,</tt> <tt class="py-param">topic</tt><tt class="py-op">,</tt> <tt class="py-param">unique_key</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="DictUpdater.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="DictUpdater.__init__-expanded"><a name="L282"></a><tt class="py-lineno">282</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L283"></a><tt class="py-lineno">283</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L284"></a><tt class="py-lineno">284</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L285"></a><tt class="py-lineno">285</tt> <tt class="py-line"><tt class="py-docstring"> dct - lookup dict or dict like object to insert records into.</tt> </tt> +<a name="L286"></a><tt class="py-lineno">286</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L287"></a><tt class="py-lineno">287</tt> <tt class="py-line"><tt class="py-docstring"> topic - high-level category name of data to be processed.</tt> </tt> +<a name="L288"></a><tt class="py-lineno">288</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L289"></a><tt class="py-lineno">289</tt> <tt class="py-line"><tt class="py-docstring"> unique_key - key name in data dict that uniquely identifies it.</tt> </tt> +<a name="L290"></a><tt class="py-lineno">290</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L291"></a><tt class="py-lineno">291</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">dct</tt> <tt class="py-op">=</tt> <tt class="py-name">dct</tt> </tt> +<a name="L292"></a><tt class="py-lineno">292</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">topic</tt> <tt class="py-op">=</tt> <tt class="py-name">topic</tt> </tt> +<a name="L293"></a><tt class="py-lineno">293</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">unique_key</tt> <tt class="py-op">=</tt> <tt class="py-name">unique_key</tt> </tt> +</div><a name="L294"></a><tt class="py-lineno">294</tt> <tt class="py-line"> </tt> +<a name="DictUpdater.update"></a><div id="DictUpdater.update-def"><a name="L295"></a><tt class="py-lineno">295</tt> <a class="py-toggle" href="#" id="DictUpdater.update-toggle" onclick="return toggle('DictUpdater.update');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip.DictUpdater-class.html#update">update</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">data</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="DictUpdater.update-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="DictUpdater.update-expanded"><a name="L296"></a><tt class="py-lineno">296</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L297"></a><tt class="py-lineno">297</tt> <tt class="py-line"><tt class="py-docstring"> Callback function used by Publisher to notify this Subscriber about</tt> </tt> +<a name="L298"></a><tt class="py-lineno">298</tt> <tt class="py-line"><tt class="py-docstring"> an update. Stores topic based information into dictionary passed to</tt> </tt> +<a name="L299"></a><tt class="py-lineno">299</tt> <tt class="py-line"><tt class="py-docstring"> constructor.</tt> </tt> +<a name="L300"></a><tt class="py-lineno">300</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L301"></a><tt class="py-lineno">301</tt> <tt class="py-line"> <tt class="py-name">data_id</tt> <tt class="py-op">=</tt> <tt class="py-name">data</tt><tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">unique_key</tt><tt class="py-op">]</tt> </tt> +<a name="L302"></a><tt class="py-lineno">302</tt> <tt class="py-line"> </tt> +<a name="L303"></a><tt class="py-lineno">303</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">topic</tt> <tt class="py-op">==</tt> <tt class="py-string">'IPv4'</tt><tt class="py-op">:</tt> </tt> +<a name="L304"></a><tt class="py-lineno">304</tt> <tt class="py-line"> <tt id="link-30" class="py-name" targets="Method netaddr.address.IP.cidr()=netaddr.address.IP-class.html#cidr"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-30', 'cidr', 'link-30');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-31" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-31', 'CIDR', 'link-10');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-name">data_id</tt><tt class="py-op">)</tt> </tt> +<a name="L305"></a><tt class="py-lineno">305</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">dct</tt><tt class="py-op">[</tt><tt id="link-32" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-32', 'cidr', 'link-30');">cidr</a></tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">data</tt> </tt> +<a name="L306"></a><tt class="py-lineno">306</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">topic</tt> <tt class="py-op">==</tt> <tt class="py-string">'IPv6'</tt><tt class="py-op">:</tt> </tt> +<a name="L307"></a><tt class="py-lineno">307</tt> <tt class="py-line"> <tt id="link-33" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-33', 'cidr', 'link-30');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-34" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-34', 'CIDR', 'link-10');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-name">data_id</tt><tt class="py-op">)</tt> </tt> +<a name="L308"></a><tt class="py-lineno">308</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">dct</tt><tt class="py-op">[</tt><tt id="link-35" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-35', 'cidr', 'link-30');">cidr</a></tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">data</tt> </tt> +<a name="L309"></a><tt class="py-lineno">309</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">topic</tt> <tt class="py-op">==</tt> <tt class="py-string">'multicast'</tt><tt class="py-op">:</tt> </tt> +<a name="L310"></a><tt class="py-lineno">310</tt> <tt class="py-line"> <tt id="link-36" class="py-name" targets="Method netaddr.address.IP.iprange()=netaddr.address.IP-class.html#iprange,Method netaddr.address.IPRange.iprange()=netaddr.address.IPRange-class.html#iprange"><a title="netaddr.address.IP.iprange +netaddr.address.IPRange.iprange" class="py-name" href="#" onclick="return doclink('link-36', 'iprange', 'link-36');">iprange</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L311"></a><tt class="py-lineno">311</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">data_id</tt><tt class="py-op">:</tt> </tt> +<a name="L312"></a><tt class="py-lineno">312</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt id="link-37" class="py-name" targets="Variable netaddr.address.IPRange.first=netaddr.address.IPRange-class.html#first"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-37', 'first', 'link-37');">first</a></tt><tt class="py-op">,</tt> <tt id="link-38" class="py-name" targets="Variable netaddr.address.IPRange.last=netaddr.address.IPRange-class.html#last"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-38', 'last', 'link-38');">last</a></tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">data_id</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt> </tt> +<a name="L313"></a><tt class="py-lineno">313</tt> <tt class="py-line"> <tt id="link-39" class="py-name"><a title="netaddr.address.IP.iprange +netaddr.address.IPRange.iprange" class="py-name" href="#" onclick="return doclink('link-39', 'iprange', 'link-36');">iprange</a></tt> <tt class="py-op">=</tt> <tt id="link-40" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-40', 'IPRange', 'link-11');">IPRange</a></tt><tt class="py-op">(</tt><tt id="link-41" class="py-name"><a title="netaddr.address.IPRange.first" class="py-name" href="#" onclick="return doclink('link-41', 'first', 'link-37');">first</a></tt><tt class="py-op">,</tt> <tt id="link-42" class="py-name"><a title="netaddr.address.IPRange.last" class="py-name" href="#" onclick="return doclink('link-42', 'last', 'link-38');">last</a></tt><tt class="py-op">)</tt> </tt> +<a name="L314"></a><tt class="py-lineno">314</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L315"></a><tt class="py-lineno">315</tt> <tt class="py-line"> <tt id="link-43" class="py-name"><a title="netaddr.address.IP.iprange +netaddr.address.IPRange.iprange" class="py-name" href="#" onclick="return doclink('link-43', 'iprange', 'link-36');">iprange</a></tt> <tt class="py-op">=</tt> <tt id="link-44" class="py-name"><a title="netaddr.address.IPRange" class="py-name" href="#" onclick="return doclink('link-44', 'IPRange', 'link-11');">IPRange</a></tt><tt class="py-op">(</tt><tt class="py-name">data_id</tt><tt class="py-op">,</tt> <tt class="py-name">data_id</tt><tt class="py-op">)</tt> </tt> +<a name="L316"></a><tt class="py-lineno">316</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">dct</tt><tt class="py-op">[</tt><tt id="link-45" class="py-name"><a title="netaddr.address.IP.iprange +netaddr.address.IPRange.iprange" class="py-name" href="#" onclick="return doclink('link-45', 'iprange', 'link-36');">iprange</a></tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-name">data</tt> </tt> +</div></div><a name="L317"></a><tt class="py-lineno">317</tt> <tt class="py-line"> </tt> +<a name="L318"></a><tt class="py-lineno">318</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="load_iana_info"></a><div id="load_iana_info-def"><a name="L319"></a><tt class="py-lineno">319</tt> <a class="py-toggle" href="#" id="load_iana_info-toggle" onclick="return toggle('load_iana_info');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip-module.html#load_iana_info">load_iana_info</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="load_iana_info-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="load_iana_info-expanded"><a name="L320"></a><tt class="py-lineno">320</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L321"></a><tt class="py-lineno">321</tt> <tt class="py-line"><tt class="py-docstring"> Parse and load internal IANA data lookups with the latest information from</tt> </tt> +<a name="L322"></a><tt class="py-lineno">322</tt> <tt class="py-line"><tt class="py-docstring"> data files.</tt> </tt> +<a name="L323"></a><tt class="py-lineno">323</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L324"></a><tt class="py-lineno">324</tt> <tt class="py-line"> <tt class="py-name">PATH</tt> <tt class="py-op">=</tt> <tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">dirname</tt><tt class="py-op">(</tt><tt class="py-name">__file__</tt><tt class="py-op">)</tt> </tt> +<a name="L325"></a><tt class="py-lineno">325</tt> <tt class="py-line"> </tt> +<a name="L326"></a><tt class="py-lineno">326</tt> <tt class="py-line"> <tt id="link-46" class="py-name" targets="Method netaddr.address.IP.ipv4()=netaddr.address.IP-class.html#ipv4"><a title="netaddr.address.IP.ipv4" class="py-name" href="#" onclick="return doclink('link-46', 'ipv4', 'link-46');">ipv4</a></tt> <tt class="py-op">=</tt> <tt id="link-47" class="py-name"><a title="netaddr.ip.IPv4Parser" class="py-name" href="#" onclick="return doclink('link-47', 'IPv4Parser', 'link-18');">IPv4Parser</a></tt><tt class="py-op">(</tt><tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">PATH</tt><tt class="py-op">,</tt> <tt class="py-string">'ipv4-address-space'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L327"></a><tt class="py-lineno">327</tt> <tt class="py-line"> <tt id="link-48" class="py-name"><a title="netaddr.address.IP.ipv4" class="py-name" href="#" onclick="return doclink('link-48', 'ipv4', 'link-46');">ipv4</a></tt><tt class="py-op">.</tt><tt id="link-49" class="py-name" targets="Method netaddr.core.Publisher.attach()=netaddr.core.Publisher-class.html#attach"><a title="netaddr.core.Publisher.attach" class="py-name" href="#" onclick="return doclink('link-49', 'attach', 'link-49');">attach</a></tt><tt class="py-op">(</tt><tt id="link-50" class="py-name" targets="Class netaddr.ip.DictUpdater=netaddr.ip.DictUpdater-class.html"><a title="netaddr.ip.DictUpdater" class="py-name" href="#" onclick="return doclink('link-50', 'DictUpdater', 'link-50');">DictUpdater</a></tt><tt class="py-op">(</tt><tt id="link-51" class="py-name"><a title="netaddr.ip.IANA_INFO" class="py-name" href="#" onclick="return doclink('link-51', 'IANA_INFO', 'link-12');">IANA_INFO</a></tt><tt class="py-op">[</tt><tt class="py-string">'IPv4'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-string">'IPv4'</tt><tt class="py-op">,</tt> <tt class="py-string">'prefix'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L328"></a><tt class="py-lineno">328</tt> <tt class="py-line"> <tt id="link-52" class="py-name"><a title="netaddr.address.IP.ipv4" class="py-name" href="#" onclick="return doclink('link-52', 'ipv4', 'link-46');">ipv4</a></tt><tt class="py-op">.</tt><tt id="link-53" class="py-name" targets="Method netaddr.eui.IABIndexParser.parse()=netaddr.eui.IABIndexParser-class.html#parse,Method netaddr.eui.OUIIndexParser.parse()=netaddr.eui.OUIIndexParser-class.html#parse,Method netaddr.ip.LineRecordParser.parse()=netaddr.ip.LineRecordParser-class.html#parse"><a title="netaddr.eui.IABIndexParser.parse +netaddr.eui.OUIIndexParser.parse +netaddr.ip.LineRecordParser.parse" class="py-name" href="#" onclick="return doclink('link-53', 'parse', 'link-53');">parse</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L329"></a><tt class="py-lineno">329</tt> <tt class="py-line"> </tt> +<a name="L330"></a><tt class="py-lineno">330</tt> <tt class="py-line"> <tt id="link-54" class="py-name" targets="Method netaddr.address.IP.ipv6()=netaddr.address.IP-class.html#ipv6"><a title="netaddr.address.IP.ipv6" class="py-name" href="#" onclick="return doclink('link-54', 'ipv6', 'link-54');">ipv6</a></tt> <tt class="py-op">=</tt> <tt id="link-55" class="py-name"><a title="netaddr.ip.IPv6Parser" class="py-name" href="#" onclick="return doclink('link-55', 'IPv6Parser', 'link-22');">IPv6Parser</a></tt><tt class="py-op">(</tt><tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">PATH</tt><tt class="py-op">,</tt> <tt class="py-string">'ipv6-address-space'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L331"></a><tt class="py-lineno">331</tt> <tt class="py-line"> <tt id="link-56" class="py-name"><a title="netaddr.address.IP.ipv6" class="py-name" href="#" onclick="return doclink('link-56', 'ipv6', 'link-54');">ipv6</a></tt><tt class="py-op">.</tt><tt id="link-57" class="py-name"><a title="netaddr.core.Publisher.attach" class="py-name" href="#" onclick="return doclink('link-57', 'attach', 'link-49');">attach</a></tt><tt class="py-op">(</tt><tt id="link-58" class="py-name"><a title="netaddr.ip.DictUpdater" class="py-name" href="#" onclick="return doclink('link-58', 'DictUpdater', 'link-50');">DictUpdater</a></tt><tt class="py-op">(</tt><tt id="link-59" class="py-name"><a title="netaddr.ip.IANA_INFO" class="py-name" href="#" onclick="return doclink('link-59', 'IANA_INFO', 'link-12');">IANA_INFO</a></tt><tt class="py-op">[</tt><tt class="py-string">'IPv6'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-string">'IPv6'</tt><tt class="py-op">,</tt> <tt class="py-string">'prefix'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L332"></a><tt class="py-lineno">332</tt> <tt class="py-line"> <tt id="link-60" class="py-name"><a title="netaddr.address.IP.ipv6" class="py-name" href="#" onclick="return doclink('link-60', 'ipv6', 'link-54');">ipv6</a></tt><tt class="py-op">.</tt><tt id="link-61" class="py-name"><a title="netaddr.eui.IABIndexParser.parse +netaddr.eui.OUIIndexParser.parse +netaddr.ip.LineRecordParser.parse" class="py-name" href="#" onclick="return doclink('link-61', 'parse', 'link-53');">parse</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L333"></a><tt class="py-lineno">333</tt> <tt class="py-line"> </tt> +<a name="L334"></a><tt class="py-lineno">334</tt> <tt class="py-line"> <tt class="py-name">mcast</tt> <tt class="py-op">=</tt> <tt id="link-62" class="py-name"><a title="netaddr.ip.MulticastParser" class="py-name" href="#" onclick="return doclink('link-62', 'MulticastParser', 'link-26');">MulticastParser</a></tt><tt class="py-op">(</tt><tt class="py-name">open</tt><tt class="py-op">(</tt><tt class="py-name">_path</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">PATH</tt><tt class="py-op">,</tt> <tt class="py-string">'multicast-addresses'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L335"></a><tt class="py-lineno">335</tt> <tt class="py-line"> <tt class="py-name">mcast</tt><tt class="py-op">.</tt><tt id="link-63" class="py-name"><a title="netaddr.core.Publisher.attach" class="py-name" href="#" onclick="return doclink('link-63', 'attach', 'link-49');">attach</a></tt><tt class="py-op">(</tt><tt id="link-64" class="py-name"><a title="netaddr.ip.DictUpdater" class="py-name" href="#" onclick="return doclink('link-64', 'DictUpdater', 'link-50');">DictUpdater</a></tt><tt class="py-op">(</tt><tt id="link-65" class="py-name"><a title="netaddr.ip.IANA_INFO" class="py-name" href="#" onclick="return doclink('link-65', 'IANA_INFO', 'link-12');">IANA_INFO</a></tt><tt class="py-op">[</tt><tt class="py-string">'multicast'</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-string">'multicast'</tt><tt class="py-op">,</tt> <tt class="py-string">'address'</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L336"></a><tt class="py-lineno">336</tt> <tt class="py-line"> <tt class="py-name">mcast</tt><tt class="py-op">.</tt><tt id="link-66" class="py-name"><a title="netaddr.eui.IABIndexParser.parse +netaddr.eui.OUIIndexParser.parse +netaddr.ip.LineRecordParser.parse" class="py-name" href="#" onclick="return doclink('link-66', 'parse', 'link-53');">parse</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L337"></a><tt class="py-lineno">337</tt> <tt class="py-line"> </tt> +<a name="L338"></a><tt class="py-lineno">338</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="query"></a><div id="query-def"><a name="L339"></a><tt class="py-lineno">339</tt> <a class="py-toggle" href="#" id="query-toggle" onclick="return toggle('query');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.ip-module.html#query">query</a><tt class="py-op">(</tt><tt class="py-param">ip_addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="query-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="query-expanded"><a name="L340"></a><tt class="py-lineno">340</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L341"></a><tt class="py-lineno">341</tt> <tt class="py-line"><tt class="py-docstring"> Returns informational data specific to this IP address.</tt> </tt> +<a name="L342"></a><tt class="py-lineno">342</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L343"></a><tt class="py-lineno">343</tt> <tt class="py-line"> <tt id="link-67" class="py-name" targets="Method netaddr.address.EUI.info()=netaddr.address.EUI-class.html#info,Method netaddr.address.IP.info()=netaddr.address.IP-class.html#info"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-67', 'info', 'link-67');">info</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt><tt class="py-op">}</tt> </tt> +<a name="L344"></a><tt class="py-lineno">344</tt> <tt class="py-line"> </tt> +<a name="L345"></a><tt class="py-lineno">345</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-68" class="py-name" targets="Variable netaddr.address.Addr.addr_type=netaddr.address.Addr-class.html#addr_type,Variable netaddr.address.CIDR.addr_type=netaddr.address.CIDR-class.html#addr_type,Variable netaddr.address.EUI.addr_type=netaddr.address.EUI-class.html#addr_type,Variable netaddr.address.IP.addr_type=netaddr.address.IP-class.html#addr_type,Variable netaddr.address.IPRange.addr_type=netaddr.address.IPRange-class.html#addr_type,Variable netaddr.address.Wildcard.addr_type=netaddr.address.Wildcard-class.html#addr_type"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-68', 'addr_type', 'link-68');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-69" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-69', 'AT_INET', 'link-6');">AT_INET</a></tt><tt class="py-op">:</tt> </tt> +<a name="L346"></a><tt class="py-lineno">346</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-70" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-70', 'cidr', 'link-30');">cidr</a></tt><tt class="py-op">,</tt> <tt class="py-name">record</tt> <tt class="py-keyword">in</tt> <tt id="link-71" class="py-name"><a title="netaddr.ip.IANA_INFO" class="py-name" href="#" onclick="return doclink('link-71', 'IANA_INFO', 'link-12');">IANA_INFO</a></tt><tt class="py-op">[</tt><tt class="py-string">'IPv4'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">items</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L347"></a><tt class="py-lineno">347</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ip_addr</tt> <tt class="py-keyword">in</tt> <tt id="link-72" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-72', 'cidr', 'link-30');">cidr</a></tt><tt class="py-op">:</tt> </tt> +<a name="L348"></a><tt class="py-lineno">348</tt> <tt class="py-line"> <tt id="link-73" class="py-name"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-73', 'info', 'link-67');">info</a></tt><tt class="py-op">.</tt><tt class="py-name">setdefault</tt><tt class="py-op">(</tt><tt class="py-string">'IPv4'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L349"></a><tt class="py-lineno">349</tt> <tt class="py-line"> <tt id="link-74" class="py-name"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-74', 'info', 'link-67');">info</a></tt><tt class="py-op">[</tt><tt class="py-string">'IPv4'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +<a name="L350"></a><tt class="py-lineno">350</tt> <tt class="py-line"> </tt> +<a name="L351"></a><tt class="py-lineno">351</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-75" class="py-name" targets="Method netaddr.address.IP.is_multicast()=netaddr.address.IP-class.html#is_multicast"><a title="netaddr.address.IP.is_multicast" class="py-name" href="#" onclick="return doclink('link-75', 'is_multicast', 'link-75');">is_multicast</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L352"></a><tt class="py-lineno">352</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-76" class="py-name"><a title="netaddr.address.IP.iprange +netaddr.address.IPRange.iprange" class="py-name" href="#" onclick="return doclink('link-76', 'iprange', 'link-36');">iprange</a></tt><tt class="py-op">,</tt> <tt class="py-name">record</tt> <tt class="py-keyword">in</tt> <tt id="link-77" class="py-name"><a title="netaddr.ip.IANA_INFO" class="py-name" href="#" onclick="return doclink('link-77', 'IANA_INFO', 'link-12');">IANA_INFO</a></tt><tt class="py-op">[</tt><tt class="py-string">'multicast'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">items</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L353"></a><tt class="py-lineno">353</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ip_addr</tt> <tt class="py-keyword">in</tt> <tt id="link-78" class="py-name"><a title="netaddr.address.IP.iprange +netaddr.address.IPRange.iprange" class="py-name" href="#" onclick="return doclink('link-78', 'iprange', 'link-36');">iprange</a></tt><tt class="py-op">:</tt> </tt> +<a name="L354"></a><tt class="py-lineno">354</tt> <tt class="py-line"> <tt id="link-79" class="py-name"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-79', 'info', 'link-67');">info</a></tt><tt class="py-op">.</tt><tt class="py-name">setdefault</tt><tt class="py-op">(</tt><tt class="py-string">'Multicast'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L355"></a><tt class="py-lineno">355</tt> <tt class="py-line"> <tt id="link-80" class="py-name"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-80', 'info', 'link-67');">info</a></tt><tt class="py-op">[</tt><tt class="py-string">'Multicast'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +<a name="L356"></a><tt class="py-lineno">356</tt> <tt class="py-line"> </tt> +<a name="L357"></a><tt class="py-lineno">357</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">ip_addr</tt><tt class="py-op">.</tt><tt id="link-81" class="py-name"><a title="netaddr.address.Addr.addr_type +netaddr.address.CIDR.addr_type +netaddr.address.EUI.addr_type +netaddr.address.IP.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-81', 'addr_type', 'link-68');">addr_type</a></tt> <tt class="py-op">==</tt> <tt id="link-82" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-82', 'AT_INET6', 'link-7');">AT_INET6</a></tt><tt class="py-op">:</tt> </tt> +<a name="L358"></a><tt class="py-lineno">358</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-83" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-83', 'cidr', 'link-30');">cidr</a></tt><tt class="py-op">,</tt> <tt class="py-name">record</tt> <tt class="py-keyword">in</tt> <tt id="link-84" class="py-name"><a title="netaddr.ip.IANA_INFO" class="py-name" href="#" onclick="return doclink('link-84', 'IANA_INFO', 'link-12');">IANA_INFO</a></tt><tt class="py-op">[</tt><tt class="py-string">'IPv6'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">items</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L359"></a><tt class="py-lineno">359</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ip_addr</tt> <tt class="py-keyword">in</tt> <tt id="link-85" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-85', 'cidr', 'link-30');">cidr</a></tt><tt class="py-op">:</tt> </tt> +<a name="L360"></a><tt class="py-lineno">360</tt> <tt class="py-line"> <tt id="link-86" class="py-name"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-86', 'info', 'link-67');">info</a></tt><tt class="py-op">.</tt><tt class="py-name">setdefault</tt><tt class="py-op">(</tt><tt class="py-string">'IPv6'</tt><tt class="py-op">,</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L361"></a><tt class="py-lineno">361</tt> <tt class="py-line"> <tt id="link-87" class="py-name"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-87', 'info', 'link-67');">info</a></tt><tt class="py-op">[</tt><tt class="py-string">'IPv6'</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">record</tt><tt class="py-op">)</tt> </tt> +<a name="L362"></a><tt class="py-lineno">362</tt> <tt class="py-line"> </tt> +<a name="L363"></a><tt class="py-lineno">363</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-88" class="py-name"><a title="netaddr.address.EUI.info +netaddr.address.IP.info" class="py-name" href="#" onclick="return doclink('link-88', 'info', 'link-67');">info</a></tt> </tt> +</div><a name="L364"></a><tt class="py-lineno">364</tt> <tt class="py-line"> </tt> +<a name="L365"></a><tt class="py-lineno">365</tt> <tt class="py-line"><tt class="py-comment"># On module import, read IANA data files and populate lookups dict.</tt> </tt> +<a name="L366"></a><tt class="py-lineno">366</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-89" class="py-name" targets="Function netaddr.ip.load_iana_info()=netaddr.ip-module.html#load_iana_info"><a title="netaddr.ip.load_iana_info" class="py-name" href="#" onclick="return doclink('link-89', 'load_iana_info', 'link-89');">load_iana_info</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L367"></a><tt class="py-lineno">367</tt> <tt class="py-line"> </tt><script type="text/javascript"> +<!-- +expandto(location.href); +// --> +</script> +</pre> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:24 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.ip.DictUpdater-class.html b/docs/api/netaddr.ip.DictUpdater-class.html new file mode 100644 index 0000000..040f809 --- /dev/null +++ b/docs/api/netaddr.ip.DictUpdater-class.html @@ -0,0 +1,268 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.ip.DictUpdater</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.ip-module.html">Package ip</a> :: + Class DictUpdater + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.ip.DictUpdater-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class DictUpdater</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.ip-pysrc.html#DictUpdater">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Subscriber-class.html">core.Subscriber</a> --+ + | + <strong class="uidshort">DictUpdater</strong> +</pre> + +<hr /> +<p>Concrete Subscriber that inserts records received from a Publisher + into a dictionary.</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.DictUpdater-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">dct</span>, + <span class="summary-sig-arg">topic</span>, + <span class="summary-sig-arg">unique_key</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#DictUpdater.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.DictUpdater-class.html#update" class="summary-sig-name">update</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">data</span>)</span><br /> + Callback function used by Publisher to notify this Subscriber about + an update.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#DictUpdater.update">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">dct</span>, + <span class="sig-arg">topic</span>, + <span class="sig-arg">unique_key</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#DictUpdater.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>dct - lookup dict or dict like object to insert records into.</p> + <p>topic - high-level category name of data to be processed.</p> + <p>unique_key - key name in data dict that uniquely identifies it.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="update"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">update</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">data</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#DictUpdater.update">source code</a></span> + </td> + </tr></table> + + <p>Callback function used by Publisher to notify this Subscriber about an + update. Stores topic based information into dictionary passed to + constructor.</p> + <dl class="fields"> + <dt>Overrides: + <a href="netaddr.core.Subscriber-class.html#update">core.Subscriber.update</a> + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.ip.IPv4Parser-class.html b/docs/api/netaddr.ip.IPv4Parser-class.html new file mode 100644 index 0000000..f573127 --- /dev/null +++ b/docs/api/netaddr.ip.IPv4Parser-class.html @@ -0,0 +1,277 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.ip.IPv4Parser</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.ip-module.html">Package ip</a> :: + Class IPv4Parser + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.ip.IPv4Parser-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class IPv4Parser</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.ip-pysrc.html#IPv4Parser">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Publisher-class.html">core.Publisher</a> --+ + | + <a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a> --+ + | + <strong class="uidshort">IPv4Parser</strong> +</pre> + +<hr /> +<p>A LineRecordParser that understands how to parse and retrieve data + records from the IANA IPv4 address space file.</p> + <p>It can be found online here :-</p> + <p>http://www.iana.org/assignments/ipv4-address-space</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.IPv4Parser-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">fh</span>, + <span class="summary-sig-arg">**kwargs</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#IPv4Parser.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.IPv4Parser-class.html#parse_line" class="summary-sig-name">parse_line</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">line</span>)</span><br /> + Callback method invoked for every line considered valid by the line + parser's settings.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#IPv4Parser.parse_line">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a></code></b>: + <code><a href="netaddr.ip.LineRecordParser-class.html#parse">parse</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.core.Publisher-class.html">core.Publisher</a></code></b>: + <code><a href="netaddr.core.Publisher-class.html#attach">attach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#detach">detach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#notify">notify</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">fh</span>, + <span class="sig-arg">**kwargs</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#IPv4Parser.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>fh - a valid, open file handle to an OUI Registry data file.</p> + <p>kwargs - additional parser options.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="parse_line"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">parse_line</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">line</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#IPv4Parser.parse_line">source code</a></span> + </td> + </tr></table> + + <p>Callback method invoked for every line considered valid by the line + parser's settings.</p> + <p>See base class method for more details.</p> + <dl class="fields"> + <dt>Overrides: + <a href="netaddr.ip.LineRecordParser-class.html#parse_line">LineRecordParser.parse_line</a> + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.ip.IPv6Parser-class.html b/docs/api/netaddr.ip.IPv6Parser-class.html new file mode 100644 index 0000000..85e1e6e --- /dev/null +++ b/docs/api/netaddr.ip.IPv6Parser-class.html @@ -0,0 +1,277 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.ip.IPv6Parser</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.ip-module.html">Package ip</a> :: + Class IPv6Parser + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.ip.IPv6Parser-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class IPv6Parser</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.ip-pysrc.html#IPv6Parser">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Publisher-class.html">core.Publisher</a> --+ + | + <a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a> --+ + | + <strong class="uidshort">IPv6Parser</strong> +</pre> + +<hr /> +<p>A LineRecordParser that understands how to parse and retrieve data + records from the IANA IPv6 address space file.</p> + <p>It can be found online here :-</p> + <p>http://www.iana.org/assignments/ipv6-address-space</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.IPv6Parser-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">fh</span>, + <span class="summary-sig-arg">**kwargs</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#IPv6Parser.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.IPv6Parser-class.html#parse_line" class="summary-sig-name">parse_line</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">line</span>)</span><br /> + Callback method invoked for every line considered valid by the line + parser's settings.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#IPv6Parser.parse_line">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a></code></b>: + <code><a href="netaddr.ip.LineRecordParser-class.html#parse">parse</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.core.Publisher-class.html">core.Publisher</a></code></b>: + <code><a href="netaddr.core.Publisher-class.html#attach">attach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#detach">detach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#notify">notify</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">fh</span>, + <span class="sig-arg">**kwargs</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#IPv6Parser.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>fh - a valid, open file handle to an OUI Registry data file.</p> + <p>kwargs - additional parser options.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="parse_line"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">parse_line</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">line</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#IPv6Parser.parse_line">source code</a></span> + </td> + </tr></table> + + <p>Callback method invoked for every line considered valid by the line + parser's settings.</p> + <p>See base class method for more details.</p> + <dl class="fields"> + <dt>Overrides: + <a href="netaddr.ip.LineRecordParser-class.html#parse_line">LineRecordParser.parse_line</a> + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.ip.LineRecordParser-class.html b/docs/api/netaddr.ip.LineRecordParser-class.html new file mode 100644 index 0000000..5128f2c --- /dev/null +++ b/docs/api/netaddr.ip.LineRecordParser-class.html @@ -0,0 +1,292 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.ip.LineRecordParser</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.ip-module.html">Package ip</a> :: + Class LineRecordParser + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.ip.LineRecordParser-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class LineRecordParser</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.ip-pysrc.html#LineRecordParser">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Publisher-class.html">core.Publisher</a> --+ + | + <strong class="uidshort">LineRecordParser</strong> +</pre> + +<dl><dt>Known Subclasses:</dt> +<dd> + <ul class="subclass-list"> +<li><a href="netaddr.ip.IPv4Parser-class.html">IPv4Parser</a></li><li>, <a href="netaddr.ip.IPv6Parser-class.html">IPv6Parser</a></li><li>, <a href="netaddr.ip.MulticastParser-class.html">MulticastParser</a></li> </ul> +</dd></dl> + +<hr /> +<p>A configurable Parser that understands how to parse line based + records.</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.LineRecordParser-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">fh</span>, + <span class="summary-sig-arg">**kwargs</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#LineRecordParser.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.LineRecordParser-class.html#parse_line" class="summary-sig-name">parse_line</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">line</span>)</span><br /> + This is the callback method invoked for every line considered valid + by the line parser's settings.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#LineRecordParser.parse_line">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="parse"></a><span class="summary-sig-name">parse</span>(<span class="summary-sig-arg">self</span>)</span><br /> + Parse and normalises records, notifying registered subscribers with + record data as it is encountered.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#LineRecordParser.parse">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.core.Publisher-class.html">core.Publisher</a></code></b>: + <code><a href="netaddr.core.Publisher-class.html#attach">attach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#detach">detach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#notify">notify</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">fh</span>, + <span class="sig-arg">**kwargs</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#LineRecordParser.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>fh - a valid, open file handle to line based record data.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="parse_line"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">parse_line</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">line</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#LineRecordParser.parse_line">source code</a></span> + </td> + </tr></table> + + <p>This is the callback method invoked for every line considered valid by + the line parser's settings. It is usually over-ridden by base classes to + provide specific line parsing and line skipping logic.</p> + <p>Any line can be vetoed (not passed to registered Subscriber objects) + by simply returning None.</p> + <dl class="fields"> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.ip.MulticastParser-class.html b/docs/api/netaddr.ip.MulticastParser-class.html new file mode 100644 index 0000000..b9bc6cf --- /dev/null +++ b/docs/api/netaddr.ip.MulticastParser-class.html @@ -0,0 +1,296 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.ip.MulticastParser</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + <a href="netaddr.ip-module.html">Package ip</a> :: + Class MulticastParser + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.ip.MulticastParser-class.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== CLASS DESCRIPTION ==================== --> +<h1 class="epydoc">Class MulticastParser</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.ip-pysrc.html#MulticastParser">source code</a></span></p> +<pre class="base-tree"> + object --+ + | +<a href="netaddr.core.Publisher-class.html">core.Publisher</a> --+ + | + <a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a> --+ + | + <strong class="uidshort">MulticastParser</strong> +</pre> + +<hr /> +<p>A LineParser that knows how to process the IANA IPv4 multicast address + allocation file.</p> + <p>It can be found online here :-</p> + <p>http://www.iana.org/assignments/multicast-addresses</p> + +<!-- ==================== INSTANCE METHODS ==================== --> +<a name="section-InstanceMethods"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Instance Methods</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.MulticastParser-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">fh</span>, + <span class="summary-sig-arg">**kwargs</span>)</span><br /> + Constructor.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#MulticastParser.__init__">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="normalise_addr"></a><span class="summary-sig-name">normalise_addr</span>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">addr</span>)</span><br /> + Removes variations from address entries found in this particular + file.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#MulticastParser.normalise_addr">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a href="netaddr.ip.MulticastParser-class.html#parse_line" class="summary-sig-name">parse_line</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">line</span>)</span><br /> + Callback method invoked for every line considered valid by the line + parser's settings.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.ip-pysrc.html#MulticastParser.parse_line">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.ip.LineRecordParser-class.html">LineRecordParser</a></code></b>: + <code><a href="netaddr.ip.LineRecordParser-class.html#parse">parse</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.core.Publisher-class.html">core.Publisher</a></code></b>: + <code><a href="netaddr.core.Publisher-class.html#attach">attach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#detach">detach</a></code>, + <code><a href="netaddr.core.Publisher-class.html#notify">notify</a></code> + </p> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__delattr__</code>, + <code>__getattribute__</code>, + <code>__hash__</code>, + <code>__new__</code>, + <code>__reduce__</code>, + <code>__reduce_ex__</code>, + <code>__repr__</code>, + <code>__setattr__</code>, + <code>__str__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== PROPERTIES ==================== --> +<a name="section-Properties"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Properties</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: + <code>__class__</code> + </p> + </td> + </tr> +</table> +<!-- ==================== METHOD DETAILS ==================== --> +<a name="section-MethodDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Method Details</span></td> +</tr> +</table> +<a name="__init__"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">fh</span>, + <span class="sig-arg">**kwargs</span>)</span> + <br /><em class="fname">(Constructor)</em> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#MulticastParser.__init__">source code</a></span> + </td> + </tr></table> + + <p>Constructor.</p> + <p>fh - a valid, open file handle to an OUI Registry data file.</p> + <p>kwargs - additional parser options.</p> + <dl class="fields"> + <dt>Overrides: + object.__init__ + </dt> + </dl> +</td></tr></table> +</div> +<a name="parse_line"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">parse_line</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">line</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.ip-pysrc.html#MulticastParser.parse_line">source code</a></span> + </td> + </tr></table> + + <p>Callback method invoked for every line considered valid by the line + parser's settings.</p> + <p>See base class method for more details.</p> + <dl class="fields"> + <dt>Overrides: + <a href="netaddr.ip.LineRecordParser-class.html#parse_line">LineRecordParser.parse_line</a> + </dt> + </dl> +</td></tr></table> +</div> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.misc-module.html b/docs/api/netaddr.misc-module.html new file mode 100644 index 0000000..8073db4 --- /dev/null +++ b/docs/api/netaddr.misc-module.html @@ -0,0 +1,196 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.misc</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Module misc + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.misc-module.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<!-- ==================== MODULE DESCRIPTION ==================== --> +<h1 class="epydoc">Module misc</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.misc-pysrc.html">source code</a></span></p> +<p>Miscellanous functions and classes. Do not rely on anything in here as + it is liable to change, move or be deleted with each release.</p> + +<!-- ==================== FUNCTIONS ==================== --> +<a name="section-Functions"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Functions</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="ipv4_cidr_prefixes"></a><span class="summary-sig-name">ipv4_cidr_prefixes</span>()</span><br /> + Returns a recordset (list of dicts) of host/network breakdown for + IPv4 using all of the various CIDR prefixes.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.misc-pysrc.html#ipv4_cidr_prefixes">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="ipv6_cidr_prefixes"></a><span class="summary-sig-name">ipv6_cidr_prefixes</span>()</span><br /> + Returns a recordset (list of dicts) of host/network breakdown for + IPv6 using all of the various CIDR prefixes.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.misc-pysrc.html#ipv6_cidr_prefixes">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="print_ipv4_cidr_prefixes"></a><span class="summary-sig-name">print_ipv4_cidr_prefixes</span>()</span><br /> + Prints a table to stdout of host/network breakdown for IPv4 using + CIDR notation.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.misc-pysrc.html#print_ipv4_cidr_prefixes">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> + <td><span class="summary-sig"><a name="print_ipv6_cidr_prefixes"></a><span class="summary-sig-name">print_ipv6_cidr_prefixes</span>()</span><br /> + Prints a table to stdout of host/network breakdown for IPv6 using + CIDR notation.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.misc-pysrc.html#print_ipv6_cidr_prefixes">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +</table> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.misc-pysrc.html b/docs/api/netaddr.misc-pysrc.html new file mode 100644 index 0000000..38526f7 --- /dev/null +++ b/docs/api/netaddr.misc-pysrc.html @@ -0,0 +1,194 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>netaddr.misc</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table width="100%" cellpadding="0" cellspacing="0"> + <tr valign="top"> + <td width="100%"> + <span class="breadcrumbs"> + <a href="netaddr-module.html">Package netaddr</a> :: + Module misc + </span> + </td> + <td> + <table cellpadding="0" cellspacing="0"> + <!-- hide/show private --> + <tr><td align="right"><span class="options" + >[<a href="frames.html" target="_top">frames</a + >] | <a href="netaddr.misc-pysrc.html" + target="_top">no frames</a>]</span></td></tr> + </table> + </td> + </tr> +</table> +<h1 class="epydoc">Source Code for <a href="netaddr.misc-module.html">Module netaddr.misc</a></h1> +<pre class="py-src"> +<a name="L1"></a><tt class="py-lineno"> 1</tt> <tt class="py-line"><tt class="py-comment">#!/usr/bin/env python</tt> </tt> +<a name="L2"></a><tt class="py-lineno"> 2</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L3"></a><tt class="py-lineno"> 3</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Copyright (c) 2008, David P. D. Moss. All rights reserved.</tt> </tt> +<a name="L4"></a><tt class="py-lineno"> 4</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#</tt> </tt> +<a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Released under the BSD license. See the LICENSE file for details.</tt> </tt> +<a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-docstring">"""</tt> </tt> +<a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">Miscellanous functions and classes. Do not rely on anything in here as it is</tt> </tt> +<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">liable to change, move or be deleted with each release.</tt> </tt> +<a name="L10"></a><tt class="py-lineno">10</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> +<a name="L11"></a><tt class="py-lineno">11</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">pprint</tt> </tt> +<a name="L12"></a><tt class="py-lineno">12</tt> <tt class="py-line"> </tt> +<a name="L13"></a><tt class="py-lineno">13</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-0" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-0', 'netaddr', 'link-0');">netaddr</a></tt> <tt class="py-keyword">import</tt> <tt id="link-1" class="py-name" targets="Class netaddr.address.CIDR=netaddr.address.CIDR-class.html"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-1', 'CIDR', 'link-1');">CIDR</a></tt><tt class="py-op">,</tt> <tt id="link-2" class="py-name" targets="Class netaddr.address.Wildcard=netaddr.address.Wildcard-class.html"><a title="netaddr.address.Wildcard" class="py-name" href="#" onclick="return doclink('link-2', 'Wildcard', 'link-2');">Wildcard</a></tt> </tt> +<a name="L14"></a><tt class="py-lineno">14</tt> <tt class="py-line"> </tt> +<a name="L15"></a><tt class="py-lineno">15</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="ipv4_cidr_prefixes"></a><div id="ipv4_cidr_prefixes-def"><a name="L16"></a><tt class="py-lineno">16</tt> <a class="py-toggle" href="#" id="ipv4_cidr_prefixes-toggle" onclick="return toggle('ipv4_cidr_prefixes');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.misc-module.html#ipv4_cidr_prefixes">ipv4_cidr_prefixes</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="ipv4_cidr_prefixes-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="ipv4_cidr_prefixes-expanded"><a name="L17"></a><tt class="py-lineno">17</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L18"></a><tt class="py-lineno">18</tt> <tt class="py-line"><tt class="py-docstring"> Returns a recordset (list of dicts) of host/network breakdown for IPv4</tt> </tt> +<a name="L19"></a><tt class="py-lineno">19</tt> <tt class="py-line"><tt class="py-docstring"> using all of the various CIDR prefixes.</tt> </tt> +<a name="L20"></a><tt class="py-lineno">20</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L21"></a><tt class="py-lineno">21</tt> <tt class="py-line"> <tt class="py-name">table</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L22"></a><tt class="py-lineno">22</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">32</tt> </tt> +<a name="L23"></a><tt class="py-lineno">23</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">prefix</tt> <tt class="py-op">>=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L24"></a><tt class="py-lineno">24</tt> <tt class="py-line"> <tt id="link-3" class="py-name" targets="Method netaddr.address.IP.cidr()=netaddr.address.IP-class.html#cidr"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-3', 'cidr', 'link-3');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-4" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-4', 'CIDR', 'link-1');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'0.0.0.0/%d'</tt> <tt class="py-op">%</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt> </tt> +<a name="L25"></a><tt class="py-lineno">25</tt> <tt class="py-line"> <tt class="py-name">table</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt><tt class="py-op">=</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt id="link-5" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-5', 'cidr', 'link-3');">cidr</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">hosts</tt><tt class="py-op">=</tt><tt id="link-6" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-6', 'cidr', 'link-3');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-7" class="py-name" targets="Method netaddr.address.IPRange.size()=netaddr.address.IPRange-class.html#size"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-7', 'size', 'link-7');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L26"></a><tt class="py-lineno">26</tt> <tt class="py-line"> <tt class="py-name">networks</tt><tt class="py-op">=</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt id="link-8" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-8', 'cidr', 'link-3');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-9" class="py-name" targets="Variable netaddr.address.CIDR.prefixlen=netaddr.address.CIDR-class.html#prefixlen,Variable netaddr.address.IP.prefixlen=netaddr.address.IP-class.html#prefixlen"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-9', 'prefixlen', 'link-9');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L27"></a><tt class="py-lineno">27</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">-=</tt> <tt class="py-number">1</tt> </tt> +<a name="L28"></a><tt class="py-lineno">28</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">table</tt> </tt> +</div><a name="L29"></a><tt class="py-lineno">29</tt> <tt class="py-line"> </tt> +<a name="L30"></a><tt class="py-lineno">30</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="ipv6_cidr_prefixes"></a><div id="ipv6_cidr_prefixes-def"><a name="L31"></a><tt class="py-lineno">31</tt> <a class="py-toggle" href="#" id="ipv6_cidr_prefixes-toggle" onclick="return toggle('ipv6_cidr_prefixes');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.misc-module.html#ipv6_cidr_prefixes">ipv6_cidr_prefixes</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="ipv6_cidr_prefixes-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="ipv6_cidr_prefixes-expanded"><a name="L32"></a><tt class="py-lineno">32</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L33"></a><tt class="py-lineno">33</tt> <tt class="py-line"><tt class="py-docstring"> Returns a recordset (list of dicts) of host/network breakdown for IPv6</tt> </tt> +<a name="L34"></a><tt class="py-lineno">34</tt> <tt class="py-line"><tt class="py-docstring"> using all of the various CIDR prefixes.</tt> </tt> +<a name="L35"></a><tt class="py-lineno">35</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L36"></a><tt class="py-lineno">36</tt> <tt class="py-line"> <tt class="py-name">table</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L37"></a><tt class="py-lineno">37</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">=</tt> <tt class="py-number">128</tt> </tt> +<a name="L38"></a><tt class="py-lineno">38</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">prefix</tt> <tt class="py-op">>=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L39"></a><tt class="py-lineno">39</tt> <tt class="py-line"> <tt id="link-10" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-10', 'cidr', 'link-3');">cidr</a></tt> <tt class="py-op">=</tt> <tt id="link-11" class="py-name"><a title="netaddr.address.CIDR" class="py-name" href="#" onclick="return doclink('link-11', 'CIDR', 'link-1');">CIDR</a></tt><tt class="py-op">(</tt><tt class="py-string">'::/%d'</tt> <tt class="py-op">%</tt> <tt class="py-name">prefix</tt><tt class="py-op">)</tt> </tt> +<a name="L40"></a><tt class="py-lineno">40</tt> <tt class="py-line"> <tt class="py-name">table</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">dict</tt><tt class="py-op">(</tt><tt class="py-name">prefix</tt><tt class="py-op">=</tt><tt class="py-name">str</tt><tt class="py-op">(</tt><tt id="link-12" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-12', 'cidr', 'link-3');">cidr</a></tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-name">hosts</tt><tt class="py-op">=</tt><tt id="link-13" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-13', 'cidr', 'link-3');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-14" class="py-name"><a title="netaddr.address.IPRange.size" class="py-name" href="#" onclick="return doclink('link-14', 'size', 'link-7');">size</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> </tt> +<a name="L41"></a><tt class="py-lineno">41</tt> <tt class="py-line"> <tt class="py-name">networks</tt><tt class="py-op">=</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt id="link-15" class="py-name"><a title="netaddr.address.IP.cidr" class="py-name" href="#" onclick="return doclink('link-15', 'cidr', 'link-3');">cidr</a></tt><tt class="py-op">.</tt><tt id="link-16" class="py-name"><a title="netaddr.address.CIDR.prefixlen +netaddr.address.IP.prefixlen" class="py-name" href="#" onclick="return doclink('link-16', 'prefixlen', 'link-9');">prefixlen</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L42"></a><tt class="py-lineno">42</tt> <tt class="py-line"> <tt class="py-name">prefix</tt> <tt class="py-op">-=</tt> <tt class="py-number">1</tt> </tt> +<a name="L43"></a><tt class="py-lineno">43</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">table</tt> </tt> +</div><a name="L44"></a><tt class="py-lineno">44</tt> <tt class="py-line"> </tt> +<a name="L45"></a><tt class="py-lineno">45</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="print_ipv4_cidr_prefixes"></a><div id="print_ipv4_cidr_prefixes-def"><a name="L46"></a><tt class="py-lineno">46</tt> <a class="py-toggle" href="#" id="print_ipv4_cidr_prefixes-toggle" onclick="return toggle('print_ipv4_cidr_prefixes');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.misc-module.html#print_ipv4_cidr_prefixes">print_ipv4_cidr_prefixes</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="print_ipv4_cidr_prefixes-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="print_ipv4_cidr_prefixes-expanded"><a name="L47"></a><tt class="py-lineno">47</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L48"></a><tt class="py-lineno">48</tt> <tt class="py-line"><tt class="py-docstring"> Prints a table to stdout of host/network breakdown for IPv4 using CIDR</tt> </tt> +<a name="L49"></a><tt class="py-lineno">49</tt> <tt class="py-line"><tt class="py-docstring"> notation.</tt> </tt> +<a name="L50"></a><tt class="py-lineno">50</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L51"></a><tt class="py-lineno">51</tt> <tt class="py-line"> <tt class="py-keyword">print</tt> <tt class="py-string">'%-10s %-15s %-15s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-string">'Prefix'</tt><tt class="py-op">,</tt> <tt class="py-string">'Hosts'</tt><tt class="py-op">,</tt> <tt class="py-string">'Networks'</tt><tt class="py-op">)</tt> </tt> +<a name="L52"></a><tt class="py-lineno">52</tt> <tt class="py-line"> <tt class="py-keyword">print</tt> <tt class="py-string">'-'</tt><tt class="py-op">*</tt><tt class="py-number">10</tt><tt class="py-op">,</tt> <tt class="py-string">'-'</tt><tt class="py-op">*</tt><tt class="py-number">15</tt><tt class="py-op">,</tt> <tt class="py-string">'-'</tt><tt class="py-op">*</tt><tt class="py-number">15</tt> </tt> +<a name="L53"></a><tt class="py-lineno">53</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">record</tt> <tt class="py-keyword">in</tt> <tt id="link-17" class="py-name" targets="Function netaddr.misc.ipv4_cidr_prefixes()=netaddr.misc-module.html#ipv4_cidr_prefixes"><a title="netaddr.misc.ipv4_cidr_prefixes" class="py-name" href="#" onclick="return doclink('link-17', 'ipv4_cidr_prefixes', 'link-17');">ipv4_cidr_prefixes</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L54"></a><tt class="py-lineno">54</tt> <tt class="py-line"> <tt class="py-keyword">print</tt> <tt class="py-string">'%(prefix)-10s %(hosts)15s %(networks)15s'</tt> <tt class="py-op">%</tt> <tt class="py-name">record</tt> </tt> +</div><a name="L55"></a><tt class="py-lineno">55</tt> <tt class="py-line"> </tt> +<a name="L56"></a><tt class="py-lineno">56</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="print_ipv6_cidr_prefixes"></a><div id="print_ipv6_cidr_prefixes-def"><a name="L57"></a><tt class="py-lineno">57</tt> <a class="py-toggle" href="#" id="print_ipv6_cidr_prefixes-toggle" onclick="return toggle('print_ipv6_cidr_prefixes');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.misc-module.html#print_ipv6_cidr_prefixes">print_ipv6_cidr_prefixes</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="print_ipv6_cidr_prefixes-collapsed" style="display:none;" pad="++" indent="++++"></div><div id="print_ipv6_cidr_prefixes-expanded"><a name="L58"></a><tt class="py-lineno">58</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L59"></a><tt class="py-lineno">59</tt> <tt class="py-line"><tt class="py-docstring"> Prints a table to stdout of host/network breakdown for IPv6 using CIDR</tt> </tt> +<a name="L60"></a><tt class="py-lineno">60</tt> <tt class="py-line"><tt class="py-docstring"> notation.</tt> </tt> +<a name="L61"></a><tt class="py-lineno">61</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L62"></a><tt class="py-lineno">62</tt> <tt class="py-line"> <tt class="py-keyword">print</tt> <tt class="py-string">'%-10s %-40s %-40s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-string">'Prefix'</tt><tt class="py-op">,</tt> <tt class="py-string">'Hosts'</tt><tt class="py-op">,</tt> <tt class="py-string">'Networks'</tt><tt class="py-op">)</tt> </tt> +<a name="L63"></a><tt class="py-lineno">63</tt> <tt class="py-line"> <tt class="py-keyword">print</tt> <tt class="py-string">'-'</tt><tt class="py-op">*</tt><tt class="py-number">10</tt><tt class="py-op">,</tt> <tt class="py-string">'-'</tt><tt class="py-op">*</tt><tt class="py-number">40</tt><tt class="py-op">,</tt> <tt class="py-string">'-'</tt><tt class="py-op">*</tt><tt class="py-number">40</tt> </tt> +<a name="L64"></a><tt class="py-lineno">64</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">record</tt> <tt class="py-keyword">in</tt> <tt id="link-18" class="py-name" targets="Function netaddr.misc.ipv6_cidr_prefixes()=netaddr.misc-module.html#ipv6_cidr_prefixes"><a title="netaddr.misc.ipv6_cidr_prefixes" class="py-name" href="#" onclick="return doclink('link-18', 'ipv6_cidr_prefixes', 'link-18');">ipv6_cidr_prefixes</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L65"></a><tt class="py-lineno">65</tt> <tt class="py-line"> <tt class="py-keyword">print</tt> <tt class="py-string">'%(prefix)-10s %(hosts)40s %(networks)40s'</tt> <tt class="py-op">%</tt> <tt class="py-name">record</tt> </tt> +</div><a name="L66"></a><tt class="py-lineno">66</tt> <tt class="py-line"> </tt> +<a name="L67"></a><tt class="py-lineno">67</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L68"></a><tt class="py-lineno">68</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">if</tt> <tt class="py-name">__name__</tt> <tt class="py-op">==</tt> <tt class="py-string">'__main__'</tt><tt class="py-op">:</tt> </tt> +<a name="L69"></a><tt class="py-lineno">69</tt> <tt class="py-line"> <tt class="py-keyword">import</tt> <tt class="py-name">pprint</tt> </tt> +<a name="L70"></a><tt class="py-lineno">70</tt> <tt class="py-line"> <tt class="py-comment">#pprint.pprint(ipv4_cidr_prefixes())</tt> </tt> +<a name="L71"></a><tt class="py-lineno">71</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-19" class="py-name" targets="Function netaddr.misc.print_ipv4_cidr_prefixes()=netaddr.misc-module.html#print_ipv4_cidr_prefixes"><a title="netaddr.misc.print_ipv4_cidr_prefixes" class="py-name" href="#" onclick="return doclink('link-19', 'print_ipv4_cidr_prefixes', 'link-19');">print_ipv4_cidr_prefixes</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L72"></a><tt class="py-lineno">72</tt> <tt class="py-line"> <tt class="py-comment">#pprint.pprint(ipv6_cidr_prefixes())</tt> </tt> +<a name="L73"></a><tt class="py-lineno">73</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-20" class="py-name" targets="Function netaddr.misc.print_ipv6_cidr_prefixes()=netaddr.misc-module.html#print_ipv6_cidr_prefixes"><a title="netaddr.misc.print_ipv6_cidr_prefixes" class="py-name" href="#" onclick="return doclink('link-20', 'print_ipv6_cidr_prefixes', 'link-20');">print_ipv6_cidr_prefixes</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L74"></a><tt class="py-lineno">74</tt> <tt class="py-line"> </tt><script type="text/javascript"> +<!-- +expandto(location.href); +// --> +</script> +</pre> +<br /> +<!-- ==================== NAVIGATION BAR ==================== --> +<table class="navbar" border="0" width="100%" cellpadding="0" + bgcolor="#a0c0ff" cellspacing="0"> + <tr valign="middle"> + <!-- Home link --> + <th> <a + href="netaddr-module.html">Home</a> </th> + + <!-- Tree link --> + <th> <a + href="module-tree.html">Trees</a> </th> + + <!-- Index link --> + <th> <a + href="identifier-index.html">Indices</a> </th> + + <!-- Help link --> + <th> <a + href="help.html">Help</a> </th> + + <!-- Project homepage --> + <th class="navbar" align="right" width="100%"> + <table border="0" cellpadding="0" cellspacing="0"> + <tr><th class="navbar" align="center" + >netaddr</th> + </tr></table></th> + </tr> +</table> +<table border="0" cellpadding="0" cellspacing="0" width="100%%"> + <tr> + <td align="left" class="footer"> + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:24 2009 + </td> + <td align="right" class="footer"> + <a target="mainFrame" href="http://epydoc.sourceforge.net" + >http://epydoc.sourceforge.net</a> + </td> + </tr> +</table> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/netaddr.strategy-module.html b/docs/api/netaddr.strategy-module.html index 9761e86..fcdc382 100755 --- a/docs/api/netaddr.strategy-module.html +++ b/docs/api/netaddr.strategy-module.html @@ -59,8 +59,8 @@ </table> <!-- ==================== MODULE DESCRIPTION ==================== --> <h1 class="epydoc">Module strategy</h1><p class="nomargin-top"><span class="codelink"><a href="netaddr.strategy-pysrc.html">source code</a></span></p> -<p>network address type logic, constants used to identify them and shared - strategy objects.</p> +<p>network address conversion logic, constants and shared strategy + objects.</p> <!-- ==================== CLASSES ==================== --> <a name="section-Classes"></a> @@ -75,8 +75,7 @@ <span class="summary-type"> </span> </td><td class="summary"> <a href="netaddr.strategy.AddrStrategy-class.html" class="summary-name">AddrStrategy</a><br /> - Very basic support for all common operations performed on each - network type. + Basic support for common operations performed on each address type </td> </tr> <tr> @@ -112,7 +111,7 @@ </td><td class="summary"> <a href="netaddr.strategy.EUI48Strategy-class.html" class="summary-name">EUI48Strategy</a><br /> Implements the operations that can be performed on an IEEE 48-bit - EUI (Extended Unique Identifer). + EUI (Extended Unique Identifer) a.k.a. </td> </tr> </table> @@ -129,14 +128,14 @@ <span class="summary-type"> </span> </td><td class="summary"> <a name="USE_IPV4_OPT"></a><span class="summary-name">USE_IPV4_OPT</span> = <code title="True">True</code><br /> - Use IPv4 optimised strategy class? Default: True + Use optimised IPv4 strategy? Default: True </td> </tr> <tr> <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.strategy-module.html#ST_IPV4" class="summary-name">ST_IPV4</a> = <code title="netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False)">netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False<code class="variable-ellipsis">...</code></code><br /> + <a href="netaddr.strategy-module.html#ST_IPV4" class="summary-name">ST_IPV4</a> = <code title="netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False)">netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, F<code class="variable-ellipsis">...</code></code><br /> A shared strategy object supporting all operations on IPv4 addresses. </td> </tr> @@ -144,7 +143,7 @@ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.strategy-module.html#ST_IPV6" class="summary-name">ST_IPV6</a> = <code title="netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False)">netaddr.address.IPv6Strategy(128, 16, ':', 6, True, <code class="variable-ellipsis">...</code></code><br /> + <a href="netaddr.strategy-module.html#ST_IPV6" class="summary-name">ST_IPV6</a> = <code title="netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False)">netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, Fa<code class="variable-ellipsis">...</code></code><br /> A shared strategy object supporting all operations on IPv6 addresses. </td> </tr> @@ -152,7 +151,7 @@ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.strategy-module.html#ST_EUI48" class="summary-name">ST_EUI48</a> = <code title="netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True)">netaddr.address.EUI48Strategy(48, 8, '-', 48, True,<code class="variable-ellipsis">...</code></code><br /> + <a href="netaddr.strategy-module.html#ST_EUI48" class="summary-name">ST_EUI48</a> = <code title="netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True)">netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, T<code class="variable-ellipsis">...</code></code><br /> A shared strategy object supporting all operations on EUI-48/MAC addresses. </td> @@ -161,7 +160,7 @@ <td width="15%" align="right" valign="top" class="summary"> <span class="summary-type"> </span> </td><td class="summary"> - <a href="netaddr.strategy-module.html#ST_EUI64" class="summary-name">ST_EUI64</a> = <code title="netaddr.address.AddrStrategy(64, 8, '-', 64, True, True)">netaddr.address.AddrStrategy(64, 8, '-', 64, True, <code class="variable-ellipsis">...</code></code><br /> + <a name="ST_EUI64"></a><span class="summary-name">ST_EUI64</span> = <code title="netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)">netaddr.address.AddrStrategy(64, 8, '-', 64, 16, True)</code><br /> A shared strategy object supporting all operations on EUI-64 addresses. </td> @@ -189,7 +188,7 @@ <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False) +netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, 10, False) </pre></td></tr></table> </dd> </dl> @@ -208,7 +207,7 @@ netaddr.address.IPv4StrategyOpt(32, 8, '.', 4, False, False) <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False) +netaddr.address.IPv6Strategy(128, 16, ':', 6, 16, False) </pre></td></tr></table> </dd> </dl> @@ -227,26 +226,7 @@ netaddr.address.IPv6Strategy(128, 16, ':', 6, True, False) <dl class="fields"> <dt>Value:</dt> <dd><table><tr><td><pre class="variable"> -netaddr.address.EUI48Strategy(48, 8, '-', 48, True, True) -</pre></td></tr></table> -</dd> - </dl> -</td></tr></table> -</div> -<a name="ST_EUI64"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <h3 class="epydoc">ST_EUI64</h3> - <p>A shared strategy object supporting all operations on EUI-64 - addresses.</p> - <dl class="fields"> - </dl> - <dl class="fields"> - <dt>Value:</dt> - <dd><table><tr><td><pre class="variable"> -netaddr.address.AddrStrategy(64, 8, '-', 64, True, True) +netaddr.address.EUI48Strategy(48, 8, '-', 48, 16, True) </pre></td></tr></table> </dd> </dl> @@ -284,7 +264,7 @@ netaddr.address.AddrStrategy(64, 8, '-', 64, True, True) <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:23 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.strategy-pysrc.html b/docs/api/netaddr.strategy-pysrc.html index 4d4bacc..dad1df6 100755 --- a/docs/api/netaddr.strategy-pysrc.html +++ b/docs/api/netaddr.strategy-pysrc.html @@ -66,1065 +66,1191 @@ <a name="L5"></a><tt class="py-lineno"> 5</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Released under the BSD license. See the LICENSE file for details.</tt> </tt> <a name="L6"></a><tt class="py-lineno"> 6</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> <a name="L7"></a><tt class="py-lineno"> 7</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-docstring">"""</tt> </tt> -<a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">network address type logic, constants used to identify them and shared</tt> </tt> -<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">strategy objects.</tt> </tt> -<a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> -<a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">socket</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_socket</tt> </tt> -<a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">struct</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_struct</tt> </tt> +<a name="L8"></a><tt class="py-lineno"> 8</tt> <tt class="py-line"><tt class="py-docstring">network address conversion logic, constants and shared strategy objects.</tt> </tt> +<a name="L9"></a><tt class="py-lineno"> 9</tt> <tt class="py-line"><tt class="py-docstring">"""</tt> </tt> +<a name="L10"></a><tt class="py-lineno"> 10</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">socket</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_socket</tt> </tt> +<a name="L11"></a><tt class="py-lineno"> 11</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">struct</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_struct</tt> </tt> +<a name="L12"></a><tt class="py-lineno"> 12</tt> <tt class="py-line"><tt class="py-keyword">import</tt> <tt class="py-name">re</tt> <tt class="py-keyword">as</tt> <tt class="py-name">_re</tt> </tt> <a name="L13"></a><tt class="py-lineno"> 13</tt> <tt class="py-line"> </tt> -<a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt id="link-0" class="py-name" targets="Variable netaddr.strategy.USE_IPV4_OPT=netaddr.strategy-module.html#USE_IPV4_OPT"><a title="netaddr.strategy.USE_IPV4_OPT" class="py-name" href="#" onclick="return doclink('link-0', 'USE_IPV4_OPT', 'link-0');">USE_IPV4_OPT</a></tt><tt class="py-op">=</tt><tt class="py-name">True</tt> <tt class="py-comment">#: Use IPv4 optimised strategy class? Default: True</tt> </tt> +<a name="L14"></a><tt class="py-lineno"> 14</tt> <tt class="py-line"><tt id="link-0" class="py-name" targets="Variable netaddr.strategy.USE_IPV4_OPT=netaddr.strategy-module.html#USE_IPV4_OPT"><a title="netaddr.strategy.USE_IPV4_OPT" class="py-name" href="#" onclick="return doclink('link-0', 'USE_IPV4_OPT', 'link-0');">USE_IPV4_OPT</a></tt><tt class="py-op">=</tt><tt class="py-name">True</tt> <tt class="py-comment">#: Use optimised IPv4 strategy? Default: True</tt> </tt> <a name="L15"></a><tt class="py-lineno"> 15</tt> <tt class="py-line"> </tt> <a name="L16"></a><tt class="py-lineno"> 16</tt> <tt class="py-line"><tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"> <tt class="py-comment"># The following call erroneous raises errors on various Python</tt> </tt> -<a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># implementations.</tt> </tt> -<a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">inet_aton</tt><tt class="py-op">(</tt><tt class="py-string">'255.255.255.255'</tt><tt class="py-op">)</tt> </tt> -<a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"><tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> -<a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"> <tt id="link-1" class="py-name"><a title="netaddr.strategy.USE_IPV4_OPT" class="py-name" href="#" onclick="return doclink('link-1', 'USE_IPV4_OPT', 'link-0');">USE_IPV4_OPT</a></tt><tt class="py-op">=</tt><tt class="py-name">False</tt> </tt> -<a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"> </tt> -<a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-2" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-2', 'netaddr', 'link-2');">netaddr</a></tt> <tt class="py-keyword">import</tt> <tt id="link-3" class="py-name" targets="Variable netaddr.BIG_ENDIAN_PLATFORM=netaddr-module.html#BIG_ENDIAN_PLATFORM"><a title="netaddr.BIG_ENDIAN_PLATFORM" class="py-name" href="#" onclick="return doclink('link-3', 'BIG_ENDIAN_PLATFORM', 'link-3');">BIG_ENDIAN_PLATFORM</a></tt><tt class="py-op">,</tt> <tt id="link-4" class="py-name" targets="Variable netaddr.AT_UNSPEC=netaddr-module.html#AT_UNSPEC"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-4', 'AT_UNSPEC', 'link-4');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-5" class="py-name" targets="Variable netaddr.AT_INET=netaddr-module.html#AT_INET"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-5', 'AT_INET', 'link-5');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-6" class="py-name" targets="Variable netaddr.AT_INET6=netaddr-module.html#AT_INET6"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-6', 'AT_INET6', 'link-6');">AT_INET6</a></tt><tt class="py-op">,</tt> \ </tt> -<a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"> <tt id="link-7" class="py-name" targets="Variable netaddr.AT_LINK=netaddr-module.html#AT_LINK"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-7', 'AT_LINK', 'link-7');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-8" class="py-name" targets="Variable netaddr.AT_EUI64=netaddr-module.html#AT_EUI64"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-8', 'AT_EUI64', 'link-8');">AT_EUI64</a></tt><tt class="py-op">,</tt> <tt id="link-9" class="py-name" targets="Variable netaddr.AT_NAMES=netaddr-module.html#AT_NAMES"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-9', 'AT_NAMES', 'link-9');">AT_NAMES</a></tt> </tt> -<a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"> </tt> -<a name="L26"></a><tt class="py-lineno"> 26</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="_BYTES_TO_BITS"></a><div id="_BYTES_TO_BITS-def"><a name="L27"></a><tt class="py-lineno"> 27</tt> <a class="py-toggle" href="#" id="_BYTES_TO_BITS-toggle" onclick="return toggle('_BYTES_TO_BITS');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy-module.html#_BYTES_TO_BITS">_BYTES_TO_BITS</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="_BYTES_TO_BITS-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="_BYTES_TO_BITS-expanded"><a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-docstring"> Generates a 256 element list of 8-bit binary digit strings. List index is</tt> </tt> -<a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"><tt class="py-docstring"> equivalent to the bit string value.</tt> </tt> -<a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"> <tt class="py-name">lookup</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"> <tt class="py-name">bits_per_byte</tt> <tt class="py-op">=</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">7</tt><tt class="py-op">,</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">num</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">256</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"> <tt id="link-10" class="py-name" targets="Method netaddr.address.Addr.bits()=netaddr.address.Addr-class.html#bits"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-10', 'bits', 'link-10');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-number">8</tt><tt class="py-op">*</tt><tt class="py-op">[</tt><tt class="py-name">None</tt><tt class="py-op">]</tt> </tt> -<a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">bits_per_byte</tt><tt class="py-op">:</tt> </tt> -<a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"> <tt id="link-11" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-11', 'bits', 'link-10');">bits</a></tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'01'</tt><tt class="py-op">[</tt><tt class="py-name">num</tt><tt class="py-op">&</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> -<a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"> <tt class="py-name">num</tt> <tt class="py-op">>>=</tt> <tt class="py-number">1</tt> </tt> -<a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"> <tt class="py-name">lookup</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt id="link-12" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-12', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">lookup</tt> </tt> -</div><a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"> </tt> -<a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"><tt id="link-13" class="py-name" targets="Variable netaddr.strategy._BYTES_TO_BITS=netaddr.strategy-module.html#_BYTES_TO_BITS"><a title="netaddr.strategy._BYTES_TO_BITS" class="py-name" href="#" onclick="return doclink('link-13', '_BYTES_TO_BITS', 'link-13');">_BYTES_TO_BITS</a></tt> <tt class="py-op">=</tt> <tt id="link-14" class="py-name"><a title="netaddr.strategy._BYTES_TO_BITS" class="py-name" href="#" onclick="return doclink('link-14', '_BYTES_TO_BITS', 'link-13');">_BYTES_TO_BITS</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"> </tt> -<a name="L44"></a><tt class="py-lineno"> 44</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="AddrStrategy"></a><div id="AddrStrategy-def"><a name="L45"></a><tt class="py-lineno"> 45</tt> <a class="py-toggle" href="#" id="AddrStrategy-toggle" onclick="return toggle('AddrStrategy');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="AddrStrategy-expanded"><a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"><tt class="py-docstring"> Very basic support for all common operations performed on each network</tt> </tt> -<a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line"><tt class="py-docstring"> type.</tt> </tt> -<a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"><tt class="py-docstring"> There are usually subclasses for each address type that over-ride methods</tt> </tt> -<a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"><tt class="py-docstring"> implemented here to optimise their performance and add additional</tt> </tt> -<a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"><tt class="py-docstring"> features.</tt> </tt> -<a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="AddrStrategy.__init__"></a><div id="AddrStrategy.__init__-def"><a name="L54"></a><tt class="py-lineno"> 54</tt> <a class="py-toggle" href="#" id="AddrStrategy.__init__-toggle" onclick="return toggle('AddrStrategy.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">width</tt><tt class="py-op">,</tt> <tt class="py-param">word_size</tt><tt class="py-op">,</tt> <tt class="py-param">delimiter</tt><tt class="py-op">,</tt> <tt class="py-param">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%x'</tt><tt class="py-op">,</tt> </tt> -<a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-15" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-15', 'AT_UNSPEC', 'link-4');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt class="py-param">hex_words</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-param">to_upper</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.__init__-expanded"><a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"> </tt> -<a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">=</tt> <tt class="py-name">width</tt> </tt> -<a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_int</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> -<a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> -<a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">=</tt> <tt class="py-name">word_size</tt> </tt> -<a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt> <tt class="py-op">=</tt> <tt class="py-name">width</tt> <tt class="py-op">/</tt> <tt class="py-name">word_size</tt> </tt> -<a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_word</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> -<a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">word_size</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> -<a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt> <tt class="py-op">=</tt> <tt class="py-name">delimiter</tt> </tt> -<a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">word_fmt</tt> </tt> -<a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">hex_words</tt> <tt class="py-op">=</tt> <tt class="py-name">hex_words</tt> </tt> -<a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt> <tt class="py-op">=</tt> <tt class="py-number">16</tt> </tt> -<a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-16" class="py-name" targets="Variable netaddr.address.Addr.addr_type=netaddr.address.Addr-class.html#addr_type,Variable netaddr.address.AddrRange.addr_type=netaddr.address.AddrRange-class.html#addr_type,Variable netaddr.address.CIDR.addr_type=netaddr.address.CIDR-class.html#addr_type,Variable netaddr.address.EUI.addr_type=netaddr.address.EUI-class.html#addr_type,Variable netaddr.address.IP.addr_type=netaddr.address.IP-class.html#addr_type,Variable netaddr.address.Wildcard.addr_type=netaddr.address.Wildcard-class.html#addr_type"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +<a name="L17"></a><tt class="py-lineno"> 17</tt> <tt class="py-line"> <tt class="py-comment"># Detects a common bug in various Python implementations.</tt> </tt> +<a name="L18"></a><tt class="py-lineno"> 18</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">inet_aton</tt><tt class="py-op">(</tt><tt class="py-string">'255.255.255.255'</tt><tt class="py-op">)</tt> </tt> +<a name="L19"></a><tt class="py-lineno"> 19</tt> <tt class="py-line"><tt class="py-keyword">except</tt><tt class="py-op">:</tt> </tt> +<a name="L20"></a><tt class="py-lineno"> 20</tt> <tt class="py-line"> <tt id="link-1" class="py-name"><a title="netaddr.strategy.USE_IPV4_OPT" class="py-name" href="#" onclick="return doclink('link-1', 'USE_IPV4_OPT', 'link-0');">USE_IPV4_OPT</a></tt><tt class="py-op">=</tt><tt class="py-name">False</tt> </tt> +<a name="L21"></a><tt class="py-lineno"> 21</tt> <tt class="py-line"> </tt> +<a name="L22"></a><tt class="py-lineno"> 22</tt> <tt class="py-line"><tt class="py-keyword">from</tt> <tt id="link-2" class="py-name" targets="Package netaddr=netaddr-module.html"><a title="netaddr" class="py-name" href="#" onclick="return doclink('link-2', 'netaddr', 'link-2');">netaddr</a></tt> <tt class="py-keyword">import</tt> <tt id="link-3" class="py-name" targets="Variable netaddr.BIG_ENDIAN_PLATFORM=netaddr-module.html#BIG_ENDIAN_PLATFORM"><a title="netaddr.BIG_ENDIAN_PLATFORM" class="py-name" href="#" onclick="return doclink('link-3', 'BIG_ENDIAN_PLATFORM', 'link-3');">BIG_ENDIAN_PLATFORM</a></tt><tt class="py-op">,</tt> <tt id="link-4" class="py-name" targets="Variable netaddr.AT_UNSPEC=netaddr-module.html#AT_UNSPEC"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-4', 'AT_UNSPEC', 'link-4');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt id="link-5" class="py-name" targets="Variable netaddr.AT_INET=netaddr-module.html#AT_INET"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-5', 'AT_INET', 'link-5');">AT_INET</a></tt><tt class="py-op">,</tt> <tt id="link-6" class="py-name" targets="Variable netaddr.AT_INET6=netaddr-module.html#AT_INET6"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-6', 'AT_INET6', 'link-6');">AT_INET6</a></tt><tt class="py-op">,</tt> \ </tt> +<a name="L23"></a><tt class="py-lineno"> 23</tt> <tt class="py-line"> <tt id="link-7" class="py-name" targets="Variable netaddr.AT_LINK=netaddr-module.html#AT_LINK"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-7', 'AT_LINK', 'link-7');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt id="link-8" class="py-name" targets="Variable netaddr.AT_EUI64=netaddr-module.html#AT_EUI64"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-8', 'AT_EUI64', 'link-8');">AT_EUI64</a></tt><tt class="py-op">,</tt> <tt id="link-9" class="py-name" targets="Variable netaddr.AT_NAMES=netaddr-module.html#AT_NAMES"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-9', 'AT_NAMES', 'link-9');">AT_NAMES</a></tt><tt class="py-op">,</tt> <tt id="link-10" class="py-name" targets="Class netaddr.AddrFormatError=netaddr.AddrFormatError-class.html"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-10', 'AddrFormatError', 'link-10');">AddrFormatError</a></tt> </tt> +<a name="L24"></a><tt class="py-lineno"> 24</tt> <tt class="py-line"> </tt> +<a name="L25"></a><tt class="py-lineno"> 25</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="_BYTES_TO_BITS"></a><div id="_BYTES_TO_BITS-def"><a name="L26"></a><tt class="py-lineno"> 26</tt> <a class="py-toggle" href="#" id="_BYTES_TO_BITS-toggle" onclick="return toggle('_BYTES_TO_BITS');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy-module.html#_BYTES_TO_BITS">_BYTES_TO_BITS</a><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="_BYTES_TO_BITS-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="_BYTES_TO_BITS-expanded"><a name="L27"></a><tt class="py-lineno"> 27</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L28"></a><tt class="py-lineno"> 28</tt> <tt class="py-line"><tt class="py-docstring"> Generates a 256 element list of 8-bit binary digit strings. List index is</tt> </tt> +<a name="L29"></a><tt class="py-lineno"> 29</tt> <tt class="py-line"><tt class="py-docstring"> equivalent to the bit string value.</tt> </tt> +<a name="L30"></a><tt class="py-lineno"> 30</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L31"></a><tt class="py-lineno"> 31</tt> <tt class="py-line"> <tt class="py-name">lookup</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L32"></a><tt class="py-lineno"> 32</tt> <tt class="py-line"> <tt class="py-name">bits_per_byte</tt> <tt class="py-op">=</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">7</tt><tt class="py-op">,</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">,</tt> <tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L33"></a><tt class="py-lineno"> 33</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">num</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">256</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L34"></a><tt class="py-lineno"> 34</tt> <tt class="py-line"> <tt id="link-11" class="py-name" targets="Method netaddr.address.Addr.bits()=netaddr.address.Addr-class.html#bits"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-11', 'bits', 'link-11');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-number">8</tt><tt class="py-op">*</tt><tt class="py-op">[</tt><tt class="py-name">None</tt><tt class="py-op">]</tt> </tt> +<a name="L35"></a><tt class="py-lineno"> 35</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">bits_per_byte</tt><tt class="py-op">:</tt> </tt> +<a name="L36"></a><tt class="py-lineno"> 36</tt> <tt class="py-line"> <tt id="link-12" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-12', 'bits', 'link-11');">bits</a></tt><tt class="py-op">[</tt><tt class="py-name">i</tt><tt class="py-op">]</tt> <tt class="py-op">=</tt> <tt class="py-string">'01'</tt><tt class="py-op">[</tt><tt class="py-name">num</tt><tt class="py-op">&</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +<a name="L37"></a><tt class="py-lineno"> 37</tt> <tt class="py-line"> <tt class="py-name">num</tt> <tt class="py-op">>>=</tt> <tt class="py-number">1</tt> </tt> +<a name="L38"></a><tt class="py-lineno"> 38</tt> <tt class="py-line"> <tt class="py-name">lookup</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt id="link-13" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-13', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L39"></a><tt class="py-lineno"> 39</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">lookup</tt> </tt> +</div><a name="L40"></a><tt class="py-lineno"> 40</tt> <tt class="py-line"> </tt> +<a name="L41"></a><tt class="py-lineno"> 41</tt> <tt class="py-line"><tt id="link-14" class="py-name" targets="Variable netaddr.strategy._BYTES_TO_BITS=netaddr.strategy-module.html#_BYTES_TO_BITS"><a title="netaddr.strategy._BYTES_TO_BITS" class="py-name" href="#" onclick="return doclink('link-14', '_BYTES_TO_BITS', 'link-14');">_BYTES_TO_BITS</a></tt> <tt class="py-op">=</tt> <tt id="link-15" class="py-name"><a title="netaddr.strategy._BYTES_TO_BITS" class="py-name" href="#" onclick="return doclink('link-15', '_BYTES_TO_BITS', 'link-14');">_BYTES_TO_BITS</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L42"></a><tt class="py-lineno"> 42</tt> <tt class="py-line"> </tt> +<a name="L43"></a><tt class="py-lineno"> 43</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="AddrStrategy"></a><div id="AddrStrategy-def"><a name="L44"></a><tt class="py-lineno"> 44</tt> <a class="py-toggle" href="#" id="AddrStrategy-toggle" onclick="return toggle('AddrStrategy');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a><tt class="py-op">(</tt><tt class="py-base-class">object</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="AddrStrategy-expanded"><a name="L45"></a><tt class="py-lineno"> 45</tt> <tt class="py-line"> <tt class="py-docstring">"""Basic support for common operations performed on each address type"""</tt> </tt> +<a name="L46"></a><tt class="py-lineno"> 46</tt> <tt class="py-line"> </tt> +<a name="L47"></a><tt class="py-lineno"> 47</tt> <tt class="py-line"> <tt class="py-comment">#: Lookup table for struct module format strings.</tt> </tt> +<a name="L48"></a><tt class="py-lineno"> 48</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-16" class="py-name" targets="Variable netaddr.strategy.AddrStrategy.STRUCT_FORMATS=netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS"><a title="netaddr.strategy.AddrStrategy.STRUCT_FORMATS" class="py-name" href="#" onclick="return doclink('link-16', 'STRUCT_FORMATS', 'link-16');">STRUCT_FORMATS</a></tt> <tt class="py-op">=</tt> <tt class="py-op">{</tt> </tt> +<a name="L49"></a><tt class="py-lineno"> 49</tt> <tt class="py-line"> <tt class="py-number">8</tt> <tt class="py-op">:</tt> <tt class="py-string">'B'</tt><tt class="py-op">,</tt> <tt class="py-comment"># unsigned char</tt> </tt> +<a name="L50"></a><tt class="py-lineno"> 50</tt> <tt class="py-line"> <tt class="py-number">16</tt> <tt class="py-op">:</tt> <tt class="py-string">'H'</tt><tt class="py-op">,</tt> <tt class="py-comment"># unsigned short</tt> </tt> +<a name="L51"></a><tt class="py-lineno"> 51</tt> <tt class="py-line"> <tt class="py-number">32</tt> <tt class="py-op">:</tt> <tt class="py-string">'I'</tt><tt class="py-op">,</tt> <tt class="py-comment"># unsigned int</tt> </tt> +<a name="L52"></a><tt class="py-lineno"> 52</tt> <tt class="py-line"> <tt class="py-op">}</tt> </tt> +<a name="L53"></a><tt class="py-lineno"> 53</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.__init__"></a><div id="AddrStrategy.__init__-def"><a name="L54"></a><tt class="py-lineno"> 54</tt> <a class="py-toggle" href="#" id="AddrStrategy.__init__-toggle" onclick="return toggle('AddrStrategy.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">width</tt><tt class="py-op">,</tt> <tt class="py-param">word_size</tt><tt class="py-op">,</tt> <tt class="py-param">word_sep</tt><tt class="py-op">,</tt> <tt class="py-param">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%x'</tt><tt class="py-op">,</tt> </tt> +<a name="L55"></a><tt class="py-lineno"> 55</tt> <tt class="py-line"> <tt class="py-param">addr_type</tt><tt class="py-op">=</tt><tt id="link-17" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-17', 'AT_UNSPEC', 'link-4');">AT_UNSPEC</a></tt><tt class="py-op">,</tt> <tt class="py-param">word_base</tt><tt class="py-op">=</tt><tt class="py-number">16</tt><tt class="py-op">,</tt> <tt class="py-param">uppercase</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.__init__-expanded"><a name="L56"></a><tt class="py-lineno"> 56</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L57"></a><tt class="py-lineno"> 57</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L58"></a><tt class="py-lineno"> 58</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L59"></a><tt class="py-lineno"> 59</tt> <tt class="py-line"><tt class="py-docstring"> @param width: size of address in bits.</tt> </tt> +<a name="L60"></a><tt class="py-lineno"> 60</tt> <tt class="py-line"><tt class="py-docstring"> (e.g. 32 - IPv4, 48 - MAC, 128 - IPv6)</tt> </tt> +<a name="L61"></a><tt class="py-lineno"> 61</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L62"></a><tt class="py-lineno"> 62</tt> <tt class="py-line"><tt class="py-docstring"> @param word_size: size of each word.</tt> </tt> +<a name="L63"></a><tt class="py-lineno"> 63</tt> <tt class="py-line"><tt class="py-docstring"> (e.g. 8 - octets, 16 - hextets)</tt> </tt> +<a name="L64"></a><tt class="py-lineno"> 64</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L65"></a><tt class="py-lineno"> 65</tt> <tt class="py-line"><tt class="py-docstring"> @param word_sep: separator between each word.</tt> </tt> +<a name="L66"></a><tt class="py-lineno"> 66</tt> <tt class="py-line"><tt class="py-docstring"> (e.g. '.' - IPv4, ':' - IPv6, '-' - EUI-48)</tt> </tt> +<a name="L67"></a><tt class="py-lineno"> 67</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L68"></a><tt class="py-lineno"> 68</tt> <tt class="py-line"><tt class="py-docstring"> @param word_fmt: format string for each word.</tt> </tt> +<a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"><tt class="py-docstring"> (Default: '%x')</tt> </tt> +<a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"><tt class="py-docstring"> @param addr_type: address type.</tt> </tt> +<a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"><tt class="py-docstring"> (Default: AT_UNSPEC)</tt> </tt> +<a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"><tt class="py-docstring"> @param word_base: number base used to convert each word using int().</tt> </tt> +<a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"><tt class="py-docstring"> (Default: 16)</tt> </tt> +<a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"><tt class="py-docstring"> @param uppercase: uppercase address.</tt> </tt> +<a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"><tt class="py-docstring"> (Default: False)</tt> </tt> +<a name="L79"></a><tt class="py-lineno"> 79</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"> </tt> +<a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">width</tt> <tt class="py-op">=</tt> <tt class="py-name">width</tt> </tt> +<a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">width</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">=</tt> <tt class="py-name">word_size</tt> </tt> +<a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt> <tt class="py-op">=</tt> <tt class="py-name">width</tt> <tt class="py-op">/</tt> <tt class="py-name">word_size</tt> </tt> +<a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">word_size</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt> <tt class="py-op">=</tt> <tt class="py-name">word_sep</tt> </tt> +<a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">word_fmt</tt> </tt> +<a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt> <tt class="py-op">=</tt> <tt class="py-name">word_base</tt> </tt> +<a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-18" class="py-name" targets="Variable netaddr.address.Addr.addr_type=netaddr.address.Addr-class.html#addr_type,Variable netaddr.address.CIDR.addr_type=netaddr.address.CIDR-class.html#addr_type,Variable netaddr.address.EUI.addr_type=netaddr.address.EUI-class.html#addr_type,Variable netaddr.address.IP.addr_type=netaddr.address.IP-class.html#addr_type,Variable netaddr.address.IPRange.addr_type=netaddr.address.IPRange-class.html#addr_type,Variable netaddr.address.Wildcard.addr_type=netaddr.address.Wildcard-class.html#addr_type"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-16', 'addr_type', 'link-16');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-17" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-18', 'addr_type', 'link-18');">addr_type</a></tt> <tt class="py-op">=</tt> <tt id="link-19" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-17', 'addr_type', 'link-16');">addr_type</a></tt> </tt> -<a name="L69"></a><tt class="py-lineno"> 69</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">to_upper</tt> <tt class="py-op">=</tt> <tt class="py-name">to_upper</tt> </tt> -<a name="L70"></a><tt class="py-lineno"> 70</tt> <tt class="py-line"> </tt> -<a name="L71"></a><tt class="py-lineno"> 71</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">hex_words</tt> <tt class="py-keyword">is</tt> <tt class="py-name">False</tt><tt class="py-op">:</tt> </tt> -<a name="L72"></a><tt class="py-lineno"> 72</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt> <tt class="py-op">=</tt> <tt class="py-number">10</tt> </tt> -<a name="L73"></a><tt class="py-lineno"> 73</tt> <tt class="py-line"> </tt> -<a name="L74"></a><tt class="py-lineno"> 74</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L75"></a><tt class="py-lineno"> 75</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt id="link-18" class="py-name"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-18', 'AT_NAMES', 'link-9');">AT_NAMES</a></tt><tt class="py-op">[</tt><tt id="link-19" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-19', 'addr_type', 'link-18');">addr_type</a></tt> </tt> +<a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uppercase</tt> <tt class="py-op">=</tt> <tt class="py-name">uppercase</tt> </tt> +<a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"> </tt> +<a name="L92"></a><tt class="py-lineno"> 92</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt id="link-20" class="py-name"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-20', 'AT_NAMES', 'link-9');">AT_NAMES</a></tt><tt class="py-op">[</tt><tt id="link-21" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-19', 'addr_type', 'link-16');">addr_type</a></tt><tt class="py-op">]</tt> </tt> -<a name="L76"></a><tt class="py-lineno"> 76</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt> -<a name="L77"></a><tt class="py-lineno"> 77</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt id="link-20" class="py-name"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-20', 'AT_NAMES', 'link-9');">AT_NAMES</a></tt><tt class="py-op">[</tt><tt id="link-21" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-21', 'AT_UNSPEC', 'link-4');">AT_UNSPEC</a></tt><tt class="py-op">]</tt> </tt> -</div><a name="L78"></a><tt class="py-lineno"> 78</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.__repr__"></a><div id="AddrStrategy.__repr__-def"><a name="L79"></a><tt class="py-lineno"> 79</tt> <a class="py-toggle" href="#" id="AddrStrategy.__repr__-toggle" onclick="return toggle('AddrStrategy.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.__repr__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.__repr__-expanded"><a name="L80"></a><tt class="py-lineno"> 80</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L81"></a><tt class="py-lineno"> 81</tt> <tt class="py-line"><tt class="py-docstring"> @return: An executable Python statement that can recreate an object</tt> </tt> -<a name="L82"></a><tt class="py-lineno"> 82</tt> <tt class="py-line"><tt class="py-docstring"> with an equivalent state.</tt> </tt> -<a name="L83"></a><tt class="py-lineno"> 83</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L84"></a><tt class="py-lineno"> 84</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s(%r, %r, %r, %r, %r, %r)"</tt> <tt class="py-op">%</tt> \ </tt> -<a name="L85"></a><tt class="py-lineno"> 85</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">,</tt> </tt> -<a name="L86"></a><tt class="py-lineno"> 86</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-22" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-21', 'addr_type', 'link-18');">addr_type</a></tt><tt class="py-op">]</tt> </tt> +<a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt> +<a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">name</tt> <tt class="py-op">=</tt> <tt id="link-22" class="py-name"><a title="netaddr.AT_NAMES" class="py-name" href="#" onclick="return doclink('link-22', 'AT_NAMES', 'link-9');">AT_NAMES</a></tt><tt class="py-op">[</tt><tt id="link-23" class="py-name"><a title="netaddr.AT_UNSPEC" class="py-name" href="#" onclick="return doclink('link-23', 'AT_UNSPEC', 'link-4');">AT_UNSPEC</a></tt><tt class="py-op">]</tt> </tt> +</div><a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.__repr__"></a><div id="AddrStrategy.__repr__-def"><a name="L97"></a><tt class="py-lineno"> 97</tt> <a class="py-toggle" href="#" id="AddrStrategy.__repr__-toggle" onclick="return toggle('AddrStrategy.__repr__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#__repr__">__repr__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.__repr__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.__repr__-expanded"><a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"> <tt class="py-docstring">"""@return: executable Python string to recreate equivalent object"""</tt> </tt> +<a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"netaddr.address.%s(%r, %r, %r, %r, %r, %r)"</tt> <tt class="py-op">%</tt> \ </tt> +<a name="L100"></a><tt class="py-lineno">100</tt> <tt class="py-line"> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">.</tt><tt class="py-name">__name__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">,</tt> </tt> +<a name="L101"></a><tt class="py-lineno">101</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-24" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-22', 'addr_type', 'link-16');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">hex_words</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">to_upper</tt><tt class="py-op">)</tt> </tt> -</div><a name="L87"></a><tt class="py-lineno"> 87</tt> <tt class="py-line"> </tt> -<a name="L88"></a><tt class="py-lineno"> 88</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L89"></a><tt class="py-lineno"> 89</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Binary methods.</tt> </tt> -<a name="L90"></a><tt class="py-lineno"> 90</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L91"></a><tt class="py-lineno"> 91</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="AddrStrategy.valid_bits"></a><div id="AddrStrategy.valid_bits-def"><a name="L92"></a><tt class="py-lineno"> 92</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_bits-toggle" onclick="return toggle('AddrStrategy.valid_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_bits">valid_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">bits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.valid_bits-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_bits-expanded"><a name="L93"></a><tt class="py-lineno"> 93</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L94"></a><tt class="py-lineno"> 94</tt> <tt class="py-line"><tt class="py-docstring"> @param bits: A network address in readable binary form.</tt> </tt> -<a name="L95"></a><tt class="py-lineno"> 95</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L96"></a><tt class="py-lineno"> 96</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if network address is valid for this address type,</tt> </tt> -<a name="L97"></a><tt class="py-lineno"> 97</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> -<a name="L98"></a><tt class="py-lineno"> 98</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L99"></a><tt class="py-lineno"> 99</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-23" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-23', 'bits', 'link-10');">bits</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L100"></a><tt class="py-lineno">100</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L101"></a><tt class="py-lineno">101</tt> <tt class="py-line"> </tt> -<a name="L102"></a><tt class="py-lineno">102</tt> <tt class="py-line"> <tt id="link-24" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-24', 'bits', 'link-10');">bits</a></tt> <tt class="py-op">=</tt> <tt id="link-25" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-25', 'bits', 'link-10');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> -<a name="L103"></a><tt class="py-lineno">103</tt> <tt class="py-line"> </tt> -<a name="L104"></a><tt class="py-lineno">104</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt id="link-26" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-26', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> -<a name="L105"></a><tt class="py-lineno">105</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L106"></a><tt class="py-lineno">106</tt> <tt class="py-line"> </tt> -<a name="L107"></a><tt class="py-lineno">107</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L108"></a><tt class="py-lineno">108</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_int</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-27" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-27', 'bits', 'link-10');">bits</a></tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">:</tt> </tt> -<a name="L109"></a><tt class="py-lineno">109</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L110"></a><tt class="py-lineno">110</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L111"></a><tt class="py-lineno">111</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L112"></a><tt class="py-lineno">112</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L113"></a><tt class="py-lineno">113</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.bits_to_int"></a><div id="AddrStrategy.bits_to_int-def"><a name="L114"></a><tt class="py-lineno">114</tt> <a class="py-toggle" href="#" id="AddrStrategy.bits_to_int-toggle" onclick="return toggle('AddrStrategy.bits_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">bits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.bits_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.bits_to_int-expanded"><a name="L115"></a><tt class="py-lineno">115</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L116"></a><tt class="py-lineno">116</tt> <tt class="py-line"><tt class="py-docstring"> @param bits: A network address in readable binary form.</tt> </tt> -<a name="L117"></a><tt class="py-lineno">117</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L118"></a><tt class="py-lineno">118</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> -<a name="L119"></a><tt class="py-lineno">119</tt> <tt class="py-line"><tt class="py-docstring"> represented by network address in readable binary form.</tt> </tt> -<a name="L120"></a><tt class="py-lineno">120</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L121"></a><tt class="py-lineno">121</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-28" class="py-name" targets="Method netaddr.strategy.AddrStrategy.bits_to_words()=netaddr.strategy.AddrStrategy-class.html#bits_to_words"><a title="netaddr.strategy.AddrStrategy.bits_to_words" class="py-name" href="#" onclick="return doclink('link-28', 'bits_to_words', 'link-28');">bits_to_words</a></tt><tt class="py-op">(</tt><tt id="link-29" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-29', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> </tt> -<a name="L122"></a><tt class="py-lineno">122</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-30" class="py-name" targets="Method netaddr.strategy.AddrStrategy.words_to_int()=netaddr.strategy.AddrStrategy-class.html#words_to_int,Method netaddr.strategy.IPv4StrategyOpt.words_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int"><a title="netaddr.strategy.AddrStrategy.words_to_int -netaddr.strategy.IPv4StrategyOpt.words_to_int" class="py-name" href="#" onclick="return doclink('link-30', 'words_to_int', 'link-30');">words_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L123"></a><tt class="py-lineno">123</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.bits_to_str"></a><div id="AddrStrategy.bits_to_str-def"><a name="L124"></a><tt class="py-lineno">124</tt> <a class="py-toggle" href="#" id="AddrStrategy.bits_to_str-toggle" onclick="return toggle('AddrStrategy.bits_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#bits_to_str">bits_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">bits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.bits_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.bits_to_str-expanded"><a name="L125"></a><tt class="py-lineno">125</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L126"></a><tt class="py-lineno">126</tt> <tt class="py-line"><tt class="py-docstring"> @param bits: A network address in readable binary form.</tt> </tt> -<a name="L127"></a><tt class="py-lineno">127</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L128"></a><tt class="py-lineno">128</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in string form that is equivalent to value</tt> </tt> -<a name="L129"></a><tt class="py-lineno">129</tt> <tt class="py-line"><tt class="py-docstring"> represented by network address in readable binary form.</tt> </tt> -<a name="L130"></a><tt class="py-lineno">130</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L131"></a><tt class="py-lineno">131</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-31" class="py-name"><a title="netaddr.strategy.AddrStrategy.bits_to_words" class="py-name" href="#" onclick="return doclink('link-31', 'bits_to_words', 'link-28');">bits_to_words</a></tt><tt class="py-op">(</tt><tt id="link-32" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-32', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> </tt> -<a name="L132"></a><tt class="py-lineno">132</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-33" class="py-name" targets="Method netaddr.strategy.AddrStrategy.words_to_str()=netaddr.strategy.AddrStrategy-class.html#words_to_str"><a title="netaddr.strategy.AddrStrategy.words_to_str" class="py-name" href="#" onclick="return doclink('link-33', 'words_to_str', 'link-33');">words_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L133"></a><tt class="py-lineno">133</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.bits_to_words"></a><div id="AddrStrategy.bits_to_words-def"><a name="L134"></a><tt class="py-lineno">134</tt> <a class="py-toggle" href="#" id="AddrStrategy.bits_to_words-toggle" onclick="return toggle('AddrStrategy.bits_to_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#bits_to_words">bits_to_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">bits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.bits_to_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.bits_to_words-expanded"><a name="L135"></a><tt class="py-lineno">135</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L136"></a><tt class="py-lineno">136</tt> <tt class="py-line"><tt class="py-docstring"> @param bits: A network address in readable binary form.</tt> </tt> -<a name="L137"></a><tt class="py-lineno">137</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L138"></a><tt class="py-lineno">138</tt> <tt class="py-line"><tt class="py-docstring"> @return: An integer word sequence that is equivalent to value</tt> </tt> -<a name="L139"></a><tt class="py-lineno">139</tt> <tt class="py-line"><tt class="py-docstring"> represented by network address in readable binary form.</tt> </tt> -<a name="L140"></a><tt class="py-lineno">140</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L141"></a><tt class="py-lineno">141</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-34" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_bits()=netaddr.strategy.AddrStrategy-class.html#valid_bits"><a title="netaddr.strategy.AddrStrategy.valid_bits" class="py-name" href="#" onclick="return doclink('link-34', 'valid_bits', 'link-34');">valid_bits</a></tt><tt class="py-op">(</tt><tt id="link-35" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-35', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L142"></a><tt class="py-lineno">142</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid binary form string for '</tt> \ </tt> -<a name="L143"></a><tt class="py-lineno">143</tt> <tt class="py-line"> <tt class="py-string">'address type!'</tt> <tt class="py-op">%</tt> <tt id="link-36" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-36', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> </tt> +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-24', 'addr_type', 'link-18');">addr_type</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uppercase</tt><tt class="py-op">)</tt> </tt> +</div><a name="L102"></a><tt class="py-lineno">102</tt> <tt class="py-line"> </tt> +<a name="L103"></a><tt class="py-lineno">103</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L104"></a><tt class="py-lineno">104</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Binary methods.</tt> </tt> +<a name="L105"></a><tt class="py-lineno">105</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L106"></a><tt class="py-lineno">106</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="AddrStrategy.valid_bits"></a><div id="AddrStrategy.valid_bits-def"><a name="L107"></a><tt class="py-lineno">107</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_bits-toggle" onclick="return toggle('AddrStrategy.valid_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_bits">valid_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">bits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.valid_bits-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_bits-expanded"><a name="L108"></a><tt class="py-lineno">108</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L109"></a><tt class="py-lineno">109</tt> <tt class="py-line"><tt class="py-docstring"> @param bits: A network address in readable binary form.</tt> </tt> +<a name="L110"></a><tt class="py-lineno">110</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L111"></a><tt class="py-lineno">111</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if network address is valid for this address type,</tt> </tt> +<a name="L112"></a><tt class="py-lineno">112</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> +<a name="L113"></a><tt class="py-lineno">113</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L114"></a><tt class="py-lineno">114</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt id="link-25" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-25', 'bits', 'link-11');">bits</a></tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L115"></a><tt class="py-lineno">115</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L116"></a><tt class="py-lineno">116</tt> <tt class="py-line"> </tt> +<a name="L117"></a><tt class="py-lineno">117</tt> <tt class="py-line"> <tt id="link-26" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-26', 'bits', 'link-11');">bits</a></tt> <tt class="py-op">=</tt> <tt id="link-27" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-27', 'bits', 'link-11');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> +<a name="L118"></a><tt class="py-lineno">118</tt> <tt class="py-line"> </tt> +<a name="L119"></a><tt class="py-lineno">119</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt id="link-28" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-28', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">width</tt><tt class="py-op">:</tt> </tt> +<a name="L120"></a><tt class="py-lineno">120</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L121"></a><tt class="py-lineno">121</tt> <tt class="py-line"> </tt> +<a name="L122"></a><tt class="py-lineno">122</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L123"></a><tt class="py-lineno">123</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt id="link-29" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-29', 'bits', 'link-11');">bits</a></tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">:</tt> </tt> +<a name="L124"></a><tt class="py-lineno">124</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L125"></a><tt class="py-lineno">125</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L126"></a><tt class="py-lineno">126</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L127"></a><tt class="py-lineno">127</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L128"></a><tt class="py-lineno">128</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.bits_to_int"></a><div id="AddrStrategy.bits_to_int-def"><a name="L129"></a><tt class="py-lineno">129</tt> <a class="py-toggle" href="#" id="AddrStrategy.bits_to_int-toggle" onclick="return toggle('AddrStrategy.bits_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">bits</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.bits_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.bits_to_int-expanded"><a name="L130"></a><tt class="py-lineno">130</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L131"></a><tt class="py-lineno">131</tt> <tt class="py-line"><tt class="py-docstring"> @param bits: A network address in readable binary form.</tt> </tt> +<a name="L132"></a><tt class="py-lineno">132</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L133"></a><tt class="py-lineno">133</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> +<a name="L134"></a><tt class="py-lineno">134</tt> <tt class="py-line"><tt class="py-docstring"> represented by network address in readable binary form.</tt> </tt> +<a name="L135"></a><tt class="py-lineno">135</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L136"></a><tt class="py-lineno">136</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-30" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_bits()=netaddr.strategy.AddrStrategy-class.html#valid_bits"><a title="netaddr.strategy.AddrStrategy.valid_bits" class="py-name" href="#" onclick="return doclink('link-30', 'valid_bits', 'link-30');">valid_bits</a></tt><tt class="py-op">(</tt><tt id="link-31" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-31', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L137"></a><tt class="py-lineno">137</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid binary form string for '</tt> \ </tt> +<a name="L138"></a><tt class="py-lineno">138</tt> <tt class="py-line"> <tt class="py-string">'address type!'</tt> <tt class="py-op">%</tt> <tt id="link-32" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-32', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt> </tt> +<a name="L139"></a><tt class="py-lineno">139</tt> <tt class="py-line"> </tt> +<a name="L140"></a><tt class="py-lineno">140</tt> <tt class="py-line"> <tt class="py-name">word_bits</tt> <tt class="py-op">=</tt> <tt id="link-33" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-33', 'bits', 'link-11');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">)</tt> </tt> +<a name="L141"></a><tt class="py-lineno">141</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">word_bits</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">:</tt> </tt> +<a name="L142"></a><tt class="py-lineno">142</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'invalid number of words within binary form '</tt> \ </tt> +<a name="L143"></a><tt class="py-lineno">143</tt> <tt class="py-line"> <tt class="py-string">'string for address type!'</tt> <tt class="py-op">%</tt> <tt id="link-34" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-34', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt> </tt> <a name="L144"></a><tt class="py-lineno">144</tt> <tt class="py-line"> </tt> -<a name="L145"></a><tt class="py-lineno">145</tt> <tt class="py-line"> <tt class="py-name">word_bits</tt> <tt class="py-op">=</tt> <tt id="link-37" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-37', 'bits', 'link-10');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">)</tt> </tt> -<a name="L146"></a><tt class="py-lineno">146</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">word_bits</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt><tt class="py-op">:</tt> </tt> -<a name="L147"></a><tt class="py-lineno">147</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'invalid number of words within binary form '</tt> \ </tt> -<a name="L148"></a><tt class="py-lineno">148</tt> <tt class="py-line"> <tt class="py-string">'string for address type!'</tt> <tt class="py-op">%</tt> <tt id="link-38" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-38', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> </tt> -<a name="L149"></a><tt class="py-lineno">149</tt> <tt class="py-line"> </tt> -<a name="L150"></a><tt class="py-lineno">150</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">word_bits</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -</div><a name="L151"></a><tt class="py-lineno">151</tt> <tt class="py-line"> </tt> -<a name="L152"></a><tt class="py-lineno">152</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L153"></a><tt class="py-lineno">153</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Integer methods.</tt> </tt> -<a name="L154"></a><tt class="py-lineno">154</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L155"></a><tt class="py-lineno">155</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="AddrStrategy.valid_int"></a><div id="AddrStrategy.valid_int-def"><a name="L156"></a><tt class="py-lineno">156</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_int-toggle" onclick="return toggle('AddrStrategy.valid_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_int">valid_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.valid_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_int-expanded"><a name="L157"></a><tt class="py-lineno">157</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L158"></a><tt class="py-lineno">158</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L159"></a><tt class="py-lineno">159</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L160"></a><tt class="py-lineno">160</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if network byte order integer falls within the</tt> </tt> -<a name="L161"></a><tt class="py-lineno">161</tt> <tt class="py-line"><tt class="py-docstring"> boundaries of this address type, C{False} otherwise.</tt> </tt> -<a name="L162"></a><tt class="py-lineno">162</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L163"></a><tt class="py-lineno">163</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L164"></a><tt class="py-lineno">164</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L165"></a><tt class="py-lineno">165</tt> <tt class="py-line"> </tt> -<a name="L166"></a><tt class="py-lineno">166</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_int</tt> <tt class="py-op"><=</tt> <tt class="py-name">int_val</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt><tt class="py-op">:</tt> </tt> -<a name="L167"></a><tt class="py-lineno">167</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -<a name="L168"></a><tt class="py-lineno">168</tt> <tt class="py-line"> </tt> -<a name="L169"></a><tt class="py-lineno">169</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -</div><a name="L170"></a><tt class="py-lineno">170</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.int_to_str"></a><div id="AddrStrategy.int_to_str-def"><a name="L171"></a><tt class="py-lineno">171</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_str-toggle" onclick="return toggle('AddrStrategy.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_str-expanded"><a name="L172"></a><tt class="py-lineno">172</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L173"></a><tt class="py-lineno">173</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L174"></a><tt class="py-lineno">174</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L175"></a><tt class="py-lineno">175</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in string form that is equivalent to value</tt> </tt> -<a name="L176"></a><tt class="py-lineno">176</tt> <tt class="py-line"><tt class="py-docstring"> represented by a network byte order integer.</tt> </tt> -<a name="L177"></a><tt class="py-lineno">177</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L178"></a><tt class="py-lineno">178</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-39" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_words()=netaddr.strategy.AddrStrategy-class.html#int_to_words,Method netaddr.strategy.IPv4StrategyOpt.int_to_words()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-39', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> -<a name="L179"></a><tt class="py-lineno">179</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt> </tt> -<a name="L180"></a><tt class="py-lineno">180</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -<a name="L181"></a><tt class="py-lineno">181</tt> <tt class="py-line"> </tt> -<a name="L182"></a><tt class="py-lineno">182</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">to_upper</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L183"></a><tt class="py-lineno">183</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L184"></a><tt class="py-lineno">184</tt> <tt class="py-line"> </tt> -<a name="L185"></a><tt class="py-lineno">185</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt> </tt> -</div><a name="L186"></a><tt class="py-lineno">186</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.int_to_bits"></a><div id="AddrStrategy.int_to_bits-def"><a name="L187"></a><tt class="py-lineno">187</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_bits-toggle" onclick="return toggle('AddrStrategy.int_to_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.int_to_bits-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_bits-expanded"><a name="L188"></a><tt class="py-lineno">188</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L189"></a><tt class="py-lineno">189</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L190"></a><tt class="py-lineno">190</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L191"></a><tt class="py-lineno">191</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in readable binary form that is equivalent</tt> </tt> -<a name="L192"></a><tt class="py-lineno">192</tt> <tt class="py-line"><tt class="py-docstring"> to value represented by a network byte order integer.</tt> </tt> -<a name="L193"></a><tt class="py-lineno">193</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L194"></a><tt class="py-lineno">194</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L195"></a><tt class="py-lineno">195</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">word</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-40" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-40', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L196"></a><tt class="py-lineno">196</tt> <tt class="py-line"> <tt id="link-41" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-41', 'bits', 'link-10');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-42" class="py-name" targets="Method netaddr.strategy.AddrStrategy.word_to_bits()=netaddr.strategy.AddrStrategy-class.html#word_to_bits"><a title="netaddr.strategy.AddrStrategy.word_to_bits" class="py-name" href="#" onclick="return doclink('link-42', 'word_to_bits', 'link-42');">word_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">)</tt> </tt> -<a name="L197"></a><tt class="py-lineno">197</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-43" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-43', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> </tt> -<a name="L198"></a><tt class="py-lineno">198</tt> <tt class="py-line"> </tt> -<a name="L199"></a><tt class="py-lineno">199</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">bit_words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L200"></a><tt class="py-lineno">200</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.int_to_words"></a><div id="AddrStrategy.int_to_words-def"><a name="L201"></a><tt class="py-lineno">201</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_words-toggle" onclick="return toggle('AddrStrategy.int_to_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_words">int_to_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.int_to_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_words-expanded"><a name="L202"></a><tt class="py-lineno">202</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L203"></a><tt class="py-lineno">203</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L204"></a><tt class="py-lineno">204</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L205"></a><tt class="py-lineno">205</tt> <tt class="py-line"><tt class="py-docstring"> @return: An integer word sequence that is equivalent to value</tt> </tt> -<a name="L206"></a><tt class="py-lineno">206</tt> <tt class="py-line"><tt class="py-docstring"> represented by a network byte order integer.</tt> </tt> -<a name="L207"></a><tt class="py-lineno">207</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L208"></a><tt class="py-lineno">208</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-44" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_int()=netaddr.strategy.AddrStrategy-class.html#valid_int"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-44', 'valid_int', 'link-44');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L209"></a><tt class="py-lineno">209</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid integer value for this '</tt> \ </tt> -<a name="L210"></a><tt class="py-lineno">210</tt> <tt class="py-line"> <tt class="py-string">'address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> +<a name="L145"></a><tt class="py-lineno">145</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">word_bits</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L146"></a><tt class="py-lineno">146</tt> <tt class="py-line"> </tt> +<a name="L147"></a><tt class="py-lineno">147</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-35" class="py-name" targets="Method netaddr.strategy.AddrStrategy.words_to_int()=netaddr.strategy.AddrStrategy-class.html#words_to_int,Method netaddr.strategy.IPv4StrategyOpt.words_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int"><a title="netaddr.strategy.AddrStrategy.words_to_int +netaddr.strategy.IPv4StrategyOpt.words_to_int" class="py-name" href="#" onclick="return doclink('link-35', 'words_to_int', 'link-35');">words_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> +</div><a name="L148"></a><tt class="py-lineno">148</tt> <tt class="py-line"> </tt> +<a name="L149"></a><tt class="py-lineno">149</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L150"></a><tt class="py-lineno">150</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Integer methods.</tt> </tt> +<a name="L151"></a><tt class="py-lineno">151</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L152"></a><tt class="py-lineno">152</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="AddrStrategy.valid_int"></a><div id="AddrStrategy.valid_int-def"><a name="L153"></a><tt class="py-lineno">153</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_int-toggle" onclick="return toggle('AddrStrategy.valid_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_int">valid_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.valid_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_int-expanded"><a name="L154"></a><tt class="py-lineno">154</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L155"></a><tt class="py-lineno">155</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L156"></a><tt class="py-lineno">156</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L157"></a><tt class="py-lineno">157</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if network byte order integer falls within the</tt> </tt> +<a name="L158"></a><tt class="py-lineno">158</tt> <tt class="py-line"><tt class="py-docstring"> boundaries of this address type, C{False} otherwise.</tt> </tt> +<a name="L159"></a><tt class="py-lineno">159</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L160"></a><tt class="py-lineno">160</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L161"></a><tt class="py-lineno">161</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L162"></a><tt class="py-lineno">162</tt> <tt class="py-line"> </tt> +<a name="L163"></a><tt class="py-lineno">163</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">int_val</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_int</tt> </tt> +</div><a name="L164"></a><tt class="py-lineno">164</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.int_to_str"></a><div id="AddrStrategy.int_to_str-def"><a name="L165"></a><tt class="py-lineno">165</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_str-toggle" onclick="return toggle('AddrStrategy.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_str-expanded"><a name="L166"></a><tt class="py-lineno">166</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L167"></a><tt class="py-lineno">167</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L168"></a><tt class="py-lineno">168</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L169"></a><tt class="py-lineno">169</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in string form that is equivalent to value</tt> </tt> +<a name="L170"></a><tt class="py-lineno">170</tt> <tt class="py-line"><tt class="py-docstring"> represented by a network byte order integer.</tt> </tt> +<a name="L171"></a><tt class="py-lineno">171</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L172"></a><tt class="py-lineno">172</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-36" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_words()=netaddr.strategy.AddrStrategy-class.html#int_to_words,Method netaddr.strategy.IPv4StrategyOpt.int_to_words()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-36', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> +<a name="L173"></a><tt class="py-lineno">173</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt> </tt> +<a name="L174"></a><tt class="py-lineno">174</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> +<a name="L175"></a><tt class="py-lineno">175</tt> <tt class="py-line"> </tt> +<a name="L176"></a><tt class="py-lineno">176</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">uppercase</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L177"></a><tt class="py-lineno">177</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L178"></a><tt class="py-lineno">178</tt> <tt class="py-line"> </tt> +<a name="L179"></a><tt class="py-lineno">179</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt> </tt> +</div><a name="L180"></a><tt class="py-lineno">180</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.int_to_bits"></a><div id="AddrStrategy.int_to_bits-def"><a name="L181"></a><tt class="py-lineno">181</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_bits-toggle" onclick="return toggle('AddrStrategy.int_to_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.int_to_bits-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_bits-expanded"><a name="L182"></a><tt class="py-lineno">182</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L183"></a><tt class="py-lineno">183</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L184"></a><tt class="py-lineno">184</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L185"></a><tt class="py-lineno">185</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in readable binary form that is equivalent</tt> </tt> +<a name="L186"></a><tt class="py-lineno">186</tt> <tt class="py-line"><tt class="py-docstring"> to value represented by a network byte order integer.</tt> </tt> +<a name="L187"></a><tt class="py-lineno">187</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L188"></a><tt class="py-lineno">188</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L189"></a><tt class="py-lineno">189</tt> <tt class="py-line"> </tt> +<a name="L190"></a><tt class="py-lineno">190</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">word</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-37" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-37', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L191"></a><tt class="py-lineno">191</tt> <tt class="py-line"> <tt id="link-38" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-38', 'bits', 'link-11');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L192"></a><tt class="py-lineno">192</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">word</tt><tt class="py-op">:</tt> </tt> +<a name="L193"></a><tt class="py-lineno">193</tt> <tt class="py-line"> <tt id="link-39" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-39', 'bits', 'link-11');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-40" class="py-name"><a title="netaddr.strategy._BYTES_TO_BITS" class="py-name" href="#" onclick="return doclink('link-40', '_BYTES_TO_BITS', 'link-14');">_BYTES_TO_BITS</a></tt><tt class="py-op">[</tt><tt class="py-name">word</tt><tt class="py-op">&</tt><tt class="py-number">255</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L194"></a><tt class="py-lineno">194</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">>>=</tt> <tt class="py-number">8</tt> </tt> +<a name="L195"></a><tt class="py-lineno">195</tt> <tt class="py-line"> <tt id="link-41" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-41', 'bits', 'link-11');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L196"></a><tt class="py-lineno">196</tt> <tt class="py-line"> <tt class="py-name">bit_str</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt id="link-42" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-42', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-string">'0'</tt><tt class="py-op">*</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> </tt> +<a name="L197"></a><tt class="py-lineno">197</tt> <tt class="py-line"> <tt id="link-43" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-43', 'bits', 'link-11');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">*</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">+</tt><tt class="py-name">bit_str</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> </tt> +<a name="L198"></a><tt class="py-lineno">198</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-44" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-44', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt> </tt> +<a name="L199"></a><tt class="py-lineno">199</tt> <tt class="py-line"> </tt> +<a name="L200"></a><tt class="py-lineno">200</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">bit_words</tt><tt class="py-op">)</tt> </tt> +</div><a name="L201"></a><tt class="py-lineno">201</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.int_to_bin"></a><div id="AddrStrategy.int_to_bin-def"><a name="L202"></a><tt class="py-lineno">202</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_bin-toggle" onclick="return toggle('AddrStrategy.int_to_bin');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_bin">int_to_bin</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.int_to_bin-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_bin-expanded"><a name="L203"></a><tt class="py-lineno">203</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L204"></a><tt class="py-lineno">204</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L205"></a><tt class="py-lineno">205</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L206"></a><tt class="py-lineno">206</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in standard binary representation format</tt> </tt> +<a name="L207"></a><tt class="py-lineno">207</tt> <tt class="py-line"><tt class="py-docstring"> that is equivalent to integer address value. Essentially a back</tt> </tt> +<a name="L208"></a><tt class="py-lineno">208</tt> <tt class="py-line"><tt class="py-docstring"> port of the bin() builtin in Python 2.6.x and higher.</tt> </tt> +<a name="L209"></a><tt class="py-lineno">209</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L210"></a><tt class="py-lineno">210</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> <a name="L211"></a><tt class="py-lineno">211</tt> <tt class="py-line"> </tt> -<a name="L212"></a><tt class="py-lineno">212</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L213"></a><tt class="py-lineno">213</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L214"></a><tt class="py-lineno">214</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L215"></a><tt class="py-lineno">215</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L216"></a><tt class="py-lineno">216</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> </tt> -<a name="L217"></a><tt class="py-lineno">217</tt> <tt class="py-line"> </tt> -<a name="L218"></a><tt class="py-lineno">218</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L219"></a><tt class="py-lineno">219</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L220"></a><tt class="py-lineno">220</tt> <tt class="py-line"> </tt> -<a name="L221"></a><tt class="py-lineno">221</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L222"></a><tt class="py-lineno">222</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># String methods.</tt> </tt> -<a name="L223"></a><tt class="py-lineno">223</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L224"></a><tt class="py-lineno">224</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="AddrStrategy.valid_str"></a><div id="AddrStrategy.valid_str-def"><a name="L225"></a><tt class="py-lineno">225</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_str-toggle" onclick="return toggle('AddrStrategy.valid_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_str">valid_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.valid_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_str-expanded"><a name="L226"></a><tt class="py-lineno">226</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L227"></a><tt class="py-lineno">227</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: A network address in string form.</tt> </tt> -<a name="L228"></a><tt class="py-lineno">228</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L229"></a><tt class="py-lineno">229</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if network address in string form is valid for this</tt> </tt> -<a name="L230"></a><tt class="py-lineno">230</tt> <tt class="py-line"><tt class="py-docstring"> address type, C{False} otherwise.</tt> </tt> -<a name="L231"></a><tt class="py-lineno">231</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L232"></a><tt class="py-lineno">232</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L233"></a><tt class="py-lineno">233</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L234"></a><tt class="py-lineno">234</tt> <tt class="py-line"> </tt> -<a name="L235"></a><tt class="py-lineno">235</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">)</tt> </tt> -<a name="L236"></a><tt class="py-lineno">236</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt><tt class="py-op">:</tt> </tt> -<a name="L237"></a><tt class="py-lineno">237</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L238"></a><tt class="py-lineno">238</tt> <tt class="py-line"> </tt> -<a name="L239"></a><tt class="py-lineno">239</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L240"></a><tt class="py-lineno">240</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt><tt class="py-op">:</tt> </tt> -<a name="L241"></a><tt class="py-lineno">241</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_word</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> \ </tt> -<a name="L242"></a><tt class="py-lineno">242</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> -<a name="L243"></a><tt class="py-lineno">243</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L244"></a><tt class="py-lineno">244</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L245"></a><tt class="py-lineno">245</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L246"></a><tt class="py-lineno">246</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L247"></a><tt class="py-lineno">247</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L248"></a><tt class="py-lineno">248</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L249"></a><tt class="py-lineno">249</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.str_to_int"></a><div id="AddrStrategy.str_to_int-def"><a name="L250"></a><tt class="py-lineno">250</tt> <a class="py-toggle" href="#" id="AddrStrategy.str_to_int-toggle" onclick="return toggle('AddrStrategy.str_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#str_to_int">str_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.str_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.str_to_int-expanded"><a name="L251"></a><tt class="py-lineno">251</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L252"></a><tt class="py-lineno">252</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: A network address in string form.</tt> </tt> -<a name="L253"></a><tt class="py-lineno">253</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L254"></a><tt class="py-lineno">254</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> -<a name="L255"></a><tt class="py-lineno">255</tt> <tt class="py-line"><tt class="py-docstring"> represented by network address in string form.</tt> </tt> -<a name="L256"></a><tt class="py-lineno">256</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L257"></a><tt class="py-lineno">257</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-45" class="py-name" targets="Method netaddr.strategy.AddrStrategy.str_to_words()=netaddr.strategy.AddrStrategy-class.html#str_to_words,Method netaddr.strategy.EUI48Strategy.str_to_words()=netaddr.strategy.EUI48Strategy-class.html#str_to_words"><a title="netaddr.strategy.AddrStrategy.str_to_words -netaddr.strategy.EUI48Strategy.str_to_words" class="py-name" href="#" onclick="return doclink('link-45', 'str_to_words', 'link-45');">str_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L258"></a><tt class="py-lineno">258</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-46" class="py-name"><a title="netaddr.strategy.AddrStrategy.words_to_int -netaddr.strategy.IPv4StrategyOpt.words_to_int" class="py-name" href="#" onclick="return doclink('link-46', 'words_to_int', 'link-30');">words_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L259"></a><tt class="py-lineno">259</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.str_to_bits"></a><div id="AddrStrategy.str_to_bits-def"><a name="L260"></a><tt class="py-lineno">260</tt> <a class="py-toggle" href="#" id="AddrStrategy.str_to_bits-toggle" onclick="return toggle('AddrStrategy.str_to_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#str_to_bits">str_to_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.str_to_bits-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.str_to_bits-expanded"><a name="L261"></a><tt class="py-lineno">261</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L262"></a><tt class="py-lineno">262</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: A network address in string form.</tt> </tt> -<a name="L263"></a><tt class="py-lineno">263</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L264"></a><tt class="py-lineno">264</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in readable binary form that is equivalent</tt> </tt> -<a name="L265"></a><tt class="py-lineno">265</tt> <tt class="py-line"><tt class="py-docstring"> to value represented by network address in string form.</tt> </tt> -<a name="L266"></a><tt class="py-lineno">266</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L267"></a><tt class="py-lineno">267</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-47" class="py-name"><a title="netaddr.strategy.AddrStrategy.str_to_words -netaddr.strategy.EUI48Strategy.str_to_words" class="py-name" href="#" onclick="return doclink('link-47', 'str_to_words', 'link-45');">str_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L268"></a><tt class="py-lineno">268</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-48" class="py-name" targets="Method netaddr.strategy.AddrStrategy.words_to_bits()=netaddr.strategy.AddrStrategy-class.html#words_to_bits"><a title="netaddr.strategy.AddrStrategy.words_to_bits" class="py-name" href="#" onclick="return doclink('link-48', 'words_to_bits', 'link-48');">words_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L269"></a><tt class="py-lineno">269</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.str_to_words"></a><div id="AddrStrategy.str_to_words-def"><a name="L270"></a><tt class="py-lineno">270</tt> <a class="py-toggle" href="#" id="AddrStrategy.str_to_words-toggle" onclick="return toggle('AddrStrategy.str_to_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#str_to_words">str_to_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.str_to_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.str_to_words-expanded"><a name="L271"></a><tt class="py-lineno">271</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L272"></a><tt class="py-lineno">272</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: A network address in string form.</tt> </tt> -<a name="L273"></a><tt class="py-lineno">273</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L274"></a><tt class="py-lineno">274</tt> <tt class="py-line"><tt class="py-docstring"> @return: An integer word sequence that is equivalent in value to the</tt> </tt> -<a name="L275"></a><tt class="py-lineno">275</tt> <tt class="py-line"><tt class="py-docstring"> network address in string form.</tt> </tt> -<a name="L276"></a><tt class="py-lineno">276</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L277"></a><tt class="py-lineno">277</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-49" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_str()=netaddr.strategy.AddrStrategy-class.html#valid_str,Method netaddr.strategy.EUI48Strategy.valid_str()=netaddr.strategy.EUI48Strategy-class.html#valid_str,Method netaddr.strategy.IPv6Strategy.valid_str()=netaddr.strategy.IPv6Strategy-class.html#valid_str"><a title="netaddr.strategy.AddrStrategy.valid_str +<a name="L212"></a><tt class="py-lineno">212</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">word</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-45" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-45', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L213"></a><tt class="py-lineno">213</tt> <tt class="py-line"> <tt id="link-46" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-46', 'bits', 'link-11');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L214"></a><tt class="py-lineno">214</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">word</tt><tt class="py-op">:</tt> </tt> +<a name="L215"></a><tt class="py-lineno">215</tt> <tt class="py-line"> <tt id="link-47" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-47', 'bits', 'link-11');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-48" class="py-name"><a title="netaddr.strategy._BYTES_TO_BITS" class="py-name" href="#" onclick="return doclink('link-48', '_BYTES_TO_BITS', 'link-14');">_BYTES_TO_BITS</a></tt><tt class="py-op">[</tt><tt class="py-name">word</tt><tt class="py-op">&</tt><tt class="py-number">255</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L216"></a><tt class="py-lineno">216</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">>>=</tt> <tt class="py-number">8</tt> </tt> +<a name="L217"></a><tt class="py-lineno">217</tt> <tt class="py-line"> <tt id="link-49" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-49', 'bits', 'link-11');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L218"></a><tt class="py-lineno">218</tt> <tt class="py-line"> <tt class="py-name">bit_str</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt id="link-50" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-50', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-string">'0'</tt><tt class="py-op">*</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> </tt> +<a name="L219"></a><tt class="py-lineno">219</tt> <tt class="py-line"> <tt id="link-51" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-51', 'bits', 'link-11');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">*</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">+</tt><tt class="py-name">bit_str</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> </tt> +<a name="L220"></a><tt class="py-lineno">220</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-52" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-52', 'bits', 'link-11');">bits</a></tt><tt class="py-op">)</tt> </tt> +<a name="L221"></a><tt class="py-lineno">221</tt> <tt class="py-line"> </tt> +<a name="L222"></a><tt class="py-lineno">222</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'0b'</tt> <tt class="py-op">+</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">bit_words</tt><tt class="py-op">)</tt> </tt> +</div><a name="L223"></a><tt class="py-lineno">223</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.int_to_words"></a><div id="AddrStrategy.int_to_words-def"><a name="L224"></a><tt class="py-lineno">224</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_words-toggle" onclick="return toggle('AddrStrategy.int_to_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_words">int_to_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">,</tt> <tt class="py-param">num_words</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">word_size</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.int_to_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_words-expanded"><a name="L225"></a><tt class="py-lineno">225</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L226"></a><tt class="py-lineno">226</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer to be split.</tt> </tt> +<a name="L227"></a><tt class="py-lineno">227</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L228"></a><tt class="py-lineno">228</tt> <tt class="py-line"><tt class="py-docstring"> @param num_words: (optional) number of words expected in return value</tt> </tt> +<a name="L229"></a><tt class="py-lineno">229</tt> <tt class="py-line"><tt class="py-docstring"> tuple. Uses address type default if not specified.</tt> </tt> +<a name="L230"></a><tt class="py-lineno">230</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L231"></a><tt class="py-lineno">231</tt> <tt class="py-line"><tt class="py-docstring"> @param word_size: (optional) size/width of individual words (in bits).</tt> </tt> +<a name="L232"></a><tt class="py-lineno">232</tt> <tt class="py-line"><tt class="py-docstring"> Uses address type default if not specified.</tt> </tt> +<a name="L233"></a><tt class="py-lineno">233</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L234"></a><tt class="py-lineno">234</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-53" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_int()=netaddr.strategy.AddrStrategy-class.html#valid_int"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-53', 'valid_int', 'link-53');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L235"></a><tt class="py-lineno">235</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">IndexError</tt><tt class="py-op">(</tt><tt class="py-string">'integer %r is out of bounds!'</tt> <tt class="py-op">%</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L236"></a><tt class="py-lineno">236</tt> <tt class="py-line"> </tt> +<a name="L237"></a><tt class="py-lineno">237</tt> <tt class="py-line"> <tt class="py-comment"># Set defaults for optional args.</tt> </tt> +<a name="L238"></a><tt class="py-lineno">238</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">num_words</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L239"></a><tt class="py-lineno">239</tt> <tt class="py-line"> <tt class="py-name">num_words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt> </tt> +<a name="L240"></a><tt class="py-lineno">240</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">word_size</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L241"></a><tt class="py-lineno">241</tt> <tt class="py-line"> <tt class="py-name">word_size</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> </tt> +<a name="L242"></a><tt class="py-lineno">242</tt> <tt class="py-line"> </tt> +<a name="L243"></a><tt class="py-lineno">243</tt> <tt class="py-line"> <tt class="py-name">max_word_size</tt> <tt class="py-op">=</tt> <tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">word_size</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt> </tt> +<a name="L244"></a><tt class="py-lineno">244</tt> <tt class="py-line"> </tt> +<a name="L245"></a><tt class="py-lineno">245</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L246"></a><tt class="py-lineno">246</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt id="link-54" class="py-name" targets="Variable netaddr.address.IP._=netaddr.address.IP-class.html#_,Variable netaddr.strategy.EUI48Strategy._=netaddr.strategy.EUI48Strategy-class.html#_"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-54', '_', 'link-54');">_</a></tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">num_words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L247"></a><tt class="py-lineno">247</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-name">max_word_size</tt> </tt> +<a name="L248"></a><tt class="py-lineno">248</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L249"></a><tt class="py-lineno">249</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-name">word_size</tt> </tt> +<a name="L250"></a><tt class="py-lineno">250</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L251"></a><tt class="py-lineno">251</tt> <tt class="py-line"> </tt> +<a name="L252"></a><tt class="py-lineno">252</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> +</div><a name="L253"></a><tt class="py-lineno">253</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.int_to_packed"></a><div id="AddrStrategy.int_to_packed-def"><a name="L254"></a><tt class="py-lineno">254</tt> <a class="py-toggle" href="#" id="AddrStrategy.int_to_packed-toggle" onclick="return toggle('AddrStrategy.int_to_packed');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#int_to_packed">int_to_packed</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.int_to_packed-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.int_to_packed-expanded"><a name="L255"></a><tt class="py-lineno">255</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L256"></a><tt class="py-lineno">256</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: the integer to be packed.</tt> </tt> +<a name="L257"></a><tt class="py-lineno">257</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L258"></a><tt class="py-lineno">258</tt> <tt class="py-line"><tt class="py-docstring"> @return: a packed string that is equivalent to value represented by a</tt> </tt> +<a name="L259"></a><tt class="py-lineno">259</tt> <tt class="py-line"><tt class="py-docstring"> network byte order integer.</tt> </tt> +<a name="L260"></a><tt class="py-lineno">260</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L261"></a><tt class="py-lineno">261</tt> <tt class="py-line"> </tt> +<a name="L262"></a><tt class="py-lineno">262</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-55" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-55', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">)</tt> </tt> +<a name="L263"></a><tt class="py-lineno">263</tt> <tt class="py-line"> </tt> +<a name="L264"></a><tt class="py-lineno">264</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L265"></a><tt class="py-lineno">265</tt> <tt class="py-line"> <tt id="link-56" class="py-name" targets="Variable netaddr.address.CIDR.fmt=netaddr.address.CIDR-class.html#fmt,Variable netaddr.address.IPRange.fmt=netaddr.address.IPRange-class.html#fmt,Variable netaddr.address.Wildcard.fmt=netaddr.address.Wildcard-class.html#fmt"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-56', 'fmt', 'link-56');">fmt</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'>%d%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">,</tt> <tt id="link-57" class="py-name" targets="Class netaddr.strategy.AddrStrategy=netaddr.strategy.AddrStrategy-class.html"><a title="netaddr.strategy.AddrStrategy" class="py-name" href="#" onclick="return doclink('link-57', 'AddrStrategy', 'link-57');">AddrStrategy</a></tt><tt class="py-op">.</tt><tt id="link-58" class="py-name"><a title="netaddr.strategy.AddrStrategy.STRUCT_FORMATS" class="py-name" href="#" onclick="return doclink('link-58', 'STRUCT_FORMATS', 'link-16');">STRUCT_FORMATS</a></tt><tt class="py-op">[</tt> </tt> +<a name="L266"></a><tt class="py-lineno">266</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L267"></a><tt class="py-lineno">267</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt> +<a name="L268"></a><tt class="py-lineno">268</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported word size: %d!'</tt> <tt class="py-op">%</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">)</tt> </tt> +<a name="L269"></a><tt class="py-lineno">269</tt> <tt class="py-line"> </tt> +<a name="L270"></a><tt class="py-lineno">270</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">pack</tt><tt class="py-op">(</tt><tt id="link-59" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-59', 'fmt', 'link-56');">fmt</a></tt><tt class="py-op">,</tt> <tt class="py-op">*</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> +</div><a name="L271"></a><tt class="py-lineno">271</tt> <tt class="py-line"> </tt> +<a name="L272"></a><tt class="py-lineno">272</tt> <tt class="py-line"> </tt> +<a name="L273"></a><tt class="py-lineno">273</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L274"></a><tt class="py-lineno">274</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Packed string methods.</tt> </tt> +<a name="L275"></a><tt class="py-lineno">275</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L276"></a><tt class="py-lineno">276</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="AddrStrategy.packed_to_int"></a><div id="AddrStrategy.packed_to_int-def"><a name="L277"></a><tt class="py-lineno">277</tt> <a class="py-toggle" href="#" id="AddrStrategy.packed_to_int-toggle" onclick="return toggle('AddrStrategy.packed_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#packed_to_int">packed_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">packed_int</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.packed_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.packed_to_int-expanded"><a name="L278"></a><tt class="py-lineno">278</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L279"></a><tt class="py-lineno">279</tt> <tt class="py-line"><tt class="py-docstring"> @param packed_int: a packed string containing an unsigned integer.</tt> </tt> +<a name="L280"></a><tt class="py-lineno">280</tt> <tt class="py-line"><tt class="py-docstring"> Network byte order is assumed.</tt> </tt> +<a name="L281"></a><tt class="py-lineno">281</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L282"></a><tt class="py-lineno">282</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> +<a name="L283"></a><tt class="py-lineno">283</tt> <tt class="py-line"><tt class="py-docstring"> of network address represented by packed binary string.</tt> </tt> +<a name="L284"></a><tt class="py-lineno">284</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L285"></a><tt class="py-lineno">285</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L286"></a><tt class="py-lineno">286</tt> <tt class="py-line"> <tt id="link-60" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-60', 'fmt', 'link-56');">fmt</a></tt> <tt class="py-op">=</tt> <tt class="py-string">'>%d%s'</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">,</tt> <tt id="link-61" class="py-name"><a title="netaddr.strategy.AddrStrategy" class="py-name" href="#" onclick="return doclink('link-61', 'AddrStrategy', 'link-57');">AddrStrategy</a></tt><tt class="py-op">.</tt><tt id="link-62" class="py-name"><a title="netaddr.strategy.AddrStrategy.STRUCT_FORMATS" class="py-name" href="#" onclick="return doclink('link-62', 'STRUCT_FORMATS', 'link-16');">STRUCT_FORMATS</a></tt><tt class="py-op">[</tt> </tt> +<a name="L287"></a><tt class="py-lineno">287</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L288"></a><tt class="py-lineno">288</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">KeyError</tt><tt class="py-op">:</tt> </tt> +<a name="L289"></a><tt class="py-lineno">289</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'unsupported word size: %d!'</tt> <tt class="py-op">%</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">)</tt> </tt> +<a name="L290"></a><tt class="py-lineno">290</tt> <tt class="py-line"> </tt> +<a name="L291"></a><tt class="py-lineno">291</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">unpack</tt><tt class="py-op">(</tt><tt id="link-63" class="py-name"><a title="netaddr.address.CIDR.fmt +netaddr.address.IPRange.fmt +netaddr.address.Wildcard.fmt" class="py-name" href="#" onclick="return doclink('link-63', 'fmt', 'link-56');">fmt</a></tt><tt class="py-op">,</tt> <tt class="py-name">packed_int</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L292"></a><tt class="py-lineno">292</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L293"></a><tt class="py-lineno">293</tt> <tt class="py-line"> </tt> +<a name="L294"></a><tt class="py-lineno">294</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> +<a name="L295"></a><tt class="py-lineno">295</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-name">num</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enumerate</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L296"></a><tt class="py-lineno">296</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">num</tt> </tt> +<a name="L297"></a><tt class="py-lineno">297</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">word</tt> <tt class="py-op"><<</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt> </tt> +<a name="L298"></a><tt class="py-lineno">298</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">|</tt> <tt class="py-name">word</tt> </tt> +<a name="L299"></a><tt class="py-lineno">299</tt> <tt class="py-line"> </tt> +<a name="L300"></a><tt class="py-lineno">300</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">int_val</tt> </tt> +</div><a name="L301"></a><tt class="py-lineno">301</tt> <tt class="py-line"> </tt> +<a name="L302"></a><tt class="py-lineno">302</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L303"></a><tt class="py-lineno">303</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># String methods.</tt> </tt> +<a name="L304"></a><tt class="py-lineno">304</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L305"></a><tt class="py-lineno">305</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="AddrStrategy.valid_str"></a><div id="AddrStrategy.valid_str-def"><a name="L306"></a><tt class="py-lineno">306</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_str-toggle" onclick="return toggle('AddrStrategy.valid_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_str">valid_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.valid_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_str-expanded"><a name="L307"></a><tt class="py-lineno">307</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L308"></a><tt class="py-lineno">308</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: A network address in string form.</tt> </tt> +<a name="L309"></a><tt class="py-lineno">309</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L310"></a><tt class="py-lineno">310</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if network address in string form is valid for this</tt> </tt> +<a name="L311"></a><tt class="py-lineno">311</tt> <tt class="py-line"><tt class="py-docstring"> address type, C{False} otherwise.</tt> </tt> +<a name="L312"></a><tt class="py-lineno">312</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L313"></a><tt class="py-lineno">313</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L314"></a><tt class="py-lineno">314</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L315"></a><tt class="py-lineno">315</tt> <tt class="py-line"> </tt> +<a name="L316"></a><tt class="py-lineno">316</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">)</tt> </tt> +<a name="L317"></a><tt class="py-lineno">317</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">:</tt> </tt> +<a name="L318"></a><tt class="py-lineno">318</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L319"></a><tt class="py-lineno">319</tt> <tt class="py-line"> </tt> +<a name="L320"></a><tt class="py-lineno">320</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L321"></a><tt class="py-lineno">321</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt><tt class="py-op">:</tt> </tt> +<a name="L322"></a><tt class="py-lineno">322</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt><tt class="py-op">)</tt> <tt class="py-op"><=</tt> \ </tt> +<a name="L323"></a><tt class="py-lineno">323</tt> <tt class="py-line"> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> +<a name="L324"></a><tt class="py-lineno">324</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L325"></a><tt class="py-lineno">325</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L326"></a><tt class="py-lineno">326</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L327"></a><tt class="py-lineno">327</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L328"></a><tt class="py-lineno">328</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L329"></a><tt class="py-lineno">329</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +</div><a name="L330"></a><tt class="py-lineno">330</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.str_to_int"></a><div id="AddrStrategy.str_to_int-def"><a name="L331"></a><tt class="py-lineno">331</tt> <a class="py-toggle" href="#" id="AddrStrategy.str_to_int-toggle" onclick="return toggle('AddrStrategy.str_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#str_to_int">str_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.str_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.str_to_int-expanded"><a name="L332"></a><tt class="py-lineno">332</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L333"></a><tt class="py-lineno">333</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: A network address in string form.</tt> </tt> +<a name="L334"></a><tt class="py-lineno">334</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L335"></a><tt class="py-lineno">335</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> +<a name="L336"></a><tt class="py-lineno">336</tt> <tt class="py-line"><tt class="py-docstring"> represented by network address in string form.</tt> </tt> +<a name="L337"></a><tt class="py-lineno">337</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L338"></a><tt class="py-lineno">338</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-64" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_str()=netaddr.strategy.AddrStrategy-class.html#valid_str,Method netaddr.strategy.EUI48Strategy.valid_str()=netaddr.strategy.EUI48Strategy-class.html#valid_str,Method netaddr.strategy.IPv4StrategyOpt.valid_str()=netaddr.strategy.IPv4StrategyOpt-class.html#valid_str,Method netaddr.strategy.IPv6Strategy.valid_str()=netaddr.strategy.IPv6Strategy-class.html#valid_str"><a title="netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-49', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L278"></a><tt class="py-lineno">278</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a recognised string representation'</tt> \ </tt> -<a name="L279"></a><tt class="py-lineno">279</tt> <tt class="py-line"> <tt class="py-string">' of this address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L280"></a><tt class="py-lineno">280</tt> <tt class="py-line"> </tt> -<a name="L281"></a><tt class="py-lineno">281</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">)</tt> </tt> -<a name="L282"></a><tt class="py-lineno">282</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-op">[</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">word</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt> <tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -</div><a name="L283"></a><tt class="py-lineno">283</tt> <tt class="py-line"> </tt> -<a name="L284"></a><tt class="py-lineno">284</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L285"></a><tt class="py-lineno">285</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Word list methods.</tt> </tt> -<a name="L286"></a><tt class="py-lineno">286</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L287"></a><tt class="py-lineno">287</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="AddrStrategy.valid_words"></a><div id="AddrStrategy.valid_words-def"><a name="L288"></a><tt class="py-lineno">288</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_words-toggle" onclick="return toggle('AddrStrategy.valid_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.valid_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_words-expanded"><a name="L289"></a><tt class="py-lineno">289</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L290"></a><tt class="py-lineno">290</tt> <tt class="py-line"><tt class="py-docstring"> @param words: A list or tuple containing integer word values.</tt> </tt> -<a name="L291"></a><tt class="py-lineno">291</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L292"></a><tt class="py-lineno">292</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if word sequence is valid for this address type,</tt> </tt> -<a name="L293"></a><tt class="py-lineno">293</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> -<a name="L294"></a><tt class="py-lineno">294</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L295"></a><tt class="py-lineno">295</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">list</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L296"></a><tt class="py-lineno">296</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L297"></a><tt class="py-lineno">297</tt> <tt class="py-line"> </tt> -<a name="L298"></a><tt class="py-lineno">298</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt><tt class="py-op">:</tt> </tt> -<a name="L299"></a><tt class="py-lineno">299</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L300"></a><tt class="py-lineno">300</tt> <tt class="py-line"> </tt> -<a name="L301"></a><tt class="py-lineno">301</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">:</tt> </tt> -<a name="L302"></a><tt class="py-lineno">302</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L303"></a><tt class="py-lineno">303</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L304"></a><tt class="py-lineno">304</tt> <tt class="py-line"> </tt> -<a name="L305"></a><tt class="py-lineno">305</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_word</tt> <tt class="py-op"><=</tt> <tt class="py-name">i</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> -<a name="L306"></a><tt class="py-lineno">306</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L307"></a><tt class="py-lineno">307</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L308"></a><tt class="py-lineno">308</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.words_to_int"></a><div id="AddrStrategy.words_to_int-def"><a name="L309"></a><tt class="py-lineno">309</tt> <a class="py-toggle" href="#" id="AddrStrategy.words_to_int-toggle" onclick="return toggle('AddrStrategy.words_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.words_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.words_to_int-expanded"><a name="L310"></a><tt class="py-lineno">310</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L311"></a><tt class="py-lineno">311</tt> <tt class="py-line"><tt class="py-docstring"> @param words: A list or tuple containing integer word values.</tt> </tt> -<a name="L312"></a><tt class="py-lineno">312</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L313"></a><tt class="py-lineno">313</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> -<a name="L314"></a><tt class="py-lineno">314</tt> <tt class="py-line"><tt class="py-docstring"> represented by word sequence.</tt> </tt> -<a name="L315"></a><tt class="py-lineno">315</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L316"></a><tt class="py-lineno">316</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-50" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_words()=netaddr.strategy.AddrStrategy-class.html#valid_words"><a title="netaddr.strategy.AddrStrategy.valid_words" class="py-name" href="#" onclick="return doclink('link-50', 'valid_words', 'link-50');">valid_words</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L317"></a><tt class="py-lineno">317</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid word list!'</tt> <tt class="py-op">%</tt> <tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -<a name="L318"></a><tt class="py-lineno">318</tt> <tt class="py-line"> </tt> -<a name="L319"></a><tt class="py-lineno">319</tt> <tt class="py-line"> <tt class="py-comment"># tuples have no reverse() method and reversed() is only available</tt> </tt> -<a name="L320"></a><tt class="py-lineno">320</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># in Python 2.4. Ugly but necessary.</tt> </tt> -<a name="L321"></a><tt class="py-lineno">321</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L322"></a><tt class="py-lineno">322</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -<a name="L323"></a><tt class="py-lineno">323</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L324"></a><tt class="py-lineno">324</tt> <tt class="py-line"> </tt> -<a name="L325"></a><tt class="py-lineno">325</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> -<a name="L326"></a><tt class="py-lineno">326</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-name">num</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enumerate</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L327"></a><tt class="py-lineno">327</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">num</tt> </tt> -<a name="L328"></a><tt class="py-lineno">328</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">word</tt> <tt class="py-op"><<</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt> </tt> -<a name="L329"></a><tt class="py-lineno">329</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">|</tt> <tt class="py-name">word</tt> </tt> -<a name="L330"></a><tt class="py-lineno">330</tt> <tt class="py-line"> </tt> -<a name="L331"></a><tt class="py-lineno">331</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">int_val</tt> </tt> -</div><a name="L332"></a><tt class="py-lineno">332</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.words_to_str"></a><div id="AddrStrategy.words_to_str-def"><a name="L333"></a><tt class="py-lineno">333</tt> <a class="py-toggle" href="#" id="AddrStrategy.words_to_str-toggle" onclick="return toggle('AddrStrategy.words_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#words_to_str">words_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.words_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.words_to_str-expanded"><a name="L334"></a><tt class="py-lineno">334</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L335"></a><tt class="py-lineno">335</tt> <tt class="py-line"><tt class="py-docstring"> @param words: A list or tuple containing integer word values.</tt> </tt> -<a name="L336"></a><tt class="py-lineno">336</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L337"></a><tt class="py-lineno">337</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in string form that is equivalent to value</tt> </tt> -<a name="L338"></a><tt class="py-lineno">338</tt> <tt class="py-line"><tt class="py-docstring"> represented by word sequence.</tt> </tt> -<a name="L339"></a><tt class="py-lineno">339</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L340"></a><tt class="py-lineno">340</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-51" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_words" class="py-name" href="#" onclick="return doclink('link-51', 'valid_words', 'link-50');">valid_words</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L341"></a><tt class="py-lineno">341</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid word list!'</tt> <tt class="py-op">%</tt> <tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -<a name="L342"></a><tt class="py-lineno">342</tt> <tt class="py-line"> </tt> -<a name="L343"></a><tt class="py-lineno">343</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt> </tt> -<a name="L344"></a><tt class="py-lineno">344</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -<a name="L345"></a><tt class="py-lineno">345</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt> </tt> +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-64', 'valid_str', 'link-64');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L339"></a><tt class="py-lineno">339</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a recognised string representation'</tt> \ </tt> +<a name="L340"></a><tt class="py-lineno">340</tt> <tt class="py-line"> <tt class="py-string">' of this address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L341"></a><tt class="py-lineno">341</tt> <tt class="py-line"> </tt> +<a name="L342"></a><tt class="py-lineno">342</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">)</tt> </tt> +<a name="L343"></a><tt class="py-lineno">343</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt> <tt class="py-op">]</tt> </tt> +<a name="L344"></a><tt class="py-lineno">344</tt> <tt class="py-line"> </tt> +<a name="L345"></a><tt class="py-lineno">345</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-65" class="py-name"><a title="netaddr.strategy.AddrStrategy.words_to_int +netaddr.strategy.IPv4StrategyOpt.words_to_int" class="py-name" href="#" onclick="return doclink('link-65', 'words_to_int', 'link-35');">words_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> </div><a name="L346"></a><tt class="py-lineno">346</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.words_to_bits"></a><div id="AddrStrategy.words_to_bits-def"><a name="L347"></a><tt class="py-lineno">347</tt> <a class="py-toggle" href="#" id="AddrStrategy.words_to_bits-toggle" onclick="return toggle('AddrStrategy.words_to_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#words_to_bits">words_to_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.words_to_bits-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.words_to_bits-expanded"><a name="L348"></a><tt class="py-lineno">348</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L349"></a><tt class="py-lineno">349</tt> <tt class="py-line"><tt class="py-docstring"> @param words: A list or tuple containing integer word values.</tt> </tt> -<a name="L350"></a><tt class="py-lineno">350</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L351"></a><tt class="py-lineno">351</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network address in readable binary form that is equivalent</tt> </tt> -<a name="L352"></a><tt class="py-lineno">352</tt> <tt class="py-line"><tt class="py-docstring"> to value represented by word sequence.</tt> </tt> -<a name="L353"></a><tt class="py-lineno">353</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L354"></a><tt class="py-lineno">354</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-52" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_words" class="py-name" href="#" onclick="return doclink('link-52', 'valid_words', 'link-50');">valid_words</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L355"></a><tt class="py-lineno">355</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid word list!'</tt> <tt class="py-op">%</tt> <tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -<a name="L356"></a><tt class="py-lineno">356</tt> <tt class="py-line"> </tt> -<a name="L357"></a><tt class="py-lineno">357</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L358"></a><tt class="py-lineno">358</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">word</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">:</tt> </tt> -<a name="L359"></a><tt class="py-lineno">359</tt> <tt class="py-line"> <tt id="link-53" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-53', 'bits', 'link-10');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-54" class="py-name"><a title="netaddr.strategy.AddrStrategy.word_to_bits" class="py-name" href="#" onclick="return doclink('link-54', 'word_to_bits', 'link-42');">word_to_bits</a></tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">)</tt> </tt> -<a name="L360"></a><tt class="py-lineno">360</tt> <tt class="py-line"> <tt class="py-name">bit_words</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-55" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-55', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> </tt> -<a name="L361"></a><tt class="py-lineno">361</tt> <tt class="py-line"> </tt> -<a name="L362"></a><tt class="py-lineno">362</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">bit_words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L363"></a><tt class="py-lineno">363</tt> <tt class="py-line"> </tt> -<a name="L364"></a><tt class="py-lineno">364</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L365"></a><tt class="py-lineno">365</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Other methods.</tt> </tt> -<a name="L366"></a><tt class="py-lineno">366</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> -<a name="L367"></a><tt class="py-lineno">367</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="AddrStrategy.word_to_bits"></a><div id="AddrStrategy.word_to_bits-def"><a name="L368"></a><tt class="py-lineno">368</tt> <a class="py-toggle" href="#" id="AddrStrategy.word_to_bits-toggle" onclick="return toggle('AddrStrategy.word_to_bits');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#word_to_bits">word_to_bits</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.word_to_bits-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.word_to_bits-expanded"><a name="L369"></a><tt class="py-lineno">369</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L370"></a><tt class="py-lineno">370</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: An individual integer word value.</tt> </tt> -<a name="L371"></a><tt class="py-lineno">371</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L372"></a><tt class="py-lineno">372</tt> <tt class="py-line"><tt class="py-docstring"> @return: An integer word value for this address type in a fixed width</tt> </tt> -<a name="L373"></a><tt class="py-lineno">373</tt> <tt class="py-line"><tt class="py-docstring"> readable binary form.</tt> </tt> -<a name="L374"></a><tt class="py-lineno">374</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L375"></a><tt class="py-lineno">375</tt> <tt class="py-line"> <tt id="link-56" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-56', 'bits', 'link-10');">bits</a></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L376"></a><tt class="py-lineno">376</tt> <tt class="py-line"> </tt> -<a name="L377"></a><tt class="py-lineno">377</tt> <tt class="py-line"> <tt class="py-keyword">while</tt> <tt class="py-name">int_val</tt><tt class="py-op">:</tt> </tt> -<a name="L378"></a><tt class="py-lineno">378</tt> <tt class="py-line"> <tt id="link-57" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-57', 'bits', 'link-10');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt id="link-58" class="py-name"><a title="netaddr.strategy._BYTES_TO_BITS" class="py-name" href="#" onclick="return doclink('link-58', '_BYTES_TO_BITS', 'link-13');">_BYTES_TO_BITS</a></tt><tt class="py-op">[</tt><tt class="py-name">int_val</tt><tt class="py-op">&</tt><tt class="py-number">255</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -<a name="L379"></a><tt class="py-lineno">379</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-number">8</tt> </tt> -<a name="L380"></a><tt class="py-lineno">380</tt> <tt class="py-line"> </tt> -<a name="L381"></a><tt class="py-lineno">381</tt> <tt class="py-line"> <tt id="link-59" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-59', 'bits', 'link-10');">bits</a></tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L382"></a><tt class="py-lineno">382</tt> <tt class="py-line"> <tt class="py-name">bit_str</tt> <tt class="py-op">=</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt id="link-60" class="py-name"><a title="netaddr.address.Addr.bits" class="py-name" href="#" onclick="return doclink('link-60', 'bits', 'link-10');">bits</a></tt><tt class="py-op">)</tt> <tt class="py-keyword">or</tt> <tt class="py-string">'0'</tt><tt class="py-op">*</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> </tt> -<a name="L383"></a><tt class="py-lineno">383</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">*</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">+</tt><tt class="py-name">bit_str</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> </tt> -</div><a name="L384"></a><tt class="py-lineno">384</tt> <tt class="py-line"> </tt> -<a name="AddrStrategy.description"></a><div id="AddrStrategy.description-def"><a name="L385"></a><tt class="py-lineno">385</tt> <a class="py-toggle" href="#" id="AddrStrategy.description-toggle" onclick="return toggle('AddrStrategy.description');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#description">description</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="AddrStrategy.description-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.description-expanded"><a name="L386"></a><tt class="py-lineno">386</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L387"></a><tt class="py-lineno">387</tt> <tt class="py-line"><tt class="py-docstring"> @return: String detailing setup of this L{AddrStrategy} instance.</tt> </tt> -<a name="L388"></a><tt class="py-lineno">388</tt> <tt class="py-line"><tt class="py-docstring"> Useful for debugging.</tt> </tt> -<a name="L389"></a><tt class="py-lineno">389</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L390"></a><tt class="py-lineno">390</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L391"></a><tt class="py-lineno">391</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">k</tt> <tt class="py-keyword">in</tt> <tt class="py-name">sorted</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L392"></a><tt class="py-lineno">392</tt> <tt class="py-line"> <tt class="py-name">v</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__dict__</tt><tt class="py-op">[</tt><tt class="py-name">k</tt><tt class="py-op">]</tt> </tt> -<a name="L393"></a><tt class="py-lineno">393</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">v</tt><tt class="py-op">,</tt> <tt class="py-name">bool</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L394"></a><tt class="py-lineno">394</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">"%s: %r"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L395"></a><tt class="py-lineno">395</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">v</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L396"></a><tt class="py-lineno">396</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> -<a name="L397"></a><tt class="py-lineno">397</tt> <tt class="py-line"> <tt class="py-string">"%s: %r (%s)"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">,</tt> <tt class="py-name">hex</tt><tt class="py-op">(</tt><tt class="py-name">v</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">rstrip</tt><tt class="py-op">(</tt><tt class="py-string">'L'</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L398"></a><tt class="py-lineno">398</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L399"></a><tt class="py-lineno">399</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">"%s: %r"</tt> <tt class="py-op">%</tt> <tt class="py-op">(</tt><tt class="py-name">k</tt><tt class="py-op">,</tt> <tt class="py-name">v</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L400"></a><tt class="py-lineno">400</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">"\n"</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L401"></a><tt class="py-lineno">401</tt> <tt class="py-line"> </tt> -<a name="L402"></a><tt class="py-lineno">402</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="IPv4StrategyStd"></a><div id="IPv4StrategyStd-def"><a name="L403"></a><tt class="py-lineno">403</tt> <a class="py-toggle" href="#" id="IPv4StrategyStd-toggle" onclick="return toggle('IPv4StrategyStd');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a><tt class="py-op">(</tt><tt class="py-base-class">AddrStrategy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyStd-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv4StrategyStd-expanded"><a name="L404"></a><tt class="py-lineno">404</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L405"></a><tt class="py-lineno">405</tt> <tt class="py-line"><tt class="py-docstring"> A 'safe' L{AddrStrategy} for IPv4 addresses. Unlike L{IPv4StrategyOpt}.</tt> </tt> +<a name="L347"></a><tt class="py-lineno">347</tt> <tt class="py-line"> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L348"></a><tt class="py-lineno">348</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Word list methods.</tt> </tt> +<a name="L349"></a><tt class="py-lineno">349</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment">#-------------------------------------------------------------------------</tt> </tt> +<a name="L350"></a><tt class="py-lineno">350</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="AddrStrategy.valid_words"></a><div id="AddrStrategy.valid_words-def"><a name="L351"></a><tt class="py-lineno">351</tt> <a class="py-toggle" href="#" id="AddrStrategy.valid_words-toggle" onclick="return toggle('AddrStrategy.valid_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.valid_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.valid_words-expanded"><a name="L352"></a><tt class="py-lineno">352</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L353"></a><tt class="py-lineno">353</tt> <tt class="py-line"><tt class="py-docstring"> @param words: A sequence containing integer word values.</tt> </tt> +<a name="L354"></a><tt class="py-lineno">354</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L355"></a><tt class="py-lineno">355</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if word sequence is valid for this address type,</tt> </tt> +<a name="L356"></a><tt class="py-lineno">356</tt> <tt class="py-line"><tt class="py-docstring"> C{False} otherwise.</tt> </tt> +<a name="L357"></a><tt class="py-lineno">357</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L358"></a><tt class="py-lineno">358</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">hasattr</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">,</tt> <tt class="py-string">'__iter__'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L359"></a><tt class="py-lineno">359</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L360"></a><tt class="py-lineno">360</tt> <tt class="py-line"> </tt> +<a name="L361"></a><tt class="py-lineno">361</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">:</tt> </tt> +<a name="L362"></a><tt class="py-lineno">362</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L363"></a><tt class="py-lineno">363</tt> <tt class="py-line"> </tt> +<a name="L364"></a><tt class="py-lineno">364</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">:</tt> </tt> +<a name="L365"></a><tt class="py-lineno">365</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">,</tt> <tt class="py-name">long</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L366"></a><tt class="py-lineno">366</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L367"></a><tt class="py-lineno">367</tt> <tt class="py-line"> </tt> +<a name="L368"></a><tt class="py-lineno">368</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">i</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> +<a name="L369"></a><tt class="py-lineno">369</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L370"></a><tt class="py-lineno">370</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +</div><a name="L371"></a><tt class="py-lineno">371</tt> <tt class="py-line"> </tt> +<a name="AddrStrategy.words_to_int"></a><div id="AddrStrategy.words_to_int-def"><a name="L372"></a><tt class="py-lineno">372</tt> <a class="py-toggle" href="#" id="AddrStrategy.words_to_int-toggle" onclick="return toggle('AddrStrategy.words_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="AddrStrategy.words_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="AddrStrategy.words_to_int-expanded"><a name="L373"></a><tt class="py-lineno">373</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L374"></a><tt class="py-lineno">374</tt> <tt class="py-line"><tt class="py-docstring"> @param words: A list or tuple containing integer word values.</tt> </tt> +<a name="L375"></a><tt class="py-lineno">375</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L376"></a><tt class="py-lineno">376</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> +<a name="L377"></a><tt class="py-lineno">377</tt> <tt class="py-line"><tt class="py-docstring"> represented by word sequence.</tt> </tt> +<a name="L378"></a><tt class="py-lineno">378</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L379"></a><tt class="py-lineno">379</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-66" class="py-name" targets="Method netaddr.strategy.AddrStrategy.valid_words()=netaddr.strategy.AddrStrategy-class.html#valid_words"><a title="netaddr.strategy.AddrStrategy.valid_words" class="py-name" href="#" onclick="return doclink('link-66', 'valid_words', 'link-66');">valid_words</a></tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L380"></a><tt class="py-lineno">380</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid word list!'</tt> <tt class="py-op">%</tt> <tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> +<a name="L381"></a><tt class="py-lineno">381</tt> <tt class="py-line"> </tt> +<a name="L382"></a><tt class="py-lineno">382</tt> <tt class="py-line"> <tt class="py-comment"># tuples have no reverse() method and reversed() is only available</tt> </tt> +<a name="L383"></a><tt class="py-lineno">383</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># in Python 2.4. Ugly but necessary.</tt> </tt> +<a name="L384"></a><tt class="py-lineno">384</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L385"></a><tt class="py-lineno">385</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> +<a name="L386"></a><tt class="py-lineno">386</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L387"></a><tt class="py-lineno">387</tt> <tt class="py-line"> </tt> +<a name="L388"></a><tt class="py-lineno">388</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> +<a name="L389"></a><tt class="py-lineno">389</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-name">num</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enumerate</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L390"></a><tt class="py-lineno">390</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">num</tt> </tt> +<a name="L391"></a><tt class="py-lineno">391</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">word</tt> <tt class="py-op"><<</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">*</tt> <tt class="py-name">i</tt> </tt> +<a name="L392"></a><tt class="py-lineno">392</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">|</tt> <tt class="py-name">word</tt> </tt> +<a name="L393"></a><tt class="py-lineno">393</tt> <tt class="py-line"> </tt> +<a name="L394"></a><tt class="py-lineno">394</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">int_val</tt> </tt> +</div></div><a name="L395"></a><tt class="py-lineno">395</tt> <tt class="py-line"> </tt> +<a name="L396"></a><tt class="py-lineno">396</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IPv4StrategyStd"></a><div id="IPv4StrategyStd-def"><a name="L397"></a><tt class="py-lineno">397</tt> <a class="py-toggle" href="#" id="IPv4StrategyStd-toggle" onclick="return toggle('IPv4StrategyStd');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyStd-class.html">IPv4StrategyStd</a><tt class="py-op">(</tt><tt class="py-base-class">AddrStrategy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyStd-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv4StrategyStd-expanded"><a name="L398"></a><tt class="py-lineno">398</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L399"></a><tt class="py-lineno">399</tt> <tt class="py-line"><tt class="py-docstring"> A 'safe' L{AddrStrategy} for IPv4 addresses. Unlike L{IPv4StrategyOpt}.</tt> </tt> +<a name="L400"></a><tt class="py-lineno">400</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L401"></a><tt class="py-lineno">401</tt> <tt class="py-line"><tt class="py-docstring"> It contains all methods related to IPv4 addresses that the optimised</tt> </tt> +<a name="L402"></a><tt class="py-lineno">402</tt> <tt class="py-line"><tt class="py-docstring"> version has, without the reliance on the socket or struct modules. There</tt> </tt> +<a name="L403"></a><tt class="py-lineno">403</tt> <tt class="py-line"><tt class="py-docstring"> are several cases where the use of this class are preferable when either</tt> </tt> +<a name="L404"></a><tt class="py-lineno">404</tt> <tt class="py-line"><tt class="py-docstring"> the modules mentioned do not exist on certain Python implementations or</tt> </tt> +<a name="L405"></a><tt class="py-lineno">405</tt> <tt class="py-line"><tt class="py-docstring"> contain bugs like the infamous inet_aton('255.255.255.254') bug.</tt> </tt> <a name="L406"></a><tt class="py-lineno">406</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L407"></a><tt class="py-lineno">407</tt> <tt class="py-line"><tt class="py-docstring"> It contains all methods related to IPv4 addresses that the optimised</tt> </tt> -<a name="L408"></a><tt class="py-lineno">408</tt> <tt class="py-line"><tt class="py-docstring"> version has, without the reliance on the socket or struct modules. There</tt> </tt> -<a name="L409"></a><tt class="py-lineno">409</tt> <tt class="py-line"><tt class="py-docstring"> are several cases where the use of this class are preferable when either</tt> </tt> -<a name="L410"></a><tt class="py-lineno">410</tt> <tt class="py-line"><tt class="py-docstring"> the modules mentioned do not exist on certain Python implementations or</tt> </tt> -<a name="L411"></a><tt class="py-lineno">411</tt> <tt class="py-line"><tt class="py-docstring"> contain bugs like the infamous inet_aton('255.255.255.254') bug.</tt> </tt> -<a name="L412"></a><tt class="py-lineno">412</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L413"></a><tt class="py-lineno">413</tt> <tt class="py-line"><tt class="py-docstring"> All methods shared between the optimised class and this one should be</tt> </tt> -<a name="L414"></a><tt class="py-lineno">414</tt> <tt class="py-line"><tt class="py-docstring"> defined here.</tt> </tt> -<a name="L415"></a><tt class="py-lineno">415</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="IPv4StrategyStd.__init__"></a><div id="IPv4StrategyStd.__init__-def"><a name="L416"></a><tt class="py-lineno">416</tt> <a class="py-toggle" href="#" id="IPv4StrategyStd.__init__-toggle" onclick="return toggle('IPv4StrategyStd.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyStd-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyStd.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyStd.__init__-expanded"><a name="L417"></a><tt class="py-lineno">417</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor."""</tt> </tt> -<a name="L418"></a><tt class="py-lineno">418</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-61" class="py-name" targets="Class netaddr.strategy.IPv4StrategyStd=netaddr.strategy.IPv4StrategyStd-class.html"><a title="netaddr.strategy.IPv4StrategyStd" class="py-name" href="#" onclick="return doclink('link-61', 'IPv4StrategyStd', 'link-61');">IPv4StrategyStd</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-62" class="py-name" targets="Method netaddr.address.Addr.__init__()=netaddr.address.Addr-class.html#__init__,Method netaddr.address.AddrRange.__init__()=netaddr.address.AddrRange-class.html#__init__,Method netaddr.address.AddrTypeDescriptor.__init__()=netaddr.address.AddrTypeDescriptor-class.html#__init__,Method netaddr.address.AddrValueDescriptor.__init__()=netaddr.address.AddrValueDescriptor-class.html#__init__,Method netaddr.address.CIDR.__init__()=netaddr.address.CIDR-class.html#__init__,Method netaddr.address.EUI.__init__()=netaddr.address.EUI-class.html#__init__,Method netaddr.address.IP.__init__()=netaddr.address.IP-class.html#__init__,Method netaddr.address.KlassDescriptor.__init__()=netaddr.address.KlassDescriptor-class.html#__init__,Method netaddr.address.PrefixLenDescriptor.__init__()=netaddr.address.PrefixLenDescriptor-class.html#__init__,Method netaddr.address.StrategyDescriptor.__init__()=netaddr.address.StrategyDescriptor-class.html#__init__,Method netaddr.address.Wildcard.__init__()=netaddr.address.Wildcard-class.html#__init__,Method netaddr.strategy.AddrStrategy.__init__()=netaddr.strategy.AddrStrategy-class.html#__init__,Method netaddr.strategy.EUI48Strategy.__init__()=netaddr.strategy.EUI48Strategy-class.html#__init__,Method netaddr.strategy.IPv4StrategyOpt.__init__()=netaddr.strategy.IPv4StrategyOpt-class.html#__init__,Method netaddr.strategy.IPv4StrategyStd.__init__()=netaddr.strategy.IPv4StrategyStd-class.html#__init__,Method netaddr.strategy.IPv6Strategy.__init__()=netaddr.strategy.IPv6Strategy-class.html#__init__"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +<a name="L407"></a><tt class="py-lineno">407</tt> <tt class="py-line"><tt class="py-docstring"> All methods shared between the optimised class and this one should be</tt> </tt> +<a name="L408"></a><tt class="py-lineno">408</tt> <tt class="py-line"><tt class="py-docstring"> defined here.</tt> </tt> +<a name="L409"></a><tt class="py-lineno">409</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="IPv4StrategyStd.__init__"></a><div id="IPv4StrategyStd.__init__-def"><a name="L410"></a><tt class="py-lineno">410</tt> <a class="py-toggle" href="#" id="IPv4StrategyStd.__init__-toggle" onclick="return toggle('IPv4StrategyStd.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyStd-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyStd.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyStd.__init__-expanded"><a name="L411"></a><tt class="py-lineno">411</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor."""</tt> </tt> +<a name="L412"></a><tt class="py-lineno">412</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-67" class="py-name" targets="Class netaddr.strategy.IPv4StrategyStd=netaddr.strategy.IPv4StrategyStd-class.html"><a title="netaddr.strategy.IPv4StrategyStd" class="py-name" href="#" onclick="return doclink('link-67', 'IPv4StrategyStd', 'link-67');">IPv4StrategyStd</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-68" class="py-name" targets="Method netaddr.address.Addr.__init__()=netaddr.address.Addr-class.html#__init__,Method netaddr.address.AddrTypeDescriptor.__init__()=netaddr.address.AddrTypeDescriptor-class.html#__init__,Method netaddr.address.AddrValueDescriptor.__init__()=netaddr.address.AddrValueDescriptor-class.html#__init__,Method netaddr.address.CIDR.__init__()=netaddr.address.CIDR-class.html#__init__,Method netaddr.address.EUI.__init__()=netaddr.address.EUI-class.html#__init__,Method netaddr.address.FormatDescriptor.__init__()=netaddr.address.FormatDescriptor-class.html#__init__,Method netaddr.address.IP.__init__()=netaddr.address.IP-class.html#__init__,Method netaddr.address.IPRange.__init__()=netaddr.address.IPRange-class.html#__init__,Method netaddr.address.IPRangeSet.__init__()=netaddr.address.IPRangeSet-class.html#__init__,Method netaddr.address.PrefixLenDescriptor.__init__()=netaddr.address.PrefixLenDescriptor-class.html#__init__,Method netaddr.address.StrategyDescriptor.__init__()=netaddr.address.StrategyDescriptor-class.html#__init__,Method netaddr.address.Wildcard.__init__()=netaddr.address.Wildcard-class.html#__init__,Method netaddr.core.PrettyPrinter.__init__()=netaddr.core.PrettyPrinter-class.html#__init__,Method netaddr.core.Publisher.__init__()=netaddr.core.Publisher-class.html#__init__,Method netaddr.eui.FileIndexer.__init__()=netaddr.eui.FileIndexer-class.html#__init__,Method netaddr.eui.IAB.__init__()=netaddr.eui.IAB-class.html#__init__,Method netaddr.eui.IABIndexParser.__init__()=netaddr.eui.IABIndexParser-class.html#__init__,Method netaddr.eui.OUI.__init__()=netaddr.eui.OUI-class.html#__init__,Method netaddr.eui.OUIIndexParser.__init__()=netaddr.eui.OUIIndexParser-class.html#__init__,Method netaddr.ip.DictUpdater.__init__()=netaddr.ip.DictUpdater-class.html#__init__,Method netaddr.ip.IPv4Parser.__init__()=netaddr.ip.IPv4Parser-class.html#__init__,Method netaddr.ip.IPv6Parser.__init__()=netaddr.ip.IPv6Parser-class.html#__init__,Method netaddr.ip.LineRecordParser.__init__()=netaddr.ip.LineRecordParser-class.html#__init__,Method netaddr.ip.MulticastParser.__init__()=netaddr.ip.MulticastParser-class.html#__init__,Method netaddr.strategy.AddrStrategy.__init__()=netaddr.strategy.AddrStrategy-class.html#__init__,Method netaddr.strategy.EUI48Strategy.__init__()=netaddr.strategy.EUI48Strategy-class.html#__init__,Method netaddr.strategy.IPv4StrategyOpt.__init__()=netaddr.strategy.IPv4StrategyOpt-class.html#__init__,Method netaddr.strategy.IPv4StrategyStd.__init__()=netaddr.strategy.IPv4StrategyStd-class.html#__init__,Method netaddr.strategy.IPv6Strategy.__init__()=netaddr.strategy.IPv6Strategy-class.html#__init__"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-62', '__init__', 'link-62');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">32</tt><tt class="py-op">,</tt> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">8</tt><tt class="py-op">,</tt> </tt> -<a name="L419"></a><tt class="py-lineno">419</tt> <tt class="py-line"> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%d'</tt><tt class="py-op">,</tt> <tt class="py-name">delimiter</tt><tt class="py-op">=</tt><tt class="py-string">'.'</tt><tt class="py-op">,</tt> <tt id="link-63" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-68', '__init__', 'link-68');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">32</tt><tt class="py-op">,</tt> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">8</tt><tt class="py-op">,</tt> </tt> +<a name="L413"></a><tt class="py-lineno">413</tt> <tt class="py-line"> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%d'</tt><tt class="py-op">,</tt> <tt class="py-name">word_sep</tt><tt class="py-op">=</tt><tt class="py-string">'.'</tt><tt class="py-op">,</tt> <tt id="link-69" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-63', 'addr_type', 'link-16');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-64" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-64', 'AT_INET', 'link-5');">AT_INET</a></tt><tt class="py-op">,</tt> </tt> -<a name="L420"></a><tt class="py-lineno">420</tt> <tt class="py-line"> <tt class="py-name">hex_words</tt><tt class="py-op">=</tt><tt class="py-name">False</tt><tt class="py-op">)</tt> </tt> -</div><a name="L421"></a><tt class="py-lineno">421</tt> <tt class="py-line"> </tt> -<a name="IPv4StrategyStd.int_to_arpa"></a><div id="IPv4StrategyStd.int_to_arpa-def"><a name="L422"></a><tt class="py-lineno">422</tt> <a class="py-toggle" href="#" id="IPv4StrategyStd.int_to_arpa-toggle" onclick="return toggle('IPv4StrategyStd.int_to_arpa');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa">int_to_arpa</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyStd.int_to_arpa-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyStd.int_to_arpa-expanded"><a name="L423"></a><tt class="py-lineno">423</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L424"></a><tt class="py-lineno">424</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L425"></a><tt class="py-lineno">425</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L426"></a><tt class="py-lineno">426</tt> <tt class="py-line"><tt class="py-docstring"> @return: The reverse DNS lookup for an IPv4 address in network byte</tt> </tt> -<a name="L427"></a><tt class="py-lineno">427</tt> <tt class="py-line"><tt class="py-docstring"> order integer form.</tt> </tt> -<a name="L428"></a><tt class="py-lineno">428</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L429"></a><tt class="py-lineno">429</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%d"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-65" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-65', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L430"></a><tt class="py-lineno">430</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L431"></a><tt class="py-lineno">431</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'in-addr'</tt><tt class="py-op">,</tt> <tt class="py-string">'arpa'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -<a name="L432"></a><tt class="py-lineno">432</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L433"></a><tt class="py-lineno">433</tt> <tt class="py-line"> </tt> -<a name="L434"></a><tt class="py-lineno">434</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="IPv4StrategyOpt"></a><div id="IPv4StrategyOpt-def"><a name="L435"></a><tt class="py-lineno">435</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt-toggle" onclick="return toggle('IPv4StrategyOpt');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a><tt class="py-op">(</tt><tt class="py-base-class">IPv4StrategyStd</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyOpt-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv4StrategyOpt-expanded"><a name="L436"></a><tt class="py-lineno">436</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L437"></a><tt class="py-lineno">437</tt> <tt class="py-line"><tt class="py-docstring"> An optimised L{AddrStrategy} for IPv4 addresses.</tt> </tt> -<a name="L438"></a><tt class="py-lineno">438</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L439"></a><tt class="py-lineno">439</tt> <tt class="py-line"><tt class="py-docstring"> It uses C{pack()} and C{unpack()} from the C{struct} module along with the</tt> </tt> -<a name="L440"></a><tt class="py-lineno">440</tt> <tt class="py-line"><tt class="py-docstring"> C{inet_ntoa()} and C{inet_aton()} from the C{socket} module great improve</tt> </tt> -<a name="L441"></a><tt class="py-lineno">441</tt> <tt class="py-line"><tt class="py-docstring"> the speed of certain operations (approx. 2.5 times faster than a standard</tt> </tt> -<a name="L442"></a><tt class="py-lineno">442</tt> <tt class="py-line"><tt class="py-docstring"> L{AddrStrategy} configured for IPv4).</tt> </tt> -<a name="L443"></a><tt class="py-lineno">443</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L444"></a><tt class="py-lineno">444</tt> <tt class="py-line"><tt class="py-docstring"> However, keep in mind that these modules might not be available everywhere</tt> </tt> -<a name="L445"></a><tt class="py-lineno">445</tt> <tt class="py-line"><tt class="py-docstring"> that Python itself is. Runtimes such as Google App Engine gut the</tt> </tt> -<a name="L446"></a><tt class="py-lineno">446</tt> <tt class="py-line"><tt class="py-docstring"> C{socket} module. C{struct} is also limited to processing 32-bit integers</tt> </tt> -<a name="L447"></a><tt class="py-lineno">447</tt> <tt class="py-line"><tt class="py-docstring"> which is fine for IPv4 but isn't suitable for IPv6.</tt> </tt> -<a name="L448"></a><tt class="py-lineno">448</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="IPv4StrategyOpt.__init__"></a><div id="IPv4StrategyOpt.__init__-def"><a name="L449"></a><tt class="py-lineno">449</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.__init__-toggle" onclick="return toggle('IPv4StrategyOpt.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyOpt.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.__init__-expanded"><a name="L450"></a><tt class="py-lineno">450</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor."""</tt> </tt> -<a name="L451"></a><tt class="py-lineno">451</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-66" class="py-name" targets="Class netaddr.strategy.IPv4StrategyOpt=netaddr.strategy.IPv4StrategyOpt-class.html"><a title="netaddr.strategy.IPv4StrategyOpt" class="py-name" href="#" onclick="return doclink('link-66', 'IPv4StrategyOpt', 'link-66');">IPv4StrategyOpt</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-67" class="py-name"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-69', 'addr_type', 'link-18');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-70" class="py-name"><a title="netaddr.AT_INET" class="py-name" href="#" onclick="return doclink('link-70', 'AT_INET', 'link-5');">AT_INET</a></tt><tt class="py-op">,</tt> <tt class="py-name">word_base</tt><tt class="py-op">=</tt><tt class="py-number">10</tt><tt class="py-op">)</tt> </tt> +</div><a name="L414"></a><tt class="py-lineno">414</tt> <tt class="py-line"> </tt> +<a name="IPv4StrategyStd.int_to_arpa"></a><div id="IPv4StrategyStd.int_to_arpa-def"><a name="L415"></a><tt class="py-lineno">415</tt> <a class="py-toggle" href="#" id="IPv4StrategyStd.int_to_arpa-toggle" onclick="return toggle('IPv4StrategyStd.int_to_arpa');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyStd-class.html#int_to_arpa">int_to_arpa</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyStd.int_to_arpa-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyStd.int_to_arpa-expanded"><a name="L416"></a><tt class="py-lineno">416</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L417"></a><tt class="py-lineno">417</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L418"></a><tt class="py-lineno">418</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L419"></a><tt class="py-lineno">419</tt> <tt class="py-line"><tt class="py-docstring"> @return: The reverse DNS lookup for an IPv4 address in network byte</tt> </tt> +<a name="L420"></a><tt class="py-lineno">420</tt> <tt class="py-line"><tt class="py-docstring"> order integer form.</tt> </tt> +<a name="L421"></a><tt class="py-lineno">421</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L422"></a><tt class="py-lineno">422</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%d"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-71" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-71', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> +<a name="L423"></a><tt class="py-lineno">423</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L424"></a><tt class="py-lineno">424</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'in-addr'</tt><tt class="py-op">,</tt> <tt class="py-string">'arpa'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> +<a name="L425"></a><tt class="py-lineno">425</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L426"></a><tt class="py-lineno">426</tt> <tt class="py-line"> </tt> +<a name="L427"></a><tt class="py-lineno">427</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IPv4StrategyOpt"></a><div id="IPv4StrategyOpt-def"><a name="L428"></a><tt class="py-lineno">428</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt-toggle" onclick="return toggle('IPv4StrategyOpt');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html">IPv4StrategyOpt</a><tt class="py-op">(</tt><tt class="py-base-class">IPv4StrategyStd</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyOpt-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv4StrategyOpt-expanded"><a name="L429"></a><tt class="py-lineno">429</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L430"></a><tt class="py-lineno">430</tt> <tt class="py-line"><tt class="py-docstring"> An optimised L{AddrStrategy} for IPv4 addresses.</tt> </tt> +<a name="L431"></a><tt class="py-lineno">431</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L432"></a><tt class="py-lineno">432</tt> <tt class="py-line"><tt class="py-docstring"> It uses C{pack()} and C{unpack()} from the C{struct} module along with the</tt> </tt> +<a name="L433"></a><tt class="py-lineno">433</tt> <tt class="py-line"><tt class="py-docstring"> C{inet_ntoa()} and C{inet_aton()} from the C{socket} module great improve</tt> </tt> +<a name="L434"></a><tt class="py-lineno">434</tt> <tt class="py-line"><tt class="py-docstring"> the speed of certain operations (approx. 2.5 times faster than a standard</tt> </tt> +<a name="L435"></a><tt class="py-lineno">435</tt> <tt class="py-line"><tt class="py-docstring"> L{AddrStrategy} configured for IPv4).</tt> </tt> +<a name="L436"></a><tt class="py-lineno">436</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L437"></a><tt class="py-lineno">437</tt> <tt class="py-line"><tt class="py-docstring"> However, keep in mind that these modules might not be available everywhere</tt> </tt> +<a name="L438"></a><tt class="py-lineno">438</tt> <tt class="py-line"><tt class="py-docstring"> that Python itself is. Runtimes such as Google App Engine gut the</tt> </tt> +<a name="L439"></a><tt class="py-lineno">439</tt> <tt class="py-line"><tt class="py-docstring"> C{socket} module. C{struct} is also limited to processing 32-bit integers</tt> </tt> +<a name="L440"></a><tt class="py-lineno">440</tt> <tt class="py-line"><tt class="py-docstring"> which is fine for IPv4 but isn't suitable for IPv6.</tt> </tt> +<a name="L441"></a><tt class="py-lineno">441</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="IPv4StrategyOpt.__init__"></a><div id="IPv4StrategyOpt.__init__-def"><a name="L442"></a><tt class="py-lineno">442</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.__init__-toggle" onclick="return toggle('IPv4StrategyOpt.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyOpt.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.__init__-expanded"><a name="L443"></a><tt class="py-lineno">443</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor."""</tt> </tt> +<a name="L444"></a><tt class="py-lineno">444</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt id="link-72" class="py-name" targets="Class netaddr.strategy.IPv4StrategyOpt=netaddr.strategy.IPv4StrategyOpt-class.html"><a title="netaddr.strategy.IPv4StrategyOpt" class="py-name" href="#" onclick="return doclink('link-72', 'IPv4StrategyOpt', 'link-72');">IPv4StrategyOpt</a></tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-73" class="py-name"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-67', '__init__', 'link-62');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -</div><a name="L452"></a><tt class="py-lineno">452</tt> <tt class="py-line"> </tt> -<a name="IPv4StrategyOpt.str_to_int"></a><div id="IPv4StrategyOpt.str_to_int-def"><a name="L453"></a><tt class="py-lineno">453</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.str_to_int-toggle" onclick="return toggle('IPv4StrategyOpt.str_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int">str_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyOpt.str_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.str_to_int-expanded"><a name="L454"></a><tt class="py-lineno">454</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L455"></a><tt class="py-lineno">455</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An IPv4 dotted decimal address in string form.</tt> </tt> -<a name="L456"></a><tt class="py-lineno">456</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L457"></a><tt class="py-lineno">457</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> -<a name="L458"></a><tt class="py-lineno">458</tt> <tt class="py-line"><tt class="py-docstring"> represented by the IPv4 dotted decimal address string.</tt> </tt> -<a name="L459"></a><tt class="py-lineno">459</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L460"></a><tt class="py-lineno">460</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-68" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-73', '__init__', 'link-68');">__init__</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div><a name="L445"></a><tt class="py-lineno">445</tt> <tt class="py-line"> </tt> +<a name="IPv4StrategyOpt.valid_str"></a><div id="IPv4StrategyOpt.valid_str-def"><a name="L446"></a><tt class="py-lineno">446</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.valid_str-toggle" onclick="return toggle('IPv4StrategyOpt.valid_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#valid_str">valid_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyOpt.valid_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.valid_str-expanded"><a name="L447"></a><tt class="py-lineno">447</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L448"></a><tt class="py-lineno">448</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An IP address in presentation (string) format.</tt> </tt> +<a name="L449"></a><tt class="py-lineno">449</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L450"></a><tt class="py-lineno">450</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if network address in string form is valid for this</tt> </tt> +<a name="L451"></a><tt class="py-lineno">451</tt> <tt class="py-line"><tt class="py-docstring"> address type, C{False} otherwise.</tt> </tt> +<a name="L452"></a><tt class="py-lineno">452</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L453"></a><tt class="py-lineno">453</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L454"></a><tt class="py-lineno">454</tt> <tt class="py-line"> <tt class="py-comment"># This call handles a lot of older IPv4 address formats that</tt> </tt> +<a name="L455"></a><tt class="py-lineno">455</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># it would be a lot of work to implement (many edge cases).</tt> </tt> +<a name="L456"></a><tt class="py-lineno">456</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># Please Note: only this optimised strategy class will have</tt> </tt> +<a name="L457"></a><tt class="py-lineno">457</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># the ability to parse these less common formats for the</tt> </tt> +<a name="L458"></a><tt class="py-lineno">458</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># moment.</tt> </tt> +<a name="L459"></a><tt class="py-lineno">459</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">inet_aton</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L460"></a><tt class="py-lineno">460</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">error</tt><tt class="py-op">:</tt> </tt> +<a name="L461"></a><tt class="py-lineno">461</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L462"></a><tt class="py-lineno">462</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> +<a name="L463"></a><tt class="py-lineno">463</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L464"></a><tt class="py-lineno">464</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +</div><a name="L465"></a><tt class="py-lineno">465</tt> <tt class="py-line"> </tt> +<a name="IPv4StrategyOpt.str_to_int"></a><div id="IPv4StrategyOpt.str_to_int-def"><a name="L466"></a><tt class="py-lineno">466</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.str_to_int-toggle" onclick="return toggle('IPv4StrategyOpt.str_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int">str_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyOpt.str_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.str_to_int-expanded"><a name="L467"></a><tt class="py-lineno">467</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L468"></a><tt class="py-lineno">468</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An IPv4 dotted decimal address in string form.</tt> </tt> +<a name="L469"></a><tt class="py-lineno">469</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L470"></a><tt class="py-lineno">470</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> +<a name="L471"></a><tt class="py-lineno">471</tt> <tt class="py-line"><tt class="py-docstring"> represented by the IPv4 dotted decimal address string.</tt> </tt> +<a name="L472"></a><tt class="py-lineno">472</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L473"></a><tt class="py-lineno">473</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-74" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-68', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L461"></a><tt class="py-lineno">461</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid IPv4 dotted decimal'</tt> \ </tt> -<a name="L462"></a><tt class="py-lineno">462</tt> <tt class="py-line"> <tt class="py-string">' address string!'</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L463"></a><tt class="py-lineno">463</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">unpack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">inet_aton</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> -</div><a name="L464"></a><tt class="py-lineno">464</tt> <tt class="py-line"> </tt> -<a name="IPv4StrategyOpt.int_to_str"></a><div id="IPv4StrategyOpt.int_to_str-def"><a name="L465"></a><tt class="py-lineno">465</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.int_to_str-toggle" onclick="return toggle('IPv4StrategyOpt.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyOpt.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.int_to_str-expanded"><a name="L466"></a><tt class="py-lineno">466</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L467"></a><tt class="py-lineno">467</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L468"></a><tt class="py-lineno">468</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L469"></a><tt class="py-lineno">469</tt> <tt class="py-line"><tt class="py-docstring"> @return: An IPv4 dotted decimal address string that is equivalent to</tt> </tt> -<a name="L470"></a><tt class="py-lineno">470</tt> <tt class="py-line"><tt class="py-docstring"> value represented by a 32 bit integer in network byte order.</tt> </tt> -<a name="L471"></a><tt class="py-lineno">471</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L472"></a><tt class="py-lineno">472</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-69" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-69', 'valid_int', 'link-44');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L473"></a><tt class="py-lineno">473</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid 32-bit integer!'</tt> <tt class="py-op">%</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> -<a name="L474"></a><tt class="py-lineno">474</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">inet_ntoa</tt><tt class="py-op">(</tt><tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">pack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L475"></a><tt class="py-lineno">475</tt> <tt class="py-line"> </tt> -<a name="IPv4StrategyOpt.int_to_words"></a><div id="IPv4StrategyOpt.int_to_words-def"><a name="L476"></a><tt class="py-lineno">476</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.int_to_words-toggle" onclick="return toggle('IPv4StrategyOpt.int_to_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words">int_to_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyOpt.int_to_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.int_to_words-expanded"><a name="L477"></a><tt class="py-lineno">477</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L478"></a><tt class="py-lineno">478</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L479"></a><tt class="py-lineno">479</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L480"></a><tt class="py-lineno">480</tt> <tt class="py-line"><tt class="py-docstring"> @return: An integer word (octet) sequence that is equivalent to value</tt> </tt> -<a name="L481"></a><tt class="py-lineno">481</tt> <tt class="py-line"><tt class="py-docstring"> represented by network byte order integer.</tt> </tt> -<a name="L482"></a><tt class="py-lineno">482</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L483"></a><tt class="py-lineno">483</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-70" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-70', 'valid_int', 'link-44');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L484"></a><tt class="py-lineno">484</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid integer value supported '</tt> \ </tt> -<a name="L485"></a><tt class="py-lineno">485</tt> <tt class="py-line"> <tt class="py-string">'by this address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> -<a name="L486"></a><tt class="py-lineno">486</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">unpack</tt><tt class="py-op">(</tt><tt class="py-string">'4B'</tt><tt class="py-op">,</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">pack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -</div><a name="L487"></a><tt class="py-lineno">487</tt> <tt class="py-line"> </tt> -<a name="IPv4StrategyOpt.words_to_int"></a><div id="IPv4StrategyOpt.words_to_int-def"><a name="L488"></a><tt class="py-lineno">488</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.words_to_int-toggle" onclick="return toggle('IPv4StrategyOpt.words_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int">words_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">octets</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv4StrategyOpt.words_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.words_to_int-expanded"><a name="L489"></a><tt class="py-lineno">489</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L490"></a><tt class="py-lineno">490</tt> <tt class="py-line"><tt class="py-docstring"> @param octets: A list or tuple containing integer octets.</tt> </tt> -<a name="L491"></a><tt class="py-lineno">491</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L492"></a><tt class="py-lineno">492</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> -<a name="L493"></a><tt class="py-lineno">493</tt> <tt class="py-line"><tt class="py-docstring"> represented by word (octet) sequence.</tt> </tt> -<a name="L494"></a><tt class="py-lineno">494</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L495"></a><tt class="py-lineno">495</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-71" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_words" class="py-name" href="#" onclick="return doclink('link-71', 'valid_words', 'link-50');">valid_words</a></tt><tt class="py-op">(</tt><tt class="py-name">octets</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L496"></a><tt class="py-lineno">496</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid octet list for an IPv4 '</tt> \ </tt> -<a name="L497"></a><tt class="py-lineno">497</tt> <tt class="py-line"> <tt class="py-string">'address!'</tt> <tt class="py-op">%</tt> <tt class="py-name">octets</tt><tt class="py-op">)</tt> </tt> -<a name="L498"></a><tt class="py-lineno">498</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">unpack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">pack</tt><tt class="py-op">(</tt><tt class="py-string">'4B'</tt><tt class="py-op">,</tt> <tt class="py-op">*</tt><tt class="py-name">octets</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> -</div></div><a name="L499"></a><tt class="py-lineno">499</tt> <tt class="py-line"> </tt> -<a name="L500"></a><tt class="py-lineno">500</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="IPv6Strategy"></a><div id="IPv6Strategy-def"><a name="L501"></a><tt class="py-lineno">501</tt> <a class="py-toggle" href="#" id="IPv6Strategy-toggle" onclick="return toggle('IPv6Strategy');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a><tt class="py-op">(</tt><tt class="py-base-class">AddrStrategy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv6Strategy-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv6Strategy-expanded"><a name="L502"></a><tt class="py-lineno">502</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L503"></a><tt class="py-lineno">503</tt> <tt class="py-line"><tt class="py-docstring"> Implements the operations that can be performed on an Internet Protocol</tt> </tt> -<a name="L504"></a><tt class="py-lineno">504</tt> <tt class="py-line"><tt class="py-docstring"> version 6 network address in accordance with RFC 4291.</tt> </tt> -<a name="L505"></a><tt class="py-lineno">505</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L506"></a><tt class="py-lineno">506</tt> <tt class="py-line"><tt class="py-docstring"> NB - This class would benefit greatly from access to inet_pton/inet_ntop()</tt> </tt> -<a name="L507"></a><tt class="py-lineno">507</tt> <tt class="py-line"><tt class="py-docstring"> function calls in Python's socket module. Sadly, they aren't available so</tt> </tt> -<a name="L508"></a><tt class="py-lineno">508</tt> <tt class="py-line"><tt class="py-docstring"> we'll have to put up with the pure-Python implementation here (for now at</tt> </tt> -<a name="L509"></a><tt class="py-lineno">509</tt> <tt class="py-line"><tt class="py-docstring"> least).</tt> </tt> -<a name="L510"></a><tt class="py-lineno">510</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="IPv6Strategy.__init__"></a><div id="IPv6Strategy.__init__-def"><a name="L511"></a><tt class="py-lineno">511</tt> <a class="py-toggle" href="#" id="IPv6Strategy.__init__-toggle" onclick="return toggle('IPv6Strategy.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv6Strategy.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.__init__-expanded"><a name="L512"></a><tt class="py-lineno">512</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor."""</tt> </tt> -<a name="L513"></a><tt class="py-lineno">513</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-72" class="py-name"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-74', 'valid_str', 'link-64');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L474"></a><tt class="py-lineno">474</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid IPv4 address string!'</tt> \ </tt> +<a name="L475"></a><tt class="py-lineno">475</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L476"></a><tt class="py-lineno">476</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">unpack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">inet_aton</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +</div><a name="L477"></a><tt class="py-lineno">477</tt> <tt class="py-line"> </tt> +<a name="IPv4StrategyOpt.int_to_str"></a><div id="IPv4StrategyOpt.int_to_str-def"><a name="L478"></a><tt class="py-lineno">478</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.int_to_str-toggle" onclick="return toggle('IPv4StrategyOpt.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyOpt.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.int_to_str-expanded"><a name="L479"></a><tt class="py-lineno">479</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L480"></a><tt class="py-lineno">480</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L481"></a><tt class="py-lineno">481</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L482"></a><tt class="py-lineno">482</tt> <tt class="py-line"><tt class="py-docstring"> @return: An IPv4 dotted decimal address string that is equivalent to</tt> </tt> +<a name="L483"></a><tt class="py-lineno">483</tt> <tt class="py-line"><tt class="py-docstring"> value represented by a 32 bit integer in network byte order.</tt> </tt> +<a name="L484"></a><tt class="py-lineno">484</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L485"></a><tt class="py-lineno">485</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-75" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-75', 'valid_int', 'link-53');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L486"></a><tt class="py-lineno">486</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid 32-bit integer!'</tt> <tt class="py-op">%</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> +<a name="L487"></a><tt class="py-lineno">487</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_socket</tt><tt class="py-op">.</tt><tt class="py-name">inet_ntoa</tt><tt class="py-op">(</tt><tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">pack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L488"></a><tt class="py-lineno">488</tt> <tt class="py-line"> </tt> +<a name="IPv4StrategyOpt.int_to_words"></a><div id="IPv4StrategyOpt.int_to_words-def"><a name="L489"></a><tt class="py-lineno">489</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.int_to_words-toggle" onclick="return toggle('IPv4StrategyOpt.int_to_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words">int_to_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">,</tt> <tt class="py-param">num_words</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">word_size</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyOpt.int_to_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.int_to_words-expanded"><a name="L490"></a><tt class="py-lineno">490</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L491"></a><tt class="py-lineno">491</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L492"></a><tt class="py-lineno">492</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L493"></a><tt class="py-lineno">493</tt> <tt class="py-line"><tt class="py-docstring"> @param num_words: (unused) *** interface compatibility only ***</tt> </tt> +<a name="L494"></a><tt class="py-lineno">494</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L495"></a><tt class="py-lineno">495</tt> <tt class="py-line"><tt class="py-docstring"> @param word_size: (unused) *** interface compatibility only ***</tt> </tt> +<a name="L496"></a><tt class="py-lineno">496</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L497"></a><tt class="py-lineno">497</tt> <tt class="py-line"><tt class="py-docstring"> @return: An integer word (octet) sequence that is equivalent to value</tt> </tt> +<a name="L498"></a><tt class="py-lineno">498</tt> <tt class="py-line"><tt class="py-docstring"> represented by network byte order integer.</tt> </tt> +<a name="L499"></a><tt class="py-lineno">499</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L500"></a><tt class="py-lineno">500</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-76" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-76', 'valid_int', 'link-53');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L501"></a><tt class="py-lineno">501</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid integer value supported '</tt> \ </tt> +<a name="L502"></a><tt class="py-lineno">502</tt> <tt class="py-line"> <tt class="py-string">'by this address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> +<a name="L503"></a><tt class="py-lineno">503</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">unpack</tt><tt class="py-op">(</tt><tt class="py-string">'4B'</tt><tt class="py-op">,</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">pack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +</div><a name="L504"></a><tt class="py-lineno">504</tt> <tt class="py-line"> </tt> +<a name="IPv4StrategyOpt.words_to_int"></a><div id="IPv4StrategyOpt.words_to_int-def"><a name="L505"></a><tt class="py-lineno">505</tt> <a class="py-toggle" href="#" id="IPv4StrategyOpt.words_to_int-toggle" onclick="return toggle('IPv4StrategyOpt.words_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv4StrategyOpt-class.html#words_to_int">words_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">octets</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv4StrategyOpt.words_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv4StrategyOpt.words_to_int-expanded"><a name="L506"></a><tt class="py-lineno">506</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L507"></a><tt class="py-lineno">507</tt> <tt class="py-line"><tt class="py-docstring"> @param octets: A list or tuple containing integer octets.</tt> </tt> +<a name="L508"></a><tt class="py-lineno">508</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L509"></a><tt class="py-lineno">509</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> +<a name="L510"></a><tt class="py-lineno">510</tt> <tt class="py-line"><tt class="py-docstring"> represented by word (octet) sequence.</tt> </tt> +<a name="L511"></a><tt class="py-lineno">511</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L512"></a><tt class="py-lineno">512</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-77" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_words" class="py-name" href="#" onclick="return doclink('link-77', 'valid_words', 'link-66');">valid_words</a></tt><tt class="py-op">(</tt><tt class="py-name">octets</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L513"></a><tt class="py-lineno">513</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid octet list for an IPv4 '</tt> \ </tt> +<a name="L514"></a><tt class="py-lineno">514</tt> <tt class="py-line"> <tt class="py-string">'address!'</tt> <tt class="py-op">%</tt> <tt class="py-name">octets</tt><tt class="py-op">)</tt> </tt> +<a name="L515"></a><tt class="py-lineno">515</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">unpack</tt><tt class="py-op">(</tt><tt class="py-string">'>I'</tt><tt class="py-op">,</tt> <tt class="py-name">_struct</tt><tt class="py-op">.</tt><tt class="py-name">pack</tt><tt class="py-op">(</tt><tt class="py-string">'4B'</tt><tt class="py-op">,</tt> <tt class="py-op">*</tt><tt class="py-name">octets</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +</div></div><a name="L516"></a><tt class="py-lineno">516</tt> <tt class="py-line"> </tt> +<a name="L517"></a><tt class="py-lineno">517</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="IPv6Strategy"></a><div id="IPv6Strategy-def"><a name="L518"></a><tt class="py-lineno">518</tt> <a class="py-toggle" href="#" id="IPv6Strategy-toggle" onclick="return toggle('IPv6Strategy');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html">IPv6Strategy</a><tt class="py-op">(</tt><tt class="py-base-class">AddrStrategy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv6Strategy-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="IPv6Strategy-expanded"><a name="L519"></a><tt class="py-lineno">519</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L520"></a><tt class="py-lineno">520</tt> <tt class="py-line"><tt class="py-docstring"> Implements the operations that can be performed on an Internet Protocol</tt> </tt> +<a name="L521"></a><tt class="py-lineno">521</tt> <tt class="py-line"><tt class="py-docstring"> version 6 network address in accordance with RFC 4291.</tt> </tt> +<a name="L522"></a><tt class="py-lineno">522</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L523"></a><tt class="py-lineno">523</tt> <tt class="py-line"><tt class="py-docstring"> NB - This class would benefit greatly from access to inet_pton/inet_ntop()</tt> </tt> +<a name="L524"></a><tt class="py-lineno">524</tt> <tt class="py-line"><tt class="py-docstring"> function calls in Python's socket module. Sadly, they aren't available so</tt> </tt> +<a name="L525"></a><tt class="py-lineno">525</tt> <tt class="py-line"><tt class="py-docstring"> we'll have to put up with the pure-Python implementation here (for now at</tt> </tt> +<a name="L526"></a><tt class="py-lineno">526</tt> <tt class="py-line"><tt class="py-docstring"> least).</tt> </tt> +<a name="L527"></a><tt class="py-lineno">527</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="IPv6Strategy.__init__"></a><div id="IPv6Strategy.__init__-def"><a name="L528"></a><tt class="py-lineno">528</tt> <a class="py-toggle" href="#" id="IPv6Strategy.__init__-toggle" onclick="return toggle('IPv6Strategy.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv6Strategy.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.__init__-expanded"><a name="L529"></a><tt class="py-lineno">529</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor."""</tt> </tt> +<a name="L530"></a><tt class="py-lineno">530</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-78" class="py-name"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-72', '__init__', 'link-62');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-73" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-78', '__init__', 'link-68');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-79" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-73', 'addr_type', 'link-16');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-74" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-74', 'AT_INET6', 'link-6');">AT_INET6</a></tt><tt class="py-op">,</tt> </tt> -<a name="L514"></a><tt class="py-lineno">514</tt> <tt class="py-line"> <tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">128</tt><tt class="py-op">,</tt> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">16</tt><tt class="py-op">,</tt> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%x'</tt><tt class="py-op">,</tt> <tt class="py-name">delimiter</tt><tt class="py-op">=</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> -</div><a name="L515"></a><tt class="py-lineno">515</tt> <tt class="py-line"> </tt> -<a name="IPv6Strategy.valid_str"></a><div id="IPv6Strategy.valid_str-def"><a name="L516"></a><tt class="py-lineno">516</tt> <a class="py-toggle" href="#" id="IPv6Strategy.valid_str-toggle" onclick="return toggle('IPv6Strategy.valid_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#valid_str">valid_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv6Strategy.valid_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.valid_str-expanded"><a name="L517"></a><tt class="py-lineno">517</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L518"></a><tt class="py-lineno">518</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An IPv6 address in string form.</tt> </tt> -<a name="L519"></a><tt class="py-lineno">519</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L520"></a><tt class="py-lineno">520</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if IPv6 network address string is valid, C{False}</tt> </tt> -<a name="L521"></a><tt class="py-lineno">521</tt> <tt class="py-line"><tt class="py-docstring"> otherwise.</tt> </tt> -<a name="L522"></a><tt class="py-lineno">522</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L523"></a><tt class="py-lineno">523</tt> <tt class="py-line"> <tt class="py-comment">#TODO: Reduce the length of this method ...</tt> </tt> -<a name="L524"></a><tt class="py-lineno">524</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L525"></a><tt class="py-lineno">525</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L526"></a><tt class="py-lineno">526</tt> <tt class="py-line"> </tt> -<a name="L527"></a><tt class="py-lineno">527</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'::'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L528"></a><tt class="py-lineno">528</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 compact mode.</tt> </tt> -<a name="L529"></a><tt class="py-lineno">529</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L530"></a><tt class="py-lineno">530</tt> <tt class="py-line"> <tt class="py-name">prefix</tt><tt class="py-op">,</tt> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'::'</tt><tt class="py-op">)</tt> </tt> -<a name="L531"></a><tt class="py-lineno">531</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L532"></a><tt class="py-lineno">532</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L533"></a><tt class="py-lineno">533</tt> <tt class="py-line"> </tt> -<a name="L534"></a><tt class="py-lineno">534</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L535"></a><tt class="py-lineno">535</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L536"></a><tt class="py-lineno">536</tt> <tt class="py-line"> </tt> -<a name="L537"></a><tt class="py-lineno">537</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-op">!=</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L538"></a><tt class="py-lineno">538</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">prefix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> -<a name="L539"></a><tt class="py-lineno">539</tt> <tt class="py-line"> </tt> -<a name="L540"></a><tt class="py-lineno">540</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">suffix</tt> <tt class="py-op">!=</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L541"></a><tt class="py-lineno">541</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">suffix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> -<a name="L542"></a><tt class="py-lineno">542</tt> <tt class="py-line"> </tt> -<a name="L543"></a><tt class="py-lineno">543</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 compact IPv4 compatibility mode.</tt> </tt> -<a name="L544"></a><tt class="py-lineno">544</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> -<a name="L545"></a><tt class="py-lineno">545</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> -<a name="L546"></a><tt class="py-lineno">546</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-75" class="py-name" targets="Variable netaddr.ST_IPV4=netaddr-module.html#ST_IPV4,Variable netaddr.strategy.ST_IPV4=netaddr.strategy-module.html#ST_IPV4"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-75', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-76" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str -netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-76', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L547"></a><tt class="py-lineno">547</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-77" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-77', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-78" class="py-name" targets="Method netaddr.strategy.AddrStrategy.str_to_int()=netaddr.strategy.AddrStrategy-class.html#str_to_int,Method netaddr.strategy.IPv4StrategyOpt.str_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int,Method netaddr.strategy.IPv6Strategy.str_to_int()=netaddr.strategy.IPv6Strategy-class.html#str_to_int"><a title="netaddr.strategy.AddrStrategy.str_to_int -netaddr.strategy.IPv4StrategyOpt.str_to_int -netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-78', 'str_to_int', 'link-78');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> -<a name="L548"></a><tt class="py-lineno">548</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-79" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-79', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-80" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-80', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> -<a name="L549"></a><tt class="py-lineno">549</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L550"></a><tt class="py-lineno">550</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> -<a name="L551"></a><tt class="py-lineno">551</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L552"></a><tt class="py-lineno">552</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> -<a name="L553"></a><tt class="py-lineno">553</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L554"></a><tt class="py-lineno">554</tt> <tt class="py-line"> </tt> -<a name="L555"></a><tt class="py-lineno">555</tt> <tt class="py-line"> <tt class="py-name">token_count</tt> <tt class="py-op">=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_prefix</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> </tt> +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-79', 'addr_type', 'link-18');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-80" class="py-name"><a title="netaddr.AT_INET6" class="py-name" href="#" onclick="return doclink('link-80', 'AT_INET6', 'link-6');">AT_INET6</a></tt><tt class="py-op">,</tt> </tt> +<a name="L531"></a><tt class="py-lineno">531</tt> <tt class="py-line"> <tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">128</tt><tt class="py-op">,</tt> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">16</tt><tt class="py-op">,</tt> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%x'</tt><tt class="py-op">,</tt> <tt class="py-name">word_sep</tt><tt class="py-op">=</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> +</div><a name="L532"></a><tt class="py-lineno">532</tt> <tt class="py-line"> </tt> +<a name="IPv6Strategy.valid_str"></a><div id="IPv6Strategy.valid_str-def"><a name="L533"></a><tt class="py-lineno">533</tt> <a class="py-toggle" href="#" id="IPv6Strategy.valid_str-toggle" onclick="return toggle('IPv6Strategy.valid_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#valid_str">valid_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv6Strategy.valid_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.valid_str-expanded"><a name="L534"></a><tt class="py-lineno">534</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L535"></a><tt class="py-lineno">535</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An IPv6 address in string form.</tt> </tt> +<a name="L536"></a><tt class="py-lineno">536</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L537"></a><tt class="py-lineno">537</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if IPv6 network address string is valid, C{False}</tt> </tt> +<a name="L538"></a><tt class="py-lineno">538</tt> <tt class="py-line"><tt class="py-docstring"> otherwise.</tt> </tt> +<a name="L539"></a><tt class="py-lineno">539</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L540"></a><tt class="py-lineno">540</tt> <tt class="py-line"> <tt class="py-comment">#TODO: Reduce the length of this method ...</tt> </tt> +<a name="L541"></a><tt class="py-lineno">541</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L542"></a><tt class="py-lineno">542</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L543"></a><tt class="py-lineno">543</tt> <tt class="py-line"> </tt> +<a name="L544"></a><tt class="py-lineno">544</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'::'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L545"></a><tt class="py-lineno">545</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 compact mode.</tt> </tt> +<a name="L546"></a><tt class="py-lineno">546</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L547"></a><tt class="py-lineno">547</tt> <tt class="py-line"> <tt class="py-name">prefix</tt><tt class="py-op">,</tt> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'::'</tt><tt class="py-op">)</tt> </tt> +<a name="L548"></a><tt class="py-lineno">548</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L549"></a><tt class="py-lineno">549</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L550"></a><tt class="py-lineno">550</tt> <tt class="py-line"> </tt> +<a name="L551"></a><tt class="py-lineno">551</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L552"></a><tt class="py-lineno">552</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L553"></a><tt class="py-lineno">553</tt> <tt class="py-line"> </tt> +<a name="L554"></a><tt class="py-lineno">554</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-op">!=</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L555"></a><tt class="py-lineno">555</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">prefix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> <a name="L556"></a><tt class="py-lineno">556</tt> <tt class="py-line"> </tt> -<a name="L557"></a><tt class="py-lineno">557</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">token_count</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt> -<a name="L558"></a><tt class="py-lineno">558</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L557"></a><tt class="py-lineno">557</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">suffix</tt> <tt class="py-op">!=</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L558"></a><tt class="py-lineno">558</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">suffix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> <a name="L559"></a><tt class="py-lineno">559</tt> <tt class="py-line"> </tt> -<a name="L560"></a><tt class="py-lineno">560</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L561"></a><tt class="py-lineno">561</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_prefix</tt> <tt class="py-op">+</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">:</tt> </tt> -<a name="L562"></a><tt class="py-lineno">562</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> -<a name="L563"></a><tt class="py-lineno">563</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_word</tt> <tt class="py-op"><=</tt> <tt class="py-name">word</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> -<a name="L564"></a><tt class="py-lineno">564</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L565"></a><tt class="py-lineno">565</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L566"></a><tt class="py-lineno">566</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L567"></a><tt class="py-lineno">567</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L568"></a><tt class="py-lineno">568</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 verbose mode.</tt> </tt> -<a name="L569"></a><tt class="py-lineno">569</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">':'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L570"></a><tt class="py-lineno">570</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> +<a name="L560"></a><tt class="py-lineno">560</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 compact IPv4 compatibility mode.</tt> </tt> +<a name="L561"></a><tt class="py-lineno">561</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> +<a name="L562"></a><tt class="py-lineno">562</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +<a name="L563"></a><tt class="py-lineno">563</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-81" class="py-name" targets="Variable netaddr.ST_IPV4=netaddr-module.html#ST_IPV4,Variable netaddr.strategy.ST_IPV4=netaddr.strategy-module.html#ST_IPV4"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-81', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-82" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str +netaddr.strategy.EUI48Strategy.valid_str +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-82', 'valid_str', 'link-64');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L564"></a><tt class="py-lineno">564</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-83" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-83', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-84" class="py-name" targets="Method netaddr.strategy.AddrStrategy.str_to_int()=netaddr.strategy.AddrStrategy-class.html#str_to_int,Method netaddr.strategy.EUI48Strategy.str_to_int()=netaddr.strategy.EUI48Strategy-class.html#str_to_int,Method netaddr.strategy.IPv4StrategyOpt.str_to_int()=netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int,Method netaddr.strategy.IPv6Strategy.str_to_int()=netaddr.strategy.IPv6Strategy-class.html#str_to_int"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.EUI48Strategy.str_to_int +netaddr.strategy.IPv4StrategyOpt.str_to_int +netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-84', 'str_to_int', 'link-84');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> +<a name="L565"></a><tt class="py-lineno">565</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-85" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-85', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-86" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-86', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> +<a name="L566"></a><tt class="py-lineno">566</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L567"></a><tt class="py-lineno">567</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> +<a name="L568"></a><tt class="py-lineno">568</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L569"></a><tt class="py-lineno">569</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> +<a name="L570"></a><tt class="py-lineno">570</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> <a name="L571"></a><tt class="py-lineno">571</tt> <tt class="py-line"> </tt> -<a name="L572"></a><tt class="py-lineno">572</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L573"></a><tt class="py-lineno">573</tt> <tt class="py-line"> <tt class="py-name">ipv6_prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> -<a name="L574"></a><tt class="py-lineno">574</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ipv6_prefix</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> -<a name="L575"></a><tt class="py-lineno">575</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L576"></a><tt class="py-lineno">576</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ipv6_prefix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'ffff'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L577"></a><tt class="py-lineno">577</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L578"></a><tt class="py-lineno">578</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 verbose IPv4 compatibility mode.</tt> </tt> -<a name="L579"></a><tt class="py-lineno">579</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L580"></a><tt class="py-lineno">580</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L581"></a><tt class="py-lineno">581</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> -<a name="L582"></a><tt class="py-lineno">582</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-81" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-81', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-82" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str +<a name="L572"></a><tt class="py-lineno">572</tt> <tt class="py-line"> <tt class="py-name">token_count</tt> <tt class="py-op">=</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_prefix</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> </tt> +<a name="L573"></a><tt class="py-lineno">573</tt> <tt class="py-line"> </tt> +<a name="L574"></a><tt class="py-lineno">574</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">token_count</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt> +<a name="L575"></a><tt class="py-lineno">575</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L576"></a><tt class="py-lineno">576</tt> <tt class="py-line"> </tt> +<a name="L577"></a><tt class="py-lineno">577</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L578"></a><tt class="py-lineno">578</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_prefix</tt> <tt class="py-op">+</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">:</tt> </tt> +<a name="L579"></a><tt class="py-lineno">579</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L580"></a><tt class="py-lineno">580</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">word</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> +<a name="L581"></a><tt class="py-lineno">581</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L582"></a><tt class="py-lineno">582</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L583"></a><tt class="py-lineno">583</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L584"></a><tt class="py-lineno">584</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L585"></a><tt class="py-lineno">585</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 verbose mode.</tt> </tt> +<a name="L586"></a><tt class="py-lineno">586</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">':'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L587"></a><tt class="py-lineno">587</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> +<a name="L588"></a><tt class="py-lineno">588</tt> <tt class="py-line"> </tt> +<a name="L589"></a><tt class="py-lineno">589</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L590"></a><tt class="py-lineno">590</tt> <tt class="py-line"> <tt class="py-name">ipv6_prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +<a name="L591"></a><tt class="py-lineno">591</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ipv6_prefix</tt><tt class="py-op">[</tt><tt class="py-op">:</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-op">!=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'0'</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> +<a name="L592"></a><tt class="py-lineno">592</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L593"></a><tt class="py-lineno">593</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">ipv6_prefix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-keyword">not</tt> <tt class="py-keyword">in</tt> <tt class="py-op">(</tt><tt class="py-string">'0'</tt><tt class="py-op">,</tt> <tt class="py-string">'ffff'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L594"></a><tt class="py-lineno">594</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L595"></a><tt class="py-lineno">595</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 verbose IPv4 compatibility mode.</tt> </tt> +<a name="L596"></a><tt class="py-lineno">596</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L597"></a><tt class="py-lineno">597</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L598"></a><tt class="py-lineno">598</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +<a name="L599"></a><tt class="py-lineno">599</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-87" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-87', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-88" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-82', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L583"></a><tt class="py-lineno">583</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-83" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-83', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-84" class="py-name"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-88', 'valid_str', 'link-64');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L600"></a><tt class="py-lineno">600</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-89" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-89', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-90" class="py-name"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.EUI48Strategy.str_to_int netaddr.strategy.IPv4StrategyOpt.str_to_int -netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-84', 'str_to_int', 'link-78');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> -<a name="L584"></a><tt class="py-lineno">584</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-85" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-85', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-86" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-86', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> -<a name="L585"></a><tt class="py-lineno">585</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L586"></a><tt class="py-lineno">586</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> -<a name="L587"></a><tt class="py-lineno">587</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L588"></a><tt class="py-lineno">588</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> -<a name="L589"></a><tt class="py-lineno">589</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L590"></a><tt class="py-lineno">590</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L591"></a><tt class="py-lineno">591</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 verbose mode.</tt> </tt> -<a name="L592"></a><tt class="py-lineno">592</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt><tt class="py-op">:</tt> </tt> -<a name="L593"></a><tt class="py-lineno">593</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L594"></a><tt class="py-lineno">594</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L595"></a><tt class="py-lineno">595</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt><tt class="py-op">:</tt> </tt> -<a name="L596"></a><tt class="py-lineno">596</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> -<a name="L597"></a><tt class="py-lineno">597</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">min_word</tt> <tt class="py-op"><=</tt> <tt class="py-name">word</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> -<a name="L598"></a><tt class="py-lineno">598</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L599"></a><tt class="py-lineno">599</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L600"></a><tt class="py-lineno">600</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L601"></a><tt class="py-lineno">601</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L602"></a><tt class="py-lineno">602</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L603"></a><tt class="py-lineno">603</tt> <tt class="py-line"> </tt> -<a name="L604"></a><tt class="py-lineno">604</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L605"></a><tt class="py-lineno">605</tt> <tt class="py-line"> </tt> -<a name="IPv6Strategy.str_to_int"></a><div id="IPv6Strategy.str_to_int-def"><a name="L606"></a><tt class="py-lineno">606</tt> <a class="py-toggle" href="#" id="IPv6Strategy.str_to_int-toggle" onclick="return toggle('IPv6Strategy.str_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#str_to_int">str_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv6Strategy.str_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.str_to_int-expanded"><a name="L607"></a><tt class="py-lineno">607</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L608"></a><tt class="py-lineno">608</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An IPv6 address in string form.</tt> </tt> -<a name="L609"></a><tt class="py-lineno">609</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L610"></a><tt class="py-lineno">610</tt> <tt class="py-line"><tt class="py-docstring"> @return: The equivalent network byte order integer for a given IPv6</tt> </tt> -<a name="L611"></a><tt class="py-lineno">611</tt> <tt class="py-line"><tt class="py-docstring"> address.</tt> </tt> -<a name="L612"></a><tt class="py-lineno">612</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L613"></a><tt class="py-lineno">613</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-87" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str +netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-90', 'str_to_int', 'link-84');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> +<a name="L601"></a><tt class="py-lineno">601</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-91" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-91', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-92" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-92', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> +<a name="L602"></a><tt class="py-lineno">602</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L603"></a><tt class="py-lineno">603</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> +<a name="L604"></a><tt class="py-lineno">604</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L605"></a><tt class="py-lineno">605</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> +<a name="L606"></a><tt class="py-lineno">606</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L607"></a><tt class="py-lineno">607</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L608"></a><tt class="py-lineno">608</tt> <tt class="py-line"> <tt class="py-comment"># IPv6 verbose mode.</tt> </tt> +<a name="L609"></a><tt class="py-lineno">609</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">:</tt> </tt> +<a name="L610"></a><tt class="py-lineno">610</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L611"></a><tt class="py-lineno">611</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> +<a name="L612"></a><tt class="py-lineno">612</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt><tt class="py-op">:</tt> </tt> +<a name="L613"></a><tt class="py-lineno">613</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L614"></a><tt class="py-lineno">614</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">word</tt> <tt class="py-op"><=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">max_word</tt><tt class="py-op">:</tt> </tt> +<a name="L615"></a><tt class="py-lineno">615</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L616"></a><tt class="py-lineno">616</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> +<a name="L617"></a><tt class="py-lineno">617</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L618"></a><tt class="py-lineno">618</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L619"></a><tt class="py-lineno">619</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L620"></a><tt class="py-lineno">620</tt> <tt class="py-line"> </tt> +<a name="L621"></a><tt class="py-lineno">621</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +</div><a name="L622"></a><tt class="py-lineno">622</tt> <tt class="py-line"> </tt> +<a name="IPv6Strategy.str_to_int"></a><div id="IPv6Strategy.str_to_int-def"><a name="L623"></a><tt class="py-lineno">623</tt> <a class="py-toggle" href="#" id="IPv6Strategy.str_to_int-toggle" onclick="return toggle('IPv6Strategy.str_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#str_to_int">str_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv6Strategy.str_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.str_to_int-expanded"><a name="L624"></a><tt class="py-lineno">624</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L625"></a><tt class="py-lineno">625</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An IPv6 address in string form.</tt> </tt> +<a name="L626"></a><tt class="py-lineno">626</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L627"></a><tt class="py-lineno">627</tt> <tt class="py-line"><tt class="py-docstring"> @return: The equivalent network byte order integer for a given IPv6</tt> </tt> +<a name="L628"></a><tt class="py-lineno">628</tt> <tt class="py-line"><tt class="py-docstring"> address.</tt> </tt> +<a name="L629"></a><tt class="py-lineno">629</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L630"></a><tt class="py-lineno">630</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-93" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-87', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L614"></a><tt class="py-lineno">614</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">"'%s' is an invalid IPv6 address!"</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L615"></a><tt class="py-lineno">615</tt> <tt class="py-line"> </tt> -<a name="L616"></a><tt class="py-lineno">616</tt> <tt class="py-line"> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L617"></a><tt class="py-lineno">617</tt> <tt class="py-line"> </tt> -<a name="L618"></a><tt class="py-lineno">618</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">addr</tt> <tt class="py-op">==</tt> <tt class="py-string">'::'</tt><tt class="py-op">:</tt> </tt> -<a name="L619"></a><tt class="py-lineno">619</tt> <tt class="py-line"> <tt class="py-comment"># Unspecified address.</tt> </tt> -<a name="L620"></a><tt class="py-lineno">620</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-number">0</tt> </tt> -<a name="L621"></a><tt class="py-lineno">621</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'::'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L622"></a><tt class="py-lineno">622</tt> <tt class="py-line"> <tt class="py-comment"># Abbreviated form IPv6 address.</tt> </tt> -<a name="L623"></a><tt class="py-lineno">623</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">prefix</tt><tt class="py-op">,</tt> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'::'</tt><tt class="py-op">)</tt> </tt> -<a name="L624"></a><tt class="py-lineno">624</tt> <tt class="py-line"> </tt> -<a name="L625"></a><tt class="py-lineno">625</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L626"></a><tt class="py-lineno">626</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> -<a name="L627"></a><tt class="py-lineno">627</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L628"></a><tt class="py-lineno">628</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">prefix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> -<a name="L629"></a><tt class="py-lineno">629</tt> <tt class="py-line"> </tt> -<a name="L630"></a><tt class="py-lineno">630</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">suffix</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L631"></a><tt class="py-lineno">631</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> -<a name="L632"></a><tt class="py-lineno">632</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L633"></a><tt class="py-lineno">633</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">suffix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-93', 'valid_str', 'link-64');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L631"></a><tt class="py-lineno">631</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">"'%s' is an invalid IPv6 address!"</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L632"></a><tt class="py-lineno">632</tt> <tt class="py-line"> </tt> +<a name="L633"></a><tt class="py-lineno">633</tt> <tt class="py-line"> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> <a name="L634"></a><tt class="py-lineno">634</tt> <tt class="py-line"> </tt> -<a name="L635"></a><tt class="py-lineno">635</tt> <tt class="py-line"> <tt class="py-comment"># Check for IPv4 compatibility address form.</tt> </tt> -<a name="L636"></a><tt class="py-lineno">636</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> -<a name="L637"></a><tt class="py-lineno">637</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-number">2</tt><tt class="py-op">:</tt> </tt> -<a name="L638"></a><tt class="py-lineno">638</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L639"></a><tt class="py-lineno">639</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">2</tt> <tt class="py-keyword">and</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-string">'ffff'</tt><tt class="py-op">:</tt> </tt> -<a name="L640"></a><tt class="py-lineno">640</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L635"></a><tt class="py-lineno">635</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">addr</tt> <tt class="py-op">==</tt> <tt class="py-string">'::'</tt><tt class="py-op">:</tt> </tt> +<a name="L636"></a><tt class="py-lineno">636</tt> <tt class="py-line"> <tt class="py-comment"># Unspecified address.</tt> </tt> +<a name="L637"></a><tt class="py-lineno">637</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">return</tt> <tt class="py-number">0</tt> </tt> +<a name="L638"></a><tt class="py-lineno">638</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'::'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L639"></a><tt class="py-lineno">639</tt> <tt class="py-line"> <tt class="py-comment"># Abbreviated form IPv6 address.</tt> </tt> +<a name="L640"></a><tt class="py-lineno">640</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">prefix</tt><tt class="py-op">,</tt> <tt class="py-name">suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'::'</tt><tt class="py-op">)</tt> </tt> <a name="L641"></a><tt class="py-lineno">641</tt> <tt class="py-line"> </tt> -<a name="L642"></a><tt class="py-lineno">642</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> -<a name="L643"></a><tt class="py-lineno">643</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-88" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-88', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-89" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str +<a name="L642"></a><tt class="py-lineno">642</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">prefix</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L643"></a><tt class="py-lineno">643</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> +<a name="L644"></a><tt class="py-lineno">644</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L645"></a><tt class="py-lineno">645</tt> <tt class="py-line"> <tt class="py-name">l_prefix</tt> <tt class="py-op">=</tt> <tt class="py-name">prefix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> +<a name="L646"></a><tt class="py-lineno">646</tt> <tt class="py-line"> </tt> +<a name="L647"></a><tt class="py-lineno">647</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">suffix</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L648"></a><tt class="py-lineno">648</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> +<a name="L649"></a><tt class="py-lineno">649</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L650"></a><tt class="py-lineno">650</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt> <tt class="py-op">=</tt> <tt class="py-name">suffix</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> +<a name="L651"></a><tt class="py-lineno">651</tt> <tt class="py-line"> </tt> +<a name="L652"></a><tt class="py-lineno">652</tt> <tt class="py-line"> <tt class="py-comment"># Check for IPv4 compatibility address form.</tt> </tt> +<a name="L653"></a><tt class="py-lineno">653</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-keyword">and</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> +<a name="L654"></a><tt class="py-lineno">654</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-op">></tt> <tt class="py-number">2</tt><tt class="py-op">:</tt> </tt> +<a name="L655"></a><tt class="py-lineno">655</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L656"></a><tt class="py-lineno">656</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">2</tt> <tt class="py-keyword">and</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">.</tt><tt class="py-name">lower</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-string">'ffff'</tt><tt class="py-op">:</tt> </tt> +<a name="L657"></a><tt class="py-lineno">657</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L658"></a><tt class="py-lineno">658</tt> <tt class="py-line"> </tt> +<a name="L659"></a><tt class="py-lineno">659</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +<a name="L660"></a><tt class="py-lineno">660</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-94" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-94', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-95" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-89', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L644"></a><tt class="py-lineno">644</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-90" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-90', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-91" class="py-name"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-95', 'valid_str', 'link-64');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L661"></a><tt class="py-lineno">661</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-96" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-96', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-97" class="py-name"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.EUI48Strategy.str_to_int netaddr.strategy.IPv4StrategyOpt.str_to_int -netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-91', 'str_to_int', 'link-78');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> -<a name="L645"></a><tt class="py-lineno">645</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-92" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-92', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-93" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-93', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> -<a name="L646"></a><tt class="py-lineno">646</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L647"></a><tt class="py-lineno">647</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> -<a name="L648"></a><tt class="py-lineno">648</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L649"></a><tt class="py-lineno">649</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> -<a name="L650"></a><tt class="py-lineno">650</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L651"></a><tt class="py-lineno">651</tt> <tt class="py-line"> </tt> -<a name="L652"></a><tt class="py-lineno">652</tt> <tt class="py-line"> <tt class="py-name">gap_size</tt> <tt class="py-op">=</tt> <tt class="py-number">8</tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_prefix</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-op">)</tt> </tt> -<a name="L653"></a><tt class="py-lineno">653</tt> <tt class="py-line"> </tt> -<a name="L654"></a><tt class="py-lineno">654</tt> <tt class="py-line"> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_prefix</tt><tt class="py-op">]</tt> \ </tt> -<a name="L655"></a><tt class="py-lineno">655</tt> <tt class="py-line"> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'0000'</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">gap_size</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> \ </tt> -<a name="L656"></a><tt class="py-lineno">656</tt> <tt class="py-line"> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">]</tt> </tt> -<a name="L657"></a><tt class="py-lineno">657</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L658"></a><tt class="py-lineno">658</tt> <tt class="py-line"> <tt class="py-comment"># Verbose form IPv6 address.</tt> </tt> -<a name="L659"></a><tt class="py-lineno">659</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L660"></a><tt class="py-lineno">660</tt> <tt class="py-line"> <tt class="py-comment"># IPv4 compatiblility mode.</tt> </tt> -<a name="L661"></a><tt class="py-lineno">661</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> -<a name="L662"></a><tt class="py-lineno">662</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> -<a name="L663"></a><tt class="py-lineno">663</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-94" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-94', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-95" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str +netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-97', 'str_to_int', 'link-84');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> +<a name="L662"></a><tt class="py-lineno">662</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-98" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-98', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-99" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-99', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> +<a name="L663"></a><tt class="py-lineno">663</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L664"></a><tt class="py-lineno">664</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> +<a name="L665"></a><tt class="py-lineno">665</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L666"></a><tt class="py-lineno">666</tt> <tt class="py-line"> <tt class="py-name">l_suffix</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt> </tt> +<a name="L667"></a><tt class="py-lineno">667</tt> <tt class="py-line"> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L668"></a><tt class="py-lineno">668</tt> <tt class="py-line"> </tt> +<a name="L669"></a><tt class="py-lineno">669</tt> <tt class="py-line"> <tt class="py-name">gap_size</tt> <tt class="py-op">=</tt> <tt class="py-number">8</tt> <tt class="py-op">-</tt> <tt class="py-op">(</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_prefix</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">l_suffix</tt><tt class="py-op">)</tt> <tt class="py-op">)</tt> </tt> +<a name="L670"></a><tt class="py-lineno">670</tt> <tt class="py-line"> </tt> +<a name="L671"></a><tt class="py-lineno">671</tt> <tt class="py-line"> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_prefix</tt><tt class="py-op">]</tt> \ </tt> +<a name="L672"></a><tt class="py-lineno">672</tt> <tt class="py-line"> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'0000'</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">gap_size</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> \ </tt> +<a name="L673"></a><tt class="py-lineno">673</tt> <tt class="py-line"> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">l_suffix</tt><tt class="py-op">]</tt> </tt> +<a name="L674"></a><tt class="py-lineno">674</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L675"></a><tt class="py-lineno">675</tt> <tt class="py-line"> <tt class="py-comment"># Verbose form IPv6 address.</tt> </tt> +<a name="L676"></a><tt class="py-lineno">676</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> +<a name="L677"></a><tt class="py-lineno">677</tt> <tt class="py-line"> <tt class="py-comment"># IPv4 compatiblility mode.</tt> </tt> +<a name="L678"></a><tt class="py-lineno">678</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> +<a name="L679"></a><tt class="py-lineno">679</tt> <tt class="py-line"> <tt class="py-name">ipv4_str</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> </tt> +<a name="L680"></a><tt class="py-lineno">680</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt id="link-100" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-100', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-101" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-95', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L664"></a><tt class="py-lineno">664</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-96" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-96', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-97" class="py-name"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.IPv4StrategyOpt.valid_str +netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-101', 'valid_str', 'link-64');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L681"></a><tt class="py-lineno">681</tt> <tt class="py-line"> <tt class="py-name">ipv4_int</tt> <tt class="py-op">=</tt> <tt id="link-102" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-102', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-103" class="py-name"><a title="netaddr.strategy.AddrStrategy.str_to_int +netaddr.strategy.EUI48Strategy.str_to_int netaddr.strategy.IPv4StrategyOpt.str_to_int -netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-97', 'str_to_int', 'link-78');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> -<a name="L665"></a><tt class="py-lineno">665</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-98" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-98', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-99" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-99', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> -<a name="L666"></a><tt class="py-lineno">666</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L667"></a><tt class="py-lineno">667</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L668"></a><tt class="py-lineno">668</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L669"></a><tt class="py-lineno">669</tt> <tt class="py-line"> </tt> -<a name="L670"></a><tt class="py-lineno">670</tt> <tt class="py-line"> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt><tt class="py-op">]</tt> </tt> -<a name="L671"></a><tt class="py-lineno">671</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L672"></a><tt class="py-lineno">672</tt> <tt class="py-line"> <tt class="py-comment"># non IPv4 compatiblility mode.</tt> </tt> -<a name="L673"></a><tt class="py-lineno">673</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L674"></a><tt class="py-lineno">674</tt> <tt class="py-line"> </tt> -<a name="L675"></a><tt class="py-lineno">675</tt> <tt class="py-line"> <tt id="link-100" class="py-name" targets="Variable netaddr.address.Addr.value=netaddr.address.Addr-class.html#value"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-100', 'value', 'link-100');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">values</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> -<a name="L676"></a><tt class="py-lineno">676</tt> <tt class="py-line"> </tt> -<a name="L677"></a><tt class="py-lineno">677</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-101" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-101', 'value', 'link-100');">value</a></tt> </tt> -</div><a name="L678"></a><tt class="py-lineno">678</tt> <tt class="py-line"> </tt> -<a name="IPv6Strategy.int_to_str"></a><div id="IPv6Strategy.int_to_str-def"><a name="L679"></a><tt class="py-lineno">679</tt> <a class="py-toggle" href="#" id="IPv6Strategy.int_to_str-toggle" onclick="return toggle('IPv6Strategy.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">,</tt> <tt class="py-param">compact</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-param">word_fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv6Strategy.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.int_to_str-expanded"><a name="L680"></a><tt class="py-lineno">680</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L681"></a><tt class="py-lineno">681</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L682"></a><tt class="py-lineno">682</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L683"></a><tt class="py-lineno">683</tt> <tt class="py-line"><tt class="py-docstring"> @param compact: (optional) A boolean flag indicating if compact</tt> </tt> -<a name="L684"></a><tt class="py-lineno">684</tt> <tt class="py-line"><tt class="py-docstring"> formatting should be used. If True, this method uses the '::'</tt> </tt> -<a name="L685"></a><tt class="py-lineno">685</tt> <tt class="py-line"><tt class="py-docstring"> string to represent the first adjacent group of words with a value</tt> </tt> -<a name="L686"></a><tt class="py-lineno">686</tt> <tt class="py-line"><tt class="py-docstring"> of zero. Default: True</tt> </tt> -<a name="L687"></a><tt class="py-lineno">687</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L688"></a><tt class="py-lineno">688</tt> <tt class="py-line"><tt class="py-docstring"> @param word_fmt: (optional) The Python format string used to override</tt> </tt> -<a name="L689"></a><tt class="py-lineno">689</tt> <tt class="py-line"><tt class="py-docstring"> formatting for each word.</tt> </tt> -<a name="L690"></a><tt class="py-lineno">690</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L691"></a><tt class="py-lineno">691</tt> <tt class="py-line"><tt class="py-docstring"> @return: The IPv6 string form equal to the network byte order integer</tt> </tt> -<a name="L692"></a><tt class="py-lineno">692</tt> <tt class="py-line"><tt class="py-docstring"> value provided.</tt> </tt> -<a name="L693"></a><tt class="py-lineno">693</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L694"></a><tt class="py-lineno">694</tt> <tt class="py-line"> <tt class="py-comment"># Use basic parent class implementation if compact string form is</tt> </tt> -<a name="L695"></a><tt class="py-lineno">695</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># not required.</tt> </tt> -<a name="L696"></a><tt class="py-lineno">696</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">compact</tt><tt class="py-op">:</tt> </tt> -<a name="L697"></a><tt class="py-lineno">697</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-102" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_str()=netaddr.strategy.AddrStrategy-class.html#int_to_str,Method netaddr.strategy.EUI48Strategy.int_to_str()=netaddr.strategy.EUI48Strategy-class.html#int_to_str,Method netaddr.strategy.IPv4StrategyOpt.int_to_str()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str,Method netaddr.strategy.IPv6Strategy.int_to_str()=netaddr.strategy.IPv6Strategy-class.html#int_to_str"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.IPv6Strategy.str_to_int" class="py-name" href="#" onclick="return doclink('link-103', 'str_to_int', 'link-84');">str_to_int</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_str</tt><tt class="py-op">)</tt> </tt> +<a name="L682"></a><tt class="py-lineno">682</tt> <tt class="py-line"> <tt class="py-name">ipv4_words</tt> <tt class="py-op">=</tt> <tt id="link-104" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-104', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt><tt class="py-op">.</tt><tt id="link-105" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-105', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">ipv4_int</tt><tt class="py-op">)</tt> </tt> +<a name="L683"></a><tt class="py-lineno">683</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">pop</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L684"></a><tt class="py-lineno">684</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-number">2</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L685"></a><tt class="py-lineno">685</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">"%.2x"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">ipv4_words</tt><tt class="py-op">[</tt><tt class="py-number">2</tt><tt class="py-op">:</tt><tt class="py-number">4</tt><tt class="py-op">]</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L686"></a><tt class="py-lineno">686</tt> <tt class="py-line"> </tt> +<a name="L687"></a><tt class="py-lineno">687</tt> <tt class="py-line"> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt><tt class="py-op">]</tt> </tt> +<a name="L688"></a><tt class="py-lineno">688</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L689"></a><tt class="py-lineno">689</tt> <tt class="py-line"> <tt class="py-comment"># non IPv4 compatiblility mode.</tt> </tt> +<a name="L690"></a><tt class="py-lineno">690</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">values</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-string">"%04x"</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> +<a name="L691"></a><tt class="py-lineno">691</tt> <tt class="py-line"> </tt> +<a name="L692"></a><tt class="py-lineno">692</tt> <tt class="py-line"> <tt id="link-106" class="py-name" targets="Variable netaddr.address.Addr.value=netaddr.address.Addr-class.html#value"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-106', 'value', 'link-106');">value</a></tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">values</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L693"></a><tt class="py-lineno">693</tt> <tt class="py-line"> </tt> +<a name="L694"></a><tt class="py-lineno">694</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt id="link-107" class="py-name"><a title="netaddr.address.Addr.value" class="py-name" href="#" onclick="return doclink('link-107', 'value', 'link-106');">value</a></tt> </tt> +</div><a name="L695"></a><tt class="py-lineno">695</tt> <tt class="py-line"> </tt> +<a name="IPv6Strategy.int_to_str"></a><div id="IPv6Strategy.int_to_str-def"><a name="L696"></a><tt class="py-lineno">696</tt> <a class="py-toggle" href="#" id="IPv6Strategy.int_to_str-toggle" onclick="return toggle('IPv6Strategy.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">,</tt> <tt class="py-param">compact</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">,</tt> <tt class="py-param">word_fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv6Strategy.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.int_to_str-expanded"><a name="L697"></a><tt class="py-lineno">697</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L698"></a><tt class="py-lineno">698</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L699"></a><tt class="py-lineno">699</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L700"></a><tt class="py-lineno">700</tt> <tt class="py-line"><tt class="py-docstring"> @param compact: (optional) A boolean flag indicating if compact</tt> </tt> +<a name="L701"></a><tt class="py-lineno">701</tt> <tt class="py-line"><tt class="py-docstring"> formatting should be used. If True, this method uses the '::'</tt> </tt> +<a name="L702"></a><tt class="py-lineno">702</tt> <tt class="py-line"><tt class="py-docstring"> string to represent the first adjacent group of words with a value</tt> </tt> +<a name="L703"></a><tt class="py-lineno">703</tt> <tt class="py-line"><tt class="py-docstring"> of zero. Default: True</tt> </tt> +<a name="L704"></a><tt class="py-lineno">704</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L705"></a><tt class="py-lineno">705</tt> <tt class="py-line"><tt class="py-docstring"> @param word_fmt: (optional) The Python format string used to override</tt> </tt> +<a name="L706"></a><tt class="py-lineno">706</tt> <tt class="py-line"><tt class="py-docstring"> formatting for each word.</tt> </tt> +<a name="L707"></a><tt class="py-lineno">707</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L708"></a><tt class="py-lineno">708</tt> <tt class="py-line"><tt class="py-docstring"> @return: The IPv6 string form equal to the network byte order integer</tt> </tt> +<a name="L709"></a><tt class="py-lineno">709</tt> <tt class="py-line"><tt class="py-docstring"> value provided.</tt> </tt> +<a name="L710"></a><tt class="py-lineno">710</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L711"></a><tt class="py-lineno">711</tt> <tt class="py-line"> <tt class="py-comment"># Use basic parent class implementation if compact string form is</tt> </tt> +<a name="L712"></a><tt class="py-lineno">712</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># not required.</tt> </tt> +<a name="L713"></a><tt class="py-lineno">713</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">compact</tt><tt class="py-op">:</tt> </tt> +<a name="L714"></a><tt class="py-lineno">714</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-108" class="py-name" targets="Method netaddr.strategy.AddrStrategy.int_to_str()=netaddr.strategy.AddrStrategy-class.html#int_to_str,Method netaddr.strategy.EUI48Strategy.int_to_str()=netaddr.strategy.EUI48Strategy-class.html#int_to_str,Method netaddr.strategy.IPv4StrategyOpt.int_to_str()=netaddr.strategy.IPv4StrategyOpt-class.html#int_to_str,Method netaddr.strategy.IPv6Strategy.int_to_str()=netaddr.strategy.IPv6Strategy-class.html#int_to_str"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-102', 'int_to_str', 'link-102');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> -<a name="L698"></a><tt class="py-lineno">698</tt> <tt class="py-line"> </tt> -<a name="L699"></a><tt class="py-lineno">699</tt> <tt class="py-line"> <tt class="py-name">the_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> </tt> -<a name="L700"></a><tt class="py-lineno">700</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">word_fmt</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L701"></a><tt class="py-lineno">701</tt> <tt class="py-line"> <tt class="py-name">the_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">word_fmt</tt> </tt> -<a name="L702"></a><tt class="py-lineno">702</tt> <tt class="py-line"> </tt> -<a name="L703"></a><tt class="py-lineno">703</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-103" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-103', 'valid_int', 'link-44');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L704"></a><tt class="py-lineno">704</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid integer value supported '</tt> \ </tt> -<a name="L705"></a><tt class="py-lineno">705</tt> <tt class="py-line"> <tt class="py-string">'by this address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> -<a name="L706"></a><tt class="py-lineno">706</tt> <tt class="py-line"> </tt> -<a name="L707"></a><tt class="py-lineno">707</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L708"></a><tt class="py-lineno">708</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_count</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L709"></a><tt class="py-lineno">709</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> -<a name="L710"></a><tt class="py-lineno">710</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">the_word_fmt</tt> <tt class="py-op">%</tt> <tt class="py-name">word</tt><tt class="py-op">]</tt> </tt> -<a name="L711"></a><tt class="py-lineno">711</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> </tt> -<a name="L712"></a><tt class="py-lineno">712</tt> <tt class="py-line"> </tt> -<a name="L713"></a><tt class="py-lineno">713</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L714"></a><tt class="py-lineno">714</tt> <tt class="py-line"> </tt> -<a name="L715"></a><tt class="py-lineno">715</tt> <tt class="py-line"> <tt class="py-comment"># This can probably be optimised.</tt> </tt> -<a name="L716"></a><tt class="py-lineno">716</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">compact</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L717"></a><tt class="py-lineno">717</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L718"></a><tt class="py-lineno">718</tt> <tt class="py-line"> <tt class="py-name">compact_start</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L719"></a><tt class="py-lineno">719</tt> <tt class="py-line"> <tt class="py-name">compact_end</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> -<a name="L720"></a><tt class="py-lineno">720</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">tokens</tt><tt class="py-op">:</tt> </tt> -<a name="L721"></a><tt class="py-lineno">721</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">token</tt> <tt class="py-op">==</tt> <tt class="py-string">'0'</tt><tt class="py-op">:</tt> </tt> -<a name="L722"></a><tt class="py-lineno">722</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">compact_start</tt> <tt class="py-op">==</tt> <tt class="py-name">False</tt> <tt class="py-keyword">and</tt> <tt class="py-name">compact_end</tt> <tt class="py-op">==</tt> <tt class="py-name">False</tt><tt class="py-op">:</tt> </tt> -<a name="L723"></a><tt class="py-lineno">723</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">''</tt><tt class="py-op">]</tt> </tt> -<a name="L724"></a><tt class="py-lineno">724</tt> <tt class="py-line"> <tt class="py-name">compact_start</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L725"></a><tt class="py-lineno">725</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">compact_start</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt> <tt class="py-keyword">and</tt> <tt class="py-name">compact_end</tt> <tt class="py-op">==</tt> <tt class="py-name">False</tt><tt class="py-op">:</tt> </tt> -<a name="L726"></a><tt class="py-lineno">726</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L727"></a><tt class="py-lineno">727</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L728"></a><tt class="py-lineno">728</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">'0'</tt><tt class="py-op">]</tt> </tt> -<a name="L729"></a><tt class="py-lineno">729</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L730"></a><tt class="py-lineno">730</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">compact_start</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L731"></a><tt class="py-lineno">731</tt> <tt class="py-line"> <tt class="py-name">compact_end</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> -<a name="L732"></a><tt class="py-lineno">732</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">token</tt><tt class="py-op">]</tt> </tt> -<a name="L733"></a><tt class="py-lineno">733</tt> <tt class="py-line"> </tt> -<a name="L734"></a><tt class="py-lineno">734</tt> <tt class="py-line"> <tt class="py-comment"># Post loop fixups.</tt> </tt> -<a name="L735"></a><tt class="py-lineno">735</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">new_tokens</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">1</tt> <tt class="py-keyword">and</tt> <tt class="py-name">new_tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L736"></a><tt class="py-lineno">736</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">''</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">]</tt> </tt> -<a name="L737"></a><tt class="py-lineno">737</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">new_tokens</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L738"></a><tt class="py-lineno">738</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-string">''</tt><tt class="py-op">]</tt> </tt> -<a name="L739"></a><tt class="py-lineno">739</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">new_tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> -<a name="L740"></a><tt class="py-lineno">740</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt><tt class="py-op">.</tt><tt class="py-name">insert</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> -<a name="L741"></a><tt class="py-lineno">741</tt> <tt class="py-line"> </tt> -<a name="L742"></a><tt class="py-lineno">742</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">new_tokens</tt> </tt> -<a name="L743"></a><tt class="py-lineno">743</tt> <tt class="py-line"> </tt> -<a name="L744"></a><tt class="py-lineno">744</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">':'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -</div><a name="L745"></a><tt class="py-lineno">745</tt> <tt class="py-line"> </tt> -<a name="IPv6Strategy.int_to_arpa"></a><div id="IPv6Strategy.int_to_arpa-def"><a name="L746"></a><tt class="py-lineno">746</tt> <a class="py-toggle" href="#" id="IPv6Strategy.int_to_arpa-toggle" onclick="return toggle('IPv6Strategy.int_to_arpa');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#int_to_arpa">int_to_arpa</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="IPv6Strategy.int_to_arpa-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.int_to_arpa-expanded"><a name="L747"></a><tt class="py-lineno">747</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L748"></a><tt class="py-lineno">748</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L749"></a><tt class="py-lineno">749</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L750"></a><tt class="py-lineno">750</tt> <tt class="py-line"><tt class="py-docstring"> @return: The reverse DNS lookup for an IPv6 address in network byte</tt> </tt> -<a name="L751"></a><tt class="py-lineno">751</tt> <tt class="py-line"><tt class="py-docstring"> order integer form.</tt> </tt> -<a name="L752"></a><tt class="py-lineno">752</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L753"></a><tt class="py-lineno">753</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-104" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-108', 'int_to_str', 'link-108');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> +<a name="L715"></a><tt class="py-lineno">715</tt> <tt class="py-line"> </tt> +<a name="L716"></a><tt class="py-lineno">716</tt> <tt class="py-line"> <tt class="py-name">_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> </tt> +<a name="L717"></a><tt class="py-lineno">717</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">word_fmt</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L718"></a><tt class="py-lineno">718</tt> <tt class="py-line"> <tt class="py-name">_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">word_fmt</tt> </tt> +<a name="L719"></a><tt class="py-lineno">719</tt> <tt class="py-line"> </tt> +<a name="L720"></a><tt class="py-lineno">720</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-109" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_int" class="py-name" href="#" onclick="return doclink('link-109', 'valid_int', 'link-53');">valid_int</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L721"></a><tt class="py-lineno">721</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a valid integer value supported '</tt> \ </tt> +<a name="L722"></a><tt class="py-lineno">722</tt> <tt class="py-line"> <tt class="py-string">'by this address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> +<a name="L723"></a><tt class="py-lineno">723</tt> <tt class="py-line"> </tt> +<a name="L724"></a><tt class="py-lineno">724</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L725"></a><tt class="py-lineno">725</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">num_words</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L726"></a><tt class="py-lineno">726</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-op">(</tt><tt class="py-number">2</tt> <tt class="py-op">**</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> <tt class="py-op">-</tt> <tt class="py-number">1</tt><tt class="py-op">)</tt> </tt> +<a name="L727"></a><tt class="py-lineno">727</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">+=</tt> <tt class="py-op">[</tt><tt class="py-name">_word_fmt</tt> <tt class="py-op">%</tt> <tt class="py-name">word</tt><tt class="py-op">]</tt> </tt> +<a name="L728"></a><tt class="py-lineno">728</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_size</tt> </tt> +<a name="L729"></a><tt class="py-lineno">729</tt> <tt class="py-line"> </tt> +<a name="L730"></a><tt class="py-lineno">730</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L731"></a><tt class="py-lineno">731</tt> <tt class="py-line"> </tt> +<a name="L732"></a><tt class="py-lineno">732</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">compact</tt> <tt class="py-op">==</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L733"></a><tt class="py-lineno">733</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L734"></a><tt class="py-lineno">734</tt> <tt class="py-line"> </tt> +<a name="L735"></a><tt class="py-lineno">735</tt> <tt class="py-line"> <tt class="py-name">positions</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L736"></a><tt class="py-lineno">736</tt> <tt class="py-line"> <tt class="py-name">within_run</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L737"></a><tt class="py-lineno">737</tt> <tt class="py-line"> <tt class="py-name">start_index</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L738"></a><tt class="py-lineno">738</tt> <tt class="py-line"> <tt class="py-name">num_tokens</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> +<a name="L739"></a><tt class="py-lineno">739</tt> <tt class="py-line"> </tt> +<a name="L740"></a><tt class="py-lineno">740</tt> <tt class="py-line"> <tt class="py-comment"># Discover all runs of zeros.</tt> </tt> +<a name="L741"></a><tt class="py-lineno">741</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">for</tt> <tt class="py-name">idx</tt><tt class="py-op">,</tt> <tt class="py-name">token</tt> <tt class="py-keyword">in</tt> <tt class="py-name">enumerate</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L742"></a><tt class="py-lineno">742</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">token</tt> <tt class="py-op">==</tt> <tt class="py-string">'0'</tt><tt class="py-op">:</tt> </tt> +<a name="L743"></a><tt class="py-lineno">743</tt> <tt class="py-line"> <tt class="py-name">within_run</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L744"></a><tt class="py-lineno">744</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">start_index</tt> <tt class="py-keyword">is</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L745"></a><tt class="py-lineno">745</tt> <tt class="py-line"> <tt class="py-name">start_index</tt> <tt class="py-op">=</tt> <tt class="py-name">idx</tt> </tt> +<a name="L746"></a><tt class="py-lineno">746</tt> <tt class="py-line"> <tt class="py-name">num_tokens</tt> <tt class="py-op">+=</tt> <tt class="py-number">1</tt> </tt> +<a name="L747"></a><tt class="py-lineno">747</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L748"></a><tt class="py-lineno">748</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">num_tokens</tt> <tt class="py-op">></tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt> +<a name="L749"></a><tt class="py-lineno">749</tt> <tt class="py-line"> <tt class="py-name">positions</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">num_tokens</tt><tt class="py-op">,</tt> <tt class="py-name">start_index</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L750"></a><tt class="py-lineno">750</tt> <tt class="py-line"> <tt class="py-name">within_run</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L751"></a><tt class="py-lineno">751</tt> <tt class="py-line"> <tt class="py-name">start_index</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L752"></a><tt class="py-lineno">752</tt> <tt class="py-line"> <tt class="py-name">num_tokens</tt> <tt class="py-op">=</tt> <tt class="py-number">0</tt> </tt> +<a name="L753"></a><tt class="py-lineno">753</tt> <tt class="py-line"> </tt> +<a name="L754"></a><tt class="py-lineno">754</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">token</tt><tt class="py-op">)</tt> </tt> +<a name="L755"></a><tt class="py-lineno">755</tt> <tt class="py-line"> </tt> +<a name="L756"></a><tt class="py-lineno">756</tt> <tt class="py-line"> <tt class="py-comment"># Store any position not saved before loop exit.</tt> </tt> +<a name="L757"></a><tt class="py-lineno">757</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">num_tokens</tt> <tt class="py-op">></tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt> +<a name="L758"></a><tt class="py-lineno">758</tt> <tt class="py-line"> <tt class="py-name">positions</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-op">(</tt><tt class="py-name">num_tokens</tt><tt class="py-op">,</tt> <tt class="py-name">start_index</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L759"></a><tt class="py-lineno">759</tt> <tt class="py-line"> </tt> +<a name="L760"></a><tt class="py-lineno">760</tt> <tt class="py-line"> <tt class="py-comment"># Replace first longest run with an empty string.</tt> </tt> +<a name="L761"></a><tt class="py-lineno">761</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">positions</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L762"></a><tt class="py-lineno">762</tt> <tt class="py-line"> <tt class="py-comment"># Locate longest, left-most run of zeros.</tt> </tt> +<a name="L763"></a><tt class="py-lineno">763</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">positions</tt><tt class="py-op">.</tt><tt class="py-name">sort</tt><tt class="py-op">(</tt><tt class="py-keyword">lambda</tt> <tt class="py-name">x</tt><tt class="py-op">,</tt> <tt class="py-name">y</tt><tt class="py-op">:</tt> <tt class="py-name">cmp</tt><tt class="py-op">(</tt><tt class="py-name">x</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">y</tt><tt class="py-op">[</tt><tt class="py-number">1</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L764"></a><tt class="py-lineno">764</tt> <tt class="py-line"> <tt class="py-name">best_position</tt> <tt class="py-op">=</tt> <tt class="py-name">positions</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L765"></a><tt class="py-lineno">765</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">position</tt> <tt class="py-keyword">in</tt> <tt class="py-name">positions</tt><tt class="py-op">:</tt> </tt> +<a name="L766"></a><tt class="py-lineno">766</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">position</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">></tt> <tt class="py-name">best_position</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">:</tt> </tt> +<a name="L767"></a><tt class="py-lineno">767</tt> <tt class="py-line"> <tt class="py-name">best_position</tt> <tt class="py-op">=</tt> <tt class="py-name">position</tt> </tt> +<a name="L768"></a><tt class="py-lineno">768</tt> <tt class="py-line"> <tt class="py-comment"># Replace chosen zero run.</tt> </tt> +<a name="L769"></a><tt class="py-lineno">769</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-op">(</tt><tt class="py-name">length</tt><tt class="py-op">,</tt> <tt class="py-name">start_idx</tt><tt class="py-op">)</tt> <tt class="py-op">=</tt> <tt class="py-name">best_position</tt> </tt> +<a name="L770"></a><tt class="py-lineno">770</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">new_tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">:</tt><tt class="py-name">start_idx</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">''</tt><tt class="py-op">]</tt> <tt class="py-op">+</tt> \ </tt> +<a name="L771"></a><tt class="py-lineno">771</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt><tt class="py-op">[</tt><tt class="py-name">start_idx</tt><tt class="py-op">+</tt><tt class="py-name">length</tt><tt class="py-op">:</tt><tt class="py-op">]</tt> </tt> +<a name="L772"></a><tt class="py-lineno">772</tt> <tt class="py-line"> </tt> +<a name="L773"></a><tt class="py-lineno">773</tt> <tt class="py-line"> <tt class="py-comment"># Add start and end blanks so join creates '::'.</tt> </tt> +<a name="L774"></a><tt class="py-lineno">774</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-keyword">if</tt> <tt class="py-name">new_tokens</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L775"></a><tt class="py-lineno">775</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt><tt class="py-op">.</tt><tt class="py-name">insert</tt><tt class="py-op">(</tt><tt class="py-number">0</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> +<a name="L776"></a><tt class="py-lineno">776</tt> <tt class="py-line"> </tt> +<a name="L777"></a><tt class="py-lineno">777</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">new_tokens</tt><tt class="py-op">[</tt><tt class="py-op">-</tt><tt class="py-number">1</tt><tt class="py-op">]</tt> <tt class="py-op">==</tt> <tt class="py-string">''</tt><tt class="py-op">:</tt> </tt> +<a name="L778"></a><tt class="py-lineno">778</tt> <tt class="py-line"> <tt class="py-name">new_tokens</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">)</tt> </tt> +<a name="L779"></a><tt class="py-lineno">779</tt> <tt class="py-line"> </tt> +<a name="L780"></a><tt class="py-lineno">780</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">new_tokens</tt> </tt> +<a name="L781"></a><tt class="py-lineno">781</tt> <tt class="py-line"> </tt> +<a name="L782"></a><tt class="py-lineno">782</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> +</div><a name="L783"></a><tt class="py-lineno">783</tt> <tt class="py-line"> </tt> +<a name="IPv6Strategy.int_to_arpa"></a><div id="IPv6Strategy.int_to_arpa-def"><a name="L784"></a><tt class="py-lineno">784</tt> <a class="py-toggle" href="#" id="IPv6Strategy.int_to_arpa-toggle" onclick="return toggle('IPv6Strategy.int_to_arpa');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.IPv6Strategy-class.html#int_to_arpa">int_to_arpa</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="IPv6Strategy.int_to_arpa-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="IPv6Strategy.int_to_arpa-expanded"><a name="L785"></a><tt class="py-lineno">785</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L786"></a><tt class="py-lineno">786</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L787"></a><tt class="py-lineno">787</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L788"></a><tt class="py-lineno">788</tt> <tt class="py-line"><tt class="py-docstring"> @return: The reverse DNS lookup for an IPv6 address in network byte</tt> </tt> +<a name="L789"></a><tt class="py-lineno">789</tt> <tt class="py-line"><tt class="py-docstring"> order integer form.</tt> </tt> +<a name="L790"></a><tt class="py-lineno">790</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L791"></a><tt class="py-lineno">791</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-110" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_str netaddr.strategy.EUI48Strategy.int_to_str netaddr.strategy.IPv4StrategyOpt.int_to_str -netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-104', 'int_to_str', 'link-102');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">,</tt> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%04x'</tt><tt class="py-op">)</tt> </tt> -<a name="L754"></a><tt class="py-lineno">754</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L755"></a><tt class="py-lineno">755</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L756"></a><tt class="py-lineno">756</tt> <tt class="py-line"> <tt class="py-comment"># We won't support ip6.int here - see RFC 3152 for details.</tt> </tt> -<a name="L757"></a><tt class="py-lineno">757</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'ip6'</tt><tt class="py-op">,</tt> <tt class="py-string">'arpa'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">]</tt> </tt> -<a name="L758"></a><tt class="py-lineno">758</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -</div></div><a name="L759"></a><tt class="py-lineno">759</tt> <tt class="py-line"> </tt> -<a name="L760"></a><tt class="py-lineno">760</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="EUI48Strategy"></a><div id="EUI48Strategy-def"><a name="L761"></a><tt class="py-lineno">761</tt> <a class="py-toggle" href="#" id="EUI48Strategy-toggle" onclick="return toggle('EUI48Strategy');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a><tt class="py-op">(</tt><tt class="py-base-class">AddrStrategy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI48Strategy-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="EUI48Strategy-expanded"><a name="L762"></a><tt class="py-lineno">762</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L763"></a><tt class="py-lineno">763</tt> <tt class="py-line"><tt class="py-docstring"> Implements the operations that can be performed on an IEEE 48-bit EUI</tt> </tt> -<a name="L764"></a><tt class="py-lineno">764</tt> <tt class="py-line"><tt class="py-docstring"> (Extended Unique Identifer). For all intents and purposes here, a MAC</tt> </tt> -<a name="L765"></a><tt class="py-lineno">765</tt> <tt class="py-line"><tt class="py-docstring"> address.</tt> </tt> -<a name="L766"></a><tt class="py-lineno">766</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L767"></a><tt class="py-lineno">767</tt> <tt class="py-line"><tt class="py-docstring"> Supports most common MAC address formats including Cisco's string format.</tt> </tt> -<a name="L768"></a><tt class="py-lineno">768</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="EUI48Strategy.__init__"></a><div id="EUI48Strategy.__init__-def"><a name="L769"></a><tt class="py-lineno">769</tt> <a class="py-toggle" href="#" id="EUI48Strategy.__init__-toggle" onclick="return toggle('EUI48Strategy.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI48Strategy.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.__init__-expanded"><a name="L770"></a><tt class="py-lineno">770</tt> <tt class="py-line"> <tt class="py-docstring">"""Constructor."""</tt> </tt> -<a name="L771"></a><tt class="py-lineno">771</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-105" class="py-name"><a title="netaddr.address.Addr.__init__ -netaddr.address.AddrRange.__init__ +netaddr.strategy.IPv6Strategy.int_to_str" class="py-name" href="#" onclick="return doclink('link-110', 'int_to_str', 'link-108');">int_to_str</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">,</tt> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%04x'</tt><tt class="py-op">)</tt> </tt> +<a name="L792"></a><tt class="py-lineno">792</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">list</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">replace</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> +<a name="L793"></a><tt class="py-lineno">793</tt> <tt class="py-line"> <tt class="py-name">tokens</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L794"></a><tt class="py-lineno">794</tt> <tt class="py-line"> <tt class="py-comment"># We won't support ip6.int here - see RFC 3152 for details.</tt> </tt> +<a name="L795"></a><tt class="py-lineno">795</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-name">tokens</tt> <tt class="py-op">+</tt> <tt class="py-op">[</tt><tt class="py-string">'ip6'</tt><tt class="py-op">,</tt> <tt class="py-string">'arpa'</tt><tt class="py-op">,</tt> <tt class="py-string">''</tt><tt class="py-op">]</tt> </tt> +<a name="L796"></a><tt class="py-lineno">796</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-string">'.'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L797"></a><tt class="py-lineno">797</tt> <tt class="py-line"> </tt> +<a name="L798"></a><tt class="py-lineno">798</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="EUI48Strategy"></a><div id="EUI48Strategy-def"><a name="L799"></a><tt class="py-lineno">799</tt> <a class="py-toggle" href="#" id="EUI48Strategy-toggle" onclick="return toggle('EUI48Strategy');">-</a><tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">class</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html">EUI48Strategy</a><tt class="py-op">(</tt><tt class="py-base-class">AddrStrategy</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI48Strategy-collapsed" style="display:none;" pad="+++" indent="++++"></div><div id="EUI48Strategy-expanded"><a name="L800"></a><tt class="py-lineno">800</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L801"></a><tt class="py-lineno">801</tt> <tt class="py-line"><tt class="py-docstring"> Implements the operations that can be performed on an IEEE 48-bit EUI</tt> </tt> +<a name="L802"></a><tt class="py-lineno">802</tt> <tt class="py-line"><tt class="py-docstring"> (Extended Unique Identifer) a.k.a. a MAC (Media Access Control) layer 2</tt> </tt> +<a name="L803"></a><tt class="py-lineno">803</tt> <tt class="py-line"><tt class="py-docstring"> address.</tt> </tt> +<a name="L804"></a><tt class="py-lineno">804</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L805"></a><tt class="py-lineno">805</tt> <tt class="py-line"><tt class="py-docstring"> Supports all common (and some less common MAC string formats including</tt> </tt> +<a name="L806"></a><tt class="py-lineno">806</tt> <tt class="py-line"><tt class="py-docstring"> Cisco's 'triple hextet' format and also bare MACs that contain no</tt> </tt> +<a name="L807"></a><tt class="py-lineno">807</tt> <tt class="py-line"><tt class="py-docstring"> delimiters.</tt> </tt> +<a name="L808"></a><tt class="py-lineno">808</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L809"></a><tt class="py-lineno">809</tt> <tt class="py-line"> <tt class="py-comment"># Regular expression to match the numerous different MAC formats.</tt> </tt> +<a name="L810"></a><tt class="py-lineno">810</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-111" class="py-name" targets="Variable netaddr.strategy.EUI48Strategy.RE_MAC_FORMATS=netaddr.strategy.EUI48Strategy-class.html#RE_MAC_FORMATS"><a title="netaddr.strategy.EUI48Strategy.RE_MAC_FORMATS" class="py-name" href="#" onclick="return doclink('link-111', 'RE_MAC_FORMATS', 'link-111');">RE_MAC_FORMATS</a></tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt> </tt> +<a name="L811"></a><tt class="py-lineno">811</tt> <tt class="py-line"> <tt class="py-comment"># 2 bytes x 6 (UNIX, Windows, EUI-48)</tt> </tt> +<a name="L812"></a><tt class="py-lineno">812</tt> <tt class="py-line"> <tt class="py-string">'^'</tt> <tt class="py-op">+</tt> <tt class="py-string">':'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'([0-9A-F]{1,2})'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">6</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">'$'</tt><tt class="py-op">,</tt> </tt> +<a name="L813"></a><tt class="py-lineno">813</tt> <tt class="py-line"> <tt class="py-string">'^'</tt> <tt class="py-op">+</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'([0-9A-F]{1,2})'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">6</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">'$'</tt><tt class="py-op">,</tt> </tt> +<a name="L814"></a><tt class="py-lineno">814</tt> <tt class="py-line"> </tt> +<a name="L815"></a><tt class="py-lineno">815</tt> <tt class="py-line"> <tt class="py-comment"># 4 bytes x 3 (Cisco)</tt> </tt> +<a name="L816"></a><tt class="py-lineno">816</tt> <tt class="py-line"> <tt class="py-string">'^'</tt> <tt class="py-op">+</tt> <tt class="py-string">':'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'([0-9A-F]{1,4})'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">3</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">'$'</tt><tt class="py-op">,</tt> </tt> +<a name="L817"></a><tt class="py-lineno">817</tt> <tt class="py-line"> <tt class="py-string">'^'</tt> <tt class="py-op">+</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'([0-9A-F]{1,4})'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">3</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">'$'</tt><tt class="py-op">,</tt> </tt> +<a name="L818"></a><tt class="py-lineno">818</tt> <tt class="py-line"> </tt> +<a name="L819"></a><tt class="py-lineno">819</tt> <tt class="py-line"> <tt class="py-comment"># 6 bytes x 2 (PostgreSQL)</tt> </tt> +<a name="L820"></a><tt class="py-lineno">820</tt> <tt class="py-line"> <tt class="py-string">'^'</tt> <tt class="py-op">+</tt> <tt class="py-string">'-'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'([0-9A-F]{5,6})'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">'$'</tt><tt class="py-op">,</tt> </tt> +<a name="L821"></a><tt class="py-lineno">821</tt> <tt class="py-line"> <tt class="py-string">'^'</tt> <tt class="py-op">+</tt> <tt class="py-string">':'</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'([0-9A-F]{5,6})'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">2</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">'$'</tt><tt class="py-op">,</tt> </tt> +<a name="L822"></a><tt class="py-lineno">822</tt> <tt class="py-line"> </tt> +<a name="L823"></a><tt class="py-lineno">823</tt> <tt class="py-line"> <tt class="py-comment"># 12 bytes (bare, no delimiters)</tt> </tt> +<a name="L824"></a><tt class="py-lineno">824</tt> <tt class="py-line"> <tt class="py-string">'^('</tt> <tt class="py-op">+</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'[0-9A-F]'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">12</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">')$'</tt><tt class="py-op">,</tt> </tt> +<a name="L825"></a><tt class="py-lineno">825</tt> <tt class="py-line"> <tt class="py-string">'^('</tt> <tt class="py-op">+</tt> <tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'[0-9A-F]'</tt><tt class="py-op">]</tt> <tt class="py-op">*</tt> <tt class="py-number">11</tt><tt class="py-op">)</tt> <tt class="py-op">+</tt> <tt class="py-string">')$'</tt><tt class="py-op">,</tt> </tt> +<a name="L826"></a><tt class="py-lineno">826</tt> <tt class="py-line"> <tt class="py-op">)</tt> </tt> +<a name="L827"></a><tt class="py-lineno">827</tt> <tt class="py-line"> <tt class="py-comment"># For efficiency, replace each string regexp with its compiled</tt> </tt> +<a name="L828"></a><tt class="py-lineno">828</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-comment"># equivalent.</tt> </tt> +<a name="L829"></a><tt class="py-lineno">829</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt id="link-112" class="py-name"><a title="netaddr.strategy.EUI48Strategy.RE_MAC_FORMATS" class="py-name" href="#" onclick="return doclink('link-112', 'RE_MAC_FORMATS', 'link-111');">RE_MAC_FORMATS</a></tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">_re</tt><tt class="py-op">.</tt><tt class="py-name">compile</tt><tt class="py-op">(</tt><tt id="link-113" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-113', '_', 'link-54');">_</a></tt><tt class="py-op">,</tt> <tt class="py-name">_re</tt><tt class="py-op">.</tt><tt class="py-name">IGNORECASE</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt id="link-114" class="py-name"><a title="netaddr.address.IP._ +netaddr.strategy.EUI48Strategy._" class="py-name" href="#" onclick="return doclink('link-114', '_', 'link-54');">_</a></tt> <tt class="py-keyword">in</tt> <tt id="link-115" class="py-name"><a title="netaddr.strategy.EUI48Strategy.RE_MAC_FORMATS" class="py-name" href="#" onclick="return doclink('link-115', 'RE_MAC_FORMATS', 'link-111');">RE_MAC_FORMATS</a></tt><tt class="py-op">]</tt> </tt> +<a name="L830"></a><tt class="py-lineno">830</tt> <tt class="py-line"> </tt> +<a name="EUI48Strategy.__init__"></a><div id="EUI48Strategy.__init__-def"><a name="L831"></a><tt class="py-lineno">831</tt> <a class="py-toggle" href="#" id="EUI48Strategy.__init__-toggle" onclick="return toggle('EUI48Strategy.__init__');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#__init__">__init__</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%02x'</tt><tt class="py-op">,</tt> <tt class="py-param">word_sep</tt><tt class="py-op">=</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-param">uppercase</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI48Strategy.__init__-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.__init__-expanded"><a name="L832"></a><tt class="py-lineno">832</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L833"></a><tt class="py-lineno">833</tt> <tt class="py-line"><tt class="py-docstring"> Constructor.</tt> </tt> +<a name="L834"></a><tt class="py-lineno">834</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L835"></a><tt class="py-lineno">835</tt> <tt class="py-line"><tt class="py-docstring"> @param word_sep: separator between each word.</tt> </tt> +<a name="L836"></a><tt class="py-lineno">836</tt> <tt class="py-line"><tt class="py-docstring"> (Default: '-')</tt> </tt> +<a name="L837"></a><tt class="py-lineno">837</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L838"></a><tt class="py-lineno">838</tt> <tt class="py-line"><tt class="py-docstring"> @param word_fmt: format string for each hextet.</tt> </tt> +<a name="L839"></a><tt class="py-lineno">839</tt> <tt class="py-line"><tt class="py-docstring"> (Default: '%02x')</tt> </tt> +<a name="L840"></a><tt class="py-lineno">840</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L841"></a><tt class="py-lineno">841</tt> <tt class="py-line"><tt class="py-docstring"> @param uppercase: return uppercase MAC/EUI-48 addresses.</tt> </tt> +<a name="L842"></a><tt class="py-lineno">842</tt> <tt class="py-line"><tt class="py-docstring"> (Default: True)</tt> </tt> +<a name="L843"></a><tt class="py-lineno">843</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L844"></a><tt class="py-lineno">844</tt> <tt class="py-line"> <tt class="py-name">super</tt><tt class="py-op">(</tt><tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">__class__</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">)</tt><tt class="py-op">.</tt><tt id="link-116" class="py-name"><a title="netaddr.address.Addr.__init__ netaddr.address.AddrTypeDescriptor.__init__ netaddr.address.AddrValueDescriptor.__init__ netaddr.address.CIDR.__init__ netaddr.address.EUI.__init__ +netaddr.address.FormatDescriptor.__init__ netaddr.address.IP.__init__ -netaddr.address.KlassDescriptor.__init__ +netaddr.address.IPRange.__init__ +netaddr.address.IPRangeSet.__init__ netaddr.address.PrefixLenDescriptor.__init__ netaddr.address.StrategyDescriptor.__init__ netaddr.address.Wildcard.__init__ +netaddr.core.PrettyPrinter.__init__ +netaddr.core.Publisher.__init__ +netaddr.eui.FileIndexer.__init__ +netaddr.eui.IAB.__init__ +netaddr.eui.IABIndexParser.__init__ +netaddr.eui.OUI.__init__ +netaddr.eui.OUIIndexParser.__init__ +netaddr.ip.DictUpdater.__init__ +netaddr.ip.IPv4Parser.__init__ +netaddr.ip.IPv6Parser.__init__ +netaddr.ip.LineRecordParser.__init__ +netaddr.ip.MulticastParser.__init__ netaddr.strategy.AddrStrategy.__init__ netaddr.strategy.EUI48Strategy.__init__ netaddr.strategy.IPv4StrategyOpt.__init__ netaddr.strategy.IPv4StrategyStd.__init__ -netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-105', '__init__', 'link-62');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-106" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.strategy.IPv6Strategy.__init__" class="py-name" href="#" onclick="return doclink('link-116', '__init__', 'link-68');">__init__</a></tt><tt class="py-op">(</tt><tt id="link-117" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-106', 'addr_type', 'link-16');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-107" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-107', 'AT_LINK', 'link-7');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">48</tt><tt class="py-op">,</tt> </tt> -<a name="L772"></a><tt class="py-lineno">772</tt> <tt class="py-line"> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">8</tt><tt class="py-op">,</tt> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%02x'</tt><tt class="py-op">,</tt> <tt class="py-name">delimiter</tt><tt class="py-op">=</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-name">to_upper</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt> -</div><a name="L773"></a><tt class="py-lineno">773</tt> <tt class="py-line"> </tt> -<a name="EUI48Strategy.valid_str"></a><div id="EUI48Strategy.valid_str-def"><a name="L774"></a><tt class="py-lineno">774</tt> <a class="py-toggle" href="#" id="EUI48Strategy.valid_str-toggle" onclick="return toggle('EUI48Strategy.valid_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#valid_str">valid_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI48Strategy.valid_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.valid_str-expanded"><a name="L775"></a><tt class="py-lineno">775</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L776"></a><tt class="py-lineno">776</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An EUI-48 or MAC address in string form.</tt> </tt> -<a name="L777"></a><tt class="py-lineno">777</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L778"></a><tt class="py-lineno">778</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if MAC address string is valid, C{False} otherwise.</tt> </tt> -<a name="L779"></a><tt class="py-lineno">779</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L780"></a><tt class="py-lineno">780</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L781"></a><tt class="py-lineno">781</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L782"></a><tt class="py-lineno">782</tt> <tt class="py-line"> </tt> -<a name="L783"></a><tt class="py-lineno">783</tt> <tt class="py-line"> <tt class="py-keyword">try</tt><tt class="py-op">:</tt> </tt> -<a name="L784"></a><tt class="py-lineno">784</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L785"></a><tt class="py-lineno">785</tt> <tt class="py-line"> <tt class="py-comment"># Cisco style.</tt> </tt> -<a name="L786"></a><tt class="py-lineno">786</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">"0x%s"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L787"></a><tt class="py-lineno">787</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">3</tt><tt class="py-op">:</tt> </tt> -<a name="L788"></a><tt class="py-lineno">788</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L789"></a><tt class="py-lineno">789</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">:</tt> </tt> -<a name="L790"></a><tt class="py-lineno">790</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">i</tt> <tt class="py-op"><=</tt> <tt class="py-number">0xffff</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L791"></a><tt class="py-lineno">791</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L792"></a><tt class="py-lineno">792</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L793"></a><tt class="py-lineno">793</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L794"></a><tt class="py-lineno">794</tt> <tt class="py-line"> <tt class="py-comment"># Windows style.</tt> </tt> -<a name="L795"></a><tt class="py-lineno">795</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">"0x%s"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L796"></a><tt class="py-lineno">796</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">':'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L797"></a><tt class="py-lineno">797</tt> <tt class="py-line"> <tt class="py-comment"># UNIX style.</tt> </tt> -<a name="L798"></a><tt class="py-lineno">798</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">"0x%s"</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt><tt class="py-op">,</tt> <tt class="py-number">0</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt><tt class="py-op">]</tt> </tt> -<a name="L799"></a><tt class="py-lineno">799</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L800"></a><tt class="py-lineno">800</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L801"></a><tt class="py-lineno">801</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">6</tt><tt class="py-op">:</tt> </tt> -<a name="L802"></a><tt class="py-lineno">802</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L803"></a><tt class="py-lineno">803</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">:</tt> </tt> -<a name="L804"></a><tt class="py-lineno">804</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-op">(</tt><tt class="py-number">0</tt> <tt class="py-op"><=</tt> <tt class="py-name">i</tt> <tt class="py-op"><=</tt> <tt class="py-number">0xff</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L805"></a><tt class="py-lineno">805</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L806"></a><tt class="py-lineno">806</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">TypeError</tt><tt class="py-op">:</tt> </tt> -<a name="L807"></a><tt class="py-lineno">807</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L808"></a><tt class="py-lineno">808</tt> <tt class="py-line"> <tt class="py-keyword">except</tt> <tt class="py-name">ValueError</tt><tt class="py-op">:</tt> </tt> -<a name="L809"></a><tt class="py-lineno">809</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> -<a name="L810"></a><tt class="py-lineno">810</tt> <tt class="py-line"> </tt> -<a name="L811"></a><tt class="py-lineno">811</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> -</div><a name="L812"></a><tt class="py-lineno">812</tt> <tt class="py-line"> </tt> -<a name="EUI48Strategy.str_to_words"></a><div id="EUI48Strategy.str_to_words-def"><a name="L813"></a><tt class="py-lineno">813</tt> <a class="py-toggle" href="#" id="EUI48Strategy.str_to_words-toggle" onclick="return toggle('EUI48Strategy.str_to_words');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#str_to_words">str_to_words</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI48Strategy.str_to_words-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.str_to_words-expanded"><a name="L814"></a><tt class="py-lineno">814</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L815"></a><tt class="py-lineno">815</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An EUI-48 or MAC address in string form.</tt> </tt> -<a name="L816"></a><tt class="py-lineno">816</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L817"></a><tt class="py-lineno">817</tt> <tt class="py-line"><tt class="py-docstring"> Returns an integer word sequence that is equivalent in value to MAC</tt> </tt> -<a name="L818"></a><tt class="py-lineno">818</tt> <tt class="py-line"><tt class="py-docstring"> address in string form.</tt> </tt> -<a name="L819"></a><tt class="py-lineno">819</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L820"></a><tt class="py-lineno">820</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-108" class="py-name"><a title="netaddr.strategy.AddrStrategy.valid_str -netaddr.strategy.EUI48Strategy.valid_str -netaddr.strategy.IPv6Strategy.valid_str" class="py-name" href="#" onclick="return doclink('link-108', 'valid_str', 'link-49');">valid_str</a></tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L821"></a><tt class="py-lineno">821</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">ValueError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a recognised string representation'</tt> \ </tt> -<a name="L822"></a><tt class="py-lineno">822</tt> <tt class="py-line"> <tt class="py-string">' of this address type!'</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> -<a name="L823"></a><tt class="py-lineno">823</tt> <tt class="py-line"> </tt> -<a name="L824"></a><tt class="py-lineno">824</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-string">':'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L825"></a><tt class="py-lineno">825</tt> <tt class="py-line"> <tt class="py-comment"># UNIX style.</tt> </tt> -<a name="L826"></a><tt class="py-lineno">826</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">':'</tt><tt class="py-op">)</tt> </tt> -<a name="L827"></a><tt class="py-lineno">827</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-op">[</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">word</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt> <tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -<a name="L828"></a><tt class="py-lineno">828</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'-'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L829"></a><tt class="py-lineno">829</tt> <tt class="py-line"> <tt class="py-comment"># Windows style.</tt> </tt> -<a name="L830"></a><tt class="py-lineno">830</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'-'</tt><tt class="py-op">)</tt> </tt> -<a name="L831"></a><tt class="py-lineno">831</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-op">[</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">,</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_base</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">word</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt> <tt class="py-op">]</tt><tt class="py-op">)</tt> </tt> -<a name="L832"></a><tt class="py-lineno">832</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-string">'.'</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">:</tt> </tt> -<a name="L833"></a><tt class="py-lineno">833</tt> <tt class="py-line"> <tt class="py-comment"># Cisco style.</tt> </tt> -<a name="L834"></a><tt class="py-lineno">834</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L835"></a><tt class="py-lineno">835</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">num</tt> <tt class="py-keyword">in</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">split</tt><tt class="py-op">(</tt><tt class="py-string">'.'</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L836"></a><tt class="py-lineno">836</tt> <tt class="py-line"> <tt class="py-name">octets</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> -<a name="L837"></a><tt class="py-lineno">837</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">num</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> -<a name="L838"></a><tt class="py-lineno">838</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">range</tt><tt class="py-op">(</tt><tt class="py-number">2</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -<a name="L839"></a><tt class="py-lineno">839</tt> <tt class="py-line"> <tt class="py-name">word</tt> <tt class="py-op">=</tt> <tt class="py-name">int_val</tt> <tt class="py-op">&</tt> <tt class="py-number">0xff</tt> </tt> -<a name="L840"></a><tt class="py-lineno">840</tt> <tt class="py-line"> <tt class="py-name">octets</tt><tt class="py-op">.</tt><tt class="py-name">append</tt><tt class="py-op">(</tt><tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">word</tt><tt class="py-op">)</tt><tt class="py-op">)</tt> </tt> -<a name="L841"></a><tt class="py-lineno">841</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">>>=</tt> <tt class="py-number">8</tt> </tt> -<a name="L842"></a><tt class="py-lineno">842</tt> <tt class="py-line"> <tt class="py-name">octets</tt><tt class="py-op">.</tt><tt class="py-name">reverse</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L843"></a><tt class="py-lineno">843</tt> <tt class="py-line"> <tt class="py-name">words</tt><tt class="py-op">.</tt><tt class="py-name">extend</tt><tt class="py-op">(</tt><tt class="py-name">octets</tt><tt class="py-op">)</tt> </tt> -<a name="L844"></a><tt class="py-lineno">844</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">tuple</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> </tt> -</div><a name="L845"></a><tt class="py-lineno">845</tt> <tt class="py-line"> </tt> -<a name="EUI48Strategy.int_to_str"></a><div id="EUI48Strategy.int_to_str-def"><a name="L846"></a><tt class="py-lineno">846</tt> <a class="py-toggle" href="#" id="EUI48Strategy.int_to_str-toggle" onclick="return toggle('EUI48Strategy.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">,</tt> <tt class="py-param">delimiter</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">word_fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> </tt> -<a name="L847"></a><tt class="py-lineno">847</tt> <tt class="py-line"> <tt class="py-param">to_upper</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> -</div><div id="EUI48Strategy.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.int_to_str-expanded"><a name="L848"></a><tt class="py-lineno">848</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> -<a name="L849"></a><tt class="py-lineno">849</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> -<a name="L850"></a><tt class="py-lineno">850</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L851"></a><tt class="py-lineno">851</tt> <tt class="py-line"><tt class="py-docstring"> @param delimiter: (optional) A delimiter string override to be used</tt> </tt> -<a name="L852"></a><tt class="py-lineno">852</tt> <tt class="py-line"><tt class="py-docstring"> instead of the default between words in string value returned.</tt> </tt> -<a name="L853"></a><tt class="py-lineno">853</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L854"></a><tt class="py-lineno">854</tt> <tt class="py-line"><tt class="py-docstring"> @param word_fmt: (optional) A Python format string override used to</tt> </tt> -<a name="L855"></a><tt class="py-lineno">855</tt> <tt class="py-line"><tt class="py-docstring"> format each word of address instead of the default.</tt> </tt> -<a name="L856"></a><tt class="py-lineno">856</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> -<a name="L857"></a><tt class="py-lineno">857</tt> <tt class="py-line"><tt class="py-docstring"> @return: A MAC address in string form that is equivalent to value</tt> </tt> -<a name="L858"></a><tt class="py-lineno">858</tt> <tt class="py-line"><tt class="py-docstring"> represented by a network byte order integer.</tt> </tt> -<a name="L859"></a><tt class="py-lineno">859</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> -<a name="L860"></a><tt class="py-lineno">860</tt> <tt class="py-line"> <tt class="py-name">the_delimiter</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">delimiter</tt> </tt> -<a name="L861"></a><tt class="py-lineno">861</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">delimiter</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L862"></a><tt class="py-lineno">862</tt> <tt class="py-line"> <tt class="py-name">the_delimiter</tt> <tt class="py-op">=</tt> <tt class="py-name">delimiter</tt> </tt> -<a name="L863"></a><tt class="py-lineno">863</tt> <tt class="py-line"> </tt> -<a name="L864"></a><tt class="py-lineno">864</tt> <tt class="py-line"> <tt class="py-name">the_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> </tt> -<a name="L865"></a><tt class="py-lineno">865</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">word_fmt</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> -<a name="L866"></a><tt class="py-lineno">866</tt> <tt class="py-line"> <tt class="py-name">the_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">word_fmt</tt> </tt> -<a name="L867"></a><tt class="py-lineno">867</tt> <tt class="py-line"> </tt> -<a name="L868"></a><tt class="py-lineno">868</tt> <tt class="py-line"> <tt class="py-name">the_to_upper</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">to_upper</tt> </tt> -<a name="L869"></a><tt class="py-lineno">869</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">to_upper</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L870"></a><tt class="py-lineno">870</tt> <tt class="py-line"> <tt class="py-name">the_to_upper</tt> <tt class="py-op">=</tt> <tt class="py-name">to_upper</tt> </tt> -<a name="L871"></a><tt class="py-lineno">871</tt> <tt class="py-line"> </tt> -<a name="L872"></a><tt class="py-lineno">872</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-109" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words -netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-109', 'int_to_words', 'link-39');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> -<a name="L873"></a><tt class="py-lineno">873</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">the_word_fmt</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt> </tt> -<a name="L874"></a><tt class="py-lineno">874</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">the_delimiter</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> -<a name="L875"></a><tt class="py-lineno">875</tt> <tt class="py-line"> </tt> -<a name="L876"></a><tt class="py-lineno">876</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">the_to_upper</tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L877"></a><tt class="py-lineno">877</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L878"></a><tt class="py-lineno">878</tt> <tt class="py-line"> </tt> -<a name="L879"></a><tt class="py-lineno">879</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt> </tt> -</div></div><a name="L880"></a><tt class="py-lineno">880</tt> <tt class="py-line"> </tt> -<a name="L881"></a><tt class="py-lineno">881</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L882"></a><tt class="py-lineno">882</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Shared strategy objects for supported address types.</tt> </tt> -<a name="L883"></a><tt class="py-lineno">883</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L884"></a><tt class="py-lineno">884</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> -<a name="L885"></a><tt class="py-lineno">885</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on IPv4 addresses.</tt> </tt> -<a name="L886"></a><tt class="py-lineno">886</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-110" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-110', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> -<a name="L887"></a><tt class="py-lineno">887</tt> <tt class="py-line"><tt class="py-comment"># Use the right strategy class dependent upon Python implementation (work-</tt> </tt> -<a name="L888"></a><tt class="py-lineno">888</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># around for various Python bugs).</tt> </tt> -<a name="L889"></a><tt class="py-lineno">889</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">if</tt> <tt id="link-111" class="py-name"><a title="netaddr.strategy.USE_IPV4_OPT" class="py-name" href="#" onclick="return doclink('link-111', 'USE_IPV4_OPT', 'link-0');">USE_IPV4_OPT</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> -<a name="L890"></a><tt class="py-lineno">890</tt> <tt class="py-line"> <tt id="link-112" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-112', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt> <tt class="py-op">=</tt> <tt id="link-113" class="py-name"><a title="netaddr.strategy.IPv4StrategyOpt" class="py-name" href="#" onclick="return doclink('link-113', 'IPv4StrategyOpt', 'link-66');">IPv4StrategyOpt</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L891"></a><tt class="py-lineno">891</tt> <tt class="py-line"><tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> -<a name="L892"></a><tt class="py-lineno">892</tt> <tt class="py-line"> <tt id="link-114" class="py-name"><a title="netaddr.ST_IPV4 -netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-114', 'ST_IPV4', 'link-75');">ST_IPV4</a></tt> <tt class="py-op">=</tt> <tt id="link-115" class="py-name"><a title="netaddr.strategy.IPv4StrategyStd" class="py-name" href="#" onclick="return doclink('link-115', 'IPv4StrategyStd', 'link-61');">IPv4StrategyStd</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L893"></a><tt class="py-lineno">893</tt> <tt class="py-line"> </tt> -<a name="L894"></a><tt class="py-lineno">894</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on IPv6 addresses.</tt> </tt> -<a name="L895"></a><tt class="py-lineno">895</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-116" class="py-name" targets="Variable netaddr.ST_IPV6=netaddr-module.html#ST_IPV6,Variable netaddr.strategy.ST_IPV6=netaddr.strategy-module.html#ST_IPV6"><a title="netaddr.ST_IPV6 -netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-116', 'ST_IPV6', 'link-116');">ST_IPV6</a></tt> <tt class="py-op">=</tt> <tt id="link-117" class="py-name" targets="Class netaddr.strategy.IPv6Strategy=netaddr.strategy.IPv6Strategy-class.html"><a title="netaddr.strategy.IPv6Strategy" class="py-name" href="#" onclick="return doclink('link-117', 'IPv6Strategy', 'link-117');">IPv6Strategy</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L896"></a><tt class="py-lineno">896</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on EUI-48/MAC addresses.</tt> </tt> -<a name="L897"></a><tt class="py-lineno">897</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-118" class="py-name" targets="Variable netaddr.ST_EUI48=netaddr-module.html#ST_EUI48,Variable netaddr.strategy.ST_EUI48=netaddr.strategy-module.html#ST_EUI48"><a title="netaddr.ST_EUI48 -netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-118', 'ST_EUI48', 'link-118');">ST_EUI48</a></tt> <tt class="py-op">=</tt> <tt id="link-119" class="py-name" targets="Class netaddr.strategy.EUI48Strategy=netaddr.strategy.EUI48Strategy-class.html"><a title="netaddr.strategy.EUI48Strategy" class="py-name" href="#" onclick="return doclink('link-119', 'EUI48Strategy', 'link-119');">EUI48Strategy</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> -<a name="L898"></a><tt class="py-lineno">898</tt> <tt class="py-line"> </tt> -<a name="L899"></a><tt class="py-lineno">899</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on EUI-64 addresses.</tt> </tt> -<a name="L900"></a><tt class="py-lineno">900</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-120" class="py-name" targets="Variable netaddr.ST_EUI64=netaddr-module.html#ST_EUI64,Variable netaddr.strategy.ST_EUI64=netaddr.strategy-module.html#ST_EUI64"><a title="netaddr.ST_EUI64 -netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-120', 'ST_EUI64', 'link-120');">ST_EUI64</a></tt> <tt class="py-op">=</tt> <tt id="link-121" class="py-name" targets="Class netaddr.strategy.AddrStrategy=netaddr.strategy.AddrStrategy-class.html"><a title="netaddr.strategy.AddrStrategy" class="py-name" href="#" onclick="return doclink('link-121', 'AddrStrategy', 'link-121');">AddrStrategy</a></tt><tt class="py-op">(</tt><tt id="link-122" class="py-name"><a title="netaddr.address.Addr.addr_type -netaddr.address.AddrRange.addr_type +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-117', 'addr_type', 'link-18');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-118" class="py-name"><a title="netaddr.AT_LINK" class="py-name" href="#" onclick="return doclink('link-118', 'AT_LINK', 'link-7');">AT_LINK</a></tt><tt class="py-op">,</tt> <tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">48</tt><tt class="py-op">,</tt> </tt> +<a name="L845"></a><tt class="py-lineno">845</tt> <tt class="py-line"> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">8</tt><tt class="py-op">,</tt> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-name">word_fmt</tt><tt class="py-op">,</tt> <tt class="py-name">word_sep</tt><tt class="py-op">=</tt><tt class="py-name">word_sep</tt><tt class="py-op">,</tt> </tt> +<a name="L846"></a><tt class="py-lineno">846</tt> <tt class="py-line"> <tt class="py-name">uppercase</tt><tt class="py-op">=</tt><tt class="py-name">uppercase</tt><tt class="py-op">)</tt> </tt> +</div><a name="L847"></a><tt class="py-lineno">847</tt> <tt class="py-line"> </tt> +<a name="EUI48Strategy.valid_str"></a><div id="EUI48Strategy.valid_str-def"><a name="L848"></a><tt class="py-lineno">848</tt> <a class="py-toggle" href="#" id="EUI48Strategy.valid_str-toggle" onclick="return toggle('EUI48Strategy.valid_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#valid_str">valid_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI48Strategy.valid_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.valid_str-expanded"><a name="L849"></a><tt class="py-lineno">849</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L850"></a><tt class="py-lineno">850</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An EUI-48 or MAC address in string form.</tt> </tt> +<a name="L851"></a><tt class="py-lineno">851</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L852"></a><tt class="py-lineno">852</tt> <tt class="py-line"><tt class="py-docstring"> @return: C{True} if MAC address string is valid, C{False} otherwise.</tt> </tt> +<a name="L853"></a><tt class="py-lineno">853</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L854"></a><tt class="py-lineno">854</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L855"></a><tt class="py-lineno">855</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +<a name="L856"></a><tt class="py-lineno">856</tt> <tt class="py-line"> </tt> +<a name="L857"></a><tt class="py-lineno">857</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">regexp</tt> <tt class="py-keyword">in</tt> <tt id="link-119" class="py-name" targets="Class netaddr.strategy.EUI48Strategy=netaddr.strategy.EUI48Strategy-class.html"><a title="netaddr.strategy.EUI48Strategy" class="py-name" href="#" onclick="return doclink('link-119', 'EUI48Strategy', 'link-119');">EUI48Strategy</a></tt><tt class="py-op">.</tt><tt id="link-120" class="py-name"><a title="netaddr.strategy.EUI48Strategy.RE_MAC_FORMATS" class="py-name" href="#" onclick="return doclink('link-120', 'RE_MAC_FORMATS', 'link-111');">RE_MAC_FORMATS</a></tt><tt class="py-op">:</tt> </tt> +<a name="L858"></a><tt class="py-lineno">858</tt> <tt class="py-line"> <tt class="py-name">match_result</tt> <tt class="py-op">=</tt> <tt class="py-name">regexp</tt><tt class="py-op">.</tt><tt class="py-name">findall</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L859"></a><tt class="py-lineno">859</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">match_result</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L860"></a><tt class="py-lineno">860</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">True</tt> </tt> +<a name="L861"></a><tt class="py-lineno">861</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">False</tt> </tt> +</div><a name="L862"></a><tt class="py-lineno">862</tt> <tt class="py-line"> </tt> +<a name="EUI48Strategy.str_to_int"></a><div id="EUI48Strategy.str_to_int-def"><a name="L863"></a><tt class="py-lineno">863</tt> <a class="py-toggle" href="#" id="EUI48Strategy.str_to_int-toggle" onclick="return toggle('EUI48Strategy.str_to_int');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#str_to_int">str_to_int</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">addr</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI48Strategy.str_to_int-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.str_to_int-expanded"><a name="L864"></a><tt class="py-lineno">864</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L865"></a><tt class="py-lineno">865</tt> <tt class="py-line"><tt class="py-docstring"> @param addr: An EUI-48 or MAC address in string form.</tt> </tt> +<a name="L866"></a><tt class="py-lineno">866</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L867"></a><tt class="py-lineno">867</tt> <tt class="py-line"><tt class="py-docstring"> @return: A network byte order integer that is equivalent to value</tt> </tt> +<a name="L868"></a><tt class="py-lineno">868</tt> <tt class="py-line"><tt class="py-docstring"> represented by EUI-48/MAC string address.</tt> </tt> +<a name="L869"></a><tt class="py-lineno">869</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L870"></a><tt class="py-lineno">870</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-op">]</tt> </tt> +<a name="L871"></a><tt class="py-lineno">871</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">,</tt> <tt class="py-op">(</tt><tt class="py-name">str</tt><tt class="py-op">,</tt> <tt class="py-name">unicode</tt><tt class="py-op">)</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L872"></a><tt class="py-lineno">872</tt> <tt class="py-line"> <tt class="py-name">found_match</tt> <tt class="py-op">=</tt> <tt class="py-name">False</tt> </tt> +<a name="L873"></a><tt class="py-lineno">873</tt> <tt class="py-line"> <tt class="py-keyword">for</tt> <tt class="py-name">regexp</tt> <tt class="py-keyword">in</tt> <tt id="link-121" class="py-name"><a title="netaddr.strategy.EUI48Strategy" class="py-name" href="#" onclick="return doclink('link-121', 'EUI48Strategy', 'link-119');">EUI48Strategy</a></tt><tt class="py-op">.</tt><tt id="link-122" class="py-name"><a title="netaddr.strategy.EUI48Strategy.RE_MAC_FORMATS" class="py-name" href="#" onclick="return doclink('link-122', 'RE_MAC_FORMATS', 'link-111');">RE_MAC_FORMATS</a></tt><tt class="py-op">:</tt> </tt> +<a name="L874"></a><tt class="py-lineno">874</tt> <tt class="py-line"> <tt class="py-name">match_result</tt> <tt class="py-op">=</tt> <tt class="py-name">regexp</tt><tt class="py-op">.</tt><tt class="py-name">findall</tt><tt class="py-op">(</tt><tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L875"></a><tt class="py-lineno">875</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">match_result</tt><tt class="py-op">)</tt> <tt class="py-op">!=</tt> <tt class="py-number">0</tt><tt class="py-op">:</tt> </tt> +<a name="L876"></a><tt class="py-lineno">876</tt> <tt class="py-line"> <tt class="py-name">found_match</tt> <tt class="py-op">=</tt> <tt class="py-name">True</tt> </tt> +<a name="L877"></a><tt class="py-lineno">877</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">isinstance</tt><tt class="py-op">(</tt><tt class="py-name">match_result</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-name">tuple</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +<a name="L878"></a><tt class="py-lineno">878</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">match_result</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt> </tt> +<a name="L879"></a><tt class="py-lineno">879</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L880"></a><tt class="py-lineno">880</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-op">(</tt><tt class="py-name">match_result</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">,</tt><tt class="py-op">)</tt> </tt> +<a name="L881"></a><tt class="py-lineno">881</tt> <tt class="py-line"> <tt class="py-keyword">break</tt> </tt> +<a name="L882"></a><tt class="py-lineno">882</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-keyword">not</tt> <tt class="py-name">found_match</tt><tt class="py-op">:</tt> </tt> +<a name="L883"></a><tt class="py-lineno">883</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-123" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-123', 'AddrFormatError', 'link-10');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'%r is not a supported MAC format!'</tt> \ </tt> +<a name="L884"></a><tt class="py-lineno">884</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L885"></a><tt class="py-lineno">885</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L886"></a><tt class="py-lineno">886</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt class="py-name">TypeError</tt><tt class="py-op">(</tt><tt class="py-string">'%r is not str() or unicode()!'</tt> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L887"></a><tt class="py-lineno">887</tt> <tt class="py-line"> </tt> +<a name="L888"></a><tt class="py-lineno">888</tt> <tt class="py-line"> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L889"></a><tt class="py-lineno">889</tt> <tt class="py-line"> </tt> +<a name="L890"></a><tt class="py-lineno">890</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">6</tt><tt class="py-op">:</tt> </tt> +<a name="L891"></a><tt class="py-lineno">891</tt> <tt class="py-line"> <tt class="py-comment"># 2 bytes x 6 (UNIX, Windows, EUI-48)</tt> </tt> +<a name="L892"></a><tt class="py-lineno">892</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'%02x'</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">w</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">w</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L893"></a><tt class="py-lineno">893</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">3</tt><tt class="py-op">:</tt> </tt> +<a name="L894"></a><tt class="py-lineno">894</tt> <tt class="py-line"> <tt class="py-comment"># 4 bytes x 3 (Cisco)</tt> </tt> +<a name="L895"></a><tt class="py-lineno">895</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'%04x'</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">w</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">w</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L896"></a><tt class="py-lineno">896</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">2</tt><tt class="py-op">:</tt> </tt> +<a name="L897"></a><tt class="py-lineno">897</tt> <tt class="py-line"> <tt class="py-comment"># 6 bytes x 2 (PostgreSQL)</tt> </tt> +<a name="L898"></a><tt class="py-lineno">898</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">''</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-op">[</tt><tt class="py-string">'%06x'</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">w</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> <tt class="py-keyword">for</tt> <tt class="py-name">w</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L899"></a><tt class="py-lineno">899</tt> <tt class="py-line"> <tt class="py-keyword">elif</tt> <tt class="py-name">len</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">)</tt> <tt class="py-op">==</tt> <tt class="py-number">1</tt><tt class="py-op">:</tt> </tt> +<a name="L900"></a><tt class="py-lineno">900</tt> <tt class="py-line"> <tt class="py-comment"># 12 bytes (bare, no delimiters)</tt> </tt> +<a name="L901"></a><tt class="py-lineno">901</tt> <tt class="py-line"><tt class="py-comment"></tt> <tt class="py-name">int_val</tt> <tt class="py-op">=</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-string">'%012x'</tt> <tt class="py-op">%</tt> <tt class="py-name">int</tt><tt class="py-op">(</tt><tt class="py-name">words</tt><tt class="py-op">[</tt><tt class="py-number">0</tt><tt class="py-op">]</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt><tt class="py-op">,</tt> <tt class="py-number">16</tt><tt class="py-op">)</tt> </tt> +<a name="L902"></a><tt class="py-lineno">902</tt> <tt class="py-line"> <tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L903"></a><tt class="py-lineno">903</tt> <tt class="py-line"> <tt class="py-keyword">raise</tt> <tt id="link-124" class="py-name"><a title="netaddr.AddrFormatError" class="py-name" href="#" onclick="return doclink('link-124', 'AddrFormatError', 'link-10');">AddrFormatError</a></tt><tt class="py-op">(</tt><tt class="py-string">'unexpected word count in MAC address %r!'</tt> \ </tt> +<a name="L904"></a><tt class="py-lineno">904</tt> <tt class="py-line"> <tt class="py-op">%</tt> <tt class="py-name">addr</tt><tt class="py-op">)</tt> </tt> +<a name="L905"></a><tt class="py-lineno">905</tt> <tt class="py-line"> </tt> +<a name="L906"></a><tt class="py-lineno">906</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">int_val</tt> </tt> +</div><a name="L907"></a><tt class="py-lineno">907</tt> <tt class="py-line"> </tt> +<a name="EUI48Strategy.int_to_str"></a><div id="EUI48Strategy.int_to_str-def"><a name="L908"></a><tt class="py-lineno">908</tt> <a class="py-toggle" href="#" id="EUI48Strategy.int_to_str-toggle" onclick="return toggle('EUI48Strategy.int_to_str');">-</a><tt class="py-line"> <tt class="py-keyword">def</tt> <a class="py-def-name" href="netaddr.strategy.EUI48Strategy-class.html#int_to_str">int_to_str</a><tt class="py-op">(</tt><tt class="py-param">self</tt><tt class="py-op">,</tt> <tt class="py-param">int_val</tt><tt class="py-op">,</tt> <tt class="py-param">word_sep</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">,</tt> <tt class="py-param">word_fmt</tt><tt class="py-op">=</tt><tt class="py-name">None</tt><tt class="py-op">)</tt><tt class="py-op">:</tt> </tt> +</div><div id="EUI48Strategy.int_to_str-collapsed" style="display:none;" pad="+++" indent="++++++++"></div><div id="EUI48Strategy.int_to_str-expanded"><a name="L909"></a><tt class="py-lineno">909</tt> <tt class="py-line"> <tt class="py-docstring">"""</tt> </tt> +<a name="L910"></a><tt class="py-lineno">910</tt> <tt class="py-line"><tt class="py-docstring"> @param int_val: A network byte order integer.</tt> </tt> +<a name="L911"></a><tt class="py-lineno">911</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L912"></a><tt class="py-lineno">912</tt> <tt class="py-line"><tt class="py-docstring"> @param word_sep: (optional) The separator used between words in an</tt> </tt> +<a name="L913"></a><tt class="py-lineno">913</tt> <tt class="py-line"><tt class="py-docstring"> address string.</tt> </tt> +<a name="L914"></a><tt class="py-lineno">914</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L915"></a><tt class="py-lineno">915</tt> <tt class="py-line"><tt class="py-docstring"> @param word_fmt: (optional) A Python format string used to format</tt> </tt> +<a name="L916"></a><tt class="py-lineno">916</tt> <tt class="py-line"><tt class="py-docstring"> each word of address.</tt> </tt> +<a name="L917"></a><tt class="py-lineno">917</tt> <tt class="py-line"><tt class="py-docstring"></tt> </tt> +<a name="L918"></a><tt class="py-lineno">918</tt> <tt class="py-line"><tt class="py-docstring"> @return: A MAC address in string form that is equivalent to value</tt> </tt> +<a name="L919"></a><tt class="py-lineno">919</tt> <tt class="py-line"><tt class="py-docstring"> represented by a network byte order integer.</tt> </tt> +<a name="L920"></a><tt class="py-lineno">920</tt> <tt class="py-line"><tt class="py-docstring"> """</tt> </tt> +<a name="L921"></a><tt class="py-lineno">921</tt> <tt class="py-line"> <tt class="py-name">_word_sep</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_sep</tt> </tt> +<a name="L922"></a><tt class="py-lineno">922</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">word_sep</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L923"></a><tt class="py-lineno">923</tt> <tt class="py-line"> <tt class="py-name">_word_sep</tt> <tt class="py-op">=</tt> <tt class="py-name">word_sep</tt> </tt> +<a name="L924"></a><tt class="py-lineno">924</tt> <tt class="py-line"> </tt> +<a name="L925"></a><tt class="py-lineno">925</tt> <tt class="py-line"> <tt class="py-name">_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt class="py-name">word_fmt</tt> </tt> +<a name="L926"></a><tt class="py-lineno">926</tt> <tt class="py-line"> <tt class="py-keyword">if</tt> <tt class="py-name">word_fmt</tt> <tt class="py-keyword">is</tt> <tt class="py-keyword">not</tt> <tt class="py-name">None</tt><tt class="py-op">:</tt> </tt> +<a name="L927"></a><tt class="py-lineno">927</tt> <tt class="py-line"> <tt class="py-name">_word_fmt</tt> <tt class="py-op">=</tt> <tt class="py-name">word_fmt</tt> </tt> +<a name="L928"></a><tt class="py-lineno">928</tt> <tt class="py-line"> </tt> +<a name="L929"></a><tt class="py-lineno">929</tt> <tt class="py-line"> <tt class="py-name">words</tt> <tt class="py-op">=</tt> <tt class="py-name">self</tt><tt class="py-op">.</tt><tt id="link-125" class="py-name"><a title="netaddr.strategy.AddrStrategy.int_to_words +netaddr.strategy.IPv4StrategyOpt.int_to_words" class="py-name" href="#" onclick="return doclink('link-125', 'int_to_words', 'link-36');">int_to_words</a></tt><tt class="py-op">(</tt><tt class="py-name">int_val</tt><tt class="py-op">)</tt> </tt> +<a name="L930"></a><tt class="py-lineno">930</tt> <tt class="py-line"> <tt class="py-name">tokens</tt> <tt class="py-op">=</tt> <tt class="py-op">[</tt><tt class="py-name">_word_fmt</tt> <tt class="py-op">%</tt> <tt class="py-name">i</tt> <tt class="py-keyword">for</tt> <tt class="py-name">i</tt> <tt class="py-keyword">in</tt> <tt class="py-name">words</tt><tt class="py-op">]</tt> </tt> +<a name="L931"></a><tt class="py-lineno">931</tt> <tt class="py-line"> <tt class="py-name">addr</tt> <tt class="py-op">=</tt> <tt class="py-name">_word_sep</tt><tt class="py-op">.</tt><tt class="py-name">join</tt><tt class="py-op">(</tt><tt class="py-name">tokens</tt><tt class="py-op">)</tt> </tt> +<a name="L932"></a><tt class="py-lineno">932</tt> <tt class="py-line"> </tt> +<a name="L933"></a><tt class="py-lineno">933</tt> <tt class="py-line"> <tt class="py-keyword">return</tt> <tt class="py-name">addr</tt><tt class="py-op">.</tt><tt class="py-name">upper</tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +</div></div><a name="L934"></a><tt class="py-lineno">934</tt> <tt class="py-line"> </tt> +<a name="L935"></a><tt class="py-lineno">935</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L936"></a><tt class="py-lineno">936</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># Shared strategy objects for supported address types.</tt> </tt> +<a name="L937"></a><tt class="py-lineno">937</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L938"></a><tt class="py-lineno">938</tt> <tt class="py-line"><tt class="py-comment"></tt> </tt> +<a name="L939"></a><tt class="py-lineno">939</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on IPv4 addresses.</tt> </tt> +<a name="L940"></a><tt class="py-lineno">940</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-126" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-126', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt> <tt class="py-op">=</tt> <tt class="py-name">None</tt> </tt> +<a name="L941"></a><tt class="py-lineno">941</tt> <tt class="py-line"><tt class="py-comment"># Use the right strategy class dependent upon Python implementation (work-</tt> </tt> +<a name="L942"></a><tt class="py-lineno">942</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-comment"># around for various Python bugs).</tt> </tt> +<a name="L943"></a><tt class="py-lineno">943</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">if</tt> <tt id="link-127" class="py-name"><a title="netaddr.strategy.USE_IPV4_OPT" class="py-name" href="#" onclick="return doclink('link-127', 'USE_IPV4_OPT', 'link-0');">USE_IPV4_OPT</a></tt> <tt class="py-keyword">is</tt> <tt class="py-name">True</tt><tt class="py-op">:</tt> </tt> +<a name="L944"></a><tt class="py-lineno">944</tt> <tt class="py-line"> <tt id="link-128" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-128', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt> <tt class="py-op">=</tt> <tt id="link-129" class="py-name"><a title="netaddr.strategy.IPv4StrategyOpt" class="py-name" href="#" onclick="return doclink('link-129', 'IPv4StrategyOpt', 'link-72');">IPv4StrategyOpt</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L945"></a><tt class="py-lineno">945</tt> <tt class="py-line"><tt class="py-keyword">else</tt><tt class="py-op">:</tt> </tt> +<a name="L946"></a><tt class="py-lineno">946</tt> <tt class="py-line"> <tt id="link-130" class="py-name"><a title="netaddr.ST_IPV4 +netaddr.strategy.ST_IPV4" class="py-name" href="#" onclick="return doclink('link-130', 'ST_IPV4', 'link-81');">ST_IPV4</a></tt> <tt class="py-op">=</tt> <tt id="link-131" class="py-name"><a title="netaddr.strategy.IPv4StrategyStd" class="py-name" href="#" onclick="return doclink('link-131', 'IPv4StrategyStd', 'link-67');">IPv4StrategyStd</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L947"></a><tt class="py-lineno">947</tt> <tt class="py-line"> </tt> +<a name="L948"></a><tt class="py-lineno">948</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on IPv6 addresses.</tt> </tt> +<a name="L949"></a><tt class="py-lineno">949</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-132" class="py-name" targets="Variable netaddr.ST_IPV6=netaddr-module.html#ST_IPV6,Variable netaddr.strategy.ST_IPV6=netaddr.strategy-module.html#ST_IPV6"><a title="netaddr.ST_IPV6 +netaddr.strategy.ST_IPV6" class="py-name" href="#" onclick="return doclink('link-132', 'ST_IPV6', 'link-132');">ST_IPV6</a></tt> <tt class="py-op">=</tt> <tt id="link-133" class="py-name" targets="Class netaddr.strategy.IPv6Strategy=netaddr.strategy.IPv6Strategy-class.html"><a title="netaddr.strategy.IPv6Strategy" class="py-name" href="#" onclick="return doclink('link-133', 'IPv6Strategy', 'link-133');">IPv6Strategy</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L950"></a><tt class="py-lineno">950</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on EUI-48/MAC addresses.</tt> </tt> +<a name="L951"></a><tt class="py-lineno">951</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-134" class="py-name" targets="Variable netaddr.ST_EUI48=netaddr-module.html#ST_EUI48,Variable netaddr.strategy.ST_EUI48=netaddr.strategy-module.html#ST_EUI48"><a title="netaddr.ST_EUI48 +netaddr.strategy.ST_EUI48" class="py-name" href="#" onclick="return doclink('link-134', 'ST_EUI48', 'link-134');">ST_EUI48</a></tt> <tt class="py-op">=</tt> <tt id="link-135" class="py-name"><a title="netaddr.strategy.EUI48Strategy" class="py-name" href="#" onclick="return doclink('link-135', 'EUI48Strategy', 'link-119');">EUI48Strategy</a></tt><tt class="py-op">(</tt><tt class="py-op">)</tt> </tt> +<a name="L952"></a><tt class="py-lineno">952</tt> <tt class="py-line"> </tt> +<a name="L953"></a><tt class="py-lineno">953</tt> <tt class="py-line"><tt class="py-comment">#: A shared strategy object supporting all operations on EUI-64 addresses.</tt> </tt> +<a name="L954"></a><tt class="py-lineno">954</tt> <tt class="py-line"><tt class="py-comment"></tt><tt id="link-136" class="py-name" targets="Variable netaddr.ST_EUI64=netaddr-module.html#ST_EUI64,Variable netaddr.strategy.ST_EUI64=netaddr.strategy-module.html#ST_EUI64"><a title="netaddr.ST_EUI64 +netaddr.strategy.ST_EUI64" class="py-name" href="#" onclick="return doclink('link-136', 'ST_EUI64', 'link-136');">ST_EUI64</a></tt> <tt class="py-op">=</tt> <tt id="link-137" class="py-name"><a title="netaddr.strategy.AddrStrategy" class="py-name" href="#" onclick="return doclink('link-137', 'AddrStrategy', 'link-57');">AddrStrategy</a></tt><tt class="py-op">(</tt><tt id="link-138" class="py-name"><a title="netaddr.address.Addr.addr_type netaddr.address.CIDR.addr_type netaddr.address.EUI.addr_type netaddr.address.IP.addr_type -netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-122', 'addr_type', 'link-16');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-123" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-123', 'AT_EUI64', 'link-8');">AT_EUI64</a></tt><tt class="py-op">,</tt> <tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">64</tt><tt class="py-op">,</tt> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">8</tt><tt class="py-op">,</tt> </tt> -<a name="L901"></a><tt class="py-lineno">901</tt> <tt class="py-line"> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%02x'</tt><tt class="py-op">,</tt> <tt class="py-name">delimiter</tt><tt class="py-op">=</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-name">to_upper</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt> -<a name="L902"></a><tt class="py-lineno">902</tt> <tt class="py-line"> </tt> -<a name="L903"></a><tt class="py-lineno">903</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> -<a name="L904"></a><tt class="py-lineno">904</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">if</tt> <tt class="py-name">__name__</tt> <tt class="py-op">==</tt> <tt class="py-string">'__main__'</tt><tt class="py-op">:</tt> </tt> -<a name="L905"></a><tt class="py-lineno">905</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> -<a name="L906"></a><tt class="py-lineno">906</tt> <tt class="py-line"> </tt><script type="text/javascript"> +netaddr.address.IPRange.addr_type +netaddr.address.Wildcard.addr_type" class="py-name" href="#" onclick="return doclink('link-138', 'addr_type', 'link-18');">addr_type</a></tt><tt class="py-op">=</tt><tt id="link-139" class="py-name"><a title="netaddr.AT_EUI64" class="py-name" href="#" onclick="return doclink('link-139', 'AT_EUI64', 'link-8');">AT_EUI64</a></tt><tt class="py-op">,</tt> <tt class="py-name">width</tt><tt class="py-op">=</tt><tt class="py-number">64</tt><tt class="py-op">,</tt> <tt class="py-name">word_size</tt><tt class="py-op">=</tt><tt class="py-number">8</tt><tt class="py-op">,</tt> \ </tt> +<a name="L955"></a><tt class="py-lineno">955</tt> <tt class="py-line"> <tt class="py-name">word_fmt</tt><tt class="py-op">=</tt><tt class="py-string">'%02x'</tt><tt class="py-op">,</tt> <tt class="py-name">word_sep</tt><tt class="py-op">=</tt><tt class="py-string">'-'</tt><tt class="py-op">,</tt> <tt class="py-name">uppercase</tt><tt class="py-op">=</tt><tt class="py-name">True</tt><tt class="py-op">)</tt> </tt> +<a name="L956"></a><tt class="py-lineno">956</tt> <tt class="py-line"> </tt> +<a name="L957"></a><tt class="py-lineno">957</tt> <tt class="py-line"><tt class="py-comment">#-----------------------------------------------------------------------------</tt> </tt> +<a name="L958"></a><tt class="py-lineno">958</tt> <tt class="py-line"><tt class="py-comment"></tt><tt class="py-keyword">if</tt> <tt class="py-name">__name__</tt> <tt class="py-op">==</tt> <tt class="py-string">'__main__'</tt><tt class="py-op">:</tt> </tt> +<a name="L959"></a><tt class="py-lineno">959</tt> <tt class="py-line"> <tt class="py-keyword">pass</tt> </tt> +<a name="L960"></a><tt class="py-lineno">960</tt> <tt class="py-line"> </tt><script type="text/javascript"> <!-- expandto(location.href); // --> @@ -1162,7 +1288,7 @@ expandto(location.href); <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:24 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.strategy.AddrStrategy-class.html b/docs/api/netaddr.strategy.AddrStrategy-class.html index 6391c20..1d5d62b 100755 --- a/docs/api/netaddr.strategy.AddrStrategy-class.html +++ b/docs/api/netaddr.strategy.AddrStrategy-class.html @@ -73,11 +73,7 @@ object --+ </dd></dl> <hr /> -<p>Very basic support for all common operations performed on each network - type.</p> - <p>There are usually subclasses for each address type that over-ride - methods implemented here to optimise their performance and add additional - features.</p> +<p>Basic support for common operations performed on each address type</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -96,12 +92,12 @@ object --+ <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">width</span>, <span class="summary-sig-arg">word_size</span>, - <span class="summary-sig-arg">delimiter</span>, + <span class="summary-sig-arg">word_sep</span>, <span class="summary-sig-arg">word_fmt</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">%x</code><code class="variable-quote">'</code></span>, <span class="summary-sig-arg">addr_type</span>=<span class="summary-sig-default">0</span>, - <span class="summary-sig-arg">hex_words</span>=<span class="summary-sig-default">True</span>, - <span class="summary-sig-arg">to_upper</span>=<span class="summary-sig-default">False</span>)</span><br /> - x.__init__(...) initializes x; see x.__class__.__doc__ for signature</td> + <span class="summary-sig-arg">word_base</span>=<span class="summary-sig-default">16</span>, + <span class="summary-sig-arg">uppercase</span>=<span class="summary-sig-default">False</span>)</span><br /> + Constructor.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.__init__">source code</a></span> @@ -119,8 +115,7 @@ object --+ <tr> <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#__repr__" class="summary-sig-name">__repr__</a>(<span class="summary-sig-arg">self</span>)</span><br /> Returns: - An executable Python statement that can recreate an object with an - equivalent state.</td> + executable Python string to recreate equivalent object</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.__repr__">source code</a></span> @@ -176,46 +171,6 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_str" class="summary-sig-name">bits_to_str</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">bits</span>)</span><br /> - Returns: - A network address in string form that is equivalent to value - represented by network address in readable binary form.</td> - <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.bits_to_str">source code</a></span> - - </td> - </tr> - </table> - - </td> - </tr> -<tr> - <td width="15%" align="right" valign="top" class="summary"> - <span class="summary-type"> </span> - </td><td class="summary"> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_words" class="summary-sig-name">bits_to_words</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">bits</span>)</span><br /> - Returns: - An integer word sequence that is equivalent to value represented by - network address in readable binary form.</td> - <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.bits_to_words">source code</a></span> - - </td> - </tr> - </table> - - </td> - </tr> -<tr> - <td width="15%" align="right" valign="top" class="summary"> - <span class="summary-type"> </span> - </td><td class="summary"> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr> <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#valid_int" class="summary-sig-name">valid_int</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">int_val</span>)</span><br /> Returns: @@ -276,13 +231,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_words" class="summary-sig-name">int_to_words</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bin" class="summary-sig-name">int_to_bin</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">int_val</span>)</span><br /> Returns: - An integer word sequence that is equivalent to value represented by a - network byte order integer.</td> + A network address in standard binary representation format that is + equivalent to integer address value.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_words">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_bin">source code</a></span> </td> </tr> @@ -296,13 +251,12 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#valid_str" class="summary-sig-name">valid_str</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">addr</span>)</span><br /> - Returns: - <code>True</code> if network address in string form is valid for this - address type, <code>False</code> otherwise.</td> + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_words" class="summary-sig-name">int_to_words</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">int_val</span>, + <span class="summary-sig-arg">num_words</span>=<span class="summary-sig-default">None</span>, + <span class="summary-sig-arg">word_size</span>=<span class="summary-sig-default">None</span>)</span></td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_str">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_words">source code</a></span> </td> </tr> @@ -316,13 +270,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#str_to_int" class="summary-sig-name">str_to_int</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">addr</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#int_to_packed" class="summary-sig-name">int_to_packed</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">int_val</span>)</span><br /> Returns: - A network byte order integer that is equivalent to value represented - by network address in string form.</td> + a packed string that is equivalent to value represented by a network + byte order integer.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_int">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_packed">source code</a></span> </td> </tr> @@ -336,13 +290,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#str_to_bits" class="summary-sig-name">str_to_bits</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">addr</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#packed_to_int" class="summary-sig-name">packed_to_int</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">packed_int</span>)</span><br /> Returns: - A network address in readable binary form that is equivalent to value - represented by network address in string form.</td> + A network byte order integer that is equivalent to value of network + address represented by packed binary string.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_bits">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.packed_to_int">source code</a></span> </td> </tr> @@ -356,33 +310,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#str_to_words" class="summary-sig-name">str_to_words</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#valid_str" class="summary-sig-name">valid_str</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">addr</span>)</span><br /> Returns: - An integer word sequence that is equivalent in value to the network - address in string form.</td> - <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_words">source code</a></span> - - </td> - </tr> - </table> - - </td> - </tr> -<tr> - <td width="15%" align="right" valign="top" class="summary"> - <span class="summary-type"> </span> - </td><td class="summary"> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#valid_words" class="summary-sig-name">valid_words</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">words</span>)</span><br /> - Returns: - <code>True</code> if word sequence is valid for this address type, - <code>False</code> otherwise.</td> + <code>True</code> if network address in string form is valid for this + address type, <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_words">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_str">source code</a></span> </td> </tr> @@ -396,13 +330,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int" class="summary-sig-name">words_to_int</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">words</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#str_to_int" class="summary-sig-name">str_to_int</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">addr</span>)</span><br /> Returns: A network byte order integer that is equivalent to value represented - by word sequence.</td> + by network address in string form.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_int">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_int">source code</a></span> </td> </tr> @@ -416,13 +350,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#words_to_str" class="summary-sig-name">words_to_str</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#valid_words" class="summary-sig-name">valid_words</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">words</span>)</span><br /> Returns: - A network address in string form that is equivalent to value - represented by word sequence.</td> + <code>True</code> if word sequence is valid for this address type, + <code>False</code> otherwise.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_str">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_words">source code</a></span> </td> </tr> @@ -436,53 +370,13 @@ object --+ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#words_to_bits" class="summary-sig-name">words_to_bits</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int" class="summary-sig-name">words_to_int</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">words</span>)</span><br /> Returns: - A network address in readable binary form that is equivalent to value - represented by word sequence.</td> - <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_bits">source code</a></span> - - </td> - </tr> - </table> - - </td> - </tr> -<tr> - <td width="15%" align="right" valign="top" class="summary"> - <span class="summary-type"> </span> - </td><td class="summary"> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#word_to_bits" class="summary-sig-name">word_to_bits</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">int_val</span>)</span><br /> - Returns: - An integer word value for this address type in a fixed width readable - binary form.</td> - <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.word_to_bits">source code</a></span> - - </td> - </tr> - </table> - - </td> - </tr> -<tr> - <td width="15%" align="right" valign="top" class="summary"> - <span class="summary-type"> </span> - </td><td class="summary"> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.AddrStrategy-class.html#description" class="summary-sig-name">description</a>(<span class="summary-sig-arg">self</span>)</span><br /> - Returns: - String detailing setup of this <a - href="netaddr.strategy.AddrStrategy-class.html" - class="link">AddrStrategy</a> instance.</td> + A network byte order integer that is equivalent to value represented + by word sequence.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.description">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_int">source code</a></span> </td> </tr> @@ -505,6 +399,23 @@ object --+ </td> </tr> </table> +<!-- ==================== CLASS VARIABLES ==================== --> +<a name="section-ClassVariables"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Class Variables</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a name="STRUCT_FORMATS"></a><span class="summary-name">STRUCT_FORMATS</span> = <code title="{8: 'B', 16: 'H', 32: 'I'}"><code class="variable-group">{</code>8<code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">B</code><code class="variable-quote">'</code><code class="variable-op">, </code>16<code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">H</code><code class="variable-quote">'</code><code class="variable-op">, </code>32<code class="variable-op">: </code><code class="variable-quote">'</code><code class="variable-string">I</code><code class="variable-quote">'</code><code class="variable-group">}</code></code><br /> + Lookup table for struct module format strings. + </td> + </tr> +</table> <!-- ==================== PROPERTIES ==================== --> <a name="section-Properties"></a> <table class="summary" border="1" cellpadding="3" @@ -540,11 +451,11 @@ object --+ <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, <span class="sig-arg">width</span>, <span class="sig-arg">word_size</span>, - <span class="sig-arg">delimiter</span>, + <span class="sig-arg">word_sep</span>, <span class="sig-arg">word_fmt</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">%x</code><code class="variable-quote">'</code></span>, <span class="sig-arg">addr_type</span>=<span class="sig-default">0</span>, - <span class="sig-arg">hex_words</span>=<span class="sig-default">True</span>, - <span class="sig-arg">to_upper</span>=<span class="sig-default">False</span>)</span> + <span class="sig-arg">word_base</span>=<span class="sig-default">16</span>, + <span class="sig-arg">uppercase</span>=<span class="sig-default">False</span>)</span> <br /><em class="fname">(Constructor)</em> </h3> </td><td align="right" valign="top" @@ -552,12 +463,21 @@ object --+ </td> </tr></table> - <p>x.__init__(...) initializes x; see x.__class__.__doc__ for - signature</p> + <p>Constructor.</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>width</code></strong> - size of address in bits. (e.g. 32 - IPv4, 48 - MAC, 128 - IPv6)</li> + <li><strong class="pname"><code>word_size</code></strong> - size of each word. (e.g. 8 - octets, 16 - hextets)</li> + <li><strong class="pname"><code>word_sep</code></strong> - separator between each word. (e.g. '.' - IPv4, ':' - IPv6, '-' - + EUI-48)</li> + <li><strong class="pname"><code>word_fmt</code></strong> - format string for each word. (Default: '%x')</li> + <li><strong class="pname"><code>addr_type</code></strong> - address type. (Default: AT_UNSPEC)</li> + <li><strong class="pname"><code>word_base</code></strong> - number base used to convert each word using int(). (Default: 16)</li> + <li><strong class="pname"><code>uppercase</code></strong> - uppercase address. (Default: False)</li> + </ul></dd> <dt>Overrides: object.__init__ - <dd><em class="note">(inherited documentation)</em></dd> </dt> </dl> </td></tr></table> @@ -580,8 +500,7 @@ object --+ <p>repr(x)</p> <dl class="fields"> <dt>Returns:</dt> - <dd>An executable Python statement that can recreate an object with - an equivalent state.</dd> + <dd>executable Python string to recreate equivalent object</dd> <dt>Overrides: object.__repr__ </dt> @@ -642,60 +561,6 @@ object --+ </dl> </td></tr></table> </div> -<a name="bits_to_str"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">bits_to_str</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">bits</span>)</span> - </h3> - </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.bits_to_str">source code</a></span> - </td> - </tr></table> - - - <dl class="fields"> - <dt>Parameters:</dt> - <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>bits</code></strong> - A network address in readable binary form.</li> - </ul></dd> - <dt>Returns:</dt> - <dd>A network address in string form that is equivalent to value - represented by network address in readable binary form.</dd> - </dl> -</td></tr></table> -</div> -<a name="bits_to_words"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">bits_to_words</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">bits</span>)</span> - </h3> - </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.bits_to_words">source code</a></span> - </td> - </tr></table> - - - <dl class="fields"> - <dt>Parameters:</dt> - <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>bits</code></strong> - A network address in readable binary form.</li> - </ul></dd> - <dt>Returns:</dt> - <dd>An integer word sequence that is equivalent to value represented - by network address in readable binary form.</dd> - </dl> -</td></tr></table> -</div> <a name="valid_int"></a> <div> <table class="details" border="1" cellpadding="3" @@ -777,18 +642,18 @@ object --+ </dl> </td></tr></table> </div> -<a name="int_to_words"></a> +<a name="int_to_bin"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">int_to_words</span>(<span class="sig-arg">self</span>, + <h3 class="epydoc"><span class="sig"><span class="sig-name">int_to_bin</span>(<span class="sig-arg">self</span>, <span class="sig-arg">int_val</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_words">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_bin">source code</a></span> </td> </tr></table> @@ -799,23 +664,26 @@ object --+ <li><strong class="pname"><code>int_val</code></strong> - A network byte order integer.</li> </ul></dd> <dt>Returns:</dt> - <dd>An integer word sequence that is equivalent to value represented - by a network byte order integer.</dd> + <dd>A network address in standard binary representation format that + is equivalent to integer address value. Essentially a back port + of the bin() builtin in Python 2.6.x and higher.</dd> </dl> </td></tr></table> </div> -<a name="valid_str"></a> +<a name="int_to_words"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">valid_str</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">addr</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">int_to_words</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">int_val</span>, + <span class="sig-arg">num_words</span>=<span class="sig-default">None</span>, + <span class="sig-arg">word_size</span>=<span class="sig-default">None</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_str">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_words">source code</a></span> </td> </tr></table> @@ -823,26 +691,27 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>addr</code></strong> - A network address in string form.</li> + <li><strong class="pname"><code>int_val</code></strong> - A network byte order integer to be split.</li> + <li><strong class="pname"><code>num_words</code></strong> - (optional) number of words expected in return value tuple. Uses + address type default if not specified.</li> + <li><strong class="pname"><code>word_size</code></strong> - (optional) size/width of individual words (in bits). Uses address + type default if not specified.</li> </ul></dd> - <dt>Returns:</dt> - <dd><code>True</code> if network address in string form is valid for - this address type, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> -<a name="str_to_int"></a> +<a name="int_to_packed"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">str_to_int</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">addr</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">int_to_packed</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">int_val</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_int">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.int_to_packed">source code</a></span> </td> </tr></table> @@ -850,26 +719,26 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>addr</code></strong> - A network address in string form.</li> + <li><strong class="pname"><code>int_val</code></strong> - the integer to be packed.</li> </ul></dd> <dt>Returns:</dt> - <dd>A network byte order integer that is equivalent to value - represented by network address in string form.</dd> + <dd>a packed string that is equivalent to value represented by a + network byte order integer.</dd> </dl> </td></tr></table> </div> -<a name="str_to_bits"></a> +<a name="packed_to_int"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">str_to_bits</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">addr</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">packed_to_int</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">packed_int</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_bits">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.packed_to_int">source code</a></span> </td> </tr></table> @@ -877,26 +746,27 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>addr</code></strong> - A network address in string form.</li> + <li><strong class="pname"><code>packed_int</code></strong> - a packed string containing an unsigned integer. Network byte + order is assumed.</li> </ul></dd> <dt>Returns:</dt> - <dd>A network address in readable binary form that is equivalent to - value represented by network address in string form.</dd> + <dd>A network byte order integer that is equivalent to value of + network address represented by packed binary string.</dd> </dl> </td></tr></table> </div> -<a name="str_to_words"></a> +<a name="valid_str"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">str_to_words</span>(<span class="sig-arg">self</span>, + <h3 class="epydoc"><span class="sig"><span class="sig-name">valid_str</span>(<span class="sig-arg">self</span>, <span class="sig-arg">addr</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_words">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_str">source code</a></span> </td> </tr></table> @@ -907,50 +777,23 @@ object --+ <li><strong class="pname"><code>addr</code></strong> - A network address in string form.</li> </ul></dd> <dt>Returns:</dt> - <dd>An integer word sequence that is equivalent in value to the - network address in string form.</dd> - </dl> -</td></tr></table> -</div> -<a name="valid_words"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">valid_words</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">words</span>)</span> - </h3> - </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_words">source code</a></span> - </td> - </tr></table> - - - <dl class="fields"> - <dt>Parameters:</dt> - <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>words</code></strong> - A list or tuple containing integer word values.</li> - </ul></dd> - <dt>Returns:</dt> - <dd><code>True</code> if word sequence is valid for this address - type, <code>False</code> otherwise.</dd> + <dd><code>True</code> if network address in string form is valid for + this address type, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> -<a name="words_to_int"></a> +<a name="str_to_int"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">words_to_int</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">words</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">str_to_int</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">addr</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_int">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.str_to_int">source code</a></span> </td> </tr></table> @@ -958,26 +801,26 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>words</code></strong> - A list or tuple containing integer word values.</li> + <li><strong class="pname"><code>addr</code></strong> - A network address in string form.</li> </ul></dd> <dt>Returns:</dt> <dd>A network byte order integer that is equivalent to value - represented by word sequence.</dd> + represented by network address in string form.</dd> </dl> </td></tr></table> </div> -<a name="words_to_str"></a> +<a name="valid_words"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">words_to_str</span>(<span class="sig-arg">self</span>, + <h3 class="epydoc"><span class="sig"><span class="sig-name">valid_words</span>(<span class="sig-arg">self</span>, <span class="sig-arg">words</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_str">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.valid_words">source code</a></span> </td> </tr></table> @@ -985,26 +828,26 @@ object --+ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>words</code></strong> - A list or tuple containing integer word values.</li> + <li><strong class="pname"><code>words</code></strong> - A sequence containing integer word values.</li> </ul></dd> <dt>Returns:</dt> - <dd>A network address in string form that is equivalent to value - represented by word sequence.</dd> + <dd><code>True</code> if word sequence is valid for this address + type, <code>False</code> otherwise.</dd> </dl> </td></tr></table> </div> -<a name="words_to_bits"></a> +<a name="words_to_int"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">words_to_bits</span>(<span class="sig-arg">self</span>, + <h3 class="epydoc"><span class="sig"><span class="sig-name">words_to_int</span>(<span class="sig-arg">self</span>, <span class="sig-arg">words</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_bits">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.words_to_int">source code</a></span> </td> </tr></table> @@ -1015,58 +858,8 @@ object --+ <li><strong class="pname"><code>words</code></strong> - A list or tuple containing integer word values.</li> </ul></dd> <dt>Returns:</dt> - <dd>A network address in readable binary form that is equivalent to - value represented by word sequence.</dd> - </dl> -</td></tr></table> -</div> -<a name="word_to_bits"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">word_to_bits</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">int_val</span>)</span> - </h3> - </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.word_to_bits">source code</a></span> - </td> - </tr></table> - - - <dl class="fields"> - <dt>Parameters:</dt> - <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>int_val</code></strong> - An individual integer word value.</li> - </ul></dd> - <dt>Returns:</dt> - <dd>An integer word value for this address type in a fixed width - readable binary form.</dd> - </dl> -</td></tr></table> -</div> -<a name="description"></a> -<div> -<table class="details" border="1" cellpadding="3" - cellspacing="0" width="100%" bgcolor="white"> -<tr><td> - <table width="100%" cellpadding="0" cellspacing="0" border="0"> - <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">description</span>(<span class="sig-arg">self</span>)</span> - </h3> - </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#AddrStrategy.description">source code</a></span> - </td> - </tr></table> - - - <dl class="fields"> - <dt>Returns:</dt> - <dd>String detailing setup of this <a - href="netaddr.strategy.AddrStrategy-class.html" - class="link">AddrStrategy</a> instance. Useful for debugging.</dd> + <dd>A network byte order integer that is equivalent to value + represented by word sequence.</dd> </dl> </td></tr></table> </div> @@ -1102,7 +895,7 @@ object --+ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.strategy.EUI48Strategy-class.html b/docs/api/netaddr.strategy.EUI48Strategy-class.html index db52f8a..223ef67 100755 --- a/docs/api/netaddr.strategy.EUI48Strategy-class.html +++ b/docs/api/netaddr.strategy.EUI48Strategy-class.html @@ -70,10 +70,11 @@ <hr /> <p>Implements the operations that can be performed on an IEEE 48-bit EUI - (Extended Unique Identifer). For all intents and purposes here, a MAC + (Extended Unique Identifer) a.k.a. a MAC (Media Access Control) layer 2 address.</p> - <p>Supports most common MAC address formats including Cisco's string - format.</p> + <p>Supports all common (and some less common MAC string formats including + Cisco's 'triple hextet' format and also bare MACs that contain no + delimiters.</p> <!-- ==================== INSTANCE METHODS ==================== --> <a name="section-InstanceMethods"></a> @@ -89,7 +90,10 @@ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.EUI48Strategy-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>)</span><br /> + <td><span class="summary-sig"><a href="netaddr.strategy.EUI48Strategy-class.html#__init__" class="summary-sig-name">__init__</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">word_fmt</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">%02x</code><code class="variable-quote">'</code></span>, + <span class="summary-sig-arg">word_sep</span>=<span class="summary-sig-default"><code class="variable-quote">'</code><code class="variable-string">-</code><code class="variable-quote">'</code></span>, + <span class="summary-sig-arg">uppercase</span>=<span class="summary-sig-default">True</span>)</span><br /> Constructor.</td> <td align="right" valign="top"> <span class="codelink"><a href="netaddr.strategy-pysrc.html#EUI48Strategy.__init__">source code</a></span> @@ -126,13 +130,13 @@ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> - <td><span class="summary-sig"><a href="netaddr.strategy.EUI48Strategy-class.html#str_to_words" class="summary-sig-name">str_to_words</a>(<span class="summary-sig-arg">self</span>, + <td><span class="summary-sig"><a href="netaddr.strategy.EUI48Strategy-class.html#str_to_int" class="summary-sig-name">str_to_int</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">addr</span>)</span><br /> Returns: - An integer word sequence that is equivalent in value to the network - address in string form.</td> + A network byte order integer that is equivalent to value represented + by EUI-48/MAC string address.</td> <td align="right" valign="top"> - <span class="codelink"><a href="netaddr.strategy-pysrc.html#EUI48Strategy.str_to_words">source code</a></span> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#EUI48Strategy.str_to_int">source code</a></span> </td> </tr> @@ -148,9 +152,8 @@ <tr> <td><span class="summary-sig"><a href="netaddr.strategy.EUI48Strategy-class.html#int_to_str" class="summary-sig-name">int_to_str</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">int_val</span>, - <span class="summary-sig-arg">delimiter</span>=<span class="summary-sig-default">None</span>, - <span class="summary-sig-arg">word_fmt</span>=<span class="summary-sig-default">None</span>, - <span class="summary-sig-arg">to_upper</span>=<span class="summary-sig-default">True</span>)</span><br /> + <span class="summary-sig-arg">word_sep</span>=<span class="summary-sig-default">None</span>, + <span class="summary-sig-arg">word_fmt</span>=<span class="summary-sig-default">None</span>)</span><br /> Returns: A MAC address in string form that is equivalent to value represented by a network byte order integer.</td> @@ -168,20 +171,15 @@ <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: <code><a href="netaddr.strategy.AddrStrategy-class.html#__repr__">__repr__</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_str">bits_to_str</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_words">bits_to_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#description">description</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bin">int_to_bin</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_packed">int_to_packed</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_words">int_to_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_bits">str_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_int">str_to_int</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#packed_to_int">packed_to_int</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_bits">valid_bits</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_int">valid_int</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#word_to_bits">word_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_bits">words_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_str">words_to_str</a></code> + <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -196,6 +194,45 @@ </td> </tr> </table> +<!-- ==================== CLASS VARIABLES ==================== --> +<a name="section-ClassVariables"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Class Variables</span></td> +</tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.strategy.EUI48Strategy-class.html#RE_MAC_FORMATS" class="summary-name">RE_MAC_FORMATS</a> = <code title="[re.compile(r'(?i)^([0-9A-F]{1,2}):([0-9A-F]{1,2}):([0-9A-F]{1,2}):([0\ +-9A-F]{1,2}):([0-9A-F]{1,2}):([0-9A-F]{1,2})$'), + re.compile(r'(?i)^([0-9A-F]{1,2})-([0-9A-F]{1,2})-([0-9A-F]{1,2})-([0\ +-9A-F]{1,2})-([0-9A-F]{1,2})-([0-9A-F]{1,2})$'), + re.compile(r'(?i)^([0-9A-F]{1,4}):([0-9A-F]{1,4}):([0-9A-F]{1,4})$'), + re.compile(r'(?i)^([0-9A-F]{1,4})-([0-9A-F]{1,4})-([0-9A-F]{1,4})$'), + re.compile(r'(?i)^([0-9A-F]{5,6})-([0-9A-F]{5,6})$'), + re.compile(r'(?i)^([0-9A-F]{5,6}):([0-9A-F]{5,6})$'), +..."><code class="variable-group">[</code>re.compile(r'<code class="re-flags">(?i)</code>^<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{</code><code class="variable-ellipsis">...</code></code> + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <a href="netaddr.strategy.EUI48Strategy-class.html#_" class="summary-name">_</a> = <code title="'^([0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-\ +9A-F][0-9A-F][0-9A-F])$'"><code class="variable-quote">'</code><code class="variable-string">^([0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F</code><code class="variable-ellipsis">...</code></code> + </td> + </tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: + <code><a href="netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS">STRUCT_FORMATS</a></code> + </p> + </td> + </tr> +</table> <!-- ==================== PROPERTIES ==================== --> <a name="section-Properties"></a> <table class="summary" border="1" cellpadding="3" @@ -228,7 +265,10 @@ <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>)</span> + <h3 class="epydoc"><span class="sig"><span class="sig-name">__init__</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">word_fmt</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">%02x</code><code class="variable-quote">'</code></span>, + <span class="sig-arg">word_sep</span>=<span class="sig-default"><code class="variable-quote">'</code><code class="variable-string">-</code><code class="variable-quote">'</code></span>, + <span class="sig-arg">uppercase</span>=<span class="sig-default">True</span>)</span> <br /><em class="fname">(Constructor)</em> </h3> </td><td align="right" valign="top" @@ -238,6 +278,12 @@ <p>Constructor.</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>word_sep</code></strong> - separator between each word. (Default: '-')</li> + <li><strong class="pname"><code>word_fmt</code></strong> - format string for each hextet. (Default: '%02x')</li> + <li><strong class="pname"><code>uppercase</code></strong> - return uppercase MAC/EUI-48 addresses. (Default: True)</li> + </ul></dd> <dt>Overrides: object.__init__ </dt> @@ -274,18 +320,18 @@ </dl> </td></tr></table> </div> -<a name="str_to_words"></a> +<a name="str_to_int"></a> <div> <table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white"> <tr><td> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> - <h3 class="epydoc"><span class="sig"><span class="sig-name">str_to_words</span>(<span class="sig-arg">self</span>, + <h3 class="epydoc"><span class="sig"><span class="sig-name">str_to_int</span>(<span class="sig-arg">self</span>, <span class="sig-arg">addr</span>)</span> </h3> </td><td align="right" valign="top" - ><span class="codelink"><a href="netaddr.strategy-pysrc.html#EUI48Strategy.str_to_words">source code</a></span> + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#EUI48Strategy.str_to_int">source code</a></span> </td> </tr></table> @@ -293,15 +339,13 @@ <dl class="fields"> <dt>Parameters:</dt> <dd><ul class="nomargin-top"> - <li><strong class="pname"><code>addr</code></strong> - An EUI-48 or MAC address in string form. - <p>Returns an integer word sequence that is equivalent in value - to MAC address in string form.</p></li> + <li><strong class="pname"><code>addr</code></strong> - An EUI-48 or MAC address in string form.</li> </ul></dd> <dt>Returns:</dt> - <dd>An integer word sequence that is equivalent in value to the - network address in string form.</dd> + <dd>A network byte order integer that is equivalent to value + represented by EUI-48/MAC string address.</dd> <dt>Overrides: - <a href="netaddr.strategy.AddrStrategy-class.html#str_to_words">AddrStrategy.str_to_words</a> + <a href="netaddr.strategy.AddrStrategy-class.html#str_to_int">AddrStrategy.str_to_int</a> </dt> </dl> </td></tr></table> @@ -315,9 +359,8 @@ <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">int_to_str</span>(<span class="sig-arg">self</span>, <span class="sig-arg">int_val</span>, - <span class="sig-arg">delimiter</span>=<span class="sig-default">None</span>, - <span class="sig-arg">word_fmt</span>=<span class="sig-default">None</span>, - <span class="sig-arg">to_upper</span>=<span class="sig-default">True</span>)</span> + <span class="sig-arg">word_sep</span>=<span class="sig-default">None</span>, + <span class="sig-arg">word_fmt</span>=<span class="sig-default">None</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.strategy-pysrc.html#EUI48Strategy.int_to_str">source code</a></span> @@ -329,10 +372,9 @@ <dt>Parameters:</dt> <dd><ul class="nomargin-top"> <li><strong class="pname"><code>int_val</code></strong> - A network byte order integer.</li> - <li><strong class="pname"><code>delimiter</code></strong> - (optional) A delimiter string override to be used instead of the - default between words in string value returned.</li> - <li><strong class="pname"><code>word_fmt</code></strong> - (optional) A Python format string override used to format each - word of address instead of the default.</li> + <li><strong class="pname"><code>word_sep</code></strong> - (optional) The separator used between words in an address string.</li> + <li><strong class="pname"><code>word_fmt</code></strong> - (optional) A Python format string used to format each word of + address.</li> </ul></dd> <dt>Returns:</dt> <dd>A MAC address in string form that is equivalent to value @@ -344,6 +386,61 @@ </td></tr></table> </div> <br /> +<!-- ==================== CLASS VARIABLE DETAILS ==================== --> +<a name="section-ClassVariableDetails"></a> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Class Variable Details</span></td> +</tr> +</table> +<a name="RE_MAC_FORMATS"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">RE_MAC_FORMATS</h3> + + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-group">[</code>re.compile(r'<code class="re-flags">(?i)</code>^<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op"></code><span class="variable-linewrap"><img src="crarr.png" alt="\" /></span> +<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>$')<code class="variable-op">,</code> + re.compile(r'<code class="re-flags">(?i)</code>^<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op"></code><span class="variable-linewrap"><img src="crarr.png" alt="\" /></span> +<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,2}</code><code class="re-group">)</code>$')<code class="variable-op">,</code> + re.compile(r'<code class="re-flags">(?i)</code>^<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,4}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,4}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,4}</code><code class="re-group">)</code>$')<code class="variable-op">,</code> + re.compile(r'<code class="re-flags">(?i)</code>^<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,4}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,4}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{1,4}</code><code class="re-group">)</code>$')<code class="variable-op">,</code> + re.compile(r'<code class="re-flags">(?i)</code>^<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{5,6}</code><code class="re-group">)</code>-<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{5,6}</code><code class="re-group">)</code>$')<code class="variable-op">,</code> + re.compile(r'<code class="re-flags">(?i)</code>^<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{5,6}</code><code class="re-group">)</code>:<code class="re-group">(</code><code class="re-group">[</code>0<code class="re-op">-</code>9A<code class="re-op">-</code>F<code class="re-group">]</code><code class="re-op">{5,6}</code><code class="re-group">)</code>$')<code class="variable-op">,</code> +<code class="variable-ellipsis">...</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<a name="_"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <h3 class="epydoc">_</h3> + + <dl class="fields"> + </dl> + <dl class="fields"> + <dt>Value:</dt> + <dd><table><tr><td><pre class="variable"> +<code class="variable-quote">'</code><code class="variable-string">^([0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-9A-F][0-</code><span class="variable-linewrap"><img src="crarr.png" alt="\" /></span> +<code class="variable-string">9A-F][0-9A-F][0-9A-F])$</code><code class="variable-quote">'</code> +</pre></td></tr></table> +</dd> + </dl> +</td></tr></table> +</div> +<br /> <!-- ==================== NAVIGATION BAR ==================== --> <table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0"> @@ -375,7 +472,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.strategy.IPv4StrategyOpt-class.html b/docs/api/netaddr.strategy.IPv4StrategyOpt-class.html index 47d99b7..df76ba6 100644 --- a/docs/api/netaddr.strategy.IPv4StrategyOpt-class.html +++ b/docs/api/netaddr.strategy.IPv4StrategyOpt-class.html @@ -116,6 +116,26 @@ </td><td class="summary"> <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> + <td><span class="summary-sig"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#valid_str" class="summary-sig-name">valid_str</a>(<span class="summary-sig-arg">self</span>, + <span class="summary-sig-arg">addr</span>)</span><br /> + Returns: + <code>True</code> if network address in string form is valid for this + address type, <code>False</code> otherwise.</td> + <td align="right" valign="top"> + <span class="codelink"><a href="netaddr.strategy-pysrc.html#IPv4StrategyOpt.valid_str">source code</a></span> + + </td> + </tr> + </table> + + </td> + </tr> +<tr> + <td width="15%" align="right" valign="top" class="summary"> + <span class="summary-type"> </span> + </td><td class="summary"> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr> <td><span class="summary-sig"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#str_to_int" class="summary-sig-name">str_to_int</a>(<span class="summary-sig-arg">self</span>, <span class="summary-sig-arg">addr</span>)</span><br /> Returns: @@ -157,7 +177,9 @@ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr> <td><span class="summary-sig"><a href="netaddr.strategy.IPv4StrategyOpt-class.html#int_to_words" class="summary-sig-name">int_to_words</a>(<span class="summary-sig-arg">self</span>, - <span class="summary-sig-arg">int_val</span>)</span><br /> + <span class="summary-sig-arg">int_val</span>, + <span class="summary-sig-arg">num_words</span>=<span class="summary-sig-default">None</span>, + <span class="summary-sig-arg">word_size</span>=<span class="summary-sig-default">None</span>)</span><br /> Returns: An integer word (octet) sequence that is equivalent to value represented by network byte order integer.</td> @@ -198,19 +220,13 @@ <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: <code><a href="netaddr.strategy.AddrStrategy-class.html#__repr__">__repr__</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_str">bits_to_str</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_words">bits_to_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#description">description</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bin">int_to_bin</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_bits">str_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_words">str_to_words</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_packed">int_to_packed</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#packed_to_int">packed_to_int</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_bits">valid_bits</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_int">valid_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_str">valid_str</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#word_to_bits">word_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_bits">words_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_str">words_to_str</a></code> + <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -225,6 +241,22 @@ </td> </tr> </table> +<!-- ==================== CLASS VARIABLES ==================== --> +<a name="section-ClassVariables"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Class Variables</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: + <code><a href="netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS">STRUCT_FORMATS</a></code> + </p> + </td> + </tr> +</table> <!-- ==================== PROPERTIES ==================== --> <a name="section-Properties"></a> <table class="summary" border="1" cellpadding="3" @@ -267,12 +299,53 @@ <p>Constructor.</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>width</code></strong> - size of address in bits. (e.g. 32 - IPv4, 48 - MAC, 128 - IPv6)</li> + <li><strong class="pname"><code>word_size</code></strong> - size of each word. (e.g. 8 - octets, 16 - hextets)</li> + <li><strong class="pname"><code>word_sep</code></strong> - separator between each word. (e.g. '.' - IPv4, ':' - IPv6, '-' - + EUI-48)</li> + <li><strong class="pname"><code>word_fmt</code></strong> - format string for each word. (Default: '%x')</li> + <li><strong class="pname"><code>addr_type</code></strong> - address type. (Default: AT_UNSPEC)</li> + <li><strong class="pname"><code>word_base</code></strong> - number base used to convert each word using int(). (Default: 16)</li> + <li><strong class="pname"><code>uppercase</code></strong> - uppercase address. (Default: False)</li> + </ul></dd> <dt>Overrides: object.__init__ </dt> </dl> </td></tr></table> </div> +<a name="valid_str"></a> +<div> +<table class="details" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr><td> + <table width="100%" cellpadding="0" cellspacing="0" border="0"> + <tr valign="top"><td> + <h3 class="epydoc"><span class="sig"><span class="sig-name">valid_str</span>(<span class="sig-arg">self</span>, + <span class="sig-arg">addr</span>)</span> + </h3> + </td><td align="right" valign="top" + ><span class="codelink"><a href="netaddr.strategy-pysrc.html#IPv4StrategyOpt.valid_str">source code</a></span> + </td> + </tr></table> + + + <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>addr</code></strong> - An IP address in presentation (string) format.</li> + </ul></dd> + <dt>Returns:</dt> + <dd><code>True</code> if network address in string form is valid for + this address type, <code>False</code> otherwise.</dd> + <dt>Overrides: + <a href="netaddr.strategy.AddrStrategy-class.html#valid_str">AddrStrategy.valid_str</a> + </dt> + </dl> +</td></tr></table> +</div> <a name="str_to_int"></a> <div> <table class="details" border="1" cellpadding="3" @@ -341,7 +414,9 @@ <table width="100%" cellpadding="0" cellspacing="0" border="0"> <tr valign="top"><td> <h3 class="epydoc"><span class="sig"><span class="sig-name">int_to_words</span>(<span class="sig-arg">self</span>, - <span class="sig-arg">int_val</span>)</span> + <span class="sig-arg">int_val</span>, + <span class="sig-arg">num_words</span>=<span class="sig-default">None</span>, + <span class="sig-arg">word_size</span>=<span class="sig-default">None</span>)</span> </h3> </td><td align="right" valign="top" ><span class="codelink"><a href="netaddr.strategy-pysrc.html#IPv4StrategyOpt.int_to_words">source code</a></span> @@ -353,6 +428,8 @@ <dt>Parameters:</dt> <dd><ul class="nomargin-top"> <li><strong class="pname"><code>int_val</code></strong> - A network byte order integer.</li> + <li><strong class="pname"><code>num_words</code></strong> - (unused) *** interface compatibility only ***</li> + <li><strong class="pname"><code>word_size</code></strong> - (unused) *** interface compatibility only ***</li> </ul></dd> <dt>Returns:</dt> <dd>An integer word (octet) sequence that is equivalent to value @@ -425,7 +502,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.strategy.IPv4StrategyStd-class.html b/docs/api/netaddr.strategy.IPv4StrategyStd-class.html index 16d0222..ed496d4 100644 --- a/docs/api/netaddr.strategy.IPv4StrategyStd-class.html +++ b/docs/api/netaddr.strategy.IPv4StrategyStd-class.html @@ -137,23 +137,18 @@ <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: <code><a href="netaddr.strategy.AddrStrategy-class.html#__repr__">__repr__</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_str">bits_to_str</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_words">bits_to_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#description">description</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bin">int_to_bin</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_packed">int_to_packed</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_str">int_to_str</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_words">int_to_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_bits">str_to_bits</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#packed_to_int">packed_to_int</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_int">str_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_words">str_to_words</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_bits">valid_bits</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_int">valid_int</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_str">valid_str</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#word_to_bits">word_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_bits">words_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_str">words_to_str</a></code> + <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -168,6 +163,22 @@ </td> </tr> </table> +<!-- ==================== CLASS VARIABLES ==================== --> +<a name="section-ClassVariables"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Class Variables</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: + <code><a href="netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS">STRUCT_FORMATS</a></code> + </p> + </td> + </tr> +</table> <!-- ==================== PROPERTIES ==================== --> <a name="section-Properties"></a> <table class="summary" border="1" cellpadding="3" @@ -210,6 +221,17 @@ <p>Constructor.</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>width</code></strong> - size of address in bits. (e.g. 32 - IPv4, 48 - MAC, 128 - IPv6)</li> + <li><strong class="pname"><code>word_size</code></strong> - size of each word. (e.g. 8 - octets, 16 - hextets)</li> + <li><strong class="pname"><code>word_sep</code></strong> - separator between each word. (e.g. '.' - IPv4, ':' - IPv6, '-' - + EUI-48)</li> + <li><strong class="pname"><code>word_fmt</code></strong> - format string for each word. (Default: '%x')</li> + <li><strong class="pname"><code>addr_type</code></strong> - address type. (Default: AT_UNSPEC)</li> + <li><strong class="pname"><code>word_base</code></strong> - number base used to convert each word using int(). (Default: 16)</li> + <li><strong class="pname"><code>uppercase</code></strong> - uppercase address. (Default: False)</li> + </ul></dd> <dt>Overrides: object.__init__ </dt> @@ -275,7 +297,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/netaddr.strategy.IPv6Strategy-class.html b/docs/api/netaddr.strategy.IPv6Strategy-class.html index f63d6fb..34101ed 100755 --- a/docs/api/netaddr.strategy.IPv6Strategy-class.html +++ b/docs/api/netaddr.strategy.IPv6Strategy-class.html @@ -187,20 +187,15 @@ <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: <code><a href="netaddr.strategy.AddrStrategy-class.html#__repr__">__repr__</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_int">bits_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_str">bits_to_str</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#bits_to_words">bits_to_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#description">description</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bin">int_to_bin</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_bits">int_to_bits</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_packed">int_to_packed</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#int_to_words">int_to_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_bits">str_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#str_to_words">str_to_words</a></code>, + <code><a href="netaddr.strategy.AddrStrategy-class.html#packed_to_int">packed_to_int</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_bits">valid_bits</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_int">valid_int</a></code>, <code><a href="netaddr.strategy.AddrStrategy-class.html#valid_words">valid_words</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#word_to_bits">word_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_bits">words_to_bits</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a></code>, - <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_str">words_to_str</a></code> + <code><a href="netaddr.strategy.AddrStrategy-class.html#words_to_int">words_to_int</a></code> </p> <p class="indent-wrapped-lines"><b>Inherited from <code>object</code></b>: <code>__delattr__</code>, @@ -215,6 +210,22 @@ </td> </tr> </table> +<!-- ==================== CLASS VARIABLES ==================== --> +<a name="section-ClassVariables"></a> +<table class="summary" border="1" cellpadding="3" + cellspacing="0" width="100%" bgcolor="white"> +<tr bgcolor="#70b0f0" class="table-header"> + <td align="left" colspan="2" class="table-header"> + <span class="table-header">Class Variables</span></td> +</tr> + <tr> + <td colspan="2" class="summary"> + <p class="indent-wrapped-lines"><b>Inherited from <code><a href="netaddr.strategy.AddrStrategy-class.html">AddrStrategy</a></code></b>: + <code><a href="netaddr.strategy.AddrStrategy-class.html#STRUCT_FORMATS">STRUCT_FORMATS</a></code> + </p> + </td> + </tr> +</table> <!-- ==================== PROPERTIES ==================== --> <a name="section-Properties"></a> <table class="summary" border="1" cellpadding="3" @@ -257,6 +268,17 @@ <p>Constructor.</p> <dl class="fields"> + <dt>Parameters:</dt> + <dd><ul class="nomargin-top"> + <li><strong class="pname"><code>width</code></strong> - size of address in bits. (e.g. 32 - IPv4, 48 - MAC, 128 - IPv6)</li> + <li><strong class="pname"><code>word_size</code></strong> - size of each word. (e.g. 8 - octets, 16 - hextets)</li> + <li><strong class="pname"><code>word_sep</code></strong> - separator between each word. (e.g. '.' - IPv4, ':' - IPv6, '-' - + EUI-48)</li> + <li><strong class="pname"><code>word_fmt</code></strong> - format string for each word. (Default: '%x')</li> + <li><strong class="pname"><code>addr_type</code></strong> - address type. (Default: AT_UNSPEC)</li> + <li><strong class="pname"><code>word_base</code></strong> - number base used to convert each word using int(). (Default: 16)</li> + <li><strong class="pname"><code>uppercase</code></strong> - uppercase address. (Default: False)</li> + </ul></dd> <dt>Overrides: object.__init__ </dt> @@ -420,7 +442,7 @@ <table border="0" cellpadding="0" cellspacing="0" width="100%%"> <tr> <td align="left" class="footer"> - Generated by Epydoc 3.0.1 on Mon Sep 29 23:23:24 2008 + Generated by Epydoc 3.0.1 on Wed Jan 21 01:00:23 2009 </td> <td align="right" class="footer"> <a target="mainFrame" href="http://epydoc.sourceforge.net" diff --git a/docs/api/redirect.html b/docs/api/redirect.html index a7c7954..48c6c88 100755 --- a/docs/api/redirect.html +++ b/docs/api/redirect.html @@ -7,7 +7,7 @@ <body> <script type="text/javascript"> <!-- -var pages = ["netaddr.address.AddrValueDescriptor-c", "netaddr.address.PrefixLenDescriptor-c", "netaddr.address.AddrTypeDescriptor-c", "netaddr.address.StrategyDescriptor-c", "netaddr.strategy.IPv4StrategyOpt-c", "netaddr.strategy.IPv4StrategyStd-c", "netaddr.address.KlassDescriptor-c", "netaddr.strategy.EUI48Strategy-c", "netaddr.strategy.AddrStrategy-c", "netaddr.strategy.IPv6Strategy-c", "netaddr.AddrConversionError-c", "netaddr.address.AddrRange-c", "netaddr.address.Wildcard-c", "netaddr.AddrFormatError-c", "netaddr.address.Addr-c", "netaddr.address.CIDR-c", "netaddr.address.EUI-c", "netaddr.address.IP-c", "netaddr.strategy-m", "netaddr.address-m", "netaddr-m"]; +var pages = ["netaddr.address.AddrValueDescriptor-c", "netaddr.address.PrefixLenDescriptor-c", "netaddr.address.AddrTypeDescriptor-c", "netaddr.address.StrategyDescriptor-c", "netaddr.address.FormatDescriptor-c", "netaddr.strategy.IPv4StrategyOpt-c", "netaddr.strategy.IPv4StrategyStd-c", "netaddr.eui.NotRegisteredError-c", "netaddr.strategy.EUI48Strategy-c", "netaddr.strategy.AddrStrategy-c", "netaddr.strategy.IPv6Strategy-c", "netaddr.AddrConversionError-c", "netaddr.ip.LineRecordParser-c", "netaddr.address.IPRangeSet-c", "netaddr.core.PrettyPrinter-c", "netaddr.eui.IABIndexParser-c", "netaddr.eui.OUIIndexParser-c", "netaddr.ip.MulticastParser-c", "netaddr.address.Wildcard-c", "netaddr.AddrFormatError-c", "netaddr.address.IPRange-c", "netaddr.core.Subscriber-c", "netaddr.eui.FileIndexer-c", "netaddr.core.Publisher-c", "netaddr.ip.DictUpdater-c", "netaddr.ip.IPv4Parser-c", "netaddr.ip.IPv6Parser-c", "netaddr.address.Addr-c", "netaddr.address.CIDR-c", "netaddr.address.EUI-c", "netaddr.address.IP-c", "netaddr.strategy-m", "netaddr.address-m", "netaddr.eui.IAB-c", "netaddr.eui.OUI-c", "netaddr.core-m", "netaddr.misc-m", "netaddr.eui-m", "netaddr.ip-m", "netaddr-m"]; var dottedName = get_anchor(); if (dottedName) { var target = redirect_url(dottedName); diff --git a/docs/api/toc-everything.html b/docs/api/toc-everything.html index ecd1ecc..4f8b91e 100755 --- a/docs/api/toc-everything.html +++ b/docs/api/toc-everything.html @@ -15,8 +15,19 @@ <h2 class="toc">All Classes</h2> <a target="mainFrame" href="netaddr.AddrConversionError-class.html" >netaddr.AddrConversionError</a><br /> <a target="mainFrame" href="netaddr.AddrFormatError-class.html" - >netaddr.AddrFormatError</a><br /> <h2 class="toc">All Functions</h2> - <h2 class="toc">All Variables</h2> + >netaddr.AddrFormatError</a><br /> <a target="mainFrame" href="netaddr.ip.DictUpdater-class.html" + >netaddr.ip.DictUpdater</a><br /> <a target="mainFrame" href="netaddr.ip.IPv4Parser-class.html" + >netaddr.ip.IPv4Parser</a><br /> <a target="mainFrame" href="netaddr.ip.IPv6Parser-class.html" + >netaddr.ip.IPv6Parser</a><br /> <a target="mainFrame" href="netaddr.ip.LineRecordParser-class.html" + >netaddr.ip.LineRecordParser</a><br /> <a target="mainFrame" href="netaddr.ip.MulticastParser-class.html" + >netaddr.ip.MulticastParser</a><br /> <h2 class="toc">All Functions</h2> + <a target="mainFrame" href="netaddr.ip-module.html#load_iana_info" + >netaddr.ip.load_iana_info</a><br /> <a target="mainFrame" href="netaddr.ip-module.html#query" + >netaddr.ip.query</a><br /> <a target="mainFrame" href="netaddr.misc-module.html#ipv4_cidr_prefixes" + >netaddr.misc.ipv4_cidr_prefixes</a><br /> <a target="mainFrame" href="netaddr.misc-module.html#ipv6_cidr_prefixes" + >netaddr.misc.ipv6_cidr_prefixes</a><br /> <a target="mainFrame" href="netaddr.misc-module.html#print_ipv4_cidr_prefixes" + >netaddr.misc.print_ipv4_cidr_prefixes</a><br /> <a target="mainFrame" href="netaddr.misc-module.html#print_ipv6_cidr_prefixes" + >netaddr.misc.print_ipv6_cidr_prefixes</a><br /> <h2 class="toc">All Variables</h2> <a target="mainFrame" href="netaddr-module.html#AT_EUI64" >netaddr.AT_EUI64</a><br /> <a target="mainFrame" href="netaddr-module.html#AT_INET" >netaddr.AT_INET</a><br /> <a target="mainFrame" href="netaddr-module.html#AT_INET6" @@ -25,7 +36,8 @@ >netaddr.ST_EUI48</a><br /> <a target="mainFrame" href="netaddr-module.html#ST_EUI64" >netaddr.ST_EUI64</a><br /> <a target="mainFrame" href="netaddr-module.html#ST_IPV4" >netaddr.ST_IPV4</a><br /> <a target="mainFrame" href="netaddr-module.html#ST_IPV6" - >netaddr.ST_IPV6</a><br /><hr /> + >netaddr.ST_IPV6</a><br /> <a target="mainFrame" href="netaddr.ip-module.html#IANA_INFO" + >netaddr.ip.IANA_INFO</a><br /><hr /> <script type="text/javascript"> <!-- diff --git a/docs/api/toc-netaddr-module.html b/docs/api/toc-netaddr-module.html index 2a2fcd0..8459bbf 100755 --- a/docs/api/toc-netaddr-module.html +++ b/docs/api/toc-netaddr-module.html @@ -13,14 +13,17 @@ <h1 class="toc">Module netaddr</h1> <hr /> <h2 class="toc">Classes</h2> - <a target="mainFrame" href="netaddr.address.Addr-class.html" - >Addr</a><br /> <a target="mainFrame" href="netaddr.AddrConversionError-class.html" + <a target="mainFrame" href="netaddr.AddrConversionError-class.html" >AddrConversionError</a><br /> <a target="mainFrame" href="netaddr.AddrFormatError-class.html" - >AddrFormatError</a><br /> <a target="mainFrame" href="netaddr.address.AddrRange-class.html" - >AddrRange</a><br /> <a target="mainFrame" href="netaddr.address.CIDR-class.html" + >AddrFormatError</a><br /> <a target="mainFrame" href="netaddr.address.CIDR-class.html" >CIDR</a><br /> <a target="mainFrame" href="netaddr.address.EUI-class.html" - >EUI</a><br /> <a target="mainFrame" href="netaddr.address.IP-class.html" - >IP</a><br /> <a target="mainFrame" href="netaddr.address.Wildcard-class.html" + >EUI</a><br /> <a target="mainFrame" href="netaddr.eui.IAB-class.html" + >IAB</a><br /> <a target="mainFrame" href="netaddr.address.IP-class.html" + >IP</a><br /> <a target="mainFrame" href="netaddr.address.IPRange-class.html" + >IPRange</a><br /> <a target="mainFrame" href="netaddr.address.IPRangeSet-class.html" + >IPRangeSet</a><br /> <a target="mainFrame" href="netaddr.eui.NotRegisteredError-class.html" + >NotRegisteredError</a><br /> <a target="mainFrame" href="netaddr.eui.OUI-class.html" + >OUI</a><br /> <a target="mainFrame" href="netaddr.address.Wildcard-class.html" >Wildcard</a><br /> <h2 class="toc">Functions</h2> <a target="mainFrame" href="netaddr-module.html#nrange" >nrange</a><br /> <h2 class="toc">Variables</h2> diff --git a/docs/api/toc-netaddr.core-module.html b/docs/api/toc-netaddr.core-module.html new file mode 100644 index 0000000..60c0465 --- /dev/null +++ b/docs/api/toc-netaddr.core-module.html @@ -0,0 +1,28 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>core</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<h1 class="toc">Module core</h1> +<hr /> + <h2 class="toc">Classes</h2> +<hr /> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/toc-netaddr.eui-module.html b/docs/api/toc-netaddr.eui-module.html new file mode 100644 index 0000000..5d11039 --- /dev/null +++ b/docs/api/toc-netaddr.eui-module.html @@ -0,0 +1,30 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>eui</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<h1 class="toc">Module eui</h1> +<hr /> + <h2 class="toc">Classes</h2> + <h2 class="toc">Functions</h2> + <h2 class="toc">Variables</h2> +<hr /> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/toc-netaddr.ip-module.html b/docs/api/toc-netaddr.ip-module.html new file mode 100644 index 0000000..860ba5f --- /dev/null +++ b/docs/api/toc-netaddr.ip-module.html @@ -0,0 +1,38 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>ip</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<h1 class="toc">Module ip</h1> +<hr /> + <h2 class="toc">Classes</h2> + <a target="mainFrame" href="netaddr.ip.DictUpdater-class.html" + >DictUpdater</a><br /> <a target="mainFrame" href="netaddr.ip.IPv4Parser-class.html" + >IPv4Parser</a><br /> <a target="mainFrame" href="netaddr.ip.IPv6Parser-class.html" + >IPv6Parser</a><br /> <a target="mainFrame" href="netaddr.ip.LineRecordParser-class.html" + >LineRecordParser</a><br /> <a target="mainFrame" href="netaddr.ip.MulticastParser-class.html" + >MulticastParser</a><br /> <h2 class="toc">Functions</h2> + <a target="mainFrame" href="netaddr.ip-module.html#load_iana_info" + >load_iana_info</a><br /> <a target="mainFrame" href="netaddr.ip-module.html#query" + >query</a><br /> <h2 class="toc">Variables</h2> + <a target="mainFrame" href="netaddr.ip-module.html#IANA_INFO" + >IANA_INFO</a><br /><hr /> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/toc-netaddr.misc-module.html b/docs/api/toc-netaddr.misc-module.html new file mode 100644 index 0000000..00ee23a --- /dev/null +++ b/docs/api/toc-netaddr.misc-module.html @@ -0,0 +1,32 @@ +<?xml version="1.0" encoding="ascii"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> +<head> + <title>misc</title> + <link rel="stylesheet" href="epydoc.css" type="text/css" /> + <script type="text/javascript" src="epydoc.js"></script> +</head> + +<body bgcolor="white" text="black" link="blue" vlink="#204080" + alink="#204080"> +<h1 class="toc">Module misc</h1> +<hr /> + <h2 class="toc">Functions</h2> + <a target="mainFrame" href="netaddr.misc-module.html#ipv4_cidr_prefixes" + >ipv4_cidr_prefixes</a><br /> <a target="mainFrame" href="netaddr.misc-module.html#ipv6_cidr_prefixes" + >ipv6_cidr_prefixes</a><br /> <a target="mainFrame" href="netaddr.misc-module.html#print_ipv4_cidr_prefixes" + >print_ipv4_cidr_prefixes</a><br /> <a target="mainFrame" href="netaddr.misc-module.html#print_ipv6_cidr_prefixes" + >print_ipv6_cidr_prefixes</a><br /><hr /> + +<script type="text/javascript"> + <!-- + // Private objects are initially displayed (because if + // javascript is turned off then we want them to be + // visible); but by default, we want to hide them. So hide + // them unless we have a cookie that says to show them. + checkCookie(); + // --> +</script> +</body> +</html> diff --git a/docs/api/toc.html b/docs/api/toc.html index 3a311a3..bb9da0c 100755 --- a/docs/api/toc.html +++ b/docs/api/toc.html @@ -16,7 +16,9 @@ <br /> <h2 class="toc">Modules</h2> <a target="moduleFrame" href="toc-netaddr-module.html" - onclick="setFrame('toc-netaddr-module.html','netaddr-module.html');" >netaddr</a><br /><hr /> + onclick="setFrame('toc-netaddr-module.html','netaddr-module.html');" >netaddr</a><br /> <a target="moduleFrame" href="toc-netaddr.ip-module.html" + onclick="setFrame('toc-netaddr.ip-module.html','netaddr.ip-module.html');" >netaddr.ip</a><br /> <a target="moduleFrame" href="toc-netaddr.misc-module.html" + onclick="setFrame('toc-netaddr.misc-module.html','netaddr.misc-module.html');" >netaddr.misc</a><br /><hr /> <script type="text/javascript"> <!-- |