Improve BadZipFile reporting

Author: lukasjuhrich

news/10535.feature.rst

@@ -0,0 +1,2 @@
+Catch ``BadZipFile`` errors and re-raise them as ``InvalidWheel`` which
+additionally reports wheel name and path.

src/pip/_internal/exceptions.py

@@ -132,6 +132,17 @@ class UnsupportedWheel(InstallationError):
     """Unsupported wheel."""
 
 
+class InvalidWheel(InstallationError):
+    """Invalid (e.g. corrupt) wheel."""
+
+    def __init__(self, location: str, name: str):
+        self.location = location
+        self.name = name
+
+    def __str__(self) -> str:
+        return f"Wheel '{self.name}' located at {self.location} is invalid."
+
+
 class MetadataInconsistent(InstallationError):
     """Built metadata contains inconsistent information.
 

src/pip/_internal/metadata/pkg_resources.py

@@ -1,12 +1,14 @@
 import email.message
 import logging
 from typing import Collection, Iterable, Iterator, List, NamedTuple, Optional
+from zipfile import BadZipFile
 
 from pip._vendor import pkg_resources
 from pip._vendor.packaging.requirements import Requirement
 from pip._vendor.packaging.utils import NormalizedName, canonicalize_name
 from pip._vendor.packaging.version import parse as parse_version
 
+from pip._internal.exceptions import InvalidWheel
 from pip._internal.utils import misc  # TODO: Move definition here.
 from pip._internal.utils.packaging import get_installer, get_metadata
 from pip._internal.utils.wheel import pkg_resources_distribution_for_wheel
@@ -34,8 +36,16 @@ def __init__(self, dist: pkg_resources.Distribution) -> None:
 
     @classmethod
     def from_wheel(cls, wheel: Wheel, name: str) -> "Distribution":
-        with wheel.as_zipfile() as zf:
-            dist = pkg_resources_distribution_for_wheel(zf, name, wheel.location)
+        """Load the distribution from a given wheel.
+
+        :raises InvalidWheel: Whenever loading of the wheel causes a
+            :py:exc:`zipfile.BadZipFile` exception to be thrown.
+        """
+        try:
+            with wheel.as_zipfile() as zf:
+                dist = pkg_resources_distribution_for_wheel(zf, name, wheel.location)
+        except BadZipFile as e:
+            raise InvalidWheel(wheel.location, name) from e
         return cls(dist)
 
     @property