1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
|
.. _install:
Installation guide
==================
Before installing ``django-registration``, you'll need to have a copy
of `Django <https://www.djangoproject.com>`_ already installed. For
information on obtaining and installing Django, consult the `Django
download page <https://www.djangoproject.com/download/>`_, which
offers convenient packaged downloads and installation instructions.
The |version| release of ``django-registration`` supports Django 1.7,
1.8 and 1.9, on any Python version supported by those versions of
Django:
* Django 1.7 supports Python 2.7, 3.2, 3.3 and 3.4.
* Django 1.8 suports Python 2.7, 3.2, 3.3, 3.4 and 3.5.
* Django 1.9 supports Python 2.7, 3.4 and 3.5.
.. important:: **Python 3.2**
Although Django 1.7 and 1.8 support Python 3.2, and
``django-registration`` |version| supports it, many Python
libraries supporting Python 3 impose a minimum requirement of
Python 3.3 (due to conveniences added in Python 3.3 which make
supporting Python 2 and 3 in the same codebase much simpler).
As a result, use of Python 3.2 is discouraged; Django 1.9 has
already dropped support for it, and a future release of
``django-registration`` will likely drop Python 3.2 support as
well.
Normal installation
-------------------
The preferred method of installing ``django-registration`` is via
``pip``, the standard Python package-installation tool. If you don't
have ``pip``, instructions are available for `how to obtain and
install it <https://pip.pypa.io/en/latest/installing.html>`_. If
you're using Python 2.7.9 or later (for Python 2) or Python 3.4 or
later (for Python 3), ``pip`` came bundled with your installation of
Python.
Once you have ``pip``, simply type::
pip install django-registration
Manual installation
-------------------
It's also possible to install ``django-registration`` manually. To do
so, obtain the latest packaged version from `the listing on the Python
Package Index
<https://pypi.python.org/pypi/django-registration/>`_. Unpack the
``.tar.gz`` file, and run::
python setup.py install
Once you've installed ``django-registration``, you can verify
successful installation by opening a Python interpreter and typing
``import registration``.
If the installation was successful, you'll simply get a fresh Python
prompt. If you instead see an ``ImportError``, check the configuration
of your install tools and your Python import path to ensure
``django-registration`` installed into a location Python can import
from.
Installing from a source checkout
---------------------------------
The development repository for ``django-registration`` is at
<https://github.com/ubernostrum/django-registration>. Presuming you
have `git <http://git-scm.com/>`_ installed, you can obtain a copy of
the repository by typing::
git clone https://github.com/ubernostrum/django-registration.git
From there, you can use normal git commands to check out the specific
revision you want, and install it using ``python setup.py install``.
Next steps
----------
To get up and running quickly, checkout :ref:`the quick start guide
<quickstart>`. For full documentation, see :ref:`the documentation
index <index>`.
|
