1============== 2Python libnacl 3============== 4 5This library is used to gain direct access to the functions exposed by 6Daniel J. Bernstein's nacl library via libsodium. It has 7been constructed to maintain extensive documentation on how to use nacl 8as well as being completely portable. The file in libnacl/__init__.py 9can be pulled out and placed directly in any project to give a single file 10binding to all of nacl. 11 12Higher Level Classes 13==================== 14 15The libnacl code also ships with many high level classes which make nacl 16cryptography easy and safe, for documentation please see: 17http://libnacl.readthedocs.org/ 18 19Why libnacl 20=========== 21 22There are a number of libraries out there binding to libsodium, so why make 23libnacl? 24 251. libnacl does not have any non-python hard deps outside of libsodium 262. libnacl does not need to be compiled 273. libnacl is easy to package and very portable 284. Inclusion of high level pythonic encryption classes 295. Ability to have a single embeddable and transferable bindings file 30 that can be added directly to python applications without needing 31 to dep libnacl 32 33This makes libnacl very portable, very easy to use and easy to distribute. 34 35Install 36======= 37 38The libnacl code is easiy installed via a setup.py from the source or via pip. 39 40From Source: 41 42.. code-block:: bash 43 44 tar xvf libnacl-1.5.2.tar.gz 45 cd libnacl-1.5.2 46 python setup.py install 47 48Via Pip: 49 50.. code-block:: bash 51 52 pip install libnacl 53 54Remember that libnacl can be installed for python 2 and 3. 55 56Linux distributions 57------------------- 58 59Libnacl is shiped with many linux distributions, check your distribution 60package manager for the package ``python-libnacl``, ``python2-libnacl`` 61and/or ``python3-libnacl``. 62