https://github.com/saltstack/libnacl

Python ctypes wrapper for libsodium
https://github.com/saltstack/libnacl

Last synced: about 1 month ago
JSON representation

Python ctypes wrapper for libsodium

• Host: GitHub
• URL: https://github.com/saltstack/libnacl
• Owner: saltstack
• License: apache-2.0
• Created: 2014-05-27T22:39:13.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2024-03-14T13:50:58.000Z (8 months ago)
• Last Synced: 2024-09-30T11:17:27.439Z (about 1 month ago)
• Language: Python
• Size: 290 KB
• Stars: 81
• Watchers: 16
• Forks: 62
• Open Issues: 4
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
==============

Python libnacl

==============

This library is used to gain direct access to the functions exposed by

Daniel J. Bernstein's nacl library via libsodium. It has

been constructed to maintain extensive documentation on how to use nacl

as well as being completely portable. The file in libnacl/__init__.py

can be pulled out and placed directly in any project to give a single file

binding to all of nacl.

Higher Level Classes

====================

The libnacl code also ships with many high level classes which make nacl

cryptography easy and safe, for documentation please see:

http://libnacl.readthedocs.org/

Why libnacl

===========

There are a number of libraries out there binding to libsodium, so why make

libnacl?

1. libnacl does not have any non-python hard deps outside of libsodium

2. libnacl does not need to be compiled

3. libnacl is easy to package and very portable

4. Inclusion of high level pythonic encryption classes

5. Ability to have a single embeddable and transferable bindings file

   that can be added directly to python applications without needing

   to dep libnacl

This makes libnacl very portable, very easy to use and easy to distribute.

Install

=======

The libnacl code is easiy installed via a setup.py from the source or via pip.

From Source:

.. code-block:: bash

    tar xvf libnacl-1.5.2.tar.gz

    cd libnacl-1.5.2

    python setup.py install

Via Pip:

.. code-block:: bash

    pip install libnacl

Remember that libnacl can be installed for python 2 and 3.

Linux distributions

-------------------

Libnacl is shiped with many linux distributions, check your distribution

package manager for the package ``python-libnacl``, ``python2-libnacl``

and/or ``python3-libnacl``.