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 DER (Distinguished Encoding Rules). Although ASN.1 is
  15 written more than 30 years ago by wise Ancients (taken from ``pyasn1``'s
  16 README), it is still often can be seen anywhere in our life.
  17
  18 PyDERASN is `free software <https://www.gnu.org/philosophy/free-sw.html>`__,
  19 licenced under `GNU LGPLv3 <https://www.gnu.org/licenses/lgpl-3.0.html>`__.
  20
  21 .. toctree::
  22    :maxdepth: 1
  23
  24    features
  25    performance
  26    limitations
  27    examples
  28    reference
  29    news
  30    install
  31    download
  32    thanks
  33    feedback
  34
  35 There are articles about its history and usage:
  36
  37 * `Как я написал ASN.1 библиотеку с slots and blobs <https://m.habr.com/ru/post/444272/>`__ (on russian)
  38 * `Как я добавил big-data поддержку <https://m.habr.com/ru/post/498014/>`__ (on russian)
  39
  40 .. figure:: pprinting.png
  41    :alt: Pretty printing example output
  42
  43    An example of pretty printed X.509 certificate with automatically
  44    parsed DEFINED BY fields.
  45
  46 .. figure:: browser.png
  47    :alt: ASN.1 browser example
  48
  49    An example of browser running.