/
lib
/
python3.9
/
site-packages
/
elftools
/
construct
/
__pycache__
/
up file
home
a �#�_�S � @ s� d dl mZ d dlmZmZmZmZ d dlmZm Z m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZ d dlmZm Z m Z m Z m Z m Z m!Z!m"Z"m#Z#m$Z$ dd� Z%d�d d �Z&d�d d �Z'd�dd�Z(dd� Z)dd� Z*dd� Z+dd� Z,dd� Z-dd � Z.d d � Z/d d � Z0d!d"� Z1d#d$� Z2d%d&� Z3d'd(� Z4d)d*� Z5d+d,� Z6d-d.� Z7d/d0� Z8d1d2� Z9d3d4� Z:d5d6� Z;d7d8� Z<d9d:� Z=d;d<� Z>d=d>� Z?d?d@� Z@dAdB� ZAdCdD� ZBdEdF� ZCdGdH� ZDdIdJ� ZEdKdL� ZFdMdN� ZGdOdP� ZHdQdR� ZIdSdT� ZJe,dU�fdVdW�ZKdXdY� ZLdZd[� ZMd\d]� ZNd^d_� ZOd`da� ZPd�dcdd�ZQdedf� ZRdgdh� ZSdidj� ZTdkdl� ZUeVfdmdn�ZWdodp� ZXdqdr� ZYdsdt� ZZdudv� Z[dwdx� Z\d�d{d|�Z]e,dU�dyfd}d~�Z^d dye%dyd �fdd��Z_d�d�� Z`d�d�d��Zad�d�d��Zbd�d�� ZcdyS )�� )�int2byte)�BitStreamReader�BitStreamWriter� encode_bin� decode_bin)�Struct� MetaField� StaticField� FormatField�OnDemand�Pointer�Switch�Value� RepeatUntil� MetaArray�Sequence�Range�Select�Pass� SizeofError�Buffered�Restream�Reconfig) �BitIntegerAdapter�PaddingAdapter� ConstAdapter�CStringAdapter�LengthValueAdapter�IndexingAdapter�PaddedStringAdapter� FlagsAdapter� StringAdapter�MappingAdapterc C s t |�rt| |�S t| |�S dS )a* A field consisting of a specified number of bytes. :param str name: the name of the field :param length: the length of the field. the length can be either an integer (StaticField), or a function that takes the context as an argument and returns the length (MetaField) N)�callabler r )�name�length� r& �=/usr/lib/python3.9/site-packages/elftools/construct/macros.py�Field s r( F� c C s t t| |�||||d�S )a� BitFields, as the name suggests, are fields that operate on raw, unaligned bits, and therefore must be enclosed in a BitStruct. Using them is very similar to all normal fields: they take a name and a length (in bits). :param str name: name of the field :param int length: number of bits in the field, or a function that takes the context as its argument and returns the length :param bool swapped: whether the value is byte-swapped :param bool signed: whether the value is signed :param int bytesize: number of bits per byte, for byte-swapping >>> foo = BitStruct("foo", ... BitField("a", 3), ... Flag("b"), ... Padding(3), ... Nibble("c"), ... BitField("d", 5), ... ) >>> foo.parse("\xe1\x1f") Container(a = 7, b = False, c = 8, d = 31) >>> foo = BitStruct("foo", ... BitField("a", 3), ... Flag("b"), ... Padding(3), ... Nibble("c"), ... Struct("bar", ... Nibble("d"), ... Bit("e"), ... ) ... ) >>> foo.parse("\xe1\x1f") Container(a = 7, b = False, bar = Container(d = 15, e = 1), c = 8) )�swapped�signed�bytesize)r r( )r$ r% r* r+ r, r& r& r' �BitField s $ �r- � c C s t td| �||d�S )a� a padding field (value is discarded) * length - the length of the field. the length can be either an integer, or a function that takes the context as an argument and returns the length * pattern - the padding pattern (character/byte) to use. default is b"\x00" * strict - whether or not to raise an exception is the actual padding pattern mismatches the desired pattern. default is False. N)�pattern�strict)r r( )r% r/ r0 r& r& r' �PaddingH s �r1 � c C s" t t| d�t|�t|�d�|d�S )a@ A flag. Flags are usually used to signify a Boolean value, and this construct maps values onto the ``bool`` type. .. note:: This construct works with both bit and byte contexts. .. warning:: Flags default to False, not True. This is different from the C and Python way of thinking about truth, and may be subject to change in the future. :param str name: field name :param int truth: value of truth (default 1) :param int falsehood: value of falsehood (default 0) :param bool default: default value (default False) r �TF)�default)�SymmetricMappingr( r )r$ �truthZ falsehoodr4 r& r& r' �FlagV s �r7 c C s t | d�S )z1a 1-bit BitField; must be enclosed in a BitStructr �r- �r$ r& r& r' �Bitq s r: c C s t | d�S )z1a 4-bit BitField; must be enclosed in a BitStruct� r8 r9 r& r& r' �Nibblet s r< c C s t | d�S )z2an 8-bit BitField; must be enclosed in a BitStructr) r8 r9 r& r& r' �Octetw s r= c C s t | dd�S )z"unsigned, big endian 8-bit integer�>�B�r r9 r& r& r' �UBInt8{ s rA c C s t | dd�S )z#unsigned, big endian 16-bit integerr> �Hr@ r9 r& r& r' �UBInt16~ s rC c C s t | dd�S )z#unsigned, big endian 32-bit integerr> �Lr@ r9 r& r& r' �UBInt32� s rE c C s t | dd�S )z#unsigned, big endian 64-bit integerr> �Qr@ r9 r& r& r' �UBInt64� s rG c C s t | dd�S )z signed, big endian 8-bit integerr> �br@ r9 r& r& r' �SBInt8� s rI c C s t | dd�S )z!signed, big endian 16-bit integerr> �hr@ r9 r& r& r' �SBInt16� s rK c C s t | dd�S )z!signed, big endian 32-bit integerr> �lr@ r9 r& r& r' �SBInt32� s rM c C s t | dd�S )z!signed, big endian 64-bit integerr> �qr@ r9 r& r& r' �SBInt64� s rO c C s t | dd�S )z%unsigned, little endian 8-bit integer�<r? r@ r9 r& r& r' �ULInt8� s rQ c C s t | dd�S )z&unsigned, little endian 16-bit integerrP rB r@ r9 r& r& r' �ULInt16� s rR c C s t | dd�S )z&unsigned, little endian 32-bit integerrP rD r@ r9 r& r& r' �ULInt32� s rS c C s t | dd�S )z&unsigned, little endian 64-bit integerrP rF r@ r9 r& r& r' �ULInt64� s rT c C s t | dd�S )z#signed, little endian 8-bit integerrP rH r@ r9 r& r& r' �SLInt8� s rU c C s t | dd�S )z$signed, little endian 16-bit integerrP rJ r@ r9 r& r& r' �SLInt16� s rV c C s t | dd�S )z$signed, little endian 32-bit integerrP rL r@ r9 r& r& r' �SLInt32� s rW c C s t | dd�S )z$signed, little endian 64-bit integerrP rN r@ r9 r& r& r' �SLInt64� s rX c C s t | dd�S )z(unsigned, native endianity 8-bit integer�=r? r@ r9 r& r& r' �UNInt8� s rZ c C s t | dd�S )z)unsigned, native endianity 16-bit integerrY rB r@ r9 r& r& r' �UNInt16� s r[ c C s t | dd�S )z)unsigned, native endianity 32-bit integerrY rD r@ r9 r& r& r' �UNInt32� s r\ c C s t | dd�S )z)unsigned, native endianity 64-bit integerrY rF r@ r9 r& r& r' �UNInt64� s r] c C s t | dd�S )z&signed, native endianity 8-bit integerrY rH r@ r9 r& r& r' �SNInt8� s r^ c C s t | dd�S )z'signed, native endianity 16-bit integerrY rJ r@ r9 r& r& r' �SNInt16� s r_ c C s t | dd�S )z'signed, native endianity 32-bit integerrY rL r@ r9 r& r& r' �SNInt32� s r` c C s t | dd�S )z'signed, native endianity 64-bit integerrY rN r@ r9 r& r& r' �SNInt64� s ra c C s t | dd�S )z-big endian, 32-bit IEEE floating point numberr> �fr@ r9 r& r& r' �BFloat32� s rc c C s t | dd�S )z0little endian, 32-bit IEEE floating point numberrP rb r@ r9 r& r& r' �LFloat32� s rd c C s t | dd�S )z3native endianity, 32-bit IEEE floating point numberrY rb r@ r9 r& r& r' �NFloat32� s re c C s t | dd�S )z-big endian, 64-bit IEEE floating point numberr> �dr@ r9 r& r& r' �BFloat64� s rg c C s t | dd�S )z0little endian, 64-bit IEEE floating point numberrP rf r@ r9 r& r& r' �LFloat64� s rh c C s t | dd�S )z3native endianity, 64-bit IEEE floating point numberrY rf r@ r9 r& r& r' �NFloat64� s ri c s6 t � �rt� |�}n t� fdd�|�}|�|j� |S )a� Repeats the given unit a fixed number of times. :param int count: number of times to repeat :param ``Construct`` subcon: construct to repeat >>> c = Array(4, UBInt8("foo")) >>> c.parse("\x01\x02\x03\x04") [1, 2, 3, 4] >>> c.parse("\x01\x02\x03\x04\x05\x06") [1, 2, 3, 4] >>> c.build([5,6,7,8]) '\x05\x06\x07\x08' >>> c.build([5,6,7,8,9]) Traceback (most recent call last): ... construct.core.RangeError: expected 4..4, found 5 c s � S �Nr& ��ctx��countr& r' �<lambda>� � zArray.<locals>.<lambda>)r# r Z _clear_flag� FLAG_DYNAMIC)rn �subcon�conr& rm r' �Array� s rt r% c s$ t t| j� t� fdd�| �dd��S )z�an array prefixed by a length field. * subcon - the subcon to be repeated * length_field - a construct returning an integer c s | � j S rj r9 rk �� length_fieldr& r' ro rp z PrefixedArray.<locals>.<lambda>F��nested)r r r$ rt )rr rv r& ru r' � PrefixedArray� s ��ry c C s ddl m} t| ||�S )Nr2 )�maxsize)�sysrz r )Zmincountrr rz r& r& r' � OpenRange s r| c C s t d| �S )a� Repeats the given unit one or more times. :param ``Construct`` subcon: construct to repeat >>> from construct import GreedyRange, UBInt8 >>> c = GreedyRange(UBInt8("foo")) >>> c.parse("\x01") [1] >>> c.parse("\x01\x02\x03") [1, 2, 3] >>> c.parse("\x01\x02\x03\x04\x05\x06") [1, 2, 3, 4, 5, 6] >>> c.parse("") Traceback (most recent call last): ... construct.core.RangeError: expected 1..2147483647, found 0 >>> c.build([1,2]) '\x01\x02' >>> c.build([]) Traceback (most recent call last): ... construct.core.RangeError: expected 1..2147483647, found 0 r �r| �rr r& r& r' � GreedyRange s r c C s t d| �S )a� Repeats the given unit zero or more times. This repeater can't fail, as it accepts lists of any length. :param ``Construct`` subcon: construct to repeat >>> from construct import OptionalGreedyRange, UBInt8 >>> c = OptionalGreedyRange(UBInt8("foo")) >>> c.parse("") [] >>> c.parse("\x01\x02") [1, 2] >>> c.build([]) '' >>> c.build([1,2]) '\x01\x02' r2 r} r~ r& r& r' �OptionalGreedyRange) s r� c C s t | j| t�S )zran optional construct. if parsing fails, returns None. * subcon - the subcon to optionally parse or build )r r$ r r~ r& r& r' �OptionalB s r� c C sJ d}dd� }| � | j�s6| �� |k r6t| tt|d�}nt| tt|d�}|S )zzconverts the stream to bits, and passes the bitstream to subcon * subcon - a bitwise construct (usually BitField) i c S s | d@ rt d| ��| d? S )N� z size must be a multiple of 8� )r )r% r& r& r' �resizerO s zBitwise.<locals>.resizer)�encoder�decoderr� )Z stream_readerZ stream_writerr� ) Z_is_flagrq Zsizeofr r r r r r )rr Z MAX_BUFFERr� rs r& r& r' �BitwiseH s ��r� r; c s: � dk rt d� ��� �fdd�}t�j�t||d�dd�S )z�aligns subcon to modulus boundary using padding pattern * subcon - the subcon to align * modulus - the modulus boundary (default is 4) * pattern - the padding pattern (default is \x00) � zmodulus must be >= 2c s � �� | �� � S rj )Z_sizeofrk ��modulusrr r& r' � padlengthh s zAligned.<locals>.padlength)r/ Frw )� ValueError�SeqOfOner$ r1 )rr r� r/ r� r& r� r' �Aligned` s �r� c O s t t| g|�R i |��dd�S )z�a sequence of one element. only the first element is meaningful, the rest are discarded * name - the name of the sequence * args - subconstructs * kw - any keyword arguments to Sequence r2 )�index)r r )r$ �args�kwr& r& r' r� t s r� c C s t | j| | j�S )zRembeds a struct into the enclosing struct. * subcon - the struct to embed )r r$ Z FLAG_EMBEDr~ r& r& r' �Embedded} s r� c C s t | |�S )zcrenames an existing construct * newname - the new name * subcon - the subcon to rename )r )�newnamerr r& r& r' �Rename� s r� c s t | � fdd��S )z�creates an alias for an existing element in a struct * newname - the new name * oldname - the name of an existing element c s | � S rj r& rk ��oldnamer& r' ro � rp zAlias.<locals>.<lambda>)r )r� r� r& r� r' �Alias� s r� c C s( t dd� |�� D ��}t| ||||d�S )a� defines a symmetrical mapping: a->b, b->a. * subcon - the subcon to map * mapping - the encoding mapping (a dict); the decoding mapping is achieved by reversing this mapping * default - the default value to use when no mapping is found. if no default value is given, and exception is raised. setting to Pass would return the value "as is" (unmapped) c s s | ]\}}||fV qd S rj r& )�.0�k�vr& r& r' � <genexpr>� rp z#SymmetricMapping.<locals>.<genexpr>)�encodingZdecodingZ encdefaultZ decdefault)�dict�itemsr" )rr �mappingr4 Zreversed_mappingr& r& r' r5 � s �r5 c K s t | ||�dt��S )a� a set of named values mapping. * subcon - the subcon to map * kw - keyword arguments which serve as the encoding mapping * _default_ - an optional, keyword-only argument that specifies the default value to use when the mapping is undefined. if not given, and exception is raised when the mapping is undefined. use `Pass` to pass the unmapped value as-is Z _default_)r5 �pop�NotImplemented�rr r� r& r& r' �Enum� s r� c K s t | |�S )z�a set of flag values mapping. * subcon - the subcon to map * kw - keyword arguments which serve as the encoding mapping )r r� r& r& r' � FlagsEnum� s r� c s t | g� fdd�|D ��R � S )z�a struct of aligned fields * name - the name of the struct * subcons - the subcons that make up this structure * kw - keyword arguments to pass to Aligned: 'modulus' and 'pattern' c 3 s | ]}t |fi � ��V qd S rj )r� )r� Zsc�r� r& r' r� � rp z AlignedStruct.<locals>.<genexpr>)r )r$ �subconsr� r& r� r' � AlignedStruct� s r� c G s t t| g|�R � �S )z{a struct of bitwise fields * name - the name of the struct * subcons - the subcons that make up this structure )r� r )r$ r� r& r& r' � BitStruct� s r� c G s t ttdg| �R � ��S )zian embedded BitStruct. no name is necessary. * subcons - the subcons that make up this structure N)r� r� r )r� r& r& r' �EmbeddedBitStruct� s r� N�rightc C s. t t| |�|d�}|dur*t||||d�}|S )ae A configurable, fixed-length string field. The padding character must be specified for padding and trimming to work. :param str name: name :param int length: length, in bytes :param str encoding: encoding (e.g. "utf8") or None for no encoding :param str padchar: optional character to pad out strings :param str paddir: direction to pad out strings; one of "right", "left", or "both" :param str trim: direction to trim strings; one of "right", "left" >>> from construct import String >>> String("foo", 5).parse("hello") 'hello' >>> >>> String("foo", 12, encoding = "utf8").parse("hello joh\xd4\x83n") u'hello joh\u0503n' >>> >>> foo = String("foo", 10, padchar = "X", paddir = "right") >>> foo.parse("helloXXXXX") 'hello' >>> foo.build("hello") 'helloXXXXX' �r� N)�padchar�paddir�trimdir)r! r( r )r$ r% r� r� r� r� rs r& r& r' �String� s �r� c s& t tt| � td� fdd����|d�S )a- A length-prefixed string. ``PascalString`` is named after the string types of Pascal, which are length-prefixed. Lisp strings also follow this convention. The length field will appear in the same ``Container`` as the ``PascalString``, with the given name. :param str name: name :param ``Construct`` length_field: a field which will store the length of the string :param str encoding: encoding (e.g. "utf8") or None for no encoding >>> foo = PascalString("foo") >>> foo.parse("\x05hello") 'hello' >>> foo.build("hello world") '\x0bhello world' >>> >>> foo = PascalString("foo", length_field = UBInt16("length")) >>> foo.parse("\x00\x05hello") 'hello' >>> foo.build("hello") '\x00\x05hello' �datac s | � j S rj r9 rk ru r& r' ro rp z PascalString.<locals>.<lambda>r� )r! r r r( )r$ rv r� r& ru r' � PascalString� s ���r� c s" t | tt� fdd�|�� |d��S )aH A string ending in a terminator. ``CString`` is similar to the strings of C, C++, and other related programming languages. By default, the terminator is the NULL byte (b``0x00``). :param str name: name :param iterable terminators: sequence of valid terminators, in order of preference :param str encoding: encoding (e.g. "utf8") or None for no encoding :param ``Construct`` char_field: construct representing a single character >>> foo = CString("foo") >>> foo.parse(b"hello\x00") b'hello' >>> foo.build(b"hello") b'hello\x00' >>> foo = CString("foo", terminators = b"XYZ") >>> foo.parse(b"helloX") b'hello' >>> foo.parse(b"helloY") b'hello' >>> foo.parse(b"helloZ") b'hello' >>> foo.build(b"hello") b'helloX' c s | � v S rj r& )�objrl �� terminatorsr& r' ro ? rp zCString.<locals>.<lambda>)r� r� )r� r r )r$ r� r� Z char_fieldr& r� r' �CString s ��r� c s t | � fdd�||d��S )a� an if-then-else conditional construct: if the predicate indicates True, `then_subcon` will be used; otherwise `else_subcon` * name - the name of the construct * predicate - a function taking the context as an argument and returning True or False * then_subcon - the subcon that will be used if the predicate returns True * else_subcon - the subcon that will be used if the predicate returns False c s t � | ��S rj )�boolrk �� predicater& r' ro R rp z IfThenElse.<locals>.<lambda>r3 )r )r$ r� Z then_subconZ else_subconr& r� r' � IfThenElseI s ��r� c s t |j| |td� fdd���S )a� an if-then conditional construct: if the predicate indicates True, subcon will be used; otherwise, `elsevalue` will be returned instead. * predicate - a function taking the context as an argument and returning True or False * subcon - the subcon that will be used if the predicate returns True * elsevalue - the value that will be used should the predicate return False. by default this value is None. � elsevaluec s � S rj r& rk �r� r& r' ro e rp zIf.<locals>.<lambda>)r� r$ r )r� rr r� r& r� r' �IfY s �r� Tc C s t t| |�d|d�S )a$ an on-demand pointer. * offsetfunc - a function taking the context as an argument and returning the absolute stream position * subcon - the subcon that will be parsed from the `offsetfunc()` stream position on demand * force_build - see OnDemand. by default True. F)Zadvance_stream� force_build)r r )Z offsetfuncrr r� r& r& r' �OnDemandPointerl s �r� c C s t td t| ��| �S rj )r r( �len)r� r& r& r' �Magicy s r� )FFr) )r. F)r r2 F)r; r. )NNr� r� )N)T)dZ lib.py3compatr �libr r r r Zcorer r r r r r r r r r r r r r r r r r Zadaptersr r r r r r r r r! r" r( r- r1 r7 r: r< r= rA rC rE rG rI rK rM rO rQ rR rS rT rU rV rW rX rZ r[ r\ r] r^ r_ r` ra rc rd re rg rh ri rt ry r| r r� r� r� r� r� r� r� r� r� r5 r� r� r� r� r� r� r� r� r� r� r� r� r& r& r& r' �<module> s� P0 + � #&� ,