Lines Matching +full:python +full:- +full:version
2 .. _tut-venv:
11 Python applications will often use packages and modules that don't
13 need a specific version of a library, because the application may
15 written using an obsolete version of the library's interface.
17 This means it may not be possible for one Python installation to meet
18 the requirements of every application. If application A needs version
19 1.0 of a particular module but application B needs version 2.0, then
20 the requirements are in conflict and installing either version 1.0 or 2.0
24 self-contained directory tree that contains a Python installation for a
25 particular version of Python, plus a number of additional packages.
29 application A can have its own virtual environment with version 1.0
30 installed while application B has another virtual environment with version 2.0.
31 If application B requires a library be upgraded to version 3.0, this will
39 :mod:`venv`. :mod:`venv` will install the Python version from which
40 the command was run (as reported by the :option:`--version` option).
42 version 3.12.
47 python -m venv tutorial-env
49 This will create the ``tutorial-env`` directory if it doesn't exist,
50 and also create directories inside it containing a copy of the Python
63 tutorial-env\Scripts\activate
67 source tutorial-env/bin/activate
76 ``python`` will get you that particular version and installation of Python.
79 .. code-block:: bash
81 $ source ~/envs/tutorial-env/bin/activate
82 (tutorial-env) $ python
83 Python 3.5.1 (default, May 6 2016, 10:59:36)
88 '~/envs/tutorial-env/lib/python3.5/site-packages']
101 :program:`pip`. By default ``pip`` will install packages from the `Python
102 Package Index <https://pypi.org>`_. You can browse the Python
106 "freeze", etc. (Consult the :ref:`installing-index` guide for
109 You can install the latest version of a package by specifying a package's name:
111 .. code-block:: bash
113 (tutorial-env) $ python -m pip install novas
115 Downloading novas-3.1.1.3.tar.gz (136kB)
118 Successfully installed novas-3.1.1.3
120 You can also install a specific version of a package by giving the
121 package name followed by ``==`` and the version number:
123 .. code-block:: bash
125 (tutorial-env) $ python -m pip install requests==2.6.0
127 Using cached requests-2.6.0-py2.py3-none-any.whl
129 Successfully installed requests-2.6.0
131 If you re-run this command, ``pip`` will notice that the requested
132 version is already installed and do nothing. You can supply a
133 different version number to get that version, or you can run ``python
134 -m pip install --upgrade`` to upgrade the package to the latest version:
136 .. code-block:: bash
138 (tutorial-env) $ python -m pip install --upgrade requests
142 Uninstalling requests-2.6.0:
143 Successfully uninstalled requests-2.6.0
144 Successfully installed requests-2.7.0
146 ``python -m pip uninstall`` followed by one or more package names will
149 ``python -m pip show`` will display information about a particular package:
151 .. code-block:: bash
153 (tutorial-env) $ python -m pip show requests
154 ---
155 Metadata-Version: 2.0
157 Version: 2.7.0
158 Summary: Python HTTP for Humans.
159 Home-page: http://python-requests.org
161 Author-email: me@kennethreitz.com
163 Location: /Users/akuchling/envs/tutorial-env/lib/python3.4/site-packages
166 ``python -m pip list`` will display all of the packages installed in
169 .. code-block:: bash
171 (tutorial-env) $ python -m pip list
178 ``python -m pip freeze`` will produce a similar list of the installed packages,
179 but the output uses the format that ``python -m pip install`` expects.
182 .. code-block:: bash
184 (tutorial-env) $ python -m pip freeze > requirements.txt
185 (tutorial-env) $ cat requirements.txt
190 The ``requirements.txt`` can then be committed to version control and
192 necessary packages with ``install -r``:
194 .. code-block:: bash
196 (tutorial-env) $ python -m pip install -r requirements.txt
197 Collecting novas==3.1.1.3 (from -r requirements.txt (line 1))
199 Collecting numpy==1.9.2 (from -r requirements.txt (line 2))
201 Collecting requests==2.7.0 (from -r requirements.txt (line 3))
205 Successfully installed novas-3.1.1.3 numpy-1.9.2 requests-2.7.0
207 ``pip`` has many more options. Consult the :ref:`installing-index`
209 a package and want to make it available on the Python Package Index,
210 consult the `Python packaging user guide`_.
212 .. _Python Packaging User Guide: https://packaging.python.org/en/latest/tutorials/packaging-project…