o B]OS@sxddlmZddlmZmZmZmZmZddlm Z m Z gdZ Gdddej Z Gdddej ZGd d d eZ Gd d d ejZGd ddejZGdddeZGdddej ZGdddej ZGdddej ZGdddej ZGdddejZGdddej ZGdddeZGdd d ejZGd!d"d"e jejZGd#d$d$e jejZGd%d&d&ejZd'S)() version_info)univtag constraint namedtypenamedval)rfc1155error) Opaque TimeTicksBitsInteger OctetString IpAddress Counter64 Unsigned32Gauge32 Integer32ObjectIdentifier Counter32Nullc@eZdZdZdS)raCreates an instance of SNMP Null class. :py:class:`~pysnmp.proto.rfc1902.Null` type represents the absence of value. Parameters ---------- initializer: str Python string object. Must be an empty string. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Null('') Null('') >>> N__name__ __module__ __qualname____doc__rr6/usr/lib/python3/dist-packages/pysnmp/proto/rfc1902.pyrrc@s<eZdZdZejjeddZe ddZ e ddZ dS) raCreates an instance of SNMP Integer32 class. :py:class:`~pysnmp.proto.rfc1902.Integer32` type represents integer-valued information between -2147483648 to 2147483647 inclusive (:RFC:`1902#section-7.1.1`). This type is indistinguishable from the :py:class:`~pysnmp.proto.rfc1902.Integer` type. The :py:class:`~pysnmp.proto.rfc1902.Integer32` type may be sub-typed to be more constrained than the base :py:class:`~pysnmp.proto.rfc1902.Integer32` type. Parameters ---------- initializer : int Python integer in range between -2147483648 to 2147483647 inclusive or :py:class:`~pysnmp.proto.rfc1902.Integer32`. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Integer32(1234) Integer32(1234) >>> Integer32(1) > 2 True >>> Integer32(1) + 1 Integer32(2) >>> int(Integer32(321)) 321 >>> SmallInteger = Integer32.withRange(1,3) >>> SmallInteger(1) Integer32(1) >>> DiscreetInteger = Integer32.withValues(4, 8, 1) >>> DiscreetInteger(4) Integer32(4) >>> iics"Gfddd}j|_|S)z.XN)rrr subtypeSpecrSingleValueConstraintrclsvaluesrrX\sr%rr#r$r%rr"r withValuesWszInteger32.withValuesc$Gfddd}j|_|S)z8Creates a subclass with value range constraint. ceZdZjeZdS)zInteger32.withRange..XN)rrrr rValueRangeConstraintrr#maximumminimumrrr%gr%r&r#r.r-r%rr,r withRangebzInteger32.withRangeN) rrrrrr r rr+ classmethodr(r1rrrrr)s )  rc@seZdZdZeddZdS)r a&Creates an instance of SNMP INTEGER class. The :py:class:`~pysnmp.proto.rfc1902.Integer` type represents integer-valued information as named-number enumerations (:RFC:`1902#section-7.1.1`). This type inherits and is indistinguishable from :py:class:`~pysnmp.proto.rfc1902.Integer32` class. The :py:class:`~pysnmp.proto.rfc1902.Integer` type may be sub-typed to be more constrained than the base :py:class:`~pysnmp.proto.rfc1902.Integer` type. Parameters ---------- initializer : int Python integer in range between -2147483648 to 2147483647 inclusive or :py:class:`~pysnmp.proto.rfc1902.Integer` class instance. In case of named-numbered enumerations, initialization is also possible by enumerated literal. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Integer(1234) Integer(1234) >>> Integer(1) > 2 True >>> Integer(1) + 1 Integer(2) >>> int(Integer(321)) 321 >>> SomeState = Integer.withNamedValues(enable=1, disable=0) >>> SomeState(1) Integer('enable') >>> int(SomeState('disable')) 0 >>> c s@tjGfddd}j|_|S)z}Create a subclass with discreet named values constraint. Reduce fully duplicate enumerations along the way. cs*eZdZejZjej ZdS)z"Integer.withNamedValues..XN) rrrr NamedValues namedValuesr rr!r$rr#enumsr$rrr%s   r%setr5itemsupdaterr'rr6rwithNamedValuess zInteger.withNamedValuesN)rrrrr3r<rrrrr ns+r c@s\eZdZdZejjeddZdZ ddZ ddZ d d Z d d Z d dZeddZdS)ruACreates an instance of SNMP OCTET STRING class. The :py:class:`~pysnmp.proto.rfc1902.OctetString` type represents arbitrary binary or text data (:RFC:`1902#section-7.1.2`). It may be sub-typed to be constrained in size. Parameters ---------- strValue : str Python string or :py:class:`~pysnmp.proto.rfc1902.OctetString` class instance. Other parameters ---------------- hexValue : str Python string representing octets in a hexadecimal notation (e.g. DEADBEEF). Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> OctetString('some apples') OctetString('some apples') >>> OctetString('some apples') + ' and oranges' OctetString('some apples and oranges') >>> str(OctetString('some apples')) 'some apples' >>> SomeString = OctetString.withSize(3, 12) >>> str(SomeString(hexValue='deadbeef')) 'Þ­¾ï' >>> riNcCs ||_|SN fixedLengthselfvaluerrrsetFixedLengthszOctetString.setFixedLengthcCs |jduSr=r>rArrr isFixedLengths zOctetString.isFixedLengthcCs|jSr=r>rDrrrgetFixedLengthszOctetString.getFixedLengthcO$tjj|g|Ri||Sr=)rrclonerCrFrAargskwargsrrrrH$zOctetString.clonecOrGr=)rrsubtyperCrFrIrrrrMrLzOctetString.subtypecr))z7Creates a subclass with value size constraint. cr*)zOctetString.withSize..XN)rrrr rValueSizeConstraintrr,rrr%r/r%r&r0rr,rwithSizer2zOctetString.withSize)rrrrrrr rrNr?rCrErFrHrMr3rOrrrrrs &rc@r)raCreates an instance of SNMP OBJECT IDENTIFIER class. The :py:class:`~pysnmp.proto.rfc1902.ObjectIdentifier` type represents administratively assigned names (:RFC:`1902#section-7.1.3`). Supports sequence protocol where elements are integer sub-identifiers. Parameters ---------- initializer: tuple, str Python tuple of up to 128 integers in range between 0 to 4294967295 inclusive or Python string containing OID in "dotted" form or :py:class:`~pysnmp.proto.rfc1902.ObjectIdentifier`. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> ObjectIdentifier((1, 3, 6)) ObjectIdentifier('1.3.6') >>> ObjectIdentifier('1.3.6') ObjectIdentifier('1.3.6') >>> tuple(ObjectIdentifier('1.3.6')) (1, 3, 6) >>> str(ObjectIdentifier('1.3.6')) '1.3.6' >>> Nrrrrrrrrc@sPeZdZdZejeej ej dZej e ddZ dZddZddZdS) ra/Creates an instance of SNMP IpAddress class. The :py:class:`~pysnmp.proto.rfc1902.IpAddress` class represents a 32-bit internet address as an OCTET STRING of length 4, in network byte-order (:RFC:`1902#section-7.1.5`). Parameters ---------- strValue : str The same as :py:class:`~pysnmp.proto.rfc1902.OctetString`, additionally IPv4 address in dotted notation ('127.0.0.1'). Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> IpAddress('127.0.0.1') IpAddress(hexValue='7f000001') >>> str(IpAddress(hexValue='7f000001')) '' >>> IpAddress('') IpAddress(hexValue='7f000001') >>> rcCsjt|tr"t|dkr"z dd|dD}Wn td|t||}t|dkr3td|S)NrPcSg|]}t|qSr)int.0xrrr Ez&IpAddress.prettyIn...zBad IP address syntax %szBad IP address syntax) isinstancestrlensplitr ProtocolErrorrprettyInr@rrrr^Bs   zIpAddress.prettyIncCs&|rddd||DSdS)NrXcSsg|]}d|qS)z%drrSrrrrVPrWz'IpAddress.prettyOut..)join __class__ asNumbersr@rrr prettyOutMs zIpAddress.prettyOutN)rrrrrtagSet tagImplicitlyrTagtagClassApplicationtagFormatSimpler rrNr?r^rcrrrrrs rc@@eZdZdZejje ej ej dZejj e ddZ dS)raFCreates an instance of SNMP Counter32 class. :py:class:`~pysnmp.proto.rfc1902.Counter32` type represents a non-negative integer which monotonically increases until it reaches a maximum value of 4294967295, when it wraps around and starts increasing again from zero (:RFC:`1902#section-7.1.6`). Parameters ---------- initializer : int Python integer in range between 0 to 4294967295 inclusive or any :py:class:`~pysnmp.proto.rfc1902.Integer`-based class. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Counter32(1234) Counter32(1234) >>> Counter32(1) + 1 Counter32(2) >>> int(Counter32(321)) 321 >>> rNrrrrrr rdrerrfrgrhr rr+rrrrrV  rc@ri)ra-Creates an instance of SNMP Gauge32 class. :py:class:`~pysnmp.proto.rfc1902.Gauge32` type represents a non-negative integer, which may increase or decrease, but shall never exceed a maximum value. The maximum value can not be greater than 4294967295 (:RFC:`1902#section-7.1.7`). Parameters ---------- initializer : int Python integer in range between 0 to 4294967295 inclusive or any :py:class:`~pysnmp.proto.rfc1902.Integer`-based class. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Gauge32(1234) Gauge32(1234) >>> Gauge32(1) + 1 Gauge32(2) >>> int(Gauge32(321)) 321 >>> rrkNrlrrrrr}rmrc@ri)raCreates an instance of SNMP Unsigned32 class. :py:class:`~pysnmp.proto.rfc1902.Unsigned32` type represents integer-valued information between 0 and 4294967295 (:RFC:`1902#section-7.1.11`). Parameters ---------- initializer : int Python integer in range between 0 to 4294967295 inclusive or any :py:class:`~pysnmp.proto.rfc1902.Integer`-based class. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Unsigned32(1234) Unsigned32(1234) >>> Unsigned32(1) + 1 Unsigned32(2) >>> int(Unsigned32(321)) 321 >>> rnrrkNrlrrrrr  rc@ri)r aCreates an instance of SNMP TimeTicks class. :py:class:`~pysnmp.proto.rfc1902.TimeTicks` type represents a non-negative integer which represents the time, modulo 4294967296, in hundredths of a second between two epochs (:RFC:`1902#section-7.1.8`). Parameters ---------- initializer : int Python integer in range between 0 to 4294967295 inclusive or any :py:class:`~pysnmp.proto.rfc1902.Integer`-based class. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> TimeTicks(1234) TimeTicks(1234) >>> TimeTicks(1) + 1 TimeTicks(2) >>> int(TimeTicks(321)) 321 >>> rrkNrlrrrrr ror c@s,eZdZdZejje ej ej dZdS)r uwCreates an instance of SNMP Opaque class. The :py:class:`~pysnmp.proto.rfc1902.Opaque` type supports the capability to pass arbitrary ASN.1 syntax. A value is encoded using the ASN.1 BER into a string of octets. This, in turn, is encoded as an OCTET STRING, in effect "double-wrapping" the original ASN.1 value (:RFC:`1902#section-7.1.9`). Parameters ---------- strValue : str Python string or :py:class:`~pysnmp.proto.rfc1902.OctetString`-based class instance. Other parameters ---------------- hexValue : str Python string representing octets in a hexadecimal notation (e.g. DEADBEEF). Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Opaque('some apples') Opaque('some apples') >>> Opaque('some apples') + ' and oranges' Opaque('some apples and oranges') >>> str(Opaque('some apples')) 'some apples' >>> str(Opaque(hexValue='deadbeef')) 'Þ­¾ï' >>> rPN) rrrrrrrdrerrfrgrhrrrrr s 'r c@ri)raQCreates an instance of SNMP Counter64 class. :py:class:`~pysnmp.proto.rfc1902.Counter64` type represents a non-negative integer which monotonically increases until it reaches a maximum value of 18446744073709551615, when it wraps around and starts increasing again from zero (:RFC:`1902#section-7.1.10`). Parameters ---------- initializer : int Python integer in range between 0 to 4294967295 inclusive or any :py:class:`~pysnmp.proto.rfc1902.Integer`-based class. Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> Counter64(1234) Counter64(1234) >>> Counter64(1) + 1 Counter64(2) >>> int(Counter64(321)) 321 >>> rlNrlrrrrrrmrc@s<eZdZdZeZddZddZddZ e dd Z d S) r uCreates an instance of SNMP BITS class. The :py:class:`~pysnmp.proto.rfc1902.Bits` type represents an enumeration of named bits. This collection is assigned non-negative, contiguous values, starting at zero. Only those named-bits so enumerated may be present in a value (:RFC:`1902#section-7.1.4`). The bits are named and identified by their position in the octet string. Position zero is the high order (or left-most) bit in the first octet of the string. Position 7 is the low order (or right-most) bit of the first octet of the string. Position 8 is the high order bit in the second octet of the string, and so on (`BITS Pseudotype `_). Parameters ---------- strValue : str, tuple Sequence of bit names or a Python string (as a raw data) or :py:class:`~pysnmp.proto.rfc1902.OctetString` class instance. Other parameters ---------------- hexValue : str Python string representing octets in a hexadecimal notation (e.g. DEADBEEF). Raises ------ PyAsn1Error : On constraint violation or bad initializer. Examples -------- >>> from pysnmp.proto.rfc1902 import * >>> SomeBits = Bits.withNamedBits(apple=0, orange=1, peach=2) >>> SomeBits(('apple', 'orange')).prettyPrint() 'apple, orange' >>> SomeBits(('apple', 'orange')) Bits(hexValue='c0') >>> SomeBits('€') Bits(hexValue='80') >>> SomeBits(hexValue='80') Bits(hexValue='80') >>> SomeBits(hexValue='80').prettyPrint() 'apple' >>> cOs:d|vr|jdit|d}||i|St|S)Nr5r) withNamedBitsdictpopr__new__)r#rJrKr rrrruws z Bits.__new__cCst|ttfs t||Sg}|D]:}|j|}|dur$td|t |d\}}|t |kr?| dg|t |d||dd|>O<qt||S)NzUnknown named bit %srrj) rYtuplelistrr^r5ZgetValuer r]divmodr[extend)rAbitsZoctetsbitvdmrrrr^~s    z Bits.prettyIncCsg}||}t|D]<\}}||}d}|dkrI|d|>@rA|j|dd|}|dur.)rarb enumerater5ZgetNameappendr`)rArBnamesZintsir~jnamerrrrcs  zBits.prettyOutc s<t|j|Gfddd|}|j|_|S)z|Creates a subclass with discreet named bits constraint. Reduce fully duplicate enumerations along the way. cseZdZejZdS)zBits.withNamedBits..XN)rrrrr4r5rr7rrr%sr%r8r'rrrrrs zBits.withNamedBitsN) rrrrrr4r5rur^rcr3rrrrrrr Ds0r c@s eZdZdS) ObjectNameN)rrrrrrrrsrc @s:eZdZeedeedeede Z dS) SimpleSyntaxz integer-valuez string-valuezobjectID-valueN) rrrr NamedTypes NamedTyper rrr componentTyperrrrrs   rc @s\eZdZeedeedeedeede ede ede Z dS)ApplicationSyntaxzipAddress-valuez counter-valueztimeticks-valuezarbitrary-valuezbig-counter-valuez gauge32-valueN) rrrrrrrrr r rrrrrrrrs      rc@s,eZdZeedeedeZdS) ObjectSyntaxsimplezapplication-wideN) rrrrrrrrrrrrrrs   rN)sysrZ pyasn1.typerrrrrZ pysnmp.protorr __all__rr rrrrrrrr r rr rZTypeCoercionHackMixInZChoicerrrrrrrs* E>M#:''&&-'g