U
|
H=®d8 ã @ sl d Z ddlmZ ddlZddlZdZefZz eefZW n e k
|
rJ Y nX ze
|
Z W n$ e k
|
rx e Z e e ksttY nX ddkrdd Zndd Zz
|
ejZW n ek
|
rº dd ZY nX d
|
d Zeed rØd d Zndd ZdNddZG dd deZdZdZG dd deZ G dd deZ dd Z dOd 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'd0d1 Z(d2d3 Z)G d4d5 d5eZ*G d6d7 d7e*Z+G d8d9 d9e*Z,G d:d; d;eZ-G d<d= d=e-e+Z.G d>d? d?e.Z/G d@dA dAe-e,Z0G dBdC dCeZ1e1e._2G dDdE dEeZ3G dFdG dGe3e+Z4G dHdI dIe4Z5G dJdK dKe3e,Z6G dLdM dMeZ7e7e4_2dS )PzA fast, lightweight IPv4/IPv6 manipulation library in Python.
|
|
This library is used to create/poke/manipulate IPv4 and IPv6 addresses
|
and networks.
|
|
é )Úunicode_literalsNz1.0.23c C s | S ©N© ©Zbytr r úLD:\z\workplace\VsCode\pyvenv\venv\Lib\site-packages\pip/_vendor/ipaddress.pyÚ_compat_bytes_to_byte_vals s r c C s dd | D S )Nc S s g | ]}t d |¡d qS )ó !Br )ÚstructÚunpack©Ú.0Úbr r r Ú
|
<listcomp># s z._compat_bytes_to_byte_vals.<locals>.<listcomp>r r r r r r " s c C s8 |dks t d}| D ] }t|ts&t |d> | }q|S )NÚbigr é )ÚAssertionErrorÚ
|
isinstanceÚ_compat_int_types)ZbytvalsÚ endianessÚresZbvr r r Ú_compat_int_from_byte_vals' s r c C s t | tst|dkst|dkrH| dk s2| dkr<t d¡t d| ¡S |dkr| dk sd| dd krnt d
|
¡t d | d ? | d @ ¡S t d S )Nr é r l z(integer out of range for 'I' format codes !Ié é é z)integer out of range for 'QQ' format codes !QQé@ l ÿÿÿÿ )r r r r ÚerrorÚpackÚNotImplementedError)ZintvalÚlengthr r r r Ú_compat_to_bytes0 s
|
|
r Ú
|
bit_lengthc C s | ¡ S r )r! )Úir r r Ú_compat_bit_lengthA s r# c C s& t ¡ D ]}| |? dkr| S qd S ©Nr )Ú itertoolsÚcount)r" r r r r r# D s é c c s, |dks t | }||k r(|V ||7 }qd S r$ )r )ÚstartÚendÚstepr" r r r Ú _compat_rangeJ s
|
r+ c @ s@ e Zd ZdZdd Zdd Zdd Zdd Zd
|
d Zd d Z dS )Ú_TotalOrderingMixinr c C s t d S r ©r ©ÚselfÚotherr r r Ú__eq__Y s z_TotalOrderingMixin.__eq__c C s | |¡}|tkrtS | S r )r1 ÚNotImplemented)r/ r0 Úequalr r r Ú__ne__\ s
|
z_TotalOrderingMixin.__ne__c C s t d S r r- r. r r r Ú__lt__b s z_TotalOrderingMixin.__lt__c C s$ | |¡}|tks|s | |¡S |S r ©r5 r2 r1 ©r/ r0 Úlessr r r Ú__le__e s
|
|
z_TotalOrderingMixin.__le__c C s6 | |¡}|tkrtS | |¡}|tkr,tS |p2| S r r6 )r/ r0 r8 r3 r r r Ú__gt__k s
|
|
z_TotalOrderingMixin.__gt__c C s | |¡}|tkrtS | S r )r5 r2 r7 r r r Ú__ge__t s
|
z_TotalOrderingMixin.__ge__N)
|
Ú__name__Ú
|
__module__Ú __qualname__Ú __slots__r1 r4 r5 r9 r: r; r r r r r, R s r, é r c @ s e Zd ZdZdS )ÚAddressValueErrorz%A Value Error related to the address.N©r< r= r> Ú__doc__r r r r rA s rA c @ s e Zd ZdZdS )ÚNetmaskValueErrorz%A Value Error related to the netmask.NrB r r r r rD s rD c C sn z
|
t | W S ttfk
|
r" Y nX z
|
t| W S ttfk
|
rF Y nX t| tr^td| td| dS )a® 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
|
|
zx%r does not appear to be an IPv4 or IPv6 address. Did you pass in a bytes (str in Python 2) instead of a unicode object?z0%r does not appear to be an IPv4 or IPv6 addressN)Ú IPv4AddressrA rD Ú IPv6Addressr ÚbytesÚ
|
ValueError©Úaddressr r r Ú
|
ip_address s"
|
|
|
þÿÿrK Tc C sr z t | |W S ttfk
|
r$ Y nX z t| |W S ttfk
|
rJ Y nX t| trbtd| td| dS )aÐ 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.
|
|
zx%r does not appear to be an IPv4 or IPv6 network. Did you pass in a bytes (str in Python 2) instead of a unicode object?z0%r does not appear to be an IPv4 or IPv6 networkN)Ú IPv4NetworkrA rD Ú IPv6Networkr rG rH )rJ Ústrictr r r Ú
|
ip_network« s"
|
þÿÿrO c C sX z
|
t | W S ttfk
|
r" Y nX z
|
t| W S ttfk
|
rF Y nX td| dS )ag 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.
|
|
z2%r does not appear to be an IPv4 or IPv6 interfaceN)Ú IPv4InterfacerA rD Ú IPv6InterfacerH rI r r r Ú ip_interfaceÏ s
|
|
ÿrR c C s6 zt | ddW S tjtfk
|
r0 tdY nX dS )a` 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.
|
|
r r z&Address negative or too large for IPv4N©r r r Ú OverflowErrorrH rI r r r Úv4_int_to_packedò s rU c C s6 zt | ddW S tjtfk
|
r0 tdY nX dS )zõ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.
|
|
r r z&Address negative or too large for IPv6NrS rI r r r Úv6_int_to_packed s
|
rV c C s* t | d¡}t|dkr&td| |S )zAHelper to split the netmask and raise AddressValueError if neededú/r z Only one '/' permitted in %r)Ú _compat_strÚsplitÚlenrA )rJ Úaddrr r r Ú_split_optional_netmask s r\ c c sN t | }t| }}|D ]&}|j|jd kr:||fV |}|}q||fV dS )zÏFind a sequence of sorted deduplicated IPv#Address.
|
|
Args:
|
addresses: a list of IPv#Address objects.
|
|
Yields:
|
A tuple containing the first and last IP addresses in the sequence.
|
|
r' N)ÚiterÚnextÚ_ip)Ú addressesÚitÚfirstÚlastÚipr r r Ú_find_address_range s
|
|
re c C s$ | dkr |S t |t| | d @ S )zå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.
|
|
r r' )Úminr# )ÚnumberÚbitsr r r Ú_count_righthand_zero_bits2 s ri c c sâ t | trt |ts td| j|jkr8td| |f | |krHtd| jdkrXt}n| jdkrht}ntd| j}| j}|j}||krÞt t
|
||t || d d }|||| f}|V |d|> 7 }|d |j krqÞqdS ) a¤ 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.
|
|
z1first and last must be IP addresses, not networksú%%s and %s are not of the same versionz*last IP address must be greater than firstr é zunknown IP versionr' N) r Ú _BaseAddressÚ TypeErrorÚversionrH rL rM Ú_max_prefixlenr_ rf ri r# Ú _ALL_ONES)rb rc rd Úip_bitsÚ first_intÚlast_intÚnbitsÚnetr r r Úsummarize_address_rangeB s8
|
ÿ ÿ
|
|
|
ÿ rv c c s t | }i }|rV| ¡ }| ¡ }| |¡}|dkr<|||< q ||kr ||= | |¡ q d}t| ¡ D ]$}|dk r|j|jkrqf|V |}qfdS )au 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_internal([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.
|
|
N)ÚlistÚpopÚsupernetÚgetÚappendÚsortedÚvaluesÚbroadcast_address)r` Úto_mergeÚsubnetsru ry Úexistingrc r r r Ú _collapse_addresses_internaly s$
|
|
r c C s0 g }g }g }| D ]Ü}t |trR|rF|d j|jkrFtd||d f | |¡ q|j|jkrº|r|d j|jkrtd||d f z| |j¡ W qì tk
|
r¶ | |j ¡ Y qìX q|râ|d j|jkrâtd||d f | |¡ qt
|
t |}|r$t |D ]\}}| t||¡ qt|| S )aË 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.
|
|
éÿÿÿÿrj )r rl Ú_versionrm r{ Ú
|
_prefixlenro rd ÚAttributeErrorÚnetwork_addressr| Úsetre Úextendrv r )r` ÚaddrsÚipsÚnetsrd rb rc r r r Úcollapse_addressesª s@
|
ÿ ÿ ÿ r c C s( t | tr| ¡ S t | tr$| ¡ S tS )a2 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.
|
|
)r Ú _BaseNetworkÚ_get_networks_keyrl Ú_get_address_keyr2 )Úobjr r r Úget_mixed_type_keyà s
|
|
|
r c @ s e Zd ZdZdZedd Zedd Zedd Zed d
|
Z d d Z
|
d d Z e dd Z e dd Ze dd Ze dd Ze dd Zdd ZdS ) Ú_IPAddressBasezThe mother class.r c C s | ¡ S )z:Return the longhand version of the IP address as a string.)Ú _explode_shorthand_ip_string©r/ r r r Úexplodedÿ s z_IPAddressBase.explodedc C s t | S )z;Return the shorthand version of the IP address as a string.©rX r r r r Ú
|
compressed s z_IPAddressBase.compressedc C s | ¡ S )aI The name of the reverse DNS pointer for the IP address, e.g.:
|
>>> ipaddress.ip_address("127.0.0.1").reverse_pointer
|
'1.0.0.127.in-addr.arpa'
|
>>> ipaddress.ip_address("2001:db8::1").reverse_pointer
|
'1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa'
|
|
)Ú_reverse_pointerr r r r Úreverse_pointer s z _IPAddressBase.reverse_pointerc C s dt | f }t|d S )Nz %200s has no version specified©Útyper ©r/ Úmsgr r r rn s z_IPAddressBase.versionc C sF |dk r d}t ||| jf || jkrBd}t ||| j| jf d S )Nr z-%d (< 0) is not permitted as an IPv%d addressz2%d (>= 2**%d) is not permitted as an IPv%d address)rA r rp ro )r/ rJ r r r r Ú_check_int_address s
|
|
ÿz!_IPAddressBase._check_int_addressc C s. t |}||kr*d}t||||| jf d S )Nz~%r (len %d != %d) is not permitted as an IPv%d address. Did you pass in a bytes (str in Python 2) instead of a unicode object?)rZ rA r )r/ rJ Ú expected_lenÚ address_lenr r r r Ú_check_packed_address" s ÿ ÿz$_IPAddressBase._check_packed_addressc C s | j | j |? A S )z¦Turn the prefix length into a bitwise netmask
|
|
Args:
|
prefixlen: An integer, the prefix length.
|
|
Returns:
|
An integer.
|
|
)rp )ÚclsÚ prefixlenr r r Ú_ip_int_from_prefix, s z"_IPAddressBase._ip_int_from_prefixc C s\ t || j}| j| }||? }d|> d }||krX| jd }t||d}d}t|| |S )a Return prefix length from the bitwise netmask.
|
|
Args:
|
ip_int: An integer, the netmask in expanded bitwise format
|
|
Returns:
|
An integer, the prefix length.
|
|
Raises:
|
ValueError: If the input intermingles zeroes & ones
|
r' r r z&Netmask pattern %r mixes zeroes & ones)ri ro r rH ) r£ Úip_intÚtrailing_zeroesr¤ Ú leading_onesÚall_onesÚbyteslenÚdetailsr r r r Ú_prefix_from_ip_int9 s ÿ
|
|
z"_IPAddressBase._prefix_from_ip_intc C s d| }t |d S )Nz%r is not a valid netmask)rD )r£ Ú netmask_strr r r r Ú_report_invalid_netmaskR s z&_IPAddressBase._report_invalid_netmaskc C sh t j |¡s| |¡ z t|}W n tk
|
r@ | |¡ Y nX d| krX| jksdn | |¡ |S )a 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
|
r )Ú_BaseV4Ú_DECIMAL_DIGITSÚ
|
issupersetr® ÚintrH ro )r£ Ú prefixlen_strr¤ r r r Ú_prefix_from_prefix_stringW s
|
|
z)_IPAddressBase._prefix_from_prefix_stringc C s z| |¡}W n tk
|
r, | |¡ Y nX z | |¡W S tk
|
rN Y nX || jN }z | |¡W S tk
|
r | |¡ Y nX dS )a 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)Ú_ip_int_from_stringrA r® r¬ rH rp )r£ Úip_strr¦ r r r Ú_prefix_from_ip_stringp s
|
z%_IPAddressBase._prefix_from_ip_stringc C s | j t| ffS r )Ú __class__rX r r r r Ú
|
__reduce__ s z_IPAddressBase.__reduce__N)r< r= r> rC r? Úpropertyr r r rn r r¢ Ú classmethodr¥ r¬ r® r´ r· r¹ r r r r r ù s.
|
|
|
|
|
|
|
|
|
|
|
!r c @ sd e Zd ZdZdZdd Zdd Zdd Zd d
|
Zd d Z d d Z
|
dd Z dd Z dd Z dd ZdS )rl zA generic IP object.
|
|
This IP class contains the version independent methods which are
|
used by single IP addresses.
|
r c C s | j S r ©r_ r r r r Ú__int__ s z_BaseAddress.__int__c C s8 z| j |j ko| j|jkW S tk
|
r2 t Y S X d S r )r_ r r r2 r. r r r r1 £ s
|
ÿz_BaseAddress.__eq__c C s` t |tstS t |ts(td| |f | j|jkrDtd| |f | j|jkr\| j|jk S dS ©Nú"%s and %s are not of the same typerj F)r r r2 rl rm r r_ r. r r r r5 ª s
|
|
ÿ ÿ z_BaseAddress.__lt__c C s t |tstS | t| | ¡S r ©r r r2 r¸ r² r. r r r Ú__add__¹ s
|
z_BaseAddress.__add__c C s t |tstS | t| | ¡S r rÀ r. r r r Ú__sub__¾ s
|
z_BaseAddress.__sub__c C s d| j jt| f S ©Nz%s(%r)©r¸ r< rX r r r r Ú__repr__Ã s z_BaseAddress.__repr__c C s t | | j¡S r )rX Ú_string_from_ip_intr_ r r r r Ú__str__Æ s z_BaseAddress.__str__c C s t tt| jS r )ÚhashÚhexr² r_ r r r r Ú__hash__É s z_BaseAddress.__hash__c C s
|
| j | fS r ©r r r r r r Ì s z _BaseAddress._get_address_keyc C s | j | jffS r )r¸ r_ r r r r r¹ Ï s z_BaseAddress.__reduce__N)r< r= r> rC r? r½ r1 r5 rÁ r rÅ rÇ rÊ r r¹ r r r r rl s rl c @ sd e Zd ZdZdd Zdd Zdd Zdd Zd
|
d Zd d Z dd Z
|
dd Z dd Z dd Z dd Zedd Zedd Zed d Zed d Zed d! Zed"d# Zed$d% Zed&d' Zd(d) Zd*d+ Zd,d- ZdHd0d1ZdId2d3Z ed4d5 Z e d6d7 Z d8d9 Z d:d; Z!ed<d= Z"ed>d? Z#ed@dA Z$edBdC Z%edDdE Z&edFdG Z'd/S )Jr z~A generic IP network object.
|
|
This IP class contains the version independent methods which are
|
used by networks.
|
|
c C s
|
i | _ d S r )Ú_cache)r/ rJ r r r Ú__init__Û s z_BaseNetwork.__init__c C s d| j jt| f S rà rÄ r r r r rÅ Þ s z_BaseNetwork.__repr__c C s d| j | jf S ©Nú%s/%d)r r¤ r r r r rÇ á s z_BaseNetwork.__str__c c s8 t | j}t | j}t|d |D ]}| |¡V q"dS )zGenerate Iterator over usable hosts in a network.
|
|
This is like __iter__ except it doesn't return the network
|
or broadcast addresses.
|
|
r' N©r² r r~ r+ Ú_address_class©r/ ÚnetworkÚ broadcastÚxr r r Úhostsä s
|
|
z_BaseNetwork.hostsc c s8 t | j}t | j}t||d D ]}| |¡V q"d S ©Nr' rÐ rÒ r r r Ú__iter__ð s
|
|
z_BaseNetwork.__iter__c C sl t | j}t | j}|dkr>|| |kr0td| || ¡S |d7 }|| |k rZtd| || ¡S d S )Nr zaddress out of ranger' )r² r r~ Ú
|
IndexErrorrÑ )r/ ÚnrÓ rÔ r r r Ú __getitem__ö s
|
|
z_BaseNetwork.__getitem__c C sx t |tstS t |ts(td| |f | j|jkrDtd| |f | j|jkr\| j|jk S | j|jkrt| j|jk S dS r¾ )r r r2 r rm r r Únetmaskr. r r r r5 s"
|
|
ÿ ÿ z_BaseNetwork.__lt__c C sL z.| j |j ko,| j|jko,t| jt|jkW S tk
|
rF t Y S X d S r )r r r² rÜ r r2 r. r r r r1 s
|
ÿþz_BaseNetwork.__eq__c C s t t| jt| jA S r )rÈ r² r rÜ r r r r rÊ s z_BaseNetwork.__hash__c C sL | j |j krdS t|tr dS t| jt|j koBt| jkS S d S ©NF)r r r r² r r_ r~ r. r r r Ú __contains__ s
|
ÿz_BaseNetwork.__contains__c C s( | j |kp&| j|kp&|j | kp&|j| kS )z*Tell if self is partly contained in other.)r r~ r. r r r Úoverlaps* s
|
|
|
|
ýz_BaseNetwork.overlapsc C s< | j d¡}|d kr8| t| jt| jB ¡}|| j d< |S )Nr~ )rÌ rz rÑ r² r Úhostmask©r/ rÕ r r r r~ 1 s ÿ
|
z _BaseNetwork.broadcast_addressc C s8 | j d¡}|d kr4| t| j| jA ¡}|| j d< |S )Nrà )rÌ rz rÑ r² rÜ rp rá r r r rà : s
|
|
z_BaseNetwork.hostmaskc C s d| j | jf S rÎ )r r
r r r r Úwith_prefixlenB s z_BaseNetwork.with_prefixlenc C s d| j | jf S ©Nú%s/%s)r rÜ r r r r Ú with_netmaskF s z_BaseNetwork.with_netmaskc C s d| j | jf S rã )r rà r r r r Ú with_hostmaskJ s z_BaseNetwork.with_hostmaskc C s t | jt | j d S )z&Number of hosts in the current subnet.r' )r² r~ r r r r r Ú num_addressesN s z_BaseNetwork.num_addressesc C s dt | f }t|d S )Nz%%200s has no associated address classr r r r r rÑ S s z_BaseNetwork._address_classc C s | j S r )r
r r r r r¤ [ s z_BaseNetwork.prefixlenc c s | j |j ks td| |f t|ts2td| | | ¡sLtd|| f || krXdS | d|j|jf ¡}| ¡ \}}||krÚ||krÚ| |¡r¨|V | ¡ \}}qz| |¡rÆ|V | ¡ \}}qzt
|
d|||f qz||krê|V n"||krú|V nt
|
d|||f dS )aº Remove an address from a larger block.
|
|
For example:
|
|
addr1 = ip_network('192.0.2.0/28')
|
addr2 = ip_network('192.0.2.1/32')
|
list(addr1.address_exclude(addr2)) =
|
[IPv4Network('192.0.2.0/32'), IPv4Network('192.0.2.2/31'),
|
IPv4Network('192.0.2.4/30'), IPv4Network('192.0.2.8/29')]
|
|
or IPv6:
|
|
addr1 = ip_network('2001:db8::1/32')
|
addr2 = ip_network('2001:db8::1/128')
|
list(addr1.address_exclude(addr2)) =
|
[ip_network('2001:db8::1/128'),
|
ip_network('2001:db8::2/127'),
|
ip_network('2001:db8::4/126'),
|
ip_network('2001:db8::8/125'),
|
...
|
ip_network('2001:db8:8000::/33')]
|
|
Args:
|
other: An IPv4Network or IPv6Network object of the same type.
|
|
Returns:
|
An iterator of the IPv(4|6)Network objects which is self
|
minus other.
|
|
Raises:
|
TypeError: If self and other are of differing address
|
versions, or if other is not a network object.
|
ValueError: If other is not completely contained by self.
|
|
rj z%s is not a network objectz%s not contained in %sNrä z3Error performing exclusion: s1: %s s2: %s other: %s) r rm r r Ú subnet_ofrH r¸ r r¤ r r )r/ r0 Ús1Ús2r r r Úaddress_exclude_ s@ $ ÿ
|
|
|
ÿ
|
|
þþz _BaseNetwork.address_excludec C s` | j |j kr td| |f | j|jk r,dS | j|jkr<dS | j|jk rLdS | j|jkr\dS dS )a¥ Compare two IP objects.
|
|
This is only concerned about the comparison of the integer
|
representation of the network addresses. This means that the
|
host bits aren't considered at all in this method. If you want
|
to compare host bits, you can easily enough do a
|
'HostA._ip < HostB._ip'
|
|
Args:
|
other: An IP object.
|
|
Returns:
|
If the IP versions of self and other are the same, returns:
|
|
-1 if self < other:
|
eg: IPv4Network('192.0.2.0/25') < IPv4Network('192.0.2.128/25')
|
IPv6Network('2001:db8::1000/124') <
|
IPv6Network('2001:db8::2000/124')
|
0 if self == other
|
eg: IPv4Network('192.0.2.0/24') == IPv4Network('192.0.2.0/24')
|
IPv6Network('2001:db8::1000/124') ==
|
IPv6Network('2001:db8::1000/124')
|
1 if self > 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.
|
|
r¿ r r' r )r rm r rÜ r. r r r Úcompare_networksª s ! ÿ z _BaseNetwork.compare_networksc C s | j | j| jfS )zË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().
|
|
)r r rÜ r r r r r Ú s z _BaseNetwork._get_networks_keyr' Nc c sÒ | j | jkr| V dS |dk rJ|| j k r0td|dkr@td|| j }|dk rZtd| j | }|| jkr~td|| f t| j}t| jd }t| jd |? }t|||D ]}| ||f¡}|V q´dS )aÓ 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)
|
|
Nznew prefix must be longerr' ú(cannot set prefixlen_diff and new_prefixr z prefix length diff must be > 0z0prefix length diff %d is invalid for netblock %s) r
ro rH r² r r~ rà r+ r¸ ) r/ Úprefixlen_diffÚ
|
new_prefixÚ new_prefixlenr( r) r* Únew_addrÚcurrentr r r r ä s2
|
|
|
|
ÿÿ
|
z_BaseNetwork.subnetsc C s | j dkr| S |dk rB|| j kr(td|dkr8td| j | }| j| }|dk rftd| j|f | t| jt| j|> @ |f¡S )aË 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)
|
|
r Nznew prefix must be shorterr' rí z;current prefixlen is %d, cannot have a prefixlen_diff of %d)r
rH r¤ r¸ r² r rÜ )r/ rî rï rð r r r ry s&
|
|
|
|
ÿÿþz_BaseNetwork.supernetc C s | j jo| jjS ©z»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.
|
|
)r Ú is_multicastr~ r r r r rô A s ÿz_BaseNetwork.is_multicastc C s` z6| j |j kr td| |f |j| jko4|j| jkW S tk
|
rZ td| |f Y nX d S )Nrj z3Unable to test subnet containment between %s and %s)r rm r r~ r )Úar r r r Ú _is_subnet_ofM s
|
ÿ
|
ÿÿz_BaseNetwork._is_subnet_ofc C s | | |¡S )z1Return True if this network is a subnet of other.©rö r. r r r rè Z s z_BaseNetwork.subnet_ofc C s | || ¡S )z3Return True if this network is a supernet of other.r÷ r. r r r Ú supernet_of^ s z_BaseNetwork.supernet_ofc C s | j jo| jjS )úµTest if the address is otherwise IETF reserved.
|
|
Returns:
|
A boolean, True if the address is within one of the
|
reserved IPv6 Network ranges.
|
|
)r Ú is_reservedr~ r r r r rú b s ÿz_BaseNetwork.is_reservedc C s | j jo| jjS ©zTest if the address is reserved for link-local.
|
|
Returns:
|
A boolean, True if the address is reserved per RFC 4291.
|
|
)r Ú is_link_localr~ r r r r rü n s ÿz_BaseNetwork.is_link_localc C s | j jo| jjS )zÔTest if this address is allocated for private networks.
|
|
Returns:
|
A boolean, True if the address is reserved per
|
iana-ipv4-special-registry or iana-ipv6-special-registry.
|
|
)r Ú
|
is_privater~ r r r r rý y s ÿz_BaseNetwork.is_privatec C s | j S )z×Test if this address is allocated for public networks.
|
|
Returns:
|
A boolean, True if the address is not reserved per
|
iana-ipv4-special-registry or iana-ipv6-special-registry.
|
|
©rý r r r r Ú is_global
s z_BaseNetwork.is_globalc C s | j jo| jjS )ú¨Test if the address is unspecified.
|
|
Returns:
|
A boolean, True if this is the unspecified address as defined in
|
RFC 2373 2.5.2.
|
|
)r Úis_unspecifiedr~ r r r r r s ÿz_BaseNetwork.is_unspecifiedc C s | j jo| jjS )ú±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.
|
|
)r Ú is_loopbackr~ r r r r r s ÿz_BaseNetwork.is_loopback)r' N)r' N)(r< r= r> rC rÍ rÅ rÇ rÖ rØ rÛ r5 r1 rÊ rÞ rß rº r~ rà râ rå ræ rç rÑ r¤ rë rì r r ry rô Ú staticmethodrö rè rø rú rü rý rÿ r r r r r r r Ó sf
|
|
|
|
|
|
|
|
K0
|
|
5
|
(
|
|
|
|
|
|
|
|
|
r c
|
@ s® e Zd ZdZdZdZde d ZedZ eddd d
|
d d d ddg Z
|
eZ i Z dd Z edd Zedd Zedd Zedd Zdd Zd d Zed d Zed d! Zd"S )#r¯ zyBase IPv4 object.
|
|
The following methods are used by IPv4 objects in both single IP
|
addresses and networks.
|
|
r r r r' Ú
|
0123456789éÿ éþ éü éø éð éà éÀ r r c C s t | S r r r r r r r À s z$_BaseV4._explode_shorthand_ip_stringc C sn || j krdt|tr|}n.z| |¡}W n tk
|
rF | |¡}Y nX t| |¡}||f| j |< | j | S ©a Make a (netmask, prefix_len) tuple from the given argument.
|
|
Argument can be:
|
- an integer (the prefix length)
|
- a string representing the prefix length (e.g. "24")
|
- a string representing the prefix netmask (e.g. "255.255.255.0")
|
)Ú_netmask_cacher r r´ rD r· rE r¥ ©r£ Úargr¤ rÜ r r r Ú _make_netmaskà s
|
|
z_BaseV4._make_netmaskc
|
C sz |s t d| d¡}t|dkr.t d| ztt| j|dW S tk
|
rt } zt d||f W 5 d}~X Y nX dS )a 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.
|
|
úAddress cannot be emptyÚ.r zExpected 4 octets in %rr ú%s in %rN)rA rY rZ r ÚmapÚ _parse_octetrH )r£ r¶ ÚoctetsÚexcr r r rµ Û s
|
|
ÿz_BaseV4._ip_int_from_stringc C s |s t d| j |¡s(d}t || t|dkrDd}t || t|d}|dkrr|d dkrrd }t || |d
|
krt d | |S ) a 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].
|
|
zEmpty octet not permittedz#Only decimal digits permitted in %ré z$At most 3 characters permitted in %ré
|
é r Ú0z3Ambiguous (octal/decimal) value in %r not permittedr z Octet %d (> 255) not permitted)rH r° r± rZ r² )r£ Ú octet_strr Ú octet_intr r r r ö s
|
z_BaseV4._parse_octetc C s d dd t|ddD ¡S )zÒ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.
|
|
r c s s0 | ](}t t|tr"t d |¡d n|V qdS )r r N)rX r rG r r
|
r r r r Ú <genexpr>& s ýÿþz._BaseV4._string_from_ip_int.<locals>.<genexpr>r r )Újoinr )r£ r¦ r r r rÆ s
|
|
ýz_BaseV4._string_from_ip_intc sj | d¡}z fddtt|D }W n tk
|
r< Y dS X t|t|krRdS |d |d k rfdS dS )zÙ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.
|
|
r c s g | ]}| j kr|qS r )Ú_valid_mask_octets©r rÕ r r r r 7 s
|
z(_BaseV4._is_hostmask.<locals>.<listcomp>Fr r T)rY r r² rH rZ )r/ r¶ rh Úpartsr r r Ú _is_hostmask+ s
|
|
z_BaseV4._is_hostmaskc C s& t | d¡ddd
}d |¡d S )zReturn the reverse DNS pointer name for the IPv4 address.
|
|
This implements the method described in RFC1035 3.5.
|
|
r Nr z .in-addr.arpa)rX rY r )r/ Úreverse_octetsr r r r @ s z_BaseV4._reverse_pointerc C s | j S r ©ro r r r r Ú max_prefixlenI s z_BaseV4.max_prefixlenc C s | j S r rË r r r r rn M s z_BaseV4.versionN)r< r= r> rC r? r Ú
|
IPV4LENGTHrp Ú frozensetr° r! ro r r r» r rµ r rÆ r$ r rº r' rn r r r r r¯ © s.
|
|
|
$
|
|
r¯ c @ s| e Zd ZdZdZdd Zedd Zedd Zed d
|
Z ed d Z
|
ed d Z edd Z edd Z edd ZdS )rE z/Represent and manipulate single IPv4 Addresses.©r_ Ú __weakref__c C sx t |tr | |¡ || _dS t |trL| |d¡ t|}t|d| _dS t|}d|krht d| |
|
|¡| _dS )a±
|
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.
|
|
Nr r rW úUnexpected '/' in %r© r r r r_ rG r¢ r r rX rA rµ ©r/ rJ ZbvsÚaddr_strr r r rÍ X s
|
|
|
zIPv4Address.__init__c C s
|
t | jS ©z*The binary representation of this address.)rU r_ r r r r Úpacked| s zIPv4Address.packedc C s | | j jkS )z°Test if the address is otherwise IETF reserved.
|
|
Returns:
|
A boolean, True if the address is within the
|
reserved IPv4 Network range.
|
|
)Ú
|
_constantsÚ_reserved_networkr r r r rú s zIPv4Address.is_reservedc s t fdd jjD S )z¶Test if this address is allocated for private networks.
|
|
Returns:
|
A boolean, True if the address is reserved per
|
iana-ipv4-special-registry.
|
|
c 3 s | ]} |kV qd S r r ©r ru r r r r s z)IPv4Address.is_private.<locals>.<genexpr>©Úanyr2 Ú_private_networksr r r r rý s zIPv4Address.is_privatec C s | | j jko| j S r )r2 Ú_public_networkrý r r r r rÿ s þzIPv4Address.is_globalc C s | | j jkS )zTest if the address is reserved for multicast use.
|
|
Returns:
|
A boolean, True if the address is multicast.
|
See RFC 3171 for details.
|
|
©r2 Ú_multicast_networkr r r r rô s zIPv4Address.is_multicastc C s | | j jkS )z¤Test if the address is unspecified.
|
|
Returns:
|
A boolean, True if this is the unspecified address as defined in
|
RFC 5735 3.
|
|
)r2 Ú_unspecified_addressr r r r r ¨ s zIPv4Address.is_unspecifiedc C s | | j jkS )zTest if the address is a loopback address.
|
|
Returns:
|
A boolean, True if the address is a loopback per RFC 3330.
|
|
)r2 Ú_loopback_networkr r r r r ³ s zIPv4Address.is_loopbackc C s | | j jkS )zTest if the address is reserved for link-local.
|
|
Returns:
|
A boolean, True if the address is link-local per RFC 3927.
|
|
©r2 Ú_linklocal_networkr r r r rü ½ s zIPv4Address.is_link_localN)r< r= r> rC r? rÍ rº r1 rú rý rÿ rô r r rü r r r r rE R s& $
|
|
|
|
|
|
|
|
|
|
|
rE c @ sj e Zd Zdd Zdd Zdd Zdd Zd d
|
Zej Z e
|
d d Z e
|
d d Z e
|
dd Z e
|
dd ZdS )rP c C sÞ t |ttfr2t | |¡ t| j| _| j| _ d S t |t
|
rt | |d ¡ t |dkrht |d | _ n| j| _ t|dd| _| jj | _ | jj| _d S t|}t | |d ¡ t|dd| _| jj | _ | jj | _ | jj| _d S ©Nr r' F)rN )r rG r rE rÍ rL r_ rÓ ro r
ÚtuplerZ r² rÜ rà r\ ©r/ rJ r[ r r r rÍ Ê s(
|
|
|
|
|
zIPv4Interface.__init__c C s d| | j¡| jjf S rÎ ©rÆ r_ rÓ r¤ r r r r rÇ æ s ÿzIPv4Interface.__str__c C sF t | |¡}|r|tkr |S z| j|jkW S tk
|
r@ Y dS X d S rÝ )rE r1 r2 rÓ r ©r/ r0 Ú address_equalr r r r1 ê s zIPv4Interface.__eq__c C sR t | |¡}|tkrtS z | j|jk p4| j|jko4|W S tk
|
rL Y dS X d S rÝ )rE r5 r2 rÓ r ©r/ r0 Ú address_lessr r r r5 ö s ÿzIPv4Interface.__lt__c C s | j | jA t| jjA S r ©r_ r
r² rÓ r r r r r rÊ s zIPv4Interface.__hash__c C s
|
t | jS r )rE r_ r r r r rd s zIPv4Interface.ipc C s d| | j¡| jf S rã ©rÆ r_ r
r r r r râ s ÿz IPv4Interface.with_prefixlenc C s d| | j¡| jf S rã ©rÆ r_ rÜ r r r r rå s ÿzIPv4Interface.with_netmaskc C s d| | j¡| jf S rã ©rÆ r_ rà r r r r ræ s ÿzIPv4Interface.with_hostmaskN)r< r= r> rÍ rÇ r1 r5 rÊ r r¹ rº rd râ rå ræ r r r r rP È s
|
|
|
rP c @ s* e Zd ZdZeZdddZedd ZdS ) rL ae 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
|
|
Tc C s| t | |¡ t|ttfr<t|| _| | j¡\| _ | _
|
dS t|t rÈt |dkr\|d }n| j}t|d | _| |¡\| _ | _
|
t | j}|t | j @ |krÄ|r°td| nt|t | j @ | _dS t|}t| |d ¡| _t |dkrú|d }n| j}| |¡\| _ | _
|
|rDtt | jt | j @ | jkrDtd| tt | jt | j @ | _| j
|
| jd krx| j| _dS )a 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.
|
|
Nr' r ú%s has host bits setr )r rÍ r r rG rE r r ro rÜ r
r@ rZ r² rH r\ rµ rØ rÖ ©r/ rJ rN r r1 r[ r r r rÍ * sJ %
|
ÿ
|
|
|
ÿ
|
ÿ
|
ÿzIPv4Network.__init__c C s& | j tdko| jtdk o$| j S )z¹Test if this address is allocated for public networks.
|
|
Returns:
|
A boolean, True if the address is not reserved per
|
iana-ipv4-special-registry.
|
|
ú 100.64.0.0/10)r rL r~ rý r r r r rÿ s
|
ÿþzIPv4Network.is_globalN)T) r< r= r> rC rE rÑ rÍ rº rÿ r r r r rL s
|
|
UrL c @ s e Zd ZedZedZedZedZededededededed ed
|
ed ed ed edededgZedZ e
|
dZ dS )Ú_IPv4Constantsz169.254.0.0/16z 127.0.0.0/8z 224.0.0.0/4rM z 0.0.0.0/8z
|
10.0.0.0/8z 172.16.0.0/12z 192.0.0.0/29z192.0.0.170/31z 192.0.2.0/24z192.168.0.0/16z 198.18.0.0/15z198.51.100.0/24z203.0.113.0/24z 240.0.0.0/4z255.255.255.255/32z0.0.0.0N) r< r= r> rL r> r< r: r8 r7 r3 rE r; r r r r rN s* òrN c @ s e Zd ZdZdZdZde d ZdZe dZ
|
eZ i Z e dd Ze d
|
d Ze d d Ze dd Ze dddZdd Zdd Zedd Zedd ZdS ) Ú_BaseV6zyBase IPv6 object.
|
|
The following methods are used by IPv6 objects in both single IP
|
addresses and networks.
|
|
r rk r r' r Ú0123456789ABCDEFabcdefc C sJ || j kr@t|tr|}n
|
| |¡}t| |¡}||f| j |< | j | S r )r r r r´ rF r¥ r r r r r Ä s
|
|
|
z_BaseV6._make_netmaskc
|
C sØ |s t d| d¡}d}t||k r:d||f }t |d|d kr´zt| ¡ j}W n2 t k
|
r } zt d||f W 5 d}~X Y nX | d |d
|
? d @ ¡ | d |d @ ¡ | jd }t||krâd |d |f }t |d}td t|d D ]*} || sø|dk r d| }t || }qø|dk rÆ|}
|
t|| d } |d sj|
|
d 8 }
|
|
|
rjd}t || |d s| d 8 } | rd}t || | j|
|
| } | d k r0d}t || jd |f njt|| jkrìd}t || j|f |d sd}t || |d s d}t || t|}
|
d} d} znd} t |
|
D ] } | d
|
K } | |
|
|| ¡O } q>| d
|
| K } t | dD ] } | d
|
K } | |
|
|| ¡O } qx| W S t k
|
rÒ } zt d||f W 5 d}~X Y nX dS )zù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.
|
|
r ú:r z At least %d parts expected in %rr r r Nú%xr éÿÿ r' z!At most %d colons permitted in %rz At most one '::' permitted in %rr z0Leading ':' only permitted as part of '::' in %rz1Trailing ':' only permitted as part of '::' in %rz/Expected at most %d other parts with '::' in %rz,Exactly %d parts expected without '::' in %r) rA rY rZ rE rx r_ r{ Ú _HEXTET_COUNTr+ ÚrangeÚ _parse_hextetrH )r£ r¶ r# Ú
|
_min_partsr Úipv4_intr Ú
|
_max_partsÚ
|
skip_indexr" Úparts_hiÚparts_loÚ parts_skippedr¦ r r r rµ Ö s
|
"
|
ÿ
|
|
|
|
|
|
|
z_BaseV6._ip_int_from_stringc C s> | j |¡std| t|dkr4d}t|| t|dS )a& 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].
|
|
z Only hex digits permitted in %rr z$At most 4 characters permitted in %rr )Ú _HEX_DIGITSr± rH rZ r² )r£ Ú
|
hextet_strr r r r rV ? s z_BaseV6._parse_hextetc C s¢ d}d}d}d}t |D ]>\}}|dkrN|d7 }|dkr<|}||krV|}|}qd}d}q|dkr|| }|t|kr~|dg7 }dg|||
< |dkrdg| }|S )aä 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.
|
|
r r r r' Ú )Ú enumeraterZ ) r£ ÚhextetsÚbest_doublecolon_startÚbest_doublecolon_lenÚdoublecolon_startÚdoublecolon_lenÚindexÚhextetÚbest_doublecolon_endr r r Ú_compress_hextetsY s0 ÿ
|
|
z_BaseV6._compress_hextetsNc sZ |dkrt | j}|| jkr$tdd| fddtdddD }| |¡}d |¡S )
|
a, 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.
|
|
NzIPv6 address is too largeú%032xc s& g | ] }d t ||d
d qS )rR r r )r² r" ©Úhex_strr r r s z/_BaseV6._string_from_ip_int.<locals>.<listcomp>r r@ r rQ )r² r_ rp rH rU rj r )r£ r¦ rb r rl r rÆ s
|
|
|
z_BaseV6._string_from_ip_intc s t | trt| j}n t | tr,t| j}nt| }| |¡}d| fddtdddD }t | ttfrdd |¡| j
|
f S d |¡S ) z¬Expand a shortened IPv6 address.
|
|
Args:
|
ip_str: A string, the IPv6 address.
|
|
Returns:
|
A string, the expanded IPv6 address.
|
|
rk c s g | ]} ||d
qS )r r r" rl r r r ¶ s z8_BaseV6._explode_shorthand_ip_string.<locals>.<listcomp>r r@ r rÏ rQ ) r rM rX r rQ rd rµ rU r r r
)r/ r¶ r¦ r# r rl r r £ s
|
|
|
|
z$_BaseV6._explode_shorthand_ip_stringc C s& | j ddd
dd¡}d |¡d S )zReturn the reverse DNS pointer name for the IPv6 address.
|
|
This implements the method described in RFC3596 2.5.
|
|
Nr rQ r` r z .ip6.arpa)r Úreplacer )r/ Ú reverse_charsr r r r » s z_BaseV6._reverse_pointerc C s | j S r r& r r r r r' Ä s z_BaseV6.max_prefixlenc C s | j S r rË r r r r rn È s z_BaseV6.version)N)r< r= r> rC r? r Ú
|
IPV6LENGTHrp rT r) r^ ro r r» r rµ rV rj rÆ r r rº r' rn r r r r rO ° s0
|
|
h
|
|
/
|
rO c @ s¬ e Zd ZdZdZdd Zedd Zedd Zed d
|
Z ed d Z
|
ed d Z edd Z edd Z edd Zedd Zedd Zedd Zedd Zd S ) rF z/Represent and manipulate single IPv6 Addresses.r* c C sx t |tr | |¡ || _dS t |trL| |d¡ t|}t|d| _dS t|}d|krht d| |
|
|¡| _dS )a 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.
|
|
Nr r rW r, r- r. r r r rÍ Ó s
|
|
|
zIPv6Address.__init__c C s
|
t | jS r0 )rV r_ r r r r r1 ø s zIPv6Address.packedc C s | | j jkS ró r9 r r r r rô ý s zIPv6Address.is_multicastc s t fdd jjD S )rù c 3 s | ]} |kV qd S r r r" r r r r s z*IPv6Address.is_reserved.<locals>.<genexpr>)r6 r2 Ú_reserved_networksr r r r rú s zIPv6Address.is_reservedc C s | | j jkS rû r= r r r r rü s zIPv6Address.is_link_localc C s | | j jkS ©a` 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.
|
|
)r2 Ú_sitelocal_networkr r r r Ú is_site_local s zIPv6Address.is_site_localc s t fdd jjD S )z¶Test if this address is allocated for private networks.
|
|
Returns:
|
A boolean, True if the address is reserved per
|
iana-ipv6-special-registry.
|
|
c 3 s | ]} |kV qd S r r r4 r r r r 4 s z)IPv6Address.is_private.<locals>.<genexpr>r5 r r r r rý + s zIPv6Address.is_privatec C s | j S )z¹Test if this address is allocated for public networks.
|
|
Returns:
|
A boolean, true if the address is not reserved per
|
iana-ipv6-special-registry.
|
|
rþ r r r r rÿ 6 s zIPv6Address.is_globalc C s
|
| j dkS )r r r¼ r r r r r A s zIPv6Address.is_unspecifiedc C s
|
| j dkS )r r' r¼ r r r r r L s zIPv6Address.is_loopbackc C s | j d? dkrdS t| j d@ S )z¶Return the IPv4 mapped address.
|
|
Returns:
|
If the IPv6 address is a v4 mapped address, return the
|
IPv4 mapped address. Return None otherwise.
|
|
r@ rS Nì ÿÿ ©r_ rE r r r r Ú ipv4_mappedW s zIPv6Address.ipv4_mappedc C s4 | j d? dkrdS t| j d? d@ t| j d@ fS )zÛ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 Nr ru rv r r r r Úteredod s
|
|
ÿzIPv6Address.teredoc C s$ | j d? dkrdS t| j d? d@ S )zÎ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.
|
|
ép i NéP ru rv r r r r Ú sixtofours s zIPv6Address.sixtofourN)r< r= r> rC r? rÍ rº r1 rô rú rü rt rý rÿ r r rw ry r| r r r r rF Í s6 %
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
rF c @ s e Zd Zdd Zdd Zdd Zdd Zd d
|
Zej Z e
|
d d Z e
|
d d Z e
|
dd Z e
|
dd Ze
|
dd Ze
|
dd ZdS )rQ c C sÞ t |ttfr2t | |¡ t| j| _| j| _ d S t |t
|
rt | |d ¡ t |dkrht |d | _ n| j| _ t|dd| _| jj | _ | jj| _d S t|}t | |d ¡ t|dd| _| jj | _ | jj | _ | jj| _d S r? )r rG r rF rÍ rM r_ rÓ ro r
r@ rZ r² rÜ rà r\ rA r r r rÍ s(
|
|
|
|
|
zIPv6Interface.__init__c C s d| | j¡| jjf S rÎ rB r r r r rÇ s ÿzIPv6Interface.__str__c C sF t | |¡}|r|tkr |S z| j|jkW S tk
|
r@ Y dS X d S rÝ )rF r1 r2 rÓ r rC r r r r1 s zIPv6Interface.__eq__c C sR t | |¡}|tkrtS z | j|jk p4| j|jko4|W S tk
|
rL Y dS X d S rÝ )rF r5 r2 rÓ r rE r r r r5 « s ÿzIPv6Interface.__lt__c C s | j | jA t| jjA S r rG r r r r rÊ · s zIPv6Interface.__hash__c C s
|
t | jS r )rF r_ r r r r rd ¼ s zIPv6Interface.ipc C s d| | j¡| jf S rã rH r r r r râ À s ÿz IPv6Interface.with_prefixlenc C s d| | j¡| jf S rã rI r r r r rå Å s ÿzIPv6Interface.with_netmaskc C s d| | j¡| jf S rã rJ r r r r ræ Ê s ÿzIPv6Interface.with_hostmaskc C s | j dko| jjS r$ )r_ rÓ r r r r r r Ï s z IPv6Interface.is_unspecifiedc C s | j dko| jjS r× )r_ rÓ r r r r r r Ó s zIPv6Interface.is_loopbackN)r< r= r> rÍ rÇ r1 r5 rÊ r r¹ rº rd râ rå ræ r r r r r r rQ s$
|
|
|
|
|
rQ c @ s2 e Zd ZdZeZd
|
ddZdd Zedd Z d S ) rM av 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
|
|
Tc C s| t | |¡ t|ttfr<t|| _| | j¡\| _ | _
|
dS t|t rÈt |dkr\|d }n| j}| |¡\| _ | _
|
t|d | _t | j}|t | j @ |krÄ|r°td| nt|t | j @ | _dS t|}t| |d ¡| _t |dkrú|d }n| j}| |¡\| _ | _
|
|rDtt | jt | j @ | jkrDtd| tt | jt | j @ | _| j
|
| jd krx| j| _dS )aç 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.
|
|
Nr' r rK r )r rÍ r rG r rF r r ro rÜ r
r@ rZ r² rH r\ rµ rØ rÖ rL r r r rÍ è sJ
|
ÿ
|
|
|
ÿ
|
ÿ
|
ÿzIPv6Network.__init__c c s< t | j}t | j}t|d |d D ]}| |¡V q&dS )z¢Generate Iterator over usable hosts in a network.
|
|
This is like __iter__ except it doesn't return the
|
Subnet-Router anycast address.
|
|
r' NrÐ rÒ r r r rÖ 7 s
|
|
zIPv6Network.hostsc C s | j jo| jjS rr )r rt r~ r r r r rt C s ÿzIPv6Network.is_site_localN)T)
|
r< r= r> rC rF rÑ rÍ rÖ rº rt r r r r rM Ø s
|
O rM c @ s e Zd ZedZedZededededededed ed
|
ed edg
|
Zed ed edededededededededededededgZedZd S ) Ú_IPv6Constantsz fe80::/10zff00::/8z::1/128z::/128z ::ffff:0:0/96z100::/64z 2001::/23z 2001:2::/48z 2001:db8::/32z 2001:10::/28zfc00::/7z::/8z100::/8z200::/7z400::/6z800::/5z1000::/4z4000::/3z6000::/3z8000::/3zA000::/3zC000::/3zE000::/4zF000::/5zF800::/6zFE00::/9z fec0::/10N) r< r= r> rM r> r: r7 rq rs r r r r r} S s< ö ø r} )r' )T)8rC Ú
|
__future__r r% r Ú __version__r² r ÚlongÚ NameErrorÚunicoderX ÚstrrG r r Ú
|
from_bytesr r r Úhasattrr# r+ Úobjectr, r( rp rH rA rD rK rO rR rU rV r\ re ri rv r r r r rl r r¯ rE rP rL rN r2 rO rF rQ rM r} r r r r Ú<module> s
|
|
|
|
|
)$
|
$#716 = Y *vSr 5W{!
|
