doc/install.rst

   1 Install
   2 =======
   3
   4 Preferable way is to :ref:`download <download>` tarball with the
   5 signature from `official website <http://www.pyderasn.cypherpunks.ru/>`__::
   6
   7     $ [fetch|wget] http://www.pyderasn.cypherpunks.ru/pyderasn-8.2.tar.xz
   8     $ [fetch|wget] http://www.pyderasn.cypherpunks.ru/pyderasn-8.2.tar.xz.sig
   9     $ gpg --verify pyderasn-8.2.tar.xz.sig pyderasn-8.2.tar.xz
  10     $ xz --decompress --stdout pyderasn-8.2.tar.xz | tar xf -
  11     $ cd pyderasn-8.2
  12     $ python setup.py install
  13     # or copy pyderasn.py (+six.py, possibly termcolor.py) to your PYTHONPATH
  14
  15 PyDERASN depends on `six <https://pypi.org/project/six/>`__ package
  16 for keeping compatibility with Py27/Py35. It is included in the tarball.
  17 You can also find it mirrored on :ref:`download <download>` page.
  18 ``termcolor`` is an optional dependency used for output colourizing.
  19 ``urwid`` is an optional dependency used for :ref:`interactive browser <browser>`.
  20
  21 You could use pip (**no** OpenPGP authentication is performed!) with PyPI::
  22
  23     $ cat > requirements.txt <<EOF
  24     pyderasn==8.2 --hash=sha256:TO-BE-FILLED
  25     six==1.15.0 --hash=sha256:30639c035cdb23534cd4aa2dd52c3bf48f06e5f4a941509c8bafd8ce11080259
  26     EOF
  27     $ pip install --requirement requirements.txt
  28
  29 You have to verify downloaded tarballs integrity and authenticity to be
  30 sure that you retrieved trusted and untampered software. `GNU Privacy
  31 Guard <https://www.gnupg.org/>`__ is used for that purpose.
  32
  33 For the very first time it is necessary to get signing public key and
  34 import it. It is provided below, but you should check alternative
  35 resources.
  36
  37 ::
  38
  39     pub   rsa2048/0x04A933D1BA20327A 2017-09-20
  40           2ED6 C846 3051 02DF 5B4E  0383 04A9 33D1 BA20 327A
  41     uid   PyDERASN releases <pyderasn@cypherpunks.ru>
  42
  43     $ gpg --auto-key-locate dane --locate-keys pyderasn at cypherpunks dot ru
  44     $ gpg --auto-key-locate wkd --locate-keys pyderasn at cypherpunks dot ru
  45
  46 .. literalinclude:: ../PUBKEY.asc