¬’ f c @ sņ d Z d Z d d l Z d Z d Z Gd d d e Z Gd d d e Z d
d Z e d d
Z
d d Z d d Z d d Z
d d Z d d Z d d Z d d Z d d Z d d Z d d! Z Gd" d# d# Z Gd$ d% d% e Z Gd& d' d' e Z Gd( d) d) e Z Gd* d+ d+ Z Gd, d- d- e e Z Gd. d/ d/ e Z Gd0 d1 d1 e e Z Gd2 d3 d3 Z Gd4 d5 d5 e e Z Gd6 d7 d7 e Z Gd8 d9 d9 e e Z d S(: u A fast, lightweight IPv4/IPv6 manipulation library in Python.
This library is used to create/poke/manipulate IPv4 and IPv6 addresses
and networks.
u 1.0i Ni i c B s | Ee Z d Z d Z d S( u AddressValueErroru% A Value Error related to the address.N( u __name__u
__module__u __qualname__u __doc__( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu AddressValueError s u AddressValueErrorc B s | Ee Z d Z d Z d S( u NetmaskValueErroru% A Value Error related to the netmask.N( u __name__u
__module__u __qualname__u __doc__( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu NetmaskValueError s u NetmaskValueErrorc C sf y t | SWn t t f k
r( Yn Xy t | SWn t t f k
rQ Yn Xt d | d S( u® Take an IP string/int and return an object of the correct type.
Args:
address: A string or integer, the IP address. Either IPv4 or
IPv6 addresses may be supplied; integers less than 2**32 will
be considered to be IPv4 by default.
Returns:
An IPv4Address or IPv6Address object.
Raises:
ValueError: if the *address* passed isn't either a v4 or a v6
address
u0 %r does not appear to be an IPv4 or IPv6 addressN( u IPv4Addressu AddressValueErroru NetmaskValueErroru IPv6Addressu
ValueError( u address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
ip_address s u
ip_addressc C sl y t | | SWn t t f k
r+ Yn Xy t | | SWn t t f k
rW Yn Xt d | d S( uŠ Take an IP string/int and return an object of the correct type.
Args:
address: A string or integer, the IP network. Either IPv4 or
IPv6 networks may be supplied; integers less than 2**32 will
be considered to be IPv4 by default.
Returns:
An IPv4Network or IPv6Network object.
Raises:
ValueError: if the string passed isn't either a v4 or a v6
address. Or if the network has host bits set.
u0 %r does not appear to be an IPv4 or IPv6 networkN( u IPv4Networku AddressValueErroru NetmaskValueErroru IPv6Networku
ValueError( u addressu strict( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
ip_network9 s u
ip_networkc C sf y t | SWn t t f k
r( Yn Xy t | SWn t t f k
rQ Yn Xt d | d S( ug Take an IP string/int and return an object of the correct type.
Args:
address: A string or integer, the IP address. Either IPv4 or
IPv6 addresses may be supplied; integers less than 2**32 will
be considered to be IPv4 by default.
Returns:
An IPv4Interface or IPv6Interface object.
Raises:
ValueError: if the string passed isn't either a v4 or a v6
address.
Notes:
The IPv?Interface classes describe an Address on a particular
Network, so they're basically a combination of both the Address
and Network classes.
u2 %r does not appear to be an IPv4 or IPv6 interfaceN( u
IPv4Interfaceu AddressValueErroru NetmaskValueErroru
IPv6Interfaceu
ValueError( u address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu ip_interfaceW s u ip_interfacec C s/ y | j d d SWn t d Yn Xd S( u` Represent an address as 4 packed bytes in network (big-endian) order.
Args:
address: An integer representation of an IPv4 IP address.
Returns:
The integer address packed as 4 bytes in network (big-endian) order.
Raises:
ValueError: If the integer is negative or too large to be an
IPv4 IP address.
i u bigu& Address negative or too large for IPv4N( u to_bytesu
ValueError( u address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu v4_int_to_packedz s u v4_int_to_packedc C s/ y | j d d SWn t d Yn Xd S( uõ Represent an address as 16 packed bytes in network (big-endian) order.
Args:
address: An integer representation of an IPv6 IP address.
Returns:
The integer address packed as 16 bytes in network (big-endian) order.
i u bigu& Address negative or too large for IPv6N( u to_bytesu
ValueError( u address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu v6_int_to_packed s
u v6_int_to_packedc C s> t | j d } t | d k r: t d | n | S( uA Helper to split the netmask and raise AddressValueError if neededu /i u Only one '/' permitted in %r( u stru splitu lenu AddressValueError( u addressu addr( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _split_optional_netmask s u _split_optional_netmaskc C sS | d } } x8 | d d
D]& } | j | j d k rD | } q Pq W| | f S( u¼ Find a sequence of IPv#Address.
Args:
addresses: a list of IPv#Address objects.
Returns:
A tuple containing the first and last IP addresses in the sequence.
i i N( u _ip( u addressesu firstu lastu ip( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _find_address_range¦ s
u _find_address_rangec C s= | d k r | Sx& t | D] } | | ?d @r | Sq W| S( uå Count the number of zero bits on the right hand side.
Args:
number: an integer.
bits: maximum number of bits to count.
Returns:
The number of zero bits on the right hand side of the number.
i i ( u range( u numberu bitsu i( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _count_righthand_zero_bits¹ s u _count_righthand_zero_bitsc c s^ t | t o t | t s- t d n | j | j k rX t d | | f n | | k rs t d n | j d k r t } n$ | j d k r£ t } n t d | j } | j } | j } x | | k rYt t
| | | | d j d } | d | | | f } | V| d | >7} | d | j k rGPn | j
| } qĶ Wd S(
u¤ Summarize a network range given the first and last IP addresses.
Example:
>>> list(summarize_address_range(IPv4Address('192.0.2.0'),
... IPv4Address('192.0.2.130')))
... #doctest: +NORMALIZE_WHITESPACE
[IPv4Network('192.0.2.0/25'), IPv4Network('192.0.2.128/31'),
IPv4Network('192.0.2.130/32')]
Args:
first: the first IPv4Address or IPv6Address in the range.
last: the last IPv4Address or IPv6Address in the range.
Returns:
An iterator of the summarized IPv(4|6) network objects.
Raise:
TypeError:
If the first and last objects are not IP addresses.
If the first and last objects are not the same version.
ValueError:
If the last object is not greater than the first.
If the version of the first address is not 4 or 6.
u1 first and last must be IP addresses, not networksu% %s and %s are not of the same versionu* last IP address must be greater than firsti i u unknown IP versioni u %s/%dN( u
isinstanceu _BaseAddressu TypeErroru versionu
ValueErroru IPv4Networku IPv6Networku _max_prefixlenu _ipu minu _count_righthand_zero_bitsu
bit_lengthu _ALL_ONESu __class__( u firstu lastu ipu ip_bitsu first_intu last_intu nbitsu net( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu summarize_address_rangeĶ s2 u summarize_address_rangec C sŲ xŃ d } g } d } x© | D]” } | s> | } | j | q | j | j k rk | j | j k rk d } q | t | j j d k rŖ | j | d <} d } q | } | j | q W| } | s | Sq d S( uv Loops through the addresses, collapsing concurrent netblocks.
Example:
ip1 = IPv4Network('192.0.2.0/26')
ip2 = IPv4Network('192.0.2.64/26')
ip3 = IPv4Network('192.0.2.128/26')
ip4 = IPv4Network('192.0.2.192/26')
_collapse_addresses_recursive([ip1, ip2, ip3, ip4]) ->
[IPv4Network('192.0.2.0/24')]
This shouldn't be called directly; it is called via
collapse_addresses([]).
Args:
addresses: A list of IPv4Network's or IPv6Network's
Returns:
A list of IPv4Network's or IPv6Network's depending on what we were
passed.
i NFTi’’’’( u Noneu Falseu appendu network_addressu broadcast_addressu Trueu listu supernetu subnets( u addressesu last_addru ret_arrayu optimizedu cur_addr( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _collapse_addresses_recursive s&
" u _collapse_addresses_recursivec
C só d } g } g } g } x3| D]+} t | t r} | rm | d j | j k rm t d | | d f n | j | q | j | j k r| rČ | d j | j k rČ t d | | d f n y | j | j WqJt k
r | j | j YqJXq | r=| d
j | j k r=t d | | d f n | j | q Wt
t | } t
t | } x[ | t | k rĻt
| | d
\ } } | j | d } | j t | | quWt t t
| | d t j S( uĖ Collapse a list of IP objects.
Example:
collapse_addresses([IPv4Network('192.0.2.0/25'),
IPv4Network('192.0.2.128/25')]) ->
[IPv4Network('192.0.2.0/24')]
Args:
addresses: An iterator of IPv4Network or IPv6Network objects.
Returns:
An iterator of the collapsed IPv(4|6)Network objects.
Raises:
TypeError: If passed a list of mixed version objects.
i i u% %s and %s are not of the same versionNu keyi’’’’i’’’’i’’’’i’’’’i’’’’i’’’’( u
isinstanceu _BaseAddressu _versionu TypeErroru appendu
_prefixlenu _max_prefixlenu ipu AttributeErroru network_addressu sortedu setu lenu _find_address_rangeu indexu extendu summarize_address_rangeu iteru _collapse_addresses_recursiveu _BaseNetworku _get_networks_key( u addressesu iu addrsu ipsu netsu ipu firstu last( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu collapse_addresses5 s<
u collapse_addressesc C s6 t | t r | j St | t r2 | j St S( u2 Return a key suitable for sorting between networks and addresses.
Address and Network objects are not sortable by default; they're
fundamentally different so the expression
IPv4Address('192.0.2.0') <= IPv4Network('192.0.2.0/24')
doesn't make any sense. There are some times however, where you may wish
to have ipaddress sort these for you anyway. If you need to do this, you
can use this function as the key= argument to sorted().
Args:
obj: either a Network or Address object.
Returns:
appropriate key.
( u
isinstanceu _BaseNetworku _get_networks_keyu _BaseAddressu _get_address_keyu NotImplemented( u obj( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu get_mixed_type_keyn s
u get_mixed_type_keyc B s\ | Ee Z d Z d d Z d d Z d d Z d d Z d d
Z d d Z d
S( u _TotalOrderingMixinc C s
t d S( N( u NotImplementedError( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __eq__ s u _TotalOrderingMixin.__eq__c C s$ | j | } | t k r t S| S( N( u __eq__u NotImplemented( u selfu otheru equal( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __ne__ s u _TotalOrderingMixin.__ne__c C s
t d S( N( u NotImplementedError( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __lt__ s u _TotalOrderingMixin.__lt__c C s3 | j | } | t k s" | r/ | j | S| S( N( u __lt__u NotImplementedu __eq__( u selfu otheru less( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __le__ s
u _TotalOrderingMixin.__le__c C sI | j | } | t k r t S| j | } | t k r> t S| pG | S( N( u __lt__u NotImplementedu __eq__( u selfu otheru lessu equal( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __gt__ s u _TotalOrderingMixin.__gt__c C s$ | j | } | t k r t S| S( N( u __lt__u NotImplemented( u selfu otheru less( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __ge__¢ s u _TotalOrderingMixin.__ge__N( u __name__u
__module__u __qualname__u __eq__u __ne__u __lt__u __le__u __gt__u __ge__( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _TotalOrderingMixin s u _TotalOrderingMixinc B s¤ | Ee Z d Z d Z e d d Z e d d Z e d d Z d d Z d
d Z d d
Z
d d Z d d Z d d Z
d d Z d S( u _IPAddressBaseu The mother class.c C s
| j S( u: Return the longhand version of the IP address as a string.( u _explode_shorthand_ip_string( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu exploded¬ s u _IPAddressBase.explodedc C s
t | S( u; Return the shorthand version of the IP address as a string.( u str( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
compressed± s u _IPAddressBase.compressedc C s# d t | f } t | d S( Nu %200s has no version specified( u typeu NotImplementedError( u selfu msg( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu version¶ s u _IPAddressBase.versionc C si | d k r. d } t | | | j f n | | j k re d } t | | | j | j f n d S( Ni u- %d (< 0) is not permitted as an IPv%d addressu2 %d (>= 2**%d) is not permitted as an IPv%d address( u AddressValueErroru _versionu _ALL_ONESu _max_prefixlen( u selfu addressu msg( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _check_int_address» s u! _IPAddressBase._check_int_addressc C sD t | } | | k r@ d } t | | | | | j f n d S( Nu6 %r (len %d != %d) is not permitted as an IPv%d address( u lenu AddressValueErroru _version( u selfu addressu expected_lenu address_lenu msg( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _check_packed_addressÄ s
u$ _IPAddressBase._check_packed_addressc C s | j | j | ?AS( u¦ Turn the prefix length into a bitwise netmask
Args:
prefixlen: An integer, the prefix length.
Returns:
An integer.
( u _ALL_ONES( u selfu prefixlen( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _ip_int_from_prefixĖ s
u" _IPAddressBase._ip_int_from_prefixc C s t | | j } | j | } | | ?} d | >d } | | k r{ | j d } | j | d } d } t | | n | S( u Return prefix length from the bitwise netmask.
Args:
ip_int: An integer, the netmask in axpanded bitwise format
Returns:
An integer, the prefix length.
Raises:
ValueError: If the input intermingles zeroes & ones
i i u bigu& Netmask pattern %r mixes zeroes & ones( u _count_righthand_zero_bitsu _max_prefixlenu to_bytesu
ValueError( u selfu ip_intu trailing_zeroesu prefixlenu leading_onesu all_onesu byteslenu detailsu msg( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _prefix_from_ip_int× s
u" _IPAddressBase._prefix_from_ip_intc C s d | } t | d d S( Nu %r is not a valid netmask( u NetmaskValueErroru None( u selfu netmask_stru msg( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _report_invalid_netmaskļ s
u& _IPAddressBase._report_invalid_netmaskc C s t j j | s" | j | n y t | } Wn t k
rS | j | Yn Xd | k on | j k n s | j | n | S( u Return prefix length from a numeric string
Args:
prefixlen_str: The string to be converted
Returns:
An integer, the prefix length.
Raises:
NetmaskValueError: If the input is not a valid netmask
i ( u _BaseV4u _DECIMAL_DIGITSu
issupersetu _report_invalid_netmasku intu
ValueErroru _max_prefixlen( u selfu
prefixlen_stru prefixlen( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _prefix_from_prefix_stringó s
u) _IPAddressBase._prefix_from_prefix_stringc C s y | j | } Wn t k
r4 | j | Yn Xy | j | SWn t k
rZ Yn X| | j N} y | j | SWn t k
r | j | Yn Xd S( u Turn a netmask/hostmask string into a prefix length
Args:
ip_str: The netmask/hostmask to be converted
Returns:
An integer, the prefix length.
Raises:
NetmaskValueError: If the input is not a valid netmask/hostmask
N( u _ip_int_from_stringu AddressValueErroru _report_invalid_netmasku _prefix_from_ip_intu
ValueErroru _ALL_ONES( u selfu ip_stru ip_int( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _prefix_from_ip_string s
u% _IPAddressBase._prefix_from_ip_stringN( u __name__u
__module__u __qualname__u __doc__u propertyu explodedu
compressedu versionu _check_int_addressu _check_packed_addressu _ip_int_from_prefixu _prefix_from_ip_intu _report_invalid_netmasku _prefix_from_prefix_stringu _prefix_from_ip_string( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _IPAddressBaseØ s u _IPAddressBasec B s | Ee Z d Z d Z d d Z d d Z d d Z d d Z d
d Z d d
Z d d Z
d d Z d d Z d d Z
d S( u _BaseAddressu A generic IP object.
This IP class contains the version independent methods which are
used by single IP addresses.
c C s9 t | t r5 d t | k r5 t d | n d S( Nu /u Unexpected '/' in %r( u
isinstanceu bytesu stru AddressValueError( u selfu address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__5 s u _BaseAddress.__init__c C s | j S( N( u _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __int__: s u _BaseAddress.__int__c C sC y& | j | j k o$ | j | j k SWn t k
r> t SYn Xd S( N( u _ipu _versionu AttributeErroru NotImplemented( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __eq__= s
u _BaseAddress.__eq__c C sy | j | j k r+ t d | | f n t | t sS t d | | f n | j | j k ru | j | j k Sd S( Nu% %s and %s are not of the same versionu" %s and %s are not of the same typeF( u _versionu TypeErroru
isinstanceu _BaseAddressu _ipu False( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __lt__D s u _BaseAddress.__lt__c C s* t | t s t S| j t | | S( N( u
isinstanceu intu NotImplementedu __class__( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __add__Q s u _BaseAddress.__add__c C s* t | t s t S| j t | | S( N( u
isinstanceu intu NotImplementedu __class__( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __sub__V s u _BaseAddress.__sub__c C s d | j j t | f S( Nu %s(%r)( u __class__u __name__u str( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __repr__[ s u _BaseAddress.__repr__c C s t | j | j S( N( u stru _string_from_ip_intu _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __str__^ s u _BaseAddress.__str__c C s t t t | j S( N( u hashu hexu intu _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __hash__a s u _BaseAddress.__hash__c C s
| j | f S( N( u _version( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _get_address_keyd s u _BaseAddress._get_address_keyN( u __name__u
__module__u __qualname__u __doc__u __init__u __int__u __eq__u __lt__u __add__u __sub__u __repr__u __str__u __hash__u _get_address_key( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _BaseAddress- s
u _BaseAddressc B sā | Ee Z d Z d Z d d Z d d Z d d Z d d Z d
d Z d d
Z d d Z
d d Z d d Z d d Z
d d Z e d d Z e d d Z e d d Z e d d Z e d d! Z e d" d# Z e d$ d% Z e d& d' Z d( d) Z d* d+ Z d, d- Z d. d? d/ d0 Z d. d? d1 d2 Z e d3 d4 Z e d5 d6 Z e d7 d8 Z e d9 d: Z! e d; d< Z" e d= d> Z# d? S(@ u _BaseNetworku~ A generic IP network object.
This IP class contains the version independent methods which are
used by networks.
c C s
i | _ d S( N( u _cache( u selfu address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__p s u _BaseNetwork.__init__c C s d | j j t | f S( Nu %s(%r)( u __class__u __name__u str( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __repr__s s u _BaseNetwork.__repr__c C s d | j | j f S( Nu %s/%d( u network_addressu prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __str__v s u _BaseNetwork.__str__c c sN t | j } t | j } x) t | d | D] } | j | Vq2 Wd S( u Generate Iterator over usable hosts in a network.
This is like __iter__ except it doesn't return the network
or broadcast addresses.
i N( u intu network_addressu broadcast_addressu rangeu _address_class( u selfu networku broadcastu x( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu hostsy s u _BaseNetwork.hostsc c sN t | j } t | j } x) t | | d D] } | j | Vq2 Wd S( Ni ( u intu network_addressu broadcast_addressu rangeu _address_class( u selfu networku broadcastu x( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __iter__
s u _BaseNetwork.__iter__c C s t | j } t | j } | d k rT | | | k rC t n | j | | S| d 7} | | | k rw t n | j | | Sd S( Ni i ( u intu network_addressu broadcast_addressu
IndexErroru _address_class( u selfu nu networku broadcast( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __getitem__ s
u _BaseNetwork.__getitem__c C s | j | j k r+ t d | | f n t | t sS t d | | f n | j | j k ru | j | j k S| j | j k r | j | j k Sd S( Nu% %s and %s are not of the same versionu" %s and %s are not of the same typeF( u _versionu TypeErroru
isinstanceu _BaseNetworku network_addressu netmasku False( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __lt__ s u _BaseNetwork.__lt__c C sa yD | j | j k oB | j | j k oB t | j t | j k SWn t k
r\ t SYn Xd S( N( u _versionu network_addressu intu netmasku AttributeErroru NotImplemented( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __eq__„ s
u _BaseNetwork.__eq__c C s t t | j t | j A S( N( u hashu intu network_addressu netmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __hash__ s u _BaseNetwork.__hash__c C s` | j | j k r d St | t r) d St | j t | j k oY t | j k SSd S( NF( u _versionu Falseu
isinstanceu _BaseNetworku intu network_addressu _ipu broadcast_address( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __contains__° s u _BaseNetwork.__contains__c C s: | j | k p9 | j | k p9 | j | k p9 | j | k S( u* Tell if self is partly contained in other.( u network_addressu broadcast_address( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu overlaps½ s u _BaseNetwork.overlapsc C sW | j j d } | d k rS | j t | j t | j B } | | j d other
eg: IPv4Network('192.0.2.128/25') > IPv4Network('192.0.2.0/25')
IPv6Network('2001:db8::2000/124') >
IPv6Network('2001:db8::1000/124')
Raises:
TypeError if the IP versions are different.
u" %s and %s are not of the same typei i i’’’’i’’’’( u _versionu TypeErroru network_addressu netmask( u selfu other( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu compare_networks@ s !u _BaseNetwork.compare_networksc C s | j | j | j f S( uĖ Network-only key function.
Returns an object that identifies this address' network and
netmask. This function is a suitable "key" argument for sorted()
and list.sort().
( u _versionu network_addressu netmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _get_networks_keyp s u _BaseNetwork._get_networks_keyi c c sK | j | j k r | Vd S| d k rp | | j k rE t d n | d k r` t d n | | j } n | d k r t d n | j | } | | j k rĄ t d | | f n | j d | j | j | f } | V| } xV | j } | | j k r
d S| j t | d } | j d | | f } | Vqń d S( uÓ The subnets which join to make the current subnet.
In the case that self contains only one IP
(self._prefixlen == 32 for IPv4 or self._prefixlen == 128
for IPv6), yield an iterator with just ourself.
Args:
prefixlen_diff: An integer, the amount the prefix length
should be increased by. This should not be set if
new_prefix is also set.
new_prefix: The desired new prefix length. This must be a
larger number (smaller prefix) than the existing prefix.
This should not be set if prefixlen_diff is also set.
Returns:
An iterator of IPv(4|6) objects.
Raises:
ValueError: The prefixlen_diff is too small or too large.
OR
prefixlen_diff and new_prefix are both set or new_prefix
is a smaller number than the current prefix (smaller
number means a larger network)
Nu new prefix must be longeri u( cannot set prefixlen_diff and new_prefixi u prefix length diff must be > 0u0 prefix length diff %d is invalid for netblock %su %s/%s( u
_prefixlenu _max_prefixlenu Noneu
ValueErroru __class__u network_addressu broadcast_addressu _address_classu int( u selfu prefixlen_diffu
new_prefixu
new_prefixlenu firstu currentu broadcastu new_addr( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu subnetsz s:
u _BaseNetwork.subnetsc C sŻ | j d k r | S| d k rh | | j k r= t d n | d k rX t d n | j | } n | j | d k r t d | j | f n | j d | j | j | f d d } | j d | j | j f S(
uĖ The supernet containing the current network.
Args:
prefixlen_diff: An integer, the amount the prefix length of
the network should be decreased by. For example, given a
/24 network and a prefixlen_diff of 3, a supernet with a
/21 netmask is returned.
Returns:
An IPv4 network object.
Raises:
ValueError: If self.prefixlen - prefixlen_diff < 0. I.e., you have
a negative prefix length.
OR
If prefixlen_diff and new_prefix are both set or new_prefix is a
larger number than the current prefix (larger number means a
smaller network)
i u new prefix must be shorteri u( cannot set prefixlen_diff and new_prefixu; current prefixlen is %d, cannot have a prefixlen_diff of %du %s/%du strictNF( u
_prefixlenu Noneu
ValueErroru prefixlenu __class__u network_addressu False( u selfu prefixlen_diffu
new_prefixu t( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu supernetø s u _BaseNetwork.supernetc C s | j j o | j j S( u» Test if the address is reserved for multicast use.
Returns:
A boolean, True if the address is a multicast address.
See RFC 2373 2.7 for details.
( u network_addressu is_multicastu broadcast_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_multicastį s u _BaseNetwork.is_multicastc C s | j j o | j j S( uµ Test if the address is otherwise IETF reserved.
Returns:
A boolean, True if the address is within one of the
reserved IPv6 Network ranges.
( u network_addressu is_reservedu broadcast_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_reservedķ s u _BaseNetwork.is_reservedc C s | j j o | j j S( u Test if the address is reserved for link-local.
Returns:
A boolean, True if the address is reserved per RFC 4291.
( u network_addressu
is_link_localu broadcast_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_link_localł s u _BaseNetwork.is_link_localc C s | j j o | j j S( u Test if this address is allocated for private networks.
Returns:
A boolean, True if the address is reserved per RFC 4193.
( u network_addressu
is_privateu broadcast_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_private s u _BaseNetwork.is_privatec C s | j j o | j j S( uØ Test if the address is unspecified.
Returns:
A boolean, True if this is the unspecified address as defined in
RFC 2373 2.5.2.
( u network_addressu is_unspecifiedu broadcast_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_unspecified s u _BaseNetwork.is_unspecifiedc C s | j j o | j j S( u± Test if the address is a loopback address.
Returns:
A boolean, True if the address is a loopback address as defined in
RFC 2373 2.5.3.
( u network_addressu is_loopbacku broadcast_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_loopback s u _BaseNetwork.is_loopbackN($ u __name__u
__module__u __qualname__u __doc__u __init__u __repr__u __str__u hostsu __iter__u __getitem__u __lt__u __eq__u __hash__u __contains__u overlapsu propertyu broadcast_addressu hostmasku with_prefixlenu with_netmasku
with_hostmasku
num_addressesu _address_classu prefixlenu address_excludeu compare_networksu _get_networks_keyu Noneu subnetsu supernetu is_multicastu is_reservedu
is_link_localu
is_privateu is_unspecifiedu is_loopback( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _BaseNetworkh s>
N 0
>) u _BaseNetworkc
B sø | Ee Z d Z d Z d e d Z e d Z e d! Z d d Z d d Z
d d Z d d Z d d Z
d d Z d d Z e d d Z e d d Z d S(" u _BaseV4uy Base IPv4 object.
The following methods are used by IPv4 objects in both single IP
addresses and networks.
i i u
0123456789i’ iž iü ių iš ią iĄ i i c C s d | _ t | _ d S( Ni ( u _versionu
IPV4LENGTHu _max_prefixlen( u selfu address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__8 s u _BaseV4.__init__c C s
t | S( N( u str( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _explode_shorthand_ip_string< s u$ _BaseV4._explode_shorthand_ip_stringc C s® | s t d n | j d } t | d k rI t d | n y t j t | j | d SWn> t k
r© } z t d | | f d WYd d } ~ Xn Xd S( u Turn the given IP string into an integer for comparison.
Args:
ip_str: A string, the IP ip_str.
Returns:
The IP ip_str as an integer.
Raises:
AddressValueError: if ip_str isn't a valid IPv4 Address.
u Address cannot be emptyu .i u Expected 4 octets in %ru bigu %s in %rN( u AddressValueErroru splitu lenu intu
from_bytesu mapu _parse_octetu
ValueErroru None( u selfu ip_stru octetsu exc( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _ip_int_from_string? s
u _BaseV4._ip_int_from_stringc C sŅ | s t d n | j j | s@ d } t | | n t | d k rk d } t | | n t | d } | d k rÆ | d d k rÆ d } t | | n | d
k rĪ t d | n | S( u Convert a decimal octet into an integer.
Args:
octet_str: A string, the number to parse.
Returns:
The octet as an integer.
Raises:
ValueError: if the octet isn't strictly a decimal from [0..255].
u Empty octet not permittedu# Only decimal digits permitted in %ri u$ At most 3 characters permitted in %ri
i i u 0u3 Ambiguous (octal/decimal) value in %r not permittedi’ u Octet %d (> 255) not permitted( u
ValueErroru _DECIMAL_DIGITSu
issupersetu lenu int( u selfu octet_stru msgu octet_int( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _parse_octetX s
u _BaseV4._parse_octetc C s" d j t t | j d d S( uŅ Turns a 32-bit integer into dotted decimal notation.
Args:
ip_int: An integer, the IP address.
Returns:
The IP address as a string in dotted decimal notation.
u .i u big( u joinu mapu stru to_bytes( u selfu ip_int( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _string_from_ip_int| s
u _BaseV4._string_from_ip_intc C sń | j d } t | d k r y. x' | D] } t | | j k r+ d Sq+ WWn t k
rg d SYn Xx> t | D]0 \ } } | d k ru | | | d k ru d Squ Wd Sy t | } Wn t k
rÕ d SYn Xd | k oī | j k SS( uū Verify that the netmask is valid.
Args:
netmask: A string, either a prefix or dotted decimal
netmask.
Returns:
A boolean, True if the prefix represents a valid IPv4
netmask.
u .i i i FT( u splitu lenu intu _valid_mask_octetsu Falseu
ValueErroru enumerateu Trueu _max_prefixlen( u selfu netmasku masku xu idxu y( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _is_valid_netmask s"
u _BaseV4._is_valid_netmaskc s | j d } y& f d d t t | D } Wn t k
rM d SYn Xt | t | k rj d S| d | d k r d Sd S( uŁ Test if the IP string is a hostmask (rather than a netmask).
Args:
ip_str: A string, the potential hostmask.
Returns:
A boolean, True if the IP string is a hostmask.
u .c s% g | ] } | j k r | q S( ( u _valid_mask_octets( u .0u x( u self( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
³ s u( _BaseV4._is_hostmask..i i Fi’’’’T( u splitu mapu intu
ValueErroru Falseu lenu True( u selfu ip_stru bitsu parts( ( u selfu. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _is_hostmask§ s
&
u _BaseV4._is_hostmaskc C s | j S( N( u _max_prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
max_prefixlen¼ s u _BaseV4.max_prefixlenc C s | j S( N( u _version( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu versionĄ s u _BaseV4.versionN( i’ iž iü ių iš ią iĄ i i ( u __name__u
__module__u __qualname__u __doc__u
IPV4LENGTHu _ALL_ONESu frozensetu _DECIMAL_DIGITSu _valid_mask_octetsu __init__u _explode_shorthand_ip_stringu _ip_int_from_stringu _parse_octetu _string_from_ip_intu _is_valid_netmasku _is_hostmasku propertyu
max_prefixlenu version( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _BaseV4( s $ u _BaseV4c B s¤ | Ee Z d Z d Z d d Z e d d Z e d d Z e d d Z e d
d Z e d d
Z
e d d Z e d d Z d S( u IPv4Addressu/ Represent and manipulate single IPv4 Addresses.c C s£ t j | | t j | | t | t rI | j | | | _ d St | t r | j | d t j | d | _ d St
| } | j | | _ d S( u±
Args:
address: A string or integer representing the IP
Additionally, an integer can be passed, so
IPv4Address('192.0.2.1') == IPv4Address(3221225985).
or, more generally
IPv4Address(int(IPv4Address('192.0.2.1'))) ==
IPv4Address('192.0.2.1')
Raises:
AddressValueError: If ipaddress isn't a valid IPv4 address.
Ni u big( u _BaseAddressu __init__u _BaseV4u
isinstanceu intu _check_int_addressu _ipu bytesu _check_packed_addressu
from_bytesu stru _ip_int_from_string( u selfu addressu addr_str( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__É s
u IPv4Address.__init__c C s
t | j S( u* The binary representation of this address.( u v4_int_to_packedu _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu packedķ s u IPv4Address.packedc C s t d } | | k S( u° Test if the address is otherwise IETF reserved.
Returns:
A boolean, True if the address is within the
reserved IPv4 Network range.
u 240.0.0.0/4( u IPv4Network( u selfu reserved_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_reservedņ s u IPv4Address.is_reservedc C sF t d } t d } t d } | | k pE | | k pE | | k S( u Test if this address is allocated for private networks.
Returns:
A boolean, True if the address is reserved per RFC 1918.
u
10.0.0.0/8u
172.16.0.0/12u 192.168.0.0/16( u IPv4Network( u selfu
private_10u private_172u private_192( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_privatež s u IPv4Address.is_privatec C s t d } | | k S( u Test if the address is reserved for multicast use.
Returns:
A boolean, True if the address is multicast.
See RFC 3171 for details.
u 224.0.0.0/4( u IPv4Network( u selfu multicast_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_multicast
s u IPv4Address.is_multicastc C s t d } | | k S( u¤ Test if the address is unspecified.
Returns:
A boolean, True if this is the unspecified address as defined in
RFC 5735 3.
u 0.0.0.0( u IPv4Address( u selfu unspecified_address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_unspecified s u IPv4Address.is_unspecifiedc C s t d } | | k S( u Test if the address is a loopback address.
Returns:
A boolean, True if the address is a loopback per RFC 3330.
u 127.0.0.0/8( u IPv4Network( u selfu loopback_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_loopback% s u IPv4Address.is_loopbackc C s t d } | | k S( u Test if the address is reserved for link-local.
Returns:
A boolean, True if the address is link-local per RFC 3927.
u 169.254.0.0/16( u IPv4Network( u selfu linklocal_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_link_local0 s u IPv4Address.is_link_localN(
u __name__u
__module__u __qualname__u __doc__u __init__u propertyu packedu is_reservedu
is_privateu is_multicastu is_unspecifiedu is_loopbacku
is_link_local( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu IPv4AddressÅ s $ u IPv4Addressc B s | Ee Z d Z d d Z d d Z d d Z d d Z d d
Z e d d Z e d
d Z
e d d Z e d d Z d S( u
IPv4Interfacec C s t | t t f rG t j | | t | j | _ | j | _ d St
| } t j | | d t | d d | _ | j j | _ | j j | _ | j j
| _
d S( Ni u strictF( u
isinstanceu bytesu intu IPv4Addressu __init__u IPv4Networku _ipu networku _max_prefixlenu
_prefixlenu _split_optional_netmasku Falseu netmasku hostmask( u selfu addressu addr( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__> s u IPv4Interface.__init__c C s d | j | j | j j f S( Nu %s/%d( u _string_from_ip_intu _ipu networku prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __str__N s u IPv4Interface.__str__c C sZ t j | | } | s% | t k r) | Sy | j | j k SWn t k
rU d SYn Xd S( NF( u IPv4Addressu __eq__u NotImplementedu networku AttributeErroru False( u selfu otheru
address_equal( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __eq__R s
u IPv4Interface.__eq__c C sS t j | | } | t k r" t Sy | j | j k SWn t k
rN d SYn Xd S( NF( u IPv4Addressu __lt__u NotImplementedu networku AttributeErroru False( u selfu otheru address_less( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __lt__^ s
u IPv4Interface.__lt__c C s | j | j At | j j AS( N( u _ipu
_prefixlenu intu networku network_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __hash__i s u IPv4Interface.__hash__c C s
t | j S( N( u IPv4Addressu _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu ipl s u IPv4Interface.ipc C s d | j | j | j f S( Nu %s/%s( u _string_from_ip_intu _ipu
_prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu with_prefixlenp s u IPv4Interface.with_prefixlenc C s d | j | j | j f S( Nu %s/%s( u _string_from_ip_intu _ipu netmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu with_netmasku s u IPv4Interface.with_netmaskc C s d | j | j | j f S( Nu %s/%s( u _string_from_ip_intu _ipu hostmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
with_hostmaskz s u IPv4Interface.with_hostmaskN(
u __name__u
__module__u __qualname__u __init__u __str__u __eq__u __lt__u __hash__u propertyu ipu with_prefixlenu with_netmasku
with_hostmask( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
IPv4Interface< s u
IPv4Interfacec B s/ | Ee Z d Z d Z e Z d d d Z d S( u IPv4Networkue This class represents and manipulates 32-bit IPv4 network + addresses..
Attributes: [examples for IPv4Network('192.0.2.0/27')]
.network_address: IPv4Address('192.0.2.0')
.hostmask: IPv4Address('0.0.0.31')
.broadcast_address: IPv4Address('192.0.2.32')
.netmask: IPv4Address('255.255.255.224')
.prefixlen: 27
c C sŽ t j | | t j | | t | t r` t | | _ | j | _ t | j | _
d St | t r t | | _ | j | _ t | j | _
d St | } t | j
| d | _ t | d k r"y | j | d | _ Wq.t k
r | j | d | _ Yq.Xn | j | _ t | j | j | _
| rt t | j t | j
@ | j k rt d | qn t t | j t | j
@ | _ | j | j d k rŚ| j | _ n d S( u Instantiate a new IPv4 network object.
Args:
address: A string or integer representing the IP [& network].
'192.0.2.0/24'
'192.0.2.0/255.255.255.0'
'192.0.0.2/0.0.0.255'
are all functionally the same in IPv4. Similarly,
'192.0.2.1'
'192.0.2.1/255.255.255.255'
'192.0.2.1/32'
are also functionally equivalent. That is to say, failing to
provide a subnetmask will create an object with a mask of /32.
If the mask (portion after the / in the argument) is given in
dotted quad form, it is treated as a netmask if it starts with a
non-zero field (e.g. /255.0.0.0 == /8) and as a hostmask if it
starts with a zero field (e.g. 0.255.255.255 == /8), with the
single exception of an all-zero mask which is treated as a
netmask == /0. If no mask is given, a default of /32 is used.
Additionally, an integer can be passed, so
IPv4Network('192.0.2.1') == IPv4Network(3221225985)
or, more generally
IPv4Interface(int(IPv4Interface('192.0.2.1'))) ==
IPv4Interface('192.0.2.1')
Raises:
AddressValueError: If ipaddress isn't a valid IPv4 address.
NetmaskValueError: If the netmask isn't valid for
an IPv4 address.
ValueError: If strict is True and a network address is not
supplied.
Ni i i u %s has host bits set( u _BaseV4u __init__u _BaseNetworku
isinstanceu bytesu IPv4Addressu network_addressu _max_prefixlenu
_prefixlenu _ALL_ONESu netmasku intu _split_optional_netmasku _ip_int_from_stringu lenu _prefix_from_prefix_stringu NetmaskValueErroru _prefix_from_ip_stringu _ip_int_from_prefixu
ValueErroru __iter__u hosts( u selfu addressu strictu addr( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__ s: &
u IPv4Network.__init__NT( u __name__u
__module__u __qualname__u __doc__u IPv4Addressu _address_classu Trueu __init__( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu IPv4Network s u IPv4Networkc B s© | Ee Z d Z d Z d e d Z d Z e d Z d d Z d d Z
d
d Z d d
Z d d d Z d d Z e d d Z e d d Z d S( u _BaseV6uy Base IPv6 object.
The following methods are used by IPv6 objects in both single IP
addresses and networks.
i i i u 0123456789ABCDEFabcdefc C s d | _ t | _ d S( Ni ( u _versionu
IPV6LENGTHu _max_prefixlen( u selfu address( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__ń s u _BaseV6.__init__c C sÜ | s t d n | j d } d } t | | k r[ d | | f } t | n d | d k rö y t | j j } Wn> t k
rÄ } z t d | | f d WYd d } ~ Xn X| j d | d
?d @ | j d | d @ n | j d } t | | k r8d | d | f } t | n d } xY t d t | d D]> } | | sX| d k rd
| } t | n | } qXqXW| d k rr| }
t | | d } | d sö|
d 8}
|
röd } t | | qön | d s,| d 8} | r,d } t | | q,n | j |
| } | d k rd } t | | j d | f qn t | | j k r©d } t | | j | f n | d sĢd } t | | n | d sļd } t | | n t | }
d } d } y d }
x5 t |
D]' } |
d
K}
|
| j
| | O}
q W|
d
| K}
x9 t | d D]' } |
d
K}
|
| j
| | O}
qgW|
SWn> t k
r×} z t d | | f d WYd d } ~ Xn Xd S( uł Turn an IPv6 ip_str into an integer.
Args:
ip_str: A string, the IPv6 ip_str.
Returns:
An int, the IPv6 address
Raises:
AddressValueError: if ip_str isn't a valid IPv6 Address.
u Address cannot be emptyu :i u At least %d parts expected in %ru .i u %s in %rNu %xi i’’ u! At most %d colons permitted in %ru At most one '::' permitted in %ri u0 Leading ':' only permitted as part of '::' in %ru1 Trailing ':' only permitted as part of '::' in %ru/ Expected at most %d other parts with '::' in %ru, Exactly %d parts expected without '::' in %ri’’’’i’’’’i’’’’( u AddressValueErroru splitu lenu IPv4Addressu popu _ipu Noneu appendu
_HEXTET_COUNTu rangeu
_parse_hextetu
ValueError( u selfu ip_stru partsu
_min_partsu msgu ipv4_intu excu
_max_partsu
skip_indexu iu parts_hiu parts_lou
parts_skippedu ip_int( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _ip_int_from_stringõ s
,
#
u _BaseV6._ip_int_from_stringc C s] | j j | s% t d | n t | d k rP d } t | | n t | d S( u& Convert an IPv6 hextet string into an integer.
Args:
hextet_str: A string, the number to parse.
Returns:
The hextet as an integer.
Raises:
ValueError: if the input isn't strictly a hex number from
[0..FFFF].
u Only hex digits permitted in %ri u$ At most 4 characters permitted in %ri ( u _HEX_DIGITSu
issupersetu
ValueErroru lenu int( u selfu
hextet_stru msg( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
_parse_hextet\ s u _BaseV6._parse_hextetc C sų d } d } d } d } xo t | D]a \ } } | d k rz | d 7} | d k r\ | } n | | k r | } | } q q% d } d } q% W| d k rō | | } | t | k rĀ | d g 7} n d g | | |
<| d k rō d g | } qō n | S( uä Compresses a list of hextets.
Compresses a list of strings, replacing the longest continuous
sequence of "0" in the list with "" and adding empty strings at
the beginning or at the end of the string such that subsequently
calling ":".join(hextets) will produce the compressed version of
the IPv6 address.
Args:
hextets: A list of strings, the hextets to compress.
Returns:
A list of strings.
i i u 0u i’’’’i’’’’i’’’’i’’’’( u enumerateu len( u selfu hextetsu best_doublecolon_startu best_doublecolon_lenu doublecolon_startu doublecolon_lenu indexu hextetu best_doublecolon_end( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _compress_hextetsu s.
u _BaseV6._compress_hextetsc s | d k r t | j } n | | j k r< t d n d | f d d t d d d D } | j | } d j | S(
u, Turns a 128-bit integer into hexadecimal notation.
Args:
ip_int: An integer, the IP address.
Returns:
A string, the hexadecimal representation of the address.
Raises:
ValueError: The address is bigger than 128 bits of all ones.
u IPv6 address is too largeu %032xc s1 g | ]' } d t | | d
d q S( u %xi i ( u int( u .0u x( u hex_str( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
ø s u/ _BaseV6._string_from_ip_int..i i i u :N( u Noneu intu _ipu _ALL_ONESu
ValueErroru rangeu _compress_hextetsu join( u selfu ip_intu hextets( ( u hex_stru. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _string_from_ip_int¤ s
%u _BaseV6._string_from_ip_intc sČ t | t r! t | j } n- t | t rB t | j } n t | } | j | } d | f d d t d d d D } t | t t f r» d d j | | j
f Sd j | S( u¬ Expand a shortened IPv6 address.
Args:
ip_str: A string, the IPv6 address.
Returns:
A string, the expanded IPv6 address.
u %032xc s$ g | ] } | | d
q S( i ( ( u .0u x( u hex_str( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
Š s u8 _BaseV6._explode_shorthand_ip_string..i i i u %s/%du :( u
isinstanceu IPv6Networku stru network_addressu
IPv6Interfaceu ipu _ip_int_from_stringu rangeu _BaseNetworku joinu
_prefixlen( u selfu ip_stru ip_intu parts( ( u hex_stru. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _explode_shorthand_ip_string½ s
%u$ _BaseV6._explode_shorthand_ip_stringc C s | j S( N( u _max_prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
max_prefixlenÕ s u _BaseV6.max_prefixlenc C s | j S( N( u _version( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu versionŁ s u _BaseV6.versionN( u __name__u
__module__u __qualname__u __doc__u
IPV6LENGTHu _ALL_ONESu
_HEXTET_COUNTu frozensetu _HEX_DIGITSu __init__u _ip_int_from_stringu
_parse_hextetu _compress_hextetsu Noneu _string_from_ip_intu _explode_shorthand_ip_stringu propertyu
max_prefixlenu version( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _BaseV6ä s g / u _BaseV6c B sģ | Ee Z d Z d Z d d Z e d d Z e d d Z e d d Z e d
d Z e d d
Z
e d d Z e d d Z e d d Z
e d d Z e d d Z e d d Z d S( u IPv6Addressu/ Represent and manipulate single IPv6 Addresses.c C s£ t j | | t j | | t | t rI | j | | | _ d St | t r | j | d t j | d | _ d St
| } | j | | _ d S( u Instantiate a new IPv6 address object.
Args:
address: A string or integer representing the IP
Additionally, an integer can be passed, so
IPv6Address('2001:db8::') ==
IPv6Address(42540766411282592856903984951653826560)
or, more generally
IPv6Address(int(IPv6Address('2001:db8::'))) ==
IPv6Address('2001:db8::')
Raises:
AddressValueError: If address isn't a valid IPv6 address.
Ni u big( u _BaseAddressu __init__u _BaseV6u
isinstanceu intu _check_int_addressu _ipu bytesu _check_packed_addressu
from_bytesu stru _ip_int_from_string( u selfu addressu addr_str( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__ā s
u IPv6Address.__init__c C s
t | j S( u* The binary representation of this address.( u v6_int_to_packedu _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu packed s u IPv6Address.packedc C s t d } | | k S( u» Test if the address is reserved for multicast use.
Returns:
A boolean, True if the address is a multicast address.
See RFC 2373 2.7 for details.
u ff00::/8( u IPv6Network( u selfu multicast_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_multicast s u IPv6Address.is_multicastc sŖ t d t d t d t d t d t d t d t d t d t d
t d t d t d
t d t d g } t f d d | D S( uµ Test if the address is otherwise IETF reserved.
Returns:
A boolean, True if the address is within one of the
reserved IPv6 Network ranges.
u ::/8u 100::/8u 200::/7u 400::/6u 800::/5u 1000::/4u 4000::/3u 6000::/3u 8000::/3u A000::/3u C000::/3u E000::/4u F000::/5u F800::/6u FE00::/9c 3 s | ] } | k Vq d S( N( ( u .0u x( u self( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu * s u* IPv6Address.is_reserved..( u IPv6Networku any( u selfu reserved_networks( ( u selfu. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_reserved s u IPv6Address.is_reservedc C s t d } | | k S( u Test if the address is reserved for link-local.
Returns:
A boolean, True if the address is reserved per RFC 4291.
u fe80::/10( u IPv6Network( u selfu linklocal_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_link_local, s u IPv6Address.is_link_localc C s t d } | | k S( u` Test if the address is reserved for site-local.
Note that the site-local address space has been deprecated by RFC 3879.
Use is_private to test if this address is in the space of unique local
addresses as defined by RFC 4193.
Returns:
A boolean, True if the address is reserved per RFC 3513 2.5.6.
u fec0::/10( u IPv6Network( u selfu sitelocal_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_site_local7 s u IPv6Address.is_site_localc C s t d } | | k S( u Test if this address is allocated for private networks.
Returns:
A boolean, True if the address is reserved per RFC 4193.
u fc00::/7( u IPv6Network( u selfu private_network( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_privateF s u IPv6Address.is_privatec C s
| j d k S( uØ Test if the address is unspecified.
Returns:
A boolean, True if this is the unspecified address as defined in
RFC 2373 2.5.2.
i ( u _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_unspecifiedQ s u IPv6Address.is_unspecifiedc C s
| j d k S( u± Test if the address is a loopback address.
Returns:
A boolean, True if the address is a loopback address as defined in
RFC 2373 2.5.3.
i ( u _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_loopback\ s u IPv6Address.is_loopbackc C s( | j d ?d k r d St | j d @ S( u¶ Return the IPv4 mapped address.
Returns:
If the IPv6 address is a v4 mapped address, return the
IPv4 mapped address. Return None otherwise.
i i’’ l ’’ N( u _ipu Noneu IPv4Address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu ipv4_mappedg s u IPv6Address.ipv4_mappedc C s@ | j d ?d k r d St | j d ?d @ t | j d @ f S( uŪ Tuple of embedded teredo IPs.
Returns:
Tuple of the (server, client) IPs or None if the address
doesn't appear to be a teredo address (doesn't start with
2001::/32)
i` i i@ l ’’ N( u _ipu Noneu IPv4Address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu teredot s
u IPv6Address.teredoc C s, | j d ?d k r d St | j d ?d @ S( uĪ Return the IPv4 6to4 embedded address.
Returns:
The IPv4 6to4-embedded address if present or None if the
address doesn't appear to contain a 6to4 embedded address.
ip i iP l ’’ N( u _ipu Noneu IPv4Address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu sixtofour s u IPv6Address.sixtofourN( u __name__u
__module__u __qualname__u __doc__u __init__u propertyu packedu is_multicastu is_reservedu
is_link_localu
is_site_localu
is_privateu is_unspecifiedu is_loopbacku ipv4_mappedu teredou sixtofour( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu IPv6AddressŽ s %
u IPv6Addressc B s¼ | Ee Z d Z d d Z d d Z d d Z d d Z d d
Z e d d Z e d
d Z
e d d Z e d d Z e d d Z
e d d Z d S( u
IPv6Interfacec C s t | t t f rG t j | | t | j | _ | j | _ d St
| } t j | | d t | d d | _ | j j | _ | j j | _ | j j
| _
d S( Ni u strictF( u
isinstanceu bytesu intu IPv6Addressu __init__u IPv6Networku _ipu networku _max_prefixlenu
_prefixlenu _split_optional_netmasku Falseu netmasku hostmask( u selfu addressu addr( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__ s u IPv6Interface.__init__c C s d | j | j | j j f S( Nu %s/%d( u _string_from_ip_intu _ipu networku prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __str__” s u IPv6Interface.__str__c C sZ t j | | } | s% | t k r) | Sy | j | j k SWn t k
rU d SYn Xd S( NF( u IPv6Addressu __eq__u NotImplementedu networku AttributeErroru False( u selfu otheru
address_equal( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __eq__„ s
u IPv6Interface.__eq__c C sS t j | | } | t k r" t Sy | j | j k SWn t k
rN d SYn Xd S( NF( u IPv6Addressu __lt__u NotImplementedu networku AttributeErroru False( u selfu otheru address_less( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __lt__± s
u IPv6Interface.__lt__c C s | j | j At | j j AS( N( u _ipu
_prefixlenu intu networku network_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __hash__¼ s u IPv6Interface.__hash__c C s
t | j S( N( u IPv6Addressu _ip( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu ipæ s u IPv6Interface.ipc C s d | j | j | j f S( Nu %s/%s( u _string_from_ip_intu _ipu
_prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu with_prefixlenĆ s u IPv6Interface.with_prefixlenc C s d | j | j | j f S( Nu %s/%s( u _string_from_ip_intu _ipu netmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu with_netmaskČ s u IPv6Interface.with_netmaskc C s d | j | j | j f S( Nu %s/%s( u _string_from_ip_intu _ipu hostmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
with_hostmaskĶ s u IPv6Interface.with_hostmaskc C s | j d k o | j j S( Ni ( u _ipu networku is_unspecified( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_unspecifiedŅ s u IPv6Interface.is_unspecifiedc C s | j d k o | j j S( Ni ( u _ipu networku is_loopback( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu is_loopbackÖ s u IPv6Interface.is_loopbackN( u __name__u
__module__u __qualname__u __init__u __str__u __eq__u __lt__u __hash__u propertyu ipu with_prefixlenu with_netmasku
with_hostmasku is_unspecifiedu is_loopback( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
IPv6Interface s u
IPv6Interfacec B sA | Ee Z d Z d Z e Z d d d Z e d d Z d S( u IPv6Networkuv This class represents and manipulates 128-bit IPv6 networks.
Attributes: [examples for IPv6('2001:db8::1000/124')]
.network_address: IPv6Address('2001:db8::1000')
.hostmask: IPv6Address('::f')
.broadcast_address: IPv6Address('2001:db8::100f')
.netmask: IPv6Address('ffff:ffff:ffff:ffff:ffff:ffff:ffff:fff0')
.prefixlen: 124
c C sÆ t j | | t j | | t | t r` t | | _ | j | _ t | j | _
d St | t r t | | _ | j | _ t | j | _
d St | } t | j
| d | _ t | d k ró | j | d | _ n | j | _ t | j | j | _
| rat t | j t | j
@ | j k rat d | qan t t | j t | j
@ | _ | j | j d k r«| j | _ n d S( uē Instantiate a new IPv6 Network object.
Args:
address: A string or integer representing the IPv6 network or the
IP and prefix/netmask.
'2001:db8::/128'
'2001:db8:0000:0000:0000:0000:0000:0000/128'
'2001:db8::'
are all functionally the same in IPv6. That is to say,
failing to provide a subnetmask will create an object with
a mask of /128.
Additionally, an integer can be passed, so
IPv6Network('2001:db8::') ==
IPv6Network(42540766411282592856903984951653826560)
or, more generally
IPv6Network(int(IPv6Network('2001:db8::'))) ==
IPv6Network('2001:db8::')
strict: A boolean. If true, ensure that we have been passed
A true network address, eg, 2001:db8::1000/124 and not an
IP address on a network, eg, 2001:db8::1/124.
Raises:
AddressValueError: If address isn't a valid IPv6 address.
NetmaskValueError: If the netmask isn't valid for
an IPv6 address.
ValueError: If strict was True and a network address was not
supplied.
Ni i i u %s has host bits set( u _BaseV6u __init__u _BaseNetworku
isinstanceu intu IPv6Addressu network_addressu _max_prefixlenu
_prefixlenu _ALL_ONESu netmasku bytesu _split_optional_netmasku _ip_int_from_stringu lenu _prefix_from_prefix_stringu _ip_int_from_prefixu
ValueErroru __iter__u hosts( u selfu addressu strictu addr( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu __init__ė s4 u IPv6Network.__init__c C s | j j o | j j S( u` Test if the address is reserved for site-local.
Note that the site-local address space has been deprecated by RFC 3879.
Use is_private to test if this address is in the space of unique local
addresses as defined by RFC 4193.
Returns:
A boolean, True if the address is reserved per RFC 3513 2.5.6.
( u network_addressu
is_site_localu broadcast_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu
is_site_local3 s u IPv6Network.is_site_localNT(
u __name__u
__module__u __qualname__u __doc__u IPv6Addressu _address_classu Trueu __init__u propertyu
is_site_local( u
__locals__( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu IPv6NetworkŪ s Hu IPv6Network(! u __doc__u __version__u functoolsu
IPV4LENGTHu
IPV6LENGTHu
ValueErroru AddressValueErroru NetmaskValueErroru
ip_addressu Trueu
ip_networku ip_interfaceu v4_int_to_packedu v6_int_to_packedu _split_optional_netmasku _find_address_rangeu _count_righthand_zero_bitsu summarize_address_rangeu _collapse_addresses_recursiveu collapse_addressesu get_mixed_type_keyu _TotalOrderingMixinu _IPAddressBaseu _BaseAddressu _BaseNetworku _BaseV4u IPv4Addressu
IPv4Interfaceu IPv4Networku _BaseV6u IPv6Addressu
IPv6Interfaceu IPv6Network( ( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu s> # 8 0 9 !
;’ ĮwDdś³J