pantech 0.1.0__tar.gz

pantech-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+.env
+.DS_Store
+* 2.py
+* 2
+* 2.*
+coverage.xml
+.tox/
+.nox/

pantech-0.1.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to the `pantech` package. The newest version heading
+(`## X.Y.Z (YYYY-MM-DD)`) is released when it reaches `main`: see
+`.github/workflows/release.yml`. Put work in progress under `## Unreleased`.
+
+## 0.1.0 (2026-10-24)
+
+FEATURES:
+
+- First release of the official Python SDK for the Pantech Dynamics public API (`/public/v1`).
+- `pantech.Pantech` (blocking) and `pantech.AsyncPantech` (asyncio) clients with the same methods, as context managers.
+- Every operation in the public API, grouped by family (`client.instances`, `client.networks.subnets`, `client.kubernetes.node_pools`, `client.billing.receipts`…), with typed keyword arguments and TypedDict results in `pantech.types`.
+- `api_key` and `base_url` from arguments or `PANTECH_API_KEY` / `PANTECH_API_URL`.
+- An automatic `Idempotency-Key` on every write, reused across retries. Retries (default 3) on connection errors, timeouts, 429, 500, 502, 503 and 504 with jittered backoff and `Retry-After`; writes the API does not replay are sent once.
+- Errors as `APIError` subclasses carrying `status`, `code`, `title`, `detail`, `request_id` and field `errors`.
+- `list_all()` iterators that follow `next_cursor`, sync and async.
+- `client.operations.wait(...)`, `client.operations.stream(...)` (Server-Sent Events), and `instances.wait_for_order(...)` / `databases.wait_for_order(...)`.
+- `client.me.get()` reports the key's `kind` and `client_name`; `client.me.revoke()` revokes the calling key.
+- `pantech.verify_webhook(secret, header, body, tolerance=300)` for `Pantech-Signature`.

pantech-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pantech Dynamics
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pantech-0.1.0/PKG-INFO

@@ -0,0 +1,218 @@
+Metadata-Version: 2.5
+Name: pantech
+Version: 0.1.0
+Summary: The official Python SDK for the Pantech Dynamics public API.
+Project-URL: Homepage, https://pantechdynamics.com
+Project-URL: Documentation, https://docs.pantechdynamics.com/sdks/python
+Project-URL: Repository, https://github.com/Pantech-Dynamics/pantech-python
+Project-URL: Issues, https://github.com/Pantech-Dynamics/pantech-python/issues
+Project-URL: Changelog, https://github.com/Pantech-Dynamics/pantech-python/blob/main/CHANGELOG.md
+Author: Pantech Dynamics
+License-Expression: MIT
+License-File: LICENSE
+Keywords: api,cloud,kubernetes,pantech,pantech dynamics,sdk,vps
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: System :: Systems Administration
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx<1,>=0.25
+Description-Content-Type: text/markdown
+
+# Pantech Dynamics Python SDK
+
+[![CI](https://github.com/Pantech-Dynamics/pantech-python/actions/workflows/ci.yml/badge.svg)](https://github.com/Pantech-Dynamics/pantech-python/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/pantech.svg)](https://pypi.org/project/pantech/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+The official Python library for the [Pantech Dynamics public API](https://docs.pantechdynamics.com/api):
+instances, VPC networks, firewalls, public IPs, load balancers, volumes, snapshots, managed databases,
+managed Kubernetes, SSH keys, webhooks, billing and usage.
+
+- Sync (`Pantech`) and asyncio (`AsyncPantech`) clients with the same methods
+- Every operation in the public API, with typed keyword arguments and TypedDict results
+- Automatic `Idempotency-Key`s, safe retries, cursor pagination, operation and order waiting
+- Webhook signature verification
+- One dependency: `httpx`. Python 3.10+.
+
+Full documentation: https://docs.pantechdynamics.com/sdks/python
+
+## Install
+
+```sh
+pip install pantech
+```
+
+## Quickstart
+
+Create an API key in the console under **Organization › API keys**, then:
+
+```sh
+export PANTECH_API_KEY=PAN_...
+```
+
+```python
+import pantech
+
+with pantech.Pantech() as client:
+    me = client.me.get()
+    print("Organization", me["organization_id"])
+
+    for instance in client.instances.list_all():
+        print(instance["id"], instance["name"], instance["observed_state"])
+```
+
+### Create an instance and wait for it
+
+```python
+order = client.instances.create(
+    name="web-1",
+    plan_slug="starter",
+    image_slug="ubuntu-24-04",
+    ssh_key_id="sshk_...",
+)
+client.instances.wait_for_order(order["order_id"])  # raises OrderFailedError if it fails
+instance = client.instances.get(order["instance_id"])
+print(instance["public_ipv4"])
+```
+
+Most changes return `202 Accepted` with an operation. Wait for it:
+
+```python
+accepted = client.instances.stop("vm_...")
+client.operations.wait(accepted["operation_id"], timeout=300)  # raises OperationFailedError on failure
+```
+
+### Async
+
+```python
+import asyncio
+import pantech
+
+
+async def main() -> None:
+    async with pantech.AsyncPantech() as client:
+        async for volume in client.volumes.list_all():
+            print(volume["name"])
+
+
+asyncio.run(main())
+```
+
+### Resources
+
+Families are attributes of the client and nest where the API does:
+
+```python
+client.networks.create(name="prod", cidr="10.10.0.0/16")
+client.networks.subnets.list("net_...")
+client.networks.firewall_rules.create("snet_...", ...)
+client.public_ips.port_forwarding_rules.list("pip_...")
+client.databases.snapshots.create("db_...", name="before-migration")
+client.kubernetes.node_pools.scale("k8s_...", "k8spool_...", workers=3)
+client.catalog.list_plans(placement="vpc")
+client.billing.receipts.get_pdf("rcpt_...")  # bytes
+```
+
+Arguments are keyword-only, except the ids in the path. Optional arguments you leave out are not
+sent; passing `None` sends JSON `null`. Results are plain dicts typed with the TypedDicts in
+`pantech.types`. `client.request("GET", "/me")` calls any route directly.
+
+## Configuration
+
+| Option | Environment | Default |
+|---|---|---|
+| `api_key` | `PANTECH_API_KEY` | (required) |
+| `base_url` | `PANTECH_API_URL` | `https://api.pantechdynamics.com/public/v1` |
+| `timeout` | | 60 s per attempt (10 s to connect); a number or an `httpx.Timeout` |
+| `max_retries` | | 3 |
+| `default_headers`, `user_agent`, `http_client` | | |
+
+Every method also takes `timeout=`, `extra_headers=`, `extra_query=` and (with a body)
+`extra_body=`. Writes take `idempotency_key=`.
+
+## Retries and idempotency
+
+Every POST, PUT, PATCH and DELETE gets a fresh UUIDv4 `Idempotency-Key`, and retries resend the
+same key, so the API returns the first result instead of repeating the change. Connection errors,
+timeouts, `429`, `500`, `502`, `503` and `504` are retried up to `max_retries` times with jittered
+exponential backoff, or after the `Retry-After` the API sends.
+
+A few writes are not replayed by the API, so the SDK sends them once and retries only a `429`:
+creating and deleting SSH keys, opening a console, issuing a volume key credential, revoking the
+calling key (`client.me.revoke()`), and the webhook test, delete, secret rotation and redelivery calls.
+
+## Errors
+
+```python
+try:
+    client.networks.subnets.get("snet_...")
+except pantech.NotFoundError as err:
+    print(err.detail, err.request_id)
+except pantech.ValidationError as err:
+    for field in err.errors:
+        print(field["field"], field["code"], field["message"])
+except pantech.APIError as err:
+    print(err.status, err.code, err.detail)
+```
+
+`APIError` carries `status`, `code` (stable: branch on it), `title`, `detail` (safe to show),
+`request_id` (quote it to support) and `errors`. Subclasses: `BadRequestError` (400),
+`AuthenticationError` (401), `PaymentRequiredError` (402), `PermissionDeniedError` (403),
+`NotFoundError` (404), `ConflictError` (409), `ValidationError` (422), `RateLimitError` (429),
+`InternalServerError` (5xx). No answer at all is `APIConnectionError` (or `APITimeoutError`).
+Waiting raises `OperationFailedError`, `OrderFailedError` or `WaitTimeoutError`. All of them are
+`PantechError`.
+
+## Webhooks
+
+```python
+import pantech
+
+
+def handle(headers, raw_body: bytes) -> None:
+    pantech.verify_webhook(
+        secret="whsec_...",
+        header=headers.get("Pantech-Signature"),
+        body=raw_body,  # the raw bytes, before JSON parsing
+        tolerance=300,  # seconds; the default
+    )  # raises WebhookVerificationError
+```
+
+The comparison is constant-time, and any of several `v1` signatures may match (there are two for
+24 hours after a secret rotation). See `examples/webhook_server.py`.
+
+## Examples
+
+- [`examples/create_instance.py`](examples/create_instance.py): order an instance and wait for it
+- [`examples/async_list.py`](examples/async_list.py): concurrent listing with `AsyncPantech`
+- [`examples/webhook_server.py`](examples/webhook_server.py): a verified webhook receiver on `http.server`
+
+## Development
+
+```sh
+python3 -m venv .venv && .venv/bin/pip install -e . pytest pytest-asyncio mypy ruff pyyaml types-PyYAML
+.venv/bin/python scripts/sync_spec.py   # download the published spec into openapi/public-api.yaml
+.venv/bin/python scripts/generate_types.py && .venv/bin/python scripts/generate_resources.py
+.venv/bin/ruff check . && .venv/bin/mypy && .venv/bin/pytest -q
+```
+
+The SDK is generated from the published [OpenAPI spec](https://docs.pantechdynamics.com/openapi/public-api.yaml).
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the workflow and how releases are made. Report security
+issues as described in [SECURITY.md](SECURITY.md).
+
+## License
+
+MIT. See [LICENSE](LICENSE).

pantech-0.1.0/README.md

@@ -0,0 +1,185 @@
+# Pantech Dynamics Python SDK
+
+[![CI](https://github.com/Pantech-Dynamics/pantech-python/actions/workflows/ci.yml/badge.svg)](https://github.com/Pantech-Dynamics/pantech-python/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/pantech.svg)](https://pypi.org/project/pantech/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+The official Python library for the [Pantech Dynamics public API](https://docs.pantechdynamics.com/api):
+instances, VPC networks, firewalls, public IPs, load balancers, volumes, snapshots, managed databases,
+managed Kubernetes, SSH keys, webhooks, billing and usage.
+
+- Sync (`Pantech`) and asyncio (`AsyncPantech`) clients with the same methods
+- Every operation in the public API, with typed keyword arguments and TypedDict results
+- Automatic `Idempotency-Key`s, safe retries, cursor pagination, operation and order waiting
+- Webhook signature verification
+- One dependency: `httpx`. Python 3.10+.
+
+Full documentation: https://docs.pantechdynamics.com/sdks/python
+
+## Install
+
+```sh
+pip install pantech
+```
+
+## Quickstart
+
+Create an API key in the console under **Organization › API keys**, then:
+
+```sh
+export PANTECH_API_KEY=PAN_...
+```
+
+```python
+import pantech
+
+with pantech.Pantech() as client:
+    me = client.me.get()
+    print("Organization", me["organization_id"])
+
+    for instance in client.instances.list_all():
+        print(instance["id"], instance["name"], instance["observed_state"])
+```
+
+### Create an instance and wait for it
+
+```python
+order = client.instances.create(
+    name="web-1",
+    plan_slug="starter",
+    image_slug="ubuntu-24-04",
+    ssh_key_id="sshk_...",
+)
+client.instances.wait_for_order(order["order_id"])  # raises OrderFailedError if it fails
+instance = client.instances.get(order["instance_id"])
+print(instance["public_ipv4"])
+```
+
+Most changes return `202 Accepted` with an operation. Wait for it:
+
+```python
+accepted = client.instances.stop("vm_...")
+client.operations.wait(accepted["operation_id"], timeout=300)  # raises OperationFailedError on failure
+```
+
+### Async
+
+```python
+import asyncio
+import pantech
+
+
+async def main() -> None:
+    async with pantech.AsyncPantech() as client:
+        async for volume in client.volumes.list_all():
+            print(volume["name"])
+
+
+asyncio.run(main())
+```
+
+### Resources
+
+Families are attributes of the client and nest where the API does:
+
+```python
+client.networks.create(name="prod", cidr="10.10.0.0/16")
+client.networks.subnets.list("net_...")
+client.networks.firewall_rules.create("snet_...", ...)
+client.public_ips.port_forwarding_rules.list("pip_...")
+client.databases.snapshots.create("db_...", name="before-migration")
+client.kubernetes.node_pools.scale("k8s_...", "k8spool_...", workers=3)
+client.catalog.list_plans(placement="vpc")
+client.billing.receipts.get_pdf("rcpt_...")  # bytes
+```
+
+Arguments are keyword-only, except the ids in the path. Optional arguments you leave out are not
+sent; passing `None` sends JSON `null`. Results are plain dicts typed with the TypedDicts in
+`pantech.types`. `client.request("GET", "/me")` calls any route directly.
+
+## Configuration
+
+| Option | Environment | Default |
+|---|---|---|
+| `api_key` | `PANTECH_API_KEY` | (required) |
+| `base_url` | `PANTECH_API_URL` | `https://api.pantechdynamics.com/public/v1` |
+| `timeout` | | 60 s per attempt (10 s to connect); a number or an `httpx.Timeout` |
+| `max_retries` | | 3 |
+| `default_headers`, `user_agent`, `http_client` | | |
+
+Every method also takes `timeout=`, `extra_headers=`, `extra_query=` and (with a body)
+`extra_body=`. Writes take `idempotency_key=`.
+
+## Retries and idempotency
+
+Every POST, PUT, PATCH and DELETE gets a fresh UUIDv4 `Idempotency-Key`, and retries resend the
+same key, so the API returns the first result instead of repeating the change. Connection errors,
+timeouts, `429`, `500`, `502`, `503` and `504` are retried up to `max_retries` times with jittered
+exponential backoff, or after the `Retry-After` the API sends.
+
+A few writes are not replayed by the API, so the SDK sends them once and retries only a `429`:
+creating and deleting SSH keys, opening a console, issuing a volume key credential, revoking the
+calling key (`client.me.revoke()`), and the webhook test, delete, secret rotation and redelivery calls.
+
+## Errors
+
+```python
+try:
+    client.networks.subnets.get("snet_...")
+except pantech.NotFoundError as err:
+    print(err.detail, err.request_id)
+except pantech.ValidationError as err:
+    for field in err.errors:
+        print(field["field"], field["code"], field["message"])
+except pantech.APIError as err:
+    print(err.status, err.code, err.detail)
+```
+
+`APIError` carries `status`, `code` (stable: branch on it), `title`, `detail` (safe to show),
+`request_id` (quote it to support) and `errors`. Subclasses: `BadRequestError` (400),
+`AuthenticationError` (401), `PaymentRequiredError` (402), `PermissionDeniedError` (403),
+`NotFoundError` (404), `ConflictError` (409), `ValidationError` (422), `RateLimitError` (429),
+`InternalServerError` (5xx). No answer at all is `APIConnectionError` (or `APITimeoutError`).
+Waiting raises `OperationFailedError`, `OrderFailedError` or `WaitTimeoutError`. All of them are
+`PantechError`.
+
+## Webhooks
+
+```python
+import pantech
+
+
+def handle(headers, raw_body: bytes) -> None:
+    pantech.verify_webhook(
+        secret="whsec_...",
+        header=headers.get("Pantech-Signature"),
+        body=raw_body,  # the raw bytes, before JSON parsing
+        tolerance=300,  # seconds; the default
+    )  # raises WebhookVerificationError
+```
+
+The comparison is constant-time, and any of several `v1` signatures may match (there are two for
+24 hours after a secret rotation). See `examples/webhook_server.py`.
+
+## Examples
+
+- [`examples/create_instance.py`](examples/create_instance.py): order an instance and wait for it
+- [`examples/async_list.py`](examples/async_list.py): concurrent listing with `AsyncPantech`
+- [`examples/webhook_server.py`](examples/webhook_server.py): a verified webhook receiver on `http.server`
+
+## Development
+
+```sh
+python3 -m venv .venv && .venv/bin/pip install -e . pytest pytest-asyncio mypy ruff pyyaml types-PyYAML
+.venv/bin/python scripts/sync_spec.py   # download the published spec into openapi/public-api.yaml
+.venv/bin/python scripts/generate_types.py && .venv/bin/python scripts/generate_resources.py
+.venv/bin/ruff check . && .venv/bin/mypy && .venv/bin/pytest -q
+```
+
+The SDK is generated from the published [OpenAPI spec](https://docs.pantechdynamics.com/openapi/public-api.yaml).
+See [CONTRIBUTING.md](CONTRIBUTING.md) for the workflow and how releases are made. Report security
+issues as described in [SECURITY.md](SECURITY.md).
+
+## License
+
+MIT. See [LICENSE](LICENSE).

pantech-0.1.0/examples/async_list.py

@@ -0,0 +1,35 @@
+"""List instances and volumes concurrently with the asyncio client.
+
+export PANTECH_API_KEY=PAN_...
+python examples/async_list.py
+"""
+
+from __future__ import annotations
+
+import asyncio
+
+import pantech
+
+
+async def main() -> None:
+    async with pantech.AsyncPantech() as client:
+        me, instances, volumes = await asyncio.gather(
+            client.me.get(),
+            collect(client.instances.list_all()),
+            collect(client.volumes.list_all()),
+        )
+        print(f"Organization {me['organization_id']}")
+        print(f"{len(instances)} instances:")
+        for inst in instances:
+            print(f"  {inst['id']}  {inst['name']:<24} {inst.get('observed_state', '')}")
+        print(f"{len(volumes)} volumes:")
+        for vol in volumes:
+            print(f"  {vol['id']}  {vol['name']:<24} {vol.get('size_gb', '')} GB")
+
+
+async def collect(items):  # type: ignore[no-untyped-def]
+    return [item async for item in items]
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

pantech-0.1.0/examples/create_instance.py

@@ -0,0 +1,55 @@
+"""Create an instance, wait until it runs, and print its address.
+
+    export PANTECH_API_KEY=PAN_...
+    python examples/create_instance.py web-1 --plan starter --image ubuntu-24-04 --ssh-key sshk_...
+
+Creating an instance costs money: the order is paid from your credit.
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+
+import pantech
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)
+    parser.add_argument("name")
+    parser.add_argument("--plan", default="starter", help="a plan slug from catalog.list_plans()")
+    parser.add_argument("--image", default="ubuntu-24-04", help="an image slug from catalog.list_images()")
+    parser.add_argument("--ssh-key", required=True, help="an SSH key id (sshk_...) from ssh_keys.list()")
+    parser.add_argument("--region", default=None)
+    args = parser.parse_args()
+
+    with pantech.Pantech() as client:
+        try:
+            order = client.instances.create(
+                name=args.name,
+                plan_slug=args.plan,
+                image_slug=args.image,
+                ssh_key_id=args.ssh_key,
+                region=args.region or pantech.NOT_GIVEN,
+            )
+            print(f"Ordered {order['instance_id']} (order {order['order_id']}), waiting for it to be provisioned...")
+            client.instances.wait_for_order(order["order_id"], timeout=900)
+            instance = client.instances.get(order["instance_id"])
+        except pantech.ValidationError as err:
+            for field in err.errors:
+                print(f"{field['field']}: {field['message']}", file=sys.stderr)
+            return 1
+        except pantech.APIError as err:
+            print(f"{err.detail or err.title} (request_id: {err.request_id})", file=sys.stderr)
+            return 1
+        except pantech.PantechError as err:
+            print(err, file=sys.stderr)
+            return 1
+
+    address = instance.get("public_ipv4") or instance.get("private_ipv4")
+    print(f"{instance['name']} is {instance.get('observed_state')} at {address}")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())

pantech-0.1.0/examples/webhook_server.py

@@ -0,0 +1,59 @@
+"""A webhook receiver on the standard library's http.server.
+
+    export PANTECH_WEBHOOK_SECRET=whsec_...
+    python examples/webhook_server.py 8000
+
+Point a webhook at https://<your host>/pantech (behind TLS in production).
+Each delivery is verified against its raw body before it is trusted; a bad
+signature gets 400 and Pantech retries later.
+"""
+
+from __future__ import annotations
+
+import json
+import os
+import sys
+from http.server import BaseHTTPRequestHandler, HTTPServer
+from typing import Set
+
+import pantech
+
+SECRET = os.environ.get("PANTECH_WEBHOOK_SECRET", "")
+seen_events: Set[str] = set()  # deduplicate on the event id: deliveries can repeat
+
+
+class Handler(BaseHTTPRequestHandler):
+    def do_POST(self) -> None:
+        if self.path != "/pantech":
+            self.send_error(404)
+            return
+        length = int(self.headers.get("Content-Length") or 0)
+        body = self.rfile.read(length)  # the raw bytes, exactly as signed
+        try:
+            pantech.verify_webhook(SECRET, self.headers.get(pantech.SIGNATURE_HEADER), body)
+        except pantech.WebhookVerificationError as err:
+            self.send_error(400, str(err))
+            return
+
+        event = json.loads(body)
+        if event.get("id") not in seen_events:
+            seen_events.add(event.get("id"))
+            print(f"{self.headers.get('Pantech-Event-Type')}: {event.get('id')}")
+        # Answer 2xx within 10 seconds; do slow work after responding.
+        self.send_response(204)
+        self.end_headers()
+
+    def log_message(self, format: str, *args: object) -> None:  # quieter than the default
+        pass
+
+
+def main() -> None:
+    if not SECRET:
+        sys.exit("Set PANTECH_WEBHOOK_SECRET to the webhook's signing secret.")
+    port = int(sys.argv[1]) if len(sys.argv) > 1 else 8000
+    print(f"Listening on http://0.0.0.0:{port}/pantech")
+    HTTPServer(("0.0.0.0", port), Handler).serve_forever()
+
+
+if __name__ == "__main__":
+    main()