swbt-python 0.1.0__tar.gz

swbt_python-0.1.0/AGENTS.md

@@ -0,0 +1,176 @@
+# swbt-python Agent Guide
+
+## 対話
+
+- ユーザとの対話は日本語で行う。
+- 技術文書と回答は事実ベースで簡潔に書く。
+- 事実、仮説、提案、未検証事項を分けて扱う。
+- 実機未検証、Bumble の挙動未確認、Bluetooth adapter や Switch firmware に依存する観測は明示する。
+
+## プロジェクト概要
+
+`swbt-python` は、Python から Nintendo Switch 向けの仮想入力デバイスを扱うためのライブラリである。
+
+主な前提は次の通り。
+
+| 種別 | 名称 |
+|---|---|
+| 公開 package | `swbt-python` |
+| Python module root | `swbt` |
+| 主要公開 class | `SwitchGamepad` |
+| 主な利用面 | Python object API |
+
+初期設計の正本は `spec/initial/` に置く。実装や仕様を変更する場合は、関連する設計文書との整合を確認する。
+
+## 初期対象
+
+- 単一の仮想 Switch 入力デバイス。
+- Pro Controller 相当の HID report。
+- button、stick、neutral 入力。
+- Switch からの主要 subcommand への応答。
+- fake transport を使う実機なしの protocol / API 検証。
+- Bumble を使う Bluetooth Classic HID Device transport。
+- 実機接続時の diagnostics と trace。
+
+初期対象外:
+
+- 常駐 daemon の再実装。
+- 既存 JSON Lines IPC の完全互換。
+- 複数 controller 同時接続。
+- amiibo、NFC、IR camera の意味的実装。
+- 高水準 rumble API。
+- GUI。
+- Switch 以外の host 対応。
+
+## アーキテクチャ境界
+
+- Public API は `SwitchGamepad` に集約する。
+- 入力状態は immutable な `InputState` として扱う。
+- periodic report 送信は `ReportLoop` が担当する。
+- Switch HID report の生成と parse は protocol 層が担当する。
+- Bumble 依存は `swbt.transport.bumble` に閉じ込める。
+- protocol core は Bumble、Bluetooth adapter、Switch 実機なしで単体テストできるようにする。
+- public API に Bumble の object 型や callback 型を露出しない。
+
+参照すべき設計文書:
+
+- `spec/initial/README.md`
+- `spec/initial/architecture.md`
+- `spec/initial/api.md`
+- `spec/initial/protocol.md`
+- `spec/initial/transport-bumble.md`
+- `spec/initial/lifecycle.md`
+- `spec/initial/testing.md`
+- `spec/initial/roadmap.md`
+- `spec/initial/risks.md`
+- `spec/initial/naming.md`
+
+## Spec / Work Tracking
+
+この repo は `spec/wip` 型を基本にしつつ、作業単位、根拠監査、TDD 状態、実機条件を仕様書内で追跡する。
+
+| 目的 | path |
+|---|---|
+| 着手中の作業仕様 | `spec/wip/unit_XXX/FEATURE_NAME.md` |
+| 完了した作業仕様 | `spec/complete/unit_XXX/FEATURE_NAME.md` |
+| 小さな観測と先送り判断 | `spec/dev-journal.md` |
+| 実機観測 | `docs/hardware-test-log.md` |
+| 初期設計 | `spec/initial/` |
+
+作業仕様には、対象範囲、対象外、関連 docs、根拠監査、TDD Test List、検証、実機実行条件、先送り事項、チェックリストを含める。
+
+複数の作業仕様から参照する安定した判断は、既存の `spec/initial/` を更新するか、必要に応じて `spec/` 配下へ分ける。未確定の観測は `spec/dev-journal.md` に置く。
+
+## Agent Skills
+
+repo-local skill は `.agents/skills` を正本として管理する。`.github/skills` には重複配置しない。
+
+主な skill:
+
+- `agentic-sdd`: `spec/initial` と `spec/wip` から次の作業単位を選び、plan、実装、gate へ進める。
+- `agentic-self-review`: 仕様変更、実装、PR 前に gate 結果と未検証リスクを整理する。
+- `spec-format`: `spec/wip` / `spec/complete` の作業仕様を作成、更新、完了移動する。
+- `dev-journal`: 小さい設計観測や先送り事項を `spec/dev-journal.md` に記録する。
+- `source-audit`: Switch HID、Bumble、既存実装、実機ログ由来の値を根拠分類して記録する。
+- `hardware-harness`: Bumble adapter、Bluetooth dongle、Switch 実機を使う検証の承認境界と記録項目を確認する。
+- `tdd-workflow`: TDD Test List から red / green / refactor を進める。
+- `tdd-test-list`: 振る舞いベースの TDD Test List を作成、更新する。
+- `tdd-one-cycle`: TDD Test List の 1 項目だけを red / green / refactor で進める。
+- `refactor-after-green`: green 後に観測可能な振る舞いを変えず構造を整える。
+- `tidy-first`: 振る舞い変更と構造変更を分ける。
+- `test-desiderata-review`: Test Desiderata に基づきテスト価値と trade-off を確認する。
+- `pr-merge-cleanup`: remote 設定後に PR 作成、merge、default branch 同期、branch cleanup を行う。
+- `pypi-release`: PyPI / TestPyPI 公開、version bump、release PR、publish workflow、公開後 smoke check を扱う。publish workflow / runbook が未整備の場合は release 実行前に停止する。
+
+## Python
+
+- Python 実行と依存管理は `uv` 経由に統一する。
+- Python script は `python ...` ではなく `uv run python ...` で実行する。
+- 依存追加は `uv add <package>`、開発依存は `uv add --dev <package>` を使う。
+- 型注釈は Python 3.12+ の構文を使う。
+- ランタイムに不要な型 import は `if TYPE_CHECKING:` に置く。
+- `from __future__ import annotations` は、実行時評価を遅延する必要がある場合だけ使う。
+
+## テストと検証
+
+標準 gate は次を基本にする。
+
+```console
+uv sync --dev
+uv run ruff format --check .
+uv run ruff check .
+uv run ty check --no-progress
+uv run pytest tests/unit
+```
+
+対象となる integration test tree がある変更では、`uv run pytest tests/integration` も実行する。対象 tree がまだない場合、該当 gate は未実行理由を報告する。
+
+pytest marker:
+
+- `@pytest.mark.bumble`: USB Bluetooth dongle と Bumble adapter open が必要な検証。
+- `@pytest.mark.hardware`: Nintendo Switch 実機、pairing、HID advertising、report loop が必要な検証。
+
+CI で必須にする対象は、static type check、lint、unit tests、fake transport integration tests とする。Bumble adapter tests と hardware tests は CI 必須にしない。
+
+## 実機安全境界
+
+次は人間の明示承認なしに実行しない。
+
+- USB Bluetooth dongle を Bumble から開く処理。
+- Switch pairing。
+- HID Device advertising。
+- periodic input report loop。
+- Switch-facing output report / subcommand handling。
+- `bumble` または `hardware` marker のテスト。
+
+実機または dongle を使う command について、環境変数による実行遮断は採用しない。承認境界は、会話上の明示承認、対象 adapter、実行する command、Switch-facing 動作の範囲、cleanup plan を確認することで管理する。
+
+実機観測には OS、driver、dongle identity、adapter string、Bumble version、Python version、Switch model / firmware、command、result、cleanup を記録する。
+
+## 根拠監査
+
+次を追加または変更する前に `source-audit` を使う。
+
+- HID descriptor bytes。
+- input / output report ID と byte layout。
+- button bit、stick packing、IMU frame。
+- subcommand ID と reply payload。
+- SPI flash address と返却 data。
+- rumble packet layout。
+- report period の default。
+- Bumble HID Device / SDP / L2CAP に関する仮定。
+- WinUSB / libusb / OS driver に関する仮定。
+
+根拠は、source fact、implementation fact、hardware observation、inference、unverified hypothesis に分ける。
+
+## Git / PR
+
+- 変更を伴う作業では開始時に branch と `git status --short` を確認する。
+- default branch への直接 commit は、ユーザの明示指示がある場合を除き避ける。
+- Conventional Commits に準拠する。
+
+```text
+<type>(<scope>): <subject>
+```
+
+type は `feat` / `fix` / `docs` / `style` / `refactor` / `perf` / `test` / `build` / `ci` / `chore` / `revert` を使う。subject は日本語で記述し、末尾句点は付けない。

swbt_python-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 niart120
+
+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.

swbt_python-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: swbt-python
+Version: 0.1.0
+Summary: Python library for presenting an NX-compatible virtual Bluetooth HID input device.
+Keywords: bluetooth,bluetooth-hid,controller,gamepad,hid,nx
+Author: niart120
+Author-email: niart120 <38847256+niart120@users.noreply.github.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 2 - Pre-Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Dist: bumble>=0.0.230,<0.0.231
+Maintainer: niart120
+Maintainer-email: niart120 <38847256+niart120@users.noreply.github.com>
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# swbt-python
+
+NX 向けの仮想 Bluetooth HID 入力デバイスを Python から扱うためのライブラリです。
+
+本ライブラリは pre-alpha 版です。実機での動作は Bluetooth adapter、driver、対象機器の firmware に依存します。
+
+## 必要なもの
+
+- Python 3.12 以降
+- uv
+- Bumble が利用可能な専用 USB Bluetooth dongle
+
+## インストール
+
+```powershell
+pip install swbt-python
+```
+
+ソースから動かす場合は次を使います。
+
+```powershell
+uv sync --dev
+```
+
+## ドキュメント
+
+[公開ドキュメント](https://niart120.github.io/swbt-python/) には API、利用例、実機準備、AI エージェント向け要約があります。
+
+- API 仕様: [API Reference](https://niart120.github.io/swbt-python/api/)
+- 利用例: [Usage Guide](https://niart120.github.io/swbt-python/usage/)
+- 実機構成と troubleshooting: [Hardware Guide](https://niart120.github.io/swbt-python/hardware/)
+- AI エージェント向け要約: [Agent Brief](https://niart120.github.io/swbt-python/agent-brief/)
+
+リポジトリを checkout している場合、同じ内容は `docs/` 配下でも確認できます。
+
+## 利用例
+
+```python
+import asyncio
+from swbt import Button, SwitchGamepad
+
+
+async def main() -> None:
+    async with SwitchGamepad(
+        adapter="usb:0",
+        key_store_path="switch-bond.json",
+    ) as pad:
+        await pad.connect(
+            timeout=30.0,
+            allow_pairing=True,
+        )
+        await pad.tap(Button.A)
+        await pad.neutral()
+
+
+asyncio.run(main())
+```
+
+この例は専用 Bluetooth adapter を使い、HID advertising、pairing または reconnect、periodic report loop、入力送信を行います。専用 USB Bluetooth dongle と接続情報のファイルパスを指定し、終了時は neutral を送ってから接続を閉じます。
+
+接続方法、`key_store_path`、入力 API の使い分けは [Usage Guide](https://niart120.github.io/swbt-python/usage/) にあります。
+
+## 実機検証
+
+実機接続には、PC の通常 Bluetooth 機能と共有しない専用 USB Bluetooth dongle と、OS ごとの driver 準備が必要です。Windows では、[Zadig](https://zadig.akeo.ie/) などで専用 dongle に WinUSB / libwdi driver を入れてから adapter 名を確認します。
+
+driver 準備、adapter 名の確認、troubleshooting は [Hardware Guide](https://niart120.github.io/swbt-python/hardware/) にあります。実機ログの正本は [hardware-test-log](https://niart120.github.io/swbt-python/hardware-test-log/) です。
+
+### 確認済み構成
+
+2026-07-04 時点では、Windows 11 / CSR8510 A10 / WinUSB / Switch 2 firmware 22.1.0 で、pairing、reconnect、Button A、D-pad、left / right stick、neutral 後の入力残りなしを確認済みです。adapter 名の例は `usb:0` です。
+
+### 試験的構成
+
+Linux / macOS は experimental です。手順は Hardware Guide に整備されていますが、動作検証されていないことに留意してください。adapter が開けるか、pairing できるか、入力が反映されるかは未確認です。
+
+CSR8510 A10 以外の Bluetooth dongle、Switch 2 firmware 22.1.0 以外の対象機器は確認済み構成に含めていません。
+
+## 開発
+
+```powershell
+uv sync --dev
+uv run ruff format --check .
+uv run ruff check .
+uv run ty check --no-progress
+uv run pytest tests/unit
+uv run pytest tests/integration
+```
+
+## ライセンス
+
+MIT ライセンスです。全文は [LICENSE](https://github.com/niart120/swbt-python/blob/main/LICENSE) にあります。
+
+## 注記
+
+このプロジェクトは、対象機器や関連商標の権利者から承認、後援、提携を受けたものではありません。

swbt_python-0.1.0/README.md

@@ -0,0 +1,96 @@
+# swbt-python
+
+NX 向けの仮想 Bluetooth HID 入力デバイスを Python から扱うためのライブラリです。
+
+本ライブラリは pre-alpha 版です。実機での動作は Bluetooth adapter、driver、対象機器の firmware に依存します。
+
+## 必要なもの
+
+- Python 3.12 以降
+- uv
+- Bumble が利用可能な専用 USB Bluetooth dongle
+
+## インストール
+
+```powershell
+pip install swbt-python
+```
+
+ソースから動かす場合は次を使います。
+
+```powershell
+uv sync --dev
+```
+
+## ドキュメント
+
+[公開ドキュメント](https://niart120.github.io/swbt-python/) には API、利用例、実機準備、AI エージェント向け要約があります。
+
+- API 仕様: [API Reference](https://niart120.github.io/swbt-python/api/)
+- 利用例: [Usage Guide](https://niart120.github.io/swbt-python/usage/)
+- 実機構成と troubleshooting: [Hardware Guide](https://niart120.github.io/swbt-python/hardware/)
+- AI エージェント向け要約: [Agent Brief](https://niart120.github.io/swbt-python/agent-brief/)
+
+リポジトリを checkout している場合、同じ内容は `docs/` 配下でも確認できます。
+
+## 利用例
+
+```python
+import asyncio
+from swbt import Button, SwitchGamepad
+
+
+async def main() -> None:
+    async with SwitchGamepad(
+        adapter="usb:0",
+        key_store_path="switch-bond.json",
+    ) as pad:
+        await pad.connect(
+            timeout=30.0,
+            allow_pairing=True,
+        )
+        await pad.tap(Button.A)
+        await pad.neutral()
+
+
+asyncio.run(main())
+```
+
+この例は専用 Bluetooth adapter を使い、HID advertising、pairing または reconnect、periodic report loop、入力送信を行います。専用 USB Bluetooth dongle と接続情報のファイルパスを指定し、終了時は neutral を送ってから接続を閉じます。
+
+接続方法、`key_store_path`、入力 API の使い分けは [Usage Guide](https://niart120.github.io/swbt-python/usage/) にあります。
+
+## 実機検証
+
+実機接続には、PC の通常 Bluetooth 機能と共有しない専用 USB Bluetooth dongle と、OS ごとの driver 準備が必要です。Windows では、[Zadig](https://zadig.akeo.ie/) などで専用 dongle に WinUSB / libwdi driver を入れてから adapter 名を確認します。
+
+driver 準備、adapter 名の確認、troubleshooting は [Hardware Guide](https://niart120.github.io/swbt-python/hardware/) にあります。実機ログの正本は [hardware-test-log](https://niart120.github.io/swbt-python/hardware-test-log/) です。
+
+### 確認済み構成
+
+2026-07-04 時点では、Windows 11 / CSR8510 A10 / WinUSB / Switch 2 firmware 22.1.0 で、pairing、reconnect、Button A、D-pad、left / right stick、neutral 後の入力残りなしを確認済みです。adapter 名の例は `usb:0` です。
+
+### 試験的構成
+
+Linux / macOS は experimental です。手順は Hardware Guide に整備されていますが、動作検証されていないことに留意してください。adapter が開けるか、pairing できるか、入力が反映されるかは未確認です。
+
+CSR8510 A10 以外の Bluetooth dongle、Switch 2 firmware 22.1.0 以外の対象機器は確認済み構成に含めていません。
+
+## 開発
+
+```powershell
+uv sync --dev
+uv run ruff format --check .
+uv run ruff check .
+uv run ty check --no-progress
+uv run pytest tests/unit
+uv run pytest tests/integration
+```
+
+## ライセンス
+
+MIT ライセンスです。全文は [LICENSE](https://github.com/niart120/swbt-python/blob/main/LICENSE) にあります。
+
+## 注記
+
+このプロジェクトは、対象機器や関連商標の権利者から承認、後援、提携を受けたものではありません。

swbt_python-0.1.0/examples/hardware_bringup.py

@@ -0,0 +1,115 @@
+"""Hardware bring-up example for a connect, tap, neutral, and close path.
+
+Running this file opens the configured Bluetooth adapter and sends input reports.
+Use it only after explicit approval covers the adapter, target screen, trace
+path, timeout, input action, and cleanup plan.
+"""
+
+import argparse
+import asyncio
+from collections.abc import Sequence
+from pathlib import Path
+from typing import TextIO
+
+from swbt import Button, DiagnosticsConfig, SwitchGamepad
+
+
+async def run(
+    *,
+    adapter: str,
+    key_store_path: str | None,
+    trace_path: Path,
+    connect_timeout: float,
+    tap_duration: float,
+) -> None:
+    """Run one approved hardware bring-up path.
+
+    Args:
+        adapter: Bumble adapter moniker, such as ``"usb:0"``.
+        key_store_path: Optional pairing key store path.
+        trace_path: JSON Lines diagnostics trace output path.
+        connect_timeout: Seconds to wait for reconnect or pairing.
+        tap_duration: Seconds to keep Button A pressed.
+    """
+    trace_path.parent.mkdir(parents=True, exist_ok=True)
+    with trace_path.open("w", encoding="utf-8") as trace_writer:
+        await _bring_up_with_trace(
+            adapter=adapter,
+            key_store_path=key_store_path,
+            connect_timeout=connect_timeout,
+            tap_duration=tap_duration,
+            trace_writer=trace_writer,
+        )
+
+
+async def _bring_up_with_trace(
+    *,
+    adapter: str,
+    key_store_path: str | None,
+    connect_timeout: float,
+    tap_duration: float,
+    trace_writer: TextIO,
+) -> None:
+    diagnostics = DiagnosticsConfig(trace_writer=trace_writer)
+    async with SwitchGamepad(
+        adapter=adapter,
+        key_store_path=key_store_path,
+        diagnostics=diagnostics,
+    ) as pad:
+        await pad.connect(
+            timeout=connect_timeout,
+            allow_pairing=True,
+        )
+        await pad.tap(Button.A, duration=tap_duration)
+        await pad.neutral()
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build the example argument parser.
+
+    Returns:
+        argparse.ArgumentParser: Parser for this example script.
+    """
+    parser = argparse.ArgumentParser(
+        description=(
+            "Run hardware bring-up after explicit approval. The approval scope must "
+            "include cleanup."
+        ),
+    )
+    parser.add_argument("--adapter", default="usb:0", help="Bumble adapter moniker")
+    parser.add_argument("--key-store", dest="key_store_path", help="pairing key store path")
+    parser.add_argument("--trace", required=True, type=Path, help="JSON Lines trace output path")
+    parser.add_argument("--timeout", default=30.0, type=float, help="connection timeout seconds")
+    parser.add_argument(
+        "--tap-duration",
+        default=0.08,
+        type=float,
+        help="Button A press duration seconds",
+    )
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Run the example.
+
+    Args:
+        argv: Optional argument vector. ``None`` reads arguments from ``sys.argv``.
+
+    Returns:
+        int: Process exit code.
+    """
+    args = build_parser().parse_args(argv)
+    asyncio.run(
+        run(
+            adapter=args.adapter,
+            key_store_path=args.key_store_path,
+            trace_path=args.trace,
+            connect_timeout=args.timeout,
+            tap_duration=args.tap_duration,
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

swbt_python-0.1.0/examples/pairing_probe.py

@@ -0,0 +1,98 @@
+"""Pairing probe example with diagnostics trace output.
+
+Running this file opens the configured Bluetooth adapter, starts HID advertising,
+and waits for a host connection. Use it only after explicit approval covers the
+adapter, target screen, trace path, timeout, and cleanup plan.
+"""
+
+import argparse
+import asyncio
+from collections.abc import Sequence
+from pathlib import Path
+from typing import TextIO
+
+from swbt import DiagnosticsConfig, SwitchGamepad
+
+
+async def run(
+    *,
+    adapter: str,
+    key_store_path: str | None,
+    trace_path: Path,
+    pair_timeout: float,
+) -> None:
+    """Run one approved pairing probe.
+
+    Args:
+        adapter: Bumble adapter moniker, such as ``"usb:0"``.
+        key_store_path: Optional pairing key store path.
+        trace_path: JSON Lines diagnostics trace output path.
+        pair_timeout: Seconds to wait for a host connection.
+    """
+    trace_path.parent.mkdir(parents=True, exist_ok=True)
+    with trace_path.open("w", encoding="utf-8") as trace_writer:
+        await _pair_with_trace(
+            adapter=adapter,
+            key_store_path=key_store_path,
+            pair_timeout=pair_timeout,
+            trace_writer=trace_writer,
+        )
+
+
+async def _pair_with_trace(
+    *,
+    adapter: str,
+    key_store_path: str | None,
+    pair_timeout: float,
+    trace_writer: TextIO,
+) -> None:
+    diagnostics = DiagnosticsConfig(trace_writer=trace_writer)
+    async with SwitchGamepad(
+        adapter=adapter,
+        key_store_path=key_store_path,
+        diagnostics=diagnostics,
+    ) as pad:
+        await pad.pair(timeout=pair_timeout)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Build the example argument parser.
+
+    Returns:
+        argparse.ArgumentParser: Parser for this example script.
+    """
+    parser = argparse.ArgumentParser(
+        description=(
+            "Run a pairing probe after explicit approval. The approval scope must include cleanup."
+        ),
+    )
+    parser.add_argument("--adapter", default="usb:0", help="Bumble adapter moniker")
+    parser.add_argument("--key-store", dest="key_store_path", help="pairing key store path")
+    parser.add_argument("--trace", required=True, type=Path, help="JSON Lines trace output path")
+    parser.add_argument("--timeout", default=30.0, type=float, help="pairing timeout seconds")
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Run the example.
+
+    Args:
+        argv: Optional argument vector. ``None`` reads arguments from ``sys.argv``.
+
+    Returns:
+        int: Process exit code.
+    """
+    args = build_parser().parse_args(argv)
+    asyncio.run(
+        run(
+            adapter=args.adapter,
+            key_store_path=args.key_store_path,
+            trace_path=args.trace,
+            pair_timeout=args.timeout,
+        )
+    )
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())