# Buildsheet autogenerated by ravenadm tool -- Do not edit.

NAMEBASE=		python-asn1
VERSION=		3.1.0
KEYWORDS=		python
VARIANTS=		v13 v14
SDESC[v13]=		Simple ASN.1 encoder and decoder (3.13)
SDESC[v14]=		Simple ASN.1 encoder and decoder (3.14)
HOMEPAGE=		https://github.com/andrivet/python-asn1
CONTACT=		Python_Automaton[python@ironwolf.systems]

DOWNLOAD_GROUPS=	main
SITES[main]=		PYPIWHL/be/65/7bbe7d9cc4af285e36ce571285c779b733edf8b57d0835276471b08adba1
DISTFILE[1]=		asn1-3.1.0-py2.py3-none-any.whl:main
DIST_SUBDIR=		python-src
DF_INDEX=		1
SPKGS[v13]=		single
SPKGS[v14]=		single

OPTIONS_AVAILABLE=	PY313 PY314
OPTIONS_STANDARD=	none
VOPTS[v13]=		PY313=ON PY314=OFF
VOPTS[v14]=		PY313=OFF PY314=ON

DISTNAME=		asn1-3.1.0.dist-info

GENERATED=		yes

[PY313].USES_ON=			python:v13,wheel

[PY314].USES_ON=			python:v14,wheel

[FILE:2023:descriptions/desc.single]


========
Overview
========

Python-ASN1 is a simple ASN.1 encoder and decoder for Python 2.7 and 3.5+.

Features
========

- Support BER (parser) and DER (parser and generator) encoding (including
indefinite lengths)
- 100% python, compatible with version 2.7, 3.5 and higher
- Can be integrated by just including a file into your project
- Support most common ASN.1 types including REAL (encoding and decoding).

Dependencies
==============

Python-ASN1 relies on `Python-Future <https://python-future.org>`_ for
Python 2 and 3 compatibility. To install Python-Future:

.. code-block:: sh

  pip install future

Python-ASN1 relies on [type hints]. For Python 2.7, a backport of the
standard library typing module has to be installed:

.. code-block:: sh

  pip install typing

This is not necessary for Python 3.5 and higher since it is part of the
standard library.

How to install Python-asn1
==========================

Install from PyPi with the following:

.. code-block:: sh

  pip install asn1

or download the repository from [GitHub] and install with the following:

.. code-block:: sh

  python setup.py install

You can also simply include ``asn1.py`` into your project.

How to use Python-asn1
======================

.. note:: You can find more detailed documentation on the `Usage`_ page.

.. _Usage: usage.rst

Encoding
--------

If you want to encode data and retrieve its DER-encoded representation, use
code such as:

.. code-block:: python

  import asn1

  encoder = asn1.Encoder()
  encoder.start()
  encoder.write('1.2.3', asn1.Numbers.ObjectIdentifier)
  encoded_bytes = encoder.output()

Decoding
--------

If you want to decode ASN.1 from DER or BER encoded bytes, use code such
as:

.. code-block:: python

  import asn1

  decoder = asn1.Decoder()
  decoder.start(encoded_bytes)
  tag, value = decoder.read()

Documentation
=============

The complete documentation is available on Read The Docs:

`python-asn1.readthedocs.io
<https://python-asn1.readthedocs.io/en/latest/>`_

License
=======


[FILE:121:distinfo]
a3abe59ac84a6121771f7a60d6969683bc8023d2dbfc07b39449f80b0653fda8        17119 python-src/asn1-3.1.0-py2.py3-none-any.whl