SILENT KILLERPanel

Current Path: > > opt > alt > python33 > share > doc > alt-python33-pip > docs > reference


Operation   : Linux premium131.web-hosting.com 4.18.0-553.44.1.lve.el8.x86_64 #1 SMP Thu Mar 13 14:29:12 UTC 2025 x86_64
Software     : Apache
Server IP    : 162.0.232.56 | Your IP: 216.73.216.111
Domains      : 1034 Domain(s)
Permission   : [ 0755 ]

Files and Folders in: //opt/alt/python33/share/doc/alt-python33-pip/docs/reference

NameTypeSizeLast ModifiedActions
index.rst File 185 bytes May 17 2014 02:18:55.
pip.rst File 1877 bytes May 17 2014 02:19:02.
pip_freeze.rst File 552 bytes May 17 2014 02:19:02.
pip_install.rst File 13785 bytes May 17 2014 02:19:02.
pip_list.rst File 555 bytes May 17 2014 02:19:02.
pip_search.rst File 449 bytes May 17 2014 02:18:55.
pip_show.rst File 423 bytes May 17 2014 02:18:55.
pip_uninstall.rst File 543 bytes May 17 2014 02:18:55.
pip_wheel.rst File 466 bytes May 17 2014 02:19:02.

Reading File: //opt/alt/python33/share/doc/alt-python33-pip/docs/reference/pip.rst

pip
---

.. contents::

Usage
*****

::

 pip <command> [options]


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


.. _`Logging`:

Logging
=======

Console logging
~~~~~~~~~~~~~~~

pip offers :ref:`-v, --verbose <--verbose>` and :ref:`-q, --quiet <--quiet>`
to control the console log level.  Each option can be used multiple times and
used together. One ``-v`` increases the verbosity by one, whereas one ``-q`` decreases it by
one.

The series of log levels, in order, are as follows::

  VERBOSE_DEBUG, DEBUG, INFO, NOTIFY, WARN, ERROR, FATAL

``NOTIFY`` is the default level.

A few examples on how the parameters work to affect the level:

* specifying nothing results in ``NOTIFY``
* ``-v`` results in ``INFO``
* ``-vv`` results in ``DEBUG``
* ``-q`` results in ``WARN``
* ``-vq`` results in ``NOTIFY``

The most practical use case for users is either ``-v`` or ``-vv`` to see
additional logging to help troubleshoot an issue.


.. _`FileLogging`:

File logging
~~~~~~~~~~~~

pip offers the :ref:`--log <--log>` option for specifying a file where a maximum
verbosity log will be kept.  This option is empty by default. This log appends
to previous logging.

Additionally, when commands fail (i.e. return a non-zero exit code), pip writes
a "failure log" for the failed command. This log overwrites previous
logging. The default location is as follows:

* On Unix and Mac OS X: :file:`$HOME/.pip/pip.log`
* On Windows, the configuration file is: :file:`%HOME%\\pip\\pip.log`

The option for the failure log, is :ref:`--log-file <--log-file>`.

Both logs add a line per execution to specify the date and what pip executable wrote the log.

Like all pip options, ``--log`` and ``log-file``, can also be set as an environment
variable, or placed into the pip config file.  See the :ref:`Configuration`
section.

.. _`General Options`:

General Options
***************

.. pip-general-options::


SILENT KILLER Tool