The ASN1C code generation tool translates an Abstract Syntax Notation 1 (ASN.1) or XML Schema Definitions (XSD) source file into computer language source files that allow typed data to be encoded/decoded. This release of ASN1C includes options to generate code in the following languages: C, C++, C#, Java, or Python. This manual discusses the Python code generation capabilities. The following manuals discuss the other language code generation capabilities:
ASN1C C/C++ Compiler User's Manual : C/C++ code generation
ASN1C C# Compiler User's Manual : C# code generation
ASN1C Java Compiler User's Manual : Java code generation
Each ASN.1 module that is encountered in an ASN.1 schema source file results in the generation of an equivalent Python source file with the same name as the module with hyphens replaced with underscores and with extension '.py'.
There is also a set of classes that form the run-time component of the Python package. These classes provide the primitive component building blocks that are assembled by the compiler to encode/decode complex structures. They also provide support for managing message buffers that hold the encoded message components.
This release of the ASN1C Compiler for Python works with the version of ASN.1 specified in ITU-T international standards X.680 through X.683. It generates code for encoding/decoding data in accordance with the following encoding rules:
Basic Encoding Rules (BER) and Distinguished Encoding Rules (DER) as published in the ITU-T X.690 and ISO/IEC 8825-1 standards.
JSON Encoding Rules (JER) as published in the ITU-T X.697 and ISO/IEC 8825-8:2018 standards.
ASN1C for Python is capable of parsing all ASN.1 syntax as defined in the standards. It is capable of parsing advanced syntax including Information Object Specifications as defined in the ITU-T X.681 standard as well as Parameterized Types as defined in ITU-T X.683.