|
Server : Apache System : Linux cvar2.toservers.com 3.10.0-962.3.2.lve1.5.73.el7.x86_64 #1 SMP Wed Aug 24 21:31:23 UTC 2022 x86_64 User : njnconst ( 1116) PHP Version : 8.4.18 Disable Function : NONE Directory : /lib/python2.7/site-packages/netaddr/ip/ |
Upload File : |
�
o�\c @ s+ d Z d d l Z d d l m Z m Z m Z m Z m Z m Z m
Z
m Z m Z m
Z
d d l m Z m Z d d l m Z m Z m Z m Z m Z d e f d � � YZ d e f d � � YZ d
e f d � � YZ e d d
� Z d e e f d � � YZ d e e f d � � YZ d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& d d � Z' d � Z( d � Z) d � Z* d � Z+ e d � Z, e d � e d � e d! � e d" � e d# � e d$ � e d% d& � f Z- e d' � Z. e d( � Z/ e d) � Z0 e d* � e d+ � e d, � e d- � e d. � e d/ � e d0 d1 � e d2 d3 � f e, e0 f Z1 e d4 � Z2 e d5 � e d6 � f Z3 e d7 � Z4 e d8 � Z5 e d9 � e d: � e d; � e d< � e d= � e d> � e d? � e d@ � e dA � e dB � e dC � e dD � e dE � e dF � e dG � e dH � f Z6 d S(I s9 Routines for IPv4 and IPv6 addresses, subnets and ranges.i����N(
t AddrFormatErrort AddrConversionErrort num_bitst
DictDotLookupt NOHOSTt Nt INET_PTONt Pt ZEROFILLt Z( t ipv4t ipv6( t _sys_maxintt _iter_ranget _is_strt _int_typet _str_typet BaseIPc B s� e Z d Z d Z d � Z d � Z e d � e d d �Z d � Z d � Z d
� Z
d � Z d � Z d
� Z
d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z e d � � Z e d � � Z RS( si
An abstract base class for common operations shared between various IP
related subclasses.
t _valuet _modulec C s d | _ d | _ d S( s Constructor.N( t NoneR R ( t self( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __init__ s c C sp t | t � s( t d t | � � � n d | k oE | j j k n sc t d | j j � � n | | _ d S( Ns int argument expected, not %si s& value out of bounds for an %s address!( t
isinstanceR t TypeErrort typeR t max_intR t family_nameR ( R t value( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt
_set_value s "c C s | j S( N( R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt <lambda>( s t docs? a positive integer representing the value of IP address/subnet.c C s t S( sP
:return: a key tuple that uniquely identifies this IP address.
( t NotImplemented( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt key+ s c C s t S( sg
:return: A key tuple used to compare and sort this `IPAddress`
correctly.
( R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt sort_key1 s c C s t | j � � S( sM
:return: A hash value uniquely indentifying this IP object.
( t hashR! ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __hash__8 s c C s9 y | j � | j � k SWn t t f k
r4 t SXd S( s�
:param other: an `IPAddress` or `IPNetwork` object.
:return: ``True`` if this `IPAddress` or `IPNetwork` object is
equivalent to ``other``, ``False`` otherwise.
N( R! t AttributeErrorR R ( R t other( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __eq__> s c C s9 y | j � | j � k SWn t t f k
r4 t SXd S( s�
:param other: an `IPAddress` or `IPNetwork` object.
:return: ``True`` if this `IPAddress` or `IPNetwork` object is
not equivalent to ``other``, ``False`` otherwise.
N( R! R% R R ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __ne__J s c C s9 y | j � | j � k SWn t t f k
r4 t SXd S( s�
:param other: an `IPAddress` or `IPNetwork` object.
:return: ``True`` if this `IPAddress` or `IPNetwork` object is
less than ``other``, ``False`` otherwise.
N( R" R% R R ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __lt__V s c C s9 y | j � | j � k SWn t t f k
r4 t SXd S( s�
:param other: an `IPAddress` or `IPNetwork` object.
:return: ``True`` if this `IPAddress` or `IPNetwork` object is
less than or equal to ``other``, ``False`` otherwise.
N( R" R% R R ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __le__b s c C s9 y | j � | j � k SWn t t f k
r4 t SXd S( s�
:param other: an `IPAddress` or `IPNetwork` object.
:return: ``True`` if this `IPAddress` or `IPNetwork` object is
greater than ``other``, ``False`` otherwise.
N( R" R% R R ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __gt__n s c C s9 y | j � | j � k SWn t t f k
r4 t SXd S( s�
:param other: an `IPAddress` or `IPNetwork` object.
:return: ``True`` if this `IPAddress` or `IPNetwork` object is
greater than or equal to ``other``, ``False`` otherwise.
N( R" R% R R ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __ge__z s c C s | j � S( s< :return: ``True`` if this IP is unicast, ``False`` otherwise( t is_multicast( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt
is_unicast� s c C s6 | j t k r | t k S| j t k r2 | t k Sd S( s> :return: ``True`` if this IP is multicast, ``False`` otherwiseN( R t _ipv4t IPV4_MULTICASTt _ipv6t IPV6_MULTICAST( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR- � s
c C s< | j j d k r | t k S| j j d k r8 | t k Sd S( s�
:return: ``True`` if this IP is loopback address (not for network
transmission), ``False`` otherwise.
References: RFC 3330 and 4291.
i i N( R t versiont
IPV4_LOOPBACKt
IPV6_LOOPBACK( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt is_loopback� s
c C s� | j j d k r6 xW t D] } | | k r t Sq Wn6 | j j d k rl x! t D] } | | k rO t SqO Wn | j � r| t St S( s�
:return: ``True`` if this IP is for internal/private use only
(i.e. non-public), ``False`` otherwise. Reference: RFCs 1918,
3330, 4193, 3879 and 2365.
i i ( R R3 t IPV4_PRIVATEt Truet IPV6_PRIVATEt
is_link_localt False( R t cidr( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt
is_private� s
c C s< | j j d k r | t k S| j j d k r8 | t k Sd S( s�
:return: ``True`` if this IP is link-local address ``False`` otherwise.
Reference: RFCs 3927 and 4291.
i i N( R R3 t IPV4_LINK_LOCALt IPV6_LINK_LOCAL( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR: � s
c C sp | j j d k r6 xW t D] } | | k r t Sq Wn6 | j j d k rl x! t D] } | | k rO t SqO Wn t S( s�
:return: ``True`` if this IP is in IANA reserved range, ``False``
otherwise. Reference: RFCs 3330 and 3171.
i i ( R R3 t
IPV4_RESERVEDR8 t
IPV6_RESERVEDR; ( R R< ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt is_reserved� s
c C s# | j j d k o" | j d ?d k S( sp
:return: ``True`` if this IP is IPv4-compatible IPv6 address, ``False``
otherwise.
i i i�� ( R R3 R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt is_ipv4_mapped� s c C s# | j j d k o" | j d ?d k S( sl
:return: ``True`` if this IP is IPv4-mapped IPv6 address, ``False``
otherwise.
i i i ( R R3 R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt is_ipv4_compat� s c C s d d l m } t | | � � S( s~
A record dict containing IANA registration details for this IP address
if available, None otherwise.
i����( t query( t netaddr.ip.ianaRE R ( R RE ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt info� s c C s
| j j S( s6 the IP protocol version represented by this IP object.( R R3 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR3 � s ( s _values _module( t __name__t
__module__t __doc__t __slots__R R t propertyR R! R" R$ R' R( R) R* R+ R, R. R- R6 R= R: RB RC RD RG R3 ( ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR s2
t IPAddressc B sy e Z d Z d$ Z d% d d � Z d � Z d � Z d � Z d � Z d � Z
d � Z d � Z d
� Z
e
Z d � Z d � Z d
� Z d � Z d � Z d � Z d � Z d � Z d � Z d% d � Z e d � � Z e d � � Z e d � � Z e d � � Z d � Z e d � Z d% d � Z! d � Z" d � Z# d � Z$ d � Z% d � Z& d! � Z' e' Z( d" � Z) d# � Z* RS(& s�
An individual IPv4 or IPv6 address without a net mask or subnet prefix.
To support these and other network based operations, see `IPNetwork`.
i c C s� t t | � j � t | t � rj | d k rO | | j j k rO t d � � n | j | _ | j | _ nM| d k r� | d k r� t
| _ q� | d k r� t | _ q� t d | � � n t | � r� d | k r� t d | j
j � � n | j d k rt | t � r�y� d t | � k o+t
j k n rKt | � | _ t
| _ nC t
j t | � k ont j k n r�t | � | _ t | _ n Wq�t k
r�q�XnG xD t
t f D]6 } y | j | | � | _ Wn
q�q�X| | _ Pq�W| j d k r�t d | � � q�n� t | � rmy | j j | | � | _ Wq�t k
rit d | | j j f � � q�XnJ d t | � k o�| j j k n r�t | � | _ n t d
| � � d S( s�
Constructor.
:param addr: an IPv4 or IPv6 address which may be represented in an
accepted string format, as an unsigned integer or as another
IPAddress object (copy construction).
:param version: (optional) optimizes version detection if specified
and distinguishes between IPv4 and IPv6 for addresses with an
equivalent integer value.
:param flags: (optional) decides which rules are applied to the
interpretation of the addr value. Supported constants are
INET_PTON and ZEROFILL. See the netaddr.core docs for further
details.
s1 cannot switch IP versions using copy constructor!i i s %r is an invalid IP version!t /sQ %s() does not support netmasks or subnet prefixes! See documentation for details.i s+ failed to detect a valid IP address from %rs base address %r is not IPv%ds bad address format: %rN( t superRM R R R R R R3 t
ValueErrorR R/ R1 R t __class__RH R t intR t
str_to_intR ( R t addrR3 t flagst module( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR � sZ % (
(c C s | j | j j f S( s1 :returns: Pickled state of an `IPAddress` object.( R R R3 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __getstate__A s c C s_ | \ } } | | _ | d k r- t | _ n. | d k rE t | _ n t d t | � � � d S( sT
:param state: data used to unpickle a pickled `IPAddress` object.
i i s& unpickling failed for object state: %sN( R R/ R R1 RP t str( R t stateR R3 ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __setstate__E s c C s� | j � s | j j S| j d k r) d S| j } d } x8 | d k rr | d @d k r[ Pn | d 7} | d L} q; W| j j | } d | k o� | j j k n s� t d | � � n | S( s�
@return: If this IP is a valid netmask, the number of non-zero
bits are returned, otherwise it returns the width in bits for
the IP address version.
i i s+ Unexpected mask length %d for address type!( t
is_netmaskR t widthR RP ( R t i_valt numbitst mask_length( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt netmask_bitsV s
"
c C s | j d } | | d @d k S( sV
:return: ``True`` if this IP address host mask, ``False`` otherwise.
i i ( R ( R t int_val( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt is_hostmasku s
c C s) | j | j j Ad } | | d @d k S( sY
:return: ``True`` if this IP address network mask, ``False`` otherwise.
i i ( R R R ( R Ra ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR[ | s c C sR t | j | � } d | k o0 | j j k n rB | | _ | St d � � d S( s�
Increases the numerical value of this IPAddress by num.
An IndexError is raised if result exceeds maximum IP address value or
is less than zero.
:param num: size of IP address increment.
i s) result outside valid IP address boundary!N( RR R R R t
IndexError( R t numt new_value( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __iadd__� s
" c C sR t | j | � } d | k o0 | j j k n rB | | _ | St d � � d S( s�
Decreases the numerical value of this IPAddress by num.
An IndexError is raised if result is less than zero or exceeds maximum
IP address value.
:param num: size of IP address decrement.
i s) result outside valid IP address boundary!N( RR R R R Rc ( R Rd Re ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __isub__� s
" c C s[ t | j | � } d | k o0 | j j k n rK | j | | j j � St d � � d S( s
Add the numerical value of this IP address to num and provide the
result as a new IPAddress object.
:param num: size of IP address increase.
:return: a new IPAddress object with its numerical value increased by num.
i s) result outside valid IP address boundary!N( RR R R R RQ R3 Rc ( R Rd Re ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __add__� s "c C s[ t | j | � } d | k o0 | j j k n rK | j | | j j � St d � � d S( s
Subtract the numerical value of this IP address from num providing
the result as a new IPAddress object.
:param num: size of IP address decrease.
:return: a new IPAddress object with its numerical value decreased by num.
i s) result outside valid IP address boundary!N( RR R R R RQ R3 Rc ( R Rd Re ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __sub__� s "c C s[ t | | j � } d | k o0 | j j k n rK | j | | j j � St d � � d S( s
Subtract num (lvalue) from the numerical value of this IP address
(rvalue) providing the result as a new IPAddress object.
:param num: size of IP address decrease.
:return: a new IPAddress object with its numerical value decreased by num.
i s) result outside valid IP address boundary!N( RR R R R RQ R3 Rc ( R Rd Re ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __rsub__� s "c C s | j j | j f S( sP
:return: a key tuple that uniquely identifies this IP address.
( R R3 R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR! � s c C s | j j | j | j j f S( sI :return: A key tuple used to compare and sort this `IPAddress` correctly.( R R3 R R\ ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR" � s c C s | j S( s< :return: the value of this IP address as an unsigned integer( R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __int__� s c C s | j S( s< :return: the value of this IP address as an unsigned integer( R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __long__� s c C s | j d k r d Sd | j S( s; :return: an octal string representation of this IP address.i t 0s 0%o( R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __oct__� s c C s d | j S( s@ :return: a hexadecimal string representation of this IP address.s 0x%x( R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __hex__� s c C s | j S( sx
:return: return the integer value of this IP address when called by hex(), oct() or bin().
( R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __index__� s c C s | j j | j | � S( s�
:param word_sep: (optional) the separator to insert between words.
Default: None - use default separator for address type.
:return: the value of this IP address as a binary digit string.( R t int_to_bitsR ( R t word_sep( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt bits� s c C s | j j | j � S( s7 The value of this IP address as a packed binary string.( R t
int_to_packedR ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt packed� s c C s | j j | j � S( sx
A list of unsigned integer words (octets for IPv4, hextets for IPv6)
found in this IP address.
( R t int_to_wordsR ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt words s c C s | j j | j � S( s�
The value of this IP adddress in standard Python binary
representational form (0bxxx). A back port of the format provided by
the builtin bin() function found in Python 2.6.x and higher.
( R t
int_to_binR ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt bin s c C s | j j | j � S( s1 The reverse DNS lookup record for this IP address( R t int_to_arpaR ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt reverse_dns s c C s� d } | j } | j j d k r6 | | j d � } n� | j j d k r� d | j k oe t j k n r | | j d � } q� t j | j k o� d k n r� | | j d d � } q� t d | � � n | S( s�
Raises an `AddrConversionError` if IPv6 address cannot be converted
to IPv4.
:return: A numerically equivalent version 4 `IPAddress` object.
i i i I������ I �� s2 IPv6 address %s unsuitable for conversion to IPv4!N( R RQ R R3 R R/ R R ( R t ipt klass( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR
s ""
c C s� d } | j } | j j d k rt | r_ d | j k oA d k n r_ | | j d d � } q� | | j d � } nF | j j d k r� | | j d � } | s� | d | j d � } q� n | S( s�
.. note:: The IPv4-mapped IPv6 address format is now considered deprecated. See RFC 4291 or later for details.
:param ipv4_compatible: If ``True`` returns an IPv4-mapped address
(::ffff:x.x.x.x), an IPv4-compatible (::x.x.x.x) address
otherwise. Default: False (IPv4-mapped).
:return: A numerically equivalent version 6 `IPAddress` object.
i I �� I������ i N( R RQ R R3 R ( R t ipv4_compatibleR| R} ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR / s c C sF | d k r- t | d � s- t d � � q- n | j j | j d | �S( s�
Only relevant for IPv6 addresses. Has no effect for IPv4.
:param dialect: An ipv6_* dialect class.
:return: an alternate string representation for this IP address.
t word_fmts- custom dialects should subclass ipv6_verbose!t dialectN( R t hasattrR R t
int_to_strR ( R R� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt formatL s
c C s# | j | j t | � B| j j � S( s�
:param other: An `IPAddress` object (or other int-like object).
:return: bitwise OR (x | y) between the integer value of this IP
address and ``other``.
( RQ R RR R R3 ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __or__Z s c C s# | j | j t | � @| j j � S( s�
:param other: An `IPAddress` object (or other int-like object).
:return: bitwise AND (x & y) between the integer value of this IP
address and ``other``.
( RQ R RR R R3 ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __and__c s c C s# | j | j t | � A| j j � S( s�
:param other: An `IPAddress` object (or other int-like object).
:return: bitwise exclusive OR (x ^ y) between the integer value of
this IP address and ``other``.
( RQ R RR R R3 ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __xor__l s c C s | j | j | >| j j � S( s�
:param numbits: size of bitwise shift.
:return: an `IPAddress` object based on this one with its integer
value left shifted by ``numbits``.
( RQ R R R3 ( R R^ ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt
__lshift__u s c C s | j | j | ?| j j � S( s�
:param numbits: size of bitwise shift.
:return: an `IPAddress` object based on this one with its integer
value right shifted by ``numbits``.
( RQ R R R3 ( R R^ ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt
__rshift__~ s c C s
t | j � S( si :return: ``True`` if the numerical value of this IP address is not zero, ``False`` otherwise.( t boolR ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __nonzero__� s c C s | j j | j � S( s, :return: IP address in presentational format( R R� R ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __str__� s c C s d | j j | f S( s8 :return: Python statement to create an equivalent objects %s('%s')( RQ RH ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __repr__� s ( N(+ RH RI RJ RK R R RW RZ R` Rb R[ Rf Rg Rh t __radd__Ri Rj R! R" Rk Rl Rn Ro Rp Rs RL Ru Rw Ry R{ R
R; R R� R� R� R� R� R� R� t __bool__R� R� ( ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyRM � sL Q t IPListMixinc B sV e Z d Z d Z d � Z e d � � Z d � Z d � Z d � Z d � Z
e
Z RS( su
A mixin class providing shared list-like functionality to classes
representing groups of IP addresses.
c C s= t | j | j j � } t | j | j j � } t | | � S( s�
:return: An iterator providing access to all `IPAddress` objects
within range represented by this ranged IP object.
( RM t firstR R3 t lastt iter_iprange( R t start_ipt end_ip( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __iter__� s c C s t | j | j d � S( sP
The total number of IP addresses within this ranged IP object.
i ( RR R� R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt size� s c C s, | j } | t k r( t d t � � n | S( s�
:return: the number of IP addresses in this ranged IP object. Raises
an `IndexError` if size > system max int (a Python 2.x
limitation). Use the .size property for subnets of any size.
sV range contains more than %d (sys.maxint) IP addresses! Use the .size property instead.( R� R Rc ( R R� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __len__� s
c C s� d } t | d � r� | j j d k r6 t d � � n | j | j � \ } } } | | d k sm | | k r� t t | j | j j � g � } q�t | j | | j j � } t | j | | | j j � } t
| | | � } n� y� t | � } | j | k o d k n r4t | j | d | j j � } nN d | k oR| j d k n rvt | j | | j j � } n t
d � � Wn! t k
r�t d | � � n X| S( s�
:return: The IP address(es) in this `IPNetwork` object referenced by
index or slice. As slicing can produce large sequences of objects
an iterator is returned instead of the more usual `list`.
t indicesi s IPv6 slices are not supported!i i s' index out range for address range size!s unsupported index type %r!N( R R� R R3 R R� R� t iterRM R� R� RR R� Rc RP ( R t indext itemt startt stopt stepR� R� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __getitem__� s( $ ##
c C s� t | t � r~ | j j | j j k r+ t St | t � r\ | j | j k o[ | j | j k S| j | j k o} | j | j k St | � | k S( s�
:param other: an `IPAddress` or ranged IP object.
:return: ``True`` if other falls within the boundary of this one,
``False`` otherwise.
( R R R R3 R; RM R R� R� ( R R& ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt __contains__� s ""c C s t S( s�
Ranged IP objects always represent a sequence of at least one IP
address and are therefore always True in the boolean context.
( R8 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s ( ( RH RI RJ RK R� RL R� R� R� R� R� R� ( ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s % i c C s� t | t � r� t | � d k r7 t d | j � � n | \ } } d | k o] | j k n sx t d | j � � n d | k o� | j k n s�t d | j � � q�n�t | t � rs| r� t | � } n d | k r� | j d d � \ } } n | } d } y t | | j d t
�} WnZ t k
r| j d k rlt j | � } t | | j d t
�} q�t d
| � � n X| j } y t | � } Wn� t k
r�| d k r;| j } q;nw t k
r:t | | j d t
�}
|
j � r| j |
j } q;|
j � r'| j |
j } q;t d | � � n Xd | k oU| j k n s�t d | j � � q�n t d
t | � � � | t @r�| j | } | | @} n | | f S( Ni s invalid %s tuple!i s# invalid address value for %s tuple!s invalid prefix for %s tuple!RN i RU i s invalid IPNetwork address %s!s! addr %r is not a valid IPNetwork!s invalid prefix for %s address!s unexpected type %s for addr arg( R t tuplet lenR R R R\ R t cidr_abbrev_to_verboset splitR RM R3 R R/ t expand_partial_addressR RR R RP R[ t netmask_to_prefixRb t hostmask_to_prefixR R t prefix_to_netmask( RV RT t implicit_prefixRU R t prefixlent val1t val2R| t
expanded_addrt maskt netmask( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt parse_ip_network� s\
t IPNetworkc B s e Z d Z d# Z e d$ d d � Z d � Z d � Z d � Z e
d � e d d �Z e
d
� � Z e
d � � Z
e
d � � Z e
d
� � Z e
d � � Z e
d � � Z e
d � � Z e
d � � Z e
d � � Z e
d � � Z d � Z d � Z d � Z d � Z d � Z d � Z e d � Z d d � Z d d � Z d d � Z d$ d$ d � Z d � Z! d! � Z" d" � Z# RS(% sf
An IPv4 or IPv6 network or subnet.
A combination of an IP address and a network mask.
Accepts CIDR and several related variants :
a) Standard CIDR::
x.x.x.x/y -> 192.0.2.0/24
x::/y -> fe80::/10
b) Hybrid CIDR format (netmask address instead of prefix), where 'y' address represent a valid netmask::
x.x.x.x/y.y.y.y -> 192.0.2.0/255.255.255.0
x::/y:: -> fe80::/ffc0::
c) ACL hybrid CIDR format (hostmask address instead of prefix like Cisco's ACL bitmasks), where 'y' address represent a valid netmask::
x.x.x.x/y.y.y.y -> 192.0.2.0/0.0.0.255
x::/y:: -> fe80::/3f:ffff:ffff:ffff:ffff:ffff:ffff:ffff
d) Abbreviated CIDR format (as of netaddr 0.7.x this requires the optional constructor argument ``implicit_prefix=True``)::
x -> 192
x/y -> 10/8
x.x/y -> 192.168/16
x.x.x/y -> 192.168.0/24
which are equivalent to::
x.0.0.0/y -> 192.0.0.0/24
x.0.0.0/y -> 10.0.0.0/8
x.x.0.0/y -> 192.168.0.0/16
x.x.x.0/y -> 192.168.0.0/24
t
_prefixleni c C s� t t | � j � d
\ } } } t | d � rO | j } | j } | j } nIt | d � r| | j } | j } | j } n | d k r� t t
| d | d | �\ } } t
} n� | d k r� t t | d | d | �\ } } t } n� | d k rt d | � � n y% t
} t | | | | � \ } } Wni t
k
r�y% t } t | | | | � \ } } Wn t
k
rtn X| d k r�t
d | � � q�n X| | _ | | _ | | _ d S( s�
Constructor.
:param addr: an IPv4 or IPv6 address with optional CIDR prefix,
netmask or hostmask. May be an IP address in presentation
(string) format, an tuple containing and integer address and a
network prefix, or another IPAddress/IPNetwork object (copy
construction).
:param implicit_prefix: (optional) if True, the constructor uses
classful IPv4 rules to select a default prefix when one is not
provided. If False it uses the length of the IP address version.
(default: False)
:param version: (optional) optimizes version detection if specified
and distinguishes between IPv4 and IPv6 for addresses with an
equivalent integer value.
:param flags: (optional) decides which rules are applied to the
interpretation of the addr value. Currently only supports the
NOHOST option. See the netaddr.core docs for further details.
R� R i R� RU i s %r is an invalid IP version!s invalid IPNetwork %sN( NNN( RO R� R R R� R R R� R\ R� R/ R1 RP R ( R RT R� R3 RU R R� RV ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR l sH
c C s | j | j | j j f S( s0 :return: Pickled state of an `IPNetwork` object.( R R� R R3 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyRW � s c C s� | \ } } } | | _ | d k r0 t | _ n. | d k rH t | _ n t d t | � � � d | k o{ | j j k n r� | | _ n t d t | � � � d S( sT
:param state: data used to unpickle a pickled `IPNetwork` object.
i i s% unpickling failed for object state %si N( R R/ R R1 RP RX R\ R� ( R RY R R� R3 ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyRZ � s " c C sp t | t � s( t d t | � � � n d | k oE | j j k n sc t d | j j � � n | | _ d S( Ns int argument expected, not %si s! invalid prefix for an %s address!( R R R R R R\ R R R� ( R R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt _set_prefixlen� s "c C s | j S( N( R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR � s R sC size of the bitmask used to separate the network from the host bitsc C s t | j | j j � S( s�
The IP address of this `IPNetwork` object. This is may or may not be
the same as the network IP address which varies according to the value
of the CIDR subnet prefix.
( RM R R R3 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR| � s c C s t | j | j @| j j � S( s/ The network address of this `IPNetwork` object.( RM R t _netmask_intR R3 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt network� s c C sP | j j d k r/ | j j | j d k r/ d St | j | j B| j j � Sd S( s0 The broadcast address of this `IPNetwork` objecti i N( R R3 R\ R� R RM R t
_hostmask_int( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt broadcast� s +c C s | j | j j | j A@S( se
The integer value of first IP address found within this `IPNetwork`
object.
( R R R R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s c C s& d | j j | j >d } | j | BS( sd
The integer value of last IP address found within this `IPNetwork`
object.
i ( R R\ R� R ( R t hostmask( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s c C s& | j j | j A} t | | j j � S( s+ The subnet mask of this `IPNetwork` object.( R R R� RM R3 ( R R� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s c C s | j j | j AS( s+ Same as self.netmask, but in integer format( R R R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� s c C s. d | j j | j >d } t | | j j � S( s) The host mask of this `IPNetwork` object.i ( R R\ R� RM R3 ( R R� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� s c C s d | j j | j >d S( s, Same as self.hostmask, but in integer formati ( R R\ R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� s c C s) t | j | j @| j f d | j j �S( s�
The true CIDR address for this `IPNetwork` object which omits any
host bits to the right of the CIDR subnet prefix.
R3 ( R� R R� R� R R3 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR< s c C sn t | j � | j | } | | j d | j j k rF t d � � n | d k ra t d � � n | | _ | S( sP
Increases the value of this `IPNetwork` object by the current size
multiplied by ``num``.
An `IndexError` is raised if result exceeds maximum IP address value
or is less than zero.
:param num: (optional) number of `IPNetwork` blocks to increment this IPNetwork's value by.
i s# increment exceeds address boundary!i s increment is less than zero!( RR R� R� R R Rc R ( R Rd Re ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyRf s c C sn t | j � | j | } | d k r5 t d � � n | | j d | j j k ra t d � � n | | _ | S( sP
Decreases the value of this `IPNetwork` object by the current size
multiplied by ``num``.
An `IndexError` is raised if result is less than zero or exceeds
maximum IP address value.
:param num: (optional) number of `IPNetwork` blocks to decrement this IPNetwork's value by.
i s decrement is less than zero!i s# decrement exceeds address boundary!( RR R� R� Rc R R R ( R Rd Re ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyRg 2 s c C s� t | t � r� | j j | j j k r+ t S| j j | j } | j | ?} t | t � r� | | >| j j k o� | d | >| j
j k S| j | ?} t | t � r� | | k St | t � r� | | k o� | j | j k Sn t | � | k S( s�
:param other: an `IPAddress` or ranged IP object.
:return: ``True`` if other falls within the boundary of this one,
``False`` otherwise.
i (
R R R R3 R; R\ R� R t IPRanget _startt _endRM R� ( R R& t
shiftwidtht self_nett other_net( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� G s
c C s | j j | j | j f S( sR
:return: A key tuple used to uniquely identify this `IPNetwork`.
( R R3 R� R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR! e s c C sJ | j d } | j | j j | j A@} | j | } | j j | | | f S( s[
:return: A key tuple used to compare and sort this `IPNetwork` correctly.
i ( R� R R R R� R3 ( R t
net_size_bitsR� t host_bits( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR" k s
c C s d } | j } | j j d k r@ | d | j | j f � } n� | j j d k rd | j k oo t j k n r� t j | j � } | d | | j d f � } qt j | j k o� d k n r� t j | j d � } | d | | j d f � } qt
d | � � n | S(
s�
:return: A numerically equivalent version 4 `IPNetwork` object. Raises an `AddrConversionError` if IPv6 address cannot be converted to IPv4.
i s %s/%di i i` I������ I �� s2 IPv6 address %s unsuitable for conversion to IPv4!N( R RQ R R3 R| R� R R/ R R� R ( R R| R} RT ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR
t s " "
c C s� d } | j } | j j d k r� | rk d | j k oA d k n rk | | j d | j f d d �} q� | | j | j f d d �} nf | j j d k r� | r� | | j | j d f d d �} q� | d | j | j d f d d �} n | S( s�
.. note:: the IPv4-mapped IPv6 address format is now considered deprecated. See RFC 4291 or later for details.
:param ipv4_compatible: If ``True`` returns an IPv4-mapped address
(::ffff:x.x.x.x), an IPv4-compatible (::x.x.x.x) address
otherwise. Default: False (IPv4-mapped).
:return: A numerically equivalent version 6 `IPNetwork` object.
i I �� I������ R3 i i` N( R RQ R R3 R R� ( R R~ R| R} ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR � s !%
i c C s6 | j d | j | j f | j j � } | | 8} | S( s�
:param step: the number of IP subnets between this `IPNetwork` object
and the expected subnet. Default: 1 (the previous IP subnet).
:return: The adjacent subnet preceding this `IPNetwork` object.
s %s/%d( RQ R� R� R R3 ( R R� t ip_copy( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt previous� s
c C s6 | j d | j | j f | j j � } | | 7} | S( s�
:param step: the number of IP subnets between this `IPNetwork` object
and the expected subnet. Default: 1 (the next IP subnet).
:return: The adjacent subnet succeeding this `IPNetwork` object.
s %s/%d( RQ R� R� R R3 ( R R� R� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt next� s
c C s� d | k o | j j k n sA t d | | j j f � � n g } | j } | | _ x5 | j | j k r� | j | j � | j d 7_ q\ W| S( sb
Provides a list of supernets for this `IPNetwork` object between the
size of the current prefix and (if specified) an endpoint prefix.
:param prefixlen: (optional) a CIDR prefix for the maximum supernet.
Default: 0 - returns all possible supernets.
:return: a tuple of supernet `IPNetwork` objects.
i s" CIDR prefix /%d invalid for IPv%d!i ( R R\ RP R3 R< R� t append( R R� t supernetst supernet( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s
" c c sG d | j k o | j j k n sD t d | | j j f � � n | j | k s\ t � n | j j } d | | j d | | } | d k r� | } n d | k o� | k n s� t d � � n | j j | j � } d } x` | | k rB| j d | | f | j j � } | j
| j | 7_
| | _ | d 7} | Vq� Wd S( s�
A generator that divides up this IPNetwork's subnet into smaller
subnets based on a specified CIDR prefix.
:param prefixlen: a CIDR prefix indicating size of subnets to be
returned.
:param count: (optional) number of consecutive IP subnets to be
returned.
:return: an iterator containing IPNetwork subnet objects.
i s" CIDR prefix /%d invalid for IPv%d!i i s, count outside of current IP subnet boundary!s %s/%dN( R� R R\ RP R3 t
StopIterationR R� R� RQ R R� ( R R� t countt fmtR\ t max_subnetst base_subnett it subnet( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s(
%
c C s� t g � } | j j d k r� | j d k rk t t | j d | j j � t | j d | j j � � } q� t t | j | j j � t | j | j j � � } nI | j d k r� t t | j d | j j � t | j | j j � � } n | S( s
A generator that provides all the IP addresses that can be assigned
to hosts within the range of this IP object's subnet.
- for IPv4, the network and broadcast addresses are always excluded. for subnets that contains less than 4 IP addresses /31 and /32 report in a manner per RFC 3021
- for IPv6, only the unspecified address '::' or Subnet-Router anycast address (first address in the network) is excluded.
:return: an IPAddress iterator
i i i ( R� R R3 R� R� RM R� R� ( R t it_hosts( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt
iter_hosts s " c C s& | j j | j � } d | | j f S( s& :return: this IPNetwork in CIDR formats %s/%s( R R� R R� ( R RT ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� ( s c C s d | j j | f S( s8 :return: Python statement to create an equivalent objects %s('%s')( RQ RH ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� - s ( s
_prefixlenN($ RH RI RJ RK R; R R RW RZ R� RL R� R| R� R� R� R� R� R� R� R� R< Rf Rg R� R! R" R
R R� R� R� R� R� R� R� ( ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� A s@ (D
) % R� c B s� e Z d Z d Z d d � Z d � Z d � Z d � Z e d � � Z e d � � Z
d
� Z d � Z d � Z
d
� Z d � Z RS( s�
An arbitrary IPv4 or IPv6 address range.
Formed from a lower and upper bound IP address. The upper bound IP cannot
be numerically smaller than the lower bound and the IP version of both
must match.
R� R� i c C ss t | d | �| _ | j j | _ t | | j j d | �| _ t | j � t | j � k ro t d � � n d S( s�
Constructor.
:param start: an IPv4 or IPv6 address that forms the lower
boundary of this IP range.
:param end: an IPv4 or IPv6 address that forms the upper
boundary of this IP range.
:param flags: (optional) decides which rules are applied to the
interpretation of the start and end values. Supported constants
are INET_PTON and ZEROFILL. See the netaddr.core docs for further
details.
RU s( lower bound IP greater than upper bound!N( RM R� R R3 R� RR R ( R R� t endRU ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR = s
c C s | j j | j j | j j f S( s. :return: Pickled state of an `IPRange` object.( R� R R� R R3 ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyRW S s c C sF | \ } } } t | | � | _ | j j | _ t | | � | _ d S( sQ
:param state: data used to unpickle a pickled `IPRange` object.
N( RM R� R R� ( R RY R� R� R3 ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyRZ W s c C s t | t � r| j j | j j k r+ t St | t � rb | j j | j k oa | j j | j k St | t � r� | j j | j j k o� | j j | j j k St | t
� r| j j | j } | j | ?| >} | d | >} | j j | k o| j j | k Sn t | � | k S( Ni (
R R R R3 R; RM R� R R� R� R� R\ R� ( R R& R� t other_startt other_next_start( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� a s c C s
t | j � S( s? The integer value of first IP address in this `IPRange` object.( RR R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� w s c C s
t | j � S( s> The integer value of last IP address in this `IPRange` object.( RR R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� | s c C s | j j | j | j f S( sP
:return: A key tuple used to uniquely identify this `IPRange`.
( R R3 R� R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR! � s c C s2 | j j t | j � } | j j | j j | f S( sY
:return: A key tuple used to compare and sort this `IPRange` correctly.
( R R\ R R� R3 R� R ( R t skey( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR" � s c C s t | j | j � S( sx
The list of CIDR addresses found within the lower and upper bound
addresses of this `IPRange`.
( t iprange_to_cidrsR� R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt cidrs� s c C s d | j | j f S( s< :return: this `IPRange` in a common representational format.s %s-%s( R� R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s c C s d | j j | j | j f S( s8 :return: Python statement to create an equivalent objects %s('%s', '%s')( RQ RH R� R� ( R ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s ( s _starts _end( RH RI RJ RK R RW RZ R� RL R� R� R! R" R� R� R� ( ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� 2 s
c g s1 x* t | � D] } x | D] } | Vq Wq
Wd S( s�
:param args: A list of IP addresses and subnets passed in as arguments.
:return: A generator that flattens out IP subnets, yielding unique
individual IP addresses (no duplicates).
N( t
cidr_merge( t argsR< R| ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt iter_unique_ips� s
c C s� d � } t | � r4 d | k s- | d k r4 | Sn y$ t | � } d | | | � f SWnHt k
r�d | k r� | j d d � \ } } y9 d t | � k o� d k n s� t d | � � n Wq� t k
r� | SXn | } d } | j d
� } t | � d k r| Sx+ t d t | � � D] } | j d � q%W| d k rty | | d � } Wqtt k
rp| SXn d
d
j | � | f St t
f k
r�| SXd S( s�
A function that converts abbreviated IPv4 CIDRs to their more verbose
equivalent.
:param abbrev_cidr: an abbreviated CIDR.
Uses the old-style classful IP address rules to decide on a default
subnet prefix if one is not explicitly provided.
Only supports IPv4 addresses.
Examples ::
10 - 10.0.0.0/8
10/16 - 10.0.0.0/16
128 - 128.0.0.0/16
128/8 - 128.0.0.0/8
192.168 - 192.168.0.0/16
:return: A verbose CIDR from an abbreviated CIDR or old-style classful network address. The original value if it was not recognised as a supported abbreviation.
c S s� t | � } d | k o# d k n s; t d | � � n d | k oR d k n r[ d Sd | k or d k n r{ d Sd | k o� d
k n r� d Sd | k o� d
k n r� d Sd S( Ni i� s Invalid octet: %r!i i i� i� i i� i� i i� i� i i ( RR Rc ( t octet( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt classful_prefix� s t :t s %s.0.0.0/%sRN i i i s. prefixlen in address %r out of range for IPv4!t .i Rm s %s/%sN( R RR RP R� R R� t rangeR� t joinR Rc ( t abbrev_cidrR� R� t part_addrt prefixt tokens( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s>
"
c
C s� t | d � s t d � � n g } x< | D]4 } t | � } | j | j | j | j | f � q+ W| j � t | � d } x� | d k r+| | d | | d d k r | | d d | | d d k r | | d | | d t | | d d | | d � f | | d <| | =n | d 8} q� Wg } x� | D]x } t | � d k re| j | d � q9| d } t
| d d | �} t
| d d | �} | j t | | � � q9W| S( s
A function that accepts an iterable sequence of IP addresses and subnets
merging them into the smallest possible list of CIDRs. It merges adjacent
subnets where possible, those contained within others and also removes
any duplicates.
:param ip_addrs: an iterable sequence of IP addresses and subnets.
:return: a summarized list of `IPNetwork` objects.
R� s# A sequence or iterator is expected!i i i i i R3 (
R� RP R� R� R3 R� R� t sortR� t minRM t extendR� (
t ip_addrst rangesR| R< R� t mergedt range_tupleR3 t range_startt
range_stop( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s,
&
DD
c C s t | | � \ } } } | | S( s
Removes an exclude IP address or subnet from target IP subnet.
:param target: the target IP address or subnet to be divided up.
:param exclude: the IP address or subnet to be removed from target.
:return: list of `IPNetwork` objects remaining after exclusion.
( t cidr_partition( t targett excludet leftt _t right( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt cidr_exclude+ s
c C s� t | � } t | � } | j | j k r= g g | j g f S| j | j k rb | j g g g f S| j | j k r� g | g g f Sg } g } | j d } | j j } | j } | j } | } | d | | } x� | j | k rv| j | k r | j t | | f d | �� | }
n% | j t | | f d | �� | }
| d 7} | | k r[Pn |
} |
d | | } q� W| | g | d d d � f S( sc
Partitions a target IP subnet on an exclude IP address.
:param target: the target IP address or subnet to be divided up.
:param exclude: the IP address or subnet to partition on
:return: list of `IPNetwork` objects before, the partition and after, sorted.
Adding the three lists returns the equivalent of the original subnet.
i i R3 Ni����( R� R� R� R< R� R R\ R3 R� ( R� R� R� R� t
new_prefixlent target_module_widtht target_firstR3 t i_lowert i_uppert matched( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� 9 s8
c C s� t g | D] } t | � ^ q
� } t | � d k sF t d � � n | d } | d } | j | j k r{ t d � � n | j } | j } | j } | j j
} x9 | d k r� | | k r� | d 8} | d | | > M} q� Wt | | f d | j �S( sO
Function that accepts a sequence of IP addresses and subnets returning
a single `IPNetwork` subnet that is large enough to span the lower and
upper bound IP addresses with a possible overlap on either end.
:param ip_addrs: sequence of IP addresses and subnets.
:return: a single spanning `IPNetwork` subnet.
i s- IP sequence must contain at least 2 elements!i i����s. IP sequence cannot contain both IPv4 and IPv6!R3 ( t sortedR� R� RP R3 R R� R� R� R R\ ( R� R| t
sorted_ipst lowest_ipt
highest_ipt ipnumR� t lowest_ipnumR\ ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt
spanning_cidru s
"
i c c s� t | � } t | � } | j | j k r9 t d � � n | j } t | � } | d k ri t d � � n t | � } t | � } t } | d k r� t } n | | } xK t r� | | 7} | r� | | k s� Pq� n | | k s� Pn t | | � Vq� Wd S( s�
A generator that produces IPAddress objects between an arbitrary start
and stop IP address with intervals of step between them. Sequences
produce are inclusive of boundary IPs.
:param start: start IP address.
:param end: end IP address.
:param step: (optional) size of step between IP addresses. Default: 1
:return: an iterator of one or more `IPAddress` objects.
s( start and stop IP versions do not match!i s step argument cannot be zeroN( RM R3 R RR RP R; R8 ( R� R� R� R3 R� t
negative_stepR� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s,
c C s g } t | � } t | � } | j | j g } t | | g � } | j j } | j | d k r� t | d d | f d | j �} t | | � d } | j � } n | j | d k r� t | d d | f d | j �} | t | | � d 7} n
| j | � | S( s`
A function that accepts an arbitrary start and end IP address or subnet
and returns a list of CIDR subnets that fit exactly between the boundaries
of the two with no overlap.
:param start: the start IP address or subnet.
:param end: the end IP address or subnet.
:return: a list of one or more IP addresses and subnets.
i i R3 i (
R� R� R� R R R\ R3 R� t popR� ( R� R� t cidr_listt ipranget cidr_spanR\ R� ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyR� � s ##
c C s� d } t | d � s( t d | � � n t | � } xa t g | D] } t | � ^ qA � D]: } | | k ru | } qZ | d k rZ | j | k rZ PqZ qZ W| S( sb
Matches an IP address or subnet against a given sequence of IP addresses
and subnets.
:param ip: a single IP address or subnet.
:param cidrs: a sequence of IP addresses and/or subnets.
:return: the smallest (most specific) matching IPAddress or IPNetwork
object from the provided sequence, None if there was no match.
R� s, IP address/subnet sequence expected, not %r!N( R R� R RM R� R� R� ( R| R� t matchR< ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt smallest_matching_cidr� s
, c C s~ d } t | d � s( t d | � � n t | � } xC t g | D] } t | � ^ qA � D] } | | k rZ | } PqZ qZ W| S( sb
Matches an IP address or subnet against a given sequence of IP addresses
and subnets.
:param ip: a single IP address or subnet.
:param cidrs: a sequence of IP addresses and/or subnets.
:return: the largest (least specific) matching IPAddress or IPNetwork
object from the provided sequence, None if there was no match.
R� s, IP address/subnet sequence expected, not %r!N( R R� R RM R� R� ( R| R� R R< ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt largest_matching_cidr s
, c C s� g } t | d � s( t d | � � n t | � } xf t g | D] } t | � ^ qA � D]? } | | k r| | j | � qZ | rZ | j | d k rZ PqZ qZ W| S( sM
Matches an IP address or subnet against a given sequence of IP addresses
and subnets.
:param ip: a single IP address.
:param cidrs: a sequence of IP addresses and/or subnets.
:return: all matching IPAddress and/or IPNetwork objects from the provided
sequence, an empty list if there was no match.
R� s, IP address/subnet sequence expected, not %r!i����( R� R RM R� R� R� R� ( R| R� t matchesR< ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt all_matching_cidrs" s
, s 127.0.0.0/8s
10.0.0.0/8s
100.64.0.0/10s
172.16.0.0/12s 192.0.0.0/24s 192.168.0.0/16s
198.18.0.0/15s 239.0.0.0s 239.255.255.255s 169.254.0.0/16s 224.0.0.0/4s 192.88.99.0/24s 0.0.0.0/8s 192.0.2.0/24s 240.0.0.0/4s 198.51.100.0/24s 203.0.113.0/24s 233.252.0.0/24s 234.0.0.0s 238.255.255.255s 225.0.0.0s 231.255.255.255s ::1s fc00::/7s fec0::/10s fe80::/10s ff00::/8s ff00::/12s ::/8s 0100::/8s 0200::/7s 0400::/6s 0800::/5s 1000::/4s 4000::/3s 6000::/3s 8000::/3s A000::/3s C000::/3s E000::/4s F000::/5s F800::/6s FE00::/9(7 RJ t syst _syst netaddr.coreR R R R R R R R R R t netaddr.strategyR
R/ R R1 t netaddr.compatR R
R R R t objectR RM R� R; R� R� R� R� R� R� R� R� R R� R� R R R
R4 R7 R> R0 t IPV4_6TO4R@ R5 R9 R? R2 RA ( ( ( s6 /tmp/pip-install-zM1pc4/netaddr/netaddr/ip/__init__.pyt <module> sp F(�� �eD� �m T , < " / $