Rework user-facing messaging

Author: ichard26

src/pip/_internal/cli/cmdoptions.py

@@ -1083,7 +1083,7 @@ def check_list_path_option(options: Values) -> None:
     dest="resume_retries",
     type="int",
     default=0,
-    help="Maximum number of resumption retries for incomplete downloads"
+    help="Maximum number of resumption attempts for incomplete downloads"
     "(default %default times).",
 )
 

src/pip/_internal/exceptions.py

@@ -824,8 +824,8 @@ def __init__(
 
         download_status = f"{format_size(received)}/{format_size(expected)}"
         if retries:
-            retry_status = f"after {retries} retries "
-            hint = "Use --resume-retries to configure resume retry limit."
+            retry_status = f"after {retries} attempts "
+            hint = "Use --resume-retries to configure resume attempt limit."
         else:
             retry_status = ""
             hint = "Consider using --resume-retries to enable download resumption."

src/pip/_internal/network/download.py

@@ -239,9 +239,10 @@ def _attempt_resume(
             attempts_left -= 1
 
             logger.warning(
-                "Attempting to resume download with bytes received: %s/%s",
+                "Attempting to resume incomplete download (%s/%s, attempt %d)",
                 format_size(bytes_received),
                 format_size(total_length),
+                (self._resume_retries - attempts_left),
             )
 
             try: