Skip to content

Commit

Permalink
Updated install docs to reflect Python 3 status.
Browse files Browse the repository at this point in the history
Closes #17452.
  • Loading branch information
aaugustin committed Sep 7, 2012
1 parent b865009 commit 7435cc0
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 32 deletions.
40 changes: 17 additions & 23 deletions docs/faq/install.txt
Original file line number Diff line number Diff line change
Expand Up @@ -16,8 +16,9 @@ How do I get started?
What are Django's prerequisites?
--------------------------------

Django requires Python_, specifically Python 2.6.5 - 2.7.x. No other Python
libraries are required for basic Django usage.
Django requires Python, specifically Python 2.6.5 - 2.7.x. No other Python
libraries are required for basic Django usage. Django 1.5 also has
experimental support for Python 3.2 and above.

For a development environment -- if you just want to experiment with Django --
you don't need to have a separate Web server installed; Django comes with its
Expand Down Expand Up @@ -50,15 +51,12 @@ aren't available under older versions of Python.
Third-party applications for use with Django are, of course, free to set their
own version requirements.

Over the next year or two Django will begin dropping support for older Python
versions as part of a migration which will end with Django running on Python 3
(see below for details).

All else being equal, we recommend that you use the latest 2.x release
(currently Python 2.7). This will let you take advantage of the numerous
improvements and optimizations to the Python language since version 2.6, and
will help ease the process of dropping support for older Python versions on
the road to Python 3.
improvements and optimizations to the Python language since version 2.6.

Generally speaking, we don't recommend running Django on Python 3 yet; see
below for more.

What Python version can I use with Django?
------------------------------------------
Expand All @@ -71,25 +69,21 @@ Django version Python versions
1.2 2.4, 2.5, 2.6, 2.7
1.3 2.4, 2.5, 2.6, 2.7
**1.4** **2.5, 2.6, 2.7**
*1.5 (future)* *2.6, 2.7, 3.x (experimental)*
*1.5 (future)* *2.6, 2.7* and *3.2, 3.3 (experimental)*
============== ===============

Can I use Django with Python 3?
-------------------------------

Not at the moment. Python 3.0 introduced a number of
backwards-incompatible changes to the Python language, and although
these changes are generally a good thing for Python's future, it will
be a while before most Python software catches up and is able to run
on Python 3.0. For larger Python-based software like Django, the
transition is expected to take at least a year or two (since it
involves dropping support for older Python releases and so must be
done gradually).

In the meantime, Python 2.x releases will be supported and provided
with bug fixes and security updates by the Python development team, so
continuing to use a Python 2.x release during the transition should
not present any risk.
Django 1.5 introduces experimental support for Python 3.2 and 3.3. However, we
don't yet suggest that you use Django and Python 3 in production.

Python 3 support should be considered a "preview". It's offered to bootstrap
the transition of the Django ecosystem to Python 3, and to help you start
porting your apps for future Python 3 compatibility. But we're not yet
confidant enough to promise stability in production.

This comment has been minimized.

Copy link
@kmike

kmike Sep 7, 2012

confidant -> confident?


Our current plan is to make Django 1.6 suitable for general use with Python 3.

Will Django run under shared hosting (like TextDrive or Dreamhost)?
-------------------------------------------------------------------
Expand Down
8 changes: 3 additions & 5 deletions docs/intro/install.txt
Original file line number Diff line number Diff line change
Expand Up @@ -10,11 +10,9 @@ Install Python
--------------

Being a Python Web framework, Django requires Python. It works with any Python
version from 2.6.5 to 2.7 (due to backwards incompatibilities in Python 3.0,
Django does not currently work with Python 3.0; see :doc:`the Django FAQ
</faq/install>` for more information on supported Python versions and the 3.0
transition), these versions of Python include a lightweight database called
SQLite_ so you won't need to set up a database just yet.
version from 2.6.5 to 2.7. It also features experimental support for versions
3.2 and 3.3. All these versions of Python include a lightweight database
called SQLite_ so you won't need to set up a database just yet.

.. _sqlite: http://sqlite.org/

Expand Down
6 changes: 2 additions & 4 deletions docs/topics/install.txt
Original file line number Diff line number Diff line change
Expand Up @@ -9,10 +9,8 @@ Install Python

Being a Python Web framework, Django requires Python.

It works with any Python version from 2.6.5 to 2.7 (due to backwards
incompatibilities in Python 3.0, Django does not currently work with
Python 3.0; see :doc:`the Django FAQ </faq/install>` for more
information on supported Python versions and the 3.0 transition).
It works with any Python version from 2.6.5 to 2.7. It also features
experimental support for versions 3.2 and 3.3.

Get Python at http://www.python.org. If you're running Linux or Mac OS X, you
probably already have it installed.
Expand Down

0 comments on commit 7435cc0

Please sign in to comment.