U ScrW@sddlZddlmZddlmZddlmZddlmZddlmZddd d gZ Gd dde Z Gd dde Z e Z Gd dde ZeZGdd d e ZeZGdd d e ZeZdS)N)error)calling) constraint)tag)tagmapAsn1ItemAsn1TypeSimpleAsn1TypeConstructedAsn1Typec@seZdZedddZdS)rcCs4ztj|7_Wntk r,|t_YnXtjSN)rZ _typeCounterAttributeError)cls incrementr4/tmp/pip-unpacked-wheel-hsjy238j/pyasn1/type/base.py getTypeIds  zAsn1Item.getTypeIdN)r )__name__ __module__ __qualname__ classmethodrrrrrrsc@seZdZdZeZeZ dZ ddZ ddZ ddZ ed d Zed d Zed dZd#ddZd$ddZeddZd%ddZddZddZddZdd Zd!d"ZdS)&ra>Base class for all classes representing ASN.1 types. In the user code, |ASN.1| class is normally used only for telling ASN.1 objects from others. Note ---- For as long as ASN.1 is concerned, a way to compare ASN.1 types is to use :meth:`isSameTypeWith` and :meth:`isSuperTypeOf` methods. NcKs.|j|jd}|||j|||_dS)NtagSet subtypeSpec)rrupdate__dict__ _readOnlyselfkwargsreadOnlyrrr__init__3s   zAsn1Type.__init__cCs2|ddkr$||jkr$td|||j|<dS)Nr_z!read-only instance attribute "%s")rr PyAsn1Errorr)rnamevaluerrr __setattr__?szAsn1Type.__setattr__cCs|Sr ) prettyPrintrrrr__str__EszAsn1Type.__str__cCs|jSr )rr(rrrr HszAsn1Type.readOnlycCs|jS)z3For |ASN.1| type is equivalent to *tagSet* rr(rrreffectiveTagSetLszAsn1Type.effectiveTagSetcCst|j|iS)zvReturn a :class:`~pyasn1.type.tagmap.TagMap` object mapping ASN.1 tags to ASN.1 objects within callee object. )rZTagMaprr(rrrtagMapRszAsn1Type.tagMapTcCs,||kp*| s|j|jko*| p*|j|jkS)a?Examine |ASN.1| type for equality with other ASN.1 type. ASN.1 tags (:py:mod:`~pyasn1.type.tag`) and constraints (:py:mod:`~pyasn1.type.constraint`) are examined when carrying out ASN.1 types comparison. Python class inheritance relationship is NOT considered. Parameters ---------- other: a pyasn1 type object Class instance representing ASN.1 type. Returns ------- : :class:`bool` :obj:`True` if *other* is |ASN.1| type, :obj:`False` otherwise. rrotherZ matchTagsZmatchConstraintsrrrisSameTypeWithXszAsn1Type.isSameTypeWithcCs(| p&|j|jo&| p&|j|jS)alExamine |ASN.1| type for subtype relationship with other ASN.1 type. ASN.1 tags (:py:mod:`~pyasn1.type.tag`) and constraints (:py:mod:`~pyasn1.type.constraint`) are examined when carrying out ASN.1 types comparison. Python class inheritance relationship is NOT considered. Parameters ---------- other: a pyasn1 type object Class instance representing ASN.1 type. Returns ------- : :class:`bool` :obj:`True` if *other* is a subtype of |ASN.1| type, :obj:`False` otherwise. )rZisSuperTagSetOfr isSuperTypeOfr-rrrr0pszAsn1Type.isSuperTypeOfcGs|D]}|tk rdSqdS)NFT)noValue)valuesr%rrr isNoValueszAsn1Type.isNoValuercCs tdSr )NotImplementedErrorrZscoperrrr'szAsn1Type.prettyPrintcCs|jSr r*r(rrr getTagSetszAsn1Type.getTagSetcCs|jSr )r+r(rrrgetEffectiveTagSetszAsn1Type.getEffectiveTagSetcCs|jSr )r,r(rrr getTagMapszAsn1Type.getTagMapcCs|jSr rr(rrrgetSubtypeSpecszAsn1Type.getSubtypeSpeccCs|jSr )isValuer(rrrhasValueszAsn1Type.hasValue)TT)TT)r)rrr__doc__rZTagSetrrConstraintsIntersectionrZtypeIdr!r&r)propertyr r+r,r/r0 staticmethodr3r'r6r7r8r:r<rrrrrs.         c@s4eZdZdZedZdZddZddZdd Z dS) NoValueazCreate a singleton instance of NoValue class. The *NoValue* sentinel object represents an instance of ASN.1 schema object as opposed to ASN.1 value object. Only ASN.1 schema-related operations can be performed on ASN.1 schema objects. Warning ------- Any operation attempted on the *noValue* object will raise the *PyAsn1Error* exception. ) __slots____getattribute__ __getattr__r& __delattr__ __class__r!__del____new____repr__r __objclass__Zim_class __sizeof__ __reduce__ __reduce_ex____getnewargs____getinitargs__ __getstate__ __setstate__Ncs\jdkrVdd}fddttttfD}t|D]}t|||q4t_jS)Ncsfdd}|S)NcstddS)N/Attempted "%s" operation on ASN.1 schema objectrr#)rargskwr$rrplugsz.NoValue.__new__..getPlug..plugr)r$rWrrVrgetPlugs z NoValue.__new__..getPlugcsLg|]D}t|D]6}|jkr|dr|drtt||r|qqS)__)dir skipMethods startswithendswithrcallablegetattr).0typr$rrr s    z#NoValue.__new__..) _instancestrintlistdictsetsetattrobjectrH)rrXZop_namesr$rrbrrHs     zNoValue.__new__cCs(||jkrtd|td|dS)NzAttribute %s not presentrR)r[r rr#)rattrrrrrDs  zNoValue.__getattr__cCs d|jjS)Nz <%s object>)rFrr(rrrrIszNoValue.__repr__) rrrr=rir[rdrHrDrIrrrrrAs rAc@seZdZdZeZefddZddZddZdd Z d d Z d d Z ddZ ddZ ejddkrlddZnddZddZeddZefddZefddZd d!Zd"d#Zd)d$d%Zd*d&d'Zd(S)+r aBase class for all simple classes representing ASN.1 types. ASN.1 distinguishes types by their ability to hold other objects. Scalar types are known as *simple* in ASN.1. In the user code, |ASN.1| class is normally used only for telling ASN.1 objects from others. Note ---- For as long as ASN.1 is concerned, a way to compare ASN.1 types is to use :meth:`isSameTypeWith` and :meth:`isSuperTypeOf` methods. cKsztj|f||tkr|j}nR||}z||Wn8tjk rnt \}}}|d||j j fYnX||_ dS)Nz%s at %s) rr!r1 defaultValueprettyInrrr#sysexc_inforFr_value)rr%rZexTypeZexValueZexTbrrrr!s zSimpleAsn1Type.__init__cCsd|jj|jrdpdf}|jD]\}}|r$|d||f7}q$|jr|}t|dkrx|ddd|dd}|d |7}d |S) N %s %s objectr%schemaz, %s %s z...i, payload [%s]<%s>)rFrr;r itemsr'lenrZrepresentationrlr%rrrrIs   zSimpleAsn1Type.__repr__cCs||kr dp|j|kS)NTrqrr.rrr__eq__%szSimpleAsn1Type.__eq__cCs |j|kSr r{r|rrr__ne__(szSimpleAsn1Type.__ne__cCs |j|kSr r{r|rrr__lt__+szSimpleAsn1Type.__lt__cCs |j|kSr r{r|rrr__le__.szSimpleAsn1Type.__le__cCs |j|kSr r{r|rrr__gt__1szSimpleAsn1Type.__gt__cCs |j|kSr r{r|rrr__ge__4szSimpleAsn1Type.__ge__rcCs|jr dp dSNTFr{r(rrr __nonzero__8szSimpleAsn1Type.__nonzero__cCs|jr dp dSrr{r(rrr__bool__;szSimpleAsn1Type.__bool__cCs t|jSr )hashrqr(rrr__hash__>szSimpleAsn1Type.__hash__cCs |jtk S)azIndicate that |ASN.1| object represents ASN.1 value. If *isValue* is :obj:`False` then this object represents just ASN.1 schema. If *isValue* is :obj:`True` then, in addition to its ASN.1 schema features, this object can also be used like a Python built-in object (e.g. :class:`int`, :class:`str`, :class:`dict` etc.). Returns ------- : :class:`bool` :obj:`False` if object represents just ASN.1 schema. :obj:`True` if object represents ASN.1 schema and can be used as a normal value. Note ---- There is an important distinction between PyASN1 schema and value objects. The PyASN1 schema objects can only participate in ASN.1 schema-related operations (e.g. defining or testing the structure of the data). Most obvious uses of ASN.1 schema is to guide serialisation codecs whilst encoding/decoding serialised ASN.1 contents. The PyASN1 value objects can **additionally** participate in many operations involving regular Python objects (e.g. arithmetic, comprehension etc). )rqr1r(rrrr;AszSimpleAsn1Type.isValuecKs8|tkr|s|S|j}|j}|||j|f|S)a`Create a modified version of |ASN.1| schema or value object. The `clone()` method accepts the same set arguments as |ASN.1| class takes on instantiation except that all arguments of the `clone()` method are optional. Whatever arguments are supplied, they are used to create a copy of `self` taking precedence over the ones used to instantiate `self`. Note ---- Due to the immutable nature of the |ASN.1| object, if no arguments are supplied, no new |ASN.1| object will be created and `self` will be returned instead. )r1rqr copyrrF)rr%r initializersrrrclone_s  zSimpleAsn1Type.clonecKs|tkr|s|S|j}|j}|dd}|dk rD|j||d<|dd}|dk rh|j||d<|D]\}}|||7<qp|j |f|S)aCreate a specialization of |ASN.1| schema or value object. The subtype relationship between ASN.1 types has no correlation with subtype relationship between Python types. ASN.1 type is mainly identified by its tag(s) (:py:class:`~pyasn1.type.tag.TagSet`) and value range constraints (:py:class:`~pyasn1.type.constraint.ConstraintsIntersection`). These ASN.1 type properties are implemented as |ASN.1| attributes. The `subtype()` method accepts the same set arguments as |ASN.1| class takes on instantiation except that all parameters of the `subtype()` method are optional. With the exception of the arguments described below, the rest of supplied arguments they are used to create a copy of `self` taking precedence over the ones used to instantiate `self`. The following arguments to `subtype()` create a ASN.1 subtype out of |ASN.1| type: Other Parameters ---------------- implicitTag: :py:class:`~pyasn1.type.tag.Tag` Implicitly apply given ASN.1 tag object to `self`'s :py:class:`~pyasn1.type.tag.TagSet`, then use the result as new object's ASN.1 tag(s). explicitTag: :py:class:`~pyasn1.type.tag.Tag` Explicitly apply given ASN.1 tag object to `self`'s :py:class:`~pyasn1.type.tag.TagSet`, then use the result as new object's ASN.1 tag(s). subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` Add ASN.1 constraints object to one of the `self`'s, then use the result as new object's ASN.1 constraints. Returns ------- : new instance of |ASN.1| schema or value object Note ---- Due to the immutable nature of the |ASN.1| object, if no arguments are supplied, no new |ASN.1| object will be created and `self` will be returned instead. implicitTagNr explicitTag) r1rqr rpopr tagImplicitly tagExplicitlyrxrF)rr%rrrrargoptionrrrsubtypezs/   zSimpleAsn1Type.subtypecCs|Sr rrr%rrrrnszSimpleAsn1Type.prettyIncCst|Sr )rerrrr prettyOutszSimpleAsn1Type.prettyOutcCs ||jSr )rrqr5rrrr'szSimpleAsn1Type.prettyPrintcCsd|j|jjfS)Nz%s -> %s)rrFrr5rrrprettyPrintTypeszSimpleAsn1Type.prettyPrintTypeN)r)r)rrrr=r1rmr!rIr}r~rrrrro version_inforrrr?r;rrrnrr'rrrrrr s,     D c@seZdZdZdZdZeZddZ ddZ dd Z d d Z d d Z ddZddZddZddZejddkr|ddZnddZeddZddZd d!Zd"d#Zd$d%Zd1d'd(Zd)d*Zd+d,Zd-d.Zd/d0Z dS)2r aBase class for all constructed classes representing ASN.1 types. ASN.1 distinguishes types by their ability to hold other objects. Those "nesting" types are known as *constructed* in ASN.1. In the user code, |ASN.1| class is normally used only for telling ASN.1 objects from others. Note ---- For as long as ASN.1 is concerned, a way to compare ASN.1 types is to use :meth:`isSameTypeWith` and :meth:`isSuperTypeOf` methods. FNcKs6|j|jd}|jf|}||tj|f|dS)N) componentTypesizeSpec)rr _moveSizeSpecrrr!rrrrr!s   zConstructedAsn1Type.__init__cKs>|d|j}|r:|d|j}|r*|}n||7}||d<|S)Nrr)rrr)rrrrrrrrsz!ConstructedAsn1Type._moveSizeSpeccCsxd|jj|jrdpdf}|jD] \}}|tk r$|d||f7}q$|jrp|jrp|dddd|jD7}d |S) Nrrr%rsz, %s=%rrvz, cSsg|] }t|qSr)repr)r`xrrrrc!sz0ConstructedAsn1Type.__repr__..rw)rFrr;r rxr1 componentsjoinrzrrrrIs  zConstructedAsn1Type.__repr__cCs||kp|j|kSr rr|rrrr}%szConstructedAsn1Type.__eq__cCs |j|kSr rr|rrrr~(szConstructedAsn1Type.__ne__cCs |j|kSr rr|rrrr+szConstructedAsn1Type.__lt__cCs |j|kSr rr|rrrr.szConstructedAsn1Type.__le__cCs |j|kSr rr|rrrr1szConstructedAsn1Type.__gt__cCs |j|kSr rr|rrrr4szConstructedAsn1Type.__ge__rrcCs t|jSr boolrr(rrrr8szConstructedAsn1Type.__nonzero__cCs t|jSr rr(rrrr;szConstructedAsn1Type.__bool__cCstddSNzMethod not implementedrSr(rrrr>szConstructedAsn1Type.componentscCsdSr r)rZmyClonecloneValueFlagrrr_cloneComponentValuesBsz)ConstructedAsn1Type._cloneComponentValuescKs@|dd}|j}|||jf|}|r<||||S)a Create a modified version of |ASN.1| schema object. The `clone()` method accepts the same set arguments as |ASN.1| class takes on instantiation except that all arguments of the `clone()` method are optional. Whatever arguments are supplied, they are used to create a copy of `self` taking precedence over the ones used to instantiate `self`. Possible values of `self` are never copied over thus `clone()` can only create a new schema object. Returns ------- : new instance of |ASN.1| type/value Note ---- Due to the mutable nature of the |ASN.1| object, even if no arguments are supplied, a new |ASN.1| object will be created and returned. rF)rr rrrFr)rrrrrrrrrEs     zConstructedAsn1Type.clonec Ks|j}|dd}|dd}|dk r:|j||d<|dd}|dk r^|j||d<|D]\}}|||7<qf|jf|}|r||||S)a Create a specialization of |ASN.1| schema object. The `subtype()` method accepts the same set arguments as |ASN.1| class takes on instantiation except that all parameters of the `subtype()` method are optional. With the exception of the arguments described below, the rest of supplied arguments they are used to create a copy of `self` taking precedence over the ones used to instantiate `self`. The following arguments to `subtype()` create a ASN.1 subtype out of |ASN.1| type. Other Parameters ---------------- implicitTag: :py:class:`~pyasn1.type.tag.Tag` Implicitly apply given ASN.1 tag object to `self`'s :py:class:`~pyasn1.type.tag.TagSet`, then use the result as new object's ASN.1 tag(s). explicitTag: :py:class:`~pyasn1.type.tag.Tag` Explicitly apply given ASN.1 tag object to `self`'s :py:class:`~pyasn1.type.tag.TagSet`, then use the result as new object's ASN.1 tag(s). subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` Add ASN.1 constraints object to one of the `self`'s, then use the result as new object's ASN.1 constraints. Returns ------- : new instance of |ASN.1| type/value Note ---- Due to the mutable nature of the |ASN.1| object, even if no arguments are supplied, a new |ASN.1| object will be created and returned. rFrNrr) r rrrrrrxrFr) rrrrrrrrrrrrrhs*      zConstructedAsn1Type.subtypecCstddSrrS)ridxrrrgetComponentByPositionsz*ConstructedAsn1Type.getComponentByPositionTcCstddSrrS)rrr%ZverifyConstraintsrrrsetComponentByPositionsz*ConstructedAsn1Type.setComponentByPositioncOs4t|D]\}}|||<q|D]}||||<q|Sr ) enumerate)rrTrrr%krrr setComponentss  z!ConstructedAsn1Type.setComponentscCsdSr rr(rrrsetDefaultComponentssz(ConstructedAsn1Type.setDefaultComponentscCs|jSr )rr(rrrgetComponentTypesz$ConstructedAsn1Type.getComponentTypecCs||dSr r9r(rrrverifySizeSpecsz"ConstructedAsn1Type.verifySizeSpec)T)!rrrr=ZstrictConstraintsrrr>rr!rrIr}r~rrrrrorrrr?rrrrrrrrrrrrrrr s6  #@  )roZpyasn1rZ pyasn1.compatrZ pyasn1.typerrr__all__rkrrZ Asn1ItemBaserAr1r ZAbstractSimpleAsn1Itemr ZAbstractConstructedAsn1Itemrrrrs(       JWc