📁 File Manager Pro
v10.0.3 | PHP: 8.1.34
Server: Apache
2026-06-21 21:23:41
📂
/ (Root)
/
usr
/
lib
/
python3.6
/
site-packages
/
netaddr
/
eui
/
__pycache__
📍 /usr/lib/python3.6/site-packages/netaddr/eui/__pycache__
🔄 Refresh
✏️
Editing: __init__.cpython-36.pyc
Read Only
3 ��]�a � @ s� d Z ddlmZmZmZ ddlmZmZ ddl m Z ddl m Z ddlmZ ddlmZmZ G dd � d e�ZG d d � d e�ZG d d � d e�ZG dd� de�ZdS )z] Classes and functions for dealing with MAC addresses, EUI-48, EUI-64, OUI, IAB identifiers. � )�NotRegisteredError�AddrFormatError� DictDotLookup)�eui48�eui64)� mac_eui48)� eui64_base)� IPAddress)�_is_int�_is_strc @ sD e Zd ZdZdZdd� Zdd� Zdd� Zd d � Zd d � Z d d� Z dS )�BaseIdentifierz$Base class for all IEEE identifiers.�_valuec C s d | _ d S )N)r )�self� r � /usr/lib/python3.6/__init__.py�__init__ s zBaseIdentifier.__init__c C s | j S )z):return: integer value of this identifier)r )r r r r �__int__ s zBaseIdentifier.__int__c C s | j S )z):return: integer value of this identifier)r )r r r r �__long__ s zBaseIdentifier.__long__c C s | j dkrdS d| j S )z8:return: octal string representation of this identifier.r �0z0%o)r )r r r r �__oct__" s zBaseIdentifier.__oct__c C s d| j S )z>:return: hexadecimal string representation of this identifier.z0x%x)r )r r r r �__hex__) s zBaseIdentifier.__hex__c C s | j S )zx :return: return the integer value of this identifier when passed to hex(), oct() or bin(). )r )r r r r � __index__. s zBaseIdentifier.__index__N)r ) �__name__� __module__� __qualname__�__doc__� __slots__r r r r r r r r r r r s r c sr e Zd ZdZdZ� fdd�Zdd� Zdd� Zd d � Zd d � Z d d� Z e dd� �Z ddd�Z dd� Zdd� Z� ZS )�OUIz� An individual IEEE OUI (Organisationally Unique Identifier). For online details see - http://standards.ieee.org/regauth/oui/ �recordsc s� t t| �j� ddlm} g | _t|t�r@t|j dd�d�| _ nBt |�rvd| koZdkn rh|| _ q�t d| ��n t d| ��| j |jkr�t|jd �}x@|j| j D ]0\}}|j|� |j|�jd �}| j|||� q�W |j� n td | ��d S ) z� Constructor :param oui: an OUI string ``XX-XX-XX`` or an unsigned integer. Also accepts and parses full MAC/EUI-48 address strings (but not MAC/EUI-48 integers)! r )�ieee�-� � i��� z"OUI int outside expected range: %rzunexpected OUI format: %r�rbzUTF-8zOUI %r not registered!N)�superr r � netaddr.euir r � isinstance�str�int�replacer r � ValueError� TypeErrorZ OUI_INDEX�openZOUI_REGISTRY_PATH�seek�read�decode� _parse_data�closer )r �ouir �fh�offset�size�data)� __class__r r r @ s$ z OUI.__init__c C s: t |t�s.y| j|�}W n tk r, tS X | j|jkS )N)r& r r7 � Exception�NotImplementedr )r �otherr r r �__eq__g s z OUI.__eq__c C s: t |t�s.y| j|�}W n tk r, tS X | j|jkS )N)r& r r7 r8 r9 r )r r: r r r �__ne__o s z OUI.__ne__c C s | j | jfS )z+:returns: Pickled state of an `OUI` object.)r r )r r r r � __getstate__w s zOUI.__getstate__c C s |\| _ | _dS )z;:param state: data used to unpickle a pickled `OUI` object.N)r r )r �stater r r � __setstate__{ s zOUI.__setstate__c C s� dddg ||d�}xn|j d�D ]`}|j� }|s0q d|krd| j|d< |j dd�d |d < t| �|d < q d |krpq q |d j|� q W | jj|� dS ) z.Returns a dict record from raw OUI record datar r! )�idxr2 �org�addressr4 r5 � z(hex)r@ N� rA r2 z (base 16)rB )�split�stripr r' �appendr )r r6 r4 r5 �record�liner r r r0 s$ zOUI._parse_datac C s t | j�S )z0Number of registered organisations with this OUI)�lenr )r r r r � reg_count� s z OUI.reg_countr c C s t | j| �S )a The IEEE registration details for this OUI. :param index: the index of record (may contain multiple registrations) (Default: 0 - first registration) :return: Objectified Python data structure containing registration details. )r r )r �indexr r r � registration� s zOUI.registrationc C s( | j }d|d? d@ |d? d@ |d@ f S )z*:return: string representation of this OUIz%02X-%02X-%02Xr" � � )r )r �int_valr r r �__str__� s z OUI.__str__c C s d| S )z@:return: executable Python string to recreate equivalent object.z OUI('%s')r )r r r r �__repr__� s z OUI.__repr__)r )r )r r r r r r r; r< r= r? r0 �propertyrK rM rQ rR � __classcell__r r )r7 r r 7 s ' r c st e Zd ZdZdZeddd��Zd� fdd� Zdd � Zd d � Z d d � Z dd� Z dd� Z dd� Z dd� Zdd� Z� ZS )�IABz� An individual IEEE IAB (Individual Address Block) identifier. For online details see - http://standards.ieee.org/regauth/oui/ rH Fc C s� d| kodkn r | dfS d }d |A }| d? }| |B | }d| koRdkn rv|r�|dkr�t dt|� ��nt d t| � ��||fS )z� :param eui_int: a MAC IAB as an unsigned integer. :param strict: If True, raises a ValueError if the last 12 bits of IAB MAC/EUI-48 address are non-zero, ignores them otherwise. (Default: False) i i�/ r rD � � �0 z%r is not a strict IAB!z%r is not an IAB address!i i� l l ��� )r* �hex)Zeui_int�strictZ user_maskZiab_maskZiab_bitsZ user_bitsr r r � split_iab_mac� s zIAB.split_iab_macc s t t| �j� ddlm} dddg ddd�| _t|t�rdt|j dd�d�}| j ||d�\}}|| _ n.t |�r�| j ||d�\}}|| _ n t d| ��| j |jk�rt|jd �}|j| j d \}} || jd < | | jd < |j|� |j| �jd �} | j| || � |j� n td | ��dS )a� Constructor :param iab: an IAB string ``00-50-C2-XX-X0-00`` or an unsigned integer. This address looks like an EUI-48 but it should not have any non-zero bits in the last 3 bytes. :param strict: If True, raises a ValueError if the last 12 bits of IAB MAC/EUI-48 address are non-zero, ignores them otherwise. (Default: False) r )r r! )r@ �iabrA rB r4 r5 r r" )rZ zunexpected IAB format: %r!r# r4 r5 zUTF-8zIAB %r not unregistered!N)r$ rU r r% r rH r& r' r( r) r[ r r r+ Z IAB_INDEXr, ZIAB_REGISTRY_PATHr- r. r/ r0 r1 r ) r r\ rZ r rP Ziab_intZuser_intr3 r4 r5 r6 )r7 r r r � s4 z IAB.__init__c C s: t |t�s.y| j|�}W n tk r, tS X | j|jkS )N)r& rU r7 r8 r9 r )r r: r r r r; s z IAB.__eq__c C s: t |t�s.y| j|�}W n tk r, tS X | j|jkS )N)r& rU r7 r8 r9 r )r r: r r r r< s z IAB.__ne__c C s | j | jfS )z+:returns: Pickled state of an `IAB` object.)r rH )r r r r r= s zIAB.__getstate__c C s |\| _ | _dS )z;:param state: data used to unpickle a pickled `IAB` object.N)r rH )r r> r r r r? " s zIAB.__setstate__c C s| xv|j d�D ]h}|j� }|s q d|krX| j| jd< |j dd�d | jd< t| �| jd< q d|krdq q | jd j|� q W dS ) z.Returns a dict record from raw IAB record datarC z(hex)r@ NrD rA r\ z (base 16)rB )rE rF r rH r' rG )r r6 r4 r5 rI r r r r0 & s zIAB._parse_datac C s t | j�S )z*The IEEE registration details for this IAB)r rH )r r r r rM 6 s zIAB.registrationc C s@ | j d> }d|d? d@ |d? d@ |d? d@ |d? d@ |d@ f S )z*:return: string representation of this IAB� z%02X-%02X-%02X-%02X-%02X-00� rN � r" rO )r )r rP r r r rQ : s z IAB.__str__c C s d| S )z@:return: executable Python string to recreate equivalent object.z IAB('%s')r )r r r r rR E s z IAB.__repr__)rH )F)F)r r r r r � staticmethodr[ r r; r< r= r? r0 rM rQ rR rT r r )r7 r rU � s 4 rU c s\ e Zd ZdZdGZdH� fdd� Zdd� Zd d � Zd d � Zd d� Z e ee dd�Z dd� Z dd� Z e e e dd�Ze dd� �Ze dd� �Zdd� Ze dd � �Ze d d � �Zd d � Zd!d"� Zd#d$� Zd%d&� Zd'd(� Zd)d*� Zd+d,� Zd-d.� Zd/d0� Z dId1d2�Z e d3d4� �Z e d5d6� �Z e d7d8� �Z d9d:� Z!d;d<� Z"d=d>� Z#d?d@� Z$e dAdB� �Z%dCdD� Z&dEdF� Z'� Z(S )J�EUIz� An IEEE EUI (Extended Unique Identifier). Both EUI-48 (used for layer 2 MAC addresses) and EUI-64 are supported. Input parsing for EUI-48 addresses is flexible, supporting many MAC variants. �_module�_dialectNc s� t t| �j� d| _t|t�rV|dk r:||jjkr:td��|j| _|j| _|j| _dS |dk r�|dkrnt | _q�|dkr~t | _q�td| ��nFt |�r�d| ko�dkn r�t | _n d| k o�dkn r�t | _|| _ || _dS ) a2 Constructor. :param addr: an EUI-48 (MAC) or EUI-64 address in string format or an unsigned integer. May also be another EUI object (copy construction). :param version: (optional) the explicit EUI address version, either 48 or 64. Mainly used to distinguish EUI-48 and EUI-64 identifiers specified as integers which may be numerically equivalent. :param dialect: (optional) the mac_* dialect to be used to configure the formatting of EUI-48 (MAC) addresses. Nz2cannot switch EUI versions using copy constructor!rX �@ zunsupported EUI version %rr l ��� l ���� ) r$ ra r rb r& �versionr* r �dialect�_eui48�_eui64r �value)r Zaddrre rf )r7 r r r V s, z EUI.__init__c C s | j | jj| jfS )z+:returns: Pickled state of an `EUI` object.)r rb re rf )r r r r r= � s zEUI.__getstate__c C sJ |\}}}|| _ |dkr t| _n |dkr0t| _ntdt|� ��|| _dS )zN :param state: data used to unpickle a pickled `EUI` object. rX rd z&unpickling failed for object state: %sN)r rg rb rh r* r' rf )r r> ri re rf r r r r? � s zEUI.__setstate__c C s | j S )N)r )r r r r � _get_value� s zEUI._get_valuec C s2 | j d kr�x�ttfD ]|}y|j|�| _|| _ P W q tk r� y4dt|� koZ|jkn rrt|�| _|| _ P W n tk r� Y nX Y qX qW | j d kr�td| ��n�t |�r�y| j j|�| _W n( tk r� td|| j j f ��Y nX n<dt|� k�o| j jkn �r"t|�| _n td| ��d S )Nr z failed to detect EUI version: %rzaddress %r is not an EUIv%dzbad address format: %r) rb rg rh Z str_to_intr r r( Zmax_intr* r re )r ri �moduler r r � _set_value� s4 $ zEUI._set_valuezBa positive integer representing the value of this EUI indentifier.c C s | j S )N)rc )r r r r � _get_dialect� s zEUI._get_dialectc C sJ |d kr"| j tkrt| _qFt| _n$t|d�r>t|d�r>|| _ntd��d S )N� word_sizeZword_fmtz*custom dialects should subclass mac_eui48!)rb rh r rc r �hasattrr+ )r ri r r r � _set_dialect� s zEUI._set_dialectzXa Python class providing support for the interpretation of various MAC address formats.c C s4 | j tkrt| jd? �S | j tkr0t| jd? �S dS )z:The OUI (Organisationally Unique Identifier) for this EUI.r_ �( N)rb rg r ri rh )r r r r r2 � s zEUI.ouic C s@ | j tkr dt| dd� � S | j tkr<dt| dd� � S dS )z*The EI (Extension Identifier) for this EUIz%02X-%02X-%02X� � z%02X-%02X-%02X-%02X-%02XrO N)rb rg �tuplerh )r r r r �ei� s zEUI.eic C s d| j d? kodkS S )z<:return: True if this EUI is an IAB address, False otherwisei rV i�/ )r )r r r r �is_iab� s z EUI.is_iabc C s | j � rt| jd? �S dS )zr If is_iab() is True, the IAB (Individual Address Block) is returned, ``None`` otherwise. rV N)rv rU r )r r r r r\ � s zEUI.iabc C s | j jS )z/The EUI version represented by this EUI object.)rb re )r r r r re � s z EUI.versionc s� t |�rL| jj}| | ko(|d kn s6td��| jj| j| j�| S t|t�r�| jj| j| j�� � fdd�t |j t � ��� D �S t d| ��dS )z� :return: The integer value of the word referenced by index (both positive and negative). Raises ``IndexError`` if index is out of bounds. Also supports Python list slices for accessing word groups. rW z!index out range for address type!c s g | ] }� | �qS r r )�.0�i)�wordsr r � <listcomp> s z#EUI.__getitem__.<locals>.<listcomp>zunsupported type %r!N) r rc � num_words� IndexErrorrb � int_to_wordsr r& �slice�range�indicesrJ r+ )r r@ r{ r )ry r � __getitem__� s zEUI.__getitem__c C s� t |t�rtd��t|�s"td��d| ko<| jjd kn sNtd| ��t|�s^td��d| kot| jjkn s�td|| jj f ��t | j j | j | j��}|||< | j j|�| _ dS ) z=Set the value of the word referenced by index in this addressz"settable slices are not supported!zindex not an integer!r rW z'index %d outside address type boundary!zvalue not an integer!z.value %d outside word size maximum of %d bits!N)r& r~ �NotImplementedErrorr r+ rc r{ r| Zmax_wordrn �listrb r} r Z words_to_int)r r@ ri ry r r r � __setitem__ s zEUI.__setitem__c C s t | j| jf�S )zA:return: hash of this EUI object suitable for dict keys, sets etc)�hashre r )r r r r �__hash__& s z EUI.__hash__c C sF t |t�s.y| j|�}W n tk r, tS X | j| jf|j|jfkS )zy :return: ``True`` if this EUI object is numerically the same as other, ``False`` otherwise. )r& ra r7 r8 r9 re r )r r: r r r r; * s z EUI.__eq__c C sF t |t�s.y| j|�}W n tk r, tS X | j| jf|j|jfkS )zy :return: ``True`` if this EUI object is numerically the same as other, ``False`` otherwise. )r& ra r7 r8 r9 re r )r r: r r r r< 6 s z EUI.__ne__c C sF t |t�s.y| j|�}W n tk r, tS X | j| jf|j|jfk S )z� :return: ``True`` if this EUI object is numerically lower in value than other, ``False`` otherwise. )r& ra r7 r8 r9 re r )r r: r r r �__lt__B s z EUI.__lt__c C sF t |t�s.y| j|�}W n tk r, tS X | j| jf|j|jfkS )z� :return: ``True`` if this EUI object is numerically lower or equal in value to other, ``False`` otherwise. )r& ra r7 r8 r9 re r )r r: r r r �__le__N s z EUI.__le__c C sF t |t�s.y| j|�}W n tk r, tS X | j| jf|j|jfkS )z� :return: ``True`` if this EUI object is numerically greater in value than other, ``False`` otherwise. )r& ra r7 r8 r9 re r )r r: r r r �__gt__Z s z EUI.__gt__c C sF t |t�s.y| j|�}W n tk r, tS X | j| jf|j|jfkS )z� :return: ``True`` if this EUI object is numerically greater or equal in value to other, ``False`` otherwise. )r& ra r7 r8 r9 re r )r r: r r r �__ge__f s z EUI.__ge__c C s | j j| j|�S )z� :param word_sep: (optional) the separator to insert between words. Default: None - use default separator for address type. :return: human-readable binary digit string of this address. )rb Z int_to_bitsr )r Zword_sepr r r �bitsr s zEUI.bitsc C s | j j| j�S )z8The value of this EUI address as a packed binary string.)rb Z int_to_packedr )r r r r �packed{ s z EUI.packedc C s | j j| j�S )z<A list of unsigned integer octets found in this EUI address.)rb r} r )r r r r ry � s z EUI.wordsc C s | j j| j�S )z� The value of this EUI 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. )rb Z int_to_binr )r r r r �bin� s zEUI.binc C sD | j dkr0| jd? }| jd@ }|d> dB |B }n| j}| j|dd�S )a2 - If this object represents an EUI-48 it is converted to EUI-64 as per the standard. - If this object is already an EUI-64, a new, numerically equivalent object is returned instead. :return: The value of this EUI object as a new 64-bit EUI object. rX r_ i��� rq l |�rd )re )re r r7 )r Z first_threeZ last_threeZ new_valuer r r r � s z EUI.eui64c C s | j � }| jdN _|S )z� - create a new EUI object with a modified EUI-64 as described in RFC 4291 section 2.5.1 :return: a new and modified 64-bit EUI object. l )r r )r r r r r �modified_eui64� s zEUI.modified_eui64c C s t |�t | j� � }t|dd�S )a5 .. note:: This poses security risks in certain scenarios. Please read RFC 4941 for details. Reference: RFCs 4291 and 4941. :param prefix: ipv6 prefix :return: new IPv6 `IPAddress` object based on this `EUI` using the technique described in RFC 4291. rs )re )r( r� r )r �prefixrP r r r �ipv6� s zEUI.ipv6c C s | j d�S )a .. note:: This poses security risks in certain scenarios. Please read RFC 4941 for details. Reference: RFCs 4291 and 4941. :return: new link local IPv6 `IPAddress` object based on this `EUI` using the technique described in RFC 4291. l @� )r� )r r r r �ipv6_link_local� s zEUI.ipv6_link_localc C s, d| j j� i}| j� r$| jj� |d< t|�S )z� A record dict containing IEEE registration details for this EUI (MAC-48) if available, None otherwise. r rU )r2 rM rv r\ r )r r6 r r r �info� s zEUI.infoc C s | j j| j| j�S )z':return: EUI in representational format)rb Z int_to_strr rc )r r r r rQ � s z EUI.__str__c C s d| S )z@:return: executable Python string to recreate equivalent object.z EUI('%s')r )r r r r rR � s z EUI.__repr__)rb rc )NN)N))r r r r r r r= r? rj rl rS ri rm rp rf r2 ru rv r\ re r� r� r� r; r< r� r� r� r� r� r� ry r� r r� r� r� r� rQ rR rT r r )r7 r ra J sL 2" ra N)r Z netaddr.corer r r Znetaddr.strategyr rg r rh Znetaddr.strategy.eui48r Znetaddr.strategy.eui64r Z netaddr.ipr Znetaddr.compatr r �objectr r rU ra r r r r �<module> s $
💾 Save Changes
❌ Cancel