apisim 0.1.0__tar.gz

apisim-0.1.0/.gitignore

@@ -0,0 +1,24 @@
+.env
+.env.*
+!.env.example
+.venv/
+__pycache__/
+.pytest_cache/
+.ruff_cache/
+node_modules/
+.next/
+.data/
+artifacts/
+*.log
+.DS_Store
+.gradle/
+**/build/
+local.properties
+*.jks
+*.tsbuildinfo
+
+# Build output and local browser-test artifacts
+mcp/dist/
+.playwright-mcp/
+sdk/typescript/dist/
+sdk/python/dist/

apisim-0.1.0/PKG-INFO

@@ -0,0 +1,79 @@
+Metadata-Version: 2.5
+Name: apisim
+Version: 0.1.0
+Summary: Python client for the ApiSIM API: send SMS, place calls and read conversations through a phone you own.
+Project-URL: Homepage, https://apisim.app/docs
+Project-URL: Repository, https://github.com/ronnybru/apisim
+Project-URL: Issues, https://github.com/ronnybru/apisim/issues
+Author-email: Digital Trend AS <support@apisim.app>
+License-Expression: MIT
+Keywords: ai-agents,api,apisim,phone,sms,voice,webhooks
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Communications :: Telephony
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# apisim
+
+Python client for the [ApiSIM](https://apisim.app) API: send SMS, place calls with browser or AI
+audio, read conversations and recordings, all through an Android phone and SIM you own.
+Python 3.11+, one dependency (`httpx`).
+
+```sh
+pip install apisim
+```
+
+```python
+import os
+from apisim import ApiSim
+
+apisim = ApiSim(api_key=os.environ["APISIM_API_KEY"])
+
+line = apisim.lines.list()[0]
+op = apisim.messages.send(
+    line["id"],
+    "+15555550101",
+    "Hi Alex, can I help?",
+    idempotency_key="welcome-1042",  # one real-world message; retries with the same key never send twice
+)
+print(apisim.operations.wait_for(op["id"])["state"])  # sent | delivered | failed | uncertain
+```
+
+Outcomes are honest: `sent` is carrier acceptance, `delivered` is handset confirmation, and
+`uncertain` means the phone went quiet mid-action; reconcile before retrying with a new key.
+
+## Events and webhooks
+
+```python
+for event in apisim.events.stream(after=last_seq):
+    if event["type"] == "messages.incoming":
+        handle(event["data"])
+    last_seq = event["seq"]  # persist it
+```
+
+Or register a webhook and verify each delivery against the raw request body:
+
+```python
+from apisim import parse_webhook
+
+event = parse_webhook(
+    os.environ["APISIM_WEBHOOK_SECRET"], request.headers.get("X-Apisim-Signature"), request.body
+)
+```
+
+Delivery is at least once; deduplicate on the `X-Apisim-Event` header.
+
+## Calls
+
+```python
+call = apisim.calls.start(line["id"], "+15555550101", idempotency_key="callback-77")
+session = apisim.calls.session(call["id"])  # {"url", "token", "room"}: WebRTC credentials for your agent
+apisim.calls.end(call["id"])
+```
+
+Calling is enabled per line after a conference-capability check; recording needs `record=True`,
+`recording_notice_acknowledged=True` and credit.
+
+Full reference: https://apisim.app/docs and the OpenAPI document at https://api.apisim.app/docs.

apisim-0.1.0/README.md

@@ -0,0 +1,62 @@
+# apisim
+
+Python client for the [ApiSIM](https://apisim.app) API: send SMS, place calls with browser or AI
+audio, read conversations and recordings, all through an Android phone and SIM you own.
+Python 3.11+, one dependency (`httpx`).
+
+```sh
+pip install apisim
+```
+
+```python
+import os
+from apisim import ApiSim
+
+apisim = ApiSim(api_key=os.environ["APISIM_API_KEY"])
+
+line = apisim.lines.list()[0]
+op = apisim.messages.send(
+    line["id"],
+    "+15555550101",
+    "Hi Alex, can I help?",
+    idempotency_key="welcome-1042",  # one real-world message; retries with the same key never send twice
+)
+print(apisim.operations.wait_for(op["id"])["state"])  # sent | delivered | failed | uncertain
+```
+
+Outcomes are honest: `sent` is carrier acceptance, `delivered` is handset confirmation, and
+`uncertain` means the phone went quiet mid-action; reconcile before retrying with a new key.
+
+## Events and webhooks
+
+```python
+for event in apisim.events.stream(after=last_seq):
+    if event["type"] == "messages.incoming":
+        handle(event["data"])
+    last_seq = event["seq"]  # persist it
+```
+
+Or register a webhook and verify each delivery against the raw request body:
+
+```python
+from apisim import parse_webhook
+
+event = parse_webhook(
+    os.environ["APISIM_WEBHOOK_SECRET"], request.headers.get("X-Apisim-Signature"), request.body
+)
+```
+
+Delivery is at least once; deduplicate on the `X-Apisim-Event` header.
+
+## Calls
+
+```python
+call = apisim.calls.start(line["id"], "+15555550101", idempotency_key="callback-77")
+session = apisim.calls.session(call["id"])  # {"url", "token", "room"}: WebRTC credentials for your agent
+apisim.calls.end(call["id"])
+```
+
+Calling is enabled per line after a conference-capability check; recording needs `record=True`,
+`recording_notice_acknowledged=True` and credit.
+
+Full reference: https://apisim.app/docs and the OpenAPI document at https://api.apisim.app/docs.

apisim-0.1.0/pyproject.toml

@@ -0,0 +1,33 @@
+[project]
+name = "apisim"
+version = "0.1.0"
+description = "Python client for the ApiSIM API: send SMS, place calls and read conversations through a phone you own."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.11"
+authors = [{ name = "Digital Trend AS", email = "support@apisim.app" }]
+keywords = ["sms", "voice", "phone", "api", "ai-agents", "webhooks", "apisim"]
+classifiers = [
+  "Programming Language :: Python :: 3",
+  "Topic :: Communications :: Telephony",
+  "Typing :: Typed",
+]
+dependencies = ["httpx>=0.27"]
+
+[project.urls]
+Homepage = "https://apisim.app/docs"
+Repository = "https://github.com/ronnybru/apisim"
+Issues = "https://github.com/ronnybru/apisim/issues"
+
+[dependency-groups]
+dev = ["pytest>=8", "ruff>=0.13"]
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/apisim"]
+
+[tool.ruff]
+line-length = 110

apisim-0.1.0/src/apisim/__init__.py

@@ -0,0 +1,15 @@
+"""ApiSIM Python SDK: your business phone, connected to software.
+
+from apisim import ApiSim
+
+apisim = ApiSim(api_key=os.environ["APISIM_API_KEY"])
+line = apisim.lines.list()[0]
+op = apisim.messages.send(line["id"], "+15555550101", "Hi Alex, can I help?", idempotency_key="welcome-1042")
+print(apisim.operations.wait_for(op["id"])["state"])  # sent | delivered | failed | uncertain
+"""
+
+from .client import ApiSim, ApiSimError
+from .webhooks import parse_webhook, verify_webhook
+
+__all__ = ["ApiSim", "ApiSimError", "parse_webhook", "verify_webhook"]
+__version__ = "0.1.0"

apisim-0.1.0/src/apisim/client.py

@@ -0,0 +1,236 @@
+"""Synchronous client over httpx. Every write takes an idempotency key: one key, one real action."""
+
+from __future__ import annotations
+
+import time
+from collections.abc import Iterator
+from typing import Any, Self
+
+import httpx
+
+TERMINAL = ("sent", "delivered", "failed", "uncertain", "completed")
+
+
+class ApiSimError(Exception):
+    """An error answer from the API: `status`, the API's `detail`, and `retry_after` seconds on 429."""
+
+    def __init__(self, status: int, detail: Any, retry_after: float | None = None):
+        super().__init__(detail if isinstance(detail, str) else repr(detail))
+        self.status = status
+        self.detail = detail
+        self.retry_after = retry_after
+
+
+class ApiSim:
+    def __init__(
+        self,
+        api_key: str,
+        base_url: str = "https://api.apisim.app",
+        timeout: float = 30.0,
+        transport: httpx.BaseTransport | None = None,
+    ):
+        if not api_key:
+            raise ValueError("api_key is required (create one in the dashboard)")
+        self._http = httpx.Client(
+            base_url=base_url.rstrip("/"),
+            timeout=timeout,
+            transport=transport,
+            headers={"Authorization": f"Bearer {api_key}", "User-Agent": "apisim-sdk-python/0.1"},
+        )
+        self.lines = _Lines(self)
+        self.devices = _Devices(self)
+        self.messages = _Messages(self)
+        self.operations = _Operations(self)
+        self.calls = _Calls(self)
+        self.recordings = _Recordings(self)
+        self.events = _Events(self)
+        self.webhooks = _Webhooks(self)
+        self.keys = _Keys(self)
+        self.billing = _Billing(self)
+
+    def close(self) -> None:
+        self._http.close()
+
+    def __enter__(self) -> Self:
+        return self
+
+    def __exit__(self, *exc: object) -> None:
+        self.close()
+
+    def request(
+        self,
+        method: str,
+        path: str,
+        json: Any = None,
+        params: dict[str, Any] | None = None,
+        idempotency_key: str | None = None,
+    ) -> Any:
+        headers = {"Idempotency-Key": idempotency_key} if idempotency_key else {}
+        response = self._http.request(method, path, json=json, params=params, headers=headers)
+        try:
+            data = response.json() if response.content else {}
+        except ValueError:
+            data = response.text
+        if response.is_error:
+            detail = data.get("detail", data) if isinstance(data, dict) else data
+            retry = response.headers.get("retry-after")
+            raise ApiSimError(
+                response.status_code, detail or response.reason_phrase, float(retry) if retry else None
+            )
+        return data
+
+    def me(self) -> dict[str, Any]:
+        """Workspace identity, e-mail verification and the capabilities this deployment enables."""
+        return self.request("GET", "/v1/me")
+
+
+class _Resource:
+    def __init__(self, client: ApiSim):
+        self._c = client
+
+
+class _Lines(_Resource):
+    def list(self) -> list[dict[str, Any]]:
+        return self._c.request("GET", "/v1/lines")
+
+    def set_calling(self, line_id: str, enabled: bool, conference_confirmed: bool = False) -> dict[str, Any]:
+        """Enable calling after confirming the carrier's conference calling works on this SIM."""
+        body = {"enabled": enabled, "conference_confirmed": conference_confirmed}
+        return self._c.request("POST", f"/v1/lines/{line_id}/calling", json=body)
+
+
+class _Devices(_Resource):
+    def list(self) -> list[dict[str, Any]]:
+        return self._c.request("GET", "/v1/devices")
+
+    def disconnect(self, device_id: str) -> Any:
+        return self._c.request("DELETE", f"/v1/devices/{device_id}")
+
+
+class _Messages(_Resource):
+    def send(self, line_id: str, to: str, body: str, idempotency_key: str) -> dict[str, Any]:
+        """Queue an SMS on a line; `idempotency_key` identifies this one message and makes retries safe."""
+        payload = {"line_id": line_id, "to": to, "body": body}
+        return self._c.request("POST", "/v1/messages", json=payload, idempotency_key=idempotency_key)
+
+    def list(self) -> list[dict[str, Any]]:
+        """Scoped business conversations: replies and manual messages to numbers you have contacted."""
+        return self._c.request("GET", "/v1/messages")
+
+
+class _Operations(_Resource):
+    def list(self) -> list[dict[str, Any]]:
+        return self._c.request("GET", "/v1/operations")
+
+    def get(self, operation_id: str) -> dict[str, Any]:
+        return self._c.request("GET", f"/v1/operations/{operation_id}")
+
+    def wait_for(
+        self,
+        operation_id: str,
+        until: tuple[str, ...] = TERMINAL,
+        timeout: float = 60.0,
+        interval: float = 1.5,
+    ) -> dict[str, Any]:
+        """Poll until the operation reaches one of `until`; raises ApiSimError(408) on timeout."""
+        deadline = time.monotonic() + timeout
+        while True:
+            op = self.get(operation_id)
+            if op["state"] in until:
+                return op
+            if time.monotonic() >= deadline:
+                raise ApiSimError(408, f"operation {operation_id} still {op['state']} after timeout")
+            time.sleep(interval)
+
+
+class _Calls(_Resource):
+    def start(
+        self,
+        line_id: str,
+        to: str,
+        idempotency_key: str,
+        record: bool = False,
+        recording_notice_acknowledged: bool = False,
+    ) -> dict[str, Any]:
+        """Dial from the line through the bridge; the recipient sees the SIM's number."""
+        payload = {
+            "line_id": line_id,
+            "to": to,
+            "record": record,
+            "recording_notice_acknowledged": recording_notice_acknowledged,
+        }
+        return self._c.request("POST", "/v1/calls", json=payload, idempotency_key=idempotency_key)
+
+    def answer(self, call_id: str, record: bool = False, recording_notice_acknowledged: bool = False) -> dict:
+        body = {"record": record, "recording_notice_acknowledged": recording_notice_acknowledged}
+        return self._c.request("POST", f"/v1/calls/{call_id}/answer", json=body)
+
+    def end(self, call_id: str) -> dict[str, Any]:
+        return self._c.request("POST", f"/v1/calls/{call_id}/end", json={})
+
+    def session(self, call_id: str) -> dict[str, Any]:
+        """Short-lived WebRTC credentials (`url`, `token`, `room`) for an agent to join the call."""
+        return self._c.request("POST", f"/v1/calls/{call_id}/session", json={})
+
+    def start_recording(self, call_id: str) -> dict[str, Any]:
+        """Record at the bridge; needs record + notice acknowledgement on the call, and credit."""
+        return self._c.request("POST", f"/v1/calls/{call_id}/recording", json={})
+
+
+class _Recordings(_Resource):
+    def list(self) -> list[dict[str, Any]]:
+        return self._c.request("GET", "/v1/recordings")
+
+    def playback(self, recording_id: str) -> dict[str, Any]:
+        """Two-minute private URL (`url`, `expires_in`)."""
+        return self._c.request("GET", f"/v1/recordings/{recording_id}/playback")
+
+    def delete(self, recording_id: str) -> Any:
+        return self._c.request("DELETE", f"/v1/recordings/{recording_id}")
+
+
+class _Events(_Resource):
+    def list(self, after: int = 0) -> list[dict[str, Any]]:
+        """Up to 200 events with seq greater than `after`, in order. Persist the last seq you processed."""
+        return self._c.request("GET", "/v1/events", params={"after": after})
+
+    def stream(self, after: int = 0, interval: float = 2.0) -> Iterator[dict[str, Any]]:
+        """Yield events as they appear, resuming from `after`. Runs until the caller stops iterating."""
+        while True:
+            batch = self.list(after)
+            for event in batch:
+                after = event["seq"]
+                yield event
+            if not batch:
+                time.sleep(interval)
+
+
+class _Webhooks(_Resource):
+    def create(self, url: str) -> dict[str, Any]:
+        """The signing `secret` is returned once; keep it for verify_webhook()."""
+        return self._c.request("POST", "/v1/webhooks", json={"url": url})
+
+    def list(self) -> list[dict[str, Any]]:
+        return self._c.request("GET", "/v1/webhooks")
+
+    def delete(self, webhook_id: str) -> Any:
+        return self._c.request("DELETE", f"/v1/webhooks/{webhook_id}")
+
+
+class _Keys(_Resource):
+    def list(self) -> list[dict[str, Any]]:
+        return self._c.request("GET", "/v1/keys")
+
+    def create(self, label: str) -> dict[str, Any]:
+        return self._c.request("POST", "/v1/keys", json={"label": label})
+
+    def revoke(self, key_id: str) -> Any:
+        return self._c.request("DELETE", f"/v1/keys/{key_id}")
+
+
+class _Billing(_Resource):
+    def status(self) -> dict[str, Any]:
+        return self._c.request("GET", "/v1/billing")
+
+    def ledger(self) -> list[dict[str, Any]]:
+        return self._c.request("GET", "/v1/billing/ledger")

apisim-0.1.0/src/apisim/webhooks.py

@@ -0,0 +1,43 @@
+"""Verify ApiSIM webhook deliveries.
+
+Header `X-Apisim-Signature: t=<unix seconds>,v1=<hex>` where
+v1 = HMAC-SHA256(secret, f"{t}.{raw_body}"). Always verify against the raw request body as received,
+never re-serialised JSON. Delivery is at least once: deduplicate on the `X-Apisim-Event` header.
+"""
+
+from __future__ import annotations
+
+import hashlib
+import hmac
+import json
+import time
+from typing import Any
+
+from .client import ApiSimError
+
+
+def verify_webhook(
+    secret: str,
+    signature: str | None,
+    raw_body: bytes | str,
+    tolerance_seconds: int = 300,
+    now: float | None = None,
+) -> bool:
+    parts = dict(p.split("=", 1) for p in (signature or "").split(",") if "=" in p)
+    timestamp, given = parts.get("t"), parts.get("v1")
+    if not timestamp or not given or not timestamp.isdigit():
+        return False
+    if abs((now if now is not None else time.time()) - int(timestamp)) > tolerance_seconds:
+        return False
+    body = raw_body.encode() if isinstance(raw_body, str) else raw_body
+    expected = hmac.new(secret.encode(), timestamp.encode() + b"." + body, hashlib.sha256).hexdigest()
+    return hmac.compare_digest(expected, given.lower())
+
+
+def parse_webhook(
+    secret: str, signature: str | None, raw_body: bytes | str, tolerance_seconds: int = 300
+) -> dict[str, Any]:
+    """Verify and parse in one step; raises ApiSimError(401) when the signature is invalid or stale."""
+    if not verify_webhook(secret, signature, raw_body, tolerance_seconds):
+        raise ApiSimError(401, "invalid webhook signature")
+    return json.loads(raw_body)

apisim-0.1.0/tests/test_client.py

@@ -0,0 +1,70 @@
+import hashlib
+import hmac
+import json
+
+import httpx
+import pytest
+
+from apisim import ApiSim, ApiSimError, parse_webhook, verify_webhook
+
+
+def make_client(handler):
+    return ApiSim(api_key="sim_test", transport=httpx.MockTransport(handler))
+
+
+def test_send_carries_auth_idempotency_and_body():
+    seen = {}
+
+    def handler(request: httpx.Request):
+        seen["url"] = str(request.url)
+        seen["headers"] = request.headers
+        seen["body"] = json.loads(request.content)
+        return httpx.Response(202, json={"id": "op1", "state": "queued"})
+
+    with make_client(handler) as apisim:
+        op = apisim.messages.send("L1", "+15555550100", "hi", idempotency_key="welcome-42")
+    assert op["id"] == "op1"
+    assert seen["url"] == "https://api.apisim.app/v1/messages"
+    assert seen["headers"]["authorization"] == "Bearer sim_test"
+    assert seen["headers"]["idempotency-key"] == "welcome-42"
+    assert seen["body"] == {"line_id": "L1", "to": "+15555550100", "body": "hi"}
+
+
+def test_errors_surface_status_detail_and_retry_after():
+    def handler(request):
+        return httpx.Response(429, json={"detail": "slow down"}, headers={"retry-after": "7"})
+
+    with pytest.raises(ApiSimError) as info, make_client(handler) as apisim:
+        apisim.lines.list()
+    assert info.value.status == 429 and info.value.detail == "slow down" and info.value.retry_after == 7.0
+
+
+def test_events_cursor_and_wait_for_polls_until_terminal():
+    polls = {"n": 0}
+
+    def handler(request):
+        if request.url.path == "/v1/events":
+            assert request.url.params["after"] == "41"
+            return httpx.Response(200, json=[])
+        polls["n"] += 1
+        return httpx.Response(200, json={"id": "op1", "state": "accepted" if polls["n"] < 3 else "sent"})
+
+    with make_client(handler) as apisim:
+        assert apisim.events.list(41) == []
+        op = apisim.operations.wait_for("op1", interval=0)
+    assert op["state"] == "sent" and polls["n"] == 3
+
+
+def test_webhook_verification_uses_raw_body_and_rejects_stale_or_altered():
+    secret, t = "whsec_test", 1_730_500_000
+    raw = json.dumps({"id": "evt1", "seq": 7, "type": "sms.sent", "data": {}, "created_at": 1}).encode()
+    v1 = hmac.new(secret.encode(), f"{t}.".encode() + raw, hashlib.sha256).hexdigest()
+    signature = f"t={t},v1={v1}"
+    assert verify_webhook(secret, signature, raw, now=t + 10)
+    assert not verify_webhook(secret, signature, raw + b" ", now=t + 10)
+    assert not verify_webhook(secret, signature, raw, now=t + 301)
+    assert not verify_webhook("other", signature, raw, now=t)
+    assert not verify_webhook(secret, "garbage", raw, now=t)
+    assert parse_webhook(secret, signature, raw, tolerance_seconds=10**10)["type"] == "sms.sent"
+    with pytest.raises(ApiSimError):
+        parse_webhook(secret, signature, raw + b"x", tolerance_seconds=10**10)

apisim-0.1.0/uv.lock

@@ -0,0 +1,189 @@
+version = 1
+revision = 5
+requires-python = ">=3.11"
+
+[[package]]
+name = "anyio"
+version = "4.16.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.15'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/a1/98/7e457a3b014976887a050561955c0b76e1e7e2d6e27b78ecef2ef80518f2/anyio-4.16.0.tar.gz", hash = "sha256:59bb03251907983d1603d27c3087ddb1e93299ea2163adcdba37899a4fb12ffb", size = 310971, upload-time = "2026-11-01T11:20:07.282Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a9/16/7757fb84c819accc7d7e9af5291b261e4abb8627ee040f99e7d35ef2457a/anyio-4.16.0-py3-none-any.whl", hash = "sha256:c66ae634e0b8228396b801741beb3294326d4b6102f7bba4041c0dfb58c29026", size = 134521, upload-time = "2026-11-01T11:20:05.59Z" },
+]
+
+[[package]]
+name = "apisim"
+version = "0.1.0"
+source = { editable = "." }
+dependencies = [
+    { name = "httpx" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "ruff" },
+]
+
+[package.metadata]
+requires-dist = [{ name = "httpx", specifier = ">=0.27" }]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=8" },
+    { name = "ruff", specifier = ">=0.13" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.10.23"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fd/11/b524cbd9bbdaca58608e4cf4053fd463417549e1959fa8d3aa18319f9555/certifi-2026.10.23.tar.gz", hash = "sha256:a9895e6e2758b371e0545e321a3a8fd1fcfd9829ada8824a936dfb16aaaf36cd", size = 136225, upload-time = "2026-10-23T11:36:16.478Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/32/d1/a3652fe2c19134d0d15922177821d863cbd7e842d53a21bbe7e8e3a1b5ac/certifi-2026.10.23-py3-none-any.whl", hash = "sha256:e9b54de76e530bb6cf0ccd036787103acb58fd42ba930ea8bf948ddbaa2f61d1", size = 135082, upload-time = "2026-10-23T11:36:14.763Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.20"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f5/08/8eea9d4b8302028f3abb2c0813953f7aec26d33b7a8960ed760e65ff29fa/idna-3.20.tar.gz", hash = "sha256:a7db850025b95ded1eae8a46181a1a6c56c92c96f0e2b005d9ff8dc0210cab44", size = 216463, upload-time = "2026-09-17T14:11:04.752Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/58/a2/bb081bab032533a855d44de1d56f8e8426114ff1ba5d1f07a438a0a654f8/idna-3.20-py3-none-any.whl", hash = "sha256:ab7ae7122974553370f0bdb919e1a960b2cd1bc1ef0276416d896db81c14582c", size = 69583, upload-time = "2026-09-17T14:11:03.168Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/e1/2069291243c926a2ff1cd706c7f3eeb9b62144bf60f77c9fb9ff2fb26bd3/iniconfig-2.3.1.tar.gz", hash = "sha256:67f4b9c50da0dedf52af349e7749a80a9057a5031199791b906c3bb3ae878960", size = 21209, upload-time = "2026-10-06T22:48:38.076Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/56/43/4ca9e49d27a1fcf6bece6f6aec0ea46bb9112489b93d4b688fb415457bdb/iniconfig-2.3.1-py3-none-any.whl", hash = "sha256:9121e2c1fdb355232495be3194c8dfe87ccc2d5dee45947b78e68f499790d7a7", size = 7552, upload-time = "2026-10-06T22:48:36.959Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/7d/fa/3944b40b07da9ce895c0e6303a5ab7d53da063554f534556b134a54d6093/packaging-26.3.tar.gz", hash = "sha256:94edc256424af38762eb31306eed28beb9f0efc50a8837492c9d6fd6004aed79", size = 313412, upload-time = "2026-08-04T18:15:28.737Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/63/34/ba1c580383c9eada3711951fef0795c80b829a078d72188184bcab9dd527/packaging-26.3-py3-none-any.whl", hash = "sha256:d7193f7c8e4e93f444fde0262bf90af30e16fa0ad0ad44cb553c87339b23cd1c", size = 129956, upload-time = "2026-08-04T18:15:27.159Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/bf/db/7fc19e6f2dc92a966727031389fc2e08b558f0f25eb7403c1119ad4713cd/pluggy-1.7.0.tar.gz", hash = "sha256:d1eaa46ebb595891b860ab086b4d09c8588af65ebd4361b8e8f4bb8920b90ba8", size = 123304, upload-time = "2026-10-15T09:50:58.343Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/40/9e/2b38731e0fc536806f16490e1a12d7f0dc2a1235aa8cc07bcc75416a7daa/pluggy-1.7.0-py3-none-any.whl", hash = "sha256:7dd7b0d8832ba3cb632c306926ded123429211b83641b35dc5c41ad2d34f9bec", size = 27082, upload-time = "2026-10-15T09:50:56.808Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.21.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/49/2e/ced460408999b33da6b31b0021b0f37d329e202d4169aeb164493778f25b/pygments-2.21.0.tar.gz", hash = "sha256:610ca751c9bc2492b38eb9a38a7fbc93edbbb2d7182edaf34e66ae493dee5c8c", size = 5005329, upload-time = "2026-08-17T08:02:48.824Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/71/46/17f022dd3e953bf20a04a028a21ec746d942f8d2af30fa0f124fa0e6a684/pygments-2.21.0-py3-none-any.whl", hash = "sha256:2363c69b61c4a97c838da3b130dcd6468f4848992b21a82f2a63ec34377137d9", size = 1250147, upload-time = "2026-08-17T08:02:44.912Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.2.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/79/42/bb4641652e58dedeac2ec51abc1f8cae4fee4ec63899a0999016229a0f2a/pytest-9.2.0.tar.gz", hash = "sha256:97c4f3b1f3c7414aa36465e09b8220f1d03627993bd51b1282e193753c80557b", size = 1797555, upload-time = "2026-10-27T21:30:20.728Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/51/39/1f5d8c8877a0fa327db959c19341d4be61660de1ab6b7391f9eb805bcd67/pytest-9.2.0-py3-none-any.whl", hash = "sha256:07acdcf88ec174f907dc01af70bf52d49b014bbab03faeeade31c96b18c2e588", size = 411776, upload-time = "2026-10-27T21:30:19.131Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.17.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/59/73/81f140c4edd9cc323de5478e6bbd3bbcfae9a82692df1a258de8cec6a6d2/ruff-0.17.3.tar.gz", hash = "sha256:a57049c8addb3662073859bb55a7ad35aa54f8a7c9ed268911d1333c5aadaaa9", size = 5339444, upload-time = "2026-10-27T00:34:05.914Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9e/8c/083365310c4e79c842f25bf5a842facbd9b0c0ec336f96dffa5074fe723d/ruff-0.17.3-py3-none-linux_armv6l.whl", hash = "sha256:ab86b84cd9d05e56d329742c0cabdcbe2d1d56c98f4a04aab9b5b66196febfb4", size = 10216522, upload-time = "2026-10-27T00:33:29.822Z" },
+    { url = "https://files.pythonhosted.org/packages/72/26/4b2edf31cfebe9605d8f6ed8f1d6f376d3a53d4c9a123e62661c64c440f0/ruff-0.17.3-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:e407b4a6852853a9a2cdce96963e94ad9775578bb44e7561a0f2829f3cc04b11", size = 10217786, upload-time = "2026-10-27T00:33:33.949Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/7e/537aba4b7f54397a374d2f6a6fc93e9c8015e18553f31a4a7b7dbced48b5/ruff-0.17.3-py3-none-macosx_11_0_arm64.whl", hash = "sha256:b75cc113b3aca388933d8296b667b1ac401a80317ea3074c9b0a66541199da29", size = 9440362, upload-time = "2026-10-27T00:33:35.784Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/66/283e39734f66c8a5ebaa93c22eb7b7515779a0b1d5a5c0ad20e05c0edb41/ruff-0.17.3-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ab5fa7ed5ce18554ea69d850ad162cbaa0c85fc47c08d83a569f806681c9a6ad", size = 10094281, upload-time = "2026-10-27T00:33:38.216Z" },
+    { url = "https://files.pythonhosted.org/packages/21/4c/1ffc768497bd025a32c72152771e40c0b99bddc5cc6e4f50c7949a395346/ruff-0.17.3-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c673c170e27834d1262e3a9c1e97bdc9b9c3b180c63d89173ce69747232474c1", size = 10022543, upload-time = "2026-10-27T00:33:40.181Z" },
+    { url = "https://files.pythonhosted.org/packages/73/c3/f90db547301080fcb82c92abf914c8bd57b89911d9b65a6c4cc6b52d0635/ruff-0.17.3-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:6a754c0341bc9ca151b7b335988b3263921c08859f84ca219b70cee825571b6f", size = 10683921, upload-time = "2026-10-27T00:33:42.182Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/98/92d4a8a26c6c96cf1a5b34dd59036d8a71e52d650aab065c58867e964e63/ruff-0.17.3-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4590b9d86c0b1543ebb09094254e191cd43fe8edaf330baa035aab03da251532", size = 11373408, upload-time = "2026-10-27T00:33:44.19Z" },
+    { url = "https://files.pythonhosted.org/packages/43/02/1f24d2e3064c9753926deeb901afa57777b37ee46799b09ddd7aee6e5145/ruff-0.17.3-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bbde18beccd98c29a227c63c99022e3443b99258e08326df6425dfe0443705ef", size = 10977469, upload-time = "2026-10-27T00:33:46.179Z" },
+    { url = "https://files.pythonhosted.org/packages/f0/20/fecedea2209f574ab92033b344e01a7f0c2dc76c6d6d19a14c9f8141173f/ruff-0.17.3-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:7fa4b0f931cdbcb8a52044f370a3eb429fb42eb88807b0e800fcaa98dd42b24e", size = 10577491, upload-time = "2026-10-27T00:33:48.233Z" },
+    { url = "https://files.pythonhosted.org/packages/33/36/b93fdf0bc6f84f0cd487aadfb0354deb40013669ea35ac3d26855de1e959/ruff-0.17.3-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:39405f341deec934b4289634324ad695f72df2970f9121582872eaf5b722f0f5", size = 10608748, upload-time = "2026-10-27T00:33:50.284Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/b7/7d3f5f14145daead1efb0b9a8289ed1daa100f419d60774375951723ce00/ruff-0.17.3-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:68074094f55ca3d29ab19491f640282f7a84061c4c7977aa5094b968ca457e9a", size = 10075057, upload-time = "2026-10-27T00:33:52.074Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/ed/93ff7a5909ee56e2bd4b982deae9e0efb2724417874a90c9e41ad66c6dd7/ruff-0.17.3-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:27bb571ac78fef178fe5118d2827df95c2aae74a48fff2b15f6acd03af5ff5bb", size = 10022431, upload-time = "2026-10-27T00:33:54.061Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/07/a83b9eeec8c1c3c0e4eda15f06c3a91001bfd2687ea2f07b750719bf9712/ruff-0.17.3-py3-none-musllinux_1_2_i686.whl", hash = "sha256:029c37cbd3de48ca37aa12117bead2d065f15da17d66bf84e0d4274013705db2", size = 10394903, upload-time = "2026-10-27T00:33:56.158Z" },
+    { url = "https://files.pythonhosted.org/packages/af/b2/05c39857c2526fcbebe46ad93a8dc97424656dfef14d3ef933abe1ffd331/ruff-0.17.3-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:692fdb46d0fd9c71e380947dc5fc72f2c3f881073bc1f739e4579376231affbe", size = 10799780, upload-time = "2026-10-27T00:33:58.204Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/d9/47171a16739eb7a353936b31c20cf54340531e68c9af7d72fd7a784e235d/ruff-0.17.3-py3-none-win32.whl", hash = "sha256:46539cb031b01fd29ae0a02142483c46640b233ee12bb1c1b690bffa1555d5ca", size = 9908481, upload-time = "2026-10-27T00:34:00.087Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/a0/f08c1631bfd81faa6a90eaf70c37c786c11bed2046302b56bb506c25e1a0/ruff-0.17.3-py3-none-win_amd64.whl", hash = "sha256:56b8ffb3f3b3cbccb8b76b71b38261b7ed982ef5d20f5b447b1b61a7f4949b24", size = 10341333, upload-time = "2026-10-27T00:34:02.099Z" },
+    { url = "https://files.pythonhosted.org/packages/99/d5/4ad4ed31413c301430918e70d3d38ae6f097af0766cb9ab8c9d502b2a4d6/ruff-0.17.3-py3-none-win_arm64.whl", hash = "sha256:81fce74bcd6be0e9da7c67c7553fd0f1f12964a2052cd728ef917b937a5ca1d9", size = 9854332, upload-time = "2026-10-27T00:34:03.847Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f6/cc/6253133b5bb138fc3306cebfbda2c520f545d36b5be2c7255cc528bb45d6/typing_extensions-4.16.0.tar.gz", hash = "sha256:dc983d19a509c94dba722ee6abd33940f7c05a89e243c47e907eb4db6f1a43e5", size = 113555, upload-time = "2026-07-02T08:40:05.92Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/49/d3/b8441a820a491ddfc024b0b0cf0393375b75ea13866d9c66727e54c2fc80/typing_extensions-4.16.0-py3-none-any.whl", hash = "sha256:481caa481374e813c1b176ada14e97f1f67a4539ce9cfeb3f350d78d6370c2e8", size = 45571, upload-time = "2026-07-02T08:40:04.659Z" },
+]