Gecko [ tsuru-no-tsurugi.tokyo ]

Name	Size	Permission	Date
index.md	601 B	-rw-r--r--	2022-01-31 07:46
pip.rst	2.06 KB	-rw-r--r--	2022-01-31 07:46
pip_cache.rst	296 B	-rw-r--r--	2022-01-31 07:46
pip_check.rst	1.44 KB	-rw-r--r--	2022-01-31 07:46
pip_config.rst	316 B	-rw-r--r--	2022-01-31 07:46
pip_debug.rst	444 B	-rw-r--r--	2022-01-31 07:46
pip_download.rst.gz	1.49 KB	-rw-r--r--	2022-01-31 07:46
pip_freeze.rst	1.97 KB	-rw-r--r--	2022-01-31 07:46
pip_hash.rst	1.77 KB	-rw-r--r--	2022-01-31 07:46
pip_install.rst.gz	8.11 KB	-rw-r--r--	2022-01-31 07:46
pip_list.rst.gz	1.04 KB	-rw-r--r--	2022-01-31 07:46
pip_search.rst	862 B	-rw-r--r--	2022-01-31 07:46
pip_show.rst.gz	841 B	-rw-r--r--	2022-01-31 07:46
pip_uninstall.rst	1.07 KB	-rw-r--r--	2022-01-31 07:46
pip_wheel.rst	1.2 KB	-rw-r--r--	2022-01-31 07:46

Rename

.. _`pip hash`:

========
pip hash
========

Usage
=====

.. tab:: Unix/macOS

.. pip-command-usage:: hash "python -m pip"

.. tab:: Windows

.. pip-command-usage:: hash "py -m pip"

Description
===========

.. pip-command-description:: hash

Overview
--------

``pip hash`` is a convenient way to get a hash digest for use with
:ref:`hash-checking mode`, especially for packages with multiple archives. The
error message from ``pip install --require-hashes ...`` will give you one
hash, but, if there are multiple archives (like source and binary ones), you
will need to manually download and compute a hash for the others. Otherwise, a
spurious hash mismatch could occur when :ref:`pip install` is passed a
different set of options, like :ref:`--no-binary <install_--no-binary>`.

Options
=======

.. pip-command-options:: hash

Example
=======

Compute the hash of a downloaded archive:

.. tab:: Unix/macOS

.. code-block:: console

$ python -m pip download SomePackage
      Collecting SomePackage
         Downloading SomePackage-2.2.tar.gz
         Saved ./pip_downloads/SomePackage-2.2.tar.gz
      Successfully downloaded SomePackage
      $ python -m pip hash ./pip_downloads/SomePackage-2.2.tar.gz
      ./pip_downloads/SomePackage-2.2.tar.gz:
      --hash=sha256:93e62e05c7ad3da1a233def6731e8285156701e3419a5fe279017c429ec67ce0

.. tab:: Windows

.. code-block:: console

C:\> py -m pip download SomePackage
      Collecting SomePackage
         Downloading SomePackage-2.2.tar.gz
         Saved ./pip_downloads/SomePackage-2.2.tar.gz
      Successfully downloaded SomePackage
      C:\> py -m pip hash ./pip_downloads/SomePackage-2.2.tar.gz
      ./pip_downloads/SomePackage-2.2.tar.gz:
      --hash=sha256:93e62e05c7ad3da1a233def6731e8285156701e3419a5fe279017c429ec67ce0