feat: add sync and async client APIs

CHANGELOG.md

@@ -4,6 +4,8 @@
 
 - Bump the uv version used in GitHub Actions from 0.9.8 to 0.11.33 so that the
   CI can parse the relative `exclude-newer` value in `pyproject.toml`.
+- Add paired synchronous and asynchronous client APIs, including flavor-specific
+  async clients and optional HTTPX client injection.
 - Fix Sphinx autodoc imports for Pydantic-backed submission types.
 - Add complete static typing across the SDK and tests, with typed single and batch
   submission return values.

docs/source/api/clients.rst

@@ -35,3 +35,41 @@ Clients Module
 
 .. autoclass:: judge0.clients.RapidJudge0ExtraCE
     :show-inheritance:
+
+.. autoclass:: judge0.clients.AsyncClient
+    :exclude-members: API_KEY_ENV
+
+.. autoclass:: judge0.clients.AsyncATD
+    :show-inheritance:
+
+.. autoclass:: judge0.clients.AsyncATDJudge0CE
+    :show-inheritance:
+    :exclude-members: DEFAULT_ENDPOINT, DEFAULT_HOST, HOME_URL, DEFAULT_ABOUT_ENDPOINT,
+                      DEFAULT_CONFIG_INFO_ENDPOINT, DEFAULT_LANGUAGE_ENDPOINT, DEFAULT_LANGUAGES_ENDPOINT,
+                      DEFAULT_STATUSES_ENDPOINT, DEFAULT_CREATE_SUBMISSION_ENDPOINT, DEFAULT_GET_SUBMISSION_ENDPOINT,
+                      DEFAULT_CREATE_SUBMISSIONS_ENDPOINT, DEFAULT_GET_SUBMISSIONS_ENDPOINT
+
+.. autoclass:: judge0.clients.AsyncATDJudge0ExtraCE
+    :show-inheritance:
+    :exclude-members: DEFAULT_ENDPOINT, DEFAULT_HOST, HOME_URL, DEFAULT_ABOUT_ENDPOINT,
+                      DEFAULT_CONFIG_INFO_ENDPOINT, DEFAULT_LANGUAGE_ENDPOINT, DEFAULT_LANGUAGES_ENDPOINT,
+                      DEFAULT_STATUSES_ENDPOINT, DEFAULT_CREATE_SUBMISSION_ENDPOINT, DEFAULT_GET_SUBMISSION_ENDPOINT,
+                      DEFAULT_CREATE_SUBMISSIONS_ENDPOINT, DEFAULT_GET_SUBMISSIONS_ENDPOINT
+
+.. autoclass:: judge0.clients.AsyncRapid
+    :show-inheritance:
+
+.. autoclass:: judge0.clients.AsyncRapidJudge0CE
+    :show-inheritance:
+
+.. autoclass:: judge0.clients.AsyncRapidJudge0ExtraCE
+    :show-inheritance:
+
+.. autoclass:: judge0.clients.AsyncJudge0Cloud
+    :show-inheritance:
+
+.. autoclass:: judge0.clients.AsyncJudge0CloudCE
+    :show-inheritance:
+
+.. autoclass:: judge0.clients.AsyncJudge0CloudExtraCE
+    :show-inheritance:

src/judge0/__init__.py

@@ -17,6 +17,16 @@
     ATD,
     ATDJudge0CE,
     ATDJudge0ExtraCE,
+    AsyncATD,
+    AsyncATDJudge0CE,
+    AsyncATDJudge0ExtraCE,
+    AsyncClient,
+    AsyncJudge0Cloud,
+    AsyncJudge0CloudCE,
+    AsyncJudge0CloudExtraCE,
+    AsyncRapid,
+    AsyncRapidJudge0CE,
+    AsyncRapidJudge0ExtraCE,
     Client,
     Judge0Cloud,
     Judge0CloudCE,
@@ -36,6 +46,16 @@
     "ATD",
     "ATDJudge0CE",
     "ATDJudge0ExtraCE",
+    "AsyncATD",
+    "AsyncATDJudge0CE",
+    "AsyncATDJudge0ExtraCE",
+    "AsyncClient",
+    "AsyncJudge0Cloud",
+    "AsyncJudge0CloudCE",
+    "AsyncJudge0CloudExtraCE",
+    "AsyncRapid",
+    "AsyncRapidJudge0CE",
+    "AsyncRapidJudge0ExtraCE",
     "Client",
     "File",
     "Filesystem",