Gecko [ lorencats.com ]

Name	Size	Permission
index.rst	238 B	-rw-r--r--
pip.rst.gz	3.23 KB	-rw-r--r--
pip_check.rst	598 B	-rw-r--r--
pip_config.rst	215 B	-rw-r--r--
pip_download.rst	3.4 KB	-rw-r--r--
pip_freeze.rst	602 B	-rw-r--r--
pip_hash.rst	1.18 KB	-rw-r--r--
pip_install.rst.gz	11.23 KB	-rw-r--r--
pip_list.rst	1.64 KB	-rw-r--r--
pip_search.rst	443 B	-rw-r--r--
pip_show.rst	2.08 KB	-rw-r--r--
pip_uninstall.rst	543 B	-rw-r--r--
pip_wheel.rst	1.49 KB	-rw-r--r--

Code Editor : pip_wheel.rst

.. _`pip wheel`:

pip wheel
---------

.. contents::

Usage
*****

.. pip-command-usage:: wheel

Description
***********

.. pip-command-description:: wheel

Build System Interface
++++++++++++++++++++++

In order for pip to build a wheel, ``setup.py`` must implement the
``bdist_wheel`` command with the following syntax::

python setup.py bdist_wheel -d TARGET

This command must create a wheel compatible with the invoking Python
interpreter, and save that wheel in the directory TARGET.

No other build system commands are invoked by the ``pip wheel`` command.

Customising the build
~~~~~~~~~~~~~~~~~~~~~

It is possible using ``--global-option`` to include additional build commands
with their arguments in the ``setup.py`` command. This is currently the only
way to influence the building of C extensions from the command line. For
example::

pip wheel --global-option bdist_ext --global-option -DFOO wheel

will result in a build command of

setup.py bdist_ext -DFOO bdist_wheel -d TARGET

which passes a preprocessor symbol to the extension build.

Such usage is considered highly build-system specific and more an accident of
the current implementation than a supported interface.

Options
*******

.. pip-command-options:: wheel

.. pip-index-options::

Examples
********

#. Build wheels for a requirement (and all its dependencies), and then install

$ pip wheel --wheel-dir=/tmp/wheelhouse SomePackage
      $ pip install --no-index --find-links=/tmp/wheelhouse SomePackage

${this.title}

Code Editor : pip_wheel.rst