docs(src/assets/): update pip official documentation

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: KemingHe

src/assets/pip/_metadata.yml

@@ -0,0 +1,4 @@
+source_repo: pypa/pip
+docs_path: docs
+updated_at: 2025-07-16T02:46:00Z
+commit_sha: 18694f6a0c568e996e0d27c3f8b3c0efe08a00fa

src/assets/pip/html/cli/index.md

@@ -0,0 +1,57 @@
+# Commands
+
+The general options that apply to all the commands listed below can be
+found [under the `pip` page in this section](pip).
+
+```{toctree}
+:maxdepth: 1
+:hidden:
+
+pip
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Environment Management and Introspection
+
+pip_install
+pip_uninstall
+pip_inspect
+pip_list
+pip_show
+pip_freeze
+pip_check
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Resolving dependencies
+
+pip_lock
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Handling Distribution Files
+
+pip_download
+pip_wheel
+pip_hash
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Package Index information
+
+pip_search
+pip_index
+```
+
+```{toctree}
+:maxdepth: 1
+:caption: Managing pip itself
+
+pip_cache
+pip_config
+pip_debug
+```

src/assets/pip/html/cli/pip.rst

@@ -0,0 +1,87 @@
+===
+pip
+===
+
+
+Usage
+*****
+
+.. tab:: Unix/macOS
+
+    .. code-block:: shell
+
+        python -m pip <command> [options]
+
+.. tab:: Windows
+
+    .. code-block:: shell
+
+        py -m 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. By default, some messages (error and warnings)
+are colored in the terminal. If you want to suppress the colored output use
+:ref:`--no-color <--no-color>`.
+
+
+.. _`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.
+
+Like all pip options, ``--log`` can also be set as an environment variable, or
+placed into the pip config file. See the :doc:`../topics/configuration` section.
+
+.. _`exists-action`:
+
+--exists-action option
+======================
+
+This option specifies default behavior when path already exists.
+Possible cases: downloading files or checking out repositories for installation,
+creating archives. If ``--exists-action`` is not defined, pip will prompt
+when decision is needed.
+
+*(s)witch*
+    Only relevant to VCS checkout. Attempt to switch the checkout
+    to the appropriate URL and/or revision.
+*(i)gnore*
+    Abort current operation (e.g. don't copy file, don't create archive,
+    don't modify a checkout).
+*(w)ipe*
+    Delete the file or VCS checkout before trying to create, download, or checkout a new one.
+*(b)ackup*
+    Rename the file or checkout to ``{name}{'.bak' * n}``, where n is some number
+    of ``.bak`` extensions, such that the file didn't exist at some point.
+    So the most recent backup will be the one with the largest number after ``.bak``.
+*(a)bort*
+    Abort pip and return non-zero exit status.
+
+.. _`2-build-system-interface`:
+.. rubric:: Build System Interface
+
+This is now covered in :doc:`../reference/build-system/index`.
+
+.. _`General Options`:
+
+General Options
+***************
+
+.. pip-general-options::

src/assets/pip/html/cli/pip_cache.rst

@@ -0,0 +1,27 @@
+
+.. _`pip cache`:
+
+pip cache
+---------
+
+
+Usage
+*****
+
+.. tab:: Unix/macOS
+
+   .. pip-command-usage:: cache "python -m pip"
+
+.. tab:: Windows
+
+   .. pip-command-usage:: cache "py -m pip"
+
+Description
+***********
+
+.. pip-command-description:: cache
+
+Options
+*******
+
+.. pip-command-options:: cache

src/assets/pip/html/cli/pip_check.rst

@@ -0,0 +1,87 @@
+.. _`pip check`:
+
+=========
+pip check
+=========
+
+
+Usage
+=====
+
+.. tab:: Unix/macOS
+
+   .. pip-command-usage:: check "python -m pip"
+
+.. tab:: Windows
+
+   .. pip-command-usage:: check "py -m pip"
+
+
+Description
+===========
+
+.. pip-command-description:: check
+
+
+Examples
+========
+
+#. If all dependencies are compatible:
+
+   .. tab:: Unix/macOS
+
+      .. code-block:: console
+
+         $ python -m pip check
+         No broken requirements found.
+         $ echo $?
+         0
+
+   .. tab:: Windows
+
+      .. code-block:: console
+
+         C:\> py -m pip check
+         No broken requirements found.
+         C:\> echo %errorlevel%
+         0
+
+#. If a package is missing:
+
+   .. tab:: Unix/macOS
+
+      .. code-block:: console
+
+         $ python -m pip check
+         pyramid 1.5.2 requires WebOb, which is not installed.
+         $ echo $?
+         1
+
+   .. tab:: Windows
+
+      .. code-block:: console
+
+         C:\> py -m pip check
+         pyramid 1.5.2 requires WebOb, which is not installed.
+         C:\> echo %errorlevel%
+         1
+
+#. If a package has the wrong version:
+
+   .. tab:: Unix/macOS
+
+      .. code-block:: console
+
+         $ python -m pip check
+         pyramid 1.5.2 has requirement WebOb>=1.3.1, but you have WebOb 0.8.
+         $ echo $?
+         1
+
+   .. tab:: Windows
+
+      .. code-block:: console
+
+         C:\> py -m pip check
+         pyramid 1.5.2 has requirement WebOb>=1.3.1, but you have WebOb 0.8.
+         C:\> echo %errorlevel%
+         1

src/assets/pip/html/cli/pip_config.rst

@@ -0,0 +1,30 @@
+
+.. _`pip config`:
+
+==========
+pip config
+==========
+
+
+Usage
+=====
+
+.. tab:: Unix/macOS
+
+   .. pip-command-usage:: config "python -m pip"
+
+.. tab:: Windows
+
+   .. pip-command-usage:: config "py -m pip"
+
+
+Description
+===========
+
+.. pip-command-description:: config
+
+
+Options
+=======
+
+.. pip-command-options:: config

src/assets/pip/html/cli/pip_debug.rst

@@ -0,0 +1,35 @@
+.. _`pip debug`:
+
+=========
+pip debug
+=========
+
+
+Usage
+=====
+
+.. tab:: Unix/macOS
+
+   .. pip-command-usage:: debug "python -m pip"
+
+.. tab:: Windows
+
+   .. pip-command-usage:: debug "py -m pip"
+
+
+.. warning::
+
+    This command is only meant for debugging.
+    Its options and outputs are provisional and may change without notice.
+
+
+Description
+===========
+
+.. pip-command-description:: debug
+
+
+Options
+=======
+
+.. pip-command-options:: debug