Your IP : 216.73.216.213
]��X�K � 8 @ s d Z d d l m Z m Z m Z m Z d d l m Z m Z d d l Z d d l Z d d l
Z
d d l Z d d l Z d d l
m Z d d l m Z d d l m Z d d l m Z m Z m Z m Z m Z d d
l m Z m Z d d l m Z m Z m Z m Z e j! d f k r;d d
l" m# Z$ e% Z& d Z' n d d l( m$ Z$ d Z' e j) � d d d d d d d d i Z* d d d d d d d d d d d d d d d d i Z+ d d d d i Z, e j- d � Z. i Z/ d d d � Z0 Gd d � d e1 � Z2 Gd d � d � Z3 Gd d � d e1 � Z4 Gd! d" � d" e1 � Z5 Gd# d$ � d$ e2 � Z6 e6 � Z7 Gd% d& � d& e2 � Z8 Gd' d( � d( e2 � Z9 Gd) d* � d* e1 � Z: Gd+ d, � d, e2 � Z; Gd- d. � d. e5 e; � Z< Gd/ d0 � d0 e; � Z= Gd1 d2 � d2 e; e3 � Z> Gd3 d4 � d4 e5 e4 e; e3 e1 � Z? Gd5 d6 � d6 e5 e4 e; � Z@ Gd7 d8 � d8 e5 e4 e; � ZA Gd9 d: � d: e5 e4 e; � ZB Gd; d< � d< e5 e4 e; � ZC Gd= d> � d> e5 e4 e; � ZD Gd? d@ � d@ eD � ZE GdA dB � dB e; � ZF GdC dD � dD e; e3 � ZG GdE dF � dF e; � ZH GdG dH � dH e; � ZI GdI dJ � dJ e; � ZJ GdK dL � dL e> � ZK GdM dN � dN e< � ZL GdO dP � dP eG � ZM GdQ dR � dR e2 � ZN GdS dT � dT e2 � ZO GdU dV � dV eN � ZP GdW dX � dX eO � ZQ GdY dZ � dZ eN � ZR Gd[ d\ � d\ e< � ZS Gd] d^ � d^ e< � ZT Gd_ d` � d` e< � ZU Gda db � db eB � ZV Gdc dd � dd e< � ZW Gde df � df e< � ZX Gdg dh � dh eX � ZY Gdi dj � dj eX � ZZ Gdk dl � dl e< � Z[ Gdm dn � dn e< � Z\ Gdo dp � dp e< � Z] Gdq dr � dr e< � Z^ Gds dt � dt e< � Z_ Gdu dv � dv e< � Z` dw dx � Za dy dz � Zb d{ d| � Zc d e= d e> d e? d} eB d~ eF d eG d� eH d� eI d� eJ d� eK d� eR d� eL d� eM d� eN d� eP d� eS d� eT d� eU d� eV d� eW d� eY d� eZ d� e[ d� e\ d� e] d� e^ d� e_ d� e` i Zd d d d d� d� � Ze d d d d d� d� � Zf d S)�a
ASN.1 type classes for universal types. Exports the following items:
- load()
- Any()
- Asn1Value()
- BitString()
- BMPString()
- Boolean()
- CharacterString()
- Choice()
- EmbeddedPdv()
- Enumerated()
- GeneralizedTime()
- GeneralString()
- GraphicString()
- IA5String()
- InstanceOf()
- Integer()
- IntegerBitString()
- IntegerOctetString()
- Null()
- NumericString()
- ObjectDescriptor()
- ObjectIdentifier()
- OctetBitString()
- OctetString()
- PrintableString()
- Real()
- RelativeOid()
- Sequence()
- SequenceOf()
- Set()
- SetOf()
- TeletexString()
- UniversalString()
- UTCTime()
- UTF8String()
- VideotexString()
- VisibleString()
- VOID
- Void()
Other type classes are defined that help compose the types listed above.
� )�unicode_literals�division�absolute_import�print_function)�datetime� timedeltaN� )�_teletex_codec)�unwrap)� OrderedDict)� type_name�str_cls�byte_cls� int_types�chr_cls)�_parse� _dump_header)� int_to_bytes�int_from_bytes�timezone�extended_datetime� )�StringIOT)�BytesIOF� universalZ application� �contextZprivateZ primitiveZ constructedz
^\d+(\.\d+)*$c C s t j | d | �S)a5
Loads a BER/DER-encoded byte string and construct a universal object based
on the tag value:
- 1: Boolean
- 2: Integer
- 3: BitString
- 4: OctetString
- 5: Null
- 6: ObjectIdentifier
- 7: ObjectDescriptor
- 8: InstanceOf
- 9: Real
- 10: Enumerated
- 11: EmbeddedPdv
- 12: UTF8String
- 13: RelativeOid
- 16: Sequence,
- 17: Set
- 18: NumericString
- 19: PrintableString
- 20: TeletexString
- 21: VideotexString
- 22: IA5String
- 23: UTCTime
- 24: GeneralizedTime
- 25: GraphicString
- 26: VisibleString
- 27: GeneralString
- 28: UniversalString
- 29: CharacterString
- 30: BMPString
:param encoded_data:
A byte string of BER or DER-encoded data
:param strict:
A boolean indicating if trailing data should be forbidden - if so, a
ValueError will be raised when trailing data exists
:raises:
ValueError - when strict is True and trailing data is present
ValueError - when the encoded value tag a tag other than listed above
ValueError - when the ASN.1 header length is longer than the data
TypeError - when encoded_data is not a byte string
:return:
An instance of the one of the universal classes
�strict)� Asn1Value�load)� encoded_datar � r! �@/opt/alt/python35/lib/python3.5/site-packages/asn1crypto/core.pyr r s 3r c @ s- e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d Z d Z d Z
d Z e d d d � � Z d d d d d d 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 d d � Z d d d! � Z d d" d# � Z d S)$r z'
The basis of all ASN.1 values
N� Fc K sh t | t � s% t d t | � � � d } | j d k r@ | } t | d | d | d | �\ } } | S)a�
Loads a BER/DER-encoded byte string using the current class as the spec
:param encoded_data:
A byte string of BER or DER-encoded data
:param strict:
A boolean indicating if trailing data should be forbidden - if so, a
ValueError will be raised when trailing data exists
:return:
An instance of the current class
z*encoded_data must be a byte string, not %sN�spec� spec_paramsr )�
isinstancer � TypeErrorr �tag� _parse_build)�clsr r �kwargsr$ �value�_r! r! r" r � s $zAsn1Value.loadc
C s y�| j t k r> | j } t | d � r4 | j � d t | <| d k r)| d k rq t t d t | � � � � | | _ | d k r� d } | t k r� t t d t | � � � � t | } | d k r� t | t
� s� t t d t | � � � � | d k r| | _
| | _ q~| | _ | | _ nU | d k ri| t k r\t t d
t | � � � � t | | _
| d k r~| | _ | d k r�| | _ n | d k r�| j | � Wni t t f k
r} zC | j d d � } | j d d
t | � f | | _ | � WYd d } ~ Xn Xd S)a5
The optional parameter is not used, but rather included so we don't
have to delete it from the parameter dictionary when passing as keyword
args
:param tag_type:
None for normal values, or one of "implicit", "explicit" for tagged
values
:param class_:
The class for the value - defaults to "universal" if tag_type is
None, otherwise defaults to "context". Valid values include:
- "universal"
- "application"
- "context"
- "private"
:param tag:
The integer tag to override - usually this is used with tag_type or
class_
:param optional:
Dummy parameter that allows "optional" key in spec param dicts
:param default:
The default value to use if the value is currently None
:param contents:
A byte string of the encoded contents of the value
:raises:
ValueError - when tag_type, class_ or tag are invalid values
�_setupTN�implicit�explicitzh
tag_type must be one of "implicit", "explicit", not %s
r z�
class_ must be one of "universal", "application",
"context", "private", not %s
zX
tag must be an integer, not %s
z�
class_ must be one of "universal", "application",
"context", "private", not %s
r r z
while constructing %s)r/ r0 )� __class__�_SETUP_CLASSES�hasattrr. �
ValueErrorr
�repr�tag_type�CLASS_NAME_TO_NUM_MAPr& r r' r �class_r( �explicit_class� explicit_tag�CLASS_NUM_TO_NAME_MAP�contents�set�args)
�selfr6 r8 r( �optional�defaultr< r* �er> r! r! r" �__init__� sZ #
%zAsn1Value.__init__c C s t r | j � S| j � Sd S)z�
Since str is differnt in Python 2 and 3, this calls the appropriate
method, __unicode__() or __bytes__()
:return:
A unicode string
N)�_PY2� __bytes__� __unicode__)r? r! r! r" �__str__R s
zAsn1Value.__str__c C s\ t r/ d t | � t | � t | j � � f Sd t | � t | � t | j � � f Sd S)z7
:return:
A unicode string
z <%s %s b%s>z
<%s %s %s>N)rD r �idr5 �dump)r? r! r! r" �__repr__` s )zAsn1Value.__repr__c C s | j � j d � S)z�
A fall-back method for print() in Python 2
:return:
A byte string of the output of repr()
zutf-8)rJ �encode)r? r! r! r" rE k s zAsn1Value.__bytes__c C s
| j � S)z�
A fall-back method for print() in Python 3
:return:
A unicode string of the output of repr()
)rJ )r? r! r! r" rF u s zAsn1Value.__unicode__c C sL | j � } | j | _ | j | _ | j | _ | j | _ | j | _ | S)z�
Constructs a new copy of the current object, preserving any tagging
:return:
An Asn1Value object
)r1 r6 r8 r( r9 r: )r? �new_objr! r! r" �
_new_instance s zAsn1Value._new_instancec C s# | j � } | j | t j � | S)z�
Implements the copy.copy() interface
:return:
A new shallow copy of the current Asn1Value object
)rM �_copy�copy)r? rL r! r! r" �__copy__� s zAsn1Value.__copy__c C s3 | j � } | | t | � <| j | t j � | S)z�
Implements the copy.deepcopy() interface
:param memo:
A dict for memoization
:return:
A new deep copy of the current Asn1Value object
)rM rH rN rO �deepcopy)r? �memorL r! r! r" � __deepcopy__� s zAsn1Value.__deepcopy__c C s
t j | � S)z}
Copies the object, preserving any special tagging from it
:return:
An Asn1Value object
)rO rQ )r? r! r! r" rO � s zAsn1Value.copyc C s/ | j d | d | � } | j | t j � | S)z�
Copies the object, applying a new tagging to it
:param tag_type:
A unicode string of "implicit" or "explicit"
:param tag:
A integer tag number
:return:
An Asn1Value object
r6 r( )r1 rN rO rQ )r? r6 r( rL r! r! r" �retag� s zAsn1Value.retagc C s# | j � } | j | t j � | S)z{
Copies the object, removing any special tagging from it
:return:
An Asn1Value object
)r1 rN rO rQ )r? rL r! r! r" �untag� s zAsn1Value.untagc C sX | j | j k r6 t t d t | � t | � � � � | j | _ | | j � | _ d S)a!
Copies the contents of another Asn1Value object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
zQ
Can not copy values from %s object to %s object
N)r1 r' r
r r< �_native)r? �other� copy_funcr! r! r" rN � s zAsn1Value._copyr c C s� d | } t | d � } t | | � | rC | j j | d � nu t | d � ri | j j | d � nO t r� t | j t � r� t d | t
| j � f � n t d | | j f � d S)zJ
Show the binary data and parsed data in a tree structure
z �parsedr �chosenz%s Native: b%sz%s Native: %sN) r3 � _basic_debugrY �debugrZ rD r& �nativer �printr5 )r? �
nest_level�prefixZ
has_parsedr! r! r" r\ � s
zAsn1Value.debugc C s� | j } | j d k s | r� t | t � r? | j r? d | _ t | j | j | j | j � } d } | j d k r� t
� } d | _ | j | _ | j | _ | | j | | _ | j
� | j | } | | j 7} | | _ | | _ | j | | j S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
Nr r# r0 r )r< �_headerr& �
Constructable� _indefinite�methodr r8 r( r6 r r9 r: rI �_trailer)r? �forcer< �header�trailerZ containerr! r! r" rI s$ !
zAsn1Value.dump) �__name__�
__module__� __qualname__�__doc__rd r8 r( �_bad_tagr6 r9 r: ra r< re rV � classmethodr rC rG rJ rE rF rM rP rS rO rT rU rN r\ rI r! r! r! r" r � s8 i
r c @ s. e Z d Z d Z d Z d Z d d � Z d S)�ValueMapzl
Basic functionality that allows for mapping values from ints or OIDs to
python unicode strings
Nc C se | j } | j d k s' | j d k r+ d Si | _ x* | j j � D] \ } } | | j | <qD Wd S)z2
Generates _reverse_map from _map
N)r1 �_map� _reverse_map�items)r? r* �keyr, r! r! r" r. 5 s zValueMap._setup)ri rj rk rl rp rq r. r! r! r! r" ro ' s ro c @ s" e Z d Z d Z d d � Z d S)�Castablez�
A mixin to handle converting an object between different classes that
represent the same encoded value, but with different rules for converting
to and from native Python values
c C s� | j | j j k rH t t d t | � t | � | j | j j � � � | � } | j | _ | j | _ | j | _ | j | _ | j | _ | j
| _
| j | _ t | t
� r� | j | _ | j | _ | S)a+
Converts the current object into an object of a different class. The
new class must use the ASN.1 encoding for the value.
:param other_class:
The class to instantiate the new object from
:return:
An instance of the type other_class
z�
Can not covert a value from %s object to %s object since they
use different tags: %d versus %d
)r( r1 r' r
r r6 r8 r9 r: ra r< re r& rb rd rc )r? Z other_classrL r! r! r" �castI s& z
Castable.castN)ri rj rk rl ru r! r! r! r" rt B s rt c sL e Z d Z d Z d Z d Z d d � Z d d � Z � f d d � Z � S)
rb z�
A mixin to handle string types that may be constructed from chunks
contained within an indefinite length BER-encoded container
Fr c C s� | j s | j � S| j } t | j � } d } x\ | | k r� t | j | d | j �\ } } | d k r| | j � } q4 | | j � 7} q4 W| d k r� | j � S| S)zc
:return:
A concatenation of the native values of the contained chunks
Nr$ )rc � _as_chunk�_chunks_offset�lenr< r) r1 �
_merge_chunks)r? �pointer� contents_len�outputZ sub_valuer! r! r" ry } s
!
zConstructable._merge_chunksc C s* | j d k r | j S| j | j d � S)a
A method to return a chunk of data that can be combined for
constructed method values
:return:
A native Python value that can be added together. Examples include
byte strings, unicode strings or tuples.
r N)rw r< )r? r! r! r" rv � s
zConstructable._as_chunkc s5 t t | � j | | � | j | _ | j | _ d S)a%
Copies the contents of another Constructable object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)�superrb rN rd rc )r? rW rX )r1 r! r" rN � s zConstructable._copy) ri rj rk rl rc rw ry rv rN r! r! )r1 r" rb o s rb c @ sm e Z d Z d Z d Z d d � Z d d � Z d d � Z d d
� Z e d d � � Z
d
d d � Z d S)�Voidz�
A representation of an optional value that is not present. Has .native
property and .dump() method to be compatible with other value classes.
r# c C s | j | j k S)zu
:param other:
The other Primitive to compare to
:return:
A boolean
)r1 )r? rW r! r! r" �__eq__� s z Void.__eq__c C s d S)NFr! )r? r! r! r" � __nonzero__� s zVoid.__nonzero__c C s d S)Nr r! )r? r! r! r" �__len__� s z Void.__len__c C s
t f � S)N)�iter)r? r! r! r" �__iter__� s z
Void.__iter__c C s d S)zn
The a native Python datatype representation of this value
:return:
None
Nr! )r? r! r! r" r] � s z Void.nativeFc C s d S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
r# r! )r? rf r! r! r" rI � s z Void.dumpN) ri rj rk rl r< r r� r� r� �propertyr] rI r! r! r! r" r~ � s r~ c s� e Z d Z d Z d Z d d d � Z e d d � � Z e d d � � Z d d d d
� Z � f d d � Z
d
d d � Z � S)�Anyz�
A value class that can contain any value, and allows for easy parsing of
the underlying encoded value using a spec. This is normally contained in
a Structure that has an ObjectIdentifier field and _oid_pair and _oid_specs
defined.
Nc K s� t j | | � y^ | d k rm t | t � sI t t d t | � � � � | | j d f | _ | j � | _ Wni t
t f k
r� } zC | j d d � } | j d d t | � f | | _ | � WYd d } ~ Xn Xd S)z�
Sets the value of the object before passing to Asn1Value.__init__()
:param value:
An Asn1Value object that will be set as the parsed value
Nz`
value must be an instance of Ans1Value, not %s
r r z
while constructing %s) r rC r& r' r
r r1 �_parsedrI r< r4 r> )r? r, r+ rB r> r! r! r" rC � s %z Any.__init__c C s' | j d k r | j � | j d j S)z�
The a native Python datatype representation of this value
:return:
The .native value from the parsed value object
Nr )r� �parser] )r? r! r! r" r] s
z
Any.nativec C s$ | j d k r | j � | j d S)zw
Returns the parsed object from .parse()
:return:
The object returned by .parse()
Nr )r� r� )r? r! r! r" rY $ s
z
Any.parsedc C sd | j d k s. | j d d � | | f k rYy� | } | j d k rx | sR i n | j � } | j | d <| j | d <| j | j | j } t | d | d | �\ } } | | | f | _ d | _ d | _ d | _ | | _ d | _ Wni t t
f k
rX} zC | j d d � } | j d
d t | � f | | _ | � WYd d } ~ Xn X| j d
S) av
Parses the contents generically, or using a spec with optional params
:param spec:
A class derived from Asn1Value that defines what class_ and tag the
value should have, and the semantics of the encoded value. The
return value will be of this type. If omitted, the encoded value
will be decoded using the standard universal tag based on the
encoded tag number.
:param spec_params:
A dict of params to pass to the spec object
:return:
An object of the type spec, or if not present, a child of Asn1Value
Nr r r0 r6 r( r$ r% r# r z
while parsing %s)
r� r6 rO r: ra r< re r) r( r4 r' r> r ) r? r$ r% Z
passed_paramsr< � parsed_valuer- rB r> r! r! r" r� 2 s. .
%z Any.parsec s/ t t | � j | | � | | j � | _ d S)a
Copies the contents of another Any object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r� rN r� )r? rW rX )r1 r! r" rN a s z Any._copyFc C s0 | j d k r | j � | j d j d | � S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
Nr rf )r� r� rI )r? rf r! r! r" rI p s
zAny.dump) ri rj rk rl r� rC r� r] rY r� rN rI r! r! )r1 r" r� � s /r� c s� e Z d Z d Z d Z d Z d Z d Z d Z d Z e
d d d � � Z d d � Z d d d d d � Z
e d
d � � Z d d
� Z e d d � � Z e d d � � Z d d � Z d d � Z � f d d � Z d d d � Z � S)�ChoicezF
A class to handle when a value may be one of several options
NFc K sM t | t � s% t d t | � � � t | d | d | d | �\ } } | S)a�
Loads a BER/DER-encoded byte string using the current class as the spec
:param encoded_data:
A byte string of BER or DER encoded data
:param strict:
A boolean indicating if trailing data should be forbidden - if so, a
ValueError will be raised when trailing data exists
:return:
A instance of the current class
z*encoded_data must be a byte string, not %sr$ r% r )r& r r' r r) )r* r r r+ r, r- r! r! r" r � s $z Choice.loadc C s� | j } i | _ i | _ x~ t | j � D]m \ } } t | � d k rc | i f } | | j | <t | d | d � } | | j | <| | j | d <q+ Wd S)zS
Generates _id_map from _alternatives to allow validating contents
r r r r N)r1 �_id_map� _name_map� enumerate�
_alternativesrx �_build_id_tuple)r? r* �index�info�id_r! r! r" r. � s
z
Choice._setupc
K s | | d <t j | | � yw| d k r; t t d � � � | d k r�t | t � r� t | � d k r� t t d t | � t | � � � � t | j � � d \ } } t | t
� rt | � d k r� t t d t | � t | � � � � | d } | d } | | j k r.t t d
| t | � � � � | j | | _ | j
| j \ } } } t | | � sx| | | � } n t | | � } | | _ Wni t t f k
r�} zC | j d d � } | j d d t | � f | | _ | � WYd d } ~ Xn Xd S) a�
Checks to ensure implicit tagging is not being used since it is
incompatible with Choice, then forwards on to Asn1Value.__init__()
:param name:
The name of the alternative to be set - used with value.
Alternatively this may be a dict with a single key being the name
and the value being the value, or a two-element tuple of the the
name and the value.
:param value:
The alternative value to set - used with name
:param tag_type:
The tag_type of the value - None, "implicit" or "explicit"
:raises:
ValueError - when tag_type is "implicit"
r6 r/ z�
The Choice type can not be implicitly tagged even if in an
implicit module - due to its nature any tagging must be
explicit
Nr z�
When passing a dict as the "name" argument to %s,
it must have a single key/value - however %d were
present
r r z�
When passing a tuple as the "name" argument to %s,
it must have two elements, the name and value -
however %d were present
z�
The name specified, "%s", is not a valid alternative
for %s
z
while constructing %s)r rC r4 r
r& �dictrx r �listrr �tupler� �_choicer� � _fix_taggingr� r' r> )
r? �namer, r6 r+ r- r$ �paramsrB r> r! r! r" rC � sJ
%zChoice.__init__c C s' | j s | j | j d | _ | j S)zc
:return:
A unicode string of the field name of the chosen alternative
r )�_namer� r� )r? r! r! r" r� s z Choice.namec C s� | j d k r | j SyA | j | j \ } } } t | j d | d | �\ | _ } Wni t t f k
r� } zC | j d d � } | j d d t | � f | | _ | � WYd d } ~ Xn Xd S)z}
Parses the detected alternative
:return:
An Asn1Value object of the chosen alternative
Nr$ r% r r z
while parsing %s) r� r� r� r) r< r4 r' r> r )r? r- r$ r� rB r> r! r! r" r� ' s (%z Choice.parsec C s
| j � S)zT
:return:
An Asn1Value object of the chosen alternative
)r� )r? r! r! r" rZ : s z
Choice.chosenc C s
| j j S)z�
The a native Python datatype representation of this value
:return:
The .native value from the contained value object
)rZ r] )r? r! r! r" r] C s z
Choice.nativec sy | | f } � j d k r� � j � j f | k rN t t d t � � � � � t | t | � � \ \ } } } } } } } | | f } | � j k r� � j | � _ d S� j
d k r � j d k r t � j � d k r� t t d t � � � � � | � j
� j f k r d � _ d S� j
| | � } � f d d � � j D� } t t d | t � � d
j | � � � � d S) a�
Ensures that the class and tag specified exist as an alternative
:param class_:
The integer class_ from the encoded value header
:param tag:
The integer tag from the encoded value header
:param contents:
A byte string of the contents of the value - used when the object
is explicitly tagged
:raises:
ValueError - when value is not a valid alternative
r0 z�
%s was explicitly tagged, but the value provided does not
match the class and tag
Nr z|
%s was implicitly tagged, but more than one alternative
exists
r c s* g | ] } � j | d | d � � q S)r r )�_format_class_tag)�.0�pair)r? r! r" �
<listcomp>� s z#Choice.validate.<locals>.<listcomp>zs
Value %s did not match the class and tag of any of the alternatives
in %s: %s
z, )r6 r9 r: r4 r
r r rx r� r� r8 r( r� r� �join)r? r8 r( r< r� r- Zasn1Zasn1sr! )r? r" �validateN s4 - zChoice.validatec C s d t | j � | f S)zo
:return:
A unicode string of a human-friendly representation of the class and tag
z[%s %s])r; �upper)r? r8 r( r! r! r" r� � s zChoice._format_class_tagc sG t t | � j | | � | j | _ | j | _ | | j � | _ d S)a
Copies the contents of another Choice object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r� rN r� r� r� )r? rW rX )r1 r! r" rN � s z Choice._copyc C sw | j j d | � | _ | j d k s- | ri | j d k r` t | j d | j | j � | _ n d | _ | j | j S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
rf Nr0 r r# )rZ rI r< ra r6 r r9 r: )r? rf r! r! r" rI � s $ z Choice.dump)ri rj rk rl r� r� r� r� r� r� rn r r. rC r� r� r� rZ r] r� r� rN rI r! r! )r1 r" r� � s& V
@ r� c @ s e Z d Z d Z d Z d Z e d d d � � Z d d d 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 d � Z d d d � Z e d d � � Z d d � Z d! d" � Z d# d$ � Z d% d& � Z d S)'�Concata
A class that contains two or more encoded child values concatentated
together. THIS IS NOT PART OF THE ASN.1 SPECIFICATION! This exists to handle
the x509.TrustedCertificate() class for OpenSSL certificates containing
extra information.
NFc C s | d | d | � S)a�
Loads a BER/DER-encoded byte string using the current class as the spec
:param encoded_data:
A byte string of BER or DER encoded data
:param strict:
A boolean indicating if trailing data should be forbidden - if so, a
ValueError will be raised when trailing data exists
:return:
A Concat object
r< r r! )r* r r r! r! r" r � s z Concat.loadc
C s� | d k r y� t | � } g | _ d } xW | j D]L } | | k rg t | d | d | �\ } } n | � } | j j | � q4 W| r� | | k r� | | } t d | � � Wni t t f k
r } zC | j d d � }
| j d d t | � f |
| _ | � WYd d } ~ Xn X| d k r~| j d k rQd g t | j � | _ x* t | � D] \ } } | j
| | � q^Wd S)a
:param value:
A native Python datatype to initialize the object value with
:param contents:
A byte string of the encoded contents of the value
:param strict:
A boolean indicating if trailing data should be forbidden - if so, a
ValueError will be raised when trailing data exists in contents
:raises:
ValueError - when an error occurs with one of the children
TypeError - when an error occurs with one of the children
Nr rz r$ z4Extra data - %d bytes of trailing data were providedr z
while constructing %s) rx � _children� _child_specsr) �appendr4 r' r> r r� � __setitem__)
r? r, r< r r{ �offsetr$ Z child_value� extra_bytesrB r> r� �datar! r! r" rC � s, !
% zConcat.__init__c C s t r | j � S| j � Sd S)z�
Since str is differnt in Python 2 and 3, this calls the appropriate
method, __unicode__() or __bytes__()
:return:
A unicode string
N)rD rE rF )r? r! r! r" rG s
zConcat.__str__c C s
| j � S)z;
A byte string of the DER-encoded contents
)rI )r? r! r! r" rE s zConcat.__bytes__c C s
t | � S)z7
:return:
A unicode string
)r5 )r? r! r! r" rF s zConcat.__unicode__c C s) d t | � t | � t | j � � f S)z7
:return:
A unicode string
z
<%s %s %s>)r rH r5 rI )r? r! r! r" rJ % s zConcat.__repr__c C s# | j � } | j | t j � | S)z|
Implements the copy.copy() interface
:return:
A new shallow copy of the Concat object
)r1 rN rO )r? rL r! r! r" rP - s zConcat.__copy__c C s3 | j � } | | t | � <| j | t j � | S)z�
Implements the copy.deepcopy() interface
:param memo:
A dict for memoization
:return:
A new deep copy of the Concat object and all child objects
)r1 rH rN rO rQ )r? rR rL r! r! r" rS 9 s zConcat.__deepcopy__c C s
t j | � S)zQ
Copies the object
:return:
A Concat object
)rO rQ )r? r! r! r" rO I s z Concat.copyc C sL | j | j k r6 t t d t | � t | � � � � | | j � | _ d S)a
Copies the contents of another Concat object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
zQ
Can not copy values from %s object to %s object
N)r1 r' r
r r� )r? rW rX r! r! r" rN S s z Concat._copyr c C sg d | } t d | t | � t | � f � t d | f � x" | j D] } | j | d � qH Wd S)zJ
Show the binary data and parsed data in a tree structure
z z%s%s Object #%sz
%s Children:r N)r^ r rH r� r\ )r? r_ r` �childr! r! r" r\ j s
#z Concat.debugc C s4 d } x' | j D] } | | j d | � 7} q W| S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
r# rf )r� rI )r? rf r< r� r! r! r" rI u s z Concat.dumpc C s
| j � S)z`
:return:
A byte string of the DER-encoded contents of the children
)rI )r? r! r! r" r< � s zConcat.contentsc C s
t | j � S)z.
:return:
Integer
)rx r� )r? r! r! r" r� � s zConcat.__len__c C sN | t | j � d k s% | d k rC t t d | t | � � � � | j | S)z�
Allows accessing children by index
:param key:
An integer of the child index
:raises:
KeyError - when an index is invalid
:return:
The Asn1Value object of the child specified
r r zN
No child is definition for position %d of %s
)rx r� �KeyErrorr
r r� )r? rs r! r! r" � __getitem__� s %zConcat.__getitem__c C s� | t | j � d k s% | d k rC t t d | t | � � � � t | t � sp t t d | t | � � � � | | j | <d S)aG
Allows settings children by index
:param key:
An integer of the child index
:param value:
An Asn1Value object to set the child to
:raises:
KeyError - when an index is invalid
ValueError - when the value is not an instance of Asn1Value
r r zK
No child is defined for position %d of %s
zz
Value for child %s of %s is not an instance of
asn1crypto.core.Asn1Value
N) rx r� r� r
r r& r r4 r� )r? rs r, r! r! r" r� � s %zConcat.__setitem__c C s
t | j � S)zB
:return:
An iterator of child values
)r� r� )r? r! r! r" r� � s zConcat.__iter__)ri rj rk rl r� r� rn r rC rG rE rF rJ rP rS rO rN r\ rI r� r< r� r� r� r� r! r! r! r" r� � s* -
$r� c @ sj e Z d Z d Z d Z d Z d d d d d � Z d d � Z d d d
� Z d d � Z d
d � Z
d S)� PrimitivezO
Sets the class_ and method attributes for primitive, universal values
r Nc K s� t j | | � yQ | d k r+ | | _ n5 | d k rG | j | � n | d k r` | j | � Wni t t f k
r� } zC | j d d � } | j d d t | � f | | _ | � WYd d } ~ Xn Xd S)a^
Sets the value of the object before passing to Asn1Value.__init__()
:param value:
A native Python datatype to initialize the object value with
:param default:
The default value if no value is specified
:param contents:
A byte string of the encoded contents of the value
Nr r z
while constructing %s)r rC r< r= r4 r' r> r )r? r, rA r< r+ rB r> r! r! r" rC � s %zPrimitive.__init__c C sj t | t � s3 t t d t | � t | � � � � | | _ | | _ d | _ | j d k rf d | _ d S)z_
Sets the value of the object
:param value:
A byte string
zH
%s value must be a byte string, not %s
Nr# ) r& r r' r
r rV r< ra re )r? r, r! r! r" r= s z
Primitive.setFc C s2 | r% | j } d | _ | j | � t j | � S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
N)r] r< r= r rI )r? rf r] r! r! r" rI s
zPrimitive.dumpc C s | | k S)Nr! )r? rW r! r! r" �__ne__/ s zPrimitive.__ne__c C sG t | t � s d S| j | j k r) d S| j j | j j k rE d S| j | j k rm | j | j k rm d St | j j � t | j g � Bt t t t g � } t | j j � t | j g � Bt t t t g � } | | Br� | j | j k S| j d k s| j d k r1| j
� j � | j
� j � k S| j � | j � k S)zu
:param other:
The other Primitive to compare to
:return:
A boolean
FTN) r& r� r< r1 r( r= � __bases__r ro r6 rU rI )r? rW Z
self_bases� other_basesr! r! r" r 2 s $55
"zPrimitive.__eq__) ri rj rk rl r8 rd rC r= rI r� r r! r! r! r" r� � s r� c s^ e Z d Z d Z d Z d Z d d � Z d d � Z � f d d � Z e d
d � � Z
� S) �AbstractStringz�
A base class for all strings that have a known encoding. In general, we do
not worry ourselves with confirming that the decoded values match a specific
set of characters, only that they are decoded into a Python unicode string
�latin1Nc C s� t | t � s3 t t d t | � t | � � � � | | _ | j | j � | _ d | _ | j
ru d | _
d | _ | j d k r� d | _ d S)zb
Sets the value of the string
:param value:
A unicode string
zK
%s value must be a unicode string, not %s
NFr r# )
r& r
r' r
r �_unicoderK � _encodingr< ra rc rd re )r? r, r! r! r" r= e s zAbstractString.setc C sD | j d k r d S| j d k r= | j � j | j � | _ | j S)z7
:return:
A unicode string
N� )r< r� ry �decoder� )r? r! r! r" rF s
zAbstractString.__unicode__c s) t t | � j | | � | j | _ d S)a&
Copies the contents of another AbstractString object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r� rN r� )r? rW rX )r1 r! r" rN � s zAbstractString._copyc C s | j d k r d S| j � S)z�
The a native Python datatype representation of this value
:return:
A unicode string or None
N)r< rF )r? r! r! r" r] � s zAbstractString.native) ri rj rk rl r� r� r= rF rN r� r] r! r! )r1 r" r� X s r� c @ sR e Z d Z d Z d Z d d � Z d d � Z d d � Z e d d
� � Z d S) �Booleanz7
Represents a boolean in both ASN.1 and Python
r c C sI t | � | _ | s d n d | _ d | _ | j d k rE d | _ d S)z�
Sets the value of the object
:param value:
True, False or another value that works with bool()
s s �Nr# )�boolrV r< ra re )r? r, r! r! r" r= � s
z Boolean.setc C s
| j � S)z4
:return:
True or False
)�__bool__)r? r! r! r" r� � s zBoolean.__nonzero__c C s
| j d k S)z4
:return:
True or False
s )r< )r? r! r! r" r� � s zBoolean.__bool__c C s8 | j d k r d S| j d k r1 | j � | _ | j S)z}
The a native Python datatype representation of this value
:return:
True, False or None
N)r< rV r� )r? r! r! r" r] � s
zBoolean.nativeN)
ri rj rk rl r( r= r� r� r� r] r! r! r! r" r� � s r� c @ sF e Z d Z d Z d Z d d � Z d d � Z e d d � � Z d S)
�Integerz8
Represents an integer in both ASN.1 and Python
r c C s t | t � rv | j d k r9 t t d t | � � � � | | j k rf t t d t | � | � � � | j | } n3 t | t � s� t t d t | � t | � � � � | j r� | | j k r� | j | n | | _ t
| d d �| _ d | _ | j
d k r
d | _
d S)z�
Sets the value of the object
:param value:
An integer, or a unicode string if _map is set
:raises:
ValueError - when an invalid value is passed
Nz\
%s value is a unicode string, but no _map provided
zR
%s value, %s, is not present in the _map
z�
%s value must be an integer or unicode string when a name_map
is provided, not %s
�signedTr# )r& r
rp r4 r
r rq r r' rV r r< ra re )r? r, r! r! r" r= � s* . z Integer.setc C s t | j d d �S)z1
:return:
An integer
r� T)r r< )r? r! r! r" �__int__ s zInteger.__int__c C sl | j d k r d S| j d k re | j � | _ | j d k re | j | j k re | j | j | _ | j S)z|
The a native Python datatype representation of this value
:return:
An integer or None
N)r< rV r� rp )r? r! r! r" r] s !zInteger.nativeN) ri rj rk rl r( r= r� r� r] r! r! r! r" r� � s
0 r� c @ s| e Z d Z d Z d Z d Z d Z d Z d d � Z d d � Z d d
� Z
d d � Z d
d � Z e
d d � � Z d S)� BitStringzK
Represents a bit string from ASN.1 as a Python tuple of 1s and 0s
r Nr c C sE t j | � | j } | j d k rA t | j j � � d | _ d S)z2
Generates _reverse_map from _map
Nr )ro r. r1 rp �max�keys�_size)r? r* r! r! r" r. < s
zBitString._setupc
C s� t | t � r� | j d k r9 t t d t | � � � � d g | j } | | _ xQ t d | j � D]= } | j j | � } | d k r� qe | | k re d | | <qe Wd j
t t | � � } n� | j
t k rZ| j d k r� | | _ nT t � | _ xE t | � D]7 \ } } | r| j j | | � } | j j | � qWd j
t t | � � } n$ t t d t | � t | � � � � d | _ | j d k r�t | � | j k r�t t d t | � | j t | � � � � | j d � } t | � } | d } d } | d k r$d | } | d | 7} t t j | d � � }
| rRt | � } n d
} | d k rmd } n t t | d � � } t | � |
k r�d
|
t | � | } | | | _ d | _ | j r�d
| _ d | _ | j d k r�d | _ d S)z�
Sets the value of the object
:param value:
An integer or a tuple of integers 0 and 1
:raises:
ValueError - when an invalid value is passed
NzF
%s._map has not been defined
r r r� z�
%s value must be a tuple of ones and zeros or a set of unicode
strings, not %s
zf
%s value must be at most %s bits long, specified was %s long
�0� s r# r F) r& r= rp r4 r
r r� rV �range�getr� �mapr
r1 r� r� �addr' �_chunkrx �rstrip�int�math�ceilr r< ra rc rd re )
r? r, �bitsr� rs �bitr� �sizeZsize_mod�
extra_bitsZ
size_in_bytesZextra_bits_byteZ value_bytesr! r! r" r= G st
z
BitString.setc C s� t | t � } | so t | j t � sB t t d t | � � � � | | j k ro t t d t | � | � � � | j d k r� | j | j d k r� t
| j � | d k r� t | j | � Sd S| r� | j j | | � } | | j k S)aG
Retrieves a boolean version of one of the bits based on a name from the
_map
:param key:
The unicode string of one of the bit names
:raises:
ValueError - when _map is not set or the key name is invalid
:return:
A boolean if the bit is set
zF
%s._map has not been defined
zT
%s._map does not contain an entry for "%s"
Nr F)
r& r rp r� r4 r
r rq rV r] rx r� r� )r? rs �is_intr! r! r" r� � s( zBitString.__getitem__c C sr t | t � } | sl | j d k r? t t d t | � � � � | | j k rl t t d t | � | � � � | j d k r� | j | j d k r� t | j � } t
| � d } | | k r� | j d g | | � | r� d n d | | <t | � | _ nb | r| j j
| | � } | r?| | j k r^| j j | � n | | j k r^| j j | � | j | j � d S)a
Sets one of the bits based on a name from the _map
:param key:
The unicode string of one of the bit names
:param value:
A boolean value
:raises:
ValueError - when _map is not set or the key name is invalid
NzF
%s._map has not been defined
zT
%s._map does not contain an entry for "%s"
r r )r& r rp r4 r
r rq rV r] r� rx �extendr� r� r� �remover= )r? rs r, r� Z
new_nativeZmax_keyr! r! r" r� � s8 zBitString.__setitem__c C s� t | j d d � � } d j t | j d d � � � } t | j d d � � } t | � } | d } | d k r� d d | | } t | � } | d | k r� | | d } d d | | } | d k r� | d d | � } t t t t | � � � S)zr
Allows reconstructing indefinite length values
:return:
A tuple of integers
r r z{0:b}Nr� r� )r r< �formatrx r� r� r� )r? r� �
bit_stringZbyte_lenZbit_len� mod_bit_lenZ
missing_bytesr! r! r" rv s "
zBitString._as_chunkc C s� | j d k r> | j d k r. | j f � n | j t � � | j d k r� | j � } | j r� t � | _ xQ t | � D]7 \ } } | r{ | j j | | � } | j j | � q{ Wn | | _ | j S)z�
The a native Python datatype representation of this value
:return:
If a _map is set, a set of names, or if no _map is set, a tuple of
integers 1 and 0. None if no value.
N)r< rp r= rV ry r� r� r� )r? r� r� r� r� r! r! r" r] 1 s zBitString.native)ri rj rk rl r( r� r� rw r. r= r� r� rv r� r] r! r! r! r" r� / s d / 9 r� c sd e Z d Z d Z d Z d Z d Z d d � Z d d � Z � f d d
� Z e
d d � � Z � S)
�OctetBitStringzB
Represents a bit string in ASN.1 as a Python byte string
r r Nc C s� t | t � s3 t t d t | � t | � � � � | | _ d | | _ d | _ | j rm d | _ d | _ | j
d k r� d | _
d S)z�
Sets the value of the object
:param value:
A byte string
:raises:
ValueError - when an invalid value is passed
zH
%s value must be a byte string, not %s
s NFr r# ) r& r r' r
r �_bytesr< ra rc rd re )r? r, r! r! r" r= _ s
zOctetBitString.setc C s8 | j d k r d S| j d k r1 | j � | _ | j S)z4
:return:
A byte string
Nr# )r< r� ry )r? r! r! r" rE } s
zOctetBitString.__bytes__c s) t t | � j | | � | j | _ d S)a&
Copies the contents of another OctetBitString object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r� rN r� )r? rW rX )r1 r! r" rN � s zOctetBitString._copyc C s | j d k r d S| j � S)z
The a native Python datatype representation of this value
:return:
A byte string or None
N)r< rE )r? r! r! r" r] � s zOctetBitString.native) ri rj rk rl r( rw r� r= rE rN r� r] r! r! )r1 r" r� O s r� c @ sL e Z d Z d Z d Z d Z d d � Z d d � Z e d d � � Z d
S) �IntegerBitStringz>
Represents a bit string in ASN.1 as a Python integer
r r c C s� t | t � s3 t t d t | � t | � � � � | | _ d t | d d �| _ d | _ | j ry d | _ d | _
| j d k r� d | _ d S) z�
Sets the value of the object
:param value:
An integer
:raises:
ValueError - when an invalid value is passed
zE
%s value must be an integer, not %s
s r� TNFr r# ) r& r r' r
r rV r r< ra rc rd re )r? r, r! r! r" r= � s zIntegerBitString.setc C s� t | j d d � � } d j t | j d d � � � } t | � d } | d k ri d d | | } | d k r� | d d | � S| S)u�
Allows reconstructing indefinite length values
:return:
A unicode string of bits – 1s and 0s
r r z{0:b}Nr� r� )r r< r� rx )r? r� r� r� r! r! r" rv � s " zIntegerBitString._as_chunkc C s� | j d k r d S| j d k r� t | j d d � � } | j rp | d k rp t | j d d � � | _ n9 | j r� | d k r� t d � � t | j � d � | _ | j S)z|
The a native Python datatype representation of this value
:return:
An integer or None
Nr r z=Constructed bit string has extra bits on indefinite containerr )r< rV r rc r4 r� ry )r? r� r! r! r" r] � s zIntegerBitString.nativeN)
ri rj rk rl r( rw r= rv r� r] r! r! r! r" r� � s r� c s^ e Z d Z d Z d Z d Z d d � Z d d � Z � f d d � Z e d
d � � Z
� S) � OctetStringz;
Represents a byte string in both ASN.1 and Python
� Nc C s� t | t � s3 t t d t | � t | � � � � | | _ | | _ d | _ | j ri d | _ d | _ | j
d k r� d | _
d S)z_
Sets the value of the object
:param value:
A byte string
zH
%s value must be a byte string, not %s
NFr r# ) r& r r' r
r r� r< ra rc rd re )r? r, r! r! r" r= s zOctetString.setc C s8 | j d k r d S| j d k r1 | j � | _ | j S)z4
:return:
A byte string
Nr# )r< r� ry )r? r! r! r" rE s
zOctetString.__bytes__c s) t t | � j | | � | j | _ d S)a#
Copies the contents of another OctetString object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r� rN r� )r? rW rX )r1 r! r" rN + s zOctetString._copyc C s | j d k r d S| j � S)z
The a native Python datatype representation of this value
:return:
A byte string or None
N)r< rE )r? r! r! r" r] : s zOctetString.native) ri rj rk rl r( r� r= rE rN r� r] r! r! )r1 r" r� � s r� c @ s: e Z d Z d Z d Z d d � Z e d d � � Z d S)�IntegerOctetStringz?
Represents a byte string in ASN.1 as a Python integer
r� c C s� t | t � s3 t t d t | � t | � � � � | | _ t | d d �| _ d | _ | j ru d | _ d | _
| j d k r� d | _ d S)z�
Sets the value of the object
:param value:
An integer
:raises:
ValueError - when an invalid value is passed
zE
%s value must be an integer, not %s
r� FNr r# ) r& r r' r
r rV r r< ra rc rd re )r? r, r! r! r" r= P s zIntegerOctetString.setc C s> | j d k r d S| j d k r7 t | j � � | _ | j S)z|
The a native Python datatype representation of this value
:return:
An integer or None
N)r< rV r ry )r? r! r! r" r] m s
zIntegerOctetString.nativeN)ri rj rk rl r( r= r� r] r! r! r! r" r� I s r� c s� e Z d Z d Z d Z d Z d d d d � Z d d � Z d d d d � Z d d
� Z � f d d � Z
e d
d � � Z e d d � � Z
d d d � Z � S)�ParsableOctetStringr� Nc K st d } | d k r? | d k r? t | t � r? | j � } d } t j | d | | �| rp | | j d f | _ d S)a�
Allows providing a parsed object that will be serialized to get the
byte string value
:param value:
A native Python datatype to initialize the object value with
:param parsed:
If value is None and this is an Asn1Value object, this will be
set as the parsed value, and the value will be obtained by calling
.dump() on this object.
FNTr, )r& r rI r� rC r1 r� )r? r, rY r+ Z
set_parsedr! r! r" rC � s ' z ParsableOctetString.__init__c C s� t | t � s3 t t d t | � t | � � � � | | _ | | _ d | _ | j ri d | _ d | _ | j
d k r� d | _
d S)z_
Sets the value of the object
:param value:
A byte string
zH
%s value must be a byte string, not %s
NFr r# ) r& r r' r
r r� r< ra rc rd re )r? r, r! r! r" r= � s zParsableOctetString.setc C so | j d k s. | j d d � | | f k rd t | j � d | d | �\ } } | | | f | _ | j d S)av
Parses the contents generically, or using a spec with optional params
:param spec:
A class derived from Asn1Value that defines what class_ and tag the
value should have, and the semantics of the encoded value. The
return value will be of this type. If omitted, the encoded value
will be decoded using the standard universal tag based on the
encoded tag number.
:param spec_params:
A dict of params to pass to the spec object
:return:
An object of the type spec, or if not present, a child of Asn1Value
Nr r r$ r% r )r� r) rE )r? r$ r% r� r- r! r! r" r� � s .$zParsableOctetString.parsec C s8 | j d k r d S| j d k r1 | j � | _ | j S)z4
:return:
A byte string
Nr# )r< r� ry )r? r! r! r" rE � s
z ParsableOctetString.__bytes__c s; t t | � j | | � | j | _ | | j � | _ d S)a+
Copies the contents of another ParsableOctetString object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r� rN r� r� )r? rW rX )r1 r! r" rN � s zParsableOctetString._copyc C s> | j d k r d S| j d k r0 | j d j S| j � Sd S)z
The a native Python datatype representation of this value
:return:
A byte string or None
Nr )r< r� r] rE )r? r! r! r" r] � s
zParsableOctetString.nativec C s$ | j d k r | j � | j d S)zw
Returns the parsed object from .parse()
:return:
The object returned by .parse()
Nr )r� r� )r? r! r! r" rY � s
zParsableOctetString.parsedFc C sY | rL | j d k r- | j j d | � } n | j } d | _ | j | � t j | � S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
Nrf )r� rY rI r] r< r= r )r? rf r] r! r! r" rI
s
zParsableOctetString.dump)ri rj rk r( r� r� rC r= r� rE rN r� r] rY rI r! r! )r1 r" r� ~ s r� c @ s( e Z d Z d Z d Z d d � Z d S)�ParsableOctetBitStringr r c C s� t | t � s3 t t d t | � t | � � � � | | _ d | | _ d | _ | j rm d | _ d | _ | j
d k r� d | _
d S)z�
Sets the value of the object
:param value:
A byte string
:raises:
ValueError - when an invalid value is passed
zH
%s value must be a byte string, not %s
s NFr r# ) r& r r' r
r r� r< ra rc rd re )r? r, r! r! r" r= ,
s
zParsableOctetBitString.setN)ri rj rk r( rw r= r! r! r! r" r� "
s r� c @ s@ e Z d Z d Z d Z d Z d d � Z e d d � � Z d S) �Nullz<
Represents a null value in ASN.1 as None in Python
� r# c C s
d | _ d S)zV
Sets the value of the object
:param value:
None
r# N)r< )r? r, r! r! r" r= T
s zNull.setc C s d S)zn
The a native Python datatype representation of this value
:return:
None
Nr! )r? r! r! r" r] ^
s z Null.nativeN) ri rj rk rl r( r< r= r� r] r! r! r! r" r� K
s
r� c @ s� e Z d Z d Z d Z d Z e d d � � Z e d d � � Z d d � Z d
d � Z
e d d
� � Z e d d � � Z
d S)�ObjectIdentifierz`
Represents an object identifier in ASN.1 as a Python unicode dotted
integer string
� Nc C sg | j d k r* t t d t | � � � � t | t � sT t t d t | � � � � | j j | | � S)a^
Converts a dotted unicode string OID into a mapped unicode string
:param value:
A dotted unicode string OID
:raises:
ValueError - when no _map dict has been defined on the class
TypeError - when value is not a unicode string
:return:
A mapped unicode string
Nz>
%s._map has not been defined
zH
value must be a unicode string, not %s
)rp r4 r
r r& r
r' r� )r* r, r! r! r" r� u
s zObjectIdentifier.mapc C s� | t k r# | � j � d t | <| j d k rM t t d t | � � � � t | t � sw t t d t | � � � � | | j k r� | j | St
j | � s� t t d t | � | � � � | S)a�
Converts a mapped unicode string value into a dotted unicode string OID
:param value:
A mapped unicode string OR dotted unicode string OID
:raises:
ValueError - when no _map dict has been defined on the class or the value can't be unmapped
TypeError - when value is not a unicode string
:return:
A dotted unicode string OID
TNz>
%s._map has not been defined
zH
value must be a unicode string, not %s
zL
%s._map does not contain an entry for "%s"
) r2 r. rp r4 r
r r& r
r' rq �_OID_RE�match)r* r, r! r! r" �unmap�
s&
zObjectIdentifier.unmapc C s] t | t � s3 t t d t | � t | � � � � | | _ | j d k rg | | j k rg | j | } d | _ d } x� t | j
d � � D]� \ } } t | � } | d k r� | } q� n | d k r� | d | } t d | @� } | d ?} x2 | d k r$t d
d | @B� | } | d ?} q� W| j | 7_ q� Wd | _
| j d k rYd | _ d S) a
Sets the value of the object
:param value:
A unicode string. May be a dotted integer string, or if _map is
provided, one of the mapped values.
:raises:
ValueError - when an invalid value is passed
zK
%s value must be a unicode string, not %s
Nr# �.r r �( � � � )r& r
r' r
r rV rp rq r< r� �splitr� r ra re )r? r, �firstr� �partZ encoded_partr! r! r" r= �
s6
"
zObjectIdentifier.setc C s | j S)z7
:return:
A unicode string
)�dotted)r? r! r! r" rF �
s z ObjectIdentifier.__unicode__c C s� | j d k r� g } d } x� | j D]� } t r= t | � } | d } | | d @7} | d @d k r% t | � d k r� | j t | d � � | j t | d � � n | j t | � � d } q% Wd j | � | _ | j S)z�
:return:
A unicode string of the object identifier in dotted notation, thus
ignoring any mapped value
Nr r� r� r� r� )�_dottedr< rD �ordrx r� r
r� )r? r| r� Zbyter! r! r" r� s
zObjectIdentifier.dottedc C si | j d k r d S| j d k rb | j | _ | j d k rb | j | j k rb | j | j | _ | j S)aE
The a native Python datatype representation of this value
:return:
A unicode string or None. If _map is not defined, the unicode string
is a string of dotted integers. If _map is defined and the dotted
string is present in the _map, the mapped value is returned.
N)r< rV r� rp )r? r! r! r" r] s !zObjectIdentifier.native)ri rj rk rl r( r� rn r� r� r= rF r� r� r] r! r! r! r" r� j
s "2 2 r� c @ s e Z d Z d Z d Z d S)�ObjectDescriptorzO
Represents an object descriptor from ASN.1 - no Python implementation
r� N)ri rj rk rl r( r! r! r! r" r� 5 s r� c @ s e Z d Z d Z d Z d S)�
InstanceOfzF
Represents an instance from ASN.1 - no Python implementation
r� N)ri rj rk rl r( r! r! r! r" r� = s r� c @ s e Z d Z d Z d Z d S)�RealzH
Represents a real number from ASN.1 - no Python implementation
� N)ri rj rk rl r( r! r! r! r" r� E s r� c @ s: e Z d Z d Z d Z d d � Z e d d � � Z d S)�
Enumeratedz\
Represents a enumerated list of integers from ASN.1 as a Python
unicode string
�
c C s� t | t � rD t | t � rD t t d t | � t | � � � � t | t � r� | | j k r� t t d t | � | � � � | j | } n- | | j k r� t t d t | � | � � � t j
| | � d S)z�
Sets the value of the object
:param value:
An integer or a unicode string from _map
:raises:
ValueError - when an invalid value is passed
zY
%s value must be an integer or a unicode string, not %s
zL
%s value "%s" is not a valid value
zB
%s value %s is not a valid value
N) r& r r
r' r
r rq r4 rp r� r= )r? r, r! r! r" r= U s$ zEnumerated.setc C s? | j d k r d S| j d k r8 | j | j � | _ | j S)z�
The a native Python datatype representation of this value
:return:
A unicode string or None
N)r< rV rp r� )r? r! r! r" r] � s
zEnumerated.nativeN)ri rj rk rl r( r= r� r] r! r! r! r" r� M s +r� c @ s" e Z d Z d Z d Z d Z d S)�
UTF8StringzI
Represents a UTF-8 string from ASN.1 as a Python unicode string
� zutf-8N)ri rj rk rl r( r� r! r! r! r" r� � s r� c @ s e Z d Z d Z d Z d S)� RelativeOidz`
Represents an object identifier in ASN.1 as a Python unicode dotted
integer string
�
N)ri rj rk rl r( r! r! r! r" r� � s r� c s� e Z d Z d Z d Z d Z d Z d Z d Z d Z g Z
d Z d Z d Z
d Z d Z d Z d Z d d d d � Z e d d
� � Z e j 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 d � Z d d � Z d d � Z d d! � Z d d" d# � Z! d$ d% � Z" e d& d' � � Z# � f d( d) � Z$ d d* d+ � Z% d d, d- � Z& � S).�Sequencezf
Represents a sequence of fields from ASN.1 as a Python object with a
dict-like interface
� r r NFc K s t j | | � d } | d k rk | d k rk d } | j d k re | j d k r[ d } n
| j � | } | d k ry$| j r� d d � | j D� } t | j � � } n | j � } t | � } x� | D]� } | r*| j | } | t | j � k r*| j | t
k r*| | k r� | j | � q� | | k r� | j | | | � | j | � q� Wt | � r�t
t d t | � d j t t | � � � � � � Wni t
t f k
r} zC | j d d � }
| j d d
t | � f |
| _ | � WYd d } ~ Xn Xd S) a"
Allows setting field values before passing everything else along to
Asn1Value.__init__()
:param value:
A native Python datatype to initialize the object value with
:param default:
The default value if no value is specified
FNTc S s g | ] } | d � q S)r r! )r� r� r! r! r" r� � s z%Sequence.__init__.<locals>.<listcomp>z�
One or more unknown fields was passed to the constructor
of %s: %s
z, r r z
while constructing %s)r rC �childrenr< �_parse_children�_fieldsr= r� �
_field_maprx �VOIDr� r� r4 r
r r� �sortedr� r' r> ) r? r, rA r+ Zcheck_existingr� Z unused_keysrs r� rB r> r! r! r" rC � sF
(
%%zSequence.__init__c C s3 | j d k r | j S| j � r, | j � | j S)z`
:return:
A byte string of the DER-encoded contents of the sequence
N)r� � _contents� _is_mutated�
_set_contents)r? r! r! r" r< s
zSequence.contentsc C s
| | _ d S)ze
:param value:
A byte string of the DER-encoded contents of the sequence
N)r )r? r, r! r! r" r< , s c C s` | j } | j d k r\ xA | j D]6 } t | t � sF t | t � r" | pU | j � } q" W| S)z~
:return:
A boolean - if the sequence or any children (recursively) have been
mutated
N)�_mutatedr� r& r� �
SequenceOfr )r? �mutatedr� r! r! r" r 5 s zSequence._is_mutatedc C s7 | j | } | j t k r3 t | � } | j | <| S)z]
Builds a child object if the child has only been parsed into a tuple so far
)r� r1 r� �_build)r? r� r� r! r! r" � _lazy_childD s
zSequence._lazy_childc C s& | j d k r | j � t | j � S)z.
:return:
Integer
N)r� r� rx )r? r! r! r" r� N s
zSequence.__len__c C s | j d k r | j � t | t � sb | | j k rU t t d | t | � � � � | j | } | t | j � k r� t t d | t | � � � � y | j | � SWni t
t f k
r} zC | j d d � } | j d d t | � f | | _ | � WYd d } ~ Xn Xd S)a9
Allows accessing fields by name or index
:param key:
A unicode string of the field name, or an integer of the field index
:raises:
KeyError - when a field name or index is invalid
:return:
The Asn1Value object of the field specified
NzL
No field named "%s" defined for %s
zL
No field numbered %s is present in this %s
r r z
while parsing %s)
r� r� r& r r� r� r
r rx r r4 r' r> )r? rs rB r> r! r! r" r� Y s(
%zSequence.__getitem__c
C sd | j d k r | j � t | t � sb | | j k rU t t d | t | � � � � | j | } | j | � \ } } } } } | j | | | | | � } d } t | t
� r� | j d k } n3 t | t � r� | j
j d k } n | j d k } | rt t d | t | � � � � | | j | <| j d k rW| j | j | j | j | d <d | _ d S)a�
Allows settings fields by name or index
:param key:
A unicode string of the field name, or an integer of the field index
:param value:
A native Python datatype to set the field value to. This method will
construct the appropriate Asn1Value object from _fields.
:raises:
ValueError - when a field name or index is invalid
NzL
No field named "%s" defined for %s
FzG
Value for field "%s" of %s is not set
r T)r� r� r& r r� r� r
r �_determine_spec� _make_valuer� rY r� rZ r< r4 rV r] r� r )
r? rs r, �
field_name�
field_spec�
value_spec� field_paramsr- � new_valueZ
invalid_valuer! r! r" r� � s4
"zSequence.__setitem__c C s
| j d k r | j � t | t � sb | | j k rU t t d | t | � � � � | j | } | j | \ } } } | s� d | k r� d | k r� t t d | t | � � � � d | k r� t
| j | <| j d k r� d | j | <n | j | d � d | _
d S)a/
Allows deleting optional or default fields by name or index
:param key:
A unicode string of the field name, or an integer of the field index
:raises:
ValueError - when a field name or index is invalid, or the field is not optional or defaulted
NzL
No field named "%s" defined for %s
rA r@ z�
Can not delete the value for the field "%s" of %s since it is
not optional or defaulted
T)r� r� r& r r� r� r
r r� r4 r� rV r� r )r? rs r� r- r� r! r! r" � __delitem__� s*
zSequence.__delitem__c c s! x | j D] } | d Vq
Wd S)zE
:return:
An iterator of field key names
r N)r� )r? r� r! r! r" r� � s zSequence.__iter__c C sJ | j d k r | j � t � } x� t | j � D]� \ } } | j | } | d k r` d } nb | j t k r� | r� | j | � j d | � } q� | d | d | d } n | j d | � } | d rd | d k r| d | d � } | j � | k rq2 | j | � q2 W| j
� | _ d | _ | j
d k rFd | _
d S)
a
Updates the .contents attribute of the value with the encoded value of
all of the child objects
:param force:
Ensure all contents are in DER format instead of possibly using
cached BER-encoded data
Nr# rf r r� r� r rA r )r� r� r r� r� r1 r� r rI �write�getvaluer ra re )r? rf r< r� r� r� Z
child_dumpZ
default_valuer! r! r" r � s*
zSequence._set_contentsc C s� | j } i | _ g | _ g | _ x{ t | j � D]j \ } } t | � d k rl | i f } | | j | <| | j | d <| j j t | d | d � � q4 W| j d k r� | j | j d | j | j d f | _
x� t | j � D]� \ } } | j d k o| d | j k } | j
d k o9| j
d | k } | sH| r[| j j d � q� | j j | d | d | d | d d f � q� Wd S)zS
Generates _field_map, _field_ids and _oid_nums for use in parsing
r r r r N) r1 r� �
_field_ids�_precomputed_specsr� r� rx r� r� � _oid_pair� _oid_nums�_spec_callbacks)r? r* r� �field� has_callback�
is_mapped_oidr! r! r" r.
s$
%+ "" zSequence._setupc C sA | j | \ } } } | } d } | j d k r� | | j k r� | j | } | | � } | r.| j t k r� t | � d k r� | \ } } | d k r� | } d } q.| d k r� | } | } d } q.| } n] | j d k r.| j d | k r.| j | j d � j } | | j k r.| j | } | } | | | | | f S)a
Determine how a value for a field should be constructed
:param index:
The field number
:return:
A tuple containing the following elements:
- unicode string of the field name
- Ans1Value class of the field spec
- Asn1Value class of the value spec
- None or dict of params to pass to the field spec
- None or Asn1Value class indicating the value spec was derived fomr an OID or a spec callback
Nr r r ) r� r r1 r� rx r r r] �
_oid_specs) r? r� r� r r r
�
spec_override�callbackZoidr! r! r" r 6
s.
! "
zSequence._determine_specc
C s� | d k r d | k r t S| | k } t | t � } t | t � r� t | t � ss t t d | t | � � � � t | | � s� | � } | j | j
| j | j � | | _
| } q�| } n� t | | � r� | } | r�| j | � n� | s� | r t | | � r | | | � } nd t | | � r4| } n | | � } | r�| r�| d | j � | � } | | j d f | _
| } t | | � } | S)a&
Contructs an appropriate Asn1Value object for a field
:param field_name:
A unicode string of the field name
:param field_spec:
An Asn1Value class that is the field spec
:param value_spec:
An Asn1Value class that is the vaue spec
:param field_params:
None or a dict of params for the field spec
:param value:
The value to construct an Asn1Value object from
:return:
An instance of a child class of Asn1Value
Nr@ u�
Can not set a native python value to %s, which has the
choice type of %s – value must be an instance of Asn1Value
r, )r� �
issubclassr� r� r& r r4 r
r r� r8 r( r< r� r� rI r1 r� )
r? r r r
r r, Zspecs_differentZis_any�wrapperr r! r! r" r
e
s>
zSequence._make_valuec C sn | j } | j d k r� | j r� t g t | j � | _ x� t | j � D]� \ } \ } } } d | k rJ | j | r� | j | \ } } } } } n | j | � \ } } } } } | j | | | | d � | j | <qJ Wd Sy g | _ t | j � }
d } d } t | j � }
d } | |
k } x8| ra| d k rZt
| j |
d | �\ } } | |
k } | |
k r�| j | p�| j | � \ } } } } } | r�d | k s�d | k r�| j | | d | d f k r�| t k r�d } t
| t � rGy5 | | � } | j | d | d | d � d } Wn t k
rFYn X| s�d | k rl| j j t � n | j j | | � � | d
7} d } q*| d k s�| r�t
| t � r�| } d } | r�| | | | f } q| | | f } n|
d k r| d
|
k rg } | d
} xk | d k r�| j | } t | � d k rLPd | d k sld | d k r}| j | d � | d
8} q Wt | � d
k r�d n d
} d j | � } t t d | d
t j | d � t j | d
� | d | | � � � n | } | r>t | � } t | t t f � r>| j d d � | j j | � | d
7} d } q*Wt | j � } x� | |
k r�| j | \ } } } d | k r�| j j | | � � n4 d | k r�| j j t � n t t d | � � � | d
7} qtWWni t t f k
ri} zC | j d
d � } | j d d t | � f | | _ | � WYd d } ~ Xn Xd S)aQ
Parses the contents and generates Asn1Value objects based on the
definitions from _fields.
:param recurse:
If child objects that are Sequence or SequenceOf objects should
be recursively parsed
:raises:
ValueError - when an error occurs parsing child objects
NrA r rz r@ r Fr� Tr r �sr� z, z�
Data for field %s (%s class, %s method, tag %s) does
not match the field definition%s of %s
�recursezV
Field "%s" is missing from structure
z
while parsing %s) r1 r r� r� rx r� r� r r r
r r r� r r� r� r4 r� r� r
r; r� �METHOD_NUM_TO_NAME_MAPr r& r� r r� r' r> r ) r? r! r* r� r- r� r r r
r �contents_length�
child_pointerr Z field_len�partsZagainr Z choice_match�testerr� Z
missed_fieldsZ
prev_fieldZprev_field_info�pluralZmissed_field_namesr� rB r> r! r! r" r� �
s�
%
& + -
!
%zSequence._parse_childrenc C s� t | t � s* t t d t | � � � � | j d k r] t t d t | � t | � � � � | j | } | j | � } | d S)a
Determines the spec to use for the field specified. Depending on how
the spec is determined (_oid_pair or _spec_callbacks), it may be
necessary to set preceeding field values before calling this. Usually
specs, if dynamic, are controlled by a preceeding ObjectIdentifier
field.
:param field_name:
A unicode string of the field name to get the spec for
:return:
A child class of asn1crypto.core.Asn1Value that the field must be
encoded using
zM
field_name must be a unicode string, not %s
Nz�
Unable to retrieve spec for field %s in the class %s because
_fields has not been set
r )
r& r
r' r
r r� r4 r5 r� r )r? r r� r� r! r! r" r$ 5 s
z
Sequence.specc C sR | j d k r d S| j d k rK| j d k rA | j d d � y� t � | _ x� t | j � D]z \ } } | j t k r� t | � } | | j | <y | j | d } Wn t
k
r� t | � } Yn X| j | j | <q` WWni t
t f k
rJ} zC | j d d � } | j d d t | � f | | _ | � WYd d } ~ Xn X| j S)z�
The a native Python datatype representation of this value
:return:
An OrderedDict or None. If an OrderedDict, all child values are
recursively converted to native representation also.
Nr! Tr r z
while parsing %s)r< rV r� r� r r� r1 r� r r� �
IndexErrorr
r] r4 r' r> r )r? r� r� r� rB r> r! r! r" r] \ s*
%zSequence.nativec s� t t | � j | | � | j d k r} g | _ xI | j D]> } | j t k rc | j j | � q; | j j | j � � q; Wd S)a
Copies the contents of another Sequence object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r� rN r� r1 r� r� rO )r? rW rX r� )r1 r! r" rN } s zSequence._copyc C s� | j d k r | j � d | } t | | � xU | D]M } | j | j | � } | t k r7 t d | | f � | j | d � q7 Wd S)zJ
Show the binary data and parsed data in a tree structure
Nz z%s Field "%s"r )r� r� r[ r r� r� r^ r\ )r? r_ r` r r� r! r! r" r\ � s
zSequence.debugc C s# | r | j d | � t j | � S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
rf )r r rI )r? rf r! r! r" rI � s z
Sequence.dump)'ri rj rk rl r( r8 rd r� r r r� r r� r r r r r rC r� r< �setterr r r� r� r� r r� r r. r r
r� r$ r] rN r\ rI r! r! )r1 r" r� � sF A
. 9 - % / I� '!r� c sc e Z d Z d Z d Z d Z d Z d Z d Z d Z d Z
d d d d d d � Z e d d
� � Z
e
j 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 d d d! � Z d d" d# � Z d$ d% � Z e d& d' � � Z � f d( d) � Z d d* d+ � Z d d, d- � Z � S).r z�
Represents a sequence (ordered) of a single type of values from ASN.1 as a
Python object with a list-like interface
r� r r NFc
K s | r | | _ t j | | � y� | d k r: | | _ np | d k rX | d k rX | } | d k r� x* t | � D] \ } } | j | | � qq W| j d k r� | j � Wni t t f k
r} zC | j d d � } | j d d t
| � f | | _ | � WYd d } ~ Xn Xd S)a
Allows setting child objects and the _child_spec via the spec parameter
before passing everything else along to Asn1Value.__init__()
:param value:
A native Python datatype to initialize the object value with
:param default:
The default value if no value is specified
:param contents:
A byte string of the encoded contents of the value
:param spec:
A class derived from Asn1Value to use to parse children
Nr r z
while constructing %s) � _child_specr rC r< r� r� r r4 r' r> r )
r? r, rA r< r$ r+ r� r� rB r> r! r! r" rC � s" %zSequenceOf.__init__c C s3 | j d k r | j S| j � r, | j � | j S)z`
:return:
A byte string of the DER-encoded contents of the sequence
N)r� r r r )r? r! r! r" r< � s
zSequenceOf.contentsc C s
| | _ d S)ze
:param value:
A byte string of the DER-encoded contents of the sequence
N)r )r? r, r! r! r" r< s c C s` | j } | j d k r\ xA | j D]6 } t | t � sF t | t � r" | pU | j � } q" W| S)z~
:return:
A boolean - if the sequence or any children (recursively) have been
mutated
N)r r� r& r� r r )r? r r� r! r! r" r s zSequenceOf._is_mutatedc C s9 | j | } | j t k r5 t | � } | | j | <| S)z]
Builds a child object if the child has only been parsed into a tuple so far
)r� r1 r� r )r? r� r� r! r! r" r s
zSequenceOf._lazy_childc C sr t | | j � r | } n� t | j t � rc t | t � rE | } q
t t d t | � � � � n� t | j t � r� t | t � s� t t d t | � | j j � � � t | | j � s� | j � } | j
| j | j | j
� | | _ | } | } n | j d | � Si } | j j d k re| j j | d <| d d k rU| j j | d <n | j j | d <t | | � S)a
Constructs a _child_spec value from a native Python data type, or
an appropriate Asn1Value object
:param value:
A native Python value, or some child of Asn1Value
:return:
An object of type _child_spec
u�
Can not set a native python value to %s where the
_child_spec is Any – value must be an instance of Asn1Value
u�
Can not set a native python value to %s where the
_child_spec is the choice type %s – value must be an
instance of Asn1Value
r, Nr6 r0 r( )r& r* r r� r r4 r
r r� ri r� r8 r( r< r� r6 r: r� )r? r, r r r� r! r! r" r
) s8 zSequenceOf._make_valuec C s& | j d k r | j � t | j � S)z1
:return:
An integer
N)r� r� rx )r? r! r! r" r� c s
zSequenceOf.__len__c C s& | j d k r | j � | j | � S)zm
Allows accessing children via index
:param key:
Integer index of child
N)r� r� r )r? rs r! r! r" r� n s
zSequenceOf.__getitem__c C s� | j d k r | j � | j | � } | t | j � k rl | j j d � | j d k rl | j j d � | | j | <| j d k r� | j | j | j | <d | _ d S)z�
Allows overriding a child via index
:param key:
Integer index of child
:param value:
Native python datatype that will be passed to _child_spec to create
new child object
NT)r� r� r
rx r� rV r] r )r? rs r, r r! r! r" r� | s
zSequenceOf.__setitem__c C sU | j d k r | j � | j j | � | j d k rH | j j | � d | _ d S)zk
Allows removing a child via index
:param key:
Integer index of child
NT)r� r� �poprV r )r? rs r! r! r" r � s
zSequenceOf.__delitem__c c sN | j d k r | j � x. t d t | j � � D] } | j | � Vq2 Wd S)zA
:return:
An iter() of child objects
Nr )r� r� r� rx r )r? r� r! r! r" r� � s
zSequenceOf.__iter__c C s� | d k s | t k r d St | | j � s^ t t d t | � t | j � t | � � � � x | D] } | | k re d Sqe Wd S)z�
:param item:
An object of the type cls._child_spec
:return:
A boolean if the item is contained in this SequenceOf
NFzy
Checking membership in %s is only available for instances of
%s, not %s
T)r� r& r* r' r
r )r? �itemr� r! r! r" � __contains__� s
zSequenceOf.__contains__c C sh | j d k r | j � | j j | j | � � | j d k r[ | j j | j d j � d | _ d S)z�
Allows adding a child to the end of the sequence
:param value:
Native python datatype that will be passed to _child_spec to create
new child object
Nr T���)r� r� r� r
rV r] r )r? r, r! r! r" r� � s
zSequenceOf.appendc C s� | j d k r | j � t � } x' | D] } | j | j d | � � q) W| j � | _ d | _ | j d k r| d | _ d S)z�
Encodes all child objects into the contents for this object
:param force:
Ensure all contents are in DER format instead of possibly using
cached BER-encoded data
Nrf r# ) r� r� r r rI r r ra re )r? rf r< r� r! r! r" r � s
zSequenceOf._set_contentsc C s? y� g | _ | j d k r d St | j � } d } x� | | k r� t | j | d | �\ } } | j r} | | j f } n | } | r� t | � } t | t t f � r� | j d d � | j j
| � q7 WWni t t f k
r:} zC | j
d d � } | j
d d t | � f | | _
| � WYd d } ~ Xn Xd S)aU
Parses the contents and generates Asn1Value objects based on the
definitions from _child_spec.
:param recurse:
If child objects that are Sequence or SequenceOf objects should
be recursively parsed
:raises:
ValueError - when an error occurs parsing child objects
Nr rz r! Tr z
while parsing %s)r� r rx r r* r r& r� r r� r� r4 r' r> r )r? r! r# r$ r% r� rB r> r! r! r" r� � s(
%zSequenceOf._parse_childrenc C s | j S)z�
Determines the spec to use for child values.
:return:
A child class of asn1crypto.core.Asn1Value that child values must be
encoded using
)r* )r? r! r! r" r$ " s zSequenceOf.specc C s� | j d k r d S| j d k r� | j d k rA | j d d � y d d � | D� | _ Wni t t f k
r� } zC | j d d � } | j d d t | � f | | _ | � WYd d } ~ Xn X| j S) z�
The a native Python datatype representation of this value
:return:
A list or None. If a list, all child values are recursively
converted to native representation also.
Nr! Tc S s g | ] } | j � q Sr! )r] )r� r� r! r! r" r� > s z%SequenceOf.native.<locals>.<listcomp>r r z
while parsing %s)r< rV r� r� r4 r' r> r )r? rB r> r! r! r" r] - s
%zSequenceOf.nativec s� t t | � j | | � | j d k r} g | _ xI | j D]> } | j t k rc | j j | � q; | j j | j � � q; Wd S)a"
Copies the contents of another SequenceOf object to itself
:param object:
Another instance of the same class
:param copy_func:
An reference of copy.copy() or copy.deepcopy() to use when copying
lists, dicts and objects
N)r} r rN r� r1 r� r� rO )r? rW rX r� )r1 r! r" rN E s zSequenceOf._copyc C sV | j d k r | j � d | } t | | � x | D] } | j | d � q7 Wd S)zJ
Show the binary data and parsed data in a tree structure
Nz r )r� r� r[ r\ )r? r_ r` r� r! r! r" r\ Z s
zSequenceOf.debugc C s# | r | j d | � t j | � S)a
Encodes the value using DER
:param force:
If the encoded contents already exist, clear them and regenerate
to ensure they are in DER format instead of BER format
:return:
A byte string of the DER-encoded value
rf )r r rI )r? rf r! r! r" rI g s zSequenceOf.dump) ri rj rk rl r( r8 rd r� r r r* rC r� r< r) r r r
r� r� r� r r� r- r� r r� r$ r] rN r\ rI r! r! )r1 r" r � s8 + :
#
r c @ sX e Z d Z d Z d Z d Z d Z d Z d d � Z d d d
� Z d d d � Z
d S)
�Setzm
Represents a set of fields (unordered) from ASN.1 as a Python object with a
dict-like interface
r r � Nc C s� | j } i | _ i | _ g | _ xx t | j � D]g \ } } t | � d k rl | i f } | | j | <| | j | d <| | j t | d | d � <q4 W| j d k r� | j | j d | j | j d f | _ x� t | j � D]� \ } } | j
d k o| d | j
k } | j d k o6| j d | k } | sE| rX| j j d � q� | j j | d | d | d | d d f � q� Wd S)zS
Generates _field_map, _field_ids and _oid_nums for use in parsing
r r r r N) r1 r� r r r� r� rx r� r r r r� )r? r* r� r r r r! r! r" r. � s$
"+ "" z
Set._setupFc C s8 | j } | j d k r� | j r� t g t | j � | _ x� t | j � D]� \ } \ } } } d | k rJ | j | r� | j | \ } } } } } n | j | � \ } } } } } | j | | | | d � | j | <qJ Wd Sy�i }
t | j
� } d } d }
xk| | k rpt | j
| d | �\ } } | d | d f } | j j
| � } | d k r�t t d |
t j
| d � t j
| d � | d � � � | j | p�| j | � \ } } } } } | d k s�| r�t | t � r�| } d } | r| | | | f } n | | | f } | rYt | � } t | t t f � rY| j d d � | |
| <|
d 7}
qWt | j � } x
t d | � D]� } | |
k r�q�| j | p�| j | � \ } } } } } | d k s�| r�t | t � r�| } d } d
} | sd } nV d | k r3d | k r3d } n5 d | k rLt |
| <n d | k rh| | � |
| <| r�t t d | t | � � � � q�Wg | _ x+ t d | � D] } | j j |
| � q�WWni t t f k
r3} zC | j d d � } | j d d
t | � f | | _ | � WYd d } ~ Xn Xd S)aQ
Parses the contents and generates Asn1Value objects based on the
definitions from _fields.
:param recurse:
If child objects that are Sequence or SequenceOf objects should
be recursively parsed
:raises:
ValueError - when an error occurs parsing child objects
NrA r rz r z�
Data for field %s (%s class, %s method, tag %s) does
not match any of the field definitions
r r! TFr@ zU
Missing required field "%s" from %s
z
while parsing %s) r1 r r� r� rx r� r� r r r
r< r r r� r4 r
r; r" r r� r r& r� r r� r� r r� r' r> )r? r! r* r� r- r� r r r
r Z child_mapr# r$ Z
seen_fieldr% r� r r r� Z total_fieldsr� �missingrB r> r! r! r" r� � s�
%
& +!
+!
%zSet._parse_childrenc C s� | j d k r | j � g } x� t | j � D]q \ } } | j d | � } | j | \ } } } d | k r� | | � j � | k r� q/ | j | j | f � q/ W| j d d d � � d j d d � | D� � | _ d | _
| j d k r� d | _ d S)
ac
Encodes all child objects into the contents for this object.
This method is overridden because a Set needs to be encoded by
removing defaulted fields and then sorting the fields by tag.
:param force:
Ensure all contents are in DER format instead of possibly using
cached BER-encoded data
Nrf rA rs c S s | d S)Nr r! )�ctr! r! r" �<lambda>+ s z#Set._set_contents.<locals>.<lambda>r# c S s g | ] } | d � q S)r r! )r� r2 r! r! r" r� - s z%Set._set_contents.<locals>.<listcomp>) r� r� r� rI r� r� r( �sortr� r ra re ) r? rf Zchild_tag_encodingsr� r� Zchild_encodingr� r$ r r! r! r" r s
zSet._set_contents) ri rj rk rl rd r8 r( r r. r� r r! r! r! r" r/ y s or/ c @ s+ e Z d Z d Z d Z d d d � Z d S)�SetOfz~
Represents a set (unordered) of a single type of values from ASN.1 as a
Python object with a list-like interface
r0 Fc C s� | j d k r | j � g } x' | D] } | j | j d | � � q& Wd j t | � � | _ d | _ | j d k r� d | _ d S)aD
Encodes all child objects into the contents for this object.
This method is overridden because a SetOf needs to be encoded by
sorting the child encodings.
:param force:
Ensure all contents are in DER format instead of possibly using
cached BER-encoded data
Nrf r# ) r� r� r� rI r� r r ra re )r? rf Zchild_encodingsr� r! r! r" r ; s
zSetOf._set_contentsN)ri rj rk rl r( r r! r! r! r" r5 3 s r5 c @ s e Z d Z d Z d Z d S)� EmbeddedPdvz
A sequence structure
� N)ri rj rk rl r( r! r! r! r" r6 T s r6 c @ s" e Z d Z d Z d Z d Z d S)�
NumericStringzK
Represents a numeric string from ASN.1 as a Python unicode string
� r� N)ri rj rk rl r( r� r! r! r! r" r8 \ s r8 c @ s" e Z d Z d Z d Z d Z d S)�PrintableStringzM
Represents a printable string from ASN.1 as a Python unicode string
� r� N)ri rj rk rl r( r� r! r! r! r" r: e s r: c @ s" e Z d Z d Z d Z d Z d S)�
TeletexStringzK
Represents a teletex string from ASN.1 as a Python unicode string
� ZteletexN)ri rj rk rl r( r� r! r! r! r" r< n s r< c @ s e Z d Z d Z d Z d S)�VideotexStringzI
Represents a videotex string from ASN.1 as a Python byte string
� N)ri rj rk rl r( r! r! r! r" r> w s r> c @ s" e Z d Z d Z d Z d Z d S)� IA5StringzH
Represents an IA5 string from ASN.1 as a Python unicode string
� �asciiN)ri rj rk rl r( r� r! r! r! r" r@ s r@ c @ s( e Z d Z d Z e d d � � Z d S)� AbstractTimezK
Represents a time from ASN.1 as a Python datetime.datetime object
c C s! | j d k r d S| j d k rt | � } t j d | � } | s | j d � } | j | � } | j d t j � | _ n� | j | d d � � } t
| d d
� � } t
| d d � � } t d t | � d
| � } | d k r� | | 8} n
| | 7} | j d t j � | _ | j S)z�
The a native Python datatype representation of this value
:return:
A datetime.datetime object in the UTC timezone or None
Nz[-\+]�Z�tzinfor r� r� r �hours�minutes���������rJ )
r< rV r
�re�searchr� � _date_by_len�replacer �utcr� r �abs)r? �stringZ has_timezone�daterF rG �deltar! r! r" r] � s$
zAbstractTime.nativeN)ri rj rk rl r� r] r! r! r! r" rC � s rC c @ s4 e Z d Z d Z d Z d d � Z d d � Z d S)�UTCTimezV
Represents a UTC time from ASN.1 as a Python datetime.datetime object in UTC
� c C sP t | t � r3 | j d � } t r3 | j d � } t j | | � d | _ d S)z�
Sets the value of the object
:param value:
A unicode string or a datetime.datetime object
:raises:
ValueError - when an invalid value is passed
z
%y%m%d%H%M%SZrB N)r& r �strftimerD r� r� r= rV )r? r, r! r! r" r= � s z UTCTime.setc C s� t | � } t | d d � � } | d k r7 d } n d } | d k r] t j | | d � S| d k r} t j | | d � S| S)
z�
Parses a date from a string based on its length
:param string:
A unicode string to parse
:return:
A datetime.datetime object or a unicode string
r r �2 Z20Z19r� z
%Y%m%d%H%Mr� z %Y%m%d%H%M%S)rx r� r �strptime)r? rQ �strlenZyear_numr` r! r! r" rM � s zUTCTime._date_by_lenN)ri rj rk rl r( r= rM r! r! r! r" rT � s rT c @ s4 e Z d Z d Z d Z d d � Z d d � Z d S)�GeneralizedTimez�
Represents a generalized time from ASN.1 as a Python datetime.datetime
object or asn1crypto.util.extended_datetime object in UTC
� c C sV t | t t f � r9 | j d � } t r9 | j d � } t j | | � d | _ d S)a
Sets the value of the object
:param value:
A unicode string, a datetime.datetime object or an
asn1crypto.util.extended_datetime object
:raises:
ValueError - when an invalid value is passed
z
%Y%m%d%H%M%SZrB N) r& r r rV rD r� r� r= rV )r? r, r! r! r" r= � s zGeneralizedTime.setc C s� t | � } d } | d k r' d } n< | d k r< d } n' | d k rQ d } n | d k rc d } | r� t | � d
k r� | d d
� d k r� t j d
| d
d � | � } t d | j | j | j | j | j | j | j
� St j | | � S| S)a
Parses a date from a string based on its length
:param string:
A unicode string to parse
:return:
A datetime.datetime object, asn1crypto.util.extended_datetime object or
a unicode string
Nr� z%Y%m%d%Hr� z
%Y%m%d%H%M� z %Y%m%d%H%M%Sr9 z%Y%m%d%H%M%S.%fr� r Z0000�2000) rx r rX r �month�day�hour�minute�second� microsecondrE )r? rQ rY Z date_format�tr! r! r" rM s0 (
z GeneralizedTime._date_by_lenN)ri rj rk rl r( r= rM r! r! r! r" rZ � s rZ c @ s" e Z d Z d Z d Z d Z d S)�
GraphicStringzK
Represents a graphic string from ASN.1 as a Python unicode string
� r� N)ri rj rk rl r( r� r! r! r! r" re 7 s re c @ s" e Z d Z d Z d Z d Z d S)�
VisibleStringzK
Represents a visible string from ASN.1 as a Python unicode string
� r� N)ri rj rk rl r( r� r! r! r! r" rg A s rg c @ s" e Z d Z d Z d Z d Z d S)�
GeneralStringzK
Represents a general string from ASN.1 as a Python unicode string
� r� N)ri rj rk rl r( r� r! r! r! r" ri J s ri c @ s" e Z d Z d Z d Z d Z d S)�UniversalStringzM
Represents a universal string from ASN.1 as a Python unicode string
� z utf-32-beN)ri rj rk rl r( r� r! r! r! r" rk T s rk c @ s" e Z d Z d Z d Z d Z d S)�CharacterStringzM
Represents a character string from ASN.1 as a Python unicode string
� r� N)ri rj rk rl r( r� r! r! r! r" rm ] s rm c @ s" e Z d Z d Z d Z d Z d S)� BMPStringzG
Represents a BMP string from ASN.1 as a Python unicode string
� z utf-16-beN)ri rj rk rl r( r� r! r! r! r" ro g s ro c C s� t d | t | � t | � f � | j r[ t d | t j | j pG d � j d � f � | j d k o� | j d k o� | j d k } | r� t
j | j � } t j | j � } | j
d k r
t d | t j | j � | j f � | ret d | | | | j f � nX | j
d k rB| ret d
| | | | j f � n# | ret d | | | | j f � t d | t j | j p�d � j d � f � d S)
a7
Prints out basic information about an Asn1Value object. Extracted for reuse
among different classes that customize the debug information.
:param prefix:
A unicode string of spaces to prefix output line with
:param self:
The object to print the debugging information about
z%s%s Object #%sz%s Header: 0x%sr# zutf-8Nr0 z#%s %s tag %s (explicitly tagged)z%s %s %s %sr/ z&%s %s %s tag %s (implicitly tagged)z%s %s %s tag %sz%s Data: 0x%s)r^ r rH ra �binascii�hexlifyr� rd r8 r( r" r� r; r6 r9 r: r< )r` r? Z
has_header� method_name�
class_namer! r! r" r[ p s* # /- r[ c C s� d | k r� | d } d } | | j k r4 d } nM | d k r\ | j | d k r\ d } n% | d k r� | j | d k r� d } | r� | j | d | d � S| S| j r� | j � S| S)z�
Checks if a value is properly tagged based on the spec, and re/untags as
necessary
:param value:
An Asn1Value object
:param params:
A dict of spec params
:return:
An Asn1Value that is properly tagged
r6 FTr0 r( r/ )r6 r: r( rT rU )r, r� Zrequired_tag_typerT r! r! r" r� � s
r� c C sw | d k r d S| j } | j } | j d | j � } | d k rI d } | j d | � } | j d | � } | | f S)aP
Builds a 2-element tuple used to identify fields by grabbing the class_
and tag from an Asn1Value class and the params dict being passed to it
:param params:
A dict of params to pass to spec
:param spec:
An Asn1Value class
:return:
A 2-element integer tuple in the form (class_, tag)
Nr6 r r8 r( )NN)r8 r( r� r6 )r� r$ Zrequired_classZ required_tagr6 r! r! r" r� � s r� r� r� r� r� r� r� r� r7 r� r� r� r0 r9 r; r= r? rA rU r[ rf rh rj rl rn rp c C s� | d k r t Sd } | d k r�| r= | d | | � }
n | d | � }
| t k r[ q�|
j d k r�| |
j k r� t t d t |
� t j |
j � t j | | � � � � | d k r� t t d t |
� t j d � t j | | � � � � | |
j
k r't t d t |
� |
j
| � � � |
} t | t | � � \ } }
t
| d | � }
| |
j |
_ |
j | pzd
7_ d |
_ | j |
_ | j
|
_
d } q�t |
t � r^|
j | | | � y$ | |
j |
_ d
} |
j � Wq�t t f k
rZ} zC | j d d � } | j d d
t |
� f | | _ | � WYd d } ~ Xq�Xq�| |
j k r�t t d t |
� t j |
j � t j | | � � � � | |
j k rA| d k o�|
j d k o�| d k } | s�t |
t � r/t t d t |
� t j |
j � t j | | � � � � n | |
_ d |
_ | |
j k r�| |
j k r�t t d t |
� |
j | � � � nV| r6d | k r6| d d k r6t d | | � } t | t | � � \ } }
t
| d | � }
| |
j |
_ |
j | pd
7_ d |
_ | j |
_ | j
|
_
d } n� | t k rot t d t j | � t j | � | � � � t | } | d | d | � }
| d k o�|
j d k o�| d k } | r�t |
t � r�d |
_ | |
_ | s�| |
_ | p�d
|
_ d |
_ | r�y |
j | � Wni t t f k
r�} zC | j d d � } | j d d
t |
� f | | _ | � WYd d } ~ Xn X|
S)a
Builds an Asn1Value object generically, or using a spec with optional params
:param class_:
An integer representing the ASN.1 class
:param method:
An integer representing the ASN.1 method
:param tag:
An integer representing the ASN.1 tag
:param header:
A byte string of the ASN.1 header (class, method, tag, length)
:param contents:
A byte string of the ASN.1 value
:param trailer:
A byte string of any ASN.1 trailer (only used by indefinite length encodings)
:param spec:
A class derived from Asn1Value that defines what class_ and tag the
value should have, and the semantics of the encoded value. The
return value will be of this type. If omitted, the encoded value
will be decoded using the standard universal tag based on the
encoded tag number.
:param spec_params:
A dict of params to pass to the spec object
:param nested_spec:
For certain Asn1Value classes (such as OctetString and BitString), the
contents can be further parsed and interpreted as another Asn1Value.
This parameter controls the spec for that sub-parsing.
:return:
An object of the type spec, or if not specified, a child of Asn1Value
NFr< r0 z�
Error parsing %s - explicitly-tagged class should have been
%s, but %s was found
r z�
Error parsing %s - explicitly-tagged method should have
been %s, but %s was found
z�
Error parsing %s - explicitly-tagged tag should have been
%s, but %s was found
r$ r# Tr z
while parsing %sz|
Error parsing %s - class should have been %s, but %s was
found
s zq
Error parsing %s - method should have been %s, but %s was found
zf
Error parsing %s - tag should have been %s, but %s was found
r6 zO
Unknown element - %s class, %s method, tag %s
r8 ) r� r� r6 r9 r4 r
r r; r� r" r: r rx r ra re r& r� r� r< r� r' r> r8 rd rb rc r( rm r �_UNIVERSAL_SPECSrV )r8 rd r( rg r< rh r$ r% Z nested_specZ
header_setr, Zoriginal_valuer� r- rB r> Z ber_indefr! r! r" r s� ) % ' "
' %r c C st t | � } t | | | � \ } } | rX | | | k rX | | | } t d | � � t | d | d | � | f S)a�
Parses a byte string generically, or using a spec with optional params
:param encoded_data:
A byte string that contains BER-encoded data
:param pointer:
The index in the byte string to parse from
:param spec:
A class derived from Asn1Value that defines what class_ and tag the
value should have, and the semantics of the encoded value. The
return value will be of this type. If omitted, the encoded value
will be decoded using the standard universal tag based on the
encoded tag number.
:param spec_params:
A dict of params to pass to the spec object
:param strict:
A boolean indicating if trailing data should be forbidden - if so, a
ValueError will be raised when trailing data exists
:return:
A 2-element tuple:
- 0: An object of the type spec, or if not specified, a child of Asn1Value
- 1: An integer indicating how many bytes were consumed
z4Extra data - %d bytes of trailing data were providedr$ r% )rx r r4 r ) r rz r$ r% r Z encoded_lenr� Z new_pointerr� r! r! r" r) � s r) )grl �
__future__r r r r r r rq rO r� rK �sysr� r Z_errorsr
Z _ordereddictr �_typesr r
r r r �parserr r �utilr r r r � version_info� cStringIOr r �xranger� rD �io�registerr; r7 r" �compiler� r2 r �objectr ro rt rb r~ r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r� r r/ r5 r6 r8 r: r< r> r@ rC rT rZ re rg ri rk rm ro r[ r� r� ru r r) r! r! r! r" �<module>/ s� " ("
6� �-G6 �� ;� "{Q5Q"� ! X T N 5 �) �D � � � � ��! .8I
+ & ! �