network.session: Add a use_keyring option, defaulting to false

Closes pypa#8719

Author: nbraud

src/pip/_internal/network/session.py

@@ -234,6 +234,7 @@ def __init__(self, *args, **kwargs):
         cache = kwargs.pop("cache", None)
         trusted_hosts = kwargs.pop("trusted_hosts", [])  # type: List[str]
         index_urls = kwargs.pop("index_urls", None)
+        use_keyring = kwargs.pop("use_keyring", False)
 
         super().__init__(*args, **kwargs)
 
@@ -245,7 +246,10 @@ def __init__(self, *args, **kwargs):
         self.headers["User-Agent"] = user_agent()
 
         # Attach our Authentication handler to the session
-        self.auth = MultiDomainBasicAuth(index_urls=index_urls)
+        self.auth = MultiDomainBasicAuth(
+            use_keyring=use_keyring,
+            index_urls=index_urls,
+        )
 
         # Create our urllib3.Retry instance which will allow us to customize
         # how we handle retries.