py2hackCraft2 1.1.44__tar.gz → 1.2.1__tar.gz

{py2hackcraft2-1.1.44 → py2hackcraft2-1.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py2hackCraft2
-Version: 1.1.44
+Version: 1.2.1
 Summary: Python client library for hackCraft2
 Home-page: https://github.com/0x48lab/hackCraft2-python
 Author: masafumi_t
@@ -65,6 +65,20 @@ entity.set_event_area(Volume.local(10, 10, 10, -10, -10, -10))
 # その他の操作...
 ```
 
+### セキュア(wss)接続（Colab / リモート）
+
+Google Colab などから、HTTPS 公開トンネル（Cloudflare 等）越しに動いているサーバーへ接続する場合は `secure=True` を指定します。`port` を省略すると標準TLSポート(443)を使用します。
+
+```python
+# 公開サーバーへ wss 接続
+player.login("your-tunnel.example.com", secure=True)
+
+# 自己署名証明書や自前トンネルで証明書検証を無効化する場合（自己責任）
+player.login("self-hosted.example.com", secure=True, verify_ssl=False)
+```
+
+ローカルサーバーへは従来どおり `player.login("localhost", 25570)` で接続できます（後方互換）。
+
 ## ライセンス
 
 MIT License

{py2hackcraft2-1.1.44 → py2hackcraft2-1.2.1}/README.md

@@ -38,6 +38,20 @@ entity.set_event_area(Volume.local(10, 10, 10, -10, -10, -10))
 # その他の操作...
 ```
 
+### セキュア(wss)接続（Colab / リモート）
+
+Google Colab などから、HTTPS 公開トンネル（Cloudflare 等）越しに動いているサーバーへ接続する場合は `secure=True` を指定します。`port` を省略すると標準TLSポート(443)を使用します。
+
+```python
+# 公開サーバーへ wss 接続
+player.login("your-tunnel.example.com", secure=True)
+
+# 自己署名証明書や自前トンネルで証明書検証を無効化する場合（自己責任）
+player.login("self-hosted.example.com", secure=True, verify_ssl=False)
+```
+
+ローカルサーバーへは従来どおり `player.login("localhost", 25570)` で接続できます（後方互換）。
+
 ## ライセンス
 
 MIT License

{py2hackcraft2-1.1.44 → py2hackcraft2-1.2.1}/py2hackCraft/modules.py

@@ -3,9 +3,45 @@ import threading
 import time
 import json
 import logging
+import ssl
+import functools
 from dataclasses import dataclass
 from typing import Callable, Any, List, Optional, NamedTuple
 
+# 標準のTLS(セキュアWebSocket)ポート
+DEFAULT_SECURE_PORT = 443
+
+# 接続確立を待つ上限秒数（到達不能・TLS不一致時に無限待機しないため）
+CONNECT_TIMEOUT_SECONDS = 15
+
+
+class ConnectionTimeoutError(Exception):
+    """接続確立が制限時間内に完了しなかったことを示す例外"""
+    pass
+
+
+def build_ws_url(host: str, port: Optional[int], secure: bool) -> str:
+    """接続先 WebSocket URL を組み立てる（副作用なし）。
+
+    - secure=True: ``wss://{host}:{port or 443}/ws``
+    - secure=False: ``ws://{host}:{port}/ws``（従来どおり）
+    """
+    scheme = "wss" if secure else "ws"
+    if secure and port is None:
+        port = DEFAULT_SECURE_PORT
+    return "%s://%s:%d/ws" % (scheme, host, port)
+
+
+def build_sslopt(secure: bool, verify_ssl: bool) -> Optional[dict]:
+    """run_forever に渡す sslopt を組み立てる（副作用なし）。
+
+    セキュア接続で証明書検証を無効化する場合のみ ``{"cert_reqs": ssl.CERT_NONE}``。
+    それ以外（非セキュア / 既定検証）は None（websocket-client の既定挙動に委ねる）。
+    """
+    if secure and not verify_ssl:
+        return {"cert_reqs": ssl.CERT_NONE}
+    return None
+
 def str_to_bool(s):
     """
     文字列をブール値に変換する
@@ -44,10 +80,11 @@ class _WebSocketClient:
         self.response_event = threading.Event()
         self.callbacks = {}
 
-    def connect(self, host: str, port: int):
+    def connect(self, host: str, port: Optional[int] = None,
+                secure: bool = False, verify_ssl: bool = True):
         self.host = host
         self.port = port
-        self.url = "ws://%s:%d/ws" % (host, port)
+        self.url = build_ws_url(host, port, secure)
         logging.debug("connecting '%s'" % (self.url))
         self.connected = False
         self.ws = websocket.WebSocketApp(self.url,
@@ -55,7 +92,10 @@ class _WebSocketClient:
                                        on_error=self._on_error,
                                        on_close=self._on_close)
         self.ws.on_open = self._on_open
-        self.thread = threading.Thread(target=self.ws.run_forever)
+        # セキュア接続で証明書検証を無効化する場合のみ sslopt を渡す（None なら既定挙動）
+        run_forever = functools.partial(self.ws.run_forever,
+                                        sslopt=build_sslopt(secure, verify_ssl))
+        self.thread = threading.Thread(target=run_forever)
         self.thread.daemon = True
         self._run_forever()
 
@@ -118,8 +158,16 @@ class _WebSocketClient:
     def _run_forever(self):
         self.thread.start()
 
-    def _wait_for_connection(self):
+    def _wait_for_connection(self, timeout: float = CONNECT_TIMEOUT_SECONDS):
+        # 一定時間内に接続が確立しない場合は例外を送出し、無限待機を避ける
+        deadline = time.monotonic() + timeout
         while not self.connected:
+            if time.monotonic() >= deadline:
+                raise ConnectionTimeoutError(
+                    "接続を確立できませんでした（%s に %d 秒以内に接続できませんでした）。"
+                    "ホスト/ポート、secure 指定、TLS証明書の検証設定を確認してください。"
+                    % (getattr(self, "url", "?"), int(timeout))
+                )
             time.sleep(0.1)
 
 
@@ -193,12 +241,16 @@ class Location:
             - "~": 相対座標 (例: ~10, ~0, ~-5)
 
             - "^": ローカル座標 (例: ^0, ^5, ^0)
+        yaw (float): 水平方向の向き（デフォルトは0）
+        pitch (float): 垂直方向の向き（デフォルトは0）
     """
     x: int
     y: int
     z: int
     world: str = "world"
     cord: str = ""  # デフォルトは絶対座標
+    yaw: float = 0
+    pitch: float = 0
 
 class LocationFactory:
     """
@@ -444,9 +496,18 @@ class Player:
     def __init__(self, player: str):
         self.name = player
 
-    def login(self, host: str, port: int) -> 'Player':
+    def login(self, host: str, port: Optional[int] = None, *,
+              secure: bool = False, verify_ssl: bool = True) -> 'Player':
+        """サーバーにログインする。
+
+        Args:
+            host: サーバーのホスト名 / IP / 公開トンネルのドメイン
+            port: ポート番号。secure=True で省略した場合は標準TLSポート(443)を使用
+            secure: True で wss（TLS暗号化）接続。Colab 等から公開サーバーへ接続する場合に使用
+            verify_ssl: secure=True 時のTLS証明書検証。自己署名/自前トンネル向けに False で無効化可能
+        """
         self.client = _WebSocketClient()
-        self.client.connect(host, port)
+        self.client.connect(host, port, secure=secure, verify_ssl=verify_ssl)
         self.client.send(json.dumps({
             "type": "login",
             "data": {
@@ -898,11 +959,11 @@ class Entity:
     
     def pop(self) -> bool:
         """
-        自分の位置を保存した位置に戻す
+        自分の位置を保存した位置に戻す（ブロックがあっても移動可能、向きも復元）
         """
         if(len(self.positions) > 0):
             pos = self.positions.pop()
-            self.teleport(pos)
+            self.client.send_call(self.uuid, "forceTeleport", [pos.x, pos.y, pos.z, pos.cord, pos.yaw, pos.pitch])
             return True
         else:
             return False
@@ -1358,6 +1419,156 @@ class Entity:
         self.client.send_call(self.uuid, "digX", [0, -1, 0])
         return str_to_bool(self.client.result)
 
+    # ===== Sign Operations =====
+
+    def write_sign(self, text) -> bool:
+        """
+        自分の前方の看板にテキストを書き込む
+
+        Args:
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+
+        Examples:
+            文字列で書き込む::
+
+                entity.write_sign("Hello World")
+
+            複数行を書き込む::
+
+                entity.write_sign(["1行目", "2行目", "3行目", "4行目"])
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSign", [str(text), "front"])
+        return str_to_bool(self.client.result)
+
+    def write_sign_up(self, text) -> bool:
+        """
+        自分の真上の看板にテキストを書き込む
+
+        Args:
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSign", [str(text), "up"])
+        return str_to_bool(self.client.result)
+
+    def write_sign_down(self, text) -> bool:
+        """
+        自分の真下の看板にテキストを書き込む
+
+        Args:
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSign", [str(text), "down"])
+        return str_to_bool(self.client.result)
+
+    def write_sign_at(self, loc: Location, text) -> bool:
+        """
+        指定した座標の看板にテキストを書き込む
+
+        Args:
+            loc (Location): 座標情報（LocationFactory.absolute/relative/localで生成）
+            text: 書き込むテキスト。文字列またはリスト（各要素が各行になる、最大4行）
+
+        Returns:
+            bool: 操作が成功した場合はTrue、失敗した場合はFalse
+
+        Examples:
+            相対座標で指定::
+
+                loc = LocationFactory.relative(0, 1, 0)  # 1ブロック上
+                entity.write_sign_at(loc, "相対座標のメッセージ")
+
+            ローカル座標で指定::
+
+                loc = LocationFactory.local(0, 0, 1)  # 前方1ブロック
+                entity.write_sign_at(loc, "ローカル座標のメッセージ")
+
+            複数行を書き込む::
+
+                loc = LocationFactory.local(0, 0, 1)
+                entity.write_sign_at(loc, ["1行目", "2行目", "3行目"])
+        """
+        if isinstance(text, list):
+            text = '\n'.join(str(line) for line in text[:4])
+        self.client.send_call(self.uuid, "setSignX", [str(text), loc.x, loc.y, loc.z, loc.cord])
+        return str_to_bool(self.client.result)
+
+    def read_sign(self) -> str:
+        """
+        自分の前方の看板のテキストを読み取る
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+
+        Examples:
+            テキストを読み取る::
+
+                text = entity.read_sign()
+                print(text)  # "1行目\\n2行目\\n..."
+        """
+        self.client.send_call(self.uuid, "getSign", ["front"])
+        return self.client.result if self.client.result else ""
+
+    def read_sign_up(self) -> str:
+        """
+        自分の真上の看板のテキストを読み取る
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+        """
+        self.client.send_call(self.uuid, "getSign", ["up"])
+        return self.client.result if self.client.result else ""
+
+    def read_sign_down(self) -> str:
+        """
+        自分の真下の看板のテキストを読み取る
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+        """
+        self.client.send_call(self.uuid, "getSign", ["down"])
+        return self.client.result if self.client.result else ""
+
+    def read_sign_at(self, loc: Location) -> str:
+        """
+        指定した座標の看板のテキストを読み取る
+
+        Args:
+            loc (Location): 座標情報（LocationFactory.absolute/relative/localで生成）
+
+        Returns:
+            str: 看板のテキスト（複数行の場合は改行で区切られた文字列）、看板がない場合は空文字列
+
+        Examples:
+            相対座標で指定::
+
+                loc = LocationFactory.relative(0, 1, 0)  # 1ブロック上
+                text = entity.read_sign_at(loc)
+
+            ローカル座標で指定::
+
+                loc = LocationFactory.local(0, 0, 1)  # 前方1ブロック
+                text = entity.read_sign_at(loc)
+        """
+        self.client.send_call(self.uuid, "getSignX", [loc.x, loc.y, loc.z, loc.cord])
+        return self.client.result if self.client.result else ""
+
+    # ===== End Sign Operations =====
+
     def attack(self) -> bool:
         """
         自分の前方を攻撃する
@@ -2057,6 +2268,197 @@ class Entity:
 
     # ===== Livestock Methods =====
 
+    def get_biome(self) -> str:
+        """
+        自分の現在位置のバイオームを取得する
+
+        Returns:
+            str: バイオーム名（例: "PLAINS", "DESERT", "FOREST"）
+        """
+        self.client.send_call(self.uuid, "getBiome")
+        return self.client.result
+
+    def get_biome_at(self, loc: Location) -> str:
+        """
+        指定された座標のバイオームを取得する
+
+        Args:
+            loc (Location): 座標情報（LocationFactory.absolute/relative/localで生成）
+
+        Returns:
+            str: バイオーム名（例: "PLAINS", "DESERT", "FOREST"）
+        """
+        self.client.send_call(self.uuid, "getBiomeAt", [loc.x, loc.y, loc.z, loc.cord])
+        return self.client.result
+
+    def get_time(self) -> int:
+        """
+        ワールドの時刻を取得する
+
+        Returns:
+            int: ワールドの時刻（0-24000のtick値。0=朝6時, 6000=正午, 12000=夕方, 18000=真夜中）
+        """
+        self.client.send_call(self.uuid, "getTime")
+        return int(self.client.result)
+
+    def get_weather(self) -> str:
+        """
+        ワールドの天気を取得する
+
+        Returns:
+            str: 天気（"clear", "rain", "thunder"のいずれか）
+        """
+        self.client.send_call(self.uuid, "getWeather")
+        return self.client.result
+
+    def get_server_time(self) -> int:
+        """
+        サーバーの現在時刻をUnixタイムスタンプ（ミリ秒）で取得する
+        イベントログの取得開始時刻の記録に使用する
+
+        Returns:
+            int: サーバーの現在時刻（Unixタイムスタンプ、ミリ秒）
+
+        Example:
+            .. code-block:: python
+
+                start = entity.get_server_time()
+                # ... 何か作業 ...
+                log = entity.get_event_log(since=start)
+        """
+        self.client.send_call(self.uuid, "getServerTime")
+        return int(self.client.result)
+
+    def get_event_log(self, event_types: list = None, limit: int = 200) -> list:
+        """
+        ワールドのイベントログを取得する（差分取得）
+        呼び出すたびに、前回取得した位置以降の新しいイベントだけを返す
+        サーバー側でエンティティごとにカーソルを管理しているため、sinceの指定は不要
+
+        Args:
+            event_types (list, optional): 取得するイベントの種類（例: ["fish", "block_break"]）
+            limit (int): 最大取得件数（デフォルト: 200、最大: 200）
+
+        Returns:
+            list: 新しいイベントのリスト。各イベントは辞書形式
+                [{"type": "fish", "player": "taro", "item": "cod", "timestamp": 1714020000000}, ...]
+
+        Example:
+            .. code-block:: python
+
+                new_events = entity.get_event_log(["fish"])
+                for event in new_events:
+                    print(f"{event['player']}が{event['item']}を釣りました")
+        """
+        types_str = ",".join(event_types) if event_types else None
+        self.client.send_call(self.uuid, "getEventLog", [types_str, limit])
+        result = json.loads(self.client.result)
+        return result.get("events", [])
+
+    def get_event_log_status(self) -> dict:
+        """
+        イベントログの状態を取得する
+
+        Returns:
+            dict: ログの状態情報
+                {"eventCount": 1234, "maxEvents": 50000, "serverTime": 1714020000000}
+        """
+        self.client.send_call(self.uuid, "getEventLogStatus")
+        return json.loads(self.client.result)
+
+    def scan_blocks(self, volume: 'Volume') -> list:
+        """
+        指定範囲のブロックを一括取得する（最大32×32×32）
+
+        Args:
+            volume (Volume): スキャンする範囲
+
+        Returns:
+            list: ブロック情報のリスト
+                [{"name": "stone", "x": 100, "y": 64, "z": -200, ...}, ...]
+
+        Example:
+            .. code-block:: python
+
+                area = Volume.relative(-5, -5, -5, 5, 5, 5)
+                blocks = entity.scan_blocks(area)
+                print(f"{len(blocks)}ブロックをスキャンしました")
+        """
+        x1, y1, z1, cord = volume.pos1
+        x2, y2, z2, _ = volume.pos2
+        self.client.send_call(self.uuid, "scanBlocks", [x1, y1, z1, x2, y2, z2, cord])
+        return json.loads(self.client.result)
+
+    def reset_event_cursor(self):
+        """
+        イベントログのカーソルをリセットする
+        次回のget_event_log()は現在時刻以降のイベントから返すようになる
+
+        Example:
+            .. code-block:: python
+
+                entity.reset_event_cursor()
+                # ここから新しいイベントだけを取得する
+                events = entity.get_event_log(["fish"])
+        """
+        self.client.send_call(self.uuid, "resetEventCursor")
+
+    def watch_events(self, event_types: list = None, interval: int = 1, callback: Callable = None) -> list:
+        """
+        リアルタイムでイベントを監視する
+        1秒ごとに新しいイベントを取得し、callbackが設定されていれば呼び出す
+        Ctrl+C（KeyboardInterrupt）で停止し、全イベントを返す
+        サーバー側でカーソルを管理するため、差分だけが自動的に返される
+
+        Args:
+            event_types (list, optional): 監視するイベントの種類（例: ["fish", "block_break"]）
+            interval (int): ポーリング間隔（秒）。デフォルト: 1
+            callback (Callable, optional): 新しいイベントが来たときに呼ばれる関数
+                callback(new_events, all_events) の形式で呼ばれる
+                new_events: 今回新しく取得したイベントのリスト
+                all_events: これまでの全イベントのリスト
+
+        Returns:
+            list: 監視中に収集した全イベントのリスト
+
+        Example:
+            .. code-block:: python
+
+                events = entity.watch_events(["fish"])
+
+            .. code-block:: python
+
+                from IPython.display import clear_output
+                import matplotlib.pyplot as plt
+                import pandas as pd
+
+                def update_graph(new_events, all_events):
+                    clear_output(wait=True)
+                    df = pd.DataFrame(all_events)
+                    df["item"].value_counts().plot(kind="bar")
+                    plt.title(f"釣り結果（{len(df)}回）")
+                    plt.show()
+
+                events = entity.watch_events(["fish"], callback=update_graph)
+        """
+        self.reset_event_cursor()
+        all_events = []
+
+        try:
+            while True:
+                new_events = self.get_event_log(event_types=event_types)
+                if new_events:
+                    all_events.extend(new_events)
+                    if callback:
+                        callback(new_events, all_events)
+                time.sleep(interval)
+        except KeyboardInterrupt:
+            pass
+
+        return all_events
+
+    # ===== Livestock Methods =====
+
     def livestock_count_nearby(self, animal_type: str = "ALL", radius: float = 50.0) -> int:
         """
         近くの動物を数える

{py2hackcraft2-1.1.44 → py2hackcraft2-1.2.1}/py2hackCraft2.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: py2hackCraft2
-Version: 1.1.44
+Version: 1.2.1
 Summary: Python client library for hackCraft2
 Home-page: https://github.com/0x48lab/hackCraft2-python
 Author: masafumi_t
@@ -65,6 +65,20 @@ entity.set_event_area(Volume.local(10, 10, 10, -10, -10, -10))
 # その他の操作...
 ```
 
+### セキュア(wss)接続（Colab / リモート）
+
+Google Colab などから、HTTPS 公開トンネル（Cloudflare 等）越しに動いているサーバーへ接続する場合は `secure=True` を指定します。`port` を省略すると標準TLSポート(443)を使用します。
+
+```python
+# 公開サーバーへ wss 接続
+player.login("your-tunnel.example.com", secure=True)
+
+# 自己署名証明書や自前トンネルで証明書検証を無効化する場合（自己責任）
+player.login("self-hosted.example.com", secure=True, verify_ssl=False)
+```
+
+ローカルサーバーへは従来どおり `player.login("localhost", 25570)` で接続できます（後方互換）。
+
 ## ライセンス
 
 MIT License

{py2hackcraft2-1.1.44 → py2hackcraft2-1.2.1}/py2hackCraft2.egg-info/SOURCES.txt

@@ -8,4 +8,9 @@ py2hackCraft2.egg-info/PKG-INFO
 py2hackCraft2.egg-info/SOURCES.txt
 py2hackCraft2.egg-info/dependency_links.txt
 py2hackCraft2.egg-info/requires.txt
-py2hackCraft2.egg-info/top_level.txt
+py2hackCraft2.egg-info/top_level.txt
+tests/__init__.py
+tests/test_backward_compat.py
+tests/test_connection_timeout.py
+tests/test_connection_url.py
+tests/test_secure_login.py

{py2hackcraft2-1.1.44 → py2hackcraft2-1.2.1}/py2hackCraft2.egg-info/top_level.txt

@@ -1 +1,2 @@
 py2hackCraft
+tests

py2hackcraft2-1.2.1/pyproject.toml

@@ -0,0 +1,8 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+ 

{py2hackcraft2-1.1.44 → py2hackcraft2-1.2.1}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
 
 setup(
     name="py2hackCraft2",
-    version="v1.1.44",
+    version="v1.2.1",
     packages=find_packages(),
     install_requires=[
         "websocket-client>=1.6.0",
@@ -24,4 +24,4 @@ setup(
         "Operating System :: OS Independent",
     ],
     python_requires=">=3.7",
-)
+)

py2hackcraft2-1.2.1/tests/test_backward_compat.py

@@ -0,0 +1,59 @@
+"""US2: 後方互換の回帰テスト。
+
+既存の login(host, port)（非secure）が従来どおり ws:// URL を構築し、
+sslopt が None（証明書設定の影響なし）であることを検証する。
+"""
+import json
+
+import pytest
+
+import py2hackCraft.modules as modules
+from py2hackCraft.modules import Player
+
+
+class _FakeWS:
+    last_url = None
+    last_sslopt = "UNSET"
+
+    def __init__(self, url, on_message=None, on_error=None, on_close=None):
+        _FakeWS.last_url = url
+        self.url = url
+        self.on_open = None
+        self._on_message = on_message
+
+    def run_forever(self, sslopt=None, **kwargs):
+        _FakeWS.last_sslopt = sslopt
+        if self.on_open:
+            self.on_open(self)
+
+    def send(self, message):
+        self._on_message(self, json.dumps({
+            "type": "logged",
+            "data": {"playerUUID": "uuid-xyz", "world": "world"},
+        }))
+
+    def close(self):
+        pass
+
+
+@pytest.fixture
+def patched(monkeypatch):
+    _FakeWS.last_url = None
+    _FakeWS.last_sslopt = "UNSET"
+    monkeypatch.setattr(modules.websocket, "WebSocketApp", _FakeWS)
+
+    def sync_run_forever(self):
+        self.thread.start()
+        self.thread.join()
+    monkeypatch.setattr(modules._WebSocketClient, "_run_forever", sync_run_forever)
+    return _FakeWS
+
+
+def test_legacy_login_builds_plain_ws_url(patched):
+    # 既存の呼び出し方法（位置引数 host, port）が従来どおり動作すること
+    player = Player("tester")
+    player.login("localhost", 25570)
+    assert patched.last_url == "ws://localhost:25570/ws"
+    # 非secure では sslopt は None（verify_ssl フラグの影響を受けない）
+    assert patched.last_sslopt is None
+    assert player.uuid == "uuid-xyz"

py2hackcraft2-1.2.1/tests/test_connection_timeout.py

@@ -0,0 +1,29 @@
+"""接続確立タイムアウトの単体テスト（FR-005: 無限待機しない）。
+
+実接続せず、connected が True にならない状況で _wait_for_connection が
+短時間で ConnectionTimeoutError を送出することを検証する。
+"""
+import time
+
+import pytest
+
+from py2hackCraft.modules import _WebSocketClient, ConnectionTimeoutError
+
+
+def test_wait_for_connection_times_out_when_never_connected():
+    client = _WebSocketClient()
+    client.url = "wss://unreachable.example.com:443/ws"
+    # connected は False のまま（接続成立しないケース）
+    start = time.monotonic()
+    with pytest.raises(ConnectionTimeoutError):
+        client._wait_for_connection(timeout=0.3)
+    elapsed = time.monotonic() - start
+    # 上限時間付近で速やかに失敗すること（無限待機しない）
+    assert elapsed < 5
+
+
+def test_wait_for_connection_returns_immediately_when_connected():
+    client = _WebSocketClient()
+    client.connected = True
+    # 既に接続済みなら即座に戻る（例外なし）
+    client._wait_for_connection(timeout=0.3)

py2hackcraft2-1.2.1/tests/test_connection_url.py

@@ -0,0 +1,34 @@
+"""build_ws_url / build_sslopt の純粋ロジック単体テスト（contracts/login-api.md 準拠）。
+
+実 WebSocket 接続を行わず、URL と TLS オプションの組み立てのみを検証する。
+"""
+import ssl
+
+from py2hackCraft.modules import build_ws_url, build_sslopt
+
+
+class TestBuildWsUrl:
+    def test_local_non_secure(self):
+        assert build_ws_url("localhost", 25570, False) == "ws://localhost:25570/ws"
+
+    def test_secure_default_tls_port(self):
+        # secure かつ port 省略(None) → 標準TLSポート 443
+        assert build_ws_url("example.com", None, True) == "wss://example.com:443/ws"
+
+    def test_secure_custom_port(self):
+        assert build_ws_url("example.com", 8443, True) == "wss://example.com:8443/ws"
+
+
+class TestBuildSslopt:
+    def test_non_secure_returns_none(self):
+        assert build_sslopt(False, True) is None
+
+    def test_secure_verify_returns_none(self):
+        # 既定検証は websocket-client の既定挙動に委ねる → None
+        assert build_sslopt(True, True) is None
+
+    def test_secure_no_verify_disables_cert_check(self):
+        assert build_sslopt(True, False) == {"cert_reqs": ssl.CERT_NONE}
+
+    def test_non_secure_ignores_verify_flag(self):
+        assert build_sslopt(False, False) is None

py2hackcraft2-1.2.1/tests/test_secure_login.py

@@ -0,0 +1,72 @@
+"""US1: secure(wss) ログインの統合テスト。
+
+実サーバーには接続せず、websocket.WebSocketApp と run_forever を monkeypatch して、
+login(secure=True) が wss URL を構築し sslopt を run_forever に渡すことを検証する。
+"""
+import json
+import ssl
+
+import pytest
+
+import py2hackCraft.modules as modules
+from py2hackCraft.modules import Player
+
+
+class _FakeWS:
+    """WebSocketApp の差し替え。run_forever の sslopt を記録し、接続成立させる。"""
+
+    last_url = None
+    last_sslopt = "UNSET"
+
+    def __init__(self, url, on_message=None, on_error=None, on_close=None):
+        _FakeWS.last_url = url
+        self.url = url
+        self.on_open = None
+        self._on_message = on_message
+
+    def run_forever(self, sslopt=None, **kwargs):
+        # connect() が functools.partial(run_forever, sslopt=...) で渡す sslopt を記録
+        _FakeWS.last_sslopt = sslopt
+        # 接続成立を通知（on_open → _WebSocketClient.connected = True）
+        if self.on_open:
+            self.on_open(self)
+
+    def send(self, message):
+        # login 送信に対して logged 応答を即返してフローを進める
+        self._on_message(self, json.dumps({
+            "type": "logged",
+            "data": {"playerUUID": "uuid-123", "world": "world"},
+        }))
+
+    def close(self):
+        pass
+
+
+@pytest.fixture
+def patched(monkeypatch):
+    _FakeWS.last_url = None
+    _FakeWS.last_sslopt = "UNSET"
+    monkeypatch.setattr(modules.websocket, "WebSocketApp", _FakeWS)
+
+    # スレッド起動を同期実行に置き換え（partial(run_forever, sslopt=...) をその場で実行）
+    def sync_run_forever(self):
+        self.thread.start()
+        self.thread.join()
+    monkeypatch.setattr(modules._WebSocketClient, "_run_forever", sync_run_forever)
+    return _FakeWS
+
+
+def test_secure_login_builds_wss_url_and_passes_sslopt(patched):
+    player = Player("tester")
+    player.login("example.com", secure=True)
+    assert patched.last_url == "wss://example.com:443/ws"
+    # verify_ssl 既定(True) → sslopt は None（既定検証）
+    assert patched.last_sslopt is None
+    assert player.uuid == "uuid-123"
+
+
+def test_secure_login_verify_ssl_false_disables_cert_check(patched):
+    player = Player("tester")
+    player.login("example.com", secure=True, verify_ssl=False)
+    assert patched.last_url == "wss://example.com:443/ws"
+    assert patched.last_sslopt == {"cert_reqs": ssl.CERT_NONE}

py2hackcraft2-1.1.44/pyproject.toml

@@ -1,3 +0,0 @@
-[build-system]
-requires = ["setuptools>=42", "wheel"]
-build-backend = "setuptools.build_meta"