summaryrefslogtreecommitdiff
path: root/doc/install.rst
blob: eb9c266b32d80c26eea36ecc234ae2e85223b431 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
Install
=======

Preferable way is to :ref:`download <download>` tarball with the
signature from `official website <http://pyderasn.cypherpunks.ru/>`__::

    $ [fetch|wget] http://pyderasn.cypherpunks.ru/pyderasn-7.6.tar.xz
    $ [fetch|wget] http://pyderasn.cypherpunks.ru/pyderasn-7.6.tar.xz.sig
    $ gpg --verify pyderasn-7.6.tar.xz.sig pyderasn-7.6.tar.xz
    $ xz --decompress --stdout pyderasn-7.6.tar.xz | tar xf -
    $ cd pyderasn-7.6
    $ python setup.py install
    # or copy pyderasn.py (+six.py, possibly termcolor.py) to your PYTHONPATH

PyDERASN depends on `six <https://pypi.org/project/six/>`__ package
for keeping compatibility with Py27/Py35. It is included in the tarball.
You can also find it mirrored on :ref:`download <download>` page.
``termcolor`` is an optional dependency used for output colourizing.
``urwid`` is an optional dependency used for :ref:`interactive browser <browser>`.

You could use pip (**no** OpenPGP authentication is performed!) with PyPI::

    $ cat > requirements.txt <<EOF
    pyderasn==7.6 --hash=sha256:TO-BE-FILLED
    six==1.14.0 --hash=sha256:236bdbdce46e6e6a3d61a337c0f8b763ca1e8717c03b369e87a7ec7ce1319c0a
    EOF
    $ pip install --requirement requirements.txt

You have to verify downloaded tarballs integrity and authenticity to be
sure that you retrieved trusted and untampered software. `GNU Privacy
Guard <https://www.gnupg.org/>`__ is used for that purpose.

For the very first time it is necessary to get signing public key and
import it. It is provided below, but you should check alternative
resources.

::

    pub   rsa2048/0x04A933D1BA20327A 2017-09-20
          2ED6 C846 3051 02DF 5B4E  0383 04A9 33D1 BA20 327A
    uid   PyDERASN releases <pyderasn@cypherpunks.ru>

    $ gpg --auto-key-locate dane --locate-keys pyderasn at cypherpunks dot ru
    $ gpg --auto-key-locate wkd --locate-keys pyderasn at cypherpunks dot ru

.. literalinclude:: ../PUBKEY.asc