Warning: file_get_contents(https://raw.githubusercontent.com/Den1xxx/Filemanager/master/languages/ru.json): failed to open stream: HTTP request failed! HTTP/1.1 404 Not Found
in /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php on line 88
Warning: Cannot modify header information - headers already sent by (output started at /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php:88) in /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php on line 215
Warning: Cannot modify header information - headers already sent by (output started at /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php:88) in /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php on line 216
Warning: Cannot modify header information - headers already sent by (output started at /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php:88) in /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php on line 217
Warning: Cannot modify header information - headers already sent by (output started at /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php:88) in /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php on line 218
Warning: Cannot modify header information - headers already sent by (output started at /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php:88) in /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php on line 219
Warning: Cannot modify header information - headers already sent by (output started at /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php:88) in /home/afelisqd/cppseducation.sc.tz/admin/images/photos/17587263121019776732_admin-dbb.php on line 220
PK ! 4 6 phpunit.xmlnu 刐迭
tests/unit
src
PK ! h澭 README.mdnu 刐迭 # sebastian/type
Collection of value objects that represent the types of the PHP type system.
## Installation
You can add this library as a local, per-project dependency to your project using [Composer](https://getcomposer.org/):
```
composer require sebastian/type
```
If you only need this library during development, for instance to run your project's test suite, then you should add it as a development-time dependency:
```
composer require --dev sebastian/type
```
PK ! 蓾 phive.xmlnu 刐迭
PK ! $惢1 LICENSEnu 刐迭 sebastian/type
Copyright (c) 2019, Sebastian Bergmann .
All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
* Neither the name of Sebastian Bergmann nor the names of his
contributors may be used to endorse or promote products derived
from this software without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
PK ! 衟镻 tests/unit/IterableTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
use SebastianBergmann\Type\TestFixture\Iterator;
/**
* @covers \SebastianBergmann\Type\IterableType
*
* @uses \SebastianBergmann\Type\Type
* @uses \SebastianBergmann\Type\TypeName
* @uses \SebastianBergmann\Type\ObjectType
* @uses \SebastianBergmann\Type\SimpleType
*/
final class IterableTypeTest extends TestCase
{
/**
* @var IterableType
*/
private $type;
protected function setUp(): void
{
$this->type = new IterableType(false);
}
public function testMayDisallowNull(): void
{
$this->assertFalse($this->type->allowsNull());
}
public function testCanGenerateReturnTypeDeclaration(): void
{
$this->assertEquals(': iterable', $this->type->getReturnTypeDeclaration());
}
public function testMayAllowNull(): void
{
$type = new IterableType(true);
$this->assertTrue($type->allowsNull());
}
public function testCanGenerateNullableReturnTypeDeclaration(): void
{
$type = new IterableType(true);
$this->assertEquals(': ?iterable', $type->getReturnTypeDeclaration());
}
public function testNullCanBeAssignedToNullableIterable(): void
{
$type = new IterableType(true);
$this->assertTrue($type->isAssignable(new NullType));
}
public function testIterableCanBeAssignedToIterable(): void
{
$this->assertTrue($this->type->isAssignable(new IterableType(false)));
}
public function testArrayCanBeAssignedToIterable(): void
{
$this->assertTrue(
$this->type->isAssignable(
Type::fromValue([], false)
)
);
}
public function testIteratorCanBeAssignedToIterable(): void
{
$this->assertTrue(
$this->type->isAssignable(
Type::fromValue(new Iterator, false)
)
);
}
public function testSomethingThatIsNotIterableCannotBeAssignedToIterable(): void
{
$this->assertFalse(
$this->type->isAssignable(
Type::fromValue(null, false)
)
);
}
}
PK ! 3e tests/unit/SimpleTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Type\SimpleType
*
* @uses \SebastianBergmann\Type\Type
*/
final class SimpleTypeTest extends TestCase
{
public function testCanBeBool(): void
{
$type = new SimpleType('bool', false);
$this->assertSame(': bool', $type->getReturnTypeDeclaration());
}
public function testCanBeBoolean(): void
{
$type = new SimpleType('boolean', false);
$this->assertSame(': bool', $type->getReturnTypeDeclaration());
}
public function testCanBeDouble(): void
{
$type = new SimpleType('double', false);
$this->assertSame(': float', $type->getReturnTypeDeclaration());
}
public function testCanBeFloat(): void
{
$type = new SimpleType('float', false);
$this->assertSame(': float', $type->getReturnTypeDeclaration());
}
public function testCanBeReal(): void
{
$type = new SimpleType('real', false);
$this->assertSame(': float', $type->getReturnTypeDeclaration());
}
public function testCanBeInt(): void
{
$type = new SimpleType('int', false);
$this->assertSame(': int', $type->getReturnTypeDeclaration());
}
public function testCanBeInteger(): void
{
$type = new SimpleType('integer', false);
$this->assertSame(': int', $type->getReturnTypeDeclaration());
}
public function testCanBeArray(): void
{
$type = new SimpleType('array', false);
$this->assertSame(': array', $type->getReturnTypeDeclaration());
}
public function testCanBeArray2(): void
{
$type = new SimpleType('[]', false);
$this->assertSame(': array', $type->getReturnTypeDeclaration());
}
public function testMayAllowNull(): void
{
$type = new SimpleType('bool', true);
$this->assertTrue($type->allowsNull());
$this->assertSame(': ?bool', $type->getReturnTypeDeclaration());
}
public function testMayNotAllowNull(): void
{
$type = new SimpleType('bool', false);
$this->assertFalse($type->allowsNull());
}
/**
* @dataProvider assignablePairs
*/
public function testIsAssignable(Type $assignTo, Type $assignedType): void
{
$this->assertTrue($assignTo->isAssignable($assignedType));
}
public function assignablePairs(): array
{
return [
'nullable to not nullable' => [new SimpleType('int', false), new SimpleType('int', true)],
'not nullable to nullable' => [new SimpleType('int', true), new SimpleType('int', false)],
'nullable to nullable' => [new SimpleType('int', true), new SimpleType('int', true)],
'not nullable to not nullable' => [new SimpleType('int', false), new SimpleType('int', false)],
'null to not nullable' => [new SimpleType('int', true), new NullType],
];
}
/**
* @dataProvider notAssignablePairs
*/
public function testIsNotAssignable(Type $assignTo, Type $assignedType): void
{
$this->assertFalse($assignTo->isAssignable($assignedType));
}
public function notAssignablePairs(): array
{
return [
'null to not nullable' => [new SimpleType('int', false), new NullType],
'int to boolean' => [new SimpleType('boolean', false), new SimpleType('int', false)],
'object' => [new SimpleType('boolean', false), new ObjectType(TypeName::fromQualifiedName(\stdClass::class), true)],
'unknown type' => [new SimpleType('boolean', false), new UnknownType],
'void' => [new SimpleType('boolean', false), new VoidType],
];
}
/**
* @dataProvider returnTypes
*/
public function testReturnTypeDeclaration(Type $type, string $returnType): void
{
$this->assertEquals($type->getReturnTypeDeclaration(), $returnType);
}
public function returnTypes(): array
{
return [
'[]' => [new SimpleType('[]', false), ': array'],
'array' => [new SimpleType('array', false), ': array'],
'?array' => [new SimpleType('array', true), ': ?array'],
'boolean' => [new SimpleType('boolean', false), ': bool'],
'real' => [new SimpleType('real', false), ': float'],
'double' => [new SimpleType('double', false), ': float'],
'integer' => [new SimpleType('integer', false), ': int'],
];
}
public function testCanHaveValue(): void
{
$this->assertSame('string', Type::fromValue('string', false)->value());
}
}
PK ! Z[vAa a $ tests/unit/GenericObjectTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Type\GenericObjectType
*
* @uses \SebastianBergmann\Type\Type
* @uses \SebastianBergmann\Type\ObjectType
* @uses \SebastianBergmann\Type\SimpleType
* @uses \SebastianBergmann\Type\TypeName
*/
final class GenericObjectTypeTest extends TestCase
{
/**
* @var GenericObjectType
*/
private $type;
protected function setUp(): void
{
$this->type = new GenericObjectType(false);
}
public function testMayDisallowNull(): void
{
$this->assertFalse($this->type->allowsNull());
}
public function testCanGenerateReturnTypeDeclaration(): void
{
$this->assertEquals(': object', $this->type->getReturnTypeDeclaration());
}
public function testMayAllowNull(): void
{
$type = new GenericObjectType(true);
$this->assertTrue($type->allowsNull());
}
public function testCanGenerateNullableReturnTypeDeclaration(): void
{
$type = new GenericObjectType(true);
$this->assertEquals(': ?object', $type->getReturnTypeDeclaration());
}
public function testObjectCanBeAssignedToGenericObject(): void
{
$this->assertTrue(
$this->type->isAssignable(
new ObjectType(TypeName::fromQualifiedName(\stdClass::class), false)
)
);
}
public function testNullCanBeAssignedToNullableGenericObject(): void
{
$type = new GenericObjectType(true);
$this->assertTrue(
$type->isAssignable(
new NullType
)
);
}
public function testNonObjectCannotBeAssignedToGenericObject(): void
{
$this->assertFalse(
$this->type->isAssignable(
new SimpleType('bool', false)
)
);
}
}
PK ! 皴 tests/unit/NullTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Type\NullType
*/
final class NullTypeTest extends TestCase
{
/**
* @var NullType
*/
private $type;
protected function setUp(): void
{
$this->type = new NullType;
}
/**
* @dataProvider assignableTypes
*/
public function testIsAssignable(Type $assignableType): void
{
$this->assertTrue($this->type->isAssignable($assignableType));
}
public function assignableTypes(): array
{
return [
[new SimpleType('int', false)],
[new SimpleType('int', true)],
[new ObjectType(TypeName::fromQualifiedName(self::class), false)],
[new ObjectType(TypeName::fromQualifiedName(self::class), true)],
[new UnknownType],
];
}
/**
* @dataProvider notAssignable
*/
public function testIsNotAssignable(Type $assignedType): void
{
$this->assertFalse($this->type->isAssignable($assignedType));
}
public function notAssignable(): array
{
return [
'void' => [new VoidType],
];
}
public function testAllowsNull(): void
{
$this->assertTrue($this->type->allowsNull());
}
public function testCanGenerateReturnTypeDeclaration(): void
{
$this->assertEquals('', $this->type->getReturnTypeDeclaration());
}
}
PK ! '紳d d tests/unit/TypeNameTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Type\TypeName
*/
final class TypeNameTest extends TestCase
{
public function testFromReflection(): void
{
$class = new \ReflectionClass(TypeName::class);
$typeName = TypeName::fromReflection($class);
$this->assertTrue($typeName->isNamespaced());
$this->assertEquals('SebastianBergmann\\Type', $typeName->getNamespaceName());
$this->assertEquals(TypeName::class, $typeName->getQualifiedName());
$this->assertEquals('TypeName', $typeName->getSimpleName());
}
public function testFromQualifiedName(): void
{
$typeName = TypeName::fromQualifiedName('PHPUnit\\Framework\\MockObject\\TypeName');
$this->assertTrue($typeName->isNamespaced());
$this->assertEquals('PHPUnit\\Framework\\MockObject', $typeName->getNamespaceName());
$this->assertEquals('PHPUnit\\Framework\\MockObject\\TypeName', $typeName->getQualifiedName());
$this->assertEquals('TypeName', $typeName->getSimpleName());
}
public function testFromQualifiedNameWithLeadingSeparator(): void
{
$typeName = TypeName::fromQualifiedName('\\Foo\\Bar');
$this->assertTrue($typeName->isNamespaced());
$this->assertEquals('Foo', $typeName->getNamespaceName());
$this->assertEquals('Foo\\Bar', $typeName->getQualifiedName());
$this->assertEquals('Bar', $typeName->getSimpleName());
}
public function testFromQualifiedNameWithoutNamespace(): void
{
$typeName = TypeName::fromQualifiedName('Bar');
$this->assertFalse($typeName->isNamespaced());
$this->assertNull($typeName->getNamespaceName());
$this->assertEquals('Bar', $typeName->getQualifiedName());
$this->assertEquals('Bar', $typeName->getSimpleName());
}
}
PK ! 籽 tests/unit/TypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Type\Type
*
* @uses \SebastianBergmann\Type\SimpleType
* @uses \SebastianBergmann\Type\GenericObjectType
* @uses \SebastianBergmann\Type\ObjectType
* @uses \SebastianBergmann\Type\TypeName
* @uses \SebastianBergmann\Type\CallableType
* @uses \SebastianBergmann\Type\IterableType
*/
final class TypeTest extends TestCase
{
/**
* @dataProvider valuesToNullableType
*/
public function testTypeMappingFromValue($value, bool $allowsNull, Type $expectedType): void
{
$this->assertEquals($expectedType, Type::fromValue($value, $allowsNull));
}
public function valuesToNullableType(): array
{
return [
'?null' => [null, true, new NullType],
'null' => [null, false, new NullType],
'?integer' => [1, true, new SimpleType('int', true, 1)],
'integer' => [1, false, new SimpleType('int', false, 1)],
'?boolean' => [true, true, new SimpleType('bool', true, true)],
'boolean' => [true, false, new SimpleType('bool', false, true)],
'?object' => [new \stdClass, true, new ObjectType(TypeName::fromQualifiedName(\stdClass::class), true)],
'object' => [new \stdClass, false, new ObjectType(TypeName::fromQualifiedName(\stdClass::class), false)],
];
}
/**
* @dataProvider namesToTypes
*/
public function testTypeMappingFromName(string $typeName, bool $allowsNull, $expectedType): void
{
$this->assertEquals($expectedType, Type::fromName($typeName, $allowsNull));
}
public function namesToTypes(): array
{
return [
'?void' => ['void', true, new VoidType],
'void' => ['void', false, new VoidType],
'?null' => ['null', true, new NullType],
'null' => ['null', true, new NullType],
'?int' => ['int', true, new SimpleType('int', true)],
'?integer' => ['integer', true, new SimpleType('int', true)],
'int' => ['int', false, new SimpleType('int', false)],
'bool' => ['bool', false, new SimpleType('bool', false)],
'boolean' => ['boolean', false, new SimpleType('bool', false)],
'object' => ['object', false, new GenericObjectType(false)],
'real' => ['real', false, new SimpleType('float', false)],
'double' => ['double', false, new SimpleType('float', false)],
'float' => ['float', false, new SimpleType('float', false)],
'string' => ['string', false, new SimpleType('string', false)],
'array' => ['array', false, new SimpleType('array', false)],
'resource' => ['resource', false, new SimpleType('resource', false)],
'resource (closed)' => ['resource (closed)', false, new SimpleType('resource (closed)', false)],
'unknown type' => ['unknown type', false, new UnknownType],
'?classname' => [\stdClass::class, true, new ObjectType(TypeName::fromQualifiedName(\stdClass::class), true)],
'classname' => [\stdClass::class, false, new ObjectType(TypeName::fromQualifiedName(\stdClass::class), false)],
'callable' => ['callable', false, new CallableType(false)],
'?callable' => ['callable', true, new CallableType(true)],
'iterable' => ['iterable', false, new IterableType(false)],
'?iterable' => ['iterable', true, new IterableType(true)],
];
}
}
PK !
)2' ' tests/unit/CallableTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
use SebastianBergmann\Type\TestFixture\ClassWithCallbackMethods;
use SebastianBergmann\Type\TestFixture\ClassWithInvokeMethod;
/**
* @covers \SebastianBergmann\Type\CallableType
*
* @uses \SebastianBergmann\Type\Type
* @uses \SebastianBergmann\Type\ObjectType
* @uses \SebastianBergmann\Type\SimpleType
* @uses \SebastianBergmann\Type\TypeName
*/
final class CallableTypeTest extends TestCase
{
/**
* @var CallableType
*/
private $type;
protected function setUp(): void
{
$this->type = new CallableType(false);
}
public function testMayDisallowNull(): void
{
$this->assertFalse($this->type->allowsNull());
}
public function testCanGenerateReturnTypeDeclaration(): void
{
$this->assertEquals(': callable', $this->type->getReturnTypeDeclaration());
}
public function testMayAllowNull(): void
{
$type = new CallableType(true);
$this->assertTrue($type->allowsNull());
}
public function testCanGenerateNullableReturnTypeDeclaration(): void
{
$type = new CallableType(true);
$this->assertEquals(': ?callable', $type->getReturnTypeDeclaration());
}
public function testNullCanBeAssignedToNullableCallable(): void
{
$type = new CallableType(true);
$this->assertTrue($type->isAssignable(new NullType));
}
public function testCallableCanBeAssignedToCallable(): void
{
$this->assertTrue($this->type->isAssignable(new CallableType(false)));
}
public function testClosureCanBeAssignedToCallable(): void
{
$this->assertTrue(
$this->type->isAssignable(
new ObjectType(
TypeName::fromQualifiedName(\Closure::class),
false
)
)
);
}
public function testInvokableCanBeAssignedToCallable(): void
{
$this->assertTrue(
$this->type->isAssignable(
new ObjectType(
TypeName::fromQualifiedName(ClassWithInvokeMethod::class),
false
)
)
);
}
public function testStringWithFunctionNameCanBeAssignedToCallable(): void
{
$this->assertTrue(
$this->type->isAssignable(
Type::fromValue('SebastianBergmann\Type\TestFixture\callback_function', false)
)
);
}
public function testStringWithClassNameAndStaticMethodNameCanBeAssignedToCallable(): void
{
$this->assertTrue(
$this->type->isAssignable(
Type::fromValue(ClassWithCallbackMethods::class . '::staticCallback', false)
)
);
}
public function testArrayWithClassNameAndStaticMethodNameCanBeAssignedToCallable(): void
{
$this->assertTrue(
$this->type->isAssignable(
Type::fromValue([ClassWithCallbackMethods::class, 'staticCallback'], false)
)
);
}
public function testArrayWithClassNameAndInstanceMethodNameCanBeAssignedToCallable(): void
{
$this->assertTrue(
$this->type->isAssignable(
Type::fromValue([new ClassWithCallbackMethods, 'nonStaticCallback'], false)
)
);
}
public function testSomethingThatIsNotCallableCannotBeAssignedToCallable(): void
{
$this->assertFalse(
$this->type->isAssignable(
Type::fromValue(null, false)
)
);
}
public function testObjectWithoutInvokeMethodCannotBeAssignedToCallable(): void
{
$this->assertFalse(
$this->type->isAssignable(
Type::fromValue(new class {
}, false)
)
);
}
}
PK ! 浚, tests/unit/UnknownTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Type\UnknownType
*/
final class UnknownTypeTest extends TestCase
{
/**
* @var UnknownType
*/
private $type;
protected function setUp(): void
{
$this->type = new UnknownType;
}
/**
* @dataProvider assignableTypes
*/
public function testIsAssignable(Type $assignableType): void
{
$this->assertTrue($this->type->isAssignable($assignableType));
}
public function assignableTypes(): array
{
return [
[new SimpleType('int', false)],
[new SimpleType('int', true)],
[new VoidType],
[new ObjectType(TypeName::fromQualifiedName(self::class), false)],
[new ObjectType(TypeName::fromQualifiedName(self::class), true)],
[new UnknownType],
];
}
public function testAllowsNull(): void
{
$this->assertTrue($this->type->allowsNull());
}
public function testReturnTypeDeclaration(): void
{
$this->assertEquals('', $this->type->getReturnTypeDeclaration());
}
}
PK ! u挒綍 tests/unit/VoidTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
/**
* @covers \SebastianBergmann\Type\VoidType
*/
final class VoidTypeTest extends TestCase
{
/**
* @dataProvider assignableTypes
*/
public function testIsAssignable(Type $assignableType): void
{
$type = new VoidType;
$this->assertTrue($type->isAssignable($assignableType));
}
public function assignableTypes(): array
{
return [
[new VoidType],
];
}
/**
* @dataProvider notAssignableTypes
*/
public function testIsNotAssignable(Type $assignableType): void
{
$type = new VoidType;
$this->assertFalse($type->isAssignable($assignableType));
}
public function notAssignableTypes(): array
{
return [
[new SimpleType('int', false)],
[new SimpleType('int', true)],
[new ObjectType(TypeName::fromQualifiedName(self::class), false)],
[new ObjectType(TypeName::fromQualifiedName(self::class), true)],
[new UnknownType],
];
}
public function testNotAllowNull(): void
{
$type = new VoidType;
$this->assertFalse($type->allowsNull());
}
public function testCanGenerateReturnTypeDeclaration(): void
{
$type = new VoidType;
$this->assertEquals(': void', $type->getReturnTypeDeclaration());
}
}
PK ! *琛摳 tests/unit/ObjectTypeTest.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
use PHPUnit\Framework\TestCase;
use SebastianBergmann\Type\TestFixture\ChildClass;
use SebastianBergmann\Type\TestFixture\ParentClass;
/**
* @covers \SebastianBergmann\Type\ObjectType
*
* @uses \SebastianBergmann\Type\TypeName
* @uses \SebastianBergmann\Type\Type
* @uses \SebastianBergmann\Type\SimpleType
*/
final class ObjectTypeTest extends TestCase
{
/**
* @var ObjectType
*/
private $childClass;
/**
* @var ObjectType
*/
private $parentClass;
protected function setUp(): void
{
$this->childClass = new ObjectType(
TypeName::fromQualifiedName(ChildClass::class),
false
);
$this->parentClass = new ObjectType(
TypeName::fromQualifiedName(ParentClass::class),
false
);
}
public function testParentIsNotAssignableToChild(): void
{
$this->assertFalse($this->childClass->isAssignable($this->parentClass));
}
public function testChildIsAssignableToParent(): void
{
$this->assertTrue($this->parentClass->isAssignable($this->childClass));
}
public function testClassIsAssignableToSelf(): void
{
$this->assertTrue($this->parentClass->isAssignable($this->parentClass));
}
public function testSimpleTypeIsNotAssignableToClass(): void
{
$this->assertFalse($this->parentClass->isAssignable(new SimpleType('int', false)));
}
public function testClassFromOneNamespaceIsNotAssignableToClassInOtherNamespace(): void
{
$classFromNamespaceA = new ObjectType(
TypeName::fromQualifiedName(\someNamespaceA\NamespacedClass::class),
false
);
$classFromNamespaceB = new ObjectType(
TypeName::fromQualifiedName(\someNamespaceB\NamespacedClass::class),
false
);
$this->assertFalse($classFromNamespaceA->isAssignable($classFromNamespaceB));
}
public function testClassIsAssignableToSelfCaseInsensitively(): void
{
$classLowercased = new ObjectType(
TypeName::fromQualifiedName(\strtolower(ParentClass::class)),
false
);
$this->assertTrue($this->parentClass->isAssignable($classLowercased));
}
public function testNullIsAssignableToNullableType(): void
{
$someClass = new ObjectType(
TypeName::fromQualifiedName(ParentClass::class),
true
);
$this->assertTrue($someClass->isAssignable(Type::fromValue(null, true)));
}
public function testNullIsNotAssignableToNotNullableType(): void
{
$someClass = new ObjectType(
TypeName::fromQualifiedName(ParentClass::class),
false
);
$this->assertFalse($someClass->isAssignable(Type::fromValue(null, true)));
}
public function testPreservesNullNotAllowed(): void
{
$someClass = new ObjectType(
TypeName::fromQualifiedName(ParentClass::class),
false
);
$this->assertFalse($someClass->allowsNull());
}
public function testPreservesNullAllowed(): void
{
$someClass = new ObjectType(
TypeName::fromQualifiedName(ParentClass::class),
true
);
$this->assertTrue($someClass->allowsNull());
}
public function testCanGenerateReturnTypeDeclaration(): void
{
$this->assertEquals(': SebastianBergmann\Type\TestFixture\ParentClass', $this->parentClass->getReturnTypeDeclaration());
}
public function testHasClassName(): void
{
$this->assertEquals('SebastianBergmann\Type\TestFixture\ParentClass', $this->parentClass->className()->getQualifiedName());
}
}
PK ! 瓌Lu u tests/_fixture/ParentClass.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type\TestFixture;
class ParentClass
{
public function foo(): void
{
}
}
PK ! 櫬N藠 ( tests/_fixture/ClassWithInvokeMethod.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type\TestFixture;
final class ClassWithInvokeMethod
{
public function __invoke(): void
{
}
}
PK ! 8\ \ tests/_fixture/ChildClass.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type\TestFixture;
class ChildClass extends ParentClass
{
}
PK ! 誥!Z Z $ tests/_fixture/callback_function.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type\TestFixture;
function callback_function(): void
{
}
PK ! + tests/_fixture/ClassWithCallbackMethods.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type\TestFixture;
final class ClassWithCallbackMethods
{
public static function staticCallback(): void
{
}
public function nonStaticCallback(): void
{
}
}
PK ! 瓅饔K K tests/_fixture/Iterator.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type\TestFixture;
final class Iterator implements \Iterator
{
public function current(): void
{
}
public function next(): void
{
}
public function key(): void
{
}
public function valid(): void
{
}
public function rewind(): void
{
}
}
PK ! 謣ｄ .travis.ymlnu 刐迭 language: php
php:
- 7.2
- 7.3
- 7.4snapshot
- nightly
matrix:
allow_failures:
- php: master
fast_finish: true
env:
matrix:
- DEPENDENCIES="high"
- DEPENDENCIES="low"
global:
- DEFAULT_COMPOSER_FLAGS="--no-interaction --no-ansi --no-progress --no-suggest"
before_install:
- ./tools/composer clear-cache
install:
- if [[ "$DEPENDENCIES" = 'high' ]]; then travis_retry ./tools/composer update $DEFAULT_COMPOSER_FLAGS; fi
- if [[ "$DEPENDENCIES" = 'low' ]]; then travis_retry ./tools/composer update $DEFAULT_COMPOSER_FLAGS --prefer-lowest; fi
script:
- ./vendor/bin/phpunit --coverage-clover=coverage.xml
after_success:
- bash <(curl -s https://codecov.io/bash)
notifications:
email: false
jobs:
include:
- stage: "Static Code Analysis"
php: 7.3
env: php-cs-fixer
install:
- phpenv config-rm xdebug.ini
script:
- ./tools/php-cs-fixer fix --dry-run -v --show-progress=dots --diff-format=udiff
- stage: "Static Code Analysis"
php: 7.3
env: psalm
install:
- phpenv config-rm xdebug.ini
script:
- travis_retry ./tools/composer update $DEFAULT_COMPOSER_FLAGS
- ./tools/psalm --shepherd --stats
PK ! o匵B .php_cs.distnu 刐迭
For the full copyright and license information, please view the LICENSE
file that was distributed with this source code.
EOF;
return PhpCsFixer\Config::create()
->setRiskyAllowed(true)
->setRules(
[
'align_multiline_comment' => true,
'array_indentation' => true,
'array_syntax' => ['syntax' => 'short'],
'binary_operator_spaces' => [
'operators' => [
'=' => 'align',
'=>' => 'align',
],
],
'blank_line_after_namespace' => true,
'blank_line_before_statement' => [
'statements' => [
'break',
'continue',
'declare',
'do',
'for',
'foreach',
'if',
'include',
'include_once',
'require',
'require_once',
'return',
'switch',
'throw',
'try',
'while',
'yield',
],
],
'braces' => true,
'cast_spaces' => true,
'class_attributes_separation' => ['elements' => ['const', 'method', 'property']],
'combine_consecutive_issets' => true,
'combine_consecutive_unsets' => true,
'compact_nullable_typehint' => true,
'concat_space' => ['spacing' => 'one'],
'declare_equal_normalize' => ['space' => 'none'],
'declare_strict_types' => true,
'dir_constant' => true,
'elseif' => true,
'encoding' => true,
'full_opening_tag' => true,
'function_declaration' => true,
'header_comment' => ['header' => $header, 'separate' => 'none'],
'indentation_type' => true,
'is_null' => true,
'line_ending' => true,
'list_syntax' => ['syntax' => 'short'],
'logical_operators' => true,
'lowercase_cast' => true,
'lowercase_constants' => true,
'lowercase_keywords' => true,
'lowercase_static_reference' => true,
'magic_constant_casing' => true,
'method_argument_space' => ['ensure_fully_multiline' => true],
'modernize_types_casting' => true,
'multiline_comment_opening_closing' => true,
'multiline_whitespace_before_semicolons' => true,
'native_constant_invocation' => true,
'native_function_casing' => true,
'native_function_invocation' => true,
'new_with_braces' => false,
'no_alias_functions' => true,
'no_alternative_syntax' => true,
'no_blank_lines_after_class_opening' => true,
'no_blank_lines_after_phpdoc' => true,
'no_blank_lines_before_namespace' => true,
'no_closing_tag' => true,
'no_empty_comment' => true,
'no_empty_phpdoc' => true,
'no_empty_statement' => true,
'no_extra_blank_lines' => true,
'no_homoglyph_names' => true,
'no_leading_import_slash' => true,
'no_leading_namespace_whitespace' => true,
'no_mixed_echo_print' => ['use' => 'print'],
'no_multiline_whitespace_around_double_arrow' => true,
'no_null_property_initialization' => true,
'no_php4_constructor' => true,
'no_short_bool_cast' => true,
'no_short_echo_tag' => true,
'no_singleline_whitespace_before_semicolons' => true,
'no_spaces_after_function_name' => true,
'no_spaces_inside_parenthesis' => true,
'no_superfluous_elseif' => true,
'no_superfluous_phpdoc_tags' => true,
'no_trailing_comma_in_list_call' => true,
'no_trailing_comma_in_singleline_array' => true,
'no_trailing_whitespace' => true,
'no_trailing_whitespace_in_comment' => true,
'no_unneeded_control_parentheses' => true,
'no_unneeded_curly_braces' => true,
'no_unneeded_final_method' => true,
'no_unreachable_default_argument_value' => true,
'no_unset_on_property' => true,
'no_unused_imports' => true,
'no_useless_else' => true,
'no_useless_return' => true,
'no_whitespace_before_comma_in_array' => true,
'no_whitespace_in_blank_line' => true,
'non_printable_character' => true,
'normalize_index_brace' => true,
'object_operator_without_whitespace' => true,
'ordered_class_elements' => [
'order' => [
'use_trait',
'constant_public',
'constant_protected',
'constant_private',
'property_public_static',
'property_protected_static',
'property_private_static',
'property_public',
'property_protected',
'property_private',
'method_public_static',
'construct',
'destruct',
'magic',
'phpunit',
'method_public',
'method_protected',
'method_private',
'method_protected_static',
'method_private_static',
],
],
'ordered_imports' => true,
'ordered_interfaces' => [
'direction' => 'ascend',
'order' => 'alpha',
],
'phpdoc_add_missing_param_annotation' => true,
'phpdoc_align' => true,
'phpdoc_annotation_without_dot' => true,
'phpdoc_indent' => true,
'phpdoc_no_access' => true,
'phpdoc_no_empty_return' => true,
'phpdoc_no_package' => true,
'phpdoc_order' => true,
'phpdoc_return_self_reference' => true,
'phpdoc_scalar' => true,
'phpdoc_separation' => true,
'phpdoc_single_line_var_spacing' => true,
'phpdoc_to_comment' => true,
'phpdoc_trim' => true,
'phpdoc_trim_consecutive_blank_line_separation' => true,
'phpdoc_types' => ['groups' => ['simple', 'meta']],
'phpdoc_types_order' => true,
'phpdoc_var_without_name' => true,
'pow_to_exponentiation' => true,
'protected_to_private' => true,
'return_assignment' => true,
'return_type_declaration' => ['space_before' => 'none'],
'semicolon_after_instruction' => true,
'set_type_to_cast' => true,
'short_scalar_cast' => true,
'simplified_null_return' => true,
'single_blank_line_at_eof' => true,
'single_import_per_statement' => true,
'single_line_after_imports' => true,
'single_quote' => true,
'standardize_not_equals' => true,
'ternary_to_null_coalescing' => true,
'trailing_comma_in_multiline_array' => true,
'trim_array_spaces' => true,
'unary_operator_spaces' => true,
'visibility_required' => [
'elements' => [
'const',
'method',
'property',
],
],
'void_return' => true,
'whitespace_after_comma_in_array' => true,
]
)
->setFinder(
PhpCsFixer\Finder::create()
->files()
->in(__DIR__ . '/src')
->in(__DIR__ . '/tests')
);
PK ! 蝒伙c c
composer.jsonnu 刐迭 {
"name": "sebastian/type",
"description": "Collection of value objects that represent the types of the PHP type system",
"type": "library",
"homepage": "https://github.com/sebastianbergmann/type",
"license": "BSD-3-Clause",
"authors": [
{
"name": "Sebastian Bergmann",
"email": "sebastian@phpunit.de",
"role": "lead"
}
],
"support": {
"issues": "https://github.com/sebastianbergmann/type/issues"
},
"prefer-stable": true,
"require": {
"php": "^7.2"
},
"require-dev": {
"phpunit/phpunit": "^8.2"
},
"config": {
"platform": {
"php": "7.2.0"
},
"optimize-autoloader": true,
"sort-packages": true
},
"autoload": {
"classmap": [
"src/"
]
},
"autoload-dev": {
"classmap": [
"tests/_fixture"
],
"files": [
"tests/_fixture/callback_function.php"
]
},
"extra": {
"branch-alias": {
"dev-master": "1.1-dev"
}
}
}
PK ! 1酳) .github/FUNDING.ymlnu 刐迭 patreon: s_bergmann
PK ! W/40 0 ChangeLog.mdnu 刐迭 # ChangeLog
All notable changes are documented in this file using the [Keep a CHANGELOG](http://keepachangelog.com/) principles.
## [1.1.3] - 2019-07-02
### Fixed
* Fixed class name comparison in `ObjectType` to be case insensitive
## [1.1.2] - 2019-06-19
### Fixed
* Fixed handling of `object` type
## [1.1.1] - 2019-06-08
### Fixed
* Fixed autoloading of `callback_function.php` fixture file
## [1.1.0] - 2019-06-07
### Added
* Added support for `callable` type
* Added support for `iterable` type
## [1.0.0] - 2019-06-06
* Initial release based on [code contributed by Michel Hartmann to PHPUnit](https://github.com/sebastianbergmann/phpunit/pull/3673)
[1.1.3]: https://github.com/sebastianbergmann/type/compare/1.1.2...1.1.3
[1.1.2]: https://github.com/sebastianbergmann/type/compare/1.1.1...1.1.2
[1.1.1]: https://github.com/sebastianbergmann/type/compare/1.1.0...1.1.1
[1.1.0]: https://github.com/sebastianbergmann/type/compare/1.0.0...1.1.0
[1.0.0]: https://github.com/sebastianbergmann/type/compare/ff74aa41746bd8d10e931843ebf37d42da513ede...1.0.0
PK ! 蜰> src/TypeName.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class TypeName
{
/**
* @var ?string
*/
private $namespaceName;
/**
* @var string
*/
private $simpleName;
public static function fromQualifiedName(string $fullClassName): self
{
if ($fullClassName[0] === '\\') {
$fullClassName = \substr($fullClassName, 1);
}
$classNameParts = \explode('\\', $fullClassName);
$simpleName = \array_pop($classNameParts);
$namespaceName = \implode('\\', $classNameParts);
return new self($namespaceName, $simpleName);
}
public static function fromReflection(\ReflectionClass $type): self
{
return new self(
$type->getNamespaceName(),
$type->getShortName()
);
}
public function __construct(?string $namespaceName, string $simpleName)
{
if ($namespaceName === '') {
$namespaceName = null;
}
$this->namespaceName = $namespaceName;
$this->simpleName = $simpleName;
}
public function getNamespaceName(): ?string
{
return $this->namespaceName;
}
public function getSimpleName(): string
{
return $this->simpleName;
}
public function getQualifiedName(): string
{
return $this->namespaceName === null
? $this->simpleName
: $this->namespaceName . '\\' . $this->simpleName;
}
public function isNamespaced(): bool
{
return $this->namespaceName !== null;
}
}
PK ! )T[ [ src/VoidType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class VoidType extends Type
{
public function isAssignable(Type $other): bool
{
return $other instanceof self;
}
public function getReturnTypeDeclaration(): string
{
return ': void';
}
public function allowsNull(): bool
{
return false;
}
}
PK ! 彻璹Q Q src/IterableType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class IterableType extends Type
{
/**
* @var bool
*/
private $allowsNull;
public function __construct(bool $nullable)
{
$this->allowsNull = $nullable;
}
/**
* @throws RuntimeException
*/
public function isAssignable(Type $other): bool
{
if ($this->allowsNull && $other instanceof NullType) {
return true;
}
if ($other instanceof self) {
return true;
}
if ($other instanceof SimpleType) {
return \is_iterable($other->value());
}
if ($other instanceof ObjectType) {
try {
return (new \ReflectionClass($other->className()->getQualifiedName()))->isIterable();
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
(int) $e->getCode(),
$e
);
// @codeCoverageIgnoreEnd
}
}
return false;
}
public function getReturnTypeDeclaration(): string
{
return ': ' . ($this->allowsNull ? '?' : '') . 'iterable';
}
public function allowsNull(): bool
{
return $this->allowsNull;
}
}
PK ! 9誳闧 [ src/NullType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class NullType extends Type
{
public function isAssignable(Type $other): bool
{
return !($other instanceof VoidType);
}
public function getReturnTypeDeclaration(): string
{
return '';
}
public function allowsNull(): bool
{
return true;
}
}
PK ! 艠1咤 src/ObjectType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class ObjectType extends Type
{
/**
* @var TypeName
*/
private $className;
/**
* @var bool
*/
private $allowsNull;
public function __construct(TypeName $className, bool $allowsNull)
{
$this->className = $className;
$this->allowsNull = $allowsNull;
}
public function isAssignable(Type $other): bool
{
if ($this->allowsNull && $other instanceof NullType) {
return true;
}
if ($other instanceof self) {
if (0 === \strcasecmp($this->className->getQualifiedName(), $other->className->getQualifiedName())) {
return true;
}
if (\is_subclass_of($other->className->getQualifiedName(), $this->className->getQualifiedName(), true)) {
return true;
}
}
return false;
}
public function getReturnTypeDeclaration(): string
{
return ': ' . ($this->allowsNull ? '?' : '') . $this->className->getQualifiedName();
}
public function allowsNull(): bool
{
return $this->allowsNull;
}
public function className(): TypeName
{
return $this->className;
}
}
PK ! 螉]練 src/CallableType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class CallableType extends Type
{
/**
* @var bool
*/
private $allowsNull;
public function __construct(bool $nullable)
{
$this->allowsNull = $nullable;
}
/**
* @throws RuntimeException
*/
public function isAssignable(Type $other): bool
{
if ($this->allowsNull && $other instanceof NullType) {
return true;
}
if ($other instanceof self) {
return true;
}
if ($other instanceof ObjectType) {
if ($this->isClosure($other)) {
return true;
}
if ($this->hasInvokeMethod($other)) {
return true;
}
}
if ($other instanceof SimpleType) {
if ($this->isFunction($other)) {
return true;
}
if ($this->isClassCallback($other)) {
return true;
}
if ($this->isObjectCallback($other)) {
return true;
}
}
return false;
}
public function getReturnTypeDeclaration(): string
{
return ': ' . ($this->allowsNull ? '?' : '') . 'callable';
}
public function allowsNull(): bool
{
return $this->allowsNull;
}
private function isClosure(ObjectType $type): bool
{
return !$type->className()->isNamespaced() && $type->className()->getSimpleName() === \Closure::class;
}
/**
* @throws RuntimeException
*/
private function hasInvokeMethod(ObjectType $type): bool
{
try {
$class = new \ReflectionClass($type->className()->getQualifiedName());
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
(int) $e->getCode(),
$e
);
// @codeCoverageIgnoreEnd
}
if ($class->hasMethod('__invoke')) {
return true;
}
return false;
}
private function isFunction(SimpleType $type): bool
{
if (!\is_string($type->value())) {
return false;
}
return \function_exists($type->value());
}
private function isObjectCallback(SimpleType $type): bool
{
if (!\is_array($type->value())) {
return false;
}
if (\count($type->value()) !== 2) {
return false;
}
if (!\is_object($type->value()[0]) || !\is_string($type->value()[1])) {
return false;
}
[$object, $methodName] = $type->value();
$reflector = new \ReflectionObject($object);
return $reflector->hasMethod($methodName);
}
private function isClassCallback(SimpleType $type): bool
{
if (!\is_string($type->value()) && !\is_array($type->value())) {
return false;
}
if (\is_string($type->value())) {
if (\strpos($type->value(), '::') === false) {
return false;
}
[$className, $methodName] = \explode('::', $type->value());
}
if (\is_array($type->value())) {
if (\count($type->value()) !== 2) {
return false;
}
if (!\is_string($type->value()[0]) || !\is_string($type->value()[1])) {
return false;
}
[$className, $methodName] = $type->value();
}
\assert(isset($className) && \is_string($className));
\assert(isset($methodName) && \is_string($methodName));
try {
$class = new \ReflectionClass($className);
if ($class->hasMethod($methodName)) {
$method = $class->getMethod($methodName);
return $method->isPublic() && $method->isStatic();
}
// @codeCoverageIgnoreStart
} catch (\ReflectionException $e) {
throw new RuntimeException(
$e->getMessage(),
(int) $e->getCode(),
$e
);
// @codeCoverageIgnoreEnd
}
return false;
}
}
PK ! k5 src/Type.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
abstract class Type
{
public static function fromValue($value, bool $allowsNull): self
{
$typeName = \gettype($value);
if ($typeName === 'object') {
return new ObjectType(TypeName::fromQualifiedName(\get_class($value)), $allowsNull);
}
$type = self::fromName($typeName, $allowsNull);
if ($type instanceof SimpleType) {
$type = new SimpleType($typeName, $allowsNull, $value);
}
return $type;
}
public static function fromName(string $typeName, bool $allowsNull): self
{
switch (\strtolower($typeName)) {
case 'callable':
return new CallableType($allowsNull);
case 'iterable':
return new IterableType($allowsNull);
case 'null':
return new NullType;
case 'object':
return new GenericObjectType($allowsNull);
case 'unknown type':
return new UnknownType;
case 'void':
return new VoidType;
case 'array':
case 'bool':
case 'boolean':
case 'double':
case 'float':
case 'int':
case 'integer':
case 'real':
case 'resource':
case 'resource (closed)':
case 'string':
return new SimpleType($typeName, $allowsNull);
default:
return new ObjectType(TypeName::fromQualifiedName($typeName), $allowsNull);
}
}
abstract public function isAssignable(Type $other): bool;
abstract public function getReturnTypeDeclaration(): string;
abstract public function allowsNull(): bool;
}
PK ! 56媴w w " src/exception/RuntimeException.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class RuntimeException extends \RuntimeException implements Exception
{
}
PK ! Pm{? ? src/exception/Exception.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
interface Exception
{
}
PK ! src/GenericObjectType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class GenericObjectType extends Type
{
/**
* @var bool
*/
private $allowsNull;
public function __construct(bool $nullable)
{
$this->allowsNull = $nullable;
}
public function isAssignable(Type $other): bool
{
if ($this->allowsNull && $other instanceof NullType) {
return true;
}
if (!$other instanceof ObjectType) {
return false;
}
return true;
}
public function getReturnTypeDeclaration(): string
{
return ': ' . ($this->allowsNull ? '?' : '') . 'object';
}
public function allowsNull(): bool
{
return $this->allowsNull;
}
}
PK ! 猾E E src/UnknownType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class UnknownType extends Type
{
public function isAssignable(Type $other): bool
{
return true;
}
public function getReturnTypeDeclaration(): string
{
return '';
}
public function allowsNull(): bool
{
return true;
}
}
PK ! g src/SimpleType.phpnu 刐迭
*
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
*/
namespace SebastianBergmann\Type;
final class SimpleType extends Type
{
/**
* @var string
*/
private $name;
/**
* @var bool
*/
private $allowsNull;
/**
* @var mixed
*/
private $value;
public function __construct(string $name, bool $nullable, $value = null)
{
$this->name = $this->normalize($name);
$this->allowsNull = $nullable;
$this->value = $value;
}
public function isAssignable(Type $other): bool
{
if ($this->allowsNull && $other instanceof NullType) {
return true;
}
if ($other instanceof self) {
return $this->name === $other->name;
}
return false;
}
public function getReturnTypeDeclaration(): string
{
return ': ' . ($this->allowsNull ? '?' : '') . $this->name;
}
public function allowsNull(): bool
{
return $this->allowsNull;
}
public function value()
{
return $this->value;
}
private function normalize(string $name): string
{
$name = \strtolower($name);
switch ($name) {
case 'boolean':
return 'bool';
case 'real':
case 'double':
return 'float';
case 'integer':
return 'int';
case '[]':
return 'array';
default:
return $name;
}
}
}
PK ! 罨 psalm.xmlnu 刐迭
PK ! 鳘霉 build.xmlnu 刐迭
PK ! 拿e9 .gitattributesnu 刐迭 /tools export-ignore
PK ! 婰馅
.gitignorenu 刐迭 /.php_cs
/.php_cs.cache
/.phpunit.result.cache
/composer.lock
/vendor
# Covers JetBrains IDEs: IntelliJ, RubyMine, PhpStorm, AppCode, PyCharm, CLion, Android Studio and WebStorm
# Reference: https://intellij-support.jetbrains.com/hc/en-us/articles/206544839
# User-specific stuff
.idea/**/workspace.xml
.idea/**/tasks.xml
.idea/**/usage.statistics.xml
.idea/**/dictionaries
.idea/**/shelf
# Generated files
.idea/**/contentModel.xml
# Sensitive or high-churn files
.idea/**/dataSources/
.idea/**/dataSources.ids
.idea/**/dataSources.local.xml
.idea/**/sqlDataSources.xml
.idea/**/dynamic.xml
.idea/**/uiDesigner.xml
.idea/**/dbnavigator.xml
# Gradle
.idea/**/gradle.xml
.idea/**/libraries
# Gradle and Maven with auto-import
# When using Gradle or Maven with auto-import, you should exclude module files,
# since they will be recreated, and may cause churn. Uncomment if using
# auto-import.
# .idea/modules.xml
# .idea/*.iml
# .idea/modules
# CMake
cmake-build-*/
# Mongo Explorer plugin
.idea/**/mongoSettings.xml
# File-based project format
*.iws
# IntelliJ
out/
# mpeltonen/sbt-idea plugin
.idea_modules/
# JIRA plugin
atlassian-ide-plugin.xml
# Cursive Clojure plugin
.idea/replstate.xml
# Crashlytics plugin (for Android Studio and IntelliJ)
com_crashlytics_export_strings.xml
crashlytics.properties
crashlytics-build.properties
fabric.properties
# Editor-based Rest Client
.idea/httpRequests
# Android studio 3.1+ serialized cache file
.idea/caches/build_file_checksums.ser
PK ! 惀|x error.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
from pyasn1.error import PyAsn1Error
class ValueConstraintError(PyAsn1Error):
pass
PK ! 縚 錄U 沀
constraint.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
# Original concept and code by Mike C. Fletcher.
#
import sys
from pyasn1.type import error
__all__ = ['SingleValueConstraint', 'ContainedSubtypeConstraint',
'ValueRangeConstraint', 'ValueSizeConstraint',
'PermittedAlphabetConstraint', 'InnerTypeConstraint',
'ConstraintsExclusion', 'ConstraintsIntersection',
'ConstraintsUnion']
class AbstractConstraint(object):
def __init__(self, *values):
self._valueMap = set()
self._setValues(values)
self.__hash = hash((self.__class__.__name__, self._values))
def __call__(self, value, idx=None):
if not self._values:
return
try:
self._testValue(value, idx)
except error.ValueConstraintError as exc:
raise error.ValueConstraintError(
'%s failed at: %r' % (self, exc)
)
def __repr__(self):
representation = '%s object' % (self.__class__.__name__)
if self._values:
representation += ', consts %s' % ', '.join(
[repr(x) for x in self._values])
return '<%s>' % representation
def __eq__(self, other):
if self is other:
return True
return self._values == other
def __ne__(self, other):
return self._values != other
def __lt__(self, other):
return self._values < other
def __le__(self, other):
return self._values <= other
def __gt__(self, other):
return self._values > other
def __ge__(self, other):
return self._values >= other
def __bool__(self):
return bool(self._values)
def __hash__(self):
return self.__hash
def _setValues(self, values):
self._values = values
def _testValue(self, value, idx):
raise error.ValueConstraintError(value)
# Constraints derivation logic
def getValueMap(self):
return self._valueMap
def isSuperTypeOf(self, otherConstraint):
# TODO: fix possible comparison of set vs scalars here
return (otherConstraint is self or
not self._values or
otherConstraint == self or
self in otherConstraint.getValueMap())
def isSubTypeOf(self, otherConstraint):
return (otherConstraint is self or
not self or
otherConstraint == self or
otherConstraint in self._valueMap)
class SingleValueConstraint(AbstractConstraint):
"""Create a SingleValueConstraint object.
The SingleValueConstraint satisfies any value that
is present in the set of permitted values.
Objects of this type are iterable (emitting constraint values) and
can act as operands for some arithmetic operations e.g. addition
and subtraction. The latter can be used for combining multiple
SingleValueConstraint objects into one.
The SingleValueConstraint object can be applied to
any ASN.1 type.
Parameters
----------
*values: :class:`int`
Full set of values permitted by this constraint object.
Examples
--------
.. code-block:: python
class DivisorOfSix(Integer):
'''
ASN.1 specification:
Divisor-Of-6 ::= INTEGER (1 | 2 | 3 | 6)
'''
subtypeSpec = SingleValueConstraint(1, 2, 3, 6)
# this will succeed
divisor_of_six = DivisorOfSix(1)
# this will raise ValueConstraintError
divisor_of_six = DivisorOfSix(7)
"""
def _setValues(self, values):
self._values = values
self._set = set(values)
def _testValue(self, value, idx):
if value not in self._set:
raise error.ValueConstraintError(value)
# Constrains can be merged or reduced
def __contains__(self, item):
return item in self._set
def __iter__(self):
return iter(self._set)
def __add__(self, constraint):
return self.__class__(*(self._set.union(constraint)))
def __sub__(self, constraint):
return self.__class__(*(self._set.difference(constraint)))
class ContainedSubtypeConstraint(AbstractConstraint):
"""Create a ContainedSubtypeConstraint object.
The ContainedSubtypeConstraint satisfies any value that
is present in the set of permitted values and also
satisfies included constraints.
The ContainedSubtypeConstraint object can be applied to
any ASN.1 type.
Parameters
----------
*values:
Full set of values and constraint objects permitted
by this constraint object.
Examples
--------
.. code-block:: python
class DivisorOfEighteen(Integer):
'''
ASN.1 specification:
Divisors-of-18 ::= INTEGER (INCLUDES Divisors-of-6 | 9 | 18)
'''
subtypeSpec = ContainedSubtypeConstraint(
SingleValueConstraint(1, 2, 3, 6), 9, 18
)
# this will succeed
divisor_of_eighteen = DivisorOfEighteen(9)
# this will raise ValueConstraintError
divisor_of_eighteen = DivisorOfEighteen(10)
"""
def _testValue(self, value, idx):
for constraint in self._values:
if isinstance(constraint, AbstractConstraint):
constraint(value, idx)
elif value not in self._set:
raise error.ValueConstraintError(value)
class ValueRangeConstraint(AbstractConstraint):
"""Create a ValueRangeConstraint object.
The ValueRangeConstraint satisfies any value that
falls in the range of permitted values.
The ValueRangeConstraint object can only be applied
to :class:`~pyasn1.type.univ.Integer` and
:class:`~pyasn1.type.univ.Real` types.
Parameters
----------
start: :class:`int`
Minimum permitted value in the range (inclusive)
end: :class:`int`
Maximum permitted value in the range (inclusive)
Examples
--------
.. code-block:: python
class TeenAgeYears(Integer):
'''
ASN.1 specification:
TeenAgeYears ::= INTEGER (13 .. 19)
'''
subtypeSpec = ValueRangeConstraint(13, 19)
# this will succeed
teen_year = TeenAgeYears(18)
# this will raise ValueConstraintError
teen_year = TeenAgeYears(20)
"""
def _testValue(self, value, idx):
if value < self.start or value > self.stop:
raise error.ValueConstraintError(value)
def _setValues(self, values):
if len(values) != 2:
raise error.PyAsn1Error(
'%s: bad constraint values' % (self.__class__.__name__,)
)
self.start, self.stop = values
if self.start > self.stop:
raise error.PyAsn1Error(
'%s: screwed constraint values (start > stop): %s > %s' % (
self.__class__.__name__,
self.start, self.stop
)
)
AbstractConstraint._setValues(self, values)
class ValueSizeConstraint(ValueRangeConstraint):
"""Create a ValueSizeConstraint object.
The ValueSizeConstraint satisfies any value for
as long as its size falls within the range of
permitted sizes.
The ValueSizeConstraint object can be applied
to :class:`~pyasn1.type.univ.BitString`,
:class:`~pyasn1.type.univ.OctetString` (including
all :ref:`character ASN.1 types `),
:class:`~pyasn1.type.univ.SequenceOf`
and :class:`~pyasn1.type.univ.SetOf` types.
Parameters
----------
minimum: :class:`int`
Minimum permitted size of the value (inclusive)
maximum: :class:`int`
Maximum permitted size of the value (inclusive)
Examples
--------
.. code-block:: python
class BaseballTeamRoster(SetOf):
'''
ASN.1 specification:
BaseballTeamRoster ::= SET SIZE (1..25) OF PlayerNames
'''
componentType = PlayerNames()
subtypeSpec = ValueSizeConstraint(1, 25)
# this will succeed
team = BaseballTeamRoster()
team.extend(['Jan', 'Matej'])
encode(team)
# this will raise ValueConstraintError
team = BaseballTeamRoster()
team.extend(['Jan'] * 26)
encode(team)
Note
----
Whenever ValueSizeConstraint is applied to mutable types
(e.g. :class:`~pyasn1.type.univ.SequenceOf`,
:class:`~pyasn1.type.univ.SetOf`), constraint
validation only happens at the serialisation phase rather
than schema instantiation phase (as it is with immutable
types).
"""
def _testValue(self, value, idx):
valueSize = len(value)
if valueSize < self.start or valueSize > self.stop:
raise error.ValueConstraintError(value)
class PermittedAlphabetConstraint(SingleValueConstraint):
"""Create a PermittedAlphabetConstraint object.
The PermittedAlphabetConstraint satisfies any character
string for as long as all its characters are present in
the set of permitted characters.
Objects of this type are iterable (emitting constraint values) and
can act as operands for some arithmetic operations e.g. addition
and subtraction.
The PermittedAlphabetConstraint object can only be applied
to the :ref:`character ASN.1 types ` such as
:class:`~pyasn1.type.char.IA5String`.
Parameters
----------
*alphabet: :class:`str`
Full set of characters permitted by this constraint object.
Example
-------
.. code-block:: python
class BooleanValue(IA5String):
'''
ASN.1 specification:
BooleanValue ::= IA5String (FROM ('T' | 'F'))
'''
subtypeSpec = PermittedAlphabetConstraint('T', 'F')
# this will succeed
truth = BooleanValue('T')
truth = BooleanValue('TF')
# this will raise ValueConstraintError
garbage = BooleanValue('TAF')
ASN.1 `FROM ... EXCEPT ...` clause can be modelled by combining multiple
PermittedAlphabetConstraint objects into one:
Example
-------
.. code-block:: python
class Lipogramme(IA5String):
'''
ASN.1 specification:
Lipogramme ::=
IA5String (FROM (ALL EXCEPT ("e"|"E")))
'''
subtypeSpec = (
PermittedAlphabetConstraint(*string.printable) -
PermittedAlphabetConstraint('e', 'E')
)
# this will succeed
lipogramme = Lipogramme('A work of fiction?')
# this will raise ValueConstraintError
lipogramme = Lipogramme('Eel')
Note
----
Although `ConstraintsExclusion` object could seemingly be used for this
purpose, practically, for it to work, it needs to represent its operand
constraints as sets and intersect one with the other. That would require
the insight into the constraint values (and their types) that are otherwise
hidden inside the constraint object.
Therefore it's more practical to model `EXCEPT` clause at
`PermittedAlphabetConstraint` level instead.
"""
def _setValues(self, values):
self._values = values
self._set = set(values)
def _testValue(self, value, idx):
if not self._set.issuperset(value):
raise error.ValueConstraintError(value)
class ComponentPresentConstraint(AbstractConstraint):
"""Create a ComponentPresentConstraint object.
The ComponentPresentConstraint is only satisfied when the value
is not `None`.
The ComponentPresentConstraint object is typically used with
`WithComponentsConstraint`.
Examples
--------
.. code-block:: python
present = ComponentPresentConstraint()
# this will succeed
present('whatever')
# this will raise ValueConstraintError
present(None)
"""
def _setValues(self, values):
self._values = ('',)
if values:
raise error.PyAsn1Error('No arguments expected')
def _testValue(self, value, idx):
if value is None:
raise error.ValueConstraintError(
'Component is not present:')
class ComponentAbsentConstraint(AbstractConstraint):
"""Create a ComponentAbsentConstraint object.
The ComponentAbsentConstraint is only satisfied when the value
is `None`.
The ComponentAbsentConstraint object is typically used with
`WithComponentsConstraint`.
Examples
--------
.. code-block:: python
absent = ComponentAbsentConstraint()
# this will succeed
absent(None)
# this will raise ValueConstraintError
absent('whatever')
"""
def _setValues(self, values):
self._values = ('',)
if values:
raise error.PyAsn1Error('No arguments expected')
def _testValue(self, value, idx):
if value is not None:
raise error.ValueConstraintError(
'Component is not absent: %r' % value)
class WithComponentsConstraint(AbstractConstraint):
"""Create a WithComponentsConstraint object.
The `WithComponentsConstraint` satisfies any mapping object that has
constrained fields present or absent, what is indicated by
`ComponentPresentConstraint` and `ComponentAbsentConstraint`
objects respectively.
The `WithComponentsConstraint` object is typically applied
to :class:`~pyasn1.type.univ.Set` or
:class:`~pyasn1.type.univ.Sequence` types.
Parameters
----------
*fields: :class:`tuple`
Zero or more tuples of (`field`, `constraint`) indicating constrained
fields.
Notes
-----
On top of the primary use of `WithComponentsConstraint` (ensuring presence
or absence of particular components of a :class:`~pyasn1.type.univ.Set` or
:class:`~pyasn1.type.univ.Sequence`), it is also possible to pass any other
constraint objects or their combinations. In case of scalar fields, these
constraints will be verified in addition to the constraints belonging to
scalar components themselves. However, formally, these additional
constraints do not change the type of these ASN.1 objects.
Examples
--------
.. code-block:: python
class Item(Sequence): # Set is similar
'''
ASN.1 specification:
Item ::= SEQUENCE {
id INTEGER OPTIONAL,
name OCTET STRING OPTIONAL
} WITH COMPONENTS id PRESENT, name ABSENT | id ABSENT, name PRESENT
'''
componentType = NamedTypes(
OptionalNamedType('id', Integer()),
OptionalNamedType('name', OctetString())
)
withComponents = ConstraintsUnion(
WithComponentsConstraint(
('id', ComponentPresentConstraint()),
('name', ComponentAbsentConstraint())
),
WithComponentsConstraint(
('id', ComponentAbsentConstraint()),
('name', ComponentPresentConstraint())
)
)
item = Item()
# This will succeed
item['id'] = 1
# This will succeed
item.reset()
item['name'] = 'John'
# This will fail (on encoding)
item.reset()
descr['id'] = 1
descr['name'] = 'John'
"""
def _testValue(self, value, idx):
for field, constraint in self._values:
constraint(value.get(field))
def _setValues(self, values):
AbstractConstraint._setValues(self, values)
# This is a bit kludgy, meaning two op modes within a single constraint
class InnerTypeConstraint(AbstractConstraint):
"""Value must satisfy the type and presence constraints"""
def _testValue(self, value, idx):
if self.__singleTypeConstraint:
self.__singleTypeConstraint(value)
elif self.__multipleTypeConstraint:
if idx not in self.__multipleTypeConstraint:
raise error.ValueConstraintError(value)
constraint, status = self.__multipleTypeConstraint[idx]
if status == 'ABSENT': # XXX presence is not checked!
raise error.ValueConstraintError(value)
constraint(value)
def _setValues(self, values):
self.__multipleTypeConstraint = {}
self.__singleTypeConstraint = None
for v in values:
if isinstance(v, tuple):
self.__multipleTypeConstraint[v[0]] = v[1], v[2]
else:
self.__singleTypeConstraint = v
AbstractConstraint._setValues(self, values)
# Logic operations on constraints
class ConstraintsExclusion(AbstractConstraint):
"""Create a ConstraintsExclusion logic operator object.
The ConstraintsExclusion logic operator succeeds when the
value does *not* satisfy the operand constraint.
The ConstraintsExclusion object can be applied to
any constraint and logic operator object.
Parameters
----------
*constraints:
Constraint or logic operator objects.
Examples
--------
.. code-block:: python
class LuckyNumber(Integer):
subtypeSpec = ConstraintsExclusion(
SingleValueConstraint(13)
)
# this will succeed
luckyNumber = LuckyNumber(12)
# this will raise ValueConstraintError
luckyNumber = LuckyNumber(13)
Note
----
The `FROM ... EXCEPT ...` ASN.1 clause should be modeled by combining
constraint objects into one. See `PermittedAlphabetConstraint` for more
information.
"""
def _testValue(self, value, idx):
for constraint in self._values:
try:
constraint(value, idx)
except error.ValueConstraintError:
continue
raise error.ValueConstraintError(value)
def _setValues(self, values):
AbstractConstraint._setValues(self, values)
class AbstractConstraintSet(AbstractConstraint):
def __getitem__(self, idx):
return self._values[idx]
def __iter__(self):
return iter(self._values)
def __add__(self, value):
return self.__class__(*(self._values + (value,)))
def __radd__(self, value):
return self.__class__(*((value,) + self._values))
def __len__(self):
return len(self._values)
# Constraints inclusion in sets
def _setValues(self, values):
self._values = values
for constraint in values:
if constraint:
self._valueMap.add(constraint)
self._valueMap.update(constraint.getValueMap())
class ConstraintsIntersection(AbstractConstraintSet):
"""Create a ConstraintsIntersection logic operator object.
The ConstraintsIntersection logic operator only succeeds
if *all* its operands succeed.
The ConstraintsIntersection object can be applied to
any constraint and logic operator objects.
The ConstraintsIntersection object duck-types the immutable
container object like Python :py:class:`tuple`.
Parameters
----------
*constraints:
Constraint or logic operator objects.
Examples
--------
.. code-block:: python
class CapitalAndSmall(IA5String):
'''
ASN.1 specification:
CapitalAndSmall ::=
IA5String (FROM ("A".."Z"|"a".."z"))
'''
subtypeSpec = ConstraintsIntersection(
PermittedAlphabetConstraint('A', 'Z'),
PermittedAlphabetConstraint('a', 'z')
)
# this will succeed
capital_and_small = CapitalAndSmall('Hello')
# this will raise ValueConstraintError
capital_and_small = CapitalAndSmall('hello')
"""
def _testValue(self, value, idx):
for constraint in self._values:
constraint(value, idx)
class ConstraintsUnion(AbstractConstraintSet):
"""Create a ConstraintsUnion logic operator object.
The ConstraintsUnion logic operator succeeds if
*at least* a single operand succeeds.
The ConstraintsUnion object can be applied to
any constraint and logic operator objects.
The ConstraintsUnion object duck-types the immutable
container object like Python :py:class:`tuple`.
Parameters
----------
*constraints:
Constraint or logic operator objects.
Examples
--------
.. code-block:: python
class CapitalOrSmall(IA5String):
'''
ASN.1 specification:
CapitalOrSmall ::=
IA5String (FROM ("A".."Z") | FROM ("a".."z"))
'''
subtypeSpec = ConstraintsUnion(
PermittedAlphabetConstraint('A', 'Z'),
PermittedAlphabetConstraint('a', 'z')
)
# this will succeed
capital_or_small = CapitalAndSmall('Hello')
# this will raise ValueConstraintError
capital_or_small = CapitalOrSmall('hello!')
"""
def _testValue(self, value, idx):
for constraint in self._values:
try:
constraint(value, idx)
except error.ValueConstraintError:
pass
else:
return
raise error.ValueConstraintError(
'all of %s failed for "%s"' % (self._values, value)
)
# TODO:
# refactor InnerTypeConstraint
# add tests for type check
# implement other constraint types
# make constraint validation easy to skip
PK ! 窬舕 tagmap.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
from pyasn1 import error
__all__ = ['TagMap']
class TagMap(object):
"""Map *TagSet* objects to ASN.1 types
Create an object mapping *TagSet* object to ASN.1 type.
*TagMap* objects are immutable and duck-type read-only Python
:class:`dict` objects holding *TagSet* objects as keys and ASN.1
type objects as values.
Parameters
----------
presentTypes: :py:class:`dict`
Map of :class:`~pyasn1.type.tag.TagSet` to ASN.1 objects considered
as being unconditionally present in the *TagMap*.
skipTypes: :py:class:`dict`
A collection of :class:`~pyasn1.type.tag.TagSet` objects considered
as absent in the *TagMap* even when *defaultType* is present.
defaultType: ASN.1 type object
An ASN.1 type object callee *TagMap* returns for any *TagSet* key not present
in *presentTypes* (unless given key is present in *skipTypes*).
"""
def __init__(self, presentTypes=None, skipTypes=None, defaultType=None):
self.__presentTypes = presentTypes or {}
self.__skipTypes = skipTypes or {}
self.__defaultType = defaultType
def __contains__(self, tagSet):
return (tagSet in self.__presentTypes or
self.__defaultType is not None and tagSet not in self.__skipTypes)
def __getitem__(self, tagSet):
try:
return self.__presentTypes[tagSet]
except KeyError:
if self.__defaultType is None:
raise
elif tagSet in self.__skipTypes:
raise error.PyAsn1Error('Key in negative map')
else:
return self.__defaultType
def __iter__(self):
return iter(self.__presentTypes)
def __repr__(self):
representation = '%s object' % self.__class__.__name__
if self.__presentTypes:
representation += ', present %s' % repr(self.__presentTypes)
if self.__skipTypes:
representation += ', skip %s' % repr(self.__skipTypes)
if self.__defaultType is not None:
representation += ', default %s' % repr(self.__defaultType)
return '<%s>' % representation
@property
def presentTypes(self):
"""Return *TagSet* to ASN.1 type map present in callee *TagMap*"""
return self.__presentTypes
@property
def skipTypes(self):
"""Return *TagSet* collection unconditionally absent in callee *TagMap*"""
return self.__skipTypes
@property
def defaultType(self):
"""Return default ASN.1 type being returned for any missing *TagSet*"""
return self.__defaultType
# Backward compatibility
def getPosMap(self):
return self.presentTypes
def getNegMap(self):
return self.skipTypes
def getDef(self):
return self.defaultType
PK ! 鮏繲- - opentype.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
__all__ = ['OpenType']
class OpenType(object):
"""Create ASN.1 type map indexed by a value
The *OpenType* object models an untyped field of a constructed ASN.1
type. In ASN.1 syntax it is usually represented by the
`ANY DEFINED BY` for scalars or `SET OF ANY DEFINED BY`,
`SEQUENCE OF ANY DEFINED BY` for container types clauses. Typically
used together with :class:`~pyasn1.type.univ.Any` object.
OpenType objects duck-type a read-only Python :class:`dict` objects,
however the passed `typeMap` is not copied, but stored by reference.
That means the user can manipulate `typeMap` at run time having this
reflected on *OpenType* object behavior.
The |OpenType| class models an untyped field of a constructed ASN.1
type. In ASN.1 syntax it is usually represented by the
`ANY DEFINED BY` for scalars or `SET OF ANY DEFINED BY`,
`SEQUENCE OF ANY DEFINED BY` for container types clauses. Typically
used with :class:`~pyasn1.type.univ.Any` type.
Parameters
----------
name: :py:class:`str`
Field name
typeMap: :py:class:`dict`
A map of value->ASN.1 type. It's stored by reference and can be
mutated later to register new mappings.
Examples
--------
For untyped scalars:
.. code-block:: python
openType = OpenType(
'id', {1: Integer(),
2: OctetString()}
)
Sequence(
componentType=NamedTypes(
NamedType('id', Integer()),
NamedType('blob', Any(), openType=openType)
)
)
For untyped `SET OF` or `SEQUENCE OF` vectors:
.. code-block:: python
openType = OpenType(
'id', {1: Integer(),
2: OctetString()}
)
Sequence(
componentType=NamedTypes(
NamedType('id', Integer()),
NamedType('blob', SetOf(componentType=Any()),
openType=openType)
)
)
"""
def __init__(self, name, typeMap=None):
self.__name = name
if typeMap is None:
self.__typeMap = {}
else:
self.__typeMap = typeMap
@property
def name(self):
return self.__name
# Python dict protocol
def values(self):
return self.__typeMap.values()
def keys(self):
return self.__typeMap.keys()
def items(self):
return self.__typeMap.items()
def __contains__(self, key):
return key in self.__typeMap
def __getitem__(self, key):
return self.__typeMap[key]
def __iter__(self):
return iter(self.__typeMap)
PK ! 捧钮 " __pycache__/useful.cpython-311.pycnu 刐迭
辤 篝 d dl Z d dlmZ d dlmZ d dlmZ d dlmZ g dZej Zej Z G d dej
Z G d d
e Z
G d d ej e
Z G d
dej e
ZdS ) N)error)char)tag)univ)ObjectDescriptorGeneralizedTimeUTCTimec 笫 e Zd Zej j Zej j ej ej
ej d Zej Z
dS )r N)__name__
__module__ __qualname__r
GraphicString__doc__tagSet
tagImplicitlyr TagtagClassUniversaltagFormatSimple getTypeIdtypeId 鷕/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/useful.pyr r se (G
&
4
4%爏':窤>> F
)
)
+
+FFFr r c 髣 e Zd ZdZdZdZdZ G d dej Z e Z
e d Z e
d ZdS ) TimeMixIn Fc , e Zd ZdZd dZd Zd Zd ZdS )
TimeMixIn.FixedOffsetz&Fixed offset in minutes east from UTC.r UTCc 驢 t j | | _ || _ d S )N)minutes)datetime timedelta_FixedOffset__offset_FixedOffset__name)selfoffsetnames r __init__z TimeMixIn.FixedOffset.__init__, s" $ .皏 > > >圖孧 圖孠圞圞r c | j S N)r% r' dts r utcoffsetz TimeMixIn.FixedOffset.utcoffset0 s
= r c | j S r, )r& r- s r tznamez TimeMixIn.FixedOffset.tzname3 s
; r c * t j d S )Nr )r# r$ r- s r dstzTimeMixIn.FixedOffset.dst6 s %燼(( (r N)r r )r r
r r r* r/ r1 r3 r r r FixedOffsetr ' s[ 44 ! ! ! ) ) ) ) )r r4 c 箨 t | }| d rt j }|dd }n d|v sd|v r d|v r| d \ }}}n| d \ }}}| j rt
| dk r|dz
}t
| dk rt j d |z t |dd d
z t |dd z }|dk r|dz }n%# t $ r t j d | z w xY wt |d }nd}d
|v sd|v rpd
|v r| d
\ }}}n| d \ }}} t | dz }n'# t $ r t j d| z w xY wd}| j r!t
| | j
z
dk r|dz
}n t
| | j
z
dk r|dz
} t j || j
dk rdpd }n%# t $ r t j d| z w xY w| || S )z稢reate :py:class:`datetime.datetime` object from a |ASN.1| object.
Returns
-------
:
new instance of :py:class:`datetime.datetime` object
ZN-+ 00r z malformed time zone offset %s< z unknown time specification %s?.,殍 z$bad sub-second time specification %sr 0000 %Y%m%d%H%M%S %y%m%d%H%M%Sz malformed datetime format %s) microsecondtzinfo)strendswithr r partition_shortTZlenr PyAsn1Errorint
ValueErrorr4 _optionalMinutes _yearsDigitsr# strptimereplace) r' textrG plusminustzr" _msr. s r
asDateTimezTimeMixIn.asDateTime; s 4墆寉 == 擼團9圖塂
怐圼圼楥4楰橩恉坽坽&*癝&9&9#恑&*癝&9&9#恑寎
燫ˋ 恉
2墂寃!妡坾'(G"(LMMM
P 榖!渇++*璖癆癇癇琜8 ##榬慚怗
P
P
P'(G$(NOOO
P **7癈88團團 團 $;;#++恉坽坽 "焠歯⊿ 1 1 恆 "焠歯⊿ 1 1 恆
W慦擶榯慯
W
W
W'(N蠶U(UVVV
W 圔 1B%B繿%G%G 怓塏圖圖
塝孻*
*╝
/
/ 怐塋圖 K"++―$2C纐2H2[萟2m衉mnn圔圔 K K K#$B繲$IJJ J K 弞妟燽坺888s$ =D "D'F "F= -H9 9"Ic 2 | | j dk rdpd }| j r|d|j dz z z
}| r;| j }|dk r|dz
}n|dz
}|d |d
z |d
z fz z
}n|d z
} | | S ) aU Create |ASN.1| object from a :py:class:`datetime.datetime` object.
Parameters
----------
dt: :py:class:`datetime.datetime` object
The `datetime.datetime` object to initialize the |ASN.1| object
from
Returns
-------
:
new instance of |ASN.1| value
r rD rE z.%dr@ r r8 r9 z%.2d%.2di r6 )strftimerQ
_hasSubsecondrF r/ seconds)clsr. rT r] s r fromDateTimezTimeMixIn.fromDateTime~ s 弡妠3+╭0C癪U纞VV 5 怑楻淾╰ 34 4圖
<<>> 條抣憂攏,圙妠坽 怞'═/7窽>!BB B圖圖 怌塊圖坰4墆寉r N)r r
r rQ r\ rP rK r# rG r4 r propertyrY classmethodr_ r r r r r s LM H) ) ) ) )恏攐 ) ) )$ +--C
@9 @9 刋@9餌 刐 r r c 筅 e Zd Zej j Zej j ej ej
ej d Zej
ZdZdZdZdZdS )r r TNr r
r r
VisibleStringr r r r r r r VideotexStringr r rQ r\ rP rK r r r r r sz (G
&
4
4%爏':窧?? F
*
*
,
,FLMHHHr r c 筅 e Zd Zej j Zej j ej ej
ej d Zej
ZdZdZdZdZdS )r r: FNrd r r r r r sz (G
&
4
4%爏':窧?? F
*
*
,
,FLM HHHr r )r# pyasn1r pyasn1.typer r r __all__NoValuenoValuer r objectr re r r r r r ro s9
<
<
<
,
, , , , , ,恡) , , ,{ { { { { { { {饇 恉() " 坉 ) r PK ! 'Κ& & __pycache__/univ.cpython-311.pycnu 刐迭
辤湭 篝 d dl Z d dlZd dlmZ d dlmZ d dlmZ d dlm Z d dlm
Z
d dlm Z d dlm Z d d lm
Z
d d
lmZ e j Z e Zg d Z G d d
e j Z G d de Z G d de Z G d de j Z G d de j Z G d de Z G d de j Z G d de j Z G d d e j Z G d d e Z G d d!e j Z G d" d#e Z G d$ d%e Z! G d& d'e j Z" G d( d)e" Z# G d* d+e" Z$ G d, d-e$ Z% G d. d/e Z&dS )0 N)error)eoo)integer)base)
constraint) namedtype)namedval)tag)tagmap)IntegerBoolean BitString OctetStringNullObjectIdentifierReal
EnumeratedSequenceOfAndSetOfBase
SequenceOfSetOfSequenceAndSetBaseSequenceSetChoiceAnyNoValuenoValuec e Zd ZdZ ej ej ej ej d Z e
j Z e
j Zej ZefdZd Zd Zd Zd Zd Zd Zd
Z d Z d Z d
Z d Z d Z!d Z"d Z#d Z$d Z%d2dZ&d Z'd Z(d Z)d Z*d Z+d Z,d Z-ej j. Z.d Z/d Z0d Z1d Z2d! Z3d" Z4d# Z5d3d%Z6d& Z7d' Z8d( Z9d) Z:d* Z;d+ Zd. Z?d/ Z@d0 ZAd1 ZBdS )4r a Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal or |ASN.1| class
instance. If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class ErrorCode(Integer):
'''
ASN.1 specification:
ErrorCode ::=
INTEGER { disk-full(1), no-disk(-1),
disk-not-formatted(2) }
error ErrorCode ::= disk-full
'''
namedValues = NamedValues(
('disk-full', 1), ('no-disk', -1),
('disk-not-formatted', 2)
)
error = ErrorCode('disk-full')
c 驲 d|vr
| j |d< t j j | |fi | d S )N namedValues)r! r SimpleAsn1Type__init__selfvaluekwargss 鷓/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/univ.pyr# zInteger.__init__e s> & &$($4團= ! $燭5;;癋;;;;; c < | | j |z S Nclone_valuer% r& s r( __and__zInteger.__and__k 弞妟$+-...r) c < | || j z S r+ r, r/ s r( __rand__zInteger.__rand__n 弞妟%$+-...r) c < | | j |z S r+ r, r/ s r( __or__zInteger.__or__q r1 r) c < | || j z S r+ r, r/ s r( __ror__zInteger.__ror__t r4 r) c < | | j |z S r+ r, r/ s r( __xor__zInteger.__xor__w r1 r) c < | || j z S r+ r, r/ s r( __rxor__zInteger.__rxor__z r4 r) c < | | j |z S r+ r, r/ s r(
__lshift__zInteger.__lshift__} 弞妟$+.///r) c < | | j |z S r+ r, r/ s r(
__rshift__zInteger.__rshift__ r? r) c < | | j |z S r+ r, r/ s r( __add__zInteger.__add__ r1 r) c < | || j z S r+ r, r/ s r( __radd__zInteger.__radd__ r4 r) c < | | j |z
S r+ r, r/ s r( __sub__zInteger.__sub__ r1 r) c < | || j z
S r+ r, r/ s r( __rsub__zInteger.__rsub__ r4 r) c < | | j |z S r+ r, r/ s r( __mul__zInteger.__mul__ r1 r) c < | || j z S r+ r, r/ s r( __rmul__zInteger.__rmul__ r4 r) c < | | j |z S r+ r, r/ s r( __mod__zInteger.__mod__ r1 r) c < | || j z S r+ r, r/ s r( __rmod__zInteger.__rmod__ r4 r) Nc 骉 | t | j || S r+ r- powr. r% r& modulos r( __pow__zInteger.__pow__ s" 弞妟#榙渒5&99:::r) c 驲 | t || j S r+ rS r/ s r( __rpow__zInteger.__rpow__ s 弞妟#榚燭11222r) c < | | j |z S r+ r, r/ s r( __floordiv__zInteger.__floordiv__ r? r) c < | || j z S r+ r, r/ s r(
__rfloordiv__zInteger.__rfloordiv__ s 弞妟%4;.///r) c 0 t | j |z S r+ r r. r/ s r( __truediv__zInteger.__truediv__ s 怐擪%'(((r) c 0 t || j z S r+ r_ r/ s r( __rtruediv__zInteger.__rtruediv__ s 怑楧淜'(((r) c 驲 | t | j | S r+ r- divmodr. r/ s r(
__divmod__zInteger.__divmod__ s 弞妟&╡44555r) c 驲 | t || j S r+ rd r/ s r( __rdivmod__zInteger.__rdivmod__ s 弞妟& 44555r) c * t | j S r+ intr. r% s r( __int__zInteger.__int__ 4; r) c * t | j S r+ floatr. rl s r( __float__zInteger.__float__ 怲擺!!!r) c 驪 | t | j S r+ )r- absr. rl s r( __abs__zInteger.__abs__ s 弞妟#榙渒**+++r) c * t | j S r+ rj rl s r( __index__zInteger.__index__ rn r) c 8 | | j
S r+ r, rl s r( __pos__zInteger.__pos__ 弞妟4;,'''r) c 8 | | j S r+ r, rl s r( __neg__zInteger.__neg__ r{ r) c 8 | | j S r+ r, rl s r(
__invert__zInteger.__invert__ r{ r) r c 骬 t | j | }|r| | S |S r+ )roundr. r- r% nrs r( __round__zInteger.__round__ s0 $+榪 ! ! ::榓== 圚r) c 4 t j | j S r+ )mathfloorr. rl s r( __floor__zInteger.__floor__ s 寊$+&&&r) c 4 t j | j S r+ )r ceilr. rl s r( __ceil__zInteger.__ceil__ s 寉%%%r) c 骦 | t j | j S r+ )r- r truncr. rl s r( __trunc__zInteger.__trunc__ s 弞妟$*燭11222r) c | j |k S r+ r. r/ s r( __lt__zInteger.__lt__ 寋楿""r) c | j |k S r+ r r/ s r( __le__zInteger.__le__ 寋榚##r) c | j |k S r+ r r/ s r( __eq__zInteger.__eq__ r r) c | j |k S r+ r r/ s r( __ne__zInteger.__ne__ r r) c | j |k S r+ r r/ s r( __gt__zInteger.__gt__ r r) c | j |k S r+ r r/ s r( __ge__zInteger.__ge__ r r) c 蠖 t | S # t $ r= | j | cY S # t $ r }t j d|d| d }~ww xY ww xY w)Nz
Can't coerce z into integer: )rk
ValueErrorr! KeyErrorr PyAsn1Errorr% r& excs r( prettyInzInteger.prettyIn s
恥::
'....
'';@##F
鴖(
A +A
AAAAc 髒 t | j | S # t $ r t | cY S w xY wr+ )strr! r r/ s r( prettyOutzInteger.prettyOut sJ 恡'.// / 恥:: 鴖 88c | j S r+ r! rl s r( getNamedValueszInteger.getNamedValues s r) r+ r )C__name__
__module__ __qualname____doc__r
initTagSetTagtagClassUniversaltagFormatSimpletagSetr ConstraintsIntersection subtypeSpecr NamedValuesr! r r" getTypeIdtypeIdr r# r0 r3 r6 r8 r: r< r> rA rC rE rG rI rK rM rO rQ rW rY r[ r] r` rb rf rh __hash__rm rr rv rx rz r} r r r r r r r r r r r r r r r) r( r r sI 0 0餳 圫宆%爏':窪AA F 5*466K '(&((K
*
*
,
,F $ < < < < / / // / // / // / // / // / /0 0 00 0 0/ / // / // / // / // / // / // / // / /; ; ; ;3 3 30 0 00 0 0) ) )) ) )6 6 66 6 6 "+H " " ", , , ( ( (( ( (( ( ( ' ' '& & &3 3 3# # #$ $ $$ $ $$ $ $# # #$ $ $ r) r c 筲 e Zd ZdZ ej ej ej ej d Z e
j e j
dd z Z ej dd Ze
ZdS )r
ad Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal or |ASN.1| class
instance. If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s).Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class RoundResult(Boolean):
'''
ASN.1 specification:
RoundResult ::= BOOLEAN
ok RoundResult ::= TRUE
ko RoundResult ::= FALSE
'''
ok = RoundResult(True)
ko = RoundResult(False)
r )Falser )Truer N)r r r r r
r r r r r r r r SingleValueConstraintr r r! r r r r) r( r
r
s * *餦 圫宆%爏':窪AA F %(H
(H華(N(NNK '(&爘癧AAK
FFFr) r
c " e Zd ZdxZZd Zd ZdS ) SizedIntegerNc 骽 || _ t || z
d | _ | S Nr ) bitLengthmax
bit_lengthleadingZeroBits)r% r s r( setBitLengthzSizedInteger.setBitLengthI s/ " "9╰/@/@#@! D D r) c 髄 | j '| | | j S r+ )r r r rl s r( __len__zSizedInteger.__len__N s0 > ! 榙無歰 / / 0 0 0寏 r) )r r r r r r r r r) r( r r F s< "&&I
r) r c 缶 e Zd ZdZ ej ej ej ej d Z e
j Z e
j Zej ZexZZefdZd Zd Zd Zd Zd 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)d Z*d Z+d Z,d Z-d Z.e/d"d Z0e/d"d Z1e/d#d Z2d! Z3d S )$r a Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type both Python :class:`tuple` (as a tuple
of bits) and :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal representing binary
or hexadecimal number or sequence of integer bits or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
binValue: :py:class:`str`
Binary string initializer to use instead of the *value*.
Example: '10110011'.
hexValue: :py:class:`str`
Hexadecimal string initializer to use instead of the *value*.
Example: 'DEADBEEF'.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Rights(BitString):
'''
ASN.1 specification:
Rights ::= BIT STRING { user-read(0), user-write(1),
group-read(2), group-write(3),
other-read(4), other-write(5) }
group1 Rights ::= { group-read, group-write }
group2 Rights ::= '0011'B
group3 Rights ::= '3'H
'''
namedValues = NamedValues(
('user-read', 0), ('user-write', 1),
('group-read', 2), ('group-write', 3),
('other-read', 4), ('other-write', 5)
)
group1 = Rights(('group-read', 'group-write'))
group2 = Rights('0011')
group3 = Rights(0x3)
c |t u rz|rx | | d d }n# t $ r Y nw xY w | | d d }n# t $ r Y nw xY w|t u rU| j t ur | | j d }n*| j t ur | | j d }d|vr
| j |d< t j j
| |fi | d S )NbinValueTinternalFormathexValuer! ) r fromBinaryStringpopr
fromHexStringdefaultBinValuedefaultHexValuer! r r" r# r$ s r( r# zBitString.__init__ sL 旼
1 1&**竄2H2H衁] 1 ^ ^怑怑 怐 . .╲痾獄*/E/E蠽Z . [ [怑怑 怐 旼 #722 --╠.B蠸W-XX%璚44 **4+?蠵T*UU & &$($4團= ! $燭5;;癋;;;;;s! *8
AA *A4 4
B Bc * | S r+ )asBinaryrl s r( __str__zBitString.__str__ s 弣妢 r) c 髷 | | }| |u p/| j |k o$t | j t | k S r+ r r. lenr% others r( r zBitString.__eq__ sD
榚$$恥坿W ╱ 4 W窽糩9I9I蚐蠶V蒢蘘9WWr) c 髮 | | }| j |k p$t | j t | k S r+ r r s r( r zBitString.__ne__ s:
榚$$寋榚#E4;'7'73竨::'EEr) c 笾 | | }t | j t | k p/t | j t | k o
| j |k S r+ r r r. r s r( r zBitString.__lt__ 骔
榚$$4; #爀**,f癉碖0@0@臗罦腏0N0f蠸W許^衋f襍ffr) c 笾 | | }t | j t | k p/t | j t | k o
| j |k S r+ r r s r( r zBitString.__le__ 骔
榚$$4; 3爑::-h癟碵1A1A臩罿腪1O1h蠺X訲_衏h襎hhr) c 笾 | | }t | j t | k p/t | j t | k o
| j |k S r+ r r s r( r zBitString.__gt__ r r) c 笾 | | }t | j t | k p/t | j t | k o
| j |k S r+ r r s r( r zBitString.__ge__ r r) c * t | j S r+ r r. rl s r( r zBitString.__len__ rn r) c
4 |j t u rH fdt | t D S t j dz
}||k s|dk rt d j ||z
z dz S )Nc g | ]
}| S r r ).0xr% s r(
z)BitString.__getitem__.. s 鴢 M M M1榯燗渨 M M Mr) r r zbit index out of range) __class__slicer- rangeindicesr r.
IndexError)r% ilengths ` r( __getitem__zBitString.__getitem__ s 鴢 ;% :: M M M M皅穣瞴繲7K7K0L M M MNN N%%)團6妟坺楺歎楿 !9:::擪燜≦/14 4r) c # 骹 K t | j }|r|dz }| j |z dz V |d S d S Nr r )r% r s r( __iter__zBitString.__iter__ s\ 怲擺!! . 恆塊團;&(ˋ- - - - . . . . .r) c : t t | S r+ )reversedtuplerl s r( __reversed__zBitString.__reversed__ s 榙 $$$r) c
| | }| t | j t | z |z t | j t | z S r+ )r r- r r. r r r/ s r( rC zBitString.__add__ si
榚$$弞妟,爐礳%眏磈'@5'HIIVV誛Z衃_訹f裌g訵g誮m衝s裫t詊t裌tuuvvvr) c | | }| t |t | j z | j z t | j t | z S r+ )r r- r r r. r r/ s r( rE zBitString.__radd__ sm
榚$$弞妟,爑癉碖0@0@'@4;'NOO\\誡`衋e詀l裖m註m誴s衪y裵z詐z裖z{{|||r) c 鬄 | j }|dk r,|t | j z }|| j z }|dz }|dk ,| | S r )r. r r- )r% r& bitStrings r( rK zBitString.__mul__ sZ 擪 恆奿坕 #榙渒** *圛 $圛 怮塉圗 恆奿坕 弞妟)$$$r) c | |z S r+ r r/ s r( rM zBitString.__rmul__ 恊墊r) c 螃 | t | j |z t | j |z S r+ )r- r r. r r r% counts r( r> zBitString.__lshift__ sA 弞妟,爐癳';<<II#萪蘫袹Z訨Z衇b袹bccdddr) c
舐 | t | j |z t dt | j |z
S r )r- r r. r r r r s r( rA zBitString.__rshift__ sN 弞妟,爐癳';<<II#萢誕T蠻Y訳`裃a訯a衐i裃i袹j訨jkklllr) c * t | j S r+ rj rl s r( rm zBitString.__int__ rn r) c * t | j S r+ rp rl s r( rr zBitString.__float__ rs r) c 驞 t | S )zet |ASN.1| value as a sequence of 8-bit integers.
If |ASN.1| object length is not a multiple of 8, result
will be left-padded with zeros.
)r asOctetsrl s r( asNumberszBitString.asNumbers s 怲梋抅慱擾%%%r) c 驲 t j | j t | S )z淕et |ASN.1| value as a sequence of octets.
If |ASN.1| object length is not a multiple of 8, result
will be left-padded with zeros.
)r )r to_bytesr. r rl s r( r zBitString.asOctets s" 礐盜碔>>>>r) c | j S )z5Get |ASN.1| value as a single integer value.
r rl s r( asIntegerzBitString.asInteger( s 寋r) c 髱 t | j dd }dt | j t | z
z |z S )z4Get |ASN.1| value as a text string of bits.
r N0)binr. r )r% binStrings r( r zBitString.asBinary- sA $$燪燫燫( 昪$+&&╕ 789DDr) FNc 蟋 t |d t | dz }n0# t $ r#}t j | j d| d}~ww xY w|乢t t | t | z |z t | t | z }|s | | }|S )Create a |ASN.1| object initialized from the hex string.
Parameters
----------
value: :class:`str`
Text string like 'DEADBEEF'
z.fromHexString() error: Nr r r r r r r clsr& r prependr s r( r zBitString.fromHexString3 s Z ++88窾繿 HH圗圗 Z Z Z#纁膌纋纋蠺W蠺W$XYY Y Z 榞&&#╡**4= 妉3榳<<#╡**455
怌慗擩圗 s 36
A# A A#c 螵 t |pdd t | }n0# t $ r#}t j | j d| d}~ww xY w|乢t t | t | z |z t | t | z }|s | | }|S )Create a |ASN.1| object initialized from a string of '0' and '1'.
Parameters
----------
value: :class:`str`
Text string like '1010111'
r r z.fromBinaryString() error: Nr r s r( r zBitString.fromBinaryStringL s ] #╭11>>絪5箊紌JJ圗圗 ] ] ]# 蠾Z蠾Z$[\\ \ ] 榞&&#╡**4= 妉3榳<<#╡**455
怌慗擩圗 s 25
A" A A"r c 鬄 t t t | d |z t | dz |z
}|乢t t | t | z |z t | t | z }|s | | }|S )z獵reate a |ASN.1| object initialized from a string.
Parameters
----------
value: :class:`bytes`
Text string like b'\\x01\\xff'
big )r rk
from_bytesbytesr r )r r& r r paddings r( fromOctetStringzBitString.fromOctetStringe s 漇焇歗璄%㎜琇% @ @繥 KLLYY語]衈c裐d訸d術h裐h衚r裐rss 榞&&#╡**4= 妉3榳<<#╡**455
怌慗擩圗 r) c 蟥 t |t r|S t |t r諀s"t d d S |d dk rq|dd dk r |dd d S |dd dk r |dd d S t
j d | j r畖 s歞
|
d D } fd |D }n%# t $ r t
j d
| w xY wt | }d}|D ]
}|d||z
z z }t | |dz S |
d r |dd d S |
d r |dd d S |d S t |t t f r4 d d |D d S t |t" r/t | t% | S t |t& rt | S t
j d|d )Nr '辋z'Br Tr z'Hz Bad BIT STRING value notation c 6 g | ]}| S r )stripr r s r( r z&BitString.prettyIn.. s ===爍===r) ,c * g | ]}j | S r r )r namer% s r( r z&BitString.prettyIn.. s! 鴢 #M#M#M竧燚$4癟$:#M#M#Mr) zunknown bit name(s) in 0xr 0b c g | ]}|rd pd S )1r r )r bs r( r z&BitString.prettyIn.. s! 1R1R1R纐!)2B竤1R1R1Rr) z Bad BitString initializer type ')
isinstancer r r r r r r r! isdigitsplitr r
startswithr listjoinr r rk )r% r& names bitPositionsrightmostPositionnumber bitPositions ` r( r zBitString.prettyInz s) 鴢 恊漒 * * 7 圠
漵
#
# 5 &
I#燗33癆666恞楾!!:&& 00皅皌萒0RRR𩒁3擹5(( --╡癆癰癉琸$-OOO ++>C竐E !
I%--//
I==‥疜狵,<,<===T#M#M#M#M纔#M#M#M怢怢 T T T ++,RSSST %( $5$5!#/ E E怟榓$5 $C DD怓怓#燜++889J萉9NOOO!!$''
I))%)繢)III!!$''
I,,║2琘纓,LLL ,,║4,HHH
榼
-
- ((1R1R菶1R1R1R)S)S衐h(ii i
漼
)
) &&33礐盝碕?? ?
漵
#
# && & ##;@B
s D "D<)FN)FNr )4r 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 r r r r r r r rC rE rK rM r> rA rm rr r
r r r classmethodr r r& r r r) r( r r U s > >餌 圫宆%爏':窪AA F 5*466K '(&((K
*
*
,
,F(//O恛 $ < < < <6 X X XF F Fg g gi i ig g gi i i 5 5 5. . . % % %
w w w} } }% % % e e em m m " " "& & &? ? ?
E E E 刐0 刐0 刐(8 8 8 8 8r) r c 骹 e Zd ZdZ ej ej ej ej d Z e
j Z e
j ZexZZdZefdZd Zd Zd Zd Zd Zd
Zdd Z e d
Z e d Z d Z d Z!d Z"d Z#d Z$d Z%d Z&d Z'd Z(d Z)d Z*dS ) r a Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type :class:`bytes`.
When used in Unicode context, |ASN.1| type
assumes "|encoding|" serialisation.
Keyword Args
------------
value: :class:`unicode`, :class:`str`, :class:`bytes` or |ASN.1| object
:class:`bytes`, alternatively :class:`str`
representing character string to be serialised into octets
(note `encoding` parameter) or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
encoding: :py:class:`str`
Unicode codec ID to encode/decode
:class:`str` the payload when |ASN.1| object is used
in text string context.
binValue: :py:class:`str`
Binary string initializer to use instead of the *value*.
Example: '10110011'.
hexValue: :py:class:`str`
Hexadecimal string initializer to use instead of the *value*.
Example: 'DEADBEEF'.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Icon(OctetString):
'''
ASN.1 specification:
Icon ::= OCTET STRING
icon1 Icon ::= '001100010011001000110011'B
icon2 Icon ::= '313233'H
'''
icon1 = Icon.fromBinaryString('001100010011001000110011')
icon2 = Icon.fromHexString('313233')
r z
iso-8859-1c |r}|t u rt | | d }n# t $ r Y nw xY w | | d }n# t $ r Y nw xY w|t u rQ| j t ur| | j }n(| j t ur| | j }d|vr
| j |d< t j j
| |fi | d S )Nr r encoding) r r r r r r r rD r r" r# r$ s r( r# zOctetString.__init__ s3 1 1&**竄2H2H I I怑怑 怐 . .╲痾獄*/E/E F F怑怑 怐 旼 #722 --╠.BCC%璚44 **4+?@@ 榁 # #!% 團: $燭5;;癋;;;;;s! (6
AA(A0 0
A=<A=c 骦 t |t r|S t |t rN | | j S # t
$ r&}t
j d|d| j d| d }~ww xY wt |t r| S t |t j r"| t | S t |t t f r"| t | S t | S )NzCan't encode string '' with 'z' codec)r6 r$ r encoderD UnicodeEncodeErrorr PyAsn1UnicodeEncodeErrorr r r r" r r r: r s r( r zOctetString.prettyIn s 恊漊 # # 圠
漵
#
#
梶抾燚222%
44 $榰榰燿爉爉569
漿
+
+
>>## #
漷 2
3
3 ==燯,, ,
榼
-
- ==爑 .. . << s A
A8!A33A8c
筇 | j | j S # t $ r8}t j d| j d| j d| j j d| d }~ww xY w)NzCan't decode string 'rF z ' codec at 'r( )r. decoderD UnicodeDecodeErrorr PyAsn1UnicodeDecodeErrorr r )r% r s r( r zOctetString.__str__5 s} ;%%燿44 4! 00 +++爐爙爙 淣 3 3 3569
鴖 !
A#3A A#c * t | j S r+ r$ r. rl s r( __bytes__zOctetString.__bytes__@ rs r) c * t | j S r+ rO rl s r( r zOctetString.asOctetsC rs r) c * t | j S r+ )r r. rl s r( r
zOctetString.asNumbersF rs r) c |S r+ r r/ s r( r zOctetString.prettyOut[ s r) r c | | j }|| j ur|S | }|D ]2}|dk s|dk r$dd d |D z c S 3t | S )N 閪 r0 r2 c 3 K | ] }d |z V
dS )z%.2xNr r, s r( z*OctetString.prettyPrint..j s& &C&C癮爒&C&C&C&C&C&Cr) )r r. r
r; r r )r% scoper& numbersr s r( prettyPrintzOctetString.prettyPrint^ s 榯渰++ # #圠.."" - -圓2妚坴楽榖焔歡&C&C7&C&C&C D DDDDD ! &&爐,, ,r) c d}d}g }| D ]V}|r|dz }nd}| | d}|dv rt | }nt j d| |||z z }學| | t | S )r r" r r )r r4 z$Non-binary OCTET STRING initializer )appendrk r r r$ )r& bitNobyter vs r( r z OctetString.fromBinaryStringo s
圓
怞慒擣''谸AC
怉慗 圖圖 怮墄寈r) c 筌 g }g }| D ]/}|r)| t ||z d d}-|}0|r&| t |dz d t | S )r r Nr )r^ rk r$ )r& r pra s r( r zOctetString.fromHexString s
圓
楺橴燘 ((( '
廐奌昐楽"%% & & &怮墄寈r) c * t | j S r+ r rl s r( r zOctetString.__len__ rn r) c 髕 |j t u r | | j | S | j | S r+ r r r- r. r% r s r( r zOctetString.__getitem__ 3 ;% ::榙渒!渘-- -;榪> !r) c * t | j S r+ iterr. rl s r( r zOctetString.__iter__ 怐擪 r) c || j v S r+ r r/ s r( __contains__zOctetString.__contains__ ##r) c 骲 | | j | | z S r+ )r- r. r r/ s r( rC zOctetString.__add__ s' 弞妟$+
癳(<(<<===r) c 骲 | | | | j z S r+ )r- r r. r/ s r( rE zOctetString.__radd__ s' 弞妟$--..<===r) c < | | j |z S r+ r, r/ s r( rK zOctetString.__mul__ r1 r) c | |z S r+ r r/ s r( rM zOctetString.__rmul__ r r) c * t | j S r+ rj rl s r( rm zOctetString.__int__ rn r) c * t | j S r+ rp rl s r( rr zOctetString.__float__ rs r) c * t | j S r+ )r r. rl s r( r zOctetString.__reversed__ s $$$r) Nr )+r r r r r
r r r r r r r r r r" r r r r r rD r# r r rP r r
r r[ staticmethodr r r r r rn rC rE rK rM rm rr r r r) r( r r s 8 8饃 圫宆%爏':窪AA F 5*466K
*
*
,
,F(//O恛H $ < < < <6 2 " " "" " "" " "* - - - -" 刓 < 刓. " " " ! ! !$ $ $> > >> > >/ / / " " "% % % % %r) r c 竽 e Zd ZdZ ej ej ej ej d Z e
j e j
d z Z e
Zd ZdS )r ai Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`str` objects
(always empty).
Keyword Args
------------
value: :class:`str` or |ASN.1| object
Python empty :class:`str` literal or any object that evaluates to :obj:`False`
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Ack(Null):
'''
ASN.1 specification:
Ack ::= NULL
'''
ack = Ack('')
r) c |r|S dS )Nr) r r/ s r( r z
Null.prettyIn s 圠坰r) N)r r r r r
r r r r r r r r r r r r r r) r( r r s 餒 圫宆%爏':窪AA F ),L↗,L萐,Q,QQK
"
"
$
$F r) r c 篪 e Zd ZdZ ej ej ej ej d Z e
j Z e
j Zd Zd Zd Zd Zd Zd Zd Zd
Zd Zd Zd
ZdS )r a5 Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`tuple` objects
(tuple of non-negative integers).
Keyword Args
------------
value: :class:`tuple`, :class:`str` or |ASN.1| object
Python sequence of :class:`int` or :class:`str` literal or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class ID(ObjectIdentifier):
'''
ASN.1 specification:
ID ::= OBJECT IDENTIFIER
id-edims ID ::= { joint-iso-itu-t mhs-motif(6) edims(7) }
id-bp ID ::= { id-edims 11 }
'''
id_edims = ID('2.6.7')
id_bp = id_edims + (11,)
c < | | j |z S r+ r, r s r( rC zObjectIdentifier.__add__8 r1 r) c < | || j z S r+ r, r s r( rE zObjectIdentifier.__radd__; r4 r) c | j S r+ r rl s r( asTuplezObjectIdentifier.asTuple>
寋r) c * t | j S r+ r rl s r( r zObjectIdentifier.__len__C rn r) c 髕 |j t u r | | j | S | j | S r+ rf rg s r( r z ObjectIdentifier.__getitem__F rh r) c * t | j S r+ rj rl s r( r zObjectIdentifier.__iter__L rl r) c || j v S r+ r r/ s r( rn z ObjectIdentifier.__contains__O ro r) c 6 | j | S r+ r. indexr% suboids r( r zObjectIdentifier.indexR 寋 (((r) c 髣 t | }|t | k r | j d| |d| k rdS dS )ar Indicate if this |ASN.1| object is a prefix of other |ASN.1| object.
Parameters
----------
other: |ASN.1| object
|ASN.1| object
Returns
-------
: :class:`bool`
:obj:`True` if this |ASN.1| object is a parent (e.g. prefix) of the other |ASN.1| object
or :obj:`False` otherwise.
NTFr r% r ls r(
isPrefixOfzObjectIdentifier.isPrefixOfU sE
塈孖 怑
??寋2楢2%)++恡坲r) c t |t rt | S t |t r╠|v r>t j d|d| j j dt j d t d |
d D S # t $ r,}t j d|d| j j d| d }~ww xY w t d |D }n@# t t f$ r,}t j d|d| j j d| d }~ww xY wt | t | k r|S t j d|d| j j ) N-zMalformed Object ID at : r c 0 g | ]}|t | S r rk r subOids r( r z-ObjectIdentifier.prettyIn..s # S S S╢菷 S漜&檏渒 S S Sr) .c 8 g | ]}|d k t | S r r r s r( r z-ObjectIdentifier.prettyIn..z # P P P繤萢翶繩燰繩繩繩r) )r6 r r r r r r r sysexc_infor8 r TypeErrorr r% r& r tupleOfIntss r( r zObjectIdentifier.prettyIni s 恊 - . .
<<
漵
#
# 恊坾坾'':?%% 訟X蠥X蠥X語]訸f裐h訸h衖j訸k衂kl
S S 繡8H8H S S STTT
'':?%% 訟X蠥X蠥X衂]衂]^
P P5 P P PQQ圞圞滻& ##6;癳癳窽糬=T=T=T蠽Y蠽YZ
坽 漵5檢渮 ) ) %%% 訧`蠭` abbb0 =+B) )
C 3'CC #C= =D:'D55D:c 驚 d d |D S )Nr c , g | ]}t | S r r r, s r( r z.ObjectIdentifier.prettyOut.. ///燗楺///r) r; r/ s r( r zObjectIdentifier.prettyOut # 弜妜/////000r) N r r r r r
r r r r r r r r r r" r r rC rE r r r r rn r r r r r r) r( r r s ( (餢 圫宆%爏':窪AA F 5*466K
*
*
,
,F/ / // / /
" " " ! ! !$ $ $) ) ) (c c c:1 1 1 1 1r) r c 篪 e Zd ZdZ ej ej ej ej d Z e
j Z e
j Zd Zd Zd Zd Zd Zd Zd Zd
Zd Zd Zd
ZdS ) RelativeOIDa[ Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`tuple` objects
(tuple of non-negative integers).
Keyword Args
------------
value: :class:`tuple`, :class:`str` or |ASN.1| object
Python sequence of :class:`int` or :class:`str` literal or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class RelOID(RelativeOID):
'''
ASN.1 specification:
id-pad-null RELATIVE-OID ::= { 0 }
id-pad-once RELATIVE-OID ::= { 5 6 }
id-pad-twice RELATIVE-OID ::= { 5 6 7 }
'''
id_pad_null = RelOID('0')
id_pad_once = RelOID('5.6')
id_pad_twice = id_pad_once + (7,)
c < | | j |z S r+ r, r s r( rC zRelativeOID.__add__ r1 r) c < | || j z S r+ r, r s r( rE zRelativeOID.__radd__ r4 r) c | j S r+ r rl s r( r zRelativeOID.asTuple r r) c * t | j S r+ r rl s r( r zRelativeOID.__len__ rn r) c 髕 |j t u r | | j | S | j | S r+ rf rg s r( r zRelativeOID.__getitem__ rh r) c * t | j S r+ rj rl s r( r zRelativeOID.__iter__ rl r) c || j v S r+ r r/ s r( rn zRelativeOID.__contains__ ro r) c 6 | j | S r+ r r s r( r zRelativeOID.index r r) c 髣 t | }|t | k r | j d| |d| k rdS dS )ap Indicate if this |ASN.1| object is a prefix of other |ASN.1| object.
Parameters
----------
other: |ASN.1| object
|ASN.1| object
Returns
-------
: :class:`bool`
:obj:`True` if this |ASN.1| object is a parent (e.g. prefix) of the other |ASN.1| object
or :obj:`False` otherwise.
NTFr r s r( r zRelativeOID.isPrefixOf sE
塈孖 怑
??寋2楢2%)++恡坲r) c t |t rt | S t |t r╠|v r>t j d|d| j j dt j d t d |
d D S # t $ r,}t j d|d| j j d| d }~ww xY w t d |D }n@# t t f$ r,}t j d|d| j j d| d }~ww xY wt | t | k r|S t j d|d| j j ) Nr zMalformed RELATIVE-OID r r r c 0 g | ]}|t | S r r r s r( r z(RelativeOID.prettyIn.. r r) r c 8 g | ]}|d k t | S r r r s r( r z(RelativeOID.prettyIn.. r r) )r6 r r r r r r r r r r8 r r r r s r( r zRelativeOID.prettyIn s 恊漑 ) )
<<
漵
#
# 恊坾坾''=B窾窾繢腘訢[蠨[蠨[誡`註i裖k註k衛m註n衇no
S S 繡8H8H S S STTT
''=B窾窾繢腘訢[蠨[蠨[衇`衇`a
P P5 P P PQQ圞圞滻& ##9>訞W蠤W蠤W衁\衁\]
坽 漵5檢渮 ) ) 繳繳繳菵蘊訪c蠰c deeer c 驚 d d |D S )Nr c , g | ]}t | S r r r, s r( r z)RelativeOID.prettyOut.. r r) r r/ s r( r zRelativeOID.prettyOut r r) Nr r r) r( r r s 餒 圫宆%爏':窪AA F 5*466K
*
*
,
,F/ / // / /
" " " ! ! !$ $ $) ) ) $f f f:1 1 1 1 1r) r c 骲 e Zd ZdZdZ ed Z ed ZeefZn# e $ r dxZZdZY nw xY w e
j e
j e
j
e
j d Z ej Zej Zed Zd Zd0d
Zed Z ed Z ed
Z d Z d Z d Z!d Z"d Z#d Z$d Z%d Z&d1dZ'd Z(d Z)d Z*d Z+d Z,d Z-d Z.d Z/d Z0d Z1d0d!Z2d" Z3d# Z4d$ Z5d% Z6d& Z7d' Z8d( Z9d) Z:d* Z;d+ Zd- Z?d. Z@d/ ZAdS )2r ab Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`float` objects.
Additionally, |ASN.1| objects behave like a :class:`tuple` in which case its
elements are mantissa, base and exponent.
Keyword Args
------------
value: :class:`tuple`, :class:`float` or |ASN.1| object
Python sequence of :class:`int` (representing mantissa, base and
exponent) or :class:`float` instance or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Pi(Real):
'''
ASN.1 specification:
Pi ::= REAL
pi Pi ::= { mantissa 314159, base 10, exponent -5 }
'''
pi = Pi((314159, 10, -5))
Ninfz-infr c 骕 | \ }}}|r |dz dk r|dz }|dz
}|r |dz dk |||fS )N
r r r )r& mr5 es r( __normalizeBase10zReal.__normalizeBase10Q sV 1坅 怉慒榓扠怟
塆圓
塅圓 怉慒榓扠怟 !怮坵r) c 竽 t |t rt | dk r騮 |d t t f r6t |d t rt |d t st j d| t |d t r | j r|d | j v r|d S |d dvr t j d|d |d dk r| | }|S t |t r| |ddf S t |t st |t r磘 |t r6 t | }n%# t $ r t j d | w xY w| j r || j v r|S d}t | |k r |dz }|dz }t | |k | t | d|f S t |t rt | S t j d | )
Nr r r r zLame Real value syntax: )r r z Prohibited base for Real value: r zBad real value syntax: ) r6 r r rk rq r r _inf_Real__normalizeBase10r r r )r% r& r s r( r z
Real.prettyInY s 恊漊 # # " ‥
癮 榰燪渪#璾 66
Q"58璖11
Q"58璖11
Q ''(OPPP58++
擨
"'(╠琲"7"7 楺攛怮寈榳&&'' 寉
C楿燿 / / %慾攋燛))楻慘怑慒怉 %慾攋燛)) --璼5﹝瑉2竡.ABBB
漷
$
$ << +05 2
s F "F;r c 骿 | t | S # t $ r Y dS w xY w)Nz
)r rq
OverflowError)r% rY s r( r[ zReal.prettyPrint sA >>%++.. . << 鴖 !$
22c " | j | j k S )z蠭ndicate PLUS-INFINITY object value
Returns
-------
: :class:`bool`
:obj:`True` if calling object represents plus infinity
or :obj:`False` otherwise.
)r. _plusInfrl s r( isPlusInfzReal.isPlusInf s 寋榙渕++r) c " | j | j k S )z袸ndicate MINUS-INFINITY object value
Returns
-------
: :class:`bool`
:obj:`True` if calling object represents minus infinity
or :obj:`False` otherwise.
)r. _minusInfrl s r(
isMinusInfzReal.isMinusInf s 寋榙渘,,r) c | j | j v S r+ )r. r rl s r( isInfz
Real.isInf s 寋榙渋''r) c 驦 | t | |z S r+ r- rq r/ s r( rC z Real.__add__ 弞妟%++-...r) c | |z S r+ r r/ s r( rE z
Real.__radd__ r r) c 驦 | t | |z S r+ r r/ s r( rK z Real.__mul__ r r) c | |z S r+ r r/ s r( rM z
Real.__rmul__ r r) c 驦 | t | |z
S r+ r r/ s r( rG z Real.__sub__ r r) c 驦 | |t | z
S r+ r r/ s r( rI z
Real.__rsub__ 弞妟%%++-...r) c 驦 | t | |z S r+ r r/ s r( rO z Real.__mod__ r r) c 驦 | |t | z S r+ r r/ s r( rQ z
Real.__rmod__ r r) c 骴 | t t | || S r+ r- rT rq rU s r( rW z Real.__pow__ s& 弞妟#漞燚檏渒5&99:::r) c 骲 | t |t | S r+ r r/ s r( rY z
Real.__rpow__ s$ 弞妟#榚411222r) c 驦 | t | |z S r+ r r/ s r( r` zReal.__truediv__ r r) c 驦 | |t | z S r+ r r/ s r( rb zReal.__rtruediv__ r r) c 驦 | t | |z S r+ r r/ s r( rf zReal.__divmod__ s 弞妟%++.///r) c 驦 | |t | z S r+ r r/ s r( rh zReal.__rdivmod__ s 弞妟%5;;.///r) c : t t | S r+ )rk rq rl s r( rm z Real.__int__ s 5;; r) c 螽 | j | j v r| j S t | j d t | j d | j d z S )Nr r r )r. r rq rT rl s r( rr zReal.__float__ sO ;$) # #; 楢燭癟碵碸!D!DD
r) c 骮 | t t | S r+ )r- ru rq rl s r( rv z Real.__abs__ s" 弞妟#漞燚檏渒**+++r) c 驢 | t |
S r+ r rl s r( rz z Real.__pos__ 弞妟5;;,'''r) c 驢 | t | S r+ r rl s r( r} z Real.__neg__ r r) c 髇 t t | | }|r| | S |S r+ )r rq r- r s r( r zReal.__round__ s4 %++榪 ! ! ::榓== 圚r) c 骿 | t j t | S r+ )r- r r rq rl s r( r zReal.__floor__ $ 弞妟$*411222r) c 骿 | t j t | S r+ )r- r r rq rl s r( r z
Real.__ceil__ s$ 弞妟$)$00111r) c 骿 | t j t | S r+ )r- r r rq rl s r( r zReal.__trunc__ r r) c ( t | |k S r+ rq r/ s r( r z Real.__lt__ 怲墈寋楿""r) c ( t | |k S r+ r r/ s r( r z Real.__le__ 怲墈寋榚##r) c ( t | |k S r+ r r/ s r( r z Real.__eq__ r r) c ( t | |k S r+ r r/ s r( r z Real.__ne__ r r) c ( t | |k S r+ r r/ s r( r z Real.__gt__ r r) c ( t | |k S r+ r r/ s r( r z Real.__ge__ r r) c : t t | S r+ )boolrq rl s r( __bool__z
Real.__bool__ s 旹$慘擪 r) c 骮 | j | j v rt j d | j | S )Nz Invalid infinite value operation)r. r r r r% idxs r( r zReal.__getitem__
s0 ;$) # ##$FGG G;榮# #r) c | j S r+ )r rl s r( isPlusInfinityzReal.isPlusInfinity
寏 r) c | j S r+ )r rl s r( isMinusInfinityzReal.isMinusInfinity s
r) c | j S r+ )r rl s r(
isInfinityzReal.isInfinity s
寊r) r r+ )Br r r r
binEncBaserq r r r r r
r r r r r r r r r r" r r rw r r r[ propertyr r r rC rE rK rM rG rI rO rQ rW rY r` rb rf rh rm rr rv rz r} r r r r r r r r r r r r r r r r r r) r( r r sx ) )餞 J5<<怑&慚擬 " ##9 圫宆%爏':窪AA F 5*466K
*
*
,
,F 刓&
&
&
餚
,
, 刋
, - - 刋 - ( ( 刋(/ / / / / / / / // / // / // / /; ; ; ;3 3 3/ / // / /0 0 00 0 0 , , ,( ( (( ( ( 3 3 32 2 23 3 3# # #$ $ $$ $ $$ $ $# # #$ $ $! ! ! "+H$ $ $ s % 33r c 笫 e Zd ZdZ ej ej ej ej d Z e
j Z e
Z ej ZdS )r a Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class RadioButton(Enumerated):
'''
ASN.1 specification:
RadioButton ::= ENUMERATED { button1(0), button2(1),
button3(2) }
selected-by-default RadioButton ::= button1
'''
namedValues = NamedValues(
('button1', 0), ('button2', 1),
('button3', 2)
)
selected_by_default = RadioButton('button1')
r N)r r r r r
r r r r r r r r r r r r r r! r r) r( r r s~ / /餱 圫宆%爏':窪AA F 5*466K
F '(&((KKKr) r c 箢 e Zd ZdZd Zd Zd Zd Zd Zd Z d d
Z
d Z d d
Z d Z
d Zd ZedfdZedddfdZed Zed Zd Zd Zd dZd dZed Zed Zd S ) r a< Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.ConstructedAsn1Type`,
its objects are mutable and duck-type Python :class:`list` objects.
Keyword Args
------------
componentType : :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A pyasn1 object representing ASN.1 type allowed within |ASN.1| type
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type can only occur on explicit
`.isInconsistent` call.
Examples
--------
.. code-block:: python
class LotteryDraw(SequenceOf): # SetOf is similar
'''
ASN.1 specification:
LotteryDraw ::= SEQUENCE OF INTEGER
'''
componentType = Integer()
lotteryDraw = LotteryDraw()
lotteryDraw.extend([123, 456, 789])
c 蠖 |r3t d| D ]"\ }}||v rt j d ||d< #t | _ t j j | fi | d S )N)
componentTyper r z*Conflicting positional and keyword params!r )zipr r r _componentValuesr ConstructedAsn1Typer# )r% argsr' keyr& s r( r# z SequenceOfAndSetOfBase.__init__ s 0 ! #237 9 9
0
0
怳&== +,XYYY*/'' ' )$99&99999r) c 髗 | | S # t j $ r}t | d }~ww xY wr+ )getComponentByPositionr r r r% r r s r( r z"SequenceOfAndSetOfBase.__getitem__ sI "..╯33 3 " " " 楽// ! "鴖 :5:c 髝 | || d S # t j $ r}t | d }~ww xY wr+ )setComponentByPositionr r r r% r r& r s r( __setitem__z"SequenceOfAndSetOfBase.__setitem__ sQ " ' '║ 3 3 3 3 3 " " " 楽// ! "鴖 =8=c 骦 | j t u rd}nt | j }|| |< d S r )r r r )r% r& poss r( r^ z SequenceOfAndSetOfBase.append s6 + +圕圕 恉+,,圕圫 r) c 髏 t | j | S r+ )r: r valuesr r/ s r( r z SequenceOfAndSetOfBase.count s- 怐)00223399%@@@r) c 骽 |D ]}| | | j t u r i | _ d S d S r+ )r^ r r )r% r r& s r( extendz SequenceOfAndSetOfBase.extend sJ 圗 廗奒 + +$&圖 ! ! ! , +r) r Nc |t | }t | j \ }}t | } || ||| S # t j $ r}t | d }~ww xY wr+ ) r r r itemsr: r r r r )r% r& startstopr r r s r( r z SequenceOfAndSetOfBase.index s <恡圖 榯 4 : : < <= 恌 "6<<╱癲;;< < " " " 楽// ! "鴖 A" "B1B Bc 8 | j d S r+ )r reverserl s r( r z SequenceOfAndSetOfBase.reverse s %%'''''r) Fc 髺 t t t | j || | _ d S )N)r r )dict enumeratesortedr r )r% r r s r( sortzSequenceOfAndSetOfBase.sort sN $ 昮楾 2 9 9 ; ;!$╣7 7 7
8
8!9 !9 r) c 骬 | j t u s| j sdS t | j dz S )Nr r )r r r rl s r( r z SequenceOfAndSetOfBase.__len__ s3 + +H +14())ˋ--r) c # 髕 K t dt | D ]}| | V d S r )r r r r s r( r z SequenceOfAndSetOfBase.__iter__ sL 滳橧淚&& 3 3圕--╟22 2 2 2 2 3 3r) c 0 | j D ]{\ }}|t urmt |t j r+| || | 孲| || 寍d S NcloneValueFlag)r r r r6 r r
r r- r% myCloner* r componentValues r( _cloneComponentValuesz,SequenceOfAndSetOfBase._cloneComponentValues s #'#8#>#>#@#@ P P 圕 ,, 榥璬.FGG P22榐 1 1 1 P P 2238L8L8N8NOOO P Pr) Tc 筲 t |t r?t t t } fd|| D S |dk r,t |z }|dk rt j d j | }nD# t t
j f$ r+ scY S | j | }Y nw xY wt u s|j r|S S )a2 Return |ASN.1| type component value by position.
Equivalent to Python sequence subscription operation (e.g. `[]`).
Parameters
----------
idx : :class:`int`
Component index (zero-based). Must either refer to an existing
component or to N+1 component (if *componentType* is set). In the latter
case a new component type gets instantiated and appended to the |ASN.1|
sequence.
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically instantiated.
If :obj:`False` either existing component or the :class:`NoValue` object will be
returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
Instantiate |ASN.1| component type or return existing component value
Examples
--------
.. code-block:: python
# can also be SetOf
class MySequenceOf(SequenceOf):
componentType = OctetString()
s = MySequenceOf()
# returns component #0 with `.isValue` property False
s.getComponentByPosition(0)
# returns None
s.getComponentByPosition(0, default=None)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
# sets component #0 to OctetString() ASN.1 schema
# object and returns it
s.getComponentByPosition(0, instantiate=True)
# sets component #0 to ASN.1 value object
s.setComponentByPosition(0, 'ABCD')
# returns OctetString('ABCD') value object
s.getComponentByPosition(0, instantiate=False)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
c > g | ]} | S r )r )r subidxdefault instantiater% s r( r zASequenceOfAndSetOfBase.getComponentByPosition..% s; 鴢 0 0 0 //MM 0 0 0r) r &SequenceOf/SetOf index is out of range) r6 r r r r r r r r r r isValue)r% r r2 r3 r r- s ` `` r( r z-SequenceOfAndSetOfBase.getComponentByPosition s6 鴢 鮀 恈5 ! ! 0滶#燿)) , ,--圙0 0 0 0 0 0")#,0 0 0
0 77恉))榗/圕怮妛坵'<> > > 8 ! 23 7圢圢%+, 8 8 8
' ' , , , ! 23 7圢圢圢
8 昰 !7 ! !圢s
B C5"CCc 髍 t |t rnt t t | }|r|| d pd}t | D ]!\ }} | ||z | ||| "| S |dk r,t | |z }|dk rt j d | j }
| j
t u ri } n| j
} | |t } |t u r6|
|
}n| t u rt j d n黷 |t j s噟
1t |
t j r|
| }n瘄 t ur1t | t j r|
| }nut j d|d| |
乊|s|rU| j r|
j p|
j }
|
||o||o| s/|
j t* j k rt j d|d |
|| |< | | _
| S )
a Assign |ASN.1| type component by position.
Equivalent to Python sequence item assignment operation (e.g. `[]`)
or list.append() (when idx == len(self)).
Parameters
----------
idx: :class:`int`
Component index (zero-based). Must either refer to existing
component or to N+1 component. In the latter case a new component
type gets instantiated (if *componentType* is set, or given ASN.1
object is taken otherwise) and appended to the |ASN.1| sequence.
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints: :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer
IndexError
When idx > len(self)
r r4 NComponent type not definedr& zNon-ASN.1 value z! and undefined component type at %Component value is tag-incompatible: vs )r6 r r r r r" r r r r r r getr- r Asn1Itemr" strictConstraintsisSameTypeWith
isSuperTypeOfr r )r% r r& verifyConstraints matchTagsmatchConstraintsr startIdxsubIdxsubValuer componentValues currentValuesubtypeCheckers r( r z-SequenceOfAndSetOfBase.setComponentByPosition> s 鮔 恈5 ! ! 滶#燿)) , ,--圙 2<?7癮圚$-╡$4$4
1
1 ++ 榲%爔1B /1 1 1 1 圞 77恉))榗/圕怮妛坵'<> > > *
+ + 圤圤 # 3圤&**388 旼 (%++-- (('(DEEE ) 楨4=11 7 ) 榼璬.ABB *%++%+88 -- 榺璗-@AA .$***77 ''%*燯燯――23 3 3
&↖
&9I
&* 1!00!/
">%):)H竬"3"H8HJ J
7 !'3:55 ++ %爙爙67 7 7 % / r) c , | j | j j S d S r+ )r tagMaprl s r( componentTagMapz&SequenceOfAndSetOfBase.componentTagMap s )%, , * )r) c 驞 fdt j D S )Nc * g | ]}j | S r r r r r% s r( r z5SequenceOfAndSetOfBase.components.. s1 鴢 : : : %燾* : : :r) )r# r rl s `r(
componentsz!SequenceOfAndSetOfBase.components s9 鴢 : : : :!$"788: : : :r) c i | _ | S )zemove all components and become an empty |ASN.1| value object.
Has the same effect on |ASN.1| object as it does on :class:`list`
built-in.
rN rl s r( clearz SequenceOfAndSetOfBase.clear s !# r) c t | _ | S z篟emove all components and become a |ASN.1| schema object.
See :meth:`isValue` property for more information on the
distinction between value and schema objects.
)r r rl s r( resetz SequenceOfAndSetOfBase.reset s !( r) c 笾 |dz
}| j j dz }| j s|S t | D ];\ }}|d|z z
}|t u r
| j |dz
}#|| | z
}<|S )Nr :
z)r r r5 r" r r r[ r% rY representationr r- s r( r[ z"SequenceOfAndSetOfBase.prettyPrint s
058寍 "! !#,═?? D D 圕 榗燛檏 )圢 '))&2 )+ ."<"<窾"C"CC r) c 蟠 |dz
}| j d| j j d}| j %|d|z z
}|| j | z
}|dz d|dz
z z dz S )Nr -> {
rX
})r r r r prettyPrintType)r% rY rZ s r( r` z&SequenceOfAndSetOfBase.prettyPrintType sv
+/;;;8O8O8OP ) 榗燛檏 )圢 榙 0 @ @ G G G圢 $爏╡癮﹊'883>>r) c 笠 | j t u rdS t | j t | k rdS | j D ]}|t u s|j s dS dS )ar Indicate 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).
FT)r r r r r5 r% r- s r( r5 z SequenceOfAndSetOfBase.isValue s| 6 + +5 坱$ % %═ 2 25 " 3 : : < < 圢 ((0F( 恥恥 ) 坱r) c | j t u s| j sdS | j t u rdS i }| j D ]\ }}|t u r|||< | | n # t
j $ r }|cY d}~S d}~ww xY wdS a Run necessary checks to ensure |ASN.1| object consistency.
Default action is to verify |ASN.1| object against constraints imposed
by `subtypeSpec`.
Raises
------
:py:class:`~pyasn1.error.PyAsn1tError` on any inconsistencies found
FTN)r r r r r r r )r% mappingr r& r s r( isInconsistentz%SequenceOfAndSetOfBase.isInconsistent
s ( (0@ (5 + +4 /5577 ! !塉圕 圙怌塋圠 榃 % % % % 圝圝圝圝圝圝 坲s A/ /B
>B?B
B
)r NNFr ) r r r r r# r r r^ r r r r r$ r r r. r r r r rK rP rR rU r[ r` r5 rf r r) r( r r c s ! !餌 : : : " " "" " " A A A' ' '
"
"
"
" ( ( (9 9 9 9
. . . 3 3 3P P P 3:纓 [ [ [ [饅 1815)-04m m m m館 - - 刋- : : 刋: "? ? ? ? $ $ 刋$餖 刋 r) r c 蠛 e Zd Zej Z ej ej ej ej d Z
dZ e j
Ze ZdS )r r Nr r r r r r
r r r tagFormatConstructedr r r r r r r r r) r( r r - 髉 $,G
圫宆%爏'?FF F M
5*466K $
-
-
/
/FFFr) r c 蠛 e Zd Zej Z ej ej ej ej d Z
dZ e j
Ze ZdS )r Nri r r) r( r r D rk r) r c 6 e Zd ZdZ ej Z G d de Zd Z d Z
d Z d Z d Z
d Zd
Zd Zd Zd
Zd Zd Zed Zd ZedfdZedddfdZedfdZedddfdZ ed Z ed Z d dZ d dZ d Z!d Z"d Z#d S )!r a Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.ConstructedAsn1Type`,
its objects are mutable and duck-type Python :class:`dict` objects.
Keyword Args
------------
componentType: :py:class:`~pyasn1.type.namedtype.NamedType`
Object holding named ASN.1 types allowed within this collection
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type can only occur on explicit
`.isInconsistent` call.
Examples
--------
.. code-block:: python
class Description(Sequence): # Set is similar
'''
ASN.1 specification:
Description ::= SEQUENCE {
surname IA5String,
first-name IA5String OPTIONAL,
age INTEGER DEFAULT 40
}
'''
componentType = NamedTypes(
NamedType('surname', IA5String()),
OptionalNamedType('first-name', IA5String()),
DefaultedNamedType('age', Integer(40))
)
descr = Description()
descr['surname'] = 'Smith'
descr['first-name'] = 'John'
c 驜 e Zd ZdZd Zd Zd Zd Zd Zd Z d Z
d Z d
S ) SequenceAndSetBase.DynamicNamesz9Fields names/positions mapping for component-less objectsc " i | _ i | _ d S r+ _keyToIdxMap _idxToKeyMaprl s r( r# z(SequenceAndSetBase.DynamicNames.__init__ s "圖 "圖 r) c * t | j S r+ )r rs rl s r( r z'SequenceAndSetBase.DynamicNames.__len__ s 恡()) )r) c & || j v p|| j v S r+ rr r% items r( rn z,SequenceAndSetBase.DynamicNames.__contains__ s 4,,I8I0I Ir) c 骬 fdt t j D S )Nc 3 2 K | ]}j | V d S r+ )rt rO s r( rX z;SequenceAndSetBase.DynamicNames.__iter__.. s+ TT╯怐%燾*TTTTTTr) )r r rt rl s `r( r z(SequenceAndSetBase.DynamicNames.__iter__ s0 鴢 TTTT礶紺訞Qd S r+ )r r r r r r/ r s r( r zSequenceAndSetBase.items s /J3皌7I3J3JKK 9 9圕%
9(-2癉碔=====(-╰癈瑈88888 9 9r) c 驚 |D ]
\ }}|| |< |D ]
}|| | |< d S r+ r )r% iterValue mappingValuekra s r( updatezSequenceAndSetBase.update sH 塂圓坬圖塆圙 & &圓"1攐圖塆圙 & &r) c 驠 g | _ | | _ | S )zemove all components and become an empty |ASN.1| value object.
Has the same effect on |ASN.1| object as it does on :class:`dict`
built-in.
)r r r rl s r( rR zSequenceAndSetBase.clear s% !# ! . . 0 0 r) c 驪 t | _ | | _ | S rT )r r r r rl s r( rU zSequenceAndSetBase.reset s% !( ! . . 0 0 r) c | j S r+ rN rl s r( rP z SequenceAndSetBase.components s $$r) c 驠 | j t u rd S t | j D ]{\ }}|t urmt |t j r+| || | 孲| || 寍d S r( )r r r" r6 r r
r r- r+ s r( r. z(SequenceAndSetBase._cloneComponentValues s + + 團#,═-B#C#C P P 圕 ,, 榥璬.FGG P22榐 1 1 1 P P 2238L8L8N8NOOO P Pr) Tc 篾 | j r| j | }nB | j | }n&# t $ r t j d|d w xY w| ||| S )ap Returns |ASN.1| type component by name.
Equivalent to Python :class:`dict` subscription operation (e.g. `[]`).
Parameters
----------
name: :class:`str`
|ASN.1| type component name
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically
instantiated.
If :obj:`False` either existing component or the :class:`NoValue`
object will be returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
Instantiate |ASN.1| component type or return existing
component value
r r r2 r3 )r r r r r r r r )r% r/ r2 r3 r s r( r z%SequenceAndSetBase.getComponentByName' s 8 ! G$66皌<<圕圕
G(::4@@
G
G
G''竧竧竧(EFFF
G **3萚*YYY ? #A"c 簏 | j r| j | }nB | j | }n&# t $ r t j d|d w xY w| ||||| S )a Assign |ASN.1| type component by name.
Equivalent to Python :class:`dict` item assignment operation (e.g. `[]`).
Parameters
----------
name: :class:`str`
|ASN.1| type component name
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints: :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
r r )r r r r r r r r )r% r/ r& r@ rA rB r s r( r z%SequenceAndSetBase.setComponentByNameN s 養 ! G$66皌<<圕圕
G(::4@@
G
G
G''竧竧竧(EFFF
G ** )F
r c $ | j t u rt }n
| j | }n# t $ r
t }Y nw xY w|s|t u s|j s|S |S |t u r| | | j | }|t u s|j r|S |S )a Returns |ASN.1| type component by index.
Equivalent to Python sequence subscription operation (e.g. `[]`).
Parameters
----------
idx: :class:`int`
Component index (zero-based). Must either refer to an existing
component or (if *componentType* is set) new ASN.1 schema object gets
instantiated.
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically
instantiated.
If :obj:`False` either existing component or the :class:`NoValue`
object will be returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
a PyASN1 object
Examples
--------
.. code-block:: python
# can also be Set
class MySequence(Sequence):
componentType = NamedTypes(
NamedType('id', OctetString())
)
s = MySequence()
# returns component #0 with `.isValue` property False
s.getComponentByPosition(0)
# returns None
s.getComponentByPosition(0, default=None)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
# sets component #0 to OctetString() ASN.1 schema
# object and returns it
s.getComponentByPosition(0, instantiate=True)
# sets component #0 to ASN.1 value object
s.setComponentByPosition(0, 'ABCD')
# returns OctetString('ABCD') value object
s.getComponentByPosition(0, instantiate=False)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
)r r r r5 r )r% r r2 r3 r- s r( r z)SequenceAndSetBase.getComponentByPosition| s 餒 %$//!( "&!6皊!; % % % $圢圢圢 % & ((0F( %% 漌 $ $ ' ' , , , .╯3 昰 !7 ! !圢s #& ::c 骦 | j }| j }| j t u rg }n| j } || } n># t $ r1 t } |r%||k rt j d t g|z }Y nw xY w|t u rs|rR| | }t |t j
r!| || j }np| t u rt j d nQt |t j
s膢rg| | }
t |
t j r|
| }n飔 j d|j j z | t ur1t | t j r| | }n攖 j d|j j z |s|s|rm|rk| | }
|
t urM| j r|
j p|
j } | ||o||o| s'|| j st j d|d| |s || j v r|||< nWt- | |k r0| | | j | nt j d || _ | S )
a Assign |ASN.1| type component by position.
Equivalent to Python sequence item assignment operation (e.g. `[]`).
Parameters
----------
idx : :class:`int`
Component index (zero-based). Must either refer to existing
component (if *componentType* is set) or to N+1 component
otherwise. In the latter case a new component of given ASN.1
type gets instantiated and appended to |ASN.1| sequence.
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints : :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
z component index out of ranger) r7 r8 z %s can cast only scalar valuesz%s undefined component typer9 r: z Component index out of range)r r r r r r r getTypeByPositionr6 r r
r- isDefaultedr< r" r r r= r> r? openTyper r r^ r ) r% r r& r@ rA rB r componentTypeLenrF rG subComponentTyperH s r( r z)SequenceAndSetBase.setComponentByPosition s8 餒 *
1 + + 圤圤 # 3圤 ?*3/圠圠 ? ? ?"圠
?#燾)) +,JKKK#*).>">
? 旼
F%77<< 榚%=>> W !烱欿皚繱7I7U楰 V V怑 (('(DEEE ) 楨4=11 z
j#0#B#B3#G#G .0CDD q , 2 2 2 ? ?怑怑 +,L葈設f設o,oppp ,,窵$訨]1^1^,$***77 '(E
訦_訦h(hiii z營 z1A z z , > >竤 C C .."&"8 #B"2"A#A"2"@ &悀爀->-L9&7&L\ }}|j s|j r| j s dS | j | }|t u s|j s dS ?n | j D ]}|t u s|j s dS dS )a Indicate 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).
It is sufficient for |ASN.1| objects to have all non-optional and non-defaulted
components being value objects to be considered as a value objects as a whole.
In other words, even having one or more optional components not turned into
value objects, |ASN.1| object is still considered as a value object. Defaulted
components are normally value objects by default.
FT)r r r r"
namedTypesr
isOptionalr5 )r% r r r r- s r( r5 zSequenceAndSetBase.isValueE
s 餌 + +5 *
!)2=3K)L)L
!
!%%#/ 3C3N , ! 𪍇!%!6皊!;!,,癗4J, 𪍇 -
! #'"7
!
!!,,癗4J, 𪍇 - 坱r) c 驢 | j t u s| j sdS | j t u rdS i }t | j D ].\ }}|t u r| j | }|||< / | | n # t j $ r }|cY d}~S d}~ww xY wdS rd )r r r r r" r} r r )r% re r r& r/ r s r( rf z!SequenceAndSetBase.isInconsistent
s ( (0@ (5 + +4#燚$9:: " "塉圕 %77<<圖 !圙怐塎圡 榃 % % % % 圝圝圝圝圝圝 坲s .B B BB B r c 驦 |dz
}| j j dz }t | j D ]z\ }}|t url|j re|d|z z
}| j r || j | z
}n || j | z
}|d| | d}寋|S )z歊eturn an object representation string.
Returns
-------
: :class:`str`
Human-friendly object representation.
r rW rX =r^ )
r r r" r r r5 r r} r r[ rY s r( r[ z SequenceAndSetBase.prettyPrint
s
058#,═-B#C#C 圕 ,, 1G, #+-% P"燿&8&J&J3&O&OO怤怤"燿&8&J&J3&O&OO怤"怤怤燦$>$>竨$E$E$E$E" r) c 髽 |dz
}| j d| j j d}t | j p| j D ]p\ }}|d|z z
}| j r!|d| j | z z
}n |d| j | z z
}|d| | d}宷|dz d|dz
z z dz S ) Nr r\ r] rX z"%s"z = r^ r_ )
r r r r" r r r r} r r` )r% rY rZ r r s r( r` z"SequenceAndSetBase.prettyPrintType
s
+/;;;8O8O8OP"+―,>,E,E,G,G,`4訩`"a"a 圕 榗燛檏 )圢!
U &4+=+O+O蠵S+T+T"TT &4+=+O+O蠵S+T+T"TT
= =竐 D D D D 圢圢 $爏╡癮﹊'883>>r) c | S r+ r rl s r( setDefaultComponentsz'SequenceAndSetBase.setDefaultComponents
r) c " | j r| j S d S r+ )r r rl s r( getComponentTypez#SequenceAndSetBase.getComponentType
s ! &% % & &r) c 8 | j r| j | j S d S r+ )r r r/ r s r( r} z$SequenceAndSetBase.getNameByPosition
s( ! 0%燾*/ / 0 0r) Nr )$r r r r r
NamedTypesr objectr r# r r rn r r r r r r rR rU r rP r. r r r r r r5 rf r[ r` r r r} r r) r( r r [ sW * *餤 )怚(**M&6 &6 &6 &6 &6恦 &6 &6 &6餜K K K& & &"& & &"- - - * * *> > >
9 9 9& & & % % 刋% P P P 07繢 %Z %Z %Z %Z餘 .5-1%),0,
,
,
,
餦 3:纓 \ \ \ \饇 1815)-04i i i i餠 7 7 刋7餽 " " 刋"餒 , ? ? ? ? & & &0 0 0 0 0r) r c 筻 e Zd Zej Z ej ej ej ej d Z
e j Z
ej Ze Zd Zd ZdS )r r c 驢 | j r| j | S d S r+ )r getTagMapNearPositionr s r( getComponentTagMapNearPositionz'Sequence.getComponentTagMapNearPosition
s1 A%;;窩@@ @ A Ar) c 驤 | j r| j || S |S r+ )r getPositionNearType)r% r r s r( getComponentPositionNearTypez%Sequence.getComponentPositionNearType
s+ %99&#FF F圝r) N)r r r r r r
r r r rj r r r r r r r r r r r r r) r( r r
s (G
圫宆%爏'?FF F 5*466K )怚(**M
)
)
+
+FA A A r) r c e Zd Zej Z ej ej ej ej d Z
e j Z
ej Ze Zd dZeddfdZeddddfdZed ZdS )
r rm Fc | S r+ r )r% innerFlags r( getComponentzSet.getComponent r r) Tc 罄 | | j | || }|r+t |t r| d S |S )a8 Returns |ASN.1| type component by ASN.1 tag.
Parameters
----------
tagSet : :py:class:`~pyasn1.type.tag.TagSet`
Object representing ASN.1 tags to identify one of
|ASN.1| object component
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically
instantiated.
If :obj:`False` either existing component or the :class:`noValue`
object will be returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
a pyasn1 object
r Tr )r r getPositionByTyper6 r r )r% r r2 r3 r r- s r( getComponentByTypezSet.getComponentByType sq 6 44 0 0 8 8 5
"燦礐88 "!...>> > " !r) c 驚 | j | }|rj| j | }|j r| ||||| S | | }| |||||| S | ||||| S )a! Assign |ASN.1| type component by ASN.1 tag.
Parameters
----------
tagSet : :py:class:`~pyasn1.type.tag.TagSet`
Object representing ASN.1 tags to identify one of
|ASN.1| object component
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints : :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
innerFlag: :class:`bool`
If :obj:`True`, search for matching *tagSet* recursively.
Returns
-------
self
r )r r r r r r setComponentByType) r% r r& r@ rA rB r r r s r( r zSet.setComponentByType7 s 餒 226:: . @ @ E E圡 #
22 19>N !% ; ;窩 @ @
$77楨#4癷蠥Q衇f 8 ..怳 -▂:J
r) c , | j r | j j S d S r+ )r tagMapUniquerl s r( rK zSet.componentTagMapn s# 3%2 2 3 3r) NF)r r r r r r
r r r rj r r r r r r r r r r r r r r rK r r) r( r r
s (G
圫宆%爏'?FF F )怚(**M
5*466K
)
)
+
+F 29'+皍$" $" $" $"餖 07-1%),0%* 5 5 5 5餹 3 3 刋3 3 3r) r c 髮 e Zd ZdZ ej Z ej Z e
j e
j dd Z
e ZdZd Zd Zd Zd Zd Zd Zd
Zd Zd Zd
Zd Z d Z d Z d Z d Z e!dfdZ"e!dddfdZ#e$d Z%e$d Z&d dZ'd dZ(e$d Z)d Z*d Z+dS ) r a Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.ConstructedAsn1Type`,
its objects are mutable and duck-type Python :class:`list` objects.
Keyword Args
------------
componentType: :py:class:`~pyasn1.type.namedtype.NamedType`
Object holding named ASN.1 types allowed within this collection
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type can only occur on explicit
`.isInconsistent` call.
Examples
--------
.. code-block:: python
class Afters(Choice):
'''
ASN.1 specification:
Afters ::= CHOICE {
cheese [0] IA5String,
dessert [1] IA5String
}
'''
componentType = NamedTypes(
NamedType('cheese', IA5String().subtype(
implicitTag=Tag(tagClassContext, tagFormatSimple, 0)
),
NamedType('dessert', IA5String().subtype(
implicitTag=Tag(tagClassContext, tagFormatSimple, 1)
)
)
afters = Afters()
afters['cheese'] = 'Mascarpone'
r Nc 驤 | j r| j | j |k S t S r+ r _currentIdxNotImplementedr s r( r z
Choice.__eq__ * D()9:竐C C r) c 驤 | j r| j | j |k S t S r+ r r s r( r z
Choice.__ne__ r r) c 驤 | j r| j | j |k S t S r+ r r s r( r z
Choice.__lt__ * C()9:窾B B r) c 驤 | j r| j | j |k S t S r+ r r s r( r z
Choice.__le__ r r) c 驤 | j r| j | j |k S t S r+ r r s r( r z
Choice.__gt__ r r) c 驤 | j r| j | j |k S t S r+ r r s r( r z
Choice.__ge__ r r) c * t | j S r+ )r r rl s r( r zChoice.__bool__ s 怐)***r) c | j d urdpdS )Nr r )r rl s r( r zChoice.__len__ s 爐+16癚6r) c 骴 | j dS || j | j k S rg r r getNamer s r( rn zChoice.__contains__ s2 #5恉()9:BBDDDDr) c # 髍 K | j t | j | j V d S r+ )r
StopIterationr r rl s r( r zChoice.__iter__ s> # !12::<<<<<<>@@ @ @ @ @ @ ( 'r) c # 髠 K | j 5| j | j | | j fV d S d S r+ r rl s r( r z Choice.items sM '$燭%56>>@@$纓訥W訠XX X X X X X ( 'r) c < | j t j d d S )NComponent not chosen)r r r rl s r( checkConsistencyzChoice.checkConsistency s% ##$:;; ; $ #r) c 髝 | }t |t r|j }n|j }t |t
j r,| || | d S | || d S # t j
$ r Y d S w xY wr( ) r r6 r effectiveTagSetr r r
r r- r r )r% r, r* componentr s r( r. z Choice._cloneComponentValues s F ))++圛 ),,
*"2"))%=>>
F**業烵歄>極 J J **??3D3DEEEEE 圖圖 鴖 B* *B=<B=Tc 髷 t j }| j | j |k r t | ||| S | j | S )Nr )r r r r r )r% r r2 r3 r s r( r z Choice.getComponentByPosition sX + #爐'73'>'>--╠癈:E . G G
G $燬))r) c 髱 | j }t | ||||| || _ |||k rt | j |< | S )a Assign |ASN.1| type component by position.
Equivalent to Python sequence item assignment operation (e.g. `[]`).
Parameters
----------
idx: :class:`int`
Component index (zero-based). Must either refer to existing
component or to N+1 component. In the latter case a new component
type gets instantiated (if *componentType* is set, or given ASN.1
object is taken otherwise) and appended to the |ASN.1| sequence.
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component. Once a new value is
set to *idx* component, previous value is dropped.
If `value` is not given, schema object will be set as a component.
verifyConstraints : :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
)r r r r r )r% r r& r@ rA rB oldIdxs r( r z Choice.setComponentByPosition sU 餔 ! ""4╡5F 蠸cddd &–--,3圖 !& ) r) c 骉 | j r| j S | }|j S )zwReturn a :class:`~pyasn1.type.tag.TagSet` object of the currently initialized component or self (if |ASN.1| is tagged).)r r r )r% r s r( r zChoice.effectiveTagSet< s0 ; -; ))++圛 , ,r) c 骹 | j r t j | S | j j S z"Return a :class:`~pyasn1.type.tagmap.TagMap` object mapping
ASN.1 tags to ASN.1 objects contained within callee.
)r r rJ fgetr r rl s r( rJ z
Choice.tagMapE s.
; 3:??4(( (%2 2r) Fc 蟾 | j t j d | j | j }|r*t |t
r| | S |S )z砇eturn currently assigned component of the |ASN.1| object.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
a PyASN1 object
Nr )r r r r r6 r r r% r cs r( r zChoice.getComponentO s_ ##$:;; ;%燿&67圓
漐6 2 2
梸拁爄000r) c 篁 | j t j d |r<| j | j }t |t
r| | S | j | j S )z璕eturn the name of currently assigned component of the |ASN.1| object.
Returns
-------
: :py:class:`str`
|ASN.1| component name
Nr ) r r r r r6 r r r r} r s r( r zChoice.getName` su ##$:;; ;
0)$*:; 榓(( 0 燳///%778HII Ir) c 骕 | j dS | j | j }|t uo|j S )a~ Indicate 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).
NF)r r r r5 rb s r( r5 zChoice.isValueq s5 8 #5 .╰/?@ ,G 1GGr) c 驞 d | _ t | S r+ )r r rR rl s r( rR z Choice.clear s 弝妝 r) c | j S r+ ) minTagSetrl s r( getMinTagSetzChoice.getMinTagSet r r) r ),r r r r r
TagSetr r r r r r ValueSizeConstraintr r r r r r r r r r r r r rn r r r r r r. r r r r r rJ r r r5 rR r r r) r( r r t sF + +館 圫孼塡孿F )怚(**M
5*4&
&爍!,, K
廬奭塤宊FK
+ + +7 7 7E E E
= = =: : :A A AY Y Y< < <F F F" 3:纓 * * * * 1815)-04* * * *餢 - - 刋- 3 3 刋3 "J J J J" H H 刋 H餌 r) r c 髮 e Zd ZdZ ej Z ej Z e
Z e
d ZdS )r a Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`,
its objects are immutable and duck-type :class:`bytes`.
When used in Unicode context, |ASN.1| type assumes
"|encoding|" serialisation.
Keyword Args
------------
value: :class:`unicode`, :class:`str`, :class:`bytes` or |ASN.1| object
:class:`bytes`, alternatively :class:`str`
representing character string to be serialised into octets (note
`encoding` parameter) or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
encoding: :py:class:`str`
Unicode codec ID to encode/decode
:class:`str` the payload when |ASN.1| object is used
in text string context.
binValue: :py:class:`str`
Binary string initializer to use instead of the *value*.
Example: '10110011'.
hexValue: :py:class:`str`
Hexadecimal string initializer to use instead of the *value*.
Example: 'DEADBEEF'.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Error(Sequence):
'''
ASN.1 specification:
Error ::= SEQUENCE {
code INTEGER,
parameter ANY DEFINED BY code -- Either INTEGER or REAL
}
'''
componentType=NamedTypes(
NamedType('code', Integer()),
NamedType('parameter', Any(),
openType=OpenType('code', {1: Integer(),
2: Real()}))
)
error = Error()
error['code'] = 1
error['parameter'] = Integer(1234)
c 蠛 | j S # t $ rG t j | j | it
j j t
j i| | _ | j cY S w xY wr )_tagMapAttributeErrorr TagMapr r endOfOctetsrl s r( rJ z
Any.tagMap si
< !=榙# ' 9 圖孡 < 鴖 堿AAN)r r r r r
r r r r r r r r r rJ r r) r( r r sn @ @餒 圫孼塡孿F
5*466K
"
"
$
$F
刋 r) r )'r r pyasn1r pyasn1.codec.berr
pyasn1.compatr pyasn1.typer r r r r
r r r __all__r" r r
rk r r r r r r r r r
r r r r r r r r r r) r( r sh
! ! ! ! ! ! " " " " " " ! ! ! ! ! !
,
')) ! ! !c c c c c 坉! c c c 餖=! =! =! =! =!坓 =! =! =!餈 3 ] ] ] ] ]# ] ] ]餈 S% S% S% S% S%$% S% S% S%餷1 1 1 1 1; 1 1 1餳H1 H1 H1 H1 H1恡* H1 H1 H1餠~1 ~1 ~1 ~1 ~1$% ~1 ~1 ~1養N N N N N4 N N N餬B) B) B) B) B) B) B) B)餘H H H H H楾 5 H H H餞0 0 0 0 0' 0 0 0.0 0 0 0 0 " 0 0 0.x 0 x 0 x 0 x 0 x 01 x 0 x 0 x 0餿 ! 餏y3 y3 y3 y3 y3
y3 y3 y3饃g g g g g 圫 g g g 餞 ^ ^ ^ ^ ^ + ^ ^ ^ ^ ^ r) PK ! =
柚鑡 鑡 __pycache__/base.cpython-311.pycnu 刐迭
辤"V 篁 d dl Z d dlmZ d dlmZ d dlmZ d dlmZ g dZ G d de Z G d d
e Z
e
Z G d d e Z e Z
G d
de
ZeZ G d de
ZeZdS ) N)error)
constraint)tag)tagmap)Asn1ItemAsn1TypeSimpleAsn1TypeConstructedAsn1Typec & e Zd Zedd ZdS )r c 髝 t xj |z
c_ n # t $ r |t _ Y nw xY wt j S N)r _typeCounterAttributeError)cls increments 鷓/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/base.py getTypeIdzAsn1Item.getTypeId sP . ! !燳 . ! ! ! . . .$-岺 ! ! ! .$$s 11N)r )__name__
__module__ __qualname__ classmethodr r r r s2 % % % 刐% % %r r c 篁 e Zd ZdZ ej Z ej Z dZ
d Z d Z d Z
ed Zed Zed Zdd
Zdd Zed ZddZd Zd Zd Zd Zd ZdS )r a> 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.
Nc 髳 | j | j d}| | | j | || _ d S )NtagSet subtypeSpec)r r update__dict__ _readOnlyselfkwargsreadOnlys r __init__zAsn1Type.__init__2 sN 攌 +
榅&&&!r c 髍 |d dk r || j v rt j d|z || j |< d S )Nr _z!read-only instance attribute "%s")r" r PyAsn1Errorr! )r$ namevalues r __setattr__zAsn1Type.__setattr__> sD 7恈>>榙燿 4 4#$G$$NOO O #
恉r c * | S r ) prettyPrintr$ s r __str__zAsn1Type.__str__D s !!!r c | j S r )r" r0 s r r& zAsn1Type.readOnlyG s
寏 r c | j S )z3For |ASN.1| type is equivalent to *tagSet*
r r0 s r effectiveTagSetzAsn1Type.effectiveTagSetK s 寋r c 8 t j | j | i S )zvReturn a :class:`~pyasn1.type.tagmap.TagMap` object mapping ASN.1 tags to ASN.1 objects within callee object.
)r TagMapr r0 s r tagMapzAsn1Type.tagMapQ s 寎榙渒4 0111r Tc 骎 | |u p%| s| j |j k o| p| j |j k S )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.
r r$ other matchTagsmatchConstraintss r isSameTypeWithzAsn1Type.isSameTypeWithW sF (
P =$+ "= P%%N)9窾=N)N Qr c 髪 | p@| j |j o!| p | j |j S )al Examine |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.
)r isSuperTagSetOfr
isSuperTypeOfr: s r rA zAsn1Type.isSuperTypeOfo sO (
],,║琝:: ]&&[$*:*H*H訧Z*[*[ ^r c ( | D ]}|t ur dS dS )NFT)noValue)valuesr, s r isNoValuezAsn1Type.isNoValue s- 圗滸## 恥恥 $坱r r c t r )NotImplementedErrorr$ scopes r r/ zAsn1Type.prettyPrint s !!r c | j S r r4 r0 s r getTagSetzAsn1Type.getTagSet
寋r c | j S r )r5 r0 s r getEffectiveTagSetzAsn1Type.getEffectiveTagSet s ##r c | j S r )r8 r0 s r getTagMapzAsn1Type.getTagMap rL r c | j S r r r0 s r getSubtypeSpeczAsn1Type.getSubtypeSpec s r c | j S r )isValuer0 s r hasValuezAsn1Type.hasValue s
寍r )TTr ) r r r __doc__r TagSetr r ConstraintsIntersectionr typeIdr' r- r1 propertyr& r5 r8 r> rA staticmethodrE r/ rK rN rP rS rV r r r r r sn 圫孼塡孿F 5*466K F
"
"
"$ $ $ " " " 刋 刋
2 2 刋2
Q Q Q Q0^ ^ ^ ^0 刓 " " " "
$ $ $ r r c 0 e Zd ZdZh dZdZd Zd Zd ZdS )NoValueaz Create 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.
> __del____new__r' __repr__im_class __class__ __slots__
__reduce__
__sizeof__ __delattr__ __getattr__r- __getstate__ __objclass__r __setstate__
__reduce_ex____getnewargs____getinitargs____getattribute__Nc j td } fdt t t t fD }t | D ] }t
| || t _ j S )Nc fd}|S )Nc 2 t j dz )N/Attempted "%s" operation on ASN.1 schema objectr r* )r$ argskwr+ s r plugz.NoValue.__new__..getPlug..plug s 鴢 +,]衊d,deeer r )r+ rx s ` r getPlugz NoValue.__new__..getPlug s& 鴢 f f f f f r c 筘 g | ]f}t | D ]T}|j v | d | d 5t t || 疪|孶実S )__)dir skipMethods
startswithendswithcallablegetattr).0typr+ r s r
z#NoValue.__new__.. s 鴢 ; ; ; $'; ; 7 7 烵歄― 1 1 8 烳歁$ / / 8 %⊿$%7%7 8 8 8 8 7 7 7r ) _instancestrintlistdictsetsetattrobjectra )r ry op_namesr+ s ` r ra zNoValue.__new__ s 鴢 =
; ; ; ;$'璬礑#9; ; ;圚 楬
2
2楾4==1111 "烴歂3 / /圕孧寎 r c 骹 || j v rt d|z t j d|z )NzAttribute %s not presentrt )r} r r r* )r$ attrs r ri zNoValue.__getattr__ s< 4# # # !;竏!BCC C Q蠺X XYYYr c d| j j z S )Nz <%s object>)rd r r0 s r rb zNoValue.__repr__ s 榯渵 666r ) r r r rX r} r ra ri rb r r r r_ r_ sf K4 I ,Z Z Z 7 7 7 7 7r r_ c 鬁 e Zd ZdZeZefdZd Zd Zd Z d Z
d Z d Z d Z
d
Zd Zed Zefd
ZefdZd Zd ZddZddZdS )r a Base 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.
c . t j | fi | |t u r| j }nj| | } | | n># t j $ r,} t | |d| j j
d }~ww xY w|| _ d S )Nz at ) r r' rC defaultValueprettyInr r r* typerd r _value)r$ r, r% exValues r r' zSimpleAsn1Type.__init__ s $))&))) 旼 %圗圗桵扢%((圗
U ''''$
U
U
U#昫7憁攎'''4>;R;R$STTT
U s A B 'BB c 6 | j j d| j rdpdd}| j D ]\ }}|r |d|d|z
}| j rG| }t
| dk r|d d dz |d d z }|d
|z z
}d |z S ) N r, schema object, z...i, payload [%s]<%s>)rd r rU r& itemsr/ lenr$ representationr r, s r rb zSimpleAsn1Type.__repr__ s 孨 # # #燭%=癵%I%I%IK =..00 < <塊圖%
< ╰╰╰癠癠";; < 7$$&&圗5墇寊楤 榗榬榗
燯*║4琜8 . 6 6圢&&r c $ | |u rdS | j |k S )NTr r$ r; s r __eq__zSimpleAsn1Type.__eq__# s 5==4寋榚##r c | j |k S r r r s r __ne__zSimpleAsn1Type.__ne__( 寋榚##r c | j |k S r r r s r __lt__zSimpleAsn1Type.__lt__+ 寋楿""r c | j |k S r r r s r __le__zSimpleAsn1Type.__le__. r r c | j |k S r r r s r __gt__zSimpleAsn1Type.__gt__1 r r c | j |k S r r r s r __ge__zSimpleAsn1Type.__ge__4 r r c * t | j S r )boolr r0 s r __bool__zSimpleAsn1Type.__bool__7 怐擪 r c * t | j S r )hashr r0 s r __hash__zSimpleAsn1Type.__hash__: r r c | j t uS )az Indicate 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).
)r rC r0 s r rU zSimpleAsn1Type.isValue= s 8 寋'))r c 螈 |t u r |s| S | j }| j }| | | j |fi |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.
)rC r r& copyr rd )r$ r, r% initializerss r clonezSimpleAsn1Type.clone[ sd 旼
擪圗攠))++ 楩### 坱寏榚44爘444r c 鬆 |t u r |s| S | j }| j }| dd }| | j | |d< | dd }| | j | |d< | D ]\ }}||xx |z
cc< | j |fi |S )a Create 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)
rC r r& r popr
tagImplicitly
tagExplicitlyr rd )r$ r, r% r r r argoptions r subtypezSimpleAsn1Type.subtypev s 館 旼
擪圗攠))++ 梛抝 55 "%)%>%>竰%K%K圠 " 梛抝 55 "%)%>%>竰%K%K圠 "!<<>> ( (塊圕 ' 坱寏榚44爘444r c |S r r r$ r, s r r zSimpleAsn1Type.prettyIn s r c t | S r )r r s r prettyOutzSimpleAsn1Type.prettyOut s 5墇寊r r c 6 | | j S r )r r rH s r r/ zSimpleAsn1Type.prettyPrint s 弤妦榙渒***r c . | j d| j j S )Nz -> )r rd r rH s r prettyPrintTypez SimpleAsn1Type.prettyPrintType s !淸榌榌$.*A*ABBr NrW )r r r rX rC r r' rb r r r r r r r r r\ rU r r r r r/ r r r r r r sa L $ ' ' ' $ $ $
$ $ $# # #$ $ $# # #$ $ $! ! !! ! ! * * 刋*: " 5 5 5 56 $ B5 B5 B5 B5餒 + + + +C C C C C Cr r c 舐 e Zd ZdZdZdZ ej Zd Z d Z
d Z d Z d Z
d Zd
Zd Zd Zd
Zed Zd Zd Zd Zd ZddZd Zd Zd Z d Z dS )r
a Base 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.
FNc 髮 | j | j d} | j di |}| | t j | fi | d S )N)
componentTypesizeSpecr )r r
_moveSizeSpecr r r' r# s r r' z ConstructedAsn1Type.__init__ sd ! /
$#--爁-- $++(+++++r c 髷 | d| j }|r*| d| j }|r|}n||z
}||d< |S )Nr r )r r r )r$ r% r r s r r z!ConstructedAsn1Type._moveSizeSpec s_ ::榡$-88 0 **燷癉4DEE圞
( & 榵' $/團= !
r c | j j d| j rdpdd}| j D ]\ }}|t
ur |d|d|z
}| j r1| j r*|dd d | j D z z
}d |z S )
Nr r, r r r =r c , g | ]}t | S r )repr)r xs r r z0ConstructedAsn1Type.__repr__.. s 222楺恆222r r )rd r rU r& r rC
componentsjoinr s r rb z ConstructedAsn1Type.__repr__ s 孨 # # #燭%=癵%I%I%I
=..00 < <塊圖%滸## ╰╰╰癠癠";; < 4楧淥 4 .22$/22224 24 4
4圢 &&r c | |u p
| j |k S r r r s r r zConstructedAsn1Type.__eq__! s 恥坿85 88r c | j |k S r r r s r r zConstructedAsn1Type.__ne__$ %''r c | j |k S r r r s r r zConstructedAsn1Type.__lt__' &&r c | j |k S r r r s r r zConstructedAsn1Type.__le__* r r c | j |k S r r r s r r zConstructedAsn1Type.__gt__- r r c | j |k S r r r s r r zConstructedAsn1Type.__ge__0 r r c * t | j S r )r r r0 s r r z ConstructedAsn1Type.__bool__3 s 怐擮$$$r c * t j d NzMethod not implementedru r0 s r r z ConstructedAsn1Type.components6 s 8999r c d S r r )r$ myClonecloneValueFlags r _cloneComponentValuesz)ConstructedAsn1Type._cloneComponentValues: r c 筘 | dd }| j }| | | j di |}|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.
r Fr )r r& r r rd r )r$ r% r r r s r r zConstructedAsn1Type.clone= sy . $4癳<<攠))++ 楩### .. .. > & &爑╪ = = = r c 笾 | j }| dd }| dd }| | j | |d< | dd }| | j | |d< | D ]\ }}||xx |z
cc< | j di |}|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.
r Fr Nr r r ) r& r r r r r r rd r ) r$ r% r r r r r r r s r r zConstructedAsn1Type.subtype` s 餞 攠))++ $4癳<< 梛抝 55 "%)%>%>竰%K%K圠 " 梛抝 55 "%)%>%>竰%K%K圠 "!<<>> ( (塊圕 ' .. .. > & &爑╪ = = = r c * t j d r ru )r$ idxs r getComponentByPositionz*ConstructedAsn1Type.getComponentByPosition 8999r Tc * t j d r ru )r$ r r, verifyConstraintss r setComponentByPositionz*ConstructedAsn1Type.setComponentByPosition r r c 骦 t | D ]
\ }}|| |< |D ]
}|| | |< | S r ) enumerate)r$ rv r% r r, ks r
setComponentsz!ConstructedAsn1Type.setComponents sI #燚// 塉圕 圖塈圛 圓 楺攊圖塆圙 r c d S r r r0 s r setDefaultComponentsz(ConstructedAsn1Type.setDefaultComponents r r c | j S r )r r0 s r getComponentTypez$ConstructedAsn1Type.getComponentType s !!r c 0 | | d S r rR r0 s r verifySizeSpecz"ConstructedAsn1Type.verifySizeSpec s r )T) r r r rX strictConstraintsr r rZ r r' r rb r r r r r r r r\ r r r r r r r r r r r r r r
r
s| M 2坺133H , , ,
'
'
' 9 9 9( ( (' ' '( ( (' ' '( ( (% % % : : 刋:
! ! !餏> > >餈: : :: : : :
" " " r r
)syspyasn1r pyasn1.typer r r __all__r r r Asn1ItemBaser_ rC r AbstractSimpleAsn1Itemr
AbstractConstructedAsn1Itemr r r r
s
" " " " " " " " "% % % % %坴 % % %E E E E E 坸 E E E 餚 G7 G7 G7 G7 G7坒 G7 G7 G7餞 '))PC PC PC PC PC怷 PC PC PC餱 ( ,Z Z Z Z Z ( Z Z Z 饇 2 r PK ! j,盼 $ __pycache__/__init__.cpython-311.pycnu 刐迭
辤; d S )N r 鷗/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/__init__.pyr s r PK ! 雐gg ! __pycache__/error.cpython-311.pycnu 刐迭
辤 . d dl mZ G d de ZdS ) ) PyAsn1Errorc e Zd ZdS )ValueConstraintErrorN)__name__
__module__ __qualname__ 鷔/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/error.pyr r
s Dr
r N) pyasn1.errorr r r r
r r
sM % $ $ $ $ $ ; r
PK ! 2顥 $ __pycache__/opentype.cpython-311.pycnu 刐迭
辤- ( d gZ G d d e ZdS )OpenTypec 骉 e Zd ZdZd dZed Zd Zd Zd Z d Z
d Z d
Z dS ) r a Create ASN.1 type map indexed by a value
The *OpenType* object models an untyped field of a constructed ASN.1
type. In ASN.1 syntax it is usually represented by the
`ANY DEFINED BY` for scalars or `SET OF ANY DEFINED BY`,
`SEQUENCE OF ANY DEFINED BY` for container types clauses. Typically
used together with :class:`~pyasn1.type.univ.Any` object.
OpenType objects duck-type a read-only Python :class:`dict` objects,
however the passed `typeMap` is not copied, but stored by reference.
That means the user can manipulate `typeMap` at run time having this
reflected on *OpenType* object behavior.
The |OpenType| class models an untyped field of a constructed ASN.1
type. In ASN.1 syntax it is usually represented by the
`ANY DEFINED BY` for scalars or `SET OF ANY DEFINED BY`,
`SEQUENCE OF ANY DEFINED BY` for container types clauses. Typically
used with :class:`~pyasn1.type.univ.Any` type.
Parameters
----------
name: :py:class:`str`
Field name
typeMap: :py:class:`dict`
A map of value->ASN.1 type. It's stored by reference and can be
mutated later to register new mappings.
Examples
--------
For untyped scalars:
.. code-block:: python
openType = OpenType(
'id', {1: Integer(),
2: OctetString()}
)
Sequence(
componentType=NamedTypes(
NamedType('id', Integer()),
NamedType('blob', Any(), openType=openType)
)
)
For untyped `SET OF` or `SEQUENCE OF` vectors:
.. code-block:: python
openType = OpenType(
'id', {1: Integer(),
2: OctetString()}
)
Sequence(
componentType=NamedTypes(
NamedType('id', Integer()),
NamedType('blob', SetOf(componentType=Any()),
openType=openType)
)
)
Nc 8 || _ | i | _ d S || _ d S N)_OpenType__name_OpenType__typeMap)selfnametypeMaps 鷗/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/opentype.py__init__zOpenType.__init__K s$ ? 圖孨圢圢 $圖孨圢圢 c | j S r )r r s r r z
OpenType.nameR s
寋r
c 4 | j S r )r valuesr s r r zOpenType.valuesX s 寏$$&&&r
c 4 | j S r )r keysr s r r z
OpenType.keys[ s 寏""$$$r
c 4 | j S r )r itemsr s r r zOpenType.items^ s 寏##%%%r
c || j v S r r r keys r __contains__zOpenType.__contains__a s 恉攏$$r
c | j | S r r r s r __getitem__zOpenType.__getitem__d s 寏榗""r
c * t | j S r )iterr r s r __iter__zOpenType.__iter__g s 怐擭###r
r )
__name__
__module__ __qualname____doc__r propertyr r r r r r r r
r r r s = =饉% % % % 刋
' ' '% % %& & &% % %# # #$ $ $ $ $r
N)__all__objectr r% r
r r( sL ,]$ ]$ ]$ ]$ ]$坴 ]$ ]$ ]$ ]$ ]$r
PK ! 茊凭|4 |4 __pycache__/tag.cpython-311.pycnu 刐迭
辤% 髚 d dl mZ g dZd ZdZdZdZd ZdZdZ dZ
d Z G d
d e Z
G d d
e Zd ZdS ) )error) tagClassUniversaltagClassApplicationtagClassContexttagClassPrivatetagFormatSimpletagFormatConstructedtagCategoryImplicittagCategoryExplicittagCategoryUntaggedTagTagSet锧 閫 槔 c 螈 e Zd ZdZd Zd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
d Zd
Zd Zed Zed Zed ZdS )r
a Create ASN.1 tag
Represents ASN.1 tag that can be attached to a ASN.1 type to make
types distinguishable from each other.
*Tag* objects are immutable and duck-type Python :class:`tuple` objects
holding three integer components of a tag.
Parameters
----------
tagClass: :py:class:`int`
Tag *class* value
tagFormat: :py:class:`int`
Tag *format* value
tagId: :py:class:`int`
Tag ID value
c 螽 |dk rt j d|z || _ || _ || _ ||f| _ t
| j | _ d S )Nr z Negative tag ID (%s) not allowed)r PyAsn1Error_Tag__tagClass_Tag__tagFormat _Tag__tagId_Tag__tagClassIdhash
_Tag__hash)selftagClass tagFormattagIds 鷒/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/tag.py__init__z Tag.__init__9 sZ 𐕏9#$F$NOO O"$ $爀極4,-- c 骬 d| j d| j d| j d}d| j j d|dS )N[:])r r r __class____name__r representations r# __repr__z Tag.__repr__B sI 孫圤圤楾 - - -╰瑋▅▅=
孨 # # #燸燸燸5 5r% c | j |k S Nr r others r# __eq__z
Tag.__eq__H 燛))r% c | j |k S r2 r3 r4 s r# __ne__z
Tag.__ne__K r7 r% c | j |k S r2 r3 r4 s r# __lt__z
Tag.__lt__N 5((r% c | j |k S r2 r3 r4 s r# __le__z
Tag.__le__Q r7 r% c | j |k S r2 r3 r4 s r# __gt__z
Tag.__gt__T r< r% c | j |k S r2 r3 r4 s r# __ge__z
Tag.__ge__W r7 r% c | j S r2 )r r s r# __hash__z Tag.__hash__Z
寋r% c 骬 |dk r| j S |dk r| j S |dk r| j S t )Nr r r )r r r
IndexError)r idxs r# __getitem__zTag.__getitem__] s< !88? "
怉奨圶# #
怉奨圶< r% c # 驚 K | j V | j V | j V d S r2 )r r r rD s r# __iter__z Tag.__iter__g s7 宱 宭r% c 髜 | | j |j z | j |j z | j |j z S r2 r, r r r r! r r" r otherTags r# __and__z Tag.__and__l > 弤妦榙渙0A A " .1C C "渓╔琟 ;= = =r% c 髜 | | j |j z | j |j z | j |j z S r2 rN rO s r# __or__z
Tag.__or__q rR r% c | j S )ziASN.1 tag class
Returns
-------
: :py:class:`int`
Tag class
)r rD s r# r z Tag.tagClassv s r% c | j S )zkASN.1 tag format
Returns
-------
: :py:class:`int`
Tag format
)r rD s r# r! z
Tag.tagFormat
r% c | j S )zcASN.1 tag ID
Returns
-------
: :py:class:`int`
Tag ID
)r rD s r# r" z Tag.tagId s 寍r% N)r-
__module__ __qualname____doc__r$ r0 r6 r9 r; r> r@ rB rE rJ rL rQ rT propertyr r! r" r% r# r
r
% s2 &. . .5 5 5 * * ** * *) ) )* * *) ) )* * *
= = =
= = =
刋 刋 刋 r% r
c 螃 e Zd ZdZddZd Zd Zd Zd Zd Z d Z
d
Z d Z d Z
d
Zd Zd Zed Zed Zd Zd Zd Zd ZdS )r a Create a collection of ASN.1 tags
Represents a combination of :class:`~pyasn1.type.tag.Tag` objects
that can be attached to a ASN.1 type to make types distinguishable
from each other.
*TagSet* objects are immutable and duck-type Python :class:`tuple` objects
holding arbitrary number of :class:`~pyasn1.type.tag.Tag` objects.
Parameters
----------
baseTag: :class:`~pyasn1.type.tag.Tag`
Base *Tag* object. This tag survives IMPLICIT tagging.
*superTags: :class:`~pyasn1.type.tag.Tag`
Additional *Tag* objects taking part in subtyping.
Examples
--------
.. code-block:: python
class OrderNumber(NumericString):
'''
ASN.1 specification
Order-number ::=
[APPLICATION 5] IMPLICIT NumericString
'''
tagSet = NumericString.tagSet.tagImplicitly(
Tag(tagClassApplication, tagFormatSimple, 5)
)
orderNumber = OrderNumber('1234')
r] c 蟾 || _ || _ t d |D | _ t | | _ t
| j | _ d S )Nc * g | ]}|j |j fS r] )r r" ).0superTags r#
z#TagSet.__init__.. s" K K K癤坔
0 K K Kr% )_TagSet__baseTag_TagSet__superTagstuple_TagSet__superTagsClassIdlen_TagSet__lenOfSuperTagsr
_TagSet__hash)r baseTag superTagss r# r$ zTagSet.__init__ sZ $"' K K K K K#
#
!$營 4233 r% c 髣 d d | j D }|rd|z }nd}d| j j d|dS )N-c 驚 g | ]}|j d |j d |j S )r( )r r! r" )ra xs r# rc z#TagSet.__repr__.. s? #> #> #>'( 23窺糩竅竅!''#R #> #> #>r% ztags untaggedr* z object, r+ )joinre r, r- r. s r# r0 zTagSet.__repr__ sh #> #>,0,<#> #> #> ? ? ( $爚 5圢圢 '圢$($;$;$;竈竈竈LLr% c : | j | j g| j |fz R S r2 r, rd re r rb s r# __add__zTagSet.__add__ s( 坱寏榙渘N╰/?8+/MNNNNr% c : | j | j g|f| j z R S r2 rt ru s r# __radd__zTagSet.__radd__ s( 坱寏榙渘N▄窽=M/MNNNNr% c 髏 |j t u r | j | j g| j | R S | j | S r2 )r, slicerd re )r is r# rJ zTagSet.__getitem__ sA ;% !4>$.GC繟3FGGG G#燗& &r% c | j |k S r2 rg r4 s r# r6 z
TagSet.__eq__ &%//r% c | j |k S r2 r} r4 s r# r9 z
TagSet.__ne__ r~ r% c | j |k S r2 r} r4 s r# r; z
TagSet.__lt__ &..r% c | j |k S r2 r} r4 s r# r> z
TagSet.__le__ r~ r% c | j |k S r2 r} r4 s r# r@ z
TagSet.__gt__ r r% c | j |k S r2 r} r4 s r# rB z
TagSet.__ge__ r~ r% c | j S r2 )rj rD s r# rE zTagSet.__hash__ rF r% c | j S r2 )ri rD s r# __len__zTagSet.__len__ s $$r% c | j S )z峈eturn base ASN.1 tag
Returns
-------
: :class:`~pyasn1.type.tag.Tag`
Base tag of this *TagSet*
rd rD s r# rk zTagSet.baseTag s 寏 r% c | j S )z甊eturn ASN.1 tags
Returns
-------
: :py:class:`tuple`
Tuple of :class:`~pyasn1.type.tag.Tag` objects that this *TagSet* contains
)re rD s r# rl zTagSet.superTags rW r% c 蟠 |j t k rt j d |j t
k r t
|j t
|j }| |z S )a Return explicitly tagged *TagSet*
Create a new *TagSet* representing callee *TagSet* explicitly tagged
with passed tag(s). With explicit tagging mode, new tags are appended
to existing tag(s).
Parameters
----------
superTag: :class:`~pyasn1.type.tag.Tag`
*Tag* object to tag this *TagSet*
Returns
-------
: :class:`~pyasn1.type.tag.TagSet`
New *TagSet* object
z"Can't tag with UNIVERSAL class tag)r r r r r! r r
r" ru s r#
tagExplicitlyzTagSet.tagExplicitly sU " 1 1 1#$HII I !5 5 58,.B繦腘SS圚恏 r% c 髝 | j r+t |j | j d j |j }| dd |z S )a Return implicitly tagged *TagSet*
Create a new *TagSet* representing callee *TagSet* implicitly tagged
with passed tag(s). With implicit tagging mode, new tag(s) replace the
last existing tag.
Parameters
----------
superTag: :class:`~pyasn1.type.tag.Tag`
*Tag* object to tag this *TagSet*
Returns
-------
: :class:`~pyasn1.type.tag.TagSet`
New *TagSet* object
N)re r
r r! r" ru s r#
tagImplicitlyzTagSet.tagImplicitly sD " ^8,╠.>竢.B.L萮蘮]]圚怌怰怌寉8##r% c 骹 t | | j k rdS | j |d| j k S )a Test type relationship against given *TagSet*
The callee is considered to be a supertype of given *TagSet*
tag-wise if all tags in *TagSet* are present in the callee and
they are in the same order.
Parameters
----------
tagSet: :class:`~pyasn1.type.tag.TagSet`
*TagSet* object to evaluate against the callee
Returns
-------
: :py:class:`bool`
:obj:`True` if callee is a supertype of *tagSet*
FN)rh ri re )r tagSets r# isSuperTagSetOfzTagSet.isSuperTagSetOf4 s9 " 坴;;. . .5 6*@4+@*@#AAAr% c | j S r2 r rD s r#
getBaseTagzTagSet.getBaseTagK s
寏 r% N)r] )r- rY rZ r[ r$ r0 rv rx rJ r6 r9 r; r> r@ rB rE r r\ rk rl r r r r r] r% r# r r se ! !餌4 4 4 4M M MO O OO O O' ' ' 0 0 00 0 0/ / /0 0 0/ / /0 0 0 % % % 刋 刋 .$ $ $*B B B. r% r c " t | | S r2 )r )tags r#
initTagSetr N s #恠 r% N)pyasn1r __all__r r r r r r r
r r objectr
r r r] r% r# r s 3 3 3 p p p p p & p p p 餱t t t t t 圴 t t t 餷 r% PK ! |莂c ac % __pycache__/namedtype.cpython-311.pycnu 刐迭
辤3? 螵 d dl Z d dlmZ d dlmZ d dlmZ g dZ G d de Z G d d e Z G d
d e Z
G d d
e Z dS ) N)error)tag)tagmap) NamedTypeOptionalNamedTypeDefaultedNamedType
NamedTypesc 蟋 e Zd ZdZdZdZddZd Zd Zd Z d Z
d Z d
Z d Z
d Zd
Zd Zed Zed Zed Zd Zd ZdS )r a Create named field object for a constructed ASN.1 type.
The |NamedType| object represents a single name and ASN.1 type of a constructed ASN.1 type.
|NamedType| objects are immutable and duck-type Python :class:`tuple` objects
holding *name* and *asn1Object* components.
Parameters
----------
name: :py:class:`str`
Field name
asn1Object:
ASN.1 type object
FNc 驜 || _ || _ ||f| _ || _ d S N)_NamedType__name_NamedType__type_NamedType__nameAndType_NamedType__openType)selfname
asn1ObjectopenTypes 鷘/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/namedtype.py__init__zNamedType.__init__# s( !: -" c 髍 | j d| j }| j r
|d| j z z
}d| j j d|dS )N=z, open type %r)r r r __class____name__r representations r __repr__zNamedType.__repr__) sS $(營營╰? = ? . > >圢
孨 # # #燸燸燸5 5r c | j |k S r r r others r __eq__zNamedType.__eq__2 !燯**r c | j |k S r r" r# s r __ne__zNamedType.__ne__5 r& r c | j |k S r r" r# s r __lt__zNamedType.__lt__8 !燛))r c | j |k S r r" r# s r __le__zNamedType.__le__; r& r c | j |k S r r" r# s r __gt__zNamedType.__gt__> r+ r c | j |k S r r" r# s r __ge__zNamedType.__ge__A r& r c * t | j S r )hashr r s r __hash__zNamedType.__hash__D 怐&'''r c | j | S r r" r idxs r __getitem__zNamedType.__getitem__G s !#&&r c * t | j S r )iterr r4 s r __iter__zNamedType.__iter__J r6 r c | j S r )r
r4 s r r zNamedType.nameM
寋r c | j S r )r r4 s r r zNamedType.asn1ObjectQ r? r c | j S r )r r4 s r r zNamedType.openTypeU s
r c | j S r r r4 s r getNamezNamedType.getName[ s
寉r c | j S r r r4 s r getTypezNamedType.getType^ s
r r )r
__module__ __qualname____doc__
isOptional isDefaultedr r r% r( r* r- r/ r1 r5 r: r= propertyr r r rD rG r r r r sC JK# # # # 5 5 5+ + ++ + +* * *+ + +* * *+ + +( ( (' ' '( ( ( 刋 刋 刋
r r c e Zd Zej ZdZdS )r TN)r rH rI r rJ rK rN r r r r b s GJJJr r c e Zd Zej ZdZdS )r TN)r rH rI r rJ rL rN r r r r h s GKKKr r c 髒 e Zd ZdZd Zd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
d Zd
Zd Zd Zd Zd Zd Zd Z G d de Zd Zd Zd Zd Zd Z d Z d Z d Z d Z d Z!e"d Z#d! Z$e"d" Z%e"d# Z&e"d$ Z'e"d% Z(e"d& Z)e"d' Z*d(S ))r a+ Create a collection of named fields for a constructed ASN.1 type.
The NamedTypes object represents a collection of named fields of a constructed ASN.1 type.
*NamedTypes* objects are immutable and duck-type Python :class:`dict` objects
holding *name* as keys and ASN.1 type object as values.
Parameters
----------
*namedTypes: :class:`~pyasn1.type.namedtype.NamedType`
Examples
--------
.. code-block:: python
class Description(Sequence):
'''
ASN.1 specification:
Description ::= SEQUENCE {
surname IA5String,
first-name IA5String OPTIONAL,
age INTEGER DEFAULT 40
}
'''
componentType = NamedTypes(
NamedType('surname', IA5String()),
OptionalNamedType('first-name', IA5String()),
DefaultedNamedType('age', Integer(40))
)
descr = Description()
descr['surname'] = 'Smith'
descr['first-name'] = 'John'
c 驞 || _ t | j | _ | | _ | | _ | | _ d|vr| pi | _
| d | _ | d | _
t d | j D | _ t d | j D | _ t# d t% | j D | _ t# d | j D | _ t+ d | j D | _ t+ d
| j D | _ d S ) NterminalT)uniqueFc . g | ]}|j s|j d S T)rL rK .0 namedTypes r
z'NamedTypes.__init__.. sB +] +] +]癐.7.C+]谿P訥[+]4 +] +] +]r c g | ] }|j d S rV )r rW s r rZ z'NamedTypes.__init__.. s/ #: #: #:↖&/&8#:4 #: #: #:r c 4 g | ]\ }}|j |j |S rN )rK rL )rX r9 nts r rZ z'NamedTypes.__init__.. s, mmm榖
m衈`証lmmmmr c g | ] }|j
S rN rC rW s r rZ z'NamedTypes.__init__.. s S S S癐 S S Sr c g | ] }|j
S rN rF rW s r rZ z'NamedTypes.__init__.. s W W W 榶 3 W W Wr c * g | ]}|j |j fS rN )r r rW s r rZ z'NamedTypes.__init__.. s" h h h榶渵▂/C D h h hr )_NamedTypes__namedTypeslen_NamedTypes__namedTypesLen _NamedTypes__computeMinTagSet_NamedTypes__minTagSet _NamedTypes__computeNameToPosMap_NamedTypes__nameToPosMap _NamedTypes__computeTagToPosMap_NamedTypes__tagToPosMap"_NamedTypes__computeAmbiguousTypes_NamedTypes__ambiguousTypes_NamedTypes__computeTagMaps_NamedTypes__uniqueTagMap _NamedTypes__nonUniqueTagMapany!_NamedTypes__hasOptionalOrDefault_NamedTypes__hasOpenTypes frozenset enumerate _NamedTypes__requiredComponents_NamedTypes__keystuple_NamedTypes__values_NamedTypes__items)r
namedTypeskwargss r r zNamedTypes.__init__ s & "4#4 5 5 2244 " 8 8 : : ! 6 6 8 8 *& 8 [窽=Y=Y=[=[ a衉a " 3 34 3 @ @!%!6!6竐!6!D!D &) +] +]訟R +] +] +] '^ '^# ! #: #:9J #: #: #: ; ; %.mm╠.?$@$@mmm% %! S S訟R S S STT W W繲訣V W W WXX
h h蠽Z訴g h h hii r c 髉 d d | j D }d| j j d|dS )Nz, c g | ]}d |z S )z%rrN rX xs r rZ z'NamedTypes.__repr__.. s #H#H#H燚1#H#H#Hr r z object, types r )joinra r r r s r r zNamedTypes.__repr__ sE #H#H癲6G#H#H#HII 孨 # # #燸燸燸5 5r c | j |k S r ra r# s r r% zNamedTypes.__eq__ 燛))r c | j |k S r r r# s r r( zNamedTypes.__ne__ r r c | j |k S r r r# s r r* zNamedTypes.__lt__ 5((r c | j |k S r r r# s r r- zNamedTypes.__le__ r r c | j |k S r r r# s r r/ zNamedTypes.__gt__ r r c | j |k S r r r# s r r1 zNamedTypes.__ge__ r r c * t | j S r )r3 ra r4 s r r5 zNamedTypes.__hash__ s 怐%&&&r c 髇 | j | S # t $ r | j | j | cY S w xY wr )ra TypeErrorrg r8 s r r: zNamedTypes.__getitem__ sL ?$燬) ) ? ? ?$燭%8%=> > > > ?鴖 "44c || j v S r )rg )r keys r __contains__zNamedTypes.__contains__ s 恉)))r c $ d | j D S )Nc 3 & K | ] }|d V
dS )r NrN r} s r z&NamedTypes.__iter__.. s& 00!000000r r r4 s r r= zNamedTypes.__iter__ s 00榙 /0000r c | j dk S )Nr rc r4 s r __bool__zNamedTypes.__bool__ s #燼''r c | j S r r r4 s r __len__zNamedTypes.__len__ s ##r c | j S r )rw r4 s r valueszNamedTypes.values s
寎 r c | j S r )ru r4 s r keyszNamedTypes.keys s
寋r c | j S r )rx r4 s r itemszNamedTypes.items s
寍r c | j | j S r )r ra r4 s r clonezNamedTypes.clone s 坱寏榯 011r c e Zd Zd Zd ZdS )NamedTypes.PostponedErrorc || _ d S r )_PostponedError__errorMsg)r errorMsgs r r z"NamedTypes.PostponedError.__init__ s
&圖孫圤圤r c 4 t j | j r )r PyAsn1Errorr )r items r r: z%NamedTypes.PostponedError.__getitem__ s $燭55 5r N)r rH rI r r: rN r r PostponedErrorr s2 ' ' ' 6 6 6 6 6r r c i }t | j D ]i\ }}|j j }t |t
j r|c S |s2|j D ]/}||v r$t
d|d| c c S |||< 0宩|S )NzDuplicate component tag at )rs ra r tagMap
isinstancer r presentTypes)r tagToPosMapr9 rY r _tagSets r __computeTagToPosMapz NamedTypes.__computeTagToPosMap s '(9 : : + +塏圕 )0團&*";<<
!.
+
+榢))%444衃b衃b衃b衐m衐m5nooooooo'* 楪$$
+
r c 蟛 i }t | j D ]?\ }}|j |v r't d|j d| c S |||j < 孈|S )NzDuplicate component name r )rs ra r r r )r nameToPosMapr9 rY s r __computeNameToPosMapz NamedTypes.__computeNameToPosMap sw '(9 : : / /塏圕寏 --!000蠿a訶f蠿f蠿f衕q衕q1rsssss+.圠 ( (r c 6 i }d}t t t | j D ]e\ }}|j s|j r|f|z }n|f}t
| t
| j k r| ||< 孒t |i t d ||< 宖|S )NrN T)rS ) reversedrv rs ra rK rL rb r dict)r ambiguousTypespartialAmbiguousTypesr9 rY s r __computeAmbiguousTypesz"NamedTypes.__computeAmbiguousTypes s " &璝皌7H-I-I'J'J K K ` `塏圕#
5爕'<
5)2 7L(L%%)2 %())璖1B-C-CCC&*榮##&02G&_4衁]蠯^袺^訩^&_&_榮## r c 髄 | j | j S # t $ r t j d w xY w)aT Return ASN.1 type object by its position in fields set.
Parameters
----------
idx: :py:class:`int`
Field index
Returns
-------
:
ASN.1 type
Raises
------
~pyasn1.error.PyAsn1Error
If given position is out of fields range
Type position out of range)ra r
IndexErrorr r r8 s r getTypeByPositionz NamedTypes.getTypeByPosition sJ $ B$燬)4 4 B B B#$@AA A B 3c 骿 | j | S # t $ r t j d|d w xY w)a Return field position by its ASN.1 type.
Parameters
----------
tagSet: :class:`~pysnmp.type.tag.TagSet`
ASN.1 tag set distinguishing one ASN.1 type from others.
Returns
-------
: :py:class:`int`
ASN.1 type position in fields set
Raises
------
~pyasn1.error.PyAsn1Error
If *tagSet* is not present or ASN.1 types are not unique within callee *NamedTypes*
zType
not found)ri KeyErrorr r )r tagSets r getPositionByTypez NamedTypes.getPositionByType( sP $ E%爁- - E E E##6$CDD D E #2c 髄 | j | j S # t $ r t j d w xY w)an Return field name by its position in fields set.
Parameters
----------
idx: :py:class:`idx`
Field index
Returns
-------
: :py:class:`str`
Field name
Raises
------
~pyasn1.error.PyAsn1Error
If given field name is not present in callee *NamedTypes*
r )ra r r r r r8 s r getNameByPositionz NamedTypes.getNameByPosition@ sJ $ B$燬). . B B B#$@AA A B鴕 c 骿 | j | S # t $ r t j d|d w xY w)a| Return field position by filed name.
Parameters
----------
name: :py:class:`str`
Field name
Returns
-------
: :py:class:`int`
Field position in fields set
Raises
------
~pyasn1.error.PyAsn1Error
If *name* is not present or not unique within callee *NamedTypes*
zName r )rg r r r )r r s r getPositionByNamez NamedTypes.getPositionByNameX sP $ C&爐, , C C C##4$ABB B C鴕 c 髄 | j | j S # t $ r t j d w xY w)a Return ASN.1 types that are allowed at or past given field position.
Some ASN.1 serialisation allow for skipping optional and defaulted fields.
Some constructed ASN.1 types allow reordering of the fields. When recovering
such objects it may be important to know which types can possibly be
present at any given position in the field sets.
Parameters
----------
idx: :py:class:`int`
Field index
Returns
-------
: :class:`~pyasn1.type.tagmap.TagMap`
Map if ASN.1 types allowed at given field position
Raises
------
~pyasn1.error.PyAsn1Error
If given position is out of fields range
r )rk r r r r r8 s r getTagMapNearPositionz NamedTypes.getTagMapNearPositionp sJ . B(-4 4 B B B#$@AA A B鴕 c 髱 || j | | z S # t $ r t j d w xY w)a Return the closest field position where given ASN.1 type is allowed.
Some ASN.1 serialisation allow for skipping optional and defaulted fields.
Some constructed ASN.1 types allow reordering of the fields. When recovering
such objects it may be important to know at which field position, in field set,
given *tagSet* is allowed at or past *idx* position.
Parameters
----------
tagSet: :class:`~pyasn1.type.tag.TagSet`
ASN.1 type which field position to look up
idx: :py:class:`int`
Field position at or past which to perform ASN.1 type look up
Returns
-------
: :py:class:`int`
Field position in fields set
Raises
------
~pyasn1.error.PyAsn1Error
If *tagSet* is not present or not unique within callee *NamedTypes*
or *idx* is out of fields range
r )rk r r r r )r r r9 s r getPositionNearTypez NamedTypes.getPositionNearType sZ 6 B.╯3EE纅MMM M B B B#$@AA A B鴖 "% Ac 螃 d }| j D ]3}|j } |j }n# t $ r
|j }Y nw xY w|||k r|}4|pt j S r )ra r minTagSetAttributeErrorr r TagSet)r r rY r r s r __computeMinTagSetz NamedTypes.__computeMinTagSet s *
#
#圛"-圝
+#-!
+
+
+#*
+ 燜╕$6$6 " (滳淛橪淟(s 00c | j S )a Return the minimal TagSet among ASN.1 type in callee *NamedTypes*.
Some ASN.1 types/serialisation protocols require ASN.1 types to be
arranged based on their numerical tag value. The *minTagSet* property
returns that.
Returns
-------
: :class:`~pyasn1.type.tagset.TagSet`
Minimal TagSet among ASN.1 types in callee *NamedTypes*
)re r4 s r r zNamedTypes.minTagSet s
r c
螽 i }i }d }| j D ]瞹|j j }t |t j r|c S |D ]9}|r+||v r't d|d|d| c c S |j ||< :| |j ||j }寣|j t d| c S 尦t j
||| S )NzNon-unique tagSet z of r z Duplicate default ASN.1 type at ) ra r r r r r update skipTypes defaultTyper TagMap)r rT r r r rY r r s r __computeTagMapszNamedTypes.__computeTagMaps s+ *
a
a圛 )0團&*";<<
<
< u榝 4 4%444衃a衃a衃a衏l衏l衏l衝r衝r5sttttttt'0'; 榁$$ 榁 - . . ." $ 0 #/!000衁]衁]1_````` 0 寎榎9発BBBr c | j S )a Return a *TagMap* object from tags and types recursively.
Return a :class:`~pyasn1.type.tagmap.TagMap` object by
combining tags from *TagMap* objects of children types and
associating them with their immediate child type.
Example
-------
.. code-block:: python
OuterType ::= CHOICE {
innerType INTEGER
}
Calling *.tagMap* on *OuterType* will yield a map like this:
.. code-block:: python
Integer.tagSet -> Choice
)rn r4 s r r zNamedTypes.tagMap s
, %%r c | j S )a Return a *TagMap* object from unique tags and types recursively.
Return a :class:`~pyasn1.type.tagmap.TagMap` object by
combining tags from *TagMap* objects of children types and
associating them with their immediate child type.
Example
-------
.. code-block:: python
OuterType ::= CHOICE {
innerType INTEGER
}
Calling *.tagMapUnique* on *OuterType* will yield a map like this:
.. code-block:: python
Integer.tagSet -> Choice
Note
----
Duplicate *TagSet* objects found in the tree of children
types would cause error.
)rm r4 s r tagMapUniquezNamedTypes.tagMapUnique s
8 ""r c | j S r )rp r4 s r hasOptionalOrDefaultz NamedTypes.hasOptionalOrDefault s **r c | j S r )rq r4 s r hasOpenTypeszNamedTypes.hasOpenTypes s ""r c * t | j S r )rv ra r4 s r ry zNamedTypes.namedTypes s 怲&'''r c | j S r )rt r4 s r requiredComponentsz NamedTypes.requiredComponents$ s ((r N)+r rH rI rJ r r r% r( r* r- r/ r1 r5 r: r r= r r r r r r objectr rh rf rj r r r r r r rd rM r rl r r r r ry r rN r r r r n s # #餒j j j*5 5 5
* * ** * *) ) )* * *) ) )* * *' ' '? ? ?* * *1 1 1( ( ($ $ $
2 2 26 6 6 6 6 6 6 6
B B B0E E E0B B B0C C C0B B B: B B B養) ) ) 刋 C C C* & & 刋&. # # 刋#: + + 刋+ # # 刋# ( ( 刋( ) ) 刋) ) )r r ) syspyasn1r pyasn1.typer r __all__r r r r r rN r r r s
O O O O O O O O 餯 x) x) x) x) x) x) x) x) x) x)r PK ! 4譏紆 紆 & __pycache__/constraint.cpython-311.pycnu 刐迭
辤沀 螵 d dl Z d dlmZ g dZ G d de Z G d de Z G d d e Z G d
d e Z G d d
e Z G d de Z
G d de Z G d de Z G d de Z
G d de Z G d de Z G d de Z G d d e Z G d d e ZdS ) N)error) SingleValueConstraintContainedSubtypeConstraintValueRangeConstraintValueSizeConstraintPermittedAlphabetConstraintInnerTypeConstraintConstraintsExclusionConstraintsIntersectionConstraintsUnionc 髉 e Zd Zd ZddZd Zd Zd Zd Zd Z d Z
d
Z d Z d Z
d
Zd Zd Zd Zd ZdS )AbstractConstraintc 鬆 t | _ | | t | j j | j f | _ d S N)set _valueMap
_setValueshash __class____name___values_AbstractConstraint__hashselfvaluess 鷙/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/constraint.py__init__zAbstractConstraint.__init__ s> 楧淣 3癟碶BCC Nc 螃 | j sd S | || d S # t j $ r }t j | d| d }~ww xY w)Nz failed at: )r
_testValuer ValueConstraintError)r valueidxexcs r __call__zAbstractConstraint.__call__ su 寍 團 廜奜楨3 ' ' ' ' ') ,&*燿燿––0
鴖 # AA Ac 髮 d| j j z }| j r*|dd d | j D z z
}d|z S )Nz %s objectz , consts %sz, c , g | ]}t | S )repr).0xs r
z/AbstractConstraint.__repr__.., s ///楺恆///r z<%s>)r r r join)r representations r __repr__zAbstractConstraint.__repr__' s\ $(?@ < 1 榤╠痠猧//$,////1 /1 1
1圢 &&r c $ | |u rdS | j |k S )NTr r others r __eq__zAbstractConstraint.__eq__0 s 5==4寍榰$$r c | j |k S r r1 r2 s r __ne__zAbstractConstraint.__ne__5 寍榰$$r c | j |k S r r1 r2 s r __lt__zAbstractConstraint.__lt__8 寍榚##r c | j |k S r r1 r2 s r __le__zAbstractConstraint.__le__; r7 r c | j |k S r r1 r2 s r __gt__zAbstractConstraint.__gt__> r: r c | j |k S r r1 r2 s r __ge__zAbstractConstraint.__ge__A r7 r c * t | j S r )boolr r s r __bool__zAbstractConstraint.__bool__D 怐擫!!!r c | j S r )r rC s r __hash__zAbstractConstraint.__hash__G s
寋r c || _ d S r r1 r s r r z AbstractConstraint._setValuesJ s
r c * t j | r r r! r r" r# s r r z AbstractConstraint._testValueM s (///r c | j S r r rC s r getValueMapz AbstractConstraint.getValueMapQ s
寏 r c 驲 || u p#| j p|| k p| | v S r )r rN r otherConstraints r
isSuperTypeOfz AbstractConstraint.isSuperTypeOfT sD 4' 6擫 6 4'6 33555 7r c . || u p| p|| k p|| j v S r rM rP s r isSubTypeOfz AbstractConstraint.isSubTypeOf[ s7 4' 22 4'2 4>1 3r r )r
__module__ __qualname__r r% r/ r4 r6 r9 r< r> r@ rD rG r r rN rR rT r( r r r r s D D D
' ' '% % %
% % %$ $ $% % %$ $ $% % %" " " 0 0 0 7 7 73 3 3 3 3r r c 6 e Zd ZdZd Zd Zd Zd Zd Zd Z dS ) r a Create a SingleValueConstraint object.
The SingleValueConstraint satisfies any value that
is present in the set of permitted values.
Objects of this type are iterable (emitting constraint values) and
can act as operands for some arithmetic operations e.g. addition
and subtraction. The latter can be used for combining multiple
SingleValueConstraint objects into one.
The SingleValueConstraint object can be applied to
any ASN.1 type.
Parameters
----------
*values: :class:`int`
Full set of values permitted by this constraint object.
Examples
--------
.. code-block:: python
class DivisorOfSix(Integer):
'''
ASN.1 specification:
Divisor-Of-6 ::= INTEGER (1 | 2 | 3 | 6)
'''
subtypeSpec = SingleValueConstraint(1, 2, 3, 6)
# this will succeed
divisor_of_six = DivisorOfSix(1)
# this will raise ValueConstraintError
divisor_of_six = DivisorOfSix(7)
c < || _ t | | _ d S r r r _setr s r r z SingleValueConstraint._setValues 慘擪 r c 驚 || j vrt j | d S r )rZ r r! rK s r r z SingleValueConstraint._testValue s( ! !,║33 3 " !r c || j v S r )rZ )r items r __contains__z"SingleValueConstraint.__contains__ s 恡攜 r c * t | j S r )iterrZ rC s r __iter__z SingleValueConstraint.__iter__ s 怐擨 r c 驠 | j | j | S r )r rZ unionr
constraints r __add__z SingleValueConstraint.__add__ s 坱寏
; ;==r c 驠 | j | j | S r )r rZ
differencere s r __sub__z SingleValueConstraint.__sub__ s! 坱寏 4 4癦 @ @BBr N)
r rU rV __doc__r r r_ rb rg rj r( r r r r b s~ # #餒 4 4 4 ! ! ! > > >C C C C Cr r c e Zd ZdZd ZdS )r a Create a ContainedSubtypeConstraint object.
The ContainedSubtypeConstraint satisfies any value that
is present in the set of permitted values and also
satisfies included constraints.
The ContainedSubtypeConstraint object can be applied to
any ASN.1 type.
Parameters
----------
*values:
Full set of values and constraint objects permitted
by this constraint object.
Examples
--------
.. code-block:: python
class DivisorOfEighteen(Integer):
'''
ASN.1 specification:
Divisors-of-18 ::= INTEGER (INCLUDES Divisors-of-6 | 9 | 18)
'''
subtypeSpec = ContainedSubtypeConstraint(
SingleValueConstraint(1, 2, 3, 6), 9, 18
)
# this will succeed
divisor_of_eighteen = DivisorOfEighteen(9)
# this will raise ValueConstraintError
divisor_of_eighteen = DivisorOfEighteen(10)
c 髽 | j D ]A}t |t r
||| $|| j vrt j | 孊d S r )r
isinstancer rZ r r! r r" r# rf s r r z%ContainedSubtypeConstraint._testValue sh , 8 8圝*&899
8
5#&&&&榙渋''0777 ( 8 8r Nr rU rV rk r r( r r r r s. " "餏8 8 8 8 8r r c e Zd ZdZd Zd ZdS )r a{ Create a ValueRangeConstraint object.
The ValueRangeConstraint satisfies any value that
falls in the range of permitted values.
The ValueRangeConstraint object can only be applied
to :class:`~pyasn1.type.univ.Integer` and
:class:`~pyasn1.type.univ.Real` types.
Parameters
----------
start: :class:`int`
Minimum permitted value in the range (inclusive)
end: :class:`int`
Maximum permitted value in the range (inclusive)
Examples
--------
.. code-block:: python
class TeenAgeYears(Integer):
'''
ASN.1 specification:
TeenAgeYears ::= INTEGER (13 .. 19)
'''
subtypeSpec = ValueRangeConstraint(13, 19)
# this will succeed
teen_year = TeenAgeYears(18)
# this will raise ValueConstraintError
teen_year = TeenAgeYears(20)
c 骦 || j k s || j k rt j | d S r )startstopr r! rK s r r z ValueRangeConstraint._testValue s4 4: !2!2,║33 3 "3!2r c 驜 t | dk r!t j | j j d |\ | _ | _ | j | j k r0t j | j j d| j d| j t | | d S )N z: bad constraint valuesz,: screwed constraint values (start > stop): z > ) lenr PyAsn1Errorr r rs rt r r r s r r z ValueRangeConstraint._setValues s 坴;;! #/3瑍/F/F/FH
!'
怐擨 : ! !#擭+++擩怞怞
%%燿‵33333r Nr rU rV rk r r r( r r r r s= " "餏4 4 4
4
4
4
4
4r r c e Zd ZdZd ZdS )r a Create a ValueSizeConstraint object.
The ValueSizeConstraint satisfies any value for
as long as its size falls within the range of
permitted sizes.
The ValueSizeConstraint object can be applied
to :class:`~pyasn1.type.univ.BitString`,
:class:`~pyasn1.type.univ.OctetString` (including
all :ref:`character ASN.1 types `),
:class:`~pyasn1.type.univ.SequenceOf`
and :class:`~pyasn1.type.univ.SetOf` types.
Parameters
----------
minimum: :class:`int`
Minimum permitted size of the value (inclusive)
maximum: :class:`int`
Maximum permitted size of the value (inclusive)
Examples
--------
.. code-block:: python
class BaseballTeamRoster(SetOf):
'''
ASN.1 specification:
BaseballTeamRoster ::= SET SIZE (1..25) OF PlayerNames
'''
componentType = PlayerNames()
subtypeSpec = ValueSizeConstraint(1, 25)
# this will succeed
team = BaseballTeamRoster()
team.extend(['Jan', 'Matej'])
encode(team)
# this will raise ValueConstraintError
team = BaseballTeamRoster()
team.extend(['Jan'] * 26)
encode(team)
Note
----
Whenever ValueSizeConstraint is applied to mutable types
(e.g. :class:`~pyasn1.type.univ.SequenceOf`,
:class:`~pyasn1.type.univ.SetOf`), constraint
validation only happens at the serialisation phase rather
than schema instantiation phase (as it is with immutable
types).
c 髕 t | }|| j k s || j k rt j | d S r )rw rs rt r r! )r r" r# valueSizes r r z ValueSizeConstraint._testValue8 s? 慗擩 恡攝 ! !燳%:%:,║33 3 &;%:r Nrp r( r r r r s. 4 4餵4 4 4 4 4r r c e Zd ZdZd Zd ZdS )r a Create a PermittedAlphabetConstraint object.
The PermittedAlphabetConstraint satisfies any character
string for as long as all its characters are present in
the set of permitted characters.
Objects of this type are iterable (emitting constraint values) and
can act as operands for some arithmetic operations e.g. addition
and subtraction.
The PermittedAlphabetConstraint object can only be applied
to the :ref:`character ASN.1 types ` such as
:class:`~pyasn1.type.char.IA5String`.
Parameters
----------
*alphabet: :class:`str`
Full set of characters permitted by this constraint object.
Example
-------
.. code-block:: python
class BooleanValue(IA5String):
'''
ASN.1 specification:
BooleanValue ::= IA5String (FROM ('T' | 'F'))
'''
subtypeSpec = PermittedAlphabetConstraint('T', 'F')
# this will succeed
truth = BooleanValue('T')
truth = BooleanValue('TF')
# this will raise ValueConstraintError
garbage = BooleanValue('TAF')
ASN.1 `FROM ... EXCEPT ...` clause can be modelled by combining multiple
PermittedAlphabetConstraint objects into one:
Example
-------
.. code-block:: python
class Lipogramme(IA5String):
'''
ASN.1 specification:
Lipogramme ::=
IA5String (FROM (ALL EXCEPT ("e"|"E")))
'''
subtypeSpec = (
PermittedAlphabetConstraint(*string.printable) -
PermittedAlphabetConstraint('e', 'E')
)
# this will succeed
lipogramme = Lipogramme('A work of fiction?')
# this will raise ValueConstraintError
lipogramme = Lipogramme('Eel')
Note
----
Although `ConstraintsExclusion` object could seemingly be used for this
purpose, practically, for it to work, it needs to represent its operand
constraints as sets and intersect one with the other. That would require
the insight into the constraint values (and their types) that are otherwise
hidden inside the constraint object.
Therefore it's more practical to model `EXCEPT` clause at
`PermittedAlphabetConstraint` level instead.
c < || _ t | | _ d S r rY r s r r z&PermittedAlphabetConstraint._setValues r[ r c 骲 | j | st j | d S r )rZ
issupersetr r! rK s r r z&PermittedAlphabetConstraint._testValue s5 寉##燛** 4,║33 3 4 4r Nr rU rV rk r r r( r r r r > s? I I餞 4 4 4 4 4r r c e Zd ZdZd Zd ZdS )ComponentPresentConstrainta Create a ComponentPresentConstraint object.
The ComponentPresentConstraint is only satisfied when the value
is not `None`.
The ComponentPresentConstraint object is typically used with
`WithComponentsConstraint`.
Examples
--------
.. code-block:: python
present = ComponentPresentConstraint()
# this will succeed
present('whatever')
# this will raise ValueConstraintError
present(None)
c 驚 d| _ |rt j d d S )N)zNo arguments expectedr r rx r s r r z%ComponentPresentConstraint._setValues s- - =#$;<< < = =r c 2 |t j d d S )NzComponent is not present:rJ rK s r r z%ComponentPresentConstraint._testValue s& =,+- -
- =r Nr r( r r r r s< (= = = - - - - -r r c e Zd ZdZd Zd ZdS )ComponentAbsentConstrainta Create a ComponentAbsentConstraint object.
The ComponentAbsentConstraint is only satisfied when the value
is `None`.
The ComponentAbsentConstraint object is typically used with
`WithComponentsConstraint`.
Examples
--------
.. code-block:: python
absent = ComponentAbsentConstraint()
# this will succeed
absent(None)
# this will raise ValueConstraintError
absent('whatever')
c 驚 d| _ |rt j d d S )N)zr r r s r r z$ComponentAbsentConstraint._setValues s- , =#$;<< < = =r c 8 |t j d|z d S )NzComponent is not absent: %rrJ rK s r r z$ComponentAbsentConstraint._testValue s- ,-57 7
7 r Nr r( r r r r s< (= = = 7 7 7 7 7r r c e Zd ZdZd Zd ZdS )WithComponentsConstrainta& Create a WithComponentsConstraint object.
The `WithComponentsConstraint` satisfies any mapping object that has
constrained fields present or absent, what is indicated by
`ComponentPresentConstraint` and `ComponentAbsentConstraint`
objects respectively.
The `WithComponentsConstraint` object is typically applied
to :class:`~pyasn1.type.univ.Set` or
:class:`~pyasn1.type.univ.Sequence` types.
Parameters
----------
*fields: :class:`tuple`
Zero or more tuples of (`field`, `constraint`) indicating constrained
fields.
Notes
-----
On top of the primary use of `WithComponentsConstraint` (ensuring presence
or absence of particular components of a :class:`~pyasn1.type.univ.Set` or
:class:`~pyasn1.type.univ.Sequence`), it is also possible to pass any other
constraint objects or their combinations. In case of scalar fields, these
constraints will be verified in addition to the constraints belonging to
scalar components themselves. However, formally, these additional
constraints do not change the type of these ASN.1 objects.
Examples
--------
.. code-block:: python
class Item(Sequence): # Set is similar
'''
ASN.1 specification:
Item ::= SEQUENCE {
id INTEGER OPTIONAL,
name OCTET STRING OPTIONAL
} WITH COMPONENTS id PRESENT, name ABSENT | id ABSENT, name PRESENT
'''
componentType = NamedTypes(
OptionalNamedType('id', Integer()),
OptionalNamedType('name', OctetString())
)
withComponents = ConstraintsUnion(
WithComponentsConstraint(
('id', ComponentPresentConstraint()),
('name', ComponentAbsentConstraint())
),
WithComponentsConstraint(
('id', ComponentAbsentConstraint()),
('name', ComponentPresentConstraint())
)
)
item = Item()
# This will succeed
item['id'] = 1
# This will succeed
item.reset()
item['name'] = 'John'
# This will fail (on encoding)
item.reset()
descr['id'] = 1
descr['name'] = 'John'
c 骪 | j D ]#\ }} || | $d S r )r get)r r" r# fieldrf s r r z#WithComponentsConstraint._testValue sA !% ) ) 圗: 圝恥梱抷'' ( ( ( ( ) )r c < t | | d S r r r r s r r z#WithComponentsConstraint._setValues %%燿‵33333r Nry r( r r r r s? E E餖) ) )4 4 4 4 4r r c e Zd ZdZd Zd ZdS )r z4Value must satisfy the type and presence constraintsc 篪 | j r| | d S | j rT|| j vrt j | | j | \ }}|dk rt j | || d S d S )NABSENT)*_InnerTypeConstraint__singleTypeConstraint,_InnerTypeConstraint__multipleTypeConstraintr r! )r r" r# rf statuss r r z InnerTypeConstraint._testValue' s & ' ' . . . . .
* $7770777!%!>竤!C 圝!!0777 圝恥
r c 筘 i | _ d | _ |D ]=}t |t r |d |d f| j |d < 6|| _ >t | | d S )N rv r )r r rn tupler r )r r vs r r z InnerTypeConstraint._setValues2 sz (*%&*# 0 0圓!漊##
067磀窤竌糄癹-╝琩33./++%%燿‵33333r Nry r( r r r r $ s8 >> 4 4 4 4 4r r c e Zd ZdZd Zd ZdS )r
a Create a ConstraintsExclusion logic operator object.
The ConstraintsExclusion logic operator succeeds when the
value does *not* satisfy the operand constraint.
The ConstraintsExclusion object can be applied to
any constraint and logic operator object.
Parameters
----------
*constraints:
Constraint or logic operator objects.
Examples
--------
.. code-block:: python
class LuckyNumber(Integer):
subtypeSpec = ConstraintsExclusion(
SingleValueConstraint(13)
)
# this will succeed
luckyNumber = LuckyNumber(12)
# this will raise ValueConstraintError
luckyNumber = LuckyNumber(13)
Note
----
The `FROM ... EXCEPT ...` ASN.1 clause should be modeled by combining
constraint objects into one. See `PermittedAlphabetConstraint` for more
information.
c 髥 | j D ]8} ||| n# t j $ r Y !w xY wt j | d S r r r r! ro s r r z ConstraintsExclusion._testValueb sm , 4 4圝
5#&&&&-
,║33 3 4 4s **c < t | | d S r r r s r r z ConstraintsExclusion._setValuesl r r Nry r( r r r
r
? s= ! !餌4 4 44 4 4 4 4r r
c 2 e Zd Zd Zd Zd Zd Zd Zd ZdS )AbstractConstraintSetc | j | S r r1 )r r# s r __getitem__z!AbstractConstraintSet.__getitem__r s 寍楥 r c * t | j S r )ra r rC s r rb z AbstractConstraintSet.__iter__u rE r c ( | j | j |fz S r r r r r" s r rg z AbstractConstraintSet.__add__x s 坱寏 ▁ 799r c ( | j |f| j z S r r r s r __radd__z AbstractConstraintSet.__radd__{ s 坱寏4< 799r c * t | j S r )rw r rC s r __len__z AbstractConstraintSet.__len__~ s 4< r c 螽 || _ |D ]J}|rF| j | | j | 孠d S r )r r addupdaterN )r r rf s r r z AbstractConstraintSet._setValues sh @ @圝
@"":...%%爅&<&<&>&>??? @ @r N) r rU rV r rb rg r r r r( r r r r p ss ! ! !" " ": : :: : :! ! !
@ @ @ @ @r r c e Zd ZdZd ZdS )r a7 Create a ConstraintsIntersection logic operator object.
The ConstraintsIntersection logic operator only succeeds
if *all* its operands succeed.
The ConstraintsIntersection object can be applied to
any constraint and logic operator objects.
The ConstraintsIntersection object duck-types the immutable
container object like Python :py:class:`tuple`.
Parameters
----------
*constraints:
Constraint or logic operator objects.
Examples
--------
.. code-block:: python
class CapitalAndSmall(IA5String):
'''
ASN.1 specification:
CapitalAndSmall ::=
IA5String (FROM ("A".."Z"|"a".."z"))
'''
subtypeSpec = ConstraintsIntersection(
PermittedAlphabetConstraint('A', 'Z'),
PermittedAlphabetConstraint('a', 'z')
)
# this will succeed
capital_and_small = CapitalAndSmall('Hello')
# this will raise ValueConstraintError
capital_and_small = CapitalAndSmall('hello')
c 2 | j D ]} ||| d S r r1 ro s r r z"ConstraintsIntersection._testValue s2 , # #圝 圝恥榗 " " " " # #r Nrp r( r r r r s. % %餖# # # # #r r c e Zd ZdZd ZdS )r a Create a ConstraintsUnion logic operator object.
The ConstraintsUnion logic operator succeeds if
*at least* a single operand succeeds.
The ConstraintsUnion object can be applied to
any constraint and logic operator objects.
The ConstraintsUnion object duck-types the immutable
container object like Python :py:class:`tuple`.
Parameters
----------
*constraints:
Constraint or logic operator objects.
Examples
--------
.. code-block:: python
class CapitalOrSmall(IA5String):
'''
ASN.1 specification:
CapitalOrSmall ::=
IA5String (FROM ("A".."Z") | FROM ("a".."z"))
'''
subtypeSpec = ConstraintsUnion(
PermittedAlphabetConstraint('A', 'Z'),
PermittedAlphabetConstraint('a', 'z')
)
# this will succeed
capital_or_small = CapitalAndSmall('Hello')
# this will raise ValueConstraintError
capital_or_small = CapitalOrSmall('hello!')
c 鬄 | j D ]&} ||| d S # t j $ r Y #w xY wt j d| j d|d )Nzall of z
failed for ""r ro s r r zConstraintsUnion._testValue s , 圝
5#&&& -
((+/<<< ?
s ,,Nrp r( r r r r s. % %餖
r r )sys pyasn1.typer __all__objectr r r r r r r r r r r
r r r r( r r r s
K3 K3 K3 K3 K3 K3 K3 K3餦9C 9C 9C 9C 9C . 9C 9C 9C饃)8 )8 )8 )8 )8!3 )8 )8 )8餢54 54 54 54 54- 54 54 54餻94 94 94 94 94. 94 94 94饃Q4 Q4 Q4 Q4 Q4"7 Q4 Q4 Q4餳 - - - - -!3 - - -養 7 7 7 7 7 2 7 7 7養L4 L4 L4 L4 L4 1 L4 L4 L4餪4 4 4 4 4, 4 4 46.4 .4 .4 .4 .4- .4 .4 .4餬@ @ @ @ @ . @ @ @6)# )# )# )# )# 3 )# )# )#餢2
2
2
2
2
, 2
2
2
2
2
r PK ! 1%( %( __pycache__/char.cpython-311.pycnu 刐迭
辤$ 箬 d dl Z d dlmZ d dlmZ d dlmZ g dZej Zej Z G d dej Z
G d d e
Z G d
d e
Z G d d
e
Z
G d de
Z G d de
Z G d de
Z G d de
Z G d de
Z G d de Z G d de
Z G d d e
Z G d d e
Z G d d!e
ZdS )" N)error)tag)univ)
NumericStringPrintableString
TeletexString T61StringVideotexString IA5String
GraphicString
VisibleString ISO646String
GeneralStringUniversalString BMPString
UTF8Stringc 驢 e Zd ZdZd Zd Zd Zd
dZd
dZd Z dd
Z
d Z d S )AbstractCharacterStringa Creates |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`,
its objects are immutable and duck-type :class:`bytes`.
When used in octet-stream context, |ASN.1| type assumes
"|encoding|" encoding.
Keyword Args
------------
value: :class:`str`, :class:`bytes` or |ASN.1| object
:class:`str`, alternatively :class:`bytes`
representing octet-stream of serialised unicode string
(note `encoding` parameter) or |ASN.1| class instance.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
encoding: :py:class:`str`
Unicode codec ID to encode/decode
:class:`str` the payload when |ASN.1| object is used
in octet-stream context.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
c * t | j S N)str_valueselfs 鷓/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/char.py__str__z AbstractCharacterString.__str__8 s 4; c 蟀 | j | j S # t $ r*}t j d| j d| j | d }~ww xY w)NzCan't encode string '
' with codec )r encodeencodingUnicodeEncodeErrorr PyAsn1UnicodeEncodeError)r excs r __bytes__z!AbstractCharacterString.__bytes__; sm ;%%燿44 4! 00 燭燷458
鴖 !
A%AAc ( t |t r|S t |t r| | j S t |t
t f r"| t | S t |t j r,|
| j S t | S # t t f$ r%}t j d|d| j | d }~ww xY w)NzCan't decode string 'r )
isinstancer bytesdecoder! tuplelistprettyInr OctetStringasOctetsUnicodeDecodeError LookupErrorr PyAsn1UnicodeDecodeError)r valuer$ s r r, z AbstractCharacterString.prettyInD s %%%
" 楨5))
" 梶抾燚222楨4=11
"梷拀5222楨4#344
" 梸拁''..╰瑌===5憐攝!"0 00 榯渳榼./2
鴖/ C .C =C AC C D, D DTc t | S r )r( r paddings r r. z AbstractCharacterString.asOctetsW s 怲墈寋r c : t t | S r )r* r( r4 s r asNumbersz!AbstractCharacterString.asNumbersZ s 昒4慬擺!!!r c |S r )r r2 s r prettyOutz!AbstractCharacterString.prettyOuta s r r c 髝 | | j }|| j ur|S t | S r )r: r r r )r scoper2 s r prettyPrintz#AbstractCharacterString.prettyPrintd s; 榯渰++ # #圠&..╰444r c * t | j S r )reversedr r s r __reversed__z$AbstractCharacterString.__reversed__m s $$$r N)T)r ) __name__
__module__ __qualname____doc__r r% r, r. r7 r: r= r@ r9 r r r r s 餌 & " " " " 5 5 5 5% % % % %r r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r us-asciiNrA rB rC r rD tagSet
tagImplicitlyr TagtagClassUniversaltagFormatSimpler! getTypeIdtypeIdr9 r r r r q 骳 %-G
%
+
9
9%爏':窧?? F H %
.
.
0
0FFFr r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r rG NrH r9 r r r r rP r r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r
iso-8859-1NrH r9 r r r r 骳 %-G
%
+
9
9%爏':窧?? F H %
.
.
0
0FFFr r c 驞 e Zd Zej Ze ZdS )r N)rA rB rC r rD r rN rO r9 r r r r ) #G %
.
.
0
0FFFr r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r
rU NrH r9 r r r
r
rV r r
c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r rG NrH r9 r r r r rP r r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r rU NrH r9 r r r r rV r r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r
rG NrH r9 r r r
r
rP r r
c 驞 e Zd Zej Ze ZdS )r N)rA rB rC r
rD r rN rO r9 r r r r rX r r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r rU NrH r9 r r r r rV r r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r z utf-32-beNrH r9 r r r r 骳 %-G
%
+
9
9%爏':窧?? F H %
.
.
0
0FFFr r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r z utf-16-beNrH r9 r r r r rf r r c 蟀 e Zd Zej Zej ej ej ej
d ZdZ e Z
dS )r zutf-8NrH r9 r r r r sc %-G
%
+
9
9%爏':窧?? F H %
.
.
0
0FFFr r )syspyasn1r pyasn1.typer r __all__NoValuenoValuer- r r r r r r
r r r
r r r r r r9 r r rq s
J J J ,
,Y% Y% Y% Y% Y%榙 . Y% Y% Y%饃 1 1 1 1 1+ 1 1 1 1 1 1 1 1- 1 1 1 1 1 1 1 1+ 1 1 1 1 1 1 1 1
1 1 1 1 1 1 1 1, 1 1 1 1 1 1 1 1' 1 1 1 1 1 1 1 1+ 1 1 1 1 1 1 1 1+ 1 1 1 1 1 1 1 1= 1 1 1 1 1 1 1 1+ 1 1 1 1 1 1 1 1- 1 1 1 1 1 1 1 1' 1 1 1 1 1 1 1 1( 1 1 1 1 1r PK ! xΙ! ! $ __pycache__/namedval.cpython-311.pycnu 刐迭
辤# 4 d dl mZ dgZ G d de ZdS ) )error NamedValuesc 髳 e Zd ZdZd Zd Zd Zd Zd Zd Z d Z
d Z d
Z d Z
d Zd
Zd Zd Zd Zd Zd Zd Zd Zd Zd ZdS )r a Create named values object.
The |NamedValues| object represents a collection of string names
associated with numeric IDs. These objects are used for giving
names to otherwise numerical values.
|NamedValues| objects are immutable and duck-type Python
:class:`dict` object mapping ID to name and vice-versa.
Parameters
----------
*args: variable number of two-element :py:class:`tuple`
name: :py:class:`str`
Value label
value: :py:class:`int`
Numeric value
Keyword Args
------------
name: :py:class:`str`
Value label
value: :py:class:`int`
Numeric value
Examples
--------
.. code-block:: pycon
>>> nv = NamedValues('a', 'b', ('c', 0), d=1)
>>> nv
>>> {'c': 0, 'd': 1, 'a': 2, 'b': 3}
>>> nv[0]
'c'
>>> nv['a']
2
c 驚 i | _ i | _ g }|D ]穧t |t t f r, |\ }}n;# t
$ r t
j d| w xY w| | 宍|| j v rt
j d| || j v rt
j d|d| || j |< || j |< 尭| D ]\\ }}|| j v rt
j d| || j v rt
j d|d| || j |< || j |< 宂|r^| j rt | j dz pd}|D ]=}|| j v rt
j d| || j |< || j |< |dz
}z(NamedValues.__repr__..k s #F#F#F癆燝╝#F#F#F 锧 z...i)joinr len __class____name__)r representations r __repr__zNamedValues.__repr__j s #F#F #F#F#FGG 垀 # # +–≧– 05 8>#$$;O O圢
孨 # # #燸燸燸5 5r" c ( t | |k S Ndictr others r __eq__zNamedValues.__eq__s 怐墇寊楿""r" c ( t | |k S r. r/ r1 s r __ne__zNamedValues.__ne__v r4 r" c ( t | |k S r. r/ r1 s r __lt__zNamedValues.__lt__y 怐墇寊楨!!r" c ( t | |k S r. r/ r1 s r __le__zNamedValues.__le__| r4 r" c ( t | |k S r. r/ r1 s r __gt__zNamedValues.__gt__ r9 r" c ( t | |k S r. r/ r1 s r __ge__zNamedValues.__ge__ r4 r" c 驞 t | S r. )hashr r s r __hash__zNamedValues.__hash__ s 怐桱扟慙擫!!!r" c 骕 | j | S # t $ r | j | cY S w xY wr. )r
KeyErrorr r keys r __getitem__zNamedValues.__getitem__ sB %>#& & % % %<$ $ $ $ %鴖 ))c * t | j S r. )r( r rB s r __len__zNamedValues.__len__ s 4< r" c & || j v p|| j v S r. )r r
rF s r __contains__zNamedValues.__contains__ s 恉攍";燾═琟&;;r" c * t | j S r. iterr rB s r __iter__zNamedValues.__iter__ 怐擫!!!r" c * t | j S r. )rO r
rB s r valueszNamedValues.values s 怐擭###r" c * t | j S r. rN rB s r keyszNamedValues.keys rQ r" c # 驚 K | j D ]}|| j | fV d S r. r r r s r r zNamedValues.items s< 擫 + +圖 燭** * * * * + +r" c 髽 | j t | t | z S r. )r) r r )r namedValuess r __add__zNamedValues.__add__ s: 坱寏漸燭 2 2礥;;L;L;N;N5O5O OPPr" c & | j |i |}| |z S r. )r) )r r r news r clonezNamedValues.clone s" 坉宯榙-爁--恈墇r" c 2 || j v r
| j | S d S r. )r
)r values r getNamezNamedValues.getName s$ 怐擭 " ">%( ( # "r" c 2 || j v r
| j | S d S r. rW rX s r getValuezNamedValues.getValue s$ 4< <% % r" c 蠖 fd|D S # t $ r= t j dt | j w xY w)Nc * g | ]}j | S r rW )r r r s r r! z)NamedValues.getValues.. s 鴢 9994怐擫&999r" zUnknown bit identifier(s): )rE r r set
differencer )r namess ` r getValueszNamedValues.getValues st 鴢 99995999 9 ##36皍::3H3H 3V3V3VX
鴖
慉AN)r*
__module__ __qualname____doc__r r, r3 r6 r8 r; r= r? rC rH rJ rL rP rS rU r r[ r^ ra rc ri r r" r r r s^ ' '餚1 1 1 餱5 5 5# # ## # #" " "# # #" " "# # #" " "
% % %! ! !< < <" " "$ $ $" " "+ + + Q Q Q
) ) )& & & r" N)pyasn1r __all__objectr r r" r rp s^ /r r r r r& r r r r rr" PK ! 4:I I " __pycache__/tagmap.cpython-311.pycnu 刐迭
辤 4 d dl mZ dgZ G d de ZdS ) )errorTagMapc 髥 e Zd ZdZddZd Zd Zd Zd Ze d Z
e d Z e d
Z d Z
d Zd
ZdS )r aF Map *TagSet* objects to ASN.1 types
Create an object mapping *TagSet* object to ASN.1 type.
*TagMap* objects are immutable and duck-type read-only Python
:class:`dict` objects holding *TagSet* objects as keys and ASN.1
type objects as values.
Parameters
----------
presentTypes: :py:class:`dict`
Map of :class:`~pyasn1.type.tag.TagSet` to ASN.1 objects considered
as being unconditionally present in the *TagMap*.
skipTypes: :py:class:`dict`
A collection of :class:`~pyasn1.type.tag.TagSet` objects considered
as absent in the *TagMap* even when *defaultType* is present.
defaultType: ASN.1 type object
An ASN.1 type object callee *TagMap* returns for any *TagSet* key not present
in *presentTypes* (unless given key is present in *skipTypes*).
Nc 8 |pi | _ |pi | _ || _ d S N)_TagMap__presentTypes_TagMap__skipTypes_TagMap__defaultType)self presentTypes skipTypes defaultTypes 鷕/builddir/build/BUILD/imunify360-venv-2.6.2/opt/imunify360/venv/lib/python3.11/site-packages/pyasn1/type/tagmap.py__init__zTagMap.__init__# s) * 0╞$? ( c 8 || j v p| j d uo|| j vS r )r r
r r tagSets r __contains__zTagMap.__contains__( s1 $-- R"$.Q6訟Q3Q Sr c 髺 | j | S # t $ r/ | j || j v rt j d | j cY S w xY w)NzKey in negative map)r KeyErrorr
r r PyAsn1Errorr s r __getitem__zTagMap.__getitem__, sk *&爒. . * * *!)4+++'(=>>>))))
*鴖 6AAc * t | j S r )iterr r s r __iter__zTagMap.__iter__7 s 怐'(((r c 箴 d| j j z }| j r|dt | j z z
}| j r|dt | j z z
}| j |dt | j z z
}d|z S )Nz %s objectz , present %sz , skip %sz , default %sz<%s>) __class____name__r reprr r
)r representations r __repr__zTagMap.__repr__: s $爐'>> I 榥璽癉4G/H/H H H圢 C 榢璂1A,B,B B B圢 ) 榥璽癉4F/G/G G G圢&&r c | j S )zr5 s^ *T T T T T 圴 T T T T T r PK ! 馼軟# # namedval.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
# ASN.1 named integers
#
from pyasn1 import error
__all__ = ['NamedValues']
class NamedValues(object):
"""Create named values object.
The |NamedValues| object represents a collection of string names
associated with numeric IDs. These objects are used for giving
names to otherwise numerical values.
|NamedValues| objects are immutable and duck-type Python
:class:`dict` object mapping ID to name and vice-versa.
Parameters
----------
*args: variable number of two-element :py:class:`tuple`
name: :py:class:`str`
Value label
value: :py:class:`int`
Numeric value
Keyword Args
------------
name: :py:class:`str`
Value label
value: :py:class:`int`
Numeric value
Examples
--------
.. code-block:: pycon
>>> nv = NamedValues('a', 'b', ('c', 0), d=1)
>>> nv
>>> {'c': 0, 'd': 1, 'a': 2, 'b': 3}
>>> nv[0]
'c'
>>> nv['a']
2
"""
def __init__(self, *args, **kwargs):
self.__names = {}
self.__numbers = {}
anonymousNames = []
for namedValue in args:
if isinstance(namedValue, (tuple, list)):
try:
name, number = namedValue
except ValueError:
raise error.PyAsn1Error('Not a proper attribute-value pair %r' % (namedValue,))
else:
anonymousNames.append(namedValue)
continue
if name in self.__names:
raise error.PyAsn1Error('Duplicate name %s' % (name,))
if number in self.__numbers:
raise error.PyAsn1Error('Duplicate number %s=%s' % (name, number))
self.__names[name] = number
self.__numbers[number] = name
for name, number in kwargs.items():
if name in self.__names:
raise error.PyAsn1Error('Duplicate name %s' % (name,))
if number in self.__numbers:
raise error.PyAsn1Error('Duplicate number %s=%s' % (name, number))
self.__names[name] = number
self.__numbers[number] = name
if anonymousNames:
number = self.__numbers and max(self.__numbers) + 1 or 0
for name in anonymousNames:
if name in self.__names:
raise error.PyAsn1Error('Duplicate name %s' % (name,))
self.__names[name] = number
self.__numbers[number] = name
number += 1
def __repr__(self):
representation = ', '.join(['%s=%d' % x for x in self.items()])
if len(representation) > 64:
representation = representation[:32] + '...' + representation[-32:]
return '<%s object, enums %s>' % (
self.__class__.__name__, representation)
def __eq__(self, other):
return dict(self) == other
def __ne__(self, other):
return dict(self) != other
def __lt__(self, other):
return dict(self) < other
def __le__(self, other):
return dict(self) <= other
def __gt__(self, other):
return dict(self) > other
def __ge__(self, other):
return dict(self) >= other
def __hash__(self):
return hash(self.items())
# Python dict protocol (read-only)
def __getitem__(self, key):
try:
return self.__numbers[key]
except KeyError:
return self.__names[key]
def __len__(self):
return len(self.__names)
def __contains__(self, key):
return key in self.__names or key in self.__numbers
def __iter__(self):
return iter(self.__names)
def values(self):
return iter(self.__numbers)
def keys(self):
return iter(self.__names)
def items(self):
for name in self.__names:
yield name, self.__names[name]
# support merging
def __add__(self, namedValues):
return self.__class__(*tuple(self.items()) + tuple(namedValues.items()))
# XXX clone/subtype?
def clone(self, *args, **kwargs):
new = self.__class__(*args, **kwargs)
return self + new
# legacy protocol
def getName(self, value):
if value in self.__numbers:
return self.__numbers[value]
def getValue(self, name):
if name in self.__names:
return self.__names[name]
def getValues(self, *names):
try:
return [self.__names[name] for name in names]
except KeyError:
raise error.PyAsn1Error(
'Unknown bit identifier(s): %s' % (set(names).difference(self.__names),)
)
PK ! 珥"V "V base.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
import sys
from pyasn1 import error
from pyasn1.type import constraint
from pyasn1.type import tag
from pyasn1.type import tagmap
__all__ = ['Asn1Item', 'Asn1Type', 'SimpleAsn1Type',
'ConstructedAsn1Type']
class Asn1Item(object):
@classmethod
def getTypeId(cls, increment=1):
try:
Asn1Item._typeCounter += increment
except AttributeError:
Asn1Item._typeCounter = increment
return Asn1Item._typeCounter
class Asn1Type(Asn1Item):
"""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.
"""
#: Set or return a :py:class:`~pyasn1.type.tag.TagSet` object representing
#: ASN.1 tag(s) associated with |ASN.1| type.
tagSet = tag.TagSet()
#: Default :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
#: object imposing constraints on initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Disambiguation ASN.1 types identification
typeId = None
def __init__(self, **kwargs):
readOnly = {
'tagSet': self.tagSet,
'subtypeSpec': self.subtypeSpec
}
readOnly.update(kwargs)
self.__dict__.update(readOnly)
self._readOnly = readOnly
def __setattr__(self, name, value):
if name[0] != '_' and name in self._readOnly:
raise error.PyAsn1Error('read-only instance attribute "%s"' % name)
self.__dict__[name] = value
def __str__(self):
return self.prettyPrint()
@property
def readOnly(self):
return self._readOnly
@property
def effectiveTagSet(self):
"""For |ASN.1| type is equivalent to *tagSet*
"""
return self.tagSet # used by untagged types
@property
def tagMap(self):
"""Return a :class:`~pyasn1.type.tagmap.TagMap` object mapping ASN.1 tags to ASN.1 objects within callee object.
"""
return tagmap.TagMap({self.tagSet: self})
def isSameTypeWith(self, other, matchTags=True, matchConstraints=True):
"""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.
"""
return (self is other or
(not matchTags or self.tagSet == other.tagSet) and
(not matchConstraints or self.subtypeSpec == other.subtypeSpec))
def isSuperTypeOf(self, other, matchTags=True, matchConstraints=True):
"""Examine |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.
"""
return (not matchTags or
(self.tagSet.isSuperTagSetOf(other.tagSet)) and
(not matchConstraints or self.subtypeSpec.isSuperTypeOf(other.subtypeSpec)))
@staticmethod
def isNoValue(*values):
for value in values:
if value is not noValue:
return False
return True
def prettyPrint(self, scope=0):
raise NotImplementedError
# backward compatibility
def getTagSet(self):
return self.tagSet
def getEffectiveTagSet(self):
return self.effectiveTagSet
def getTagMap(self):
return self.tagMap
def getSubtypeSpec(self):
return self.subtypeSpec
# backward compatibility
def hasValue(self):
return self.isValue
# Backward compatibility
Asn1ItemBase = Asn1Type
class NoValue(object):
"""Create 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.
"""
skipMethods = {
'__slots__',
# attributes
'__getattribute__',
'__getattr__',
'__setattr__',
'__delattr__',
# class instance
'__class__',
'__init__',
'__del__',
'__new__',
'__repr__',
'__qualname__',
'__objclass__',
'im_class',
'__sizeof__',
# pickle protocol
'__reduce__',
'__reduce_ex__',
'__getnewargs__',
'__getinitargs__',
'__getstate__',
'__setstate__',
}
_instance = None
def __new__(cls):
if cls._instance is None:
def getPlug(name):
def plug(self, *args, **kw):
raise error.PyAsn1Error('Attempted "%s" operation on ASN.1 schema object' % name)
return plug
op_names = [name
for typ in (str, int, list, dict)
for name in dir(typ)
if (name not in cls.skipMethods and
name.startswith('__') and
name.endswith('__') and
callable(getattr(typ, name)))]
for name in set(op_names):
setattr(cls, name, getPlug(name))
cls._instance = object.__new__(cls)
return cls._instance
def __getattr__(self, attr):
if attr in self.skipMethods:
raise AttributeError('Attribute %s not present' % attr)
raise error.PyAsn1Error('Attempted "%s" operation on ASN.1 schema object' % attr)
def __repr__(self):
return '<%s object>' % self.__class__.__name__
noValue = NoValue()
class SimpleAsn1Type(Asn1Type):
"""Base 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.
"""
#: Default payload value
defaultValue = noValue
def __init__(self, value=noValue, **kwargs):
Asn1Type.__init__(self, **kwargs)
if value is noValue:
value = self.defaultValue
else:
value = self.prettyIn(value)
try:
self.subtypeSpec(value)
except error.PyAsn1Error as exValue:
raise type(exValue)('%s at %s' % (exValue, self.__class__.__name__))
self._value = value
def __repr__(self):
representation = '%s %s object' % (
self.__class__.__name__, self.isValue and 'value' or 'schema')
for attr, value in self.readOnly.items():
if value:
representation += ', %s %s' % (attr, value)
if self.isValue:
value = self.prettyPrint()
if len(value) > 32:
value = value[:16] + '...' + value[-16:]
representation += ', payload [%s]' % value
return '<%s>' % representation
def __eq__(self, other):
if self is other:
return True
return self._value == other
def __ne__(self, other):
return self._value != other
def __lt__(self, other):
return self._value < other
def __le__(self, other):
return self._value <= other
def __gt__(self, other):
return self._value > other
def __ge__(self, other):
return self._value >= other
def __bool__(self):
return bool(self._value)
def __hash__(self):
return hash(self._value)
@property
def isValue(self):
"""Indicate 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).
"""
return self._value is not noValue
def clone(self, value=noValue, **kwargs):
"""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.
"""
if value is noValue:
if not kwargs:
return self
value = self._value
initializers = self.readOnly.copy()
initializers.update(kwargs)
return self.__class__(value, **initializers)
def subtype(self, value=noValue, **kwargs):
"""Create 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.
"""
if value is noValue:
if not kwargs:
return self
value = self._value
initializers = self.readOnly.copy()
implicitTag = kwargs.pop('implicitTag', None)
if implicitTag is not None:
initializers['tagSet'] = self.tagSet.tagImplicitly(implicitTag)
explicitTag = kwargs.pop('explicitTag', None)
if explicitTag is not None:
initializers['tagSet'] = self.tagSet.tagExplicitly(explicitTag)
for arg, option in kwargs.items():
initializers[arg] += option
return self.__class__(value, **initializers)
def prettyIn(self, value):
return value
def prettyOut(self, value):
return str(value)
def prettyPrint(self, scope=0):
return self.prettyOut(self._value)
def prettyPrintType(self, scope=0):
return '%s -> %s' % (self.tagSet, self.__class__.__name__)
# Backward compatibility
AbstractSimpleAsn1Item = SimpleAsn1Type
#
# Constructed types:
# * There are five of them: Sequence, SequenceOf/SetOf, Set and Choice
# * ASN1 types and values are represened by Python class instances
# * Value initialization is made for defaulted components only
# * Primary method of component addressing is by-position. Data model for base
# type is Python sequence. Additional type-specific addressing methods
# may be implemented for particular types.
# * SequenceOf and SetOf types do not implement any additional methods
# * Sequence, Set and Choice types also implement by-identifier addressing
# * Sequence, Set and Choice types also implement by-asn1-type (tag) addressing
# * Sequence and Set types may include optional and defaulted
# components
# * Constructed types hold a reference to component types used for value
# verification and ordering.
# * Component type is a scalar type for SequenceOf/SetOf types and a list
# of types for Sequence/Set/Choice.
#
class ConstructedAsn1Type(Asn1Type):
"""Base 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.
"""
#: If :obj:`True`, requires exact component type matching,
#: otherwise subtype relation is only enforced
strictConstraints = False
componentType = None
# backward compatibility, unused
sizeSpec = constraint.ConstraintsIntersection()
def __init__(self, **kwargs):
readOnly = {
'componentType': self.componentType,
# backward compatibility, unused
'sizeSpec': self.sizeSpec
}
# backward compatibility: preserve legacy sizeSpec support
kwargs = self._moveSizeSpec(**kwargs)
readOnly.update(kwargs)
Asn1Type.__init__(self, **readOnly)
def _moveSizeSpec(self, **kwargs):
# backward compatibility, unused
sizeSpec = kwargs.pop('sizeSpec', self.sizeSpec)
if sizeSpec:
subtypeSpec = kwargs.pop('subtypeSpec', self.subtypeSpec)
if subtypeSpec:
subtypeSpec = sizeSpec
else:
subtypeSpec += sizeSpec
kwargs['subtypeSpec'] = subtypeSpec
return kwargs
def __repr__(self):
representation = '%s %s object' % (
self.__class__.__name__, self.isValue and 'value' or 'schema'
)
for attr, value in self.readOnly.items():
if value is not noValue:
representation += ', %s=%r' % (attr, value)
if self.isValue and self.components:
representation += ', payload [%s]' % ', '.join(
[repr(x) for x in self.components])
return '<%s>' % representation
def __eq__(self, other):
return self is other or self.components == other
def __ne__(self, other):
return self.components != other
def __lt__(self, other):
return self.components < other
def __le__(self, other):
return self.components <= other
def __gt__(self, other):
return self.components > other
def __ge__(self, other):
return self.components >= other
def __bool__(self):
return bool(self.components)
@property
def components(self):
raise error.PyAsn1Error('Method not implemented')
def _cloneComponentValues(self, myClone, cloneValueFlag):
pass
def clone(self, **kwargs):
"""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.
"""
cloneValueFlag = kwargs.pop('cloneValueFlag', False)
initializers = self.readOnly.copy()
initializers.update(kwargs)
clone = self.__class__(**initializers)
if cloneValueFlag:
self._cloneComponentValues(clone, cloneValueFlag)
return clone
def subtype(self, **kwargs):
"""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.
"""
initializers = self.readOnly.copy()
cloneValueFlag = kwargs.pop('cloneValueFlag', False)
implicitTag = kwargs.pop('implicitTag', None)
if implicitTag is not None:
initializers['tagSet'] = self.tagSet.tagImplicitly(implicitTag)
explicitTag = kwargs.pop('explicitTag', None)
if explicitTag is not None:
initializers['tagSet'] = self.tagSet.tagExplicitly(explicitTag)
for arg, option in kwargs.items():
initializers[arg] += option
clone = self.__class__(**initializers)
if cloneValueFlag:
self._cloneComponentValues(clone, cloneValueFlag)
return clone
def getComponentByPosition(self, idx):
raise error.PyAsn1Error('Method not implemented')
def setComponentByPosition(self, idx, value, verifyConstraints=True):
raise error.PyAsn1Error('Method not implemented')
def setComponents(self, *args, **kwargs):
for idx, value in enumerate(args):
self[idx] = value
for k in kwargs:
self[k] = kwargs[k]
return self
# backward compatibility
def setDefaultComponents(self):
pass
def getComponentType(self):
return self.componentType
# backward compatibility, unused
def verifySizeSpec(self):
self.subtypeSpec(self)
# Backward compatibility
AbstractConstructedAsn1Item = ConstructedAsn1Type
PK ! c縳┺$ $ char.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
import sys
from pyasn1 import error
from pyasn1.type import tag
from pyasn1.type import univ
__all__ = ['NumericString', 'PrintableString', 'TeletexString', 'T61String', 'VideotexString',
'IA5String', 'GraphicString', 'VisibleString', 'ISO646String',
'GeneralString', 'UniversalString', 'BMPString', 'UTF8String']
NoValue = univ.NoValue
noValue = univ.noValue
class AbstractCharacterString(univ.OctetString):
"""Creates |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`,
its objects are immutable and duck-type :class:`bytes`.
When used in octet-stream context, |ASN.1| type assumes
"|encoding|" encoding.
Keyword Args
------------
value: :class:`str`, :class:`bytes` or |ASN.1| object
:class:`str`, alternatively :class:`bytes`
representing octet-stream of serialised unicode string
(note `encoding` parameter) or |ASN.1| class instance.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
encoding: :py:class:`str`
Unicode codec ID to encode/decode
:class:`str` the payload when |ASN.1| object is used
in octet-stream context.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
"""
def __str__(self):
return str(self._value)
def __bytes__(self):
try:
return self._value.encode(self.encoding)
except UnicodeEncodeError as exc:
raise error.PyAsn1UnicodeEncodeError(
"Can't encode string '%s' with codec "
"%s" % (self._value, self.encoding), exc
)
def prettyIn(self, value):
try:
if isinstance(value, str):
return value
elif isinstance(value, bytes):
return value.decode(self.encoding)
elif isinstance(value, (tuple, list)):
return self.prettyIn(bytes(value))
elif isinstance(value, univ.OctetString):
return value.asOctets().decode(self.encoding)
else:
return str(value)
except (UnicodeDecodeError, LookupError) as exc:
raise error.PyAsn1UnicodeDecodeError(
"Can't decode string '%s' with codec "
"%s" % (value, self.encoding), exc
)
def asOctets(self, padding=True):
return bytes(self)
def asNumbers(self, padding=True):
return tuple(bytes(self))
#
# See OctetString.prettyPrint() for the explanation
#
def prettyOut(self, value):
return value
def prettyPrint(self, scope=0):
# first see if subclass has its own .prettyOut()
value = self.prettyOut(self._value)
if value is not self._value:
return value
return AbstractCharacterString.__str__(self)
def __reversed__(self):
return reversed(self._value)
class NumericString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 18)
)
encoding = 'us-ascii'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class PrintableString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 19)
)
encoding = 'us-ascii'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class TeletexString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 20)
)
encoding = 'iso-8859-1'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class T61String(TeletexString):
__doc__ = TeletexString.__doc__
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class VideotexString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 21)
)
encoding = 'iso-8859-1'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class IA5String(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 22)
)
encoding = 'us-ascii'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class GraphicString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 25)
)
encoding = 'iso-8859-1'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class VisibleString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 26)
)
encoding = 'us-ascii'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class ISO646String(VisibleString):
__doc__ = VisibleString.__doc__
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class GeneralString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 27)
)
encoding = 'iso-8859-1'
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class UniversalString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 28)
)
encoding = "utf-32-be"
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class BMPString(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 30)
)
encoding = "utf-16-be"
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
class UTF8String(AbstractCharacterString):
__doc__ = AbstractCharacterString.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = AbstractCharacterString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 12)
)
encoding = "utf-8"
# Optimization for faster codec lookup
typeId = AbstractCharacterString.getTypeId()
PK ! 鹡{c湭 湭 univ.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
import math
import sys
from pyasn1 import error
from pyasn1.codec.ber import eoo
from pyasn1.compat import integer
from pyasn1.type import base
from pyasn1.type import constraint
from pyasn1.type import namedtype
from pyasn1.type import namedval
from pyasn1.type import tag
from pyasn1.type import tagmap
NoValue = base.NoValue
noValue = NoValue()
__all__ = ['Integer', 'Boolean', 'BitString', 'OctetString', 'Null',
'ObjectIdentifier', 'Real', 'Enumerated',
'SequenceOfAndSetOfBase', 'SequenceOf', 'SetOf',
'SequenceAndSetBase', 'Sequence', 'Set', 'Choice', 'Any',
'NoValue', 'noValue']
# "Simple" ASN.1 types (yet incomplete)
class Integer(base.SimpleAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal or |ASN.1| class
instance. If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class ErrorCode(Integer):
'''
ASN.1 specification:
ErrorCode ::=
INTEGER { disk-full(1), no-disk(-1),
disk-not-formatted(2) }
error ErrorCode ::= disk-full
'''
namedValues = NamedValues(
('disk-full', 1), ('no-disk', -1),
('disk-not-formatted', 2)
)
error = ErrorCode('disk-full')
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x02)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
#: Default :py:class:`~pyasn1.type.namedval.NamedValues` object
#: representing symbolic aliases for numbers
namedValues = namedval.NamedValues()
# Optimization for faster codec lookup
typeId = base.SimpleAsn1Type.getTypeId()
def __init__(self, value=noValue, **kwargs):
if 'namedValues' not in kwargs:
kwargs['namedValues'] = self.namedValues
base.SimpleAsn1Type.__init__(self, value, **kwargs)
def __and__(self, value):
return self.clone(self._value & value)
def __rand__(self, value):
return self.clone(value & self._value)
def __or__(self, value):
return self.clone(self._value | value)
def __ror__(self, value):
return self.clone(value | self._value)
def __xor__(self, value):
return self.clone(self._value ^ value)
def __rxor__(self, value):
return self.clone(value ^ self._value)
def __lshift__(self, value):
return self.clone(self._value << value)
def __rshift__(self, value):
return self.clone(self._value >> value)
def __add__(self, value):
return self.clone(self._value + value)
def __radd__(self, value):
return self.clone(value + self._value)
def __sub__(self, value):
return self.clone(self._value - value)
def __rsub__(self, value):
return self.clone(value - self._value)
def __mul__(self, value):
return self.clone(self._value * value)
def __rmul__(self, value):
return self.clone(value * self._value)
def __mod__(self, value):
return self.clone(self._value % value)
def __rmod__(self, value):
return self.clone(value % self._value)
def __pow__(self, value, modulo=None):
return self.clone(pow(self._value, value, modulo))
def __rpow__(self, value):
return self.clone(pow(value, self._value))
def __floordiv__(self, value):
return self.clone(self._value // value)
def __rfloordiv__(self, value):
return self.clone(value // self._value)
def __truediv__(self, value):
return Real(self._value / value)
def __rtruediv__(self, value):
return Real(value / self._value)
def __divmod__(self, value):
return self.clone(divmod(self._value, value))
def __rdivmod__(self, value):
return self.clone(divmod(value, self._value))
__hash__ = base.SimpleAsn1Type.__hash__
def __int__(self):
return int(self._value)
def __float__(self):
return float(self._value)
def __abs__(self):
return self.clone(abs(self._value))
def __index__(self):
return int(self._value)
def __pos__(self):
return self.clone(+self._value)
def __neg__(self):
return self.clone(-self._value)
def __invert__(self):
return self.clone(~self._value)
def __round__(self, n=0):
r = round(self._value, n)
if n:
return self.clone(r)
else:
return r
def __floor__(self):
return math.floor(self._value)
def __ceil__(self):
return math.ceil(self._value)
def __trunc__(self):
return self.clone(math.trunc(self._value))
def __lt__(self, value):
return self._value < value
def __le__(self, value):
return self._value <= value
def __eq__(self, value):
return self._value == value
def __ne__(self, value):
return self._value != value
def __gt__(self, value):
return self._value > value
def __ge__(self, value):
return self._value >= value
def prettyIn(self, value):
try:
return int(value)
except ValueError:
try:
return self.namedValues[value]
except KeyError as exc:
raise error.PyAsn1Error(
'Can\'t coerce %r into integer: %s' % (value, exc)
)
def prettyOut(self, value):
try:
return str(self.namedValues[value])
except KeyError:
return str(value)
# backward compatibility
def getNamedValues(self):
return self.namedValues
class Boolean(Integer):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal or |ASN.1| class
instance. If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s).Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class RoundResult(Boolean):
'''
ASN.1 specification:
RoundResult ::= BOOLEAN
ok RoundResult ::= TRUE
ko RoundResult ::= FALSE
'''
ok = RoundResult(True)
ko = RoundResult(False)
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x01),
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = Integer.subtypeSpec + constraint.SingleValueConstraint(0, 1)
#: Default :py:class:`~pyasn1.type.namedval.NamedValues` object
#: representing symbolic aliases for numbers
namedValues = namedval.NamedValues(('False', 0), ('True', 1))
# Optimization for faster codec lookup
typeId = Integer.getTypeId()
class SizedInteger(int):
bitLength = leadingZeroBits = None
def setBitLength(self, bitLength):
self.bitLength = bitLength
self.leadingZeroBits = max(bitLength - self.bit_length(), 0)
return self
def __len__(self):
if self.bitLength is None:
self.setBitLength(self.bit_length())
return self.bitLength
class BitString(base.SimpleAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type both Python :class:`tuple` (as a tuple
of bits) and :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal representing binary
or hexadecimal number or sequence of integer bits or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
binValue: :py:class:`str`
Binary string initializer to use instead of the *value*.
Example: '10110011'.
hexValue: :py:class:`str`
Hexadecimal string initializer to use instead of the *value*.
Example: 'DEADBEEF'.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Rights(BitString):
'''
ASN.1 specification:
Rights ::= BIT STRING { user-read(0), user-write(1),
group-read(2), group-write(3),
other-read(4), other-write(5) }
group1 Rights ::= { group-read, group-write }
group2 Rights ::= '0011'B
group3 Rights ::= '3'H
'''
namedValues = NamedValues(
('user-read', 0), ('user-write', 1),
('group-read', 2), ('group-write', 3),
('other-read', 4), ('other-write', 5)
)
group1 = Rights(('group-read', 'group-write'))
group2 = Rights('0011')
group3 = Rights(0x3)
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x03)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
#: Default :py:class:`~pyasn1.type.namedval.NamedValues` object
#: representing symbolic aliases for numbers
namedValues = namedval.NamedValues()
# Optimization for faster codec lookup
typeId = base.SimpleAsn1Type.getTypeId()
defaultBinValue = defaultHexValue = noValue
def __init__(self, value=noValue, **kwargs):
if value is noValue:
if kwargs:
try:
value = self.fromBinaryString(kwargs.pop('binValue'), internalFormat=True)
except KeyError:
pass
try:
value = self.fromHexString(kwargs.pop('hexValue'), internalFormat=True)
except KeyError:
pass
if value is noValue:
if self.defaultBinValue is not noValue:
value = self.fromBinaryString(self.defaultBinValue, internalFormat=True)
elif self.defaultHexValue is not noValue:
value = self.fromHexString(self.defaultHexValue, internalFormat=True)
if 'namedValues' not in kwargs:
kwargs['namedValues'] = self.namedValues
base.SimpleAsn1Type.__init__(self, value, **kwargs)
def __str__(self):
return self.asBinary()
def __eq__(self, other):
other = self.prettyIn(other)
return self is other or self._value == other and len(self._value) == len(other)
def __ne__(self, other):
other = self.prettyIn(other)
return self._value != other or len(self._value) != len(other)
def __lt__(self, other):
other = self.prettyIn(other)
return len(self._value) < len(other) or len(self._value) == len(other) and self._value < other
def __le__(self, other):
other = self.prettyIn(other)
return len(self._value) <= len(other) or len(self._value) == len(other) and self._value <= other
def __gt__(self, other):
other = self.prettyIn(other)
return len(self._value) > len(other) or len(self._value) == len(other) and self._value > other
def __ge__(self, other):
other = self.prettyIn(other)
return len(self._value) >= len(other) or len(self._value) == len(other) and self._value >= other
# Immutable sequence object protocol
def __len__(self):
return len(self._value)
def __getitem__(self, i):
if i.__class__ is slice:
return self.clone([self[x] for x in range(*i.indices(len(self)))])
else:
length = len(self._value) - 1
if i > length or i < 0:
raise IndexError('bit index out of range')
return (self._value >> (length - i)) & 1
def __iter__(self):
length = len(self._value)
while length:
length -= 1
yield (self._value >> length) & 1
def __reversed__(self):
return reversed(tuple(self))
# arithmetic operators
def __add__(self, value):
value = self.prettyIn(value)
return self.clone(SizedInteger(self._value << len(value) | value).setBitLength(len(self._value) + len(value)))
def __radd__(self, value):
value = self.prettyIn(value)
return self.clone(SizedInteger(value << len(self._value) | self._value).setBitLength(len(self._value) + len(value)))
def __mul__(self, value):
bitString = self._value
while value > 1:
bitString <<= len(self._value)
bitString |= self._value
value -= 1
return self.clone(bitString)
def __rmul__(self, value):
return self * value
def __lshift__(self, count):
return self.clone(SizedInteger(self._value << count).setBitLength(len(self._value) + count))
def __rshift__(self, count):
return self.clone(SizedInteger(self._value >> count).setBitLength(max(0, len(self._value) - count)))
def __int__(self):
return int(self._value)
def __float__(self):
return float(self._value)
def asNumbers(self):
"""Get |ASN.1| value as a sequence of 8-bit integers.
If |ASN.1| object length is not a multiple of 8, result
will be left-padded with zeros.
"""
return tuple(self.asOctets())
def asOctets(self):
"""Get |ASN.1| value as a sequence of octets.
If |ASN.1| object length is not a multiple of 8, result
will be left-padded with zeros.
"""
return integer.to_bytes(self._value, length=len(self))
def asInteger(self):
"""Get |ASN.1| value as a single integer value.
"""
return self._value
def asBinary(self):
"""Get |ASN.1| value as a text string of bits.
"""
binString = bin(self._value)[2:]
return '0' * (len(self._value) - len(binString)) + binString
@classmethod
def fromHexString(cls, value, internalFormat=False, prepend=None):
"""Create a |ASN.1| object initialized from the hex string.
Parameters
----------
value: :class:`str`
Text string like 'DEADBEEF'
"""
try:
value = SizedInteger(value, 16).setBitLength(len(value) * 4)
except ValueError as exc:
raise error.PyAsn1Error('%s.fromHexString() error: %s' % (cls.__name__, exc))
if prepend is not None:
value = SizedInteger(
(SizedInteger(prepend) << len(value)) | value
).setBitLength(len(prepend) + len(value))
if not internalFormat:
value = cls(value)
return value
@classmethod
def fromBinaryString(cls, value, internalFormat=False, prepend=None):
"""Create a |ASN.1| object initialized from a string of '0' and '1'.
Parameters
----------
value: :class:`str`
Text string like '1010111'
"""
try:
value = SizedInteger(value or '0', 2).setBitLength(len(value))
except ValueError as exc:
raise error.PyAsn1Error('%s.fromBinaryString() error: %s' % (cls.__name__, exc))
if prepend is not None:
value = SizedInteger(
(SizedInteger(prepend) << len(value)) | value
).setBitLength(len(prepend) + len(value))
if not internalFormat:
value = cls(value)
return value
@classmethod
def fromOctetString(cls, value, internalFormat=False, prepend=None, padding=0):
"""Create a |ASN.1| object initialized from a string.
Parameters
----------
value: :class:`bytes`
Text string like b'\\\\x01\\\\xff'
"""
value = SizedInteger(int.from_bytes(bytes(value), 'big') >> padding).setBitLength(len(value) * 8 - padding)
if prepend is not None:
value = SizedInteger(
(SizedInteger(prepend) << len(value)) | value
).setBitLength(len(prepend) + len(value))
if not internalFormat:
value = cls(value)
return value
def prettyIn(self, value):
if isinstance(value, SizedInteger):
return value
elif isinstance(value, str):
if not value:
return SizedInteger(0).setBitLength(0)
elif value[0] == '\'': # "'1011'B" -- ASN.1 schema representation (deprecated)
if value[-2:] == '\'B':
return self.fromBinaryString(value[1:-2], internalFormat=True)
elif value[-2:] == '\'H':
return self.fromHexString(value[1:-2], internalFormat=True)
else:
raise error.PyAsn1Error(
'Bad BIT STRING value notation %s' % (value,)
)
elif self.namedValues and not value.isdigit(): # named bits like 'Urgent, Active'
names = [x.strip() for x in value.split(',')]
try:
bitPositions = [self.namedValues[name] for name in names]
except KeyError:
raise error.PyAsn1Error('unknown bit name(s) in %r' % (names,))
rightmostPosition = max(bitPositions)
number = 0
for bitPosition in bitPositions:
number |= 1 << (rightmostPosition - bitPosition)
return SizedInteger(number).setBitLength(rightmostPosition + 1)
elif value.startswith('0x'):
return self.fromHexString(value[2:], internalFormat=True)
elif value.startswith('0b'):
return self.fromBinaryString(value[2:], internalFormat=True)
else: # assume plain binary string like '1011'
return self.fromBinaryString(value, internalFormat=True)
elif isinstance(value, (tuple, list)):
return self.fromBinaryString(''.join([b and '1' or '0' for b in value]), internalFormat=True)
elif isinstance(value, BitString):
return SizedInteger(value).setBitLength(len(value))
elif isinstance(value, int):
return SizedInteger(value)
else:
raise error.PyAsn1Error(
'Bad BitString initializer type \'%s\'' % (value,)
)
class OctetString(base.SimpleAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type :class:`bytes`.
When used in Unicode context, |ASN.1| type
assumes "|encoding|" serialisation.
Keyword Args
------------
value: :class:`unicode`, :class:`str`, :class:`bytes` or |ASN.1| object
:class:`bytes`, alternatively :class:`str`
representing character string to be serialised into octets
(note `encoding` parameter) or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
encoding: :py:class:`str`
Unicode codec ID to encode/decode
:class:`str` the payload when |ASN.1| object is used
in text string context.
binValue: :py:class:`str`
Binary string initializer to use instead of the *value*.
Example: '10110011'.
hexValue: :py:class:`str`
Hexadecimal string initializer to use instead of the *value*.
Example: 'DEADBEEF'.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Icon(OctetString):
'''
ASN.1 specification:
Icon ::= OCTET STRING
icon1 Icon ::= '001100010011001000110011'B
icon2 Icon ::= '313233'H
'''
icon1 = Icon.fromBinaryString('001100010011001000110011')
icon2 = Icon.fromHexString('313233')
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x04)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Optimization for faster codec lookup
typeId = base.SimpleAsn1Type.getTypeId()
defaultBinValue = defaultHexValue = noValue
encoding = 'iso-8859-1'
def __init__(self, value=noValue, **kwargs):
if kwargs:
if value is noValue:
try:
value = self.fromBinaryString(kwargs.pop('binValue'))
except KeyError:
pass
try:
value = self.fromHexString(kwargs.pop('hexValue'))
except KeyError:
pass
if value is noValue:
if self.defaultBinValue is not noValue:
value = self.fromBinaryString(self.defaultBinValue)
elif self.defaultHexValue is not noValue:
value = self.fromHexString(self.defaultHexValue)
if 'encoding' not in kwargs:
kwargs['encoding'] = self.encoding
base.SimpleAsn1Type.__init__(self, value, **kwargs)
def prettyIn(self, value):
if isinstance(value, bytes):
return value
elif isinstance(value, str):
try:
return value.encode(self.encoding)
except UnicodeEncodeError as exc:
raise error.PyAsn1UnicodeEncodeError(
"Can't encode string '%s' with '%s' "
"codec" % (value, self.encoding), exc
)
elif isinstance(value, OctetString): # a shortcut, bytes() would work the same way
return value.asOctets()
elif isinstance(value, base.SimpleAsn1Type): # this mostly targets Integer objects
return self.prettyIn(str(value))
elif isinstance(value, (tuple, list)):
return self.prettyIn(bytes(value))
else:
return bytes(value)
def __str__(self):
try:
return self._value.decode(self.encoding)
except UnicodeDecodeError as exc:
raise error.PyAsn1UnicodeDecodeError(
"Can't decode string '%s' with '%s' codec at "
"'%s'" % (self._value, self.encoding,
self.__class__.__name__), exc
)
def __bytes__(self):
return bytes(self._value)
def asOctets(self):
return bytes(self._value)
def asNumbers(self):
return tuple(self._value)
#
# Normally, `.prettyPrint()` is called from `__str__()`. Historically,
# OctetString.prettyPrint() used to return hexified payload
# representation in cases when non-printable content is present. At the
# same time `str()` used to produce either octet-stream (Py2) or
# text (Py3) representations.
#
# Therefore `OctetString.__str__()` -> `.prettyPrint()` call chain is
# reversed to preserve the original behaviour.
#
# Eventually we should deprecate `.prettyPrint()` / `.prettyOut()` harness
# and end up with just `__str__()` producing hexified representation while
# both text and octet-stream representation should only be requested via
# the `.asOctets()` method.
#
# Note: ASN.1 OCTET STRING is never mean to contain text!
#
def prettyOut(self, value):
return value
def prettyPrint(self, scope=0):
# first see if subclass has its own .prettyOut()
value = self.prettyOut(self._value)
if value is not self._value:
return value
numbers = self.asNumbers()
for x in numbers:
# hexify if needed
if x < 32 or x > 126:
return '0x' + ''.join(('%.2x' % x for x in numbers))
else:
# this prevents infinite recursion
return OctetString.__str__(self)
@staticmethod
def fromBinaryString(value):
"""Create a |ASN.1| object initialized from a string of '0' and '1'.
Parameters
----------
value: :class:`str`
Text string like '1010111'
"""
bitNo = 8
byte = 0
r = []
for v in value:
if bitNo:
bitNo -= 1
else:
bitNo = 7
r.append(byte)
byte = 0
if v in ('0', '1'):
v = int(v)
else:
raise error.PyAsn1Error(
'Non-binary OCTET STRING initializer %s' % (v,)
)
byte |= v << bitNo
r.append(byte)
return bytes(r)
@staticmethod
def fromHexString(value):
"""Create a |ASN.1| object initialized from the hex string.
Parameters
----------
value: :class:`str`
Text string like 'DEADBEEF'
"""
r = []
p = []
for v in value:
if p:
r.append(int(p + v, 16))
p = None
else:
p = v
if p:
r.append(int(p + '0', 16))
return bytes(r)
# Immutable sequence object protocol
def __len__(self):
return len(self._value)
def __getitem__(self, i):
if i.__class__ is slice:
return self.clone(self._value[i])
else:
return self._value[i]
def __iter__(self):
return iter(self._value)
def __contains__(self, value):
return value in self._value
def __add__(self, value):
return self.clone(self._value + self.prettyIn(value))
def __radd__(self, value):
return self.clone(self.prettyIn(value) + self._value)
def __mul__(self, value):
return self.clone(self._value * value)
def __rmul__(self, value):
return self * value
def __int__(self):
return int(self._value)
def __float__(self):
return float(self._value)
def __reversed__(self):
return reversed(self._value)
class Null(OctetString):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`str` objects
(always empty).
Keyword Args
------------
value: :class:`str` or |ASN.1| object
Python empty :class:`str` literal or any object that evaluates to :obj:`False`
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Ack(Null):
'''
ASN.1 specification:
Ack ::= NULL
'''
ack = Ack('')
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x05)
)
subtypeSpec = OctetString.subtypeSpec + constraint.SingleValueConstraint(b'')
# Optimization for faster codec lookup
typeId = OctetString.getTypeId()
def prettyIn(self, value):
if value:
return value
return b''
class ObjectIdentifier(base.SimpleAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`tuple` objects
(tuple of non-negative integers).
Keyword Args
------------
value: :class:`tuple`, :class:`str` or |ASN.1| object
Python sequence of :class:`int` or :class:`str` literal or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class ID(ObjectIdentifier):
'''
ASN.1 specification:
ID ::= OBJECT IDENTIFIER
id-edims ID ::= { joint-iso-itu-t mhs-motif(6) edims(7) }
id-bp ID ::= { id-edims 11 }
'''
id_edims = ID('2.6.7')
id_bp = id_edims + (11,)
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x06)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Optimization for faster codec lookup
typeId = base.SimpleAsn1Type.getTypeId()
def __add__(self, other):
return self.clone(self._value + other)
def __radd__(self, other):
return self.clone(other + self._value)
def asTuple(self):
return self._value
# Sequence object protocol
def __len__(self):
return len(self._value)
def __getitem__(self, i):
if i.__class__ is slice:
return self.clone(self._value[i])
else:
return self._value[i]
def __iter__(self):
return iter(self._value)
def __contains__(self, value):
return value in self._value
def index(self, suboid):
return self._value.index(suboid)
def isPrefixOf(self, other):
"""Indicate if this |ASN.1| object is a prefix of other |ASN.1| object.
Parameters
----------
other: |ASN.1| object
|ASN.1| object
Returns
-------
: :class:`bool`
:obj:`True` if this |ASN.1| object is a parent (e.g. prefix) of the other |ASN.1| object
or :obj:`False` otherwise.
"""
l = len(self)
if l <= len(other):
if self._value[:l] == other[:l]:
return True
return False
def prettyIn(self, value):
if isinstance(value, ObjectIdentifier):
return tuple(value)
elif isinstance(value, str):
if '-' in value:
raise error.PyAsn1Error(
# sys.exc_info in case prettyIn was called while handling an exception
'Malformed Object ID %s at %s: %s' % (value, self.__class__.__name__, sys.exc_info()[1])
)
try:
return tuple([int(subOid) for subOid in value.split('.') if subOid])
except ValueError as exc:
raise error.PyAsn1Error(
'Malformed Object ID %s at %s: %s' % (value, self.__class__.__name__, exc)
)
try:
tupleOfInts = tuple([int(subOid) for subOid in value if subOid >= 0])
except (ValueError, TypeError) as exc:
raise error.PyAsn1Error(
'Malformed Object ID %s at %s: %s' % (value, self.__class__.__name__, exc)
)
if len(tupleOfInts) == len(value):
return tupleOfInts
raise error.PyAsn1Error('Malformed Object ID %s at %s' % (value, self.__class__.__name__))
def prettyOut(self, value):
return '.'.join([str(x) for x in value])
class RelativeOID(base.SimpleAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`tuple` objects
(tuple of non-negative integers).
Keyword Args
------------
value: :class:`tuple`, :class:`str` or |ASN.1| object
Python sequence of :class:`int` or :class:`str` literal or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class RelOID(RelativeOID):
'''
ASN.1 specification:
id-pad-null RELATIVE-OID ::= { 0 }
id-pad-once RELATIVE-OID ::= { 5 6 }
id-pad-twice RELATIVE-OID ::= { 5 6 7 }
'''
id_pad_null = RelOID('0')
id_pad_once = RelOID('5.6')
id_pad_twice = id_pad_once + (7,)
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x0d)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Optimization for faster codec lookup
typeId = base.SimpleAsn1Type.getTypeId()
def __add__(self, other):
return self.clone(self._value + other)
def __radd__(self, other):
return self.clone(other + self._value)
def asTuple(self):
return self._value
# Sequence object protocol
def __len__(self):
return len(self._value)
def __getitem__(self, i):
if i.__class__ is slice:
return self.clone(self._value[i])
else:
return self._value[i]
def __iter__(self):
return iter(self._value)
def __contains__(self, value):
return value in self._value
def index(self, suboid):
return self._value.index(suboid)
def isPrefixOf(self, other):
"""Indicate if this |ASN.1| object is a prefix of other |ASN.1| object.
Parameters
----------
other: |ASN.1| object
|ASN.1| object
Returns
-------
: :class:`bool`
:obj:`True` if this |ASN.1| object is a parent (e.g. prefix) of the other |ASN.1| object
or :obj:`False` otherwise.
"""
l = len(self)
if l <= len(other):
if self._value[:l] == other[:l]:
return True
return False
def prettyIn(self, value):
if isinstance(value, RelativeOID):
return tuple(value)
elif isinstance(value, str):
if '-' in value:
raise error.PyAsn1Error(
# sys.exc_info in case prettyIn was called while handling an exception
'Malformed RELATIVE-OID %s at %s: %s' % (value, self.__class__.__name__, sys.exc_info()[1])
)
try:
return tuple([int(subOid) for subOid in value.split('.') if subOid])
except ValueError as exc:
raise error.PyAsn1Error(
'Malformed RELATIVE-OID %s at %s: %s' % (value, self.__class__.__name__, exc)
)
try:
tupleOfInts = tuple([int(subOid) for subOid in value if subOid >= 0])
except (ValueError, TypeError) as exc:
raise error.PyAsn1Error(
'Malformed RELATIVE-OID %s at %s: %s' % (value, self.__class__.__name__, exc)
)
if len(tupleOfInts) == len(value):
return tupleOfInts
raise error.PyAsn1Error('Malformed RELATIVE-OID %s at %s' % (value, self.__class__.__name__))
def prettyOut(self, value):
return '.'.join([str(x) for x in value])
class Real(base.SimpleAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`float` objects.
Additionally, |ASN.1| objects behave like a :class:`tuple` in which case its
elements are mantissa, base and exponent.
Keyword Args
------------
value: :class:`tuple`, :class:`float` or |ASN.1| object
Python sequence of :class:`int` (representing mantissa, base and
exponent) or :class:`float` instance or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Pi(Real):
'''
ASN.1 specification:
Pi ::= REAL
pi Pi ::= { mantissa 314159, base 10, exponent -5 }
'''
pi = Pi((314159, 10, -5))
"""
binEncBase = None # binEncBase = 16 is recommended for large numbers
try:
_plusInf = float('inf')
_minusInf = float('-inf')
_inf = _plusInf, _minusInf
except ValueError:
# Infinity support is platform and Python dependent
_plusInf = _minusInf = None
_inf = ()
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x09)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Optimization for faster codec lookup
typeId = base.SimpleAsn1Type.getTypeId()
@staticmethod
def __normalizeBase10(value):
m, b, e = value
while m and m % 10 == 0:
m /= 10
e += 1
return m, b, e
def prettyIn(self, value):
if isinstance(value, tuple) and len(value) == 3:
if (not isinstance(value[0], (int, float)) or
not isinstance(value[1], int) or
not isinstance(value[2], int)):
raise error.PyAsn1Error('Lame Real value syntax: %s' % (value,))
if (isinstance(value[0], float) and
self._inf and value[0] in self._inf):
return value[0]
if value[1] not in (2, 10):
raise error.PyAsn1Error(
'Prohibited base for Real value: %s' % (value[1],)
)
if value[1] == 10:
value = self.__normalizeBase10(value)
return value
elif isinstance(value, int):
return self.__normalizeBase10((value, 10, 0))
elif isinstance(value, float) or isinstance(value, str):
if isinstance(value, str):
try:
value = float(value)
except ValueError:
raise error.PyAsn1Error(
'Bad real value syntax: %s' % (value,)
)
if self._inf and value in self._inf:
return value
else:
e = 0
while int(value) != value:
value *= 10
e -= 1
return self.__normalizeBase10((int(value), 10, e))
elif isinstance(value, Real):
return tuple(value)
raise error.PyAsn1Error(
'Bad real value syntax: %s' % (value,)
)
def prettyPrint(self, scope=0):
try:
return self.prettyOut(float(self))
except OverflowError:
return ''
@property
def isPlusInf(self):
"""Indicate PLUS-INFINITY object value
Returns
-------
: :class:`bool`
:obj:`True` if calling object represents plus infinity
or :obj:`False` otherwise.
"""
return self._value == self._plusInf
@property
def isMinusInf(self):
"""Indicate MINUS-INFINITY object value
Returns
-------
: :class:`bool`
:obj:`True` if calling object represents minus infinity
or :obj:`False` otherwise.
"""
return self._value == self._minusInf
@property
def isInf(self):
return self._value in self._inf
def __add__(self, value):
return self.clone(float(self) + value)
def __radd__(self, value):
return self + value
def __mul__(self, value):
return self.clone(float(self) * value)
def __rmul__(self, value):
return self * value
def __sub__(self, value):
return self.clone(float(self) - value)
def __rsub__(self, value):
return self.clone(value - float(self))
def __mod__(self, value):
return self.clone(float(self) % value)
def __rmod__(self, value):
return self.clone(value % float(self))
def __pow__(self, value, modulo=None):
return self.clone(pow(float(self), value, modulo))
def __rpow__(self, value):
return self.clone(pow(value, float(self)))
def __truediv__(self, value):
return self.clone(float(self) / value)
def __rtruediv__(self, value):
return self.clone(value / float(self))
def __divmod__(self, value):
return self.clone(float(self) // value)
def __rdivmod__(self, value):
return self.clone(value // float(self))
def __int__(self):
return int(float(self))
def __float__(self):
if self._value in self._inf:
return self._value
else:
return float(
self._value[0] * pow(self._value[1], self._value[2])
)
def __abs__(self):
return self.clone(abs(float(self)))
def __pos__(self):
return self.clone(+float(self))
def __neg__(self):
return self.clone(-float(self))
def __round__(self, n=0):
r = round(float(self), n)
if n:
return self.clone(r)
else:
return r
def __floor__(self):
return self.clone(math.floor(float(self)))
def __ceil__(self):
return self.clone(math.ceil(float(self)))
def __trunc__(self):
return self.clone(math.trunc(float(self)))
def __lt__(self, value):
return float(self) < value
def __le__(self, value):
return float(self) <= value
def __eq__(self, value):
return float(self) == value
def __ne__(self, value):
return float(self) != value
def __gt__(self, value):
return float(self) > value
def __ge__(self, value):
return float(self) >= value
def __bool__(self):
return bool(float(self))
__hash__ = base.SimpleAsn1Type.__hash__
def __getitem__(self, idx):
if self._value in self._inf:
raise error.PyAsn1Error('Invalid infinite value operation')
else:
return self._value[idx]
# compatibility stubs
def isPlusInfinity(self):
return self.isPlusInf
def isMinusInfinity(self):
return self.isMinusInf
def isInfinity(self):
return self.isInf
class Enumerated(Integer):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`, its
objects are immutable and duck-type Python :class:`int` objects.
Keyword Args
------------
value: :class:`int`, :class:`str` or |ASN.1| object
Python :class:`int` or :class:`str` literal or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
namedValues: :py:class:`~pyasn1.type.namedval.NamedValues`
Object representing non-default symbolic aliases for numbers
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class RadioButton(Enumerated):
'''
ASN.1 specification:
RadioButton ::= ENUMERATED { button1(0), button2(1),
button3(2) }
selected-by-default RadioButton ::= button1
'''
namedValues = NamedValues(
('button1', 0), ('button2', 1),
('button3', 2)
)
selected_by_default = RadioButton('button1')
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 0x0A)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Optimization for faster codec lookup
typeId = Integer.getTypeId()
#: Default :py:class:`~pyasn1.type.namedval.NamedValues` object
#: representing symbolic aliases for numbers
namedValues = namedval.NamedValues()
# "Structured" ASN.1 types
class SequenceOfAndSetOfBase(base.ConstructedAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.ConstructedAsn1Type`,
its objects are mutable and duck-type Python :class:`list` objects.
Keyword Args
------------
componentType : :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A pyasn1 object representing ASN.1 type allowed within |ASN.1| type
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type can only occur on explicit
`.isInconsistent` call.
Examples
--------
.. code-block:: python
class LotteryDraw(SequenceOf): # SetOf is similar
'''
ASN.1 specification:
LotteryDraw ::= SEQUENCE OF INTEGER
'''
componentType = Integer()
lotteryDraw = LotteryDraw()
lotteryDraw.extend([123, 456, 789])
"""
def __init__(self, *args, **kwargs):
# support positional params for backward compatibility
if args:
for key, value in zip(('componentType', 'tagSet',
'subtypeSpec'), args):
if key in kwargs:
raise error.PyAsn1Error('Conflicting positional and keyword params!')
kwargs['componentType'] = value
self._componentValues = noValue
base.ConstructedAsn1Type.__init__(self, **kwargs)
# Python list protocol
def __getitem__(self, idx):
try:
return self.getComponentByPosition(idx)
except error.PyAsn1Error as exc:
raise IndexError(exc)
def __setitem__(self, idx, value):
try:
self.setComponentByPosition(idx, value)
except error.PyAsn1Error as exc:
raise IndexError(exc)
def append(self, value):
if self._componentValues is noValue:
pos = 0
else:
pos = len(self._componentValues)
self[pos] = value
def count(self, value):
return list(self._componentValues.values()).count(value)
def extend(self, values):
for value in values:
self.append(value)
if self._componentValues is noValue:
self._componentValues = {}
def index(self, value, start=0, stop=None):
if stop is None:
stop = len(self)
indices, values = zip(*self._componentValues.items())
# TODO: remove when Py2.5 support is gone
values = list(values)
try:
return indices[values.index(value, start, stop)]
except error.PyAsn1Error as exc:
raise ValueError(exc)
def reverse(self):
self._componentValues.reverse()
def sort(self, key=None, reverse=False):
self._componentValues = dict(
enumerate(sorted(self._componentValues.values(),
key=key, reverse=reverse)))
def __len__(self):
if self._componentValues is noValue or not self._componentValues:
return 0
return max(self._componentValues) + 1
def __iter__(self):
for idx in range(0, len(self)):
yield self.getComponentByPosition(idx)
def _cloneComponentValues(self, myClone, cloneValueFlag):
for idx, componentValue in self._componentValues.items():
if componentValue is not noValue:
if isinstance(componentValue, base.ConstructedAsn1Type):
myClone.setComponentByPosition(
idx, componentValue.clone(cloneValueFlag=cloneValueFlag)
)
else:
myClone.setComponentByPosition(idx, componentValue.clone())
def getComponentByPosition(self, idx, default=noValue, instantiate=True):
"""Return |ASN.1| type component value by position.
Equivalent to Python sequence subscription operation (e.g. `[]`).
Parameters
----------
idx : :class:`int`
Component index (zero-based). Must either refer to an existing
component or to N+1 component (if *componentType* is set). In the latter
case a new component type gets instantiated and appended to the |ASN.1|
sequence.
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically instantiated.
If :obj:`False` either existing component or the :class:`NoValue` object will be
returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
Instantiate |ASN.1| component type or return existing component value
Examples
--------
.. code-block:: python
# can also be SetOf
class MySequenceOf(SequenceOf):
componentType = OctetString()
s = MySequenceOf()
# returns component #0 with `.isValue` property False
s.getComponentByPosition(0)
# returns None
s.getComponentByPosition(0, default=None)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
# sets component #0 to OctetString() ASN.1 schema
# object and returns it
s.getComponentByPosition(0, instantiate=True)
# sets component #0 to ASN.1 value object
s.setComponentByPosition(0, 'ABCD')
# returns OctetString('ABCD') value object
s.getComponentByPosition(0, instantiate=False)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
"""
if isinstance(idx, slice):
indices = tuple(range(len(self)))
return [self.getComponentByPosition(subidx, default, instantiate)
for subidx in indices[idx]]
if idx < 0:
idx = len(self) + idx
if idx < 0:
raise error.PyAsn1Error(
'SequenceOf/SetOf index is out of range')
try:
componentValue = self._componentValues[idx]
except (KeyError, error.PyAsn1Error):
if not instantiate:
return default
self.setComponentByPosition(idx)
componentValue = self._componentValues[idx]
if default is noValue or componentValue.isValue:
return componentValue
else:
return default
def setComponentByPosition(self, idx, value=noValue,
verifyConstraints=True,
matchTags=True,
matchConstraints=True):
"""Assign |ASN.1| type component by position.
Equivalent to Python sequence item assignment operation (e.g. `[]`)
or list.append() (when idx == len(self)).
Parameters
----------
idx: :class:`int`
Component index (zero-based). Must either refer to existing
component or to N+1 component. In the latter case a new component
type gets instantiated (if *componentType* is set, or given ASN.1
object is taken otherwise) and appended to the |ASN.1| sequence.
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints: :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer
IndexError
When idx > len(self)
"""
if isinstance(idx, slice):
indices = tuple(range(len(self)))
startIdx = indices and indices[idx][0] or 0
for subIdx, subValue in enumerate(value):
self.setComponentByPosition(
startIdx + subIdx, subValue, verifyConstraints,
matchTags, matchConstraints)
return self
if idx < 0:
idx = len(self) + idx
if idx < 0:
raise error.PyAsn1Error(
'SequenceOf/SetOf index is out of range')
componentType = self.componentType
if self._componentValues is noValue:
componentValues = {}
else:
componentValues = self._componentValues
currentValue = componentValues.get(idx, noValue)
if value is noValue:
if componentType is not None:
value = componentType.clone()
elif currentValue is noValue:
raise error.PyAsn1Error('Component type not defined')
elif not isinstance(value, base.Asn1Item):
if (componentType is not None and
isinstance(componentType, base.SimpleAsn1Type)):
value = componentType.clone(value=value)
elif (currentValue is not noValue and
isinstance(currentValue, base.SimpleAsn1Type)):
value = currentValue.clone(value=value)
else:
raise error.PyAsn1Error(
'Non-ASN.1 value %r and undefined component'
' type at %r' % (value, self))
elif componentType is not None and (matchTags or matchConstraints):
subtypeChecker = (
self.strictConstraints and
componentType.isSameTypeWith or
componentType.isSuperTypeOf)
if not subtypeChecker(value, verifyConstraints and matchTags,
verifyConstraints and matchConstraints):
# TODO: we should wrap componentType with UnnamedType to carry
# additional properties associated with componentType
if componentType.typeId != Any.typeId:
raise error.PyAsn1Error(
'Component value is tag-incompatible: %r vs '
'%r' % (value, componentType))
componentValues[idx] = value
self._componentValues = componentValues
return self
@property
def componentTagMap(self):
if self.componentType is not None:
return self.componentType.tagMap
@property
def components(self):
return [self._componentValues[idx]
for idx in sorted(self._componentValues)]
def clear(self):
"""Remove all components and become an empty |ASN.1| value object.
Has the same effect on |ASN.1| object as it does on :class:`list`
built-in.
"""
self._componentValues = {}
return self
def reset(self):
"""Remove all components and become a |ASN.1| schema object.
See :meth:`isValue` property for more information on the
distinction between value and schema objects.
"""
self._componentValues = noValue
return self
def prettyPrint(self, scope=0):
scope += 1
representation = self.__class__.__name__ + ':\n'
if not self.isValue:
return representation
for idx, componentValue in enumerate(self):
representation += ' ' * scope
if (componentValue is noValue and
self.componentType is not None):
representation += ''
else:
representation += componentValue.prettyPrint(scope)
return representation
def prettyPrintType(self, scope=0):
scope += 1
representation = '%s -> %s {\n' % (self.tagSet, self.__class__.__name__)
if self.componentType is not None:
representation += ' ' * scope
representation += self.componentType.prettyPrintType(scope)
return representation + '\n' + ' ' * (scope - 1) + '}'
@property
def isValue(self):
"""Indicate 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).
"""
if self._componentValues is noValue:
return False
if len(self._componentValues) != len(self):
return False
for componentValue in self._componentValues.values():
if componentValue is noValue or not componentValue.isValue:
return False
return True
@property
def isInconsistent(self):
"""Run necessary checks to ensure |ASN.1| object consistency.
Default action is to verify |ASN.1| object against constraints imposed
by `subtypeSpec`.
Raises
------
:py:class:`~pyasn1.error.PyAsn1tError` on any inconsistencies found
"""
if self.componentType is noValue or not self.subtypeSpec:
return False
if self._componentValues is noValue:
return True
mapping = {}
for idx, value in self._componentValues.items():
# Absent fields are not in the mapping
if value is noValue:
continue
mapping[idx] = value
try:
# Represent SequenceOf/SetOf as a bare dict to constraints chain
self.subtypeSpec(mapping)
except error.PyAsn1Error as exc:
return exc
return False
class SequenceOf(SequenceOfAndSetOfBase):
__doc__ = SequenceOfAndSetOfBase.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatConstructed, 0x10)
)
#: Default :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
#: object representing ASN.1 type allowed within |ASN.1| type
componentType = None
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Disambiguation ASN.1 types identification
typeId = SequenceOfAndSetOfBase.getTypeId()
class SetOf(SequenceOfAndSetOfBase):
__doc__ = SequenceOfAndSetOfBase.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatConstructed, 0x11)
)
#: Default :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
#: object representing ASN.1 type allowed within |ASN.1| type
componentType = None
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Disambiguation ASN.1 types identification
typeId = SequenceOfAndSetOfBase.getTypeId()
class SequenceAndSetBase(base.ConstructedAsn1Type):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.ConstructedAsn1Type`,
its objects are mutable and duck-type Python :class:`dict` objects.
Keyword Args
------------
componentType: :py:class:`~pyasn1.type.namedtype.NamedType`
Object holding named ASN.1 types allowed within this collection
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type can only occur on explicit
`.isInconsistent` call.
Examples
--------
.. code-block:: python
class Description(Sequence): # Set is similar
'''
ASN.1 specification:
Description ::= SEQUENCE {
surname IA5String,
first-name IA5String OPTIONAL,
age INTEGER DEFAULT 40
}
'''
componentType = NamedTypes(
NamedType('surname', IA5String()),
OptionalNamedType('first-name', IA5String()),
DefaultedNamedType('age', Integer(40))
)
descr = Description()
descr['surname'] = 'Smith'
descr['first-name'] = 'John'
"""
#: Default :py:class:`~pyasn1.type.namedtype.NamedTypes`
#: object representing named ASN.1 types allowed within |ASN.1| type
componentType = namedtype.NamedTypes()
class DynamicNames(object):
"""Fields names/positions mapping for component-less objects"""
def __init__(self):
self._keyToIdxMap = {}
self._idxToKeyMap = {}
def __len__(self):
return len(self._keyToIdxMap)
def __contains__(self, item):
return item in self._keyToIdxMap or item in self._idxToKeyMap
def __iter__(self):
return (self._idxToKeyMap[idx] for idx in range(len(self._idxToKeyMap)))
def __getitem__(self, item):
try:
return self._keyToIdxMap[item]
except KeyError:
return self._idxToKeyMap[item]
def getNameByPosition(self, idx):
try:
return self._idxToKeyMap[idx]
except KeyError:
raise error.PyAsn1Error('Type position out of range')
def getPositionByName(self, name):
try:
return self._keyToIdxMap[name]
except KeyError:
raise error.PyAsn1Error('Name %s not found' % (name,))
def addField(self, idx):
self._keyToIdxMap['field-%d' % idx] = idx
self._idxToKeyMap[idx] = 'field-%d' % idx
def __init__(self, **kwargs):
base.ConstructedAsn1Type.__init__(self, **kwargs)
self._componentTypeLen = len(self.componentType)
if self._componentTypeLen:
self._componentValues = []
else:
self._componentValues = noValue
self._dynamicNames = self._componentTypeLen or self.DynamicNames()
def __getitem__(self, idx):
if isinstance(idx, str):
try:
return self.getComponentByName(idx)
except error.PyAsn1Error as exc:
# duck-typing dict
raise KeyError(exc)
else:
try:
return self.getComponentByPosition(idx)
except error.PyAsn1Error as exc:
# duck-typing list
raise IndexError(exc)
def __setitem__(self, idx, value):
if isinstance(idx, str):
try:
self.setComponentByName(idx, value)
except error.PyAsn1Error as exc:
# duck-typing dict
raise KeyError(exc)
else:
try:
self.setComponentByPosition(idx, value)
except error.PyAsn1Error as exc:
# duck-typing list
raise IndexError(exc)
def __contains__(self, key):
if self._componentTypeLen:
return key in self.componentType
else:
return key in self._dynamicNames
def __len__(self):
return len(self._componentValues)
def __iter__(self):
return iter(self.componentType or self._dynamicNames)
# Python dict protocol
def values(self):
for idx in range(self._componentTypeLen or len(self._dynamicNames)):
yield self[idx]
def keys(self):
return iter(self)
def items(self):
for idx in range(self._componentTypeLen or len(self._dynamicNames)):
if self._componentTypeLen:
yield self.componentType[idx].name, self[idx]
else:
yield self._dynamicNames[idx], self[idx]
def update(self, *iterValue, **mappingValue):
for k, v in iterValue:
self[k] = v
for k in mappingValue:
self[k] = mappingValue[k]
def clear(self):
"""Remove all components and become an empty |ASN.1| value object.
Has the same effect on |ASN.1| object as it does on :class:`dict`
built-in.
"""
self._componentValues = []
self._dynamicNames = self.DynamicNames()
return self
def reset(self):
"""Remove all components and become a |ASN.1| schema object.
See :meth:`isValue` property for more information on the
distinction between value and schema objects.
"""
self._componentValues = noValue
self._dynamicNames = self.DynamicNames()
return self
@property
def components(self):
return self._componentValues
def _cloneComponentValues(self, myClone, cloneValueFlag):
if self._componentValues is noValue:
return
for idx, componentValue in enumerate(self._componentValues):
if componentValue is not noValue:
if isinstance(componentValue, base.ConstructedAsn1Type):
myClone.setComponentByPosition(
idx, componentValue.clone(cloneValueFlag=cloneValueFlag)
)
else:
myClone.setComponentByPosition(idx, componentValue.clone())
def getComponentByName(self, name, default=noValue, instantiate=True):
"""Returns |ASN.1| type component by name.
Equivalent to Python :class:`dict` subscription operation (e.g. `[]`).
Parameters
----------
name: :class:`str`
|ASN.1| type component name
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically
instantiated.
If :obj:`False` either existing component or the :class:`NoValue`
object will be returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
Instantiate |ASN.1| component type or return existing
component value
"""
if self._componentTypeLen:
idx = self.componentType.getPositionByName(name)
else:
try:
idx = self._dynamicNames.getPositionByName(name)
except KeyError:
raise error.PyAsn1Error('Name %s not found' % (name,))
return self.getComponentByPosition(idx, default=default, instantiate=instantiate)
def setComponentByName(self, name, value=noValue,
verifyConstraints=True,
matchTags=True,
matchConstraints=True):
"""Assign |ASN.1| type component by name.
Equivalent to Python :class:`dict` item assignment operation (e.g. `[]`).
Parameters
----------
name: :class:`str`
|ASN.1| type component name
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints: :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
"""
if self._componentTypeLen:
idx = self.componentType.getPositionByName(name)
else:
try:
idx = self._dynamicNames.getPositionByName(name)
except KeyError:
raise error.PyAsn1Error('Name %s not found' % (name,))
return self.setComponentByPosition(
idx, value, verifyConstraints, matchTags, matchConstraints
)
def getComponentByPosition(self, idx, default=noValue, instantiate=True):
"""Returns |ASN.1| type component by index.
Equivalent to Python sequence subscription operation (e.g. `[]`).
Parameters
----------
idx: :class:`int`
Component index (zero-based). Must either refer to an existing
component or (if *componentType* is set) new ASN.1 schema object gets
instantiated.
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically
instantiated.
If :obj:`False` either existing component or the :class:`NoValue`
object will be returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
a PyASN1 object
Examples
--------
.. code-block:: python
# can also be Set
class MySequence(Sequence):
componentType = NamedTypes(
NamedType('id', OctetString())
)
s = MySequence()
# returns component #0 with `.isValue` property False
s.getComponentByPosition(0)
# returns None
s.getComponentByPosition(0, default=None)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
# sets component #0 to OctetString() ASN.1 schema
# object and returns it
s.getComponentByPosition(0, instantiate=True)
# sets component #0 to ASN.1 value object
s.setComponentByPosition(0, 'ABCD')
# returns OctetString('ABCD') value object
s.getComponentByPosition(0, instantiate=False)
s.clear()
# returns noValue
s.getComponentByPosition(0, instantiate=False)
"""
try:
if self._componentValues is noValue:
componentValue = noValue
else:
componentValue = self._componentValues[idx]
except IndexError:
componentValue = noValue
if not instantiate:
if componentValue is noValue or not componentValue.isValue:
return default
else:
return componentValue
if componentValue is noValue:
self.setComponentByPosition(idx)
componentValue = self._componentValues[idx]
if default is noValue or componentValue.isValue:
return componentValue
else:
return default
def setComponentByPosition(self, idx, value=noValue,
verifyConstraints=True,
matchTags=True,
matchConstraints=True):
"""Assign |ASN.1| type component by position.
Equivalent to Python sequence item assignment operation (e.g. `[]`).
Parameters
----------
idx : :class:`int`
Component index (zero-based). Must either refer to existing
component (if *componentType* is set) or to N+1 component
otherwise. In the latter case a new component of given ASN.1
type gets instantiated and appended to |ASN.1| sequence.
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints : :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
"""
componentType = self.componentType
componentTypeLen = self._componentTypeLen
if self._componentValues is noValue:
componentValues = []
else:
componentValues = self._componentValues
try:
currentValue = componentValues[idx]
except IndexError:
currentValue = noValue
if componentTypeLen:
if componentTypeLen < idx:
raise error.PyAsn1Error('component index out of range')
componentValues = [noValue] * componentTypeLen
if value is noValue:
if componentTypeLen:
value = componentType.getTypeByPosition(idx)
if isinstance(value, base.ConstructedAsn1Type):
value = value.clone(cloneValueFlag=componentType[idx].isDefaulted)
elif currentValue is noValue:
raise error.PyAsn1Error('Component type not defined')
elif not isinstance(value, base.Asn1Item):
if componentTypeLen:
subComponentType = componentType.getTypeByPosition(idx)
if isinstance(subComponentType, base.SimpleAsn1Type):
value = subComponentType.clone(value=value)
else:
raise error.PyAsn1Error('%s can cast only scalar values' % componentType.__class__.__name__)
elif currentValue is not noValue and isinstance(currentValue, base.SimpleAsn1Type):
value = currentValue.clone(value=value)
else:
raise error.PyAsn1Error('%s undefined component type' % componentType.__class__.__name__)
elif ((verifyConstraints or matchTags or matchConstraints) and
componentTypeLen):
subComponentType = componentType.getTypeByPosition(idx)
if subComponentType is not noValue:
subtypeChecker = (self.strictConstraints and
subComponentType.isSameTypeWith or
subComponentType.isSuperTypeOf)
if not subtypeChecker(value, verifyConstraints and matchTags,
verifyConstraints and matchConstraints):
if not componentType[idx].openType:
raise error.PyAsn1Error('Component value is tag-incompatible: %r vs %r' % (value, componentType))
if componentTypeLen or idx in self._dynamicNames:
componentValues[idx] = value
elif len(componentValues) == idx:
componentValues.append(value)
self._dynamicNames.addField(idx)
else:
raise error.PyAsn1Error('Component index out of range')
self._componentValues = componentValues
return self
@property
def isValue(self):
"""Indicate 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).
It is sufficient for |ASN.1| objects to have all non-optional and non-defaulted
components being value objects to be considered as a value objects as a whole.
In other words, even having one or more optional components not turned into
value objects, |ASN.1| object is still considered as a value object. Defaulted
components are normally value objects by default.
"""
if self._componentValues is noValue:
return False
componentType = self.componentType
if componentType:
for idx, subComponentType in enumerate(componentType.namedTypes):
if subComponentType.isDefaulted or subComponentType.isOptional:
continue
if not self._componentValues:
return False
componentValue = self._componentValues[idx]
if componentValue is noValue or not componentValue.isValue:
return False
else:
for componentValue in self._componentValues:
if componentValue is noValue or not componentValue.isValue:
return False
return True
@property
def isInconsistent(self):
"""Run necessary checks to ensure |ASN.1| object consistency.
Default action is to verify |ASN.1| object against constraints imposed
by `subtypeSpec`.
Raises
------
:py:class:`~pyasn1.error.PyAsn1tError` on any inconsistencies found
"""
if self.componentType is noValue or not self.subtypeSpec:
return False
if self._componentValues is noValue:
return True
mapping = {}
for idx, value in enumerate(self._componentValues):
# Absent fields are not in the mapping
if value is noValue:
continue
name = self.componentType.getNameByPosition(idx)
mapping[name] = value
try:
# Represent Sequence/Set as a bare dict to constraints chain
self.subtypeSpec(mapping)
except error.PyAsn1Error as exc:
return exc
return False
def prettyPrint(self, scope=0):
"""Return an object representation string.
Returns
-------
: :class:`str`
Human-friendly object representation.
"""
scope += 1
representation = self.__class__.__name__ + ':\n'
for idx, componentValue in enumerate(self._componentValues):
if componentValue is not noValue and componentValue.isValue:
representation += ' ' * scope
if self.componentType:
representation += self.componentType.getNameByPosition(idx)
else:
representation += self._dynamicNames.getNameByPosition(idx)
representation = '%s=%s\n' % (
representation, componentValue.prettyPrint(scope)
)
return representation
def prettyPrintType(self, scope=0):
scope += 1
representation = '%s -> %s {\n' % (self.tagSet, self.__class__.__name__)
for idx, componentType in enumerate(self.componentType.values() or self._componentValues):
representation += ' ' * scope
if self.componentType:
representation += '"%s"' % self.componentType.getNameByPosition(idx)
else:
representation += '"%s"' % self._dynamicNames.getNameByPosition(idx)
representation = '%s = %s\n' % (
representation, componentType.prettyPrintType(scope)
)
return representation + '\n' + ' ' * (scope - 1) + '}'
# backward compatibility
def setDefaultComponents(self):
return self
def getComponentType(self):
if self._componentTypeLen:
return self.componentType
def getNameByPosition(self, idx):
if self._componentTypeLen:
return self.componentType[idx].name
class Sequence(SequenceAndSetBase):
__doc__ = SequenceAndSetBase.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatConstructed, 0x10)
)
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
#: Default collection of ASN.1 types of component (e.g. :py:class:`~pyasn1.type.namedtype.NamedType`)
#: object imposing size constraint on |ASN.1| objects
componentType = namedtype.NamedTypes()
# Disambiguation ASN.1 types identification
typeId = SequenceAndSetBase.getTypeId()
# backward compatibility
def getComponentTagMapNearPosition(self, idx):
if self.componentType:
return self.componentType.getTagMapNearPosition(idx)
def getComponentPositionNearType(self, tagSet, idx):
if self.componentType:
return self.componentType.getPositionNearType(tagSet, idx)
else:
return idx
class Set(SequenceAndSetBase):
__doc__ = SequenceAndSetBase.__doc__
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.initTagSet(
tag.Tag(tag.tagClassUniversal, tag.tagFormatConstructed, 0x11)
)
#: Default collection of ASN.1 types of component (e.g. :py:class:`~pyasn1.type.namedtype.NamedType`)
#: object representing ASN.1 type allowed within |ASN.1| type
componentType = namedtype.NamedTypes()
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Disambiguation ASN.1 types identification
typeId = SequenceAndSetBase.getTypeId()
def getComponent(self, innerFlag=False):
return self
def getComponentByType(self, tagSet, default=noValue,
instantiate=True, innerFlag=False):
"""Returns |ASN.1| type component by ASN.1 tag.
Parameters
----------
tagSet : :py:class:`~pyasn1.type.tag.TagSet`
Object representing ASN.1 tags to identify one of
|ASN.1| object component
Keyword Args
------------
default: :class:`object`
If set and requested component is a schema object, return the `default`
object instead of the requested component.
instantiate: :class:`bool`
If :obj:`True` (default), inner component will be automatically
instantiated.
If :obj:`False` either existing component or the :class:`noValue`
object will be returned.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
a pyasn1 object
"""
componentValue = self.getComponentByPosition(
self.componentType.getPositionByType(tagSet),
default=default, instantiate=instantiate
)
if innerFlag and isinstance(componentValue, Set):
# get inner component by inner tagSet
return componentValue.getComponent(innerFlag=True)
else:
# get outer component by inner tagSet
return componentValue
def setComponentByType(self, tagSet, value=noValue,
verifyConstraints=True,
matchTags=True,
matchConstraints=True,
innerFlag=False):
"""Assign |ASN.1| type component by ASN.1 tag.
Parameters
----------
tagSet : :py:class:`~pyasn1.type.tag.TagSet`
Object representing ASN.1 tags to identify one of
|ASN.1| object component
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component.
If `value` is not given, schema object will be set as a component.
verifyConstraints : :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
innerFlag: :class:`bool`
If :obj:`True`, search for matching *tagSet* recursively.
Returns
-------
self
"""
idx = self.componentType.getPositionByType(tagSet)
if innerFlag: # set inner component by inner tagSet
componentType = self.componentType.getTypeByPosition(idx)
if componentType.tagSet:
return self.setComponentByPosition(
idx, value, verifyConstraints, matchTags, matchConstraints
)
else:
componentType = self.getComponentByPosition(idx)
return componentType.setComponentByType(
tagSet, value, verifyConstraints, matchTags, matchConstraints, innerFlag=innerFlag
)
else: # set outer component by inner tagSet
return self.setComponentByPosition(
idx, value, verifyConstraints, matchTags, matchConstraints
)
@property
def componentTagMap(self):
if self.componentType:
return self.componentType.tagMapUnique
class Choice(Set):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.ConstructedAsn1Type`,
its objects are mutable and duck-type Python :class:`list` objects.
Keyword Args
------------
componentType: :py:class:`~pyasn1.type.namedtype.NamedType`
Object holding named ASN.1 types allowed within this collection
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type can only occur on explicit
`.isInconsistent` call.
Examples
--------
.. code-block:: python
class Afters(Choice):
'''
ASN.1 specification:
Afters ::= CHOICE {
cheese [0] IA5String,
dessert [1] IA5String
}
'''
componentType = NamedTypes(
NamedType('cheese', IA5String().subtype(
implicitTag=Tag(tagClassContext, tagFormatSimple, 0)
),
NamedType('dessert', IA5String().subtype(
implicitTag=Tag(tagClassContext, tagFormatSimple, 1)
)
)
afters = Afters()
afters['cheese'] = 'Mascarpone'
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.TagSet() # untagged
#: Default collection of ASN.1 types of component (e.g. :py:class:`~pyasn1.type.namedtype.NamedType`)
#: object representing ASN.1 type allowed within |ASN.1| type
componentType = namedtype.NamedTypes()
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection(
constraint.ValueSizeConstraint(1, 1)
)
# Disambiguation ASN.1 types identification
typeId = Set.getTypeId()
_currentIdx = None
def __eq__(self, other):
if self._componentValues:
return self._componentValues[self._currentIdx] == other
return NotImplemented
def __ne__(self, other):
if self._componentValues:
return self._componentValues[self._currentIdx] != other
return NotImplemented
def __lt__(self, other):
if self._componentValues:
return self._componentValues[self._currentIdx] < other
return NotImplemented
def __le__(self, other):
if self._componentValues:
return self._componentValues[self._currentIdx] <= other
return NotImplemented
def __gt__(self, other):
if self._componentValues:
return self._componentValues[self._currentIdx] > other
return NotImplemented
def __ge__(self, other):
if self._componentValues:
return self._componentValues[self._currentIdx] >= other
return NotImplemented
def __bool__(self):
return bool(self._componentValues)
def __len__(self):
return self._currentIdx is not None and 1 or 0
def __contains__(self, key):
if self._currentIdx is None:
return False
return key == self.componentType[self._currentIdx].getName()
def __iter__(self):
if self._currentIdx is None:
raise StopIteration
yield self.componentType[self._currentIdx].getName()
# Python dict protocol
def values(self):
if self._currentIdx is not None:
yield self._componentValues[self._currentIdx]
def keys(self):
if self._currentIdx is not None:
yield self.componentType[self._currentIdx].getName()
def items(self):
if self._currentIdx is not None:
yield self.componentType[self._currentIdx].getName(), self[self._currentIdx]
def checkConsistency(self):
if self._currentIdx is None:
raise error.PyAsn1Error('Component not chosen')
def _cloneComponentValues(self, myClone, cloneValueFlag):
try:
component = self.getComponent()
except error.PyAsn1Error:
pass
else:
if isinstance(component, Choice):
tagSet = component.effectiveTagSet
else:
tagSet = component.tagSet
if isinstance(component, base.ConstructedAsn1Type):
myClone.setComponentByType(
tagSet, component.clone(cloneValueFlag=cloneValueFlag)
)
else:
myClone.setComponentByType(tagSet, component.clone())
def getComponentByPosition(self, idx, default=noValue, instantiate=True):
__doc__ = Set.__doc__
if self._currentIdx is None or self._currentIdx != idx:
return Set.getComponentByPosition(self, idx, default=default,
instantiate=instantiate)
return self._componentValues[idx]
def setComponentByPosition(self, idx, value=noValue,
verifyConstraints=True,
matchTags=True,
matchConstraints=True):
"""Assign |ASN.1| type component by position.
Equivalent to Python sequence item assignment operation (e.g. `[]`).
Parameters
----------
idx: :class:`int`
Component index (zero-based). Must either refer to existing
component or to N+1 component. In the latter case a new component
type gets instantiated (if *componentType* is set, or given ASN.1
object is taken otherwise) and appended to the |ASN.1| sequence.
Keyword Args
------------
value: :class:`object` or :py:class:`~pyasn1.type.base.PyAsn1Item` derivative
A Python value to initialize |ASN.1| component with (if *componentType* is set)
or ASN.1 value object to assign to |ASN.1| component. Once a new value is
set to *idx* component, previous value is dropped.
If `value` is not given, schema object will be set as a component.
verifyConstraints : :class:`bool`
If :obj:`False`, skip constraints validation
matchTags: :class:`bool`
If :obj:`False`, skip component tags matching
matchConstraints: :class:`bool`
If :obj:`False`, skip component constraints matching
Returns
-------
self
"""
oldIdx = self._currentIdx
Set.setComponentByPosition(self, idx, value, verifyConstraints, matchTags, matchConstraints)
self._currentIdx = idx
if oldIdx is not None and oldIdx != idx:
self._componentValues[oldIdx] = noValue
return self
@property
def effectiveTagSet(self):
"""Return a :class:`~pyasn1.type.tag.TagSet` object of the currently initialized component or self (if |ASN.1| is tagged)."""
if self.tagSet:
return self.tagSet
else:
component = self.getComponent()
return component.effectiveTagSet
@property
def tagMap(self):
""""Return a :class:`~pyasn1.type.tagmap.TagMap` object mapping
ASN.1 tags to ASN.1 objects contained within callee.
"""
if self.tagSet:
return Set.tagMap.fget(self)
else:
return self.componentType.tagMapUnique
def getComponent(self, innerFlag=False):
"""Return currently assigned component of the |ASN.1| object.
Returns
-------
: :py:class:`~pyasn1.type.base.PyAsn1Item`
a PyASN1 object
"""
if self._currentIdx is None:
raise error.PyAsn1Error('Component not chosen')
else:
c = self._componentValues[self._currentIdx]
if innerFlag and isinstance(c, Choice):
return c.getComponent(innerFlag)
else:
return c
def getName(self, innerFlag=False):
"""Return the name of currently assigned component of the |ASN.1| object.
Returns
-------
: :py:class:`str`
|ASN.1| component name
"""
if self._currentIdx is None:
raise error.PyAsn1Error('Component not chosen')
else:
if innerFlag:
c = self._componentValues[self._currentIdx]
if isinstance(c, Choice):
return c.getName(innerFlag)
return self.componentType.getNameByPosition(self._currentIdx)
@property
def isValue(self):
"""Indicate 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).
"""
if self._currentIdx is None:
return False
componentValue = self._componentValues[self._currentIdx]
return componentValue is not noValue and componentValue.isValue
def clear(self):
self._currentIdx = None
return Set.clear(self)
# compatibility stubs
def getMinTagSet(self):
return self.minTagSet
class Any(OctetString):
"""Create |ASN.1| schema or value object.
|ASN.1| class is based on :class:`~pyasn1.type.base.SimpleAsn1Type`,
its objects are immutable and duck-type :class:`bytes`.
When used in Unicode context, |ASN.1| type assumes
"|encoding|" serialisation.
Keyword Args
------------
value: :class:`unicode`, :class:`str`, :class:`bytes` or |ASN.1| object
:class:`bytes`, alternatively :class:`str`
representing character string to be serialised into octets (note
`encoding` parameter) or |ASN.1| object.
If `value` is not given, schema object will be created.
tagSet: :py:class:`~pyasn1.type.tag.TagSet`
Object representing non-default ASN.1 tag(s)
subtypeSpec: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection`
Object representing non-default ASN.1 subtype constraint(s). Constraints
verification for |ASN.1| type occurs automatically on object
instantiation.
encoding: :py:class:`str`
Unicode codec ID to encode/decode
:class:`str` the payload when |ASN.1| object is used
in text string context.
binValue: :py:class:`str`
Binary string initializer to use instead of the *value*.
Example: '10110011'.
hexValue: :py:class:`str`
Hexadecimal string initializer to use instead of the *value*.
Example: 'DEADBEEF'.
Raises
------
~pyasn1.error.ValueConstraintError, ~pyasn1.error.PyAsn1Error
On constraint violation or bad initializer.
Examples
--------
.. code-block:: python
class Error(Sequence):
'''
ASN.1 specification:
Error ::= SEQUENCE {
code INTEGER,
parameter ANY DEFINED BY code -- Either INTEGER or REAL
}
'''
componentType=NamedTypes(
NamedType('code', Integer()),
NamedType('parameter', Any(),
openType=OpenType('code', {1: Integer(),
2: Real()}))
)
error = Error()
error['code'] = 1
error['parameter'] = Integer(1234)
"""
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.tag.TagSet` object representing ASN.1 tag(s)
#: associated with |ASN.1| type.
tagSet = tag.TagSet() # untagged
#: Set (on class, not on instance) or return a
#: :py:class:`~pyasn1.type.constraint.ConstraintsIntersection` object
#: imposing constraints on |ASN.1| type initialization values.
subtypeSpec = constraint.ConstraintsIntersection()
# Disambiguation ASN.1 types identification
typeId = OctetString.getTypeId()
@property
def tagMap(self):
""""Return a :class:`~pyasn1.type.tagmap.TagMap` object mapping
ASN.1 tags to ASN.1 objects contained within callee.
"""
try:
return self._tagMap
except AttributeError:
self._tagMap = tagmap.TagMap(
{self.tagSet: self},
{eoo.endOfOctets.tagSet: eoo.endOfOctets},
self
)
return self._tagMap
# XXX
# coercion rules?
PK ! 鎴波 useful.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
import datetime
from pyasn1 import error
from pyasn1.type import char
from pyasn1.type import tag
from pyasn1.type import univ
__all__ = ['ObjectDescriptor', 'GeneralizedTime', 'UTCTime']
NoValue = univ.NoValue
noValue = univ.noValue
class ObjectDescriptor(char.GraphicString):
__doc__ = char.GraphicString.__doc__
#: Default :py:class:`~pyasn1.type.tag.TagSet` object for |ASN.1| objects
tagSet = char.GraphicString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 7)
)
# Optimization for faster codec lookup
typeId = char.GraphicString.getTypeId()
class TimeMixIn(object):
_yearsDigits = 4
_hasSubsecond = False
_optionalMinutes = False
_shortTZ = False
class FixedOffset(datetime.tzinfo):
"""Fixed offset in minutes east from UTC."""
# defaulted arguments required
# https: // docs.python.org / 2.3 / lib / datetime - tzinfo.html
def __init__(self, offset=0, name='UTC'):
self.__offset = datetime.timedelta(minutes=offset)
self.__name = name
def utcoffset(self, dt):
return self.__offset
def tzname(self, dt):
return self.__name
def dst(self, dt):
return datetime.timedelta(0)
UTC = FixedOffset()
@property
def asDateTime(self):
"""Create :py:class:`datetime.datetime` object from a |ASN.1| object.
Returns
-------
:
new instance of :py:class:`datetime.datetime` object
"""
text = str(self)
if text.endswith('Z'):
tzinfo = TimeMixIn.UTC
text = text[:-1]
elif '-' in text or '+' in text:
if '+' in text:
text, plusminus, tz = text.partition('+')
else:
text, plusminus, tz = text.partition('-')
if self._shortTZ and len(tz) == 2:
tz += '00'
if len(tz) != 4:
raise error.PyAsn1Error('malformed time zone offset %s' % tz)
try:
minutes = int(tz[:2]) * 60 + int(tz[2:])
if plusminus == '-':
minutes *= -1
except ValueError:
raise error.PyAsn1Error('unknown time specification %s' % self)
tzinfo = TimeMixIn.FixedOffset(minutes, '?')
else:
tzinfo = None
if '.' in text or ',' in text:
if '.' in text:
text, _, ms = text.partition('.')
else:
text, _, ms = text.partition(',')
try:
ms = int(ms) * 1000
except ValueError:
raise error.PyAsn1Error('bad sub-second time specification %s' % self)
else:
ms = 0
if self._optionalMinutes and len(text) - self._yearsDigits == 6:
text += '0000'
elif len(text) - self._yearsDigits == 8:
text += '00'
try:
dt = datetime.datetime.strptime(text, self._yearsDigits == 4 and '%Y%m%d%H%M%S' or '%y%m%d%H%M%S')
except ValueError:
raise error.PyAsn1Error('malformed datetime format %s' % self)
return dt.replace(microsecond=ms, tzinfo=tzinfo)
@classmethod
def fromDateTime(cls, dt):
"""Create |ASN.1| object from a :py:class:`datetime.datetime` object.
Parameters
----------
dt: :py:class:`datetime.datetime` object
The `datetime.datetime` object to initialize the |ASN.1| object
from
Returns
-------
:
new instance of |ASN.1| value
"""
text = dt.strftime(cls._yearsDigits == 4 and '%Y%m%d%H%M%S' or '%y%m%d%H%M%S')
if cls._hasSubsecond:
text += '.%d' % (dt.microsecond // 1000)
if dt.utcoffset():
seconds = dt.utcoffset().seconds
if seconds < 0:
text += '-'
else:
text += '+'
text += '%.2d%.2d' % (seconds // 3600, seconds % 3600)
else:
text += 'Z'
return cls(text)
class GeneralizedTime(char.VisibleString, TimeMixIn):
__doc__ = char.VisibleString.__doc__
#: Default :py:class:`~pyasn1.type.tag.TagSet` object for |ASN.1| objects
tagSet = char.VisibleString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 24)
)
# Optimization for faster codec lookup
typeId = char.VideotexString.getTypeId()
_yearsDigits = 4
_hasSubsecond = True
_optionalMinutes = True
_shortTZ = True
class UTCTime(char.VisibleString, TimeMixIn):
__doc__ = char.VisibleString.__doc__
#: Default :py:class:`~pyasn1.type.tag.TagSet` object for |ASN.1| objects
tagSet = char.VisibleString.tagSet.tagImplicitly(
tag.Tag(tag.tagClassUniversal, tag.tagFormatSimple, 23)
)
# Optimization for faster codec lookup
typeId = char.VideotexString.getTypeId()
_yearsDigits = 2
_hasSubsecond = False
_optionalMinutes = False
_shortTZ = False
PK ! D@匯; ; __init__.pynu 刐迭 # This file is necessary to make this directory a package.
PK ! f3? 3? namedtype.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
import sys
from pyasn1 import error
from pyasn1.type import tag
from pyasn1.type import tagmap
__all__ = ['NamedType', 'OptionalNamedType', 'DefaultedNamedType',
'NamedTypes']
class NamedType(object):
"""Create named field object for a constructed ASN.1 type.
The |NamedType| object represents a single name and ASN.1 type of a constructed ASN.1 type.
|NamedType| objects are immutable and duck-type Python :class:`tuple` objects
holding *name* and *asn1Object* components.
Parameters
----------
name: :py:class:`str`
Field name
asn1Object:
ASN.1 type object
"""
isOptional = False
isDefaulted = False
def __init__(self, name, asn1Object, openType=None):
self.__name = name
self.__type = asn1Object
self.__nameAndType = name, asn1Object
self.__openType = openType
def __repr__(self):
representation = '%s=%r' % (self.name, self.asn1Object)
if self.openType:
representation += ', open type %r' % self.openType
return '<%s object, type %s>' % (
self.__class__.__name__, representation)
def __eq__(self, other):
return self.__nameAndType == other
def __ne__(self, other):
return self.__nameAndType != other
def __lt__(self, other):
return self.__nameAndType < other
def __le__(self, other):
return self.__nameAndType <= other
def __gt__(self, other):
return self.__nameAndType > other
def __ge__(self, other):
return self.__nameAndType >= other
def __hash__(self):
return hash(self.__nameAndType)
def __getitem__(self, idx):
return self.__nameAndType[idx]
def __iter__(self):
return iter(self.__nameAndType)
@property
def name(self):
return self.__name
@property
def asn1Object(self):
return self.__type
@property
def openType(self):
return self.__openType
# Backward compatibility
def getName(self):
return self.name
def getType(self):
return self.asn1Object
class OptionalNamedType(NamedType):
__doc__ = NamedType.__doc__
isOptional = True
class DefaultedNamedType(NamedType):
__doc__ = NamedType.__doc__
isDefaulted = True
class NamedTypes(object):
"""Create a collection of named fields for a constructed ASN.1 type.
The NamedTypes object represents a collection of named fields of a constructed ASN.1 type.
*NamedTypes* objects are immutable and duck-type Python :class:`dict` objects
holding *name* as keys and ASN.1 type object as values.
Parameters
----------
*namedTypes: :class:`~pyasn1.type.namedtype.NamedType`
Examples
--------
.. code-block:: python
class Description(Sequence):
'''
ASN.1 specification:
Description ::= SEQUENCE {
surname IA5String,
first-name IA5String OPTIONAL,
age INTEGER DEFAULT 40
}
'''
componentType = NamedTypes(
NamedType('surname', IA5String()),
OptionalNamedType('first-name', IA5String()),
DefaultedNamedType('age', Integer(40))
)
descr = Description()
descr['surname'] = 'Smith'
descr['first-name'] = 'John'
"""
def __init__(self, *namedTypes, **kwargs):
self.__namedTypes = namedTypes
self.__namedTypesLen = len(self.__namedTypes)
self.__minTagSet = self.__computeMinTagSet()
self.__nameToPosMap = self.__computeNameToPosMap()
self.__tagToPosMap = self.__computeTagToPosMap()
self.__ambiguousTypes = 'terminal' not in kwargs and self.__computeAmbiguousTypes() or {}
self.__uniqueTagMap = self.__computeTagMaps(unique=True)
self.__nonUniqueTagMap = self.__computeTagMaps(unique=False)
self.__hasOptionalOrDefault = any([True for namedType in self.__namedTypes
if namedType.isDefaulted or namedType.isOptional])
self.__hasOpenTypes = any([True for namedType in self.__namedTypes
if namedType.openType])
self.__requiredComponents = frozenset(
[idx for idx, nt in enumerate(self.__namedTypes) if not nt.isOptional and not nt.isDefaulted]
)
self.__keys = frozenset([namedType.name for namedType in self.__namedTypes])
self.__values = tuple([namedType.asn1Object for namedType in self.__namedTypes])
self.__items = tuple([(namedType.name, namedType.asn1Object) for namedType in self.__namedTypes])
def __repr__(self):
representation = ', '.join(['%r' % x for x in self.__namedTypes])
return '<%s object, types %s>' % (
self.__class__.__name__, representation)
def __eq__(self, other):
return self.__namedTypes == other
def __ne__(self, other):
return self.__namedTypes != other
def __lt__(self, other):
return self.__namedTypes < other
def __le__(self, other):
return self.__namedTypes <= other
def __gt__(self, other):
return self.__namedTypes > other
def __ge__(self, other):
return self.__namedTypes >= other
def __hash__(self):
return hash(self.__namedTypes)
def __getitem__(self, idx):
try:
return self.__namedTypes[idx]
except TypeError:
return self.__namedTypes[self.__nameToPosMap[idx]]
def __contains__(self, key):
return key in self.__nameToPosMap
def __iter__(self):
return (x[0] for x in self.__namedTypes)
def __bool__(self):
return self.__namedTypesLen > 0
def __len__(self):
return self.__namedTypesLen
# Python dict protocol
def values(self):
return self.__values
def keys(self):
return self.__keys
def items(self):
return self.__items
def clone(self):
return self.__class__(*self.__namedTypes)
class PostponedError(object):
def __init__(self, errorMsg):
self.__errorMsg = errorMsg
def __getitem__(self, item):
raise error.PyAsn1Error(self.__errorMsg)
def __computeTagToPosMap(self):
tagToPosMap = {}
for idx, namedType in enumerate(self.__namedTypes):
tagMap = namedType.asn1Object.tagMap
if isinstance(tagMap, NamedTypes.PostponedError):
return tagMap
if not tagMap:
continue
for _tagSet in tagMap.presentTypes:
if _tagSet in tagToPosMap:
return NamedTypes.PostponedError('Duplicate component tag %s at %s' % (_tagSet, namedType))
tagToPosMap[_tagSet] = idx
return tagToPosMap
def __computeNameToPosMap(self):
nameToPosMap = {}
for idx, namedType in enumerate(self.__namedTypes):
if namedType.name in nameToPosMap:
return NamedTypes.PostponedError('Duplicate component name %s at %s' % (namedType.name, namedType))
nameToPosMap[namedType.name] = idx
return nameToPosMap
def __computeAmbiguousTypes(self):
ambiguousTypes = {}
partialAmbiguousTypes = ()
for idx, namedType in reversed(tuple(enumerate(self.__namedTypes))):
if namedType.isOptional or namedType.isDefaulted:
partialAmbiguousTypes = (namedType,) + partialAmbiguousTypes
else:
partialAmbiguousTypes = (namedType,)
if len(partialAmbiguousTypes) == len(self.__namedTypes):
ambiguousTypes[idx] = self
else:
ambiguousTypes[idx] = NamedTypes(*partialAmbiguousTypes, **dict(terminal=True))
return ambiguousTypes
def getTypeByPosition(self, idx):
"""Return ASN.1 type object by its position in fields set.
Parameters
----------
idx: :py:class:`int`
Field index
Returns
-------
:
ASN.1 type
Raises
------
~pyasn1.error.PyAsn1Error
If given position is out of fields range
"""
try:
return self.__namedTypes[idx].asn1Object
except IndexError:
raise error.PyAsn1Error('Type position out of range')
def getPositionByType(self, tagSet):
"""Return field position by its ASN.1 type.
Parameters
----------
tagSet: :class:`~pysnmp.type.tag.TagSet`
ASN.1 tag set distinguishing one ASN.1 type from others.
Returns
-------
: :py:class:`int`
ASN.1 type position in fields set
Raises
------
~pyasn1.error.PyAsn1Error
If *tagSet* is not present or ASN.1 types are not unique within callee *NamedTypes*
"""
try:
return self.__tagToPosMap[tagSet]
except KeyError:
raise error.PyAsn1Error('Type %s not found' % (tagSet,))
def getNameByPosition(self, idx):
"""Return field name by its position in fields set.
Parameters
----------
idx: :py:class:`idx`
Field index
Returns
-------
: :py:class:`str`
Field name
Raises
------
~pyasn1.error.PyAsn1Error
If given field name is not present in callee *NamedTypes*
"""
try:
return self.__namedTypes[idx].name
except IndexError:
raise error.PyAsn1Error('Type position out of range')
def getPositionByName(self, name):
"""Return field position by filed name.
Parameters
----------
name: :py:class:`str`
Field name
Returns
-------
: :py:class:`int`
Field position in fields set
Raises
------
~pyasn1.error.PyAsn1Error
If *name* is not present or not unique within callee *NamedTypes*
"""
try:
return self.__nameToPosMap[name]
except KeyError:
raise error.PyAsn1Error('Name %s not found' % (name,))
def getTagMapNearPosition(self, idx):
"""Return ASN.1 types that are allowed at or past given field position.
Some ASN.1 serialisation allow for skipping optional and defaulted fields.
Some constructed ASN.1 types allow reordering of the fields. When recovering
such objects it may be important to know which types can possibly be
present at any given position in the field sets.
Parameters
----------
idx: :py:class:`int`
Field index
Returns
-------
: :class:`~pyasn1.type.tagmap.TagMap`
Map if ASN.1 types allowed at given field position
Raises
------
~pyasn1.error.PyAsn1Error
If given position is out of fields range
"""
try:
return self.__ambiguousTypes[idx].tagMap
except KeyError:
raise error.PyAsn1Error('Type position out of range')
def getPositionNearType(self, tagSet, idx):
"""Return the closest field position where given ASN.1 type is allowed.
Some ASN.1 serialisation allow for skipping optional and defaulted fields.
Some constructed ASN.1 types allow reordering of the fields. When recovering
such objects it may be important to know at which field position, in field set,
given *tagSet* is allowed at or past *idx* position.
Parameters
----------
tagSet: :class:`~pyasn1.type.tag.TagSet`
ASN.1 type which field position to look up
idx: :py:class:`int`
Field position at or past which to perform ASN.1 type look up
Returns
-------
: :py:class:`int`
Field position in fields set
Raises
------
~pyasn1.error.PyAsn1Error
If *tagSet* is not present or not unique within callee *NamedTypes*
or *idx* is out of fields range
"""
try:
return idx + self.__ambiguousTypes[idx].getPositionByType(tagSet)
except KeyError:
raise error.PyAsn1Error('Type position out of range')
def __computeMinTagSet(self):
minTagSet = None
for namedType in self.__namedTypes:
asn1Object = namedType.asn1Object
try:
tagSet = asn1Object.minTagSet
except AttributeError:
tagSet = asn1Object.tagSet
if minTagSet is None or tagSet < minTagSet:
minTagSet = tagSet
return minTagSet or tag.TagSet()
@property
def minTagSet(self):
"""Return the minimal TagSet among ASN.1 type in callee *NamedTypes*.
Some ASN.1 types/serialisation protocols require ASN.1 types to be
arranged based on their numerical tag value. The *minTagSet* property
returns that.
Returns
-------
: :class:`~pyasn1.type.tagset.TagSet`
Minimal TagSet among ASN.1 types in callee *NamedTypes*
"""
return self.__minTagSet
def __computeTagMaps(self, unique):
presentTypes = {}
skipTypes = {}
defaultType = None
for namedType in self.__namedTypes:
tagMap = namedType.asn1Object.tagMap
if isinstance(tagMap, NamedTypes.PostponedError):
return tagMap
for tagSet in tagMap:
if unique and tagSet in presentTypes:
return NamedTypes.PostponedError('Non-unique tagSet %s of %s at %s' % (tagSet, namedType, self))
presentTypes[tagSet] = namedType.asn1Object
skipTypes.update(tagMap.skipTypes)
if defaultType is None:
defaultType = tagMap.defaultType
elif tagMap.defaultType is not None:
return NamedTypes.PostponedError('Duplicate default ASN.1 type at %s' % (self,))
return tagmap.TagMap(presentTypes, skipTypes, defaultType)
@property
def tagMap(self):
"""Return a *TagMap* object from tags and types recursively.
Return a :class:`~pyasn1.type.tagmap.TagMap` object by
combining tags from *TagMap* objects of children types and
associating them with their immediate child type.
Example
-------
.. code-block:: python
OuterType ::= CHOICE {
innerType INTEGER
}
Calling *.tagMap* on *OuterType* will yield a map like this:
.. code-block:: python
Integer.tagSet -> Choice
"""
return self.__nonUniqueTagMap
@property
def tagMapUnique(self):
"""Return a *TagMap* object from unique tags and types recursively.
Return a :class:`~pyasn1.type.tagmap.TagMap` object by
combining tags from *TagMap* objects of children types and
associating them with their immediate child type.
Example
-------
.. code-block:: python
OuterType ::= CHOICE {
innerType INTEGER
}
Calling *.tagMapUnique* on *OuterType* will yield a map like this:
.. code-block:: python
Integer.tagSet -> Choice
Note
----
Duplicate *TagSet* objects found in the tree of children
types would cause error.
"""
return self.__uniqueTagMap
@property
def hasOptionalOrDefault(self):
return self.__hasOptionalOrDefault
@property
def hasOpenTypes(self):
return self.__hasOpenTypes
@property
def namedTypes(self):
return tuple(self.__namedTypes)
@property
def requiredComponents(self):
return self.__requiredComponents
PK ! % % tag.pynu 刐迭 #
# This file is part of pyasn1 software.
#
# Copyright (c) 2005-2020, Ilya Etingof
# License: https://pyasn1.readthedocs.io/en/latest/license.html
#
from pyasn1 import error
__all__ = ['tagClassUniversal', 'tagClassApplication', 'tagClassContext',
'tagClassPrivate', 'tagFormatSimple', 'tagFormatConstructed',
'tagCategoryImplicit', 'tagCategoryExplicit',
'tagCategoryUntagged', 'Tag', 'TagSet']
#: Identifier for ASN.1 class UNIVERSAL
tagClassUniversal = 0x00
#: Identifier for ASN.1 class APPLICATION
tagClassApplication = 0x40
#: Identifier for ASN.1 class context-specific
tagClassContext = 0x80
#: Identifier for ASN.1 class private
tagClassPrivate = 0xC0
#: Identifier for "simple" ASN.1 structure (e.g. scalar)
tagFormatSimple = 0x00
#: Identifier for "constructed" ASN.1 structure (e.g. may have inner components)
tagFormatConstructed = 0x20
tagCategoryImplicit = 0x01
tagCategoryExplicit = 0x02
tagCategoryUntagged = 0x04
class Tag(object):
"""Create ASN.1 tag
Represents ASN.1 tag that can be attached to a ASN.1 type to make
types distinguishable from each other.
*Tag* objects are immutable and duck-type Python :class:`tuple` objects
holding three integer components of a tag.
Parameters
----------
tagClass: :py:class:`int`
Tag *class* value
tagFormat: :py:class:`int`
Tag *format* value
tagId: :py:class:`int`
Tag ID value
"""
def __init__(self, tagClass, tagFormat, tagId):
if tagId < 0:
raise error.PyAsn1Error('Negative tag ID (%s) not allowed' % tagId)
self.__tagClass = tagClass
self.__tagFormat = tagFormat
self.__tagId = tagId
self.__tagClassId = tagClass, tagId
self.__hash = hash(self.__tagClassId)
def __repr__(self):
representation = '[%s:%s:%s]' % (
self.__tagClass, self.__tagFormat, self.__tagId)
return '<%s object, tag %s>' % (
self.__class__.__name__, representation)
def __eq__(self, other):
return self.__tagClassId == other
def __ne__(self, other):
return self.__tagClassId != other
def __lt__(self, other):
return self.__tagClassId < other
def __le__(self, other):
return self.__tagClassId <= other
def __gt__(self, other):
return self.__tagClassId > other
def __ge__(self, other):
return self.__tagClassId >= other
def __hash__(self):
return self.__hash
def __getitem__(self, idx):
if idx == 0:
return self.__tagClass
elif idx == 1:
return self.__tagFormat
elif idx == 2:
return self.__tagId
else:
raise IndexError
def __iter__(self):
yield self.__tagClass
yield self.__tagFormat
yield self.__tagId
def __and__(self, otherTag):
return self.__class__(self.__tagClass & otherTag.tagClass,
self.__tagFormat & otherTag.tagFormat,
self.__tagId & otherTag.tagId)
def __or__(self, otherTag):
return self.__class__(self.__tagClass | otherTag.tagClass,
self.__tagFormat | otherTag.tagFormat,
self.__tagId | otherTag.tagId)
@property
def tagClass(self):
"""ASN.1 tag class
Returns
-------
: :py:class:`int`
Tag class
"""
return self.__tagClass
@property
def tagFormat(self):
"""ASN.1 tag format
Returns
-------
: :py:class:`int`
Tag format
"""
return self.__tagFormat
@property
def tagId(self):
"""ASN.1 tag ID
Returns
-------
: :py:class:`int`
Tag ID
"""
return self.__tagId
class TagSet(object):
"""Create a collection of ASN.1 tags
Represents a combination of :class:`~pyasn1.type.tag.Tag` objects
that can be attached to a ASN.1 type to make types distinguishable
from each other.
*TagSet* objects are immutable and duck-type Python :class:`tuple` objects
holding arbitrary number of :class:`~pyasn1.type.tag.Tag` objects.
Parameters
----------
baseTag: :class:`~pyasn1.type.tag.Tag`
Base *Tag* object. This tag survives IMPLICIT tagging.
*superTags: :class:`~pyasn1.type.tag.Tag`
Additional *Tag* objects taking part in subtyping.
Examples
--------
.. code-block:: python
class OrderNumber(NumericString):
'''
ASN.1 specification
Order-number ::=
[APPLICATION 5] IMPLICIT NumericString
'''
tagSet = NumericString.tagSet.tagImplicitly(
Tag(tagClassApplication, tagFormatSimple, 5)
)
orderNumber = OrderNumber('1234')
"""
def __init__(self, baseTag=(), *superTags):
self.__baseTag = baseTag
self.__superTags = superTags
self.__superTagsClassId = tuple(
[(superTag.tagClass, superTag.tagId) for superTag in superTags]
)
self.__lenOfSuperTags = len(superTags)
self.__hash = hash(self.__superTagsClassId)
def __repr__(self):
representation = '-'.join(['%s:%s:%s' % (x.tagClass, x.tagFormat, x.tagId)
for x in self.__superTags])
if representation:
representation = 'tags ' + representation
else:
representation = 'untagged'
return '<%s object, %s>' % (self.__class__.__name__, representation)
def __add__(self, superTag):
return self.__class__(self.__baseTag, *self.__superTags + (superTag,))
def __radd__(self, superTag):
return self.__class__(self.__baseTag, *(superTag,) + self.__superTags)
def __getitem__(self, i):
if i.__class__ is slice:
return self.__class__(self.__baseTag, *self.__superTags[i])
else:
return self.__superTags[i]
def __eq__(self, other):
return self.__superTagsClassId == other
def __ne__(self, other):
return self.__superTagsClassId != other
def __lt__(self, other):
return self.__superTagsClassId < other
def __le__(self, other):
return self.__superTagsClassId <= other
def __gt__(self, other):
return self.__superTagsClassId > other
def __ge__(self, other):
return self.__superTagsClassId >= other
def __hash__(self):
return self.__hash
def __len__(self):
return self.__lenOfSuperTags
@property
def baseTag(self):
"""Return base ASN.1 tag
Returns
-------
: :class:`~pyasn1.type.tag.Tag`
Base tag of this *TagSet*
"""
return self.__baseTag
@property
def superTags(self):
"""Return ASN.1 tags
Returns
-------
: :py:class:`tuple`
Tuple of :class:`~pyasn1.type.tag.Tag` objects that this *TagSet* contains
"""
return self.__superTags
def tagExplicitly(self, superTag):
"""Return explicitly tagged *TagSet*
Create a new *TagSet* representing callee *TagSet* explicitly tagged
with passed tag(s). With explicit tagging mode, new tags are appended
to existing tag(s).
Parameters
----------
superTag: :class:`~pyasn1.type.tag.Tag`
*Tag* object to tag this *TagSet*
Returns
-------
: :class:`~pyasn1.type.tag.TagSet`
New *TagSet* object
"""
if superTag.tagClass == tagClassUniversal:
raise error.PyAsn1Error("Can't tag with UNIVERSAL class tag")
if superTag.tagFormat != tagFormatConstructed:
superTag = Tag(superTag.tagClass, tagFormatConstructed, superTag.tagId)
return self + superTag
def tagImplicitly(self, superTag):
"""Return implicitly tagged *TagSet*
Create a new *TagSet* representing callee *TagSet* implicitly tagged
with passed tag(s). With implicit tagging mode, new tag(s) replace the
last existing tag.
Parameters
----------
superTag: :class:`~pyasn1.type.tag.Tag`
*Tag* object to tag this *TagSet*
Returns
-------
: :class:`~pyasn1.type.tag.TagSet`
New *TagSet* object
"""
if self.__superTags:
superTag = Tag(superTag.tagClass, self.__superTags[-1].tagFormat, superTag.tagId)
return self[:-1] + superTag
def isSuperTagSetOf(self, tagSet):
"""Test type relationship against given *TagSet*
The callee is considered to be a supertype of given *TagSet*
tag-wise if all tags in *TagSet* are present in the callee and
they are in the same order.
Parameters
----------
tagSet: :class:`~pyasn1.type.tag.TagSet`
*TagSet* object to evaluate against the callee
Returns
-------
: :py:class:`bool`
:obj:`True` if callee is a supertype of *tagSet*
"""
if len(tagSet) < self.__lenOfSuperTags:
return False
return self.__superTags == tagSet[:self.__lenOfSuperTags]
# Backward compatibility
def getBaseTag(self):
return self.__baseTag
def initTagSet(tag):
return TagSet(tag, tag)
PK ! 4 6 phpunit.xmlnu 刐迭 PK ! h澭 q README.mdnu 刐迭 PK ! 蓾 phive.xmlnu 刐迭 PK ! $惢1 LICENSEnu 刐迭 PK ! 衟镻
tests/unit/IterableTypeTest.phpnu 刐迭 PK ! 3e tests/unit/SimpleTypeTest.phpnu 刐迭 PK ! Z[vAa a $ * tests/unit/GenericObjectTypeTest.phpnu 刐迭 PK ! 皴 3 tests/unit/NullTypeTest.phpnu 刐迭 PK ! '紳d d : tests/unit/TypeNameTest.phpnu 刐迭 PK ! 籽 BC tests/unit/TypeTest.phpnu 刐迭 PK !
)2' ' ZS tests/unit/CallableTypeTest.phpnu 刐迭 PK ! 浚, 衏 tests/unit/UnknownTypeTest.phpnu 刐迭 PK ! u挒綍 琲 tests/unit/VoidTypeTest.phpnu 刐迭 PK ! *琛摳 宲 tests/unit/ObjectTypeTest.phpnu 刐迭 PK ! 瓌Lu u 憖 tests/_fixture/ParentClass.phpnu 刐迭 PK ! 櫬N藠 ( T tests/_fixture/ClassWithInvokeMethod.phpnu 刐迭 PK ! 8\ \ 6 tests/_fixture/ChildClass.phpnu 刐迭 PK ! 誥!Z Z $ 邊 tests/_fixture/callback_function.phpnu 刐迭 PK ! + 崌 tests/_fixture/ClassWithCallbackMethods.phpnu 刐迭 PK ! 瓅饔K K 綁 tests/_fixture/Iterator.phpnu 刐迭 PK ! 謣ｄ S .travis.ymlnu 刐迭 PK ! o匵B d .php_cs.distnu 刐迭 PK ! 蝒伙c c
3 composer.jsonnu 刐迭 PK ! 1酳) 拥 .github/FUNDING.ymlnu 刐迭 PK ! W/40 0 * ChangeLog.mdnu 刐迭 PK ! 蜰> 柡 src/TypeName.phpnu 刐迭 PK ! )T[ [ 盍 src/VoidType.phpnu 刐迭 PK ! 彻璹Q Q 壞 src/IterableType.phpnu 刐迭 PK ! 9誳闧 [ src/NullType.phpnu 刐迭 PK ! 艠1咤 雇 src/ObjectType.phpnu 刐迭 PK ! 螉]練 嘤 src/CallableType.phpnu 刐迭 PK ! k5 惧 src/Type.phpnu 刐迭 PK ! 56媴w w " 蹴 src/exception/RuntimeException.phpnu 刐迭 PK ! Pm{? ? 撅 src/exception/Exception.phpnu 刐迭 PK ! H src/GenericObjectType.phpnu 刐迭 PK ! 猾E E k src/UnknownType.phpnu 刐迭 PK ! g 篦 src/SimpleType.phpnu 刐迭 PK ! 罨 psalm.xmlnu 刐迭 PK ! 鳘霉 [ build.xmlnu 刐迭 PK ! 拿e9
.gitattributesnu 刐迭 PK ! 婰馅
.gitignorenu 刐迭 PK ! 惀|x error.pynu 刐迭 PK ! 縚 錄U 沀
: constraint.pynu 刐迭 PK ! 窬舕 h tagmap.pynu 刐迭 PK ! 鮏繲- - t opentype.pynu 刐迭 PK ! 捧钮 " k __pycache__/useful.cpython-311.pycnu 刐迭 PK ! 'Κ& & b __pycache__/univ.cpython-311.pycnu 刐迭 PK ! =
柚鑡 鑡 赡 __pycache__/base.cpython-311.pycnu 刐迭 PK ! j,盼 $ 7 __pycache__/__init__.cpython-311.pycnu 刐迭 PK ! 雐gg ! 68 __pycache__/error.cpython-311.pycnu 刐迭 PK ! 2顥 $ : __pycache__/opentype.cpython-311.pycnu 刐迭 PK ! 茊凭|4 |4 貸 __pycache__/tag.cpython-311.pycnu 刐迭 PK ! |莂c ac % __pycache__/namedtype.cpython-311.pycnu 刐迭 PK ! 4譏紆 紆 & Z __pycache__/constraint.cpython-311.pycnu 刐迭 PK ! 1%( %( lY __pycache__/char.cpython-311.pycnu 刐迭 PK ! xΙ! ! $ 醽 __pycache__/namedval.cpython-311.pycnu 刐迭 PK ! 4:I I " F __pycache__/tagmap.cpython-311.pycnu 刐迭 PK ! 馼軟# # 岽 namedval.pynu 刐迭 PK ! 珥"V "V ? base.pynu 刐迭 PK ! c縳┺$ $ char.pynu 刐迭 PK ! 鹡{c湭 湭 瑿 univ.pynu 刐迭 PK ! 鎴波 useful.pynu 刐迭 PK ! D@匯; ; ] __init__.pynu 刐迭 PK ! f3? 3? namedtype.pynu 刐迭 PK ! % % BC tag.pynu 刐迭 PK A A 慼