The latest version of Ubuntu, **comes with Python 2.7 out of the box**.
-You do not need to install or configure anything else to use Python. Having said that, I would strongly recommend that you install the tools and libraries described in the next section before you start building Python applications for real-world use. In particular, you should always install Distribute, as it makes it much easier for you to use other third-party Python libraries.
+You do not need to install or configure anything else to use Python. Having
+said that, I would strongly recommend that you install the tools and libraries
+described in the next section before you start building Python applications
+for real-world use. In particular, you should always install Distribute, as
+it makes it much easier for you to use other third-party Python libraries.
Distribute & Pip
----------------
-The most crucial third-party Python software of all is Distribute, which extends the packaging and installation facilities provided by the distutils in the standard library. Once you add Distribute to your Python system you can download and install any compliant Python software product with a single command. It also enables you to add this network installation capability to your own Python software with very little work.
+The most crucial third-party Python software of all is Distribute, which
+extends the packaging and installation facilities provided by the distutils
+in the standard library. Once you add Distribute to your Python system you can
+download and install any compliant Python software product with a single
+command. It also enables you to add this network installation capability to
+your own Python software with very little work.
-To obtain the latest version of Distribute for Linux, run the python script available here:
+To obtain the latest version of Distribute for Linux, run the python script
+available here:
http://python-distribute.org/distribute_setup.py
-The new``easy_install`` command you have available is considered by many to be deprecated, so we will install its replacement: **pip**. Pip allows for uninstallation of packages, and is actively maintained, unlike easy_install.
+The new``easy_install`` command you have available is considered by many to be
+deprecated, so we will install its replacement: **pip**. Pip allows for
+uninstallation of packages, and is actively maintained, unlike easy_install.
To install pip, simply open a command prompt and run::
Virtualenv
----------
-After Distribute & Pip, the next development tool that you should install is `virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
+After Distribute & Pip, the next development tool that you should install is
+`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
$ pip install virtualenv
-The virtualenv kit provides the ability to create virtual Python environments that do not interfere with either each other, or the main Python installation. If you install virtualenv before you begin coding then you can get into the habit of using it to create completely clean Python environments for each project. This is particularly important for Web development, where each framework and application will have many dependencies.
+The virtualenv kit provides the ability to create virtual Python environments
+that do not interfere with either each other, or the main Python installation.
+If you install virtualenv before you begin coding then you can get into the
+habit of using it to create completely clean Python environments for each
+project. This is particularly important for Web development, where each
+framework and application will have many dependencies.
-To set up a new Python environment, change the working directory to where ever you want to store the environment, and run the virtualenv utility in your project's directory::
+To set up a new Python environment, change the working directory to where ever
+you want to store the environment, and run the virtualenv utility in your
+project's directory::
$ virtualenv --distribute venv
-To use an environment, run ``source venv/bin/activate``. Your command prompt will change to show the active environment. Once you have finished working in the current virtual environment, run ``deactivate`` to restore your settings to normal.
+To use an environment, run ``source venv/bin/activate``. Your command prompt
+will change to show the active environment. Once you have finished working in
+the current virtual environment, run ``deactivate`` to restore your settings
+to normal.
-Each new environment automatically includes a copy of ``pip``, so that you can setup the third-party libraries and tools that you want to use in that environment. Put your own code within a subdirectory of the environment, however you wish. When you no longer need a particular environment, simply copy your code out of it, and then delete the main directory for the environment.
+Each new environment automatically includes a copy of ``pip``, so that you can
+setup the third-party libraries and tools that you want to use in that
+environment. Put your own code within a subdirectory of the environment,
+however you wish. When you no longer need a particular environment, simply
+copy your code out of it, and then delete the main directory for the environment.
--------------------------------
-This page is a remixed version of `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_, which is available under the same license.
+This page is a remixed version of `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_,
+which is available under the same license.
The latest version of Mac OS X, Lion, **comes with Python 2.7 out of the box**.
-You do not need to install or configure anything else to use Python. Having said that, I would strongly recommend that you install the tools and libraries described in the next section before you start building Python applications for real-world use. In particular, you should always install Distribute, as it makes it much easier for you to use other third-party Python libraries.
+You do not need to install or configure anything else to use Python. Having
+said that, I would strongly recommend that you install the tools and libraries
+described in the next section before you start building Python applications
+for real-world use. In particular, you should always install Distribute, as it
+makes it much easier for you to use other third-party Python libraries.
-The version of Python that ships with OS X is great for learning, but it's not good for development. It's slightly out of date, and Apple has made significant changes that can cause hidden bugs.
+The version of Python that ships with OS X is great for learning, but it's not
+good for development. It's slightly out of date, and Apple has made significant
+changes that can cause hidden bugs.
Doing it Right
--------------
Let's install a real version of Python.
-First, you'll need to have GCC installed to compile Python. You can either get this from `XCode <http://developer.apple.com/xcode/>`_ or the smaller `OSX-GCC-Installer <https://github.com/kennethreitz/osx-gcc-installer#readme>`_ package.
+First, you'll need to have GCC installed to compile Python. You can either get
+this from `XCode <http://developer.apple.com/xcode/>`_ or the smaller
+`OSX-GCC-Installer <https://github.com/kennethreitz/osx-gcc-installer#readme>`_ package.
-While Lion comes with a large number of UNIX utilities, those familiar with Linux systems will notice one key component missing: a decent package manager. `Homebrew <http://mxcl.github.com/homebrew/>`_ fills this void.
+While Lion comes with a large number of UNIX utilities, those familiar with
+Linux systems will notice one key component missing: a decent package manager.
+`Homebrew <http://mxcl.github.com/homebrew/>`_ fills this void.
-To `install Homebrew <https://github.com/mxcl/homebrew/wiki/installation>`_, simply run::
+To `install Homebrew <https://github.com/mxcl/homebrew/wiki/installation>`_,
+simply run::
$ ruby -e "$(curl -fsS https://raw.github.com/mxcl/homebrew/master/Library/Contributions/install_homebrew.rb)"
-Then, insert the hombrew directory at the top of your ``PATH`` enviornment variable. You can do this by adding the following line at the bottom of your ``~/.bashrc`` file::
+Then, insert the hombrew directory at the top of your ``PATH`` enviornment
+variable. You can do this by adding the following line at the bottom of your
+``~/.bashrc`` file::
export PATH=/usr/local/bin:$PATH
$ brew install python --framework
-This will take a minute or two. Once that's complete, you'll have to add the new Python scripts directory to your ``PATH``::
+This will take a minute or two. Once that's complete, you'll have to add the
+new Python scripts directory to your ``PATH``::
export PATH=/usr/local/share/python:$PATH
-The ``--framework`` option tells Homebrew to compile a Framework-style Python build, rather than a UNIX-style build. The outdated version of Python that Snow Leopard comes packaged with is built as a Framework, so this helps avoid some future module installation bugs.
+The ``--framework`` option tells Homebrew to compile a Framework-style Python
+build, rather than a UNIX-style build. The outdated version of Python that
+Snow Leopard comes packaged with is built as a Framework, so this helps avoid
+some future module installation bugs.
Distribute & Pip
----------------
-The most crucial third-party Python software of all is Distribute, which extends the packaging and installation facilities provided by the distutils in the standard library. Once you add Distribute to your Python system you can download and install any compliant Python software product with a single command. It also enables you to add this network installation capability to your own Python software with very little work.
+The most crucial third-party Python software of all is Distribute, which
+extends the packaging and installation facilities provided by the distutils
+in the standard library. Once you add Distribute to your Python system you can
+download and install any compliant Python software product with a single
+command. It also enables you to add this network installation capability to
+your own Python software with very little work.
-Hombrew already installed Distribute for you. Its ``easy_install`` command is considered by many to be deprecated, so we will install its replacement: **pip**. Pip allows for uninstallation of packages, and is actively maintained, unlike easy_install.
+Hombrew already installed Distribute for you. Its ``easy_install`` command is
+considered by many to be deprecated, so we will install its replacement:
+**pip**. Pip allows for uninstallation of packages, and is actively maintained,
+unlike easy_install.
To install pip, simply open a command prompt and run::
Virtualenv
----------
-After Distribute & Pip, the next development tool that you should install is `virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
+After Distribute & Pip, the next development tool that you should install is
+`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
$ pip install virtualenv
-The virtualenv kit provides the ability to create virtual Python environments that do not interfere with either each other, or the main Python installation. If you install virtualenv before you begin coding then you can get into the habit of using it to create completely clean Python environments for each project. This is particularly important for Web development, where each framework and application will have many dependencies.
+The virtualenv kit provides the ability to create virtual Python environments
+that do not interfere with either each other, or the main Python installation.
+If you install virtualenv before you begin coding then you can get into the
+habit of using it to create completely clean Python environments for each
+project. This is particularly important for Web development, where each
+framework and application will have many dependencies.
-To set up a new Python environment, change the working directory to where ever you want to store the environment, and run the virtualenv utility in your project's directory::
+To set up a new Python environment, change the working directory to where ever
+you want to store the environment, and run the virtualenv utility in your
+project's directory::
$ virtualenv --distribute venv
-To use an environment, run ``source venv/bin/activate``. Your command prompt will change to show the active environment. Once you have finished working in the current virtual environment, run ``deactivate`` to restore your settings to normal.
+To use an environment, run ``source venv/bin/activate``. Your command prompt
+will change to show the active environment. Once you have finished working in
+the current virtual environment, run ``deactivate`` to restore your settings
+to normal.
-Each new environment automatically includes a copy of ``pip``, so that you can setup the third-party libraries and tools that you want to use in that environment. Put your own code within a subdirectory of the environment, however you wish. When you no longer need a particular environment, simply copy your code out of it, and then delete the main directory for the environment.
+Each new environment automatically includes a copy of ``pip``, so that you can
+setup the third-party libraries and tools that you want to use in that
+environment. Put your own code within a subdirectory of the environment,
+however you wish. When you no longer need a particular environment, simply
+copy your code out of it, and then delete the main directory for the environment.
--------------------------------
-This page is a remixed version of `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_, which is available under the same license.
+This page is a remixed version of `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_,
+which is available under the same license.
Installing Python on Windows
============================
-First, download the `latest version <http://python.org/ftp/python/2.7.2/python-2.7.2.msi>`_ of Python 2 from the official Website.
+First, download the `latest version <http://python.org/ftp/python/2.7.2/python-2.7.2.msi>`_
+of Python 2 from the official Website.
-The Windows version is provided as an MSI package. To install it manually, just double-click the file. The MSI package format allows Windows administrators to automate installation with their standard tools.
+The Windows version is provided as an MSI package. To install it manually, just
+ double-click the file. The MSI package format allows Windows administrators to
+ automate installation with their standard tools.
-By design, Python installs to a directory with the version number embedded, e.g. ``C:\Python27\``, so that you can have multiple versions of Python on the same system without conflicts. Of course, only one interpreter can be the default application for Python file types. It also does not automatically modify the ``PATH`` environment variable, so that you always have control over which copy of Python is run.
+By design, Python installs to a directory with the version number embedded,
+e.g. ``C:\Python27\``, so that you can have multiple versions of Python on the
+same system without conflicts. Of course, only one interpreter can be the
+default application for Python file types. It also does not automatically
+modify the ``PATH`` environment variable, so that you always have control over
+which copy of Python is run.
-Typing the full path name for a Python interpreter each time quickly gets tedious, so add the directories for your default Python version to the PATH. Assuming that your Python installation is in ``C:\Python27\``, add this to your PATH::
+Typing the full path name for a Python interpreter each time quickly gets
+tedious, so add the directories for your default Python version to the PATH.
+Assuming that your Python installation is in ``C:\Python27\``, add this to your
+PATH::
C:\Python27\;C:\Python27\Scripts\
[Environment]::SetEnvironmentVariable("Path", "$env:Path;C:\Python27\;C:\Python27\Scripts\", "User")
-You do not need to install or configure anything else to use Python. Having said that, I would strongly recommend that you install the tools and libraries described in the next section before you start building Python applications for real-world use. In particular, you should always install Distribute, as it makes it much easier for you to use other third-party Python libraries.
+You do not need to install or configure anything else to use Python. Having
+said that, I would strongly recommend that you install the tools and libraries
+described in the next section before you start building Python applications for
+real-world use. In particular, you should always install Distribute, as it
+makes it much easier for you to use other third-party Python libraries.
Distribute + Pip
----------------
-The most crucial third-party Python software of all is Distribute, which extends the packaging and installation facilities provided by the distutils in the standard library. Once you add Distribute to your Python system you can download and install any compliant Python software product with a single command. It also enables you to add this network installation capability to your own Python software with very little work.
+The most crucial third-party Python software of all is Distribute, which
+extends the packaging and installation facilities provided by the distutils in
+the standard library. Once you add Distribute to your Python system you can
+download and install any compliant Python software product with a single
+command. It also enables you to add this network installation capability to
+your own Python software with very little work.
-To obtain the latest version of Distribute for Windows, run the python script available here:
+To obtain the latest version of Distribute for Windows, run the python script
+available here:
http://python-distribute.org/distribute_setup.py
-You'll now have a new command available to you: **easy_install**. It is considered by many to be deprecated, so we will install its replacement: **pip**. Pip allows for uninstallation of packages, and is actively maintained, unlike easy_install.
+You'll now have a new command available to you: **easy_install**. It is
+considered by many to be deprecated, so we will install its replacement:
+**pip**. Pip allows for uninstallation of packages, and is actively maintained,
+unlike easy_install.
To install pip, simply open a command prompt and run::
Virtualenv
----------
-After Distribute & Pip, the next development tool that you should install is `virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
+After Distribute & Pip, the next development tool that you should install is
+`virtualenv <http://pypi.python.org/pypi/virtualenv/>`_. Use pip::
> pip install virtualenv
-The virtualenv kit provides the ability to create virtual Python environments that do not interfere with either each other, or the main Python installation. If you install virtualenv before you begin coding then you can get into the habit of using it to create completely clean Python environments for each project. This is particularly important for Web development, where each framework and application will have many dependencies.
+The virtualenv kit provides the ability to create virtual Python environments
+that do not interfere with either each other, or the main Python installation.
+If you install virtualenv before you begin coding then you can get into the
+habit of using it to create completely clean Python environments for each
+project. This is particularly important for Web development, where each
+framework and application will have many dependencies.
-To set up a new Python environment, change the working directory to where ever you want to store the environment, and run the virtualenv utility in your project's directory::
+To set up a new Python environment, change the working directory to where ever
+you want to store the environment, and run the virtualenv utility in your
+project's directory::
> virtualenv --distribute venv
-To use an environment, run the ``activate.bat`` batch file in the ``Scripts`` subdirectory of that environment. Your command prompt will change to show the active environment. Once you have finished working in the current virtual environment, run the ``deactivate.bat`` batch file to restore your settings to normal.
+To use an environment, run the ``activate.bat`` batch file in the ``Scripts``
+subdirectory of that environment. Your command prompt will change to show the
+active environment. Once you have finished working in the current virtual
+environment, run the ``deactivate.bat`` batch file to restore your settings to
+normal.
-Each new environment automatically includes a copy of ``pip`` in the ``Scripts`` subdirectory, so that you can setup the third-party libraries and tools that you want to use in that environment. Put your own code within a subdirectory of the environment, however you wish. When you no longer need a particular environment, simply copy your code out of it, and then delete the main directory for the environment.
+Each new environment automatically includes a copy of ``pip`` in the
+``Scripts`` subdirectory, so that you can setup the third-party libraries and
+tools that you want to use in that environment. Put your own code within a
+subdirectory of the environment, however you wish. When you no longer need a
+particular environment, simply copy your code out of it, and then delete the
+main directory for the environment.
--------------------------------
-This page is a remixed version of `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_, which is available under the same license.
+This page is a remixed version of `another guide <http://www.stuartellis.eu/articles/python-development-windows/>`_,
+which is available under the same license.
There's a good chance that you already have Python on your operating system.
-If so, you do not need to install or configure anything else to use Python. Having said that, I would strongly recommend that you install the tools and libraries described in the guides below before you start building Python applications for real-world use. In particular, you should always install Distribute, Pip, and Virtualenv — they make it much easier for you to use other third-party Python libraries.
+If so, you do not need to install or configure anything else to use Python.
+Having said that, I would strongly recommend that you install the tools and
+libraries described in the guides below before you start building Python
+applications for real-world use. In particular, you should always install
+Distribute, Pip, and Virtualenv — they make it much easier for you to use
+other third-party Python libraries.
Installation Guides
-------------------
-These guides go over the proper installation of :ref:`Python 2.7 <which-python>` for development purposes, as well as distribute, pip, and virtualenv setup.
+These guides go over the proper installation of :ref:`Python 2.7 <which-python>`
+ for development purposes, as well as distribute, pip, and virtualenv setup.
- :ref:`Mac OS X <install-osx>`.
- :ref:`Microsoft Windows<install-windows>`.
Today
-----
-If you're choosing a Python interpreter to use, I *highly* recommend you Use Python 2.7.x, unless you have a strong reason not to.
+If you're choosing a Python interpreter to use, I *highly* recommend you Use
+Python 2.7.x, unless you have a strong reason not to.
The Future
git://git.eng.unimelb.edu.au / python-guide.git / commitdiff