REDROOM

Navigation

Breadcrumbs

/ / opt / alt / python37 / lib / python3.7 / site-packages / asn1crypto

Create

Create File | Create Folder | Upload Files | Run Command

Edit File Size: 8.93 KB

//opt/alt/python37/lib/python3.7/site-packages/asn1crypto/parser.py

Text Base64

# coding: utf-8

"""
Functions for parsing and dumping using the ASN.1 DER encoding. Exports the
following items:

- emit()
 - parse()
 - peek()

Other type classes are defined that help compose the types listed above.
"""

from __future__ import unicode_literals, division, absolute_import, print_function

import sys

from ._types import byte_cls, chr_cls, type_name
from .util import int_from_bytes, int_to_bytes

_PY2 = sys.version_info <= (3,)
_INSUFFICIENT_DATA_MESSAGE = 'Insufficient data - %s bytes requested but only %s available'

def emit(class_, method, tag, contents):
    """
    Constructs a byte string of an ASN.1 DER-encoded value

This is typically not useful. Instead, use one of the standard classes from
    asn1crypto.core, or construct a new class with specific fields, and call the
    .dump() method.

:param class_:
        An integer ASN.1 class value: 0 (universal), 1 (application),
        2 (context), 3 (private)

:param method:
        An integer ASN.1 method value: 0 (primitive), 1 (constructed)

:param tag:
        An integer ASN.1 tag value

:param contents:
        A byte string of the encoded byte contents

:return:
        A byte string of the ASN.1 DER value (header and contents)
    """

if not isinstance(class_, int):
        raise TypeError('class_ must be an integer, not %s' % type_name(class_))

if class_ < 0 or class_ > 3:
        raise ValueError('class_ must be one of 0, 1, 2 or 3, not %s' % class_)

if not isinstance(method, int):
        raise TypeError('method must be an integer, not %s' % type_name(method))

if method < 0 or method > 1:
        raise ValueError('method must be 0 or 1, not %s' % method)

if not isinstance(tag, int):
        raise TypeError('tag must be an integer, not %s' % type_name(tag))

if tag < 0:
        raise ValueError('tag must be greater than zero, not %s' % tag)

if not isinstance(contents, byte_cls):
        raise TypeError('contents must be a byte string, not %s' % type_name(contents))

return _dump_header(class_, method, tag, contents) + contents

def parse(contents, strict=False):
    """
    Parses a byte string of ASN.1 BER/DER-encoded data.

This is typically not useful. Instead, use one of the standard classes from
    asn1crypto.core, or construct a new class with specific fields, and call the
    .load() class method.

:param contents:
        A byte string of BER/DER-encoded data

:param strict:
        A boolean indicating if trailing data should be forbidden - if so, a
        ValueError will be raised when trailing data exists

:raises:
        ValueError - when the contents do not contain an ASN.1 header or are truncated in some way
        TypeError - when contents is not a byte string

:return:
        A 6-element tuple:
         - 0: integer class (0 to 3)
         - 1: integer method
         - 2: integer tag
         - 3: byte string header
         - 4: byte string content
         - 5: byte string trailer
    """

if not isinstance(contents, byte_cls):
        raise TypeError('contents must be a byte string, not %s' % type_name(contents))

contents_len = len(contents)
    info, consumed = _parse(contents, contents_len)
    if strict and consumed != contents_len:
        raise ValueError('Extra data - %d bytes of trailing data were provided' % (contents_len - consumed))
    return info

def peek(contents):
    """
    Parses a byte string of ASN.1 BER/DER-encoded data to find the length

This is typically used to look into an encoded value to see how long the
    next chunk of ASN.1-encoded data is. Primarily it is useful when a
    value is a concatenation of multiple values.

:param contents:
        A byte string of BER/DER-encoded data

:raises:
        ValueError - when the contents do not contain an ASN.1 header or are truncated in some way
        TypeError - when contents is not a byte string

:return:
        An integer with the number of bytes occupied by the ASN.1 value
    """

if not isinstance(contents, byte_cls):
        raise TypeError('contents must be a byte string, not %s' % type_name(contents))

info, consumed = _parse(contents, len(contents))
    return consumed

def _parse(encoded_data, data_len, pointer=0, lengths_only=False):
    """
    Parses a byte string into component parts

:param encoded_data:
        A byte string that contains BER-encoded data

:param data_len:
        The integer length of the encoded data

:param pointer:
        The index in the byte string to parse from

:param lengths_only:
        A boolean to cause the call to return a 2-element tuple of the integer
        number of bytes in the header and the integer number of bytes in the
        contents. Internal use only.

:return:
        A 2-element tuple:
         - 0: A tuple of (class_, method, tag, header, content, trailer)
         - 1: An integer indicating how many bytes were consumed
    """

if data_len < pointer + 2:
        raise ValueError(_INSUFFICIENT_DATA_MESSAGE % (2, data_len - pointer))

start = pointer
    first_octet = ord(encoded_data[pointer]) if _PY2 else encoded_data[pointer]
    pointer += 1

tag = first_octet & 31
    # Base 128 length using 8th bit as continuation indicator
    if tag == 31:
        tag = 0
        while True:
            num = ord(encoded_data[pointer]) if _PY2 else encoded_data[pointer]
            pointer += 1
            tag *= 128
            tag += num & 127
            if num >> 7 == 0:
                break

length_octet = ord(encoded_data[pointer]) if _PY2 else encoded_data[pointer]
    pointer += 1

if length_octet >> 7 == 0:
        if lengths_only:
            return (pointer, pointer + (length_octet & 127))
        contents_end = pointer + (length_octet & 127)

else:
        length_octets = length_octet & 127
        if length_octets:
            pointer += length_octets
            contents_end = pointer + int_from_bytes(encoded_data[pointer - length_octets:pointer], signed=False)
            if lengths_only:
                return (pointer, contents_end)

else:
            # To properly parse indefinite length values, we need to scan forward
            # parsing headers until we find a value with a length of zero. If we
            # just scanned looking for \x00\x00, nested indefinite length values
            # would not work.
            contents_end = pointer
            # Unfortunately we need to understand the contents of the data to
            # properly scan forward, which bleeds some representation info into
            # the parser. This condition handles the unused bits byte in
            # constructed bit strings.
            if tag == 3:
                contents_end += 1
            while contents_end < data_len:
                sub_header_end, contents_end = _parse(encoded_data, data_len, contents_end, lengths_only=True)
                if contents_end == sub_header_end and encoded_data[contents_end - 2:contents_end] == b'\x00\x00':
                    break
            if lengths_only:
                return (pointer, contents_end)
            if contents_end > data_len:
                raise ValueError(_INSUFFICIENT_DATA_MESSAGE % (contents_end, data_len))
            return (
                (
                    first_octet >> 6,
                    (first_octet >> 5) & 1,
                    tag,
                    encoded_data[start:pointer],
                    encoded_data[pointer:contents_end - 2],
                    b'\x00\x00'
                ),
                contents_end
            )

if contents_end > data_len:
        raise ValueError(_INSUFFICIENT_DATA_MESSAGE % (contents_end, data_len))
    return (
        (
            first_octet >> 6,
            (first_octet >> 5) & 1,
            tag,
            encoded_data[start:pointer],
            encoded_data[pointer:contents_end],
            b''
        ),
        contents_end
    )

def _dump_header(class_, method, tag, contents):
    """
    Constructs the header bytes for an ASN.1 object

:param class_:
        An integer ASN.1 class value: 0 (universal), 1 (application),
        2 (context), 3 (private)

:param method:
        An integer ASN.1 method value: 0 (primitive), 1 (constructed)

:param tag:
        An integer ASN.1 tag value

:param contents:
        A byte string of the encoded byte contents

:return:
        A byte string of the ASN.1 DER header
    """

header = b''

id_num = 0
    id_num |= class_ << 6
    id_num |= method << 5

if tag >= 31:
        header += chr_cls(id_num | 31)
        while tag > 0:
            continuation_bit = 0x80 if tag > 0x7F else 0
            header += chr_cls(continuation_bit | (tag & 0x7F))
            tag = tag >> 7
    else:
        header += chr_cls(id_num | tag)

length = len(contents)
    if length <= 127:
        header += chr_cls(length)
    else:
        length_bytes = int_to_bytes(length)
        header += chr_cls(0x80 | len(length_bytes))
        header += length_bytes

return header

Exit & Reset Text mode: syntax highlighting auto-detects file type.

Directory Contents

Dirs: 2 × Files: 25

Sort:

Enable drag-to-move

Name	Size	Perms	Modified	Actions
_perf DIR	-	drwxr-xr-x	2021-10-11 07:55:40	Edit Download recursive recursive
__pycache__ DIR	-	drwxr-xr-x	2021-10-11 07:55:40	Edit Download recursive recursive
algos.py	32.73 KB	lrw-r--r--	2017-01-23 16:50:58	Edit Download recursive recursive
cms.py	24.96 KB	lrw-r--r--	2017-02-10 10:06:05	Edit Download recursive recursive
core.py	146.88 KB	lrw-r--r--	2017-03-11 11:28:29	Edit Download recursive recursive
crl.py	15.84 KB	lrw-r--r--	2015-10-24 20:52:24	Edit Download recursive recursive
csr.py	2.11 KB	lrw-r--r--	2015-11-05 21:06:04	Edit Download recursive recursive
keys.py	34.23 KB	lrw-r--r--	2016-08-30 15:31:11	Edit Download recursive recursive
ocsp.py	17.58 KB	lrw-r--r--	2015-10-30 02:55:30	Edit Download recursive recursive
parser.py	8.93 KB	lrw-r--r--	2017-03-02 15:40:47	Edit Download recursive recursive
pdf.py	2.25 KB	lrw-r--r--	2016-07-11 01:34:11	Edit Download recursive recursive
pem.py	5.98 KB	lrw-r--r--	2015-10-08 13:43:00	Edit Download recursive recursive
pkcs12.py	4.53 KB	lrw-r--r--	2017-02-19 21:13:06	Edit Download recursive recursive
tsp.py	7.88 KB	lrw-r--r--	2016-08-27 19:58:53	Edit Download recursive recursive
util.py	17.62 KB	lrw-r--r--	2017-02-01 12:20:37	Edit Download recursive recursive
version.py	154 B	lrw-r--r--	2017-03-10 19:24:03	Edit Download recursive recursive
x509.py	81.32 KB	lrw-r--r--	2017-03-03 11:35:47	Edit Download recursive recursive
_elliptic_curve.py	9.19 KB	lrw-r--r--	2016-06-16 09:12:23	Edit Download recursive recursive
_errors.py	967 B	lrw-r--r--	2015-10-08 13:38:44	Edit Download recursive recursive
_ffi.py	738 B	lrw-r--r--	2016-07-15 01:53:18	Edit Download recursive recursive
_inet.py	4.72 KB	lrw-r--r--	2016-06-15 11:14:32	Edit Download recursive recursive
_int.py	4.51 KB	lrw-r--r--	2017-01-23 16:49:03	Edit Download recursive recursive
_iri.py	8.43 KB	lrw-r--r--	2017-03-03 11:10:52	Edit Download recursive recursive
_ordereddict.py	4.43 KB	lrw-r--r--	2015-10-08 13:39:26	Edit Download recursive recursive
_teletex_codec.py	4.93 KB	lrw-r--r--	2015-10-08 13:39:30	Edit Download recursive recursive
_types.py	939 B	lrw-r--r--	2017-02-01 12:20:37	Edit Download recursive recursive
__init__.py	209 B	lrw-r--r--	2017-01-24 14:23:55	Edit Download recursive recursive