Metadata-Version: 2.0
Name: django-registration-redux
Version: 1.6
Summary: An extensible user-registration application for Django
Home-page: https://github.com/macropin/django-registration
Author: Andrew Cutler
Author-email: macropin@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Web Environment
Classifier: Framework :: Django
Classifier: Framework :: Django :: 1.8
Classifier: Framework :: Django :: 1.9
Classifier: Framework :: Django :: 1.10
Classifier: Framework :: Django :: 1.11
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: BSD License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Utilities

.. -*-restructuredtext-*-

:Description: Django-registration provides user registration functionality for Django websites.
:maintainers: Macropin_, DiCato_, and Joshblum_
:contributors: `list of contributors <https://github.com/macropin/django-registration/graphs/contributors>`_

.. _Macropin: https://github.com/macropin
.. _DiCato: https://github.com/dicato
.. _Joshblum: https://github.com/joshblum


.. image:: https://travis-ci.org/macropin/django-registration.svg?branch=master
    :target: https://travis-ci.org/macropin/django-registration

.. image:: https://coveralls.io/repos/macropin/django-registration/badge.svg?branch=master
    :target: https://coveralls.io/r/macropin/django-registration/

.. image:: https://badge.fury.io/py/django-registration-redux.svg
    :target: https://pypi.python.org/pypi/django-registration-redux/

.. image:: https://readthedocs.org/projects/django-registration-redux/badge/?version=latest
    :target: http://django-registration-redux.readthedocs.org/en/latest/?badge=latest
    :alt: Documentation Status


If you have issues with the "django-registration-redux" package then please `raise them here`_.

This is a fairly simple user-registration application for Django,
designed to make allowing user signups as painless as possible. It
requires a functional installation of Django 1.8 or newer, but has no
other dependencies.

For instructions on how to use this application, and on
what it provides, see the file "quickstart.rst" in the "docs/"
directory. Full documentation is also `available online`_


Installation
------------

Install, upgrade and uninstall django-registration-redux with these commands::

    pip install django-registration-redux
    pip install --upgrade django-registration-redux
    pip uninstall django-registration-redux

To install it manually, run the following command inside this source directory::

    python setup.py install


Or if you'd prefer you can simply place the included ``registration``
directory somewhere on your Python path, or symlink to it from
somewhere on your Python path; this is useful if you're working from a
Git checkout.

Note that this application requires Python 2.7/3.4 or later, and a
functional installation of Django 1.8 or newer.

Getting started with development
--------------------------------

To get started with development, first install the required packages::

    make installdeps

For convenience a ``Makefile`` is included which wraps the Python `invoke
<http://www.pyinvoke.org/>`_ library. Once you work on a patch, you can test
the functionality by running::

    make test

Or equivalently::

    invoke test

Command line arguments can be passed to the ``invoke`` script through the
``Makefile`` via the ``ARGS`` parameter. For example::

    make build ARGS=--docs

Or equivalently::

    invoke build --docs

Alternatives
------------

`djangopackages.com <https://www.djangopackages.com/grids/g/registration/>`_
has a comprehensive comparison of Django packages used for user registration
and authentication.

For example, `django-allauth <http://www.intenct.nl/projects/django-allauth/>`_
is an alternative to django-registration-redux that provides user registration
in addition to social authentication and email address management.

License
-------

Django-registration-redux is licensed under `BSD License`.



.. _`available online`: https://django-registration-redux.readthedocs.org/
.. _`raise them here`: https://github.com/macropin/django-registration/issues


