doc/index.rst

   1 ================================================================
   2 PyDERASN -- strict and fast ASN.1 DER/CER/BER library for Python
   3 ================================================================
   4
   5 ..
   6
   7     I'm going to build my own ASN.1 library with slots and blobs!
   8     (C) PyDERASN's author
   9
  10 `ASN.1 <https://en.wikipedia.org/wiki/ASN.1>`__ (Abstract Syntax
  11 Notation One) is a standard for abstract data serialization. PyDERASN is
  12 yet another library for dealing with ASN.1 structures, decoding them in
  13 `BER/CER/DER <https://en.wikipedia.org/wiki/X.690>`__ formats and
  14 encoding to either DER (Distinguished Encoding Rules) or CER (Canonical
  15 Encoding Rules). Although ASN.1 is written more than 30 years ago by wise
  16 Ancients (taken from ``pyasn1``'s README), it is still often can be seen
  17 anywhere in our life.
  18
  19 PyDERASN is `free software <https://www.gnu.org/philosophy/free-sw.html>`__,
  20 licenced under `GNU LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>`__.
  21
  22 .. toctree::
  23    :maxdepth: 1
  24
  25    features
  26    performance
  27    limitations
  28    examples
  29    reference
  30    news
  31    install
  32    download
  33    thanks
  34    feedback
  35
  36 There are articles about its history and usage:
  37
  38 * `Как я написал ASN.1 библиотеку с slots and blobs <https://m.habr.com/ru/post/444272/>`__ (on russian)
  39 * `Как я добавил big-data поддержку <https://m.habr.com/ru/post/498014/>`__ (on russian)
  40
  41 .. figure:: pprinting.webp
  42    :alt: Pretty printing example output
  43
  44    An example of pretty printed X.509 certificate with automatically
  45    parsed DEFINED BY fields.
  46
  47 .. figure:: browser.webp
  48    :alt: ASN.1 browser example
  49
  50    An example of browser running.