← Back
Editing: ipaddress.cpython-33.pyc
� �� 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 <n | S( Nu broadcast_address( u _cacheu getu Noneu _address_classu intu network_addressu hostmask( u selfu x( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu broadcast_address� s u _BaseNetwork.broadcast_addressc C sQ | j j d � } | d k rM | j t | j � | j A� } | | j d <n | S( Nu hostmask( u _cacheu getu Noneu _address_classu intu netmasku _ALL_ONES( u selfu x( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu hostmask� s u _BaseNetwork.hostmaskc 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 with_prefixlen� s u _BaseNetwork.with_prefixlenc C s d | j | j f S( Nu %s/%s( u network_addressu netmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu with_netmask� s u _BaseNetwork.with_netmaskc C s d | j | j f S( Nu %s/%s( u network_addressu hostmask( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu with_hostmask� s u _BaseNetwork.with_hostmaskc C s t | j � t | j � d S( u& Number of hosts in the current subnet.i ( u intu broadcast_addressu network_address( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu num_addresses� s u _BaseNetwork.num_addressesc C s# d t | � f } t | � � d S( Nu% %200s has no associated address class( u typeu NotImplementedError( u selfu msg( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu _address_class� s u _BaseNetwork._address_classc C s | j S( N( u _prefixlen( u self( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu prefixlen� s u _BaseNetwork.prefixlenc c s� | j | j k s+ t d | | f � � n t | t � sM t d | � � n | j | j k on | j | j k s� t d | | f � � n | | k r� t � n | j d | j | j f � } | j � \ } } x� | | k r�| | k r�| j | j k r)| j | j k r)| V| j � \ } } q� | j | j k rg| j | j k rg| V| j � \ } } q� t d | | | f � � q� W| | k r�| Vn- | | k r�| Vn t d | | | f � � d S( u� 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') 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') 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. u% %s and %s are not of the same versionu %s is not a network objectu %s not contained in %su %s/%su3 Error performing exclusion: s1: %s s2: %s other: %sN( u _versionu TypeErroru isinstanceu _BaseNetworku network_addressu broadcast_addressu ValueErroru StopIterationu __class__u prefixlenu subnetsu AssertionError( u selfu otheru s1u s2( ( u. /opt/alt/python33/lib64/python3.3/ipaddress.pyu address_exclude� s< $ u _BaseNetwork.address_excludec C s� | j | j k r+ t d | | f � � n | j | j k rA d S| j | j k rW d S| j | j k rm d S| j | j k r� d Sd S( u� 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. 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 <listcomp>� s u( _BaseV4._is_hostmask.<locals>.<listcomp>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 � � | _ | r�t t | j � t | j � @� | j k r�t d | � � q�n 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 r�d | } 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 <listcomp>� s u/ _BaseV6._string_from_ip_int.<locals>.<listcomp>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 <listcomp>� s u8 _BaseV6._explode_shorthand_ip_string.<locals>.<listcomp>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 <genexpr>* s u* IPv6Address.is_reserved.<locals>.<genexpr>( 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 <module> s> # 8 0 9 !�;� ��wDd��J
Save File
Cancel