Packaging additions
[pyderasn.git] / doc / install.rst
1 Install
2 =======
3
4 Preferable way is to :ref:`download <download>` tarball with the
5 signature from `official website <http://pyderasn.cypherpunks.ru/>`__::
6
7     % wget http://pyderasn.cypherpunks.ru/pyderasn-1.0.tar.xz
8     % wget http://pyderasn.cypherpunks.ru/pyderasn-1.0.tar.xz.sig
9     % gpg --verify pyderasn-1.0.tar.xz.sig pyderasn-1.0.tar.xz
10     % xz -d < pyderasn-1.0.tar.xz | tar xf -
11     % cd pyderasn-1.0
12     % python setup.py install
13
14 PyDERASN depends on `six <https://pypi.python.org/pypi/six>`__ package
15 for keeping compatibility with Py27/Py35. It is included in the tarball.
16 You can also find it mirrored on :ref:`download <download>` page.
17
18 You could use PIP (**no** authentication is performed!)::
19
20     % pip install pyderasn
21
22 You have to verify downloaded tarballs integrity and authenticity to be
23 sure that you retrieved trusted and untampered software. `GNU Privacy
24 Guard <https://www.gnupg.org/>`__ is used for that purpose.
25
26 For the very first time it is necessary to get signing public key and
27 import it. It is provided below, but you should check alternative
28 resources.
29
30 ::
31
32     pub   rsa2048/0x04A933D1BA20327A 2017-09-20
33           2ED6 C846 3051 02DF 5B4E  0383 04A9 33D1 BA20 327A
34     uid   PyDERASN releases <pyderasn@cypherpunks.ru>
35
36     % gpg --keyserver hkp://keys.gnupg.net/ --recv-keys 0x04A933D1BA20327A
37     % gpg --auto-key-locate dane --locate-keys pyderasn at cypherpunks dot ru
38     % gpg --auto-key-locate wkd --locate-keys pyderasn at cypherpunks dot ru
39     % gpg --auto-key-locate pka --locate-keys pyderasn at cypherpunks dot ru
40
41 .. literalinclude:: ../PUBKEY.asc