mirror of https://github.com/pallets/flask.git
Update installation documentation for using 'pip' command (#1920)
This commit is contained in:
Olexander Yermakov
Jeff Widman
parent
67e391921c
commit
b7a0cc61c5
|
|
@ -40,24 +40,20 @@ installations of Python, one for each project. It doesn't actually install
|
|||
separate copies of Python, but it does provide a clever way to keep different
|
||||
project environments isolated. Let's see how virtualenv works.
|
||||
|
||||
If you are on Mac OS X or Linux, chances are that one of the following two
|
||||
commands will work for you::
|
||||
|
||||
$ sudo easy_install virtualenv
|
||||
|
||||
or even better::
|
||||
If you are on Mac OS X or Linux, chances are that the following
|
||||
command will work for you::
|
||||
|
||||
$ sudo pip install virtualenv
|
||||
|
||||
One of these will probably install virtualenv on your system. Maybe it's even
|
||||
It will probably install virtualenv on your system. Maybe it's even
|
||||
in your package manager. If you use Ubuntu, try::
|
||||
|
||||
$ sudo apt-get install python-virtualenv
|
||||
|
||||
If you are on Windows and don't have the :command:`easy_install` command, you must
|
||||
If you are on Windows and don't have the ``easy_install`` command, you must
|
||||
install it first. Check the :ref:`windows-easy-install` section for more
|
||||
information about how to do that. Once you have it installed, run the same
|
||||
commands as above, but without the :command:`sudo` prefix.
|
||||
commands as above, but without the ``sudo`` prefix.
|
||||
|
||||
Once you have virtualenv installed, just fire up a shell and create
|
||||
your own environment. I usually create a project folder and a :file:`venv`
|
||||
|
|
@ -99,19 +95,19 @@ System-Wide Installation
|
|||
------------------------
|
||||
|
||||
This is possible as well, though I do not recommend it. Just run
|
||||
:command:`pip` with root privileges::
|
||||
``pip`` with root privileges::
|
||||
|
||||
$ sudo pip install Flask
|
||||
|
||||
(On Windows systems, run it in a command-prompt window with administrator
|
||||
privileges, and leave out :command:`sudo`.)
|
||||
privileges, and leave out ``sudo``.)
|
||||
|
||||
|
||||
Living on the Edge
|
||||
------------------
|
||||
|
||||
If you want to work with the latest version of Flask, there are two ways: you
|
||||
can either let :command:`pip` pull in the development version, or you can tell
|
||||
can either let ``pip`` pull in the development version, or you can tell
|
||||
it to operate on a git checkout. Either way, virtualenv is recommended.
|
||||
|
||||
Get the git checkout in a new virtualenv and run in development mode::
|
||||
|
|
@ -131,40 +127,34 @@ This will pull in the dependencies and activate the git head as the current
|
|||
version inside the virtualenv. Then all you have to do is run ``git pull
|
||||
origin`` to update to the latest version.
|
||||
|
||||
|
||||
.. _windows-easy-install:
|
||||
|
||||
`pip` and `setuptools` on Windows
|
||||
---------------------------------
|
||||
|
||||
Sometimes getting the standard "Python packaging tools" like *pip*, *setuptools*
|
||||
and *virtualenv* can be a little trickier, but nothing very hard. The two crucial
|
||||
packages you will need are setuptools and pip - these will let you install
|
||||
anything else (like virtualenv). Fortunately there are two "bootstrap scripts"
|
||||
you can run to install either.
|
||||
Sometimes getting the standard "Python packaging tools" like ``pip``, ``setuptools``
|
||||
and ``virtualenv`` can be a little trickier, but nothing very hard. The crucial
|
||||
package you will need is pip - this will let you install
|
||||
anything else (like virtualenv). Fortunately there is a "bootstrap script"
|
||||
you can run to install.
|
||||
|
||||
If you don't currently have either, then :file:`get-pip.py` will install both for you
|
||||
(you won't need to run :file:`ez_setup.py`).
|
||||
If you don't currently have ``pip``, then `get-pip.py` will install it for you.
|
||||
|
||||
`get-pip.py`_
|
||||
|
||||
To install the latest setuptools, you can use its bootstrap file:
|
||||
|
||||
`ez_setup.py`_
|
||||
|
||||
Either should be double-clickable once you download them. If you already have pip,
|
||||
It should be double-clickable once you download it. If you already have ``pip``,
|
||||
you can upgrade them by running::
|
||||
|
||||
> pip install --upgrade pip setuptools
|
||||
|
||||
Most often, once you pull up a command prompt you want to be able to type :command:`pip`
|
||||
and :command:`python` which will run those things, but this might not automatically happen
|
||||
Most often, once you pull up a command prompt you want to be able to type ``pip``
|
||||
and ``python`` which will run those things, but this might not automatically happen
|
||||
on Windows, because it doesn't know where those executables are (give either a try!).
|
||||
|
||||
To fix this, you should be able to navigate to your Python install directory
|
||||
(e.g :file:`C:\Python27`), then go to :file:`Tools`, then :file:`Scripts`, then find the
|
||||
:file:`win_add2path.py` file and run that. Open a **new** Command Prompt and
|
||||
check that you can now just type :command:`python` to bring up the interpreter.
|
||||
check that you can now just type ``python`` to bring up the interpreter.
|
||||
|
||||
Finally, to install `virtualenv`_, you can simply run::
|
||||
|
||||
|
|
@ -173,4 +163,3 @@ Finally, to install `virtualenv`_, you can simply run::
|
|||
Then you can be off on your way following the installation instructions above.
|
||||
|
||||
.. _get-pip.py: https://bootstrap.pypa.io/get-pip.py
|
||||
.. _ez_setup.py: https://bitbucket.org/pypa/setuptools/raw/bootstrap/ez_setup.py
|
||||
|
|
|
|||
Loading…
Reference in New Issue