Make index publisher HTTP timeout configurable

Author: Jatin-Shihora

docs/history/hatch.md

@@ -8,6 +8,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 ## Unreleased
 
+***Added:***
+
+- Allow configuring the HTTP timeout for the index publisher via the `timeout` config option, the `HATCH_INDEX_TIMEOUT` environment variable, or the `--timeout` CLI flag
+
 ## [1.16.5](https://github.com/pypa/hatch/releases/tag/hatch-v1.16.5) - 2026-02-26 ## {: #hatch-v1.16.5 }
 
 ***Fixed:***

docs/plugins/publisher/package-index.md

@@ -14,6 +14,7 @@ See the documentation for [publishing](../../publish.md).
 | `--ca-cert` | `ca-cert` | The path to a CA bundle |
 | `--client-cert` | `client-cert` | The path to a client certificate, optionally containing the private key |
 | `--client-key` | `client-key` | The path to the client certificate's private key |
+| `--timeout` | `timeout` | The HTTP timeout in seconds for index requests |
 | | `repos` | A table of named [repositories](#repositories) to their respective options |
 
 ## Configuration

src/hatch/cli/publish/__init__.py

@@ -35,6 +35,12 @@
     envvar=PublishEnvVars.CLIENT_KEY,
     help="The path to the client certificate's private key [env var: `HATCH_INDEX_CLIENT_KEY`]",
 )
+@click.option(
+    "--timeout",
+    envvar=PublishEnvVars.TIMEOUT,
+    type=int,
+    help="The HTTP timeout in seconds for index requests [env var: `HATCH_INDEX_TIMEOUT`]",
+)
 @click.option("--no-prompt", "-n", is_flag=True, help="Disable prompts, such as for missing required fields")
 @click.option(
     "--initialize-auth", is_flag=True, help="Save first-time authentication information even if nothing was published"
@@ -69,6 +75,7 @@ def publish(
     ca_cert,
     client_cert,
     client_key,
+    timeout,
     no_prompt,
     initialize_auth,
     publisher_name,
@@ -93,6 +100,8 @@ def publish(
             option_map["client_cert"] = client_cert
         if client_key:
             option_map["client_key"] = client_key
+        if timeout is not None:
+            option_map["timeout"] = timeout
     else:  # no cov
         for option in options:
             key, _, value = option.partition("=")

src/hatch/config/constants.py

@@ -26,6 +26,7 @@ class PublishEnvVars:
     CA_CERT = "HATCH_INDEX_CA_CERT"
     CLIENT_CERT = "HATCH_INDEX_CLIENT_CERT"
     CLIENT_KEY = "HATCH_INDEX_CLIENT_KEY"
+    TIMEOUT = "HATCH_INDEX_TIMEOUT"
     PUBLISHER = "HATCH_PUBLISHER"
     OPTIONS = "HATCH_PUBLISHER_OPTIONS"
 

src/hatch/index/core.py

@@ -32,7 +32,7 @@ def __init__(self, repo: str):
 
 
 class PackageIndex:
-    def __init__(self, repo: str, *, user="", auth="", ca_cert=None, client_cert=None, client_key=None):
+    def __init__(self, repo: str, *, user="", auth="", ca_cert=None, client_cert=None, client_key=None, timeout=None):
         self.urls = IndexURLs(repo)
         self.repo = str(self.urls.repo)
         self.user = user
@@ -48,6 +48,8 @@ def __init__(self, repo: str, *, user="", auth="", ca_cert=None, client_cert=Non
         if ca_cert:
             self.__verify = ca_cert
 
+        self.__timeout = timeout
+
     @cached_property
     def client(self) -> httpx.Client:
         import httpx
@@ -62,7 +64,7 @@ def client(self) -> httpx.Client:
         return httpx.Client(
             headers={"User-Agent": user_agent},
             transport=httpx.HTTPTransport(retries=3, verify=self.__verify, cert=self.__cert),
-            timeout=DEFAULT_TIMEOUT,
+            timeout=DEFAULT_TIMEOUT if self.__timeout is None else self.__timeout,
         )
 
     def upload_artifact(self, artifact: Path, data: dict):

src/hatch/publish/index.py

@@ -78,6 +78,7 @@ def publish(self, artifacts: list, options: dict):
             ca_cert=options.get("ca_cert", repo_config.get("ca-cert")),
             client_cert=options.get("client_cert", repo_config.get("client-cert")),
             client_key=options.get("client_key", repo_config.get("client-key")),
+            timeout=options.get("timeout", repo_config.get("timeout")),
         )
 
         existing_artifacts: dict[str, set[str]] = {}

tests/index/test_core.py

@@ -73,6 +73,22 @@ def test_client_cert_with_key(self, mocker):
         mock.assert_called_once_with(verify=True, cert=("foo", "bar"), trust_env=True)
 
 
+class TestTimeout:
+    def test_default(self):
+        from hatch.utils.network import DEFAULT_TIMEOUT
+
+        index = PackageIndex("https://foo.internal/a/b/")
+        client = index.client
+
+        assert client.timeout == httpx.Timeout(DEFAULT_TIMEOUT)
+
+    def test_explicit(self):
+        index = PackageIndex("https://foo.internal/a/b/", timeout=42)
+        client = index.client
+
+        assert client.timeout == httpx.Timeout(42)
+
+
 class TestUserAgent:
     def test_user_agent_header_format(self):
         index = PackageIndex("https://foo.internal/a/b/")