docs: use .zshrc for zsh completion setup

docs/html/user_guide.rst

@@ -743,7 +743,10 @@ To setup for bash::
 
 To setup for zsh::
 
-    python -m pip completion --zsh >> ~/.zprofile
+    python -m pip completion --zsh >> ~/.zshrc
+
+    # Requires zsh completion (compinit) to be enabled.
+
 
 To setup for fish::
 

news/13811.bugfix.rst

@@ -0,0 +1 @@
+Deduplicate repeated invalid metadata warnings for the same location.

src/pip/_internal/index/package_finder.py

@@ -1037,7 +1037,7 @@ def _format_versions(cand_iter: Iterable[InstallationCandidate]) -> str:
                 _format_versions(best_candidate_result.all_candidates),
             )
 
-            raise DistributionNotFound(f"No matching distribution found for {req}")
+            raise DistributionNotFound(f"No matching distribution found for {name}")
 
         def _should_install_candidate(
             candidate: InstallationCandidate | None,

src/pip/_internal/metadata/importlib/_envs.py

@@ -54,6 +54,7 @@ class _DistributionFinder:
 
     def __init__(self) -> None:
         self._found_names: set[NormalizedName] = set()
+        self._warned_bad_metadata: set[BasePath | None] = set()
 
     def _find_impl(self, location: str) -> Iterator[FoundResult]:
         """Find distributions in a location."""
@@ -69,7 +70,9 @@ def _find_impl(self, location: str) -> Iterator[FoundResult]:
             try:
                 name = get_dist_canonical_name(dist)
             except BadMetadata as e:
-                logger.warning("Skipping %s due to %s", info_location, e.reason)
+                if info_location not in self._warned_bad_metadata:
+                    logger.warning("Skipping %s due to %s", info_location, e.reason)
+                    self._warned_bad_metadata.add(info_location)
                 continue
             if name in self._found_names:
                 continue

src/pip/_internal/resolution/resolvelib/factory.py

@@ -720,7 +720,9 @@ def _report_single_requirement_conflict(
                 "requirements.txt"
             )
 
-        return DistributionNotFound(f"No matching distribution found for {req}")
+        return DistributionNotFound(
+            f"No matching distribution found for {req.project_name}"
+        )
 
     def _has_any_candidates(self, project_name: str) -> bool:
         """

tests/functional/test_new_resolver.py

@@ -298,7 +298,7 @@ def test_new_resolver_no_dist_message(script: PipTestEnvironment) -> None:
     assert (
         "Could not find a version that satisfies the requirement B" in result.stderr
     ), str(result)
-    assert "No matching distribution found for B" in result.stderr, str(result)
+    assert "no matching distribution found for b" in result.stderr.lower(), str(result)
 
 
 def test_new_resolver_installs_editable(script: PipTestEnvironment) -> None: