fix: add ApiClient.close() and release v0.2.2

Add RESTClientObject.close() and ApiClient.close() so callers can release
urllib3 pools safely. Patch regen workflow to preserve the lifecycle hooks.

Author: eddietejeda

.github/workflows/regenerate.yml

@@ -110,6 +110,9 @@ jobs:
           p.write_text(src)
           PY
 
+      - name: Patch ApiClient close lifecycle
+        run: python3 scripts/patch_api_client_close.py
+
       - name: Clean up generated artifacts
         run: |
           rm -f openapi.yaml

CHANGELOG.md

@@ -7,6 +7,12 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.2.2] - 2026-05-20
+
+### Fixed
+
+- Add `ApiClient.close()` and `RESTClientObject.close()` so callers can release urllib3 connection pools and use context managers safely.
+
 ## [0.2.1] - 2026-05-20
 
 ### Changed

hotdata/api_client.py

@@ -97,8 +97,12 @@ def __init__(
     def __enter__(self):
         return self
 
+    def close(self) -> None:
+        if self.rest_client is not None:
+            self.rest_client.close()
+
     def __exit__(self, exc_type, exc_value, traceback):
-        pass
+        self.close()
 
     @property
     def user_agent(self):

hotdata/rest.py

@@ -118,6 +118,10 @@ def __init__(self, configuration) -> None:
         else:
             self.pool_manager = urllib3.PoolManager(**pool_args)
 
+    def close(self) -> None:
+        if self.pool_manager is not None:
+            self.pool_manager.clear()
+
     def request(
         self,
         method,

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "hotdata"
-version = "0.2.1"
+version = "0.2.2"
 description = "Hotdata API"
 authors = [
   {name = "Hotdata",email = "developers@hotdata.dev"},

scripts/patch_api_client_close.py

@@ -0,0 +1,61 @@
+#!/usr/bin/env python3
+"""Re-apply ApiClient.close() after OpenAPI regeneration."""
+
+from __future__ import annotations
+
+import pathlib
+import sys
+
+ROOT = pathlib.Path(__file__).resolve().parents[1]
+
+
+def patch_rest_client() -> None:
+    path = ROOT / "hotdata" / "rest.py"
+    src = path.read_text()
+    needle = "            self.pool_manager = urllib3.PoolManager(**pool_args)\n\n    def request("
+    insert = (
+        "            self.pool_manager = urllib3.PoolManager(**pool_args)\n\n"
+        "    def close(self) -> None:\n"
+        "        if self.pool_manager is not None:\n"
+        "            self.pool_manager.clear()\n\n"
+        "    def request("
+    )
+    if "def close(self) -> None:" in src and "pool_manager.clear()" in src:
+        return
+    if needle not in src:
+        sys.exit(f"Failed to patch {path}: RESTClientObject anchor not found")
+    path.write_text(src.replace(needle, insert, 1))
+
+
+def patch_api_client() -> None:
+    path = ROOT / "hotdata" / "api_client.py"
+    src = path.read_text()
+    needle = (
+        "    def __enter__(self):\n"
+        "        return self\n\n"
+        "    def __exit__(self, exc_type, exc_value, traceback):\n"
+        "        pass\n"
+    )
+    replacement = (
+        "    def __enter__(self):\n"
+        "        return self\n\n"
+        "    def close(self) -> None:\n"
+        "        if self.rest_client is not None:\n"
+        "            self.rest_client.close()\n\n"
+        "    def __exit__(self, exc_type, exc_value, traceback):\n"
+        "        self.close()\n"
+    )
+    if "def close(self) -> None:" in src and "self.rest_client.close()" in src:
+        return
+    if needle not in src:
+        sys.exit(f"Failed to patch {path}: ApiClient context manager anchor not found")
+    path.write_text(src.replace(needle, replacement, 1))
+
+
+def main() -> None:
+    patch_rest_client()
+    patch_api_client()
+
+
+if __name__ == "__main__":
+    main()

test/test_api_client_close.py

@@ -0,0 +1,28 @@
+import unittest
+
+from hotdata import ApiClient
+
+
+class TestApiClientClose(unittest.TestCase):
+    def test_close_does_not_raise(self) -> None:
+        client = ApiClient()
+        client.close()
+
+    def test_context_manager_calls_close(self) -> None:
+        client = ApiClient()
+        called = False
+        original_close = client.rest_client.close
+
+        def tracked_close() -> None:
+            nonlocal called
+            called = True
+            original_close()
+
+        client.rest_client.close = tracked_close
+        with client:
+            pass
+        self.assertTrue(called)
+
+
+if __name__ == "__main__":
+    unittest.main()