Metadata-Version: 2.1
Name: django-nacl-fields
Version: 3.0.0
Summary: This is a collection of Django Model Field classes that are encrypted using PyNaCl.
Home-page: https://github.com/poolvos/django-nacl-fields
Author: Poolvos B.V.
Author-email: info@poolvos.nl
License: Apache License
Description: ============================
        Django NaCl Encrypted Fields
        ============================
        
        |Build Status| |Docs Status|
        
        .. |Build Status| image:: https://img.shields.io/travis/poolvos/django-nacl-fields.svg?style=for-the-badge
           :target: https://travis-ci.org/poolvos/django-nacl-fields
           :alt: Build Status
        
        .. |Docs Status| image:: https://img.shields.io/readthedocs/django-nacl-fields/latest.svg?style=for-the-badge
           :target: https://django-nacl-fields.readthedocs.io/en/latest/
           :alt: Read the Docs (version)
        
        This is a collection of Django Model Field classes that are encrypted using PyNaCl. This package is largely based on `django-encrypted-fields <https://github.com/defrex/django-encrypted-fields>`_, which makes use of the outdated Keyczar library to encrypt fields. Besides that, it is inspired by `django-fernet-field <https://github.com/orcasgit/django-fernet-fields>`_.
        
        
        About PyNaCl
        ------------
        
        `PyNaCl <https://github.com/pyca/pynacl>`_ is a Python binding to `libsodium <https://github.com/jedisct1/libsodium>`_, which is a fork of the `Networking and Cryptography library <https://nacl.cr.yp.to>`_. These libraries have a stated goal of improving usability, security and speed.
        
        
        Getting Started
        ----------------
        
        .. code:: shell
        
        	~ pip install django-nacl-fields
        
        
        Create a key to be used for encryption:
        
        .. code:: shell
        
        	~ python manage.py createkey
        	# put the following line in your settings.py:
        	NACL_FIELDS_KEY = b'p1Et2Rb@;^BYdo`ZRFi!Hc-MXu(^|bVqA-FGqffM'
        
        In your ``settings.py``:
        
        .. code:: python
        
        	NACL_FIELDS_KEY = b'p1Et2Rb@;^BYdo`ZRFi!Hc-MXu(^|bVqA-FGqffM'
        
        
        Then, in your ``models.py``:
        
        .. code:: python
        
        	from django.db import models
        	from nacl_encrypted_fields import NaClTextField
        
        
        	class MyModel(models.Model):
        		text_field = NaClTextField()
        
        
        Use the model as you would normally and the data will be stored encrypted in the database.
        
        **Note:** Encrypted data cannot be used to query or sort. In SQL, these will all look like text fields with random text.
        
        It is also possible to append the fields key to your settings file automatically upon creation, by using the ``-f`` flag:
        
        .. code:: shell
        
        	~ python manage.py createkey -f settings.py
        
        Where ``settings.py`` is the path to your settings file.
        
        Available Fields
        ----------------
        
        Currently build-in and unit-tested fields.
        
        -  ``NaClCharField``
        -  ``NaClTextField``
        -  ``NaClDateTimeField``
        -  ``NaClIntegerField``
        -  ``NaClFloatField``
        -  ``NaClEmailField``
        -  ``NaClBooleanField``
        
        
        Encrypt Your Own Fields
        -----------------------
        
        Making new fields can be done by using the provided ``NaClFieldMixin``:
        
        .. code:: python
        
        	from django.db import models
        	from nacl_encrypted_fields import NaClFieldMixin
        
        	class NaClIPAddressField(NaClFieldMixin, models.IPAddressField):
        		pass
        
        
        Please report any issues you encounter when trying this.
        
        
        References
        ----------
        
        *  https://github.com/defrex/django-encrypted-fields
        *  https://github.com/orcasgit/django-fernet-fields
        
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.11
Classifier: Framework :: Django :: 2.1
Classifier: Framework :: Django :: 2.2
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
Provides-Extra: testing
