Current File : //lib/python3/dist-packages/twisted/names/__pycache__/_rfc1982.cpython-312.pyc
�
Ϫ�f�# � �X � d Z ddlZddlmZmZ ddlmZ ddlmZ dZ G d� de� Z dgZ
y) a�
Utilities for handling RFC1982 Serial Number Arithmetic.
@see: U{http://tools.ietf.org/html/rfc1982}
@var RFC4034_TIME_FORMAT: RRSIG Time field presentation format. The Signature
Expiration Time and Inception Time field values MUST be represented either
as an unsigned decimal integer indicating seconds since 1 January 1970
00:00:00 UTC, or in the form YYYYMMDDHHmmSS in UTC. See U{RRSIG Presentation
Format<https://tools.ietf.org/html/rfc4034#section-3.2>}
� N)�datetime� timedelta)� nativeString)�
FancyStrMixinz %Y%m%d%H%M%Sc �� � e Zd ZdZdZddedefd�Zdedd fd�Zde fd �Z
d
� Z dede fd �Z
dede fd �Zdede fd
�Zdede fd�Zdede fd�Zdedd fd�Zd� Zed� � Zd� Zy)� SerialNumbera�
An RFC1982 Serial Number.
This class implements RFC1982 DNS Serial Number Arithmetic.
SNA is used in DNS and specifically in DNSSEC as defined in RFC4034 in the
DNSSEC Signature Expiration and Inception Fields.
@see: U{https://tools.ietf.org/html/rfc1982}
@see: U{https://tools.ietf.org/html/rfc4034}
@ivar _serialBits: See C{serialBits} of L{__init__}.
@ivar _number: See C{number} of L{__init__}.
@ivar _modulo: The value at which wrapping will occur.
@ivar _halfRing: Half C{_modulo}. If another L{SerialNumber} value is larger
than this, it would lead to a wrapped value which is larger than the
first and comparisons are therefore ambiguous.
@ivar _maxAdd: Half C{_modulo} plus 1. If another L{SerialNumber} value is
larger than this, it would lead to a wrapped value which is larger than
the first. Comparisons with the original value would therefore be
ambiguous.
))�_number�number�%d)� _serialBits�
serialBitsr r
r
c � � || _ d|z | _ d|dz
z | _ d|dz
z dz
| _ t |� | j z | _ y)a�
Construct an L{SerialNumber} instance.
@param number: An L{int} which will be stored as the modulo
C{number % 2 ^ serialBits}
@type number: L{int}
@param serialBits: The size of the serial number space. The power of two
which results in one larger than the largest integer corresponding
to a serial number value.
@type serialBits: L{int}
� � N)r �_modulo� _halfRing�_maxAdd�intr )�selfr
r
s �8/usr/lib/python3/dist-packages/twisted/names/_rfc1982.py�__init__zSerialNumber.__init__8 sP � � &����*�}�� � �J��N� 3����Z�!�^�,�q�0�� � ��K�$�,�,� 6�� � �other�returnc � � t |t � st d| �d|��� �| j |j k7 rt d| �d|��� �|S )a}
Check that a foreign object is suitable for use in the comparison or
arithmetic magic methods of this L{SerialNumber} instance. Raise
L{TypeError} if not.
@param other: The foreign L{object} to be checked.
@return: C{other} after compatibility checks and possible coercion.
@raise TypeError: If C{other} is not compatible.
zcannot compare or combine z and zLcannot compare or combine SerialNumber instances with different serialBits. )�
isinstancer � TypeErrorr �r r s r �
_convertOtherzSerialNumber._convertOtherK sZ � � �%� �.�� 8����e�Y� O�P� P� � � �u� 0� 0� 0��59�5�B��
�
� r c �4 � t d| j fz � S )zs
Return a string representation of this L{SerialNumber} instance.
@rtype: L{nativeString}
r )r r �r s r �__str__zSerialNumber.__str__` s � � �D�D�L�L�?� 2�3�3r c � � | j S )ze
@return: The integer value of this L{SerialNumber} instance.
@rtype: L{int}
)r r! s r �__int__zSerialNumber.__int__h s � �
�|�|�r c � � | j |� }|j | j k( S # t $ r t cY S w xY w)zW
Allow rich equality comparison with another L{SerialNumber} instance.
)r r �NotImplementedr r s r �__eq__zSerialNumber.__eq__o sC � � "��&�&�u�-�E� �}�}�� � �,�,�� � "�!� !� "�s �, �>�>c �X � | j |� }| j |j k xr& |j | j z
| j k xsA | j |j kD xr& | j |j z
| j kD S # t $ r t cY S w xY w)zV
Allow I{less than} comparison with another L{SerialNumber} instance.
�r r r& r r r s r �__lt__zSerialNumber.__lt__y s� � � "��&�&�u�-�E�
�L�L�5�=�=� (�
@�� � �� � �-�� � �?�
�
�L�L�5�=�=� (�
@�� � ��
�
�-�� � �?�
�� � "�!� !� "�� �B �B)�(B)c �X � | j |� }| j |j k xr& |j | j z
| j kD xsA | j |j kD xr& | j |j z
| j k S # t $ r t cY S w xY w)zY
Allow I{greater than} comparison with another L{SerialNumber} instance.
r) )r r �other_sns r �__gt__zSerialNumber.__gt__� s� � � "��)�)�%�0�H�
�L�L�8�+�+� +�
C��!�!�D�L�L�0�D�N�N�B�
�
�L�L�8�+�+� +�
C�� � �� 0� 0�0�D�N�N�B�
�� � "�!� !� "�r+ c �h � | j |� }| |k( xs | |k S # t $ r t cY S w xY w)zg
Allow I{less than or equal} comparison with another L{SerialNumber}
instance.
�r r r& r s r �__le__zSerialNumber.__le__� �C � �
"��&�&�u�-�E� �u�}�,��u� �,�� � "�!� !� "�� � �1�1c �h � | j |� }| |k( xs | |kD S # t $ r t cY S w xY w)zj
Allow I{greater than or equal} comparison with another L{SerialNumber}
instance.
r0 r s r �__ge__zSerialNumber.__ge__� r2 r3 c �B � | j |� }|j | j k r;t | j |j z | j z | j �� S t d|j �d| j ��� �# t $ r t cY S w xY w)ab
Allow I{addition} with another L{SerialNumber} instance.
Serial numbers may be incremented by the addition of a positive
integer n, where n is taken from the range of integers
[0 .. (2^(SERIAL_BITS - 1) - 1)]. For a sequence number s, the
result of such an addition, s', is defined as
s' = (s + n) modulo (2 ^ SERIAL_BITS)
where the addition and modulus operations here act upon values that are
non-negative values of unbounded size in the usual ways of integer
arithmetic.
Addition of a value outside the range
[0 .. (2^(SERIAL_BITS - 1) - 1)] is undefined.
@see: U{http://tools.ietf.org/html/rfc1982#section-3.1}
@raise ArithmeticError: If C{other} is more than C{_maxAdd}
ie more than half the maximum value of this serial number.
�r
zvalue z outside the range 0 .. ) r r r& r r r r r �ArithmeticErrorr s r �__add__zSerialNumber.__add__� s� � �. "��&�&�u�-�E� �=�=�D�L�L� (� �� � ��
�
�-�� � �=� �+�+��
�
"� �M�M��L�L���
�� � "�!� !� "�s �B � B � B c �, � t | j � S )zo
Allow L{SerialNumber} instances to be hashed for use as L{dict} keys.
@rtype: L{int}
)�hashr r! s r �__hash__zSerialNumber.__hash__� s � � �D�L�L�!�!r c � � t j |t � }t j |j � � } | |d�� S )a�
Create an L{SerialNumber} instance from a date string in format
'YYYYMMDDHHMMSS' described in U{RFC4034
3.2<https://tools.ietf.org/html/rfc4034#section-3.2>}.
The L{SerialNumber} instance stores the date as a 32bit UNIX timestamp.
@see: U{https://tools.ietf.org/html/rfc4034#section-3.1.5}
@param utcDateString: A UTC date/time string of format I{YYMMDDhhmmss}
which will be converted to seconds since the UNIX epoch.
@type utcDateString: L{unicode}
@return: An L{SerialNumber} instance containing the supplied date as a
32bit UNIX timestamp.
� r7 )r �strptime�RFC4034_TIME_FORMAT�calendar�timegm� utctimetuple)�cls�
utcDateString�
parsedDate�secondsSinceEpochs r �fromRFC4034DateStringz"SerialNumber.fromRFC4034DateString� s= � �$ �&�&�}�6I�J�
� $�O�O�J�,C�,C�,E� F���$��4�4r c � � t ddd� t | j �� z }t |j t
� � S )a
Calculate a date by treating the current L{SerialNumber} value as a UNIX
timestamp and return a date string in the format described in
U{RFC4034 3.2<https://tools.ietf.org/html/rfc4034#section-3.2>}.
@return: The date string.
i� r )�seconds)r r r r �strftimer@ )r �ds r �toRFC4034DateStringz SerialNumber.toRFC4034DateString� s5 � �
�T�1�a� �9�T�\�\�#B� B���A�J�J�':� ;�<�<r N)r> )�__name__�
__module__� __qualname__�__doc__�showAttributesr r �objectr �strr" r$ �boolr' r* r. r1 r5 r9 r< � classmethodrH rM � r r r r s� � ��.�N�
7�s� 7�� 7�&�6� �n� �*4�� 4� �-�F� -�t� -�
�F�
�t�
�
�F�
�t�
� -�F� -�t� -� -�F� -�t� -�'�V� '�� '�R"� �5� �5�* =r r ) rQ rA r r �twisted.python.compatr �twisted.python.utilr r@ r �__all__rW r r �<module>r[ s7 ��
� � (� .� -�$� �g=�=� g=�T �
�r
Mini Shell