minethon 0.1.0a1__py3-none-any.whl

minethon/__init__.py

@@ -0,0 +1,78 @@
+"""minethon -- A Python-first Mineflayer SDK."""
+
+from minethon.api.navigation import NavigationAPI
+from minethon.api.observe import ObserveAPI
+from minethon.api.plugins import PluginAPI
+from minethon.bot import Bot
+from minethon.models.block import Block
+from minethon.models.entity import Entity, EntityKind
+from minethon.models.errors import (
+    BridgeError,
+    InventoryError,
+    MinethonConnectionError,
+    MinethonError,
+    NavigationError,
+    NotSpawnedError,
+    PluginError,
+)
+from minethon.models.events import (
+    BlockBrokenEvent,
+    ChatEvent,
+    CollectCompletedEvent,
+    DeathEvent,
+    EndEvent,
+    GoalFailedEvent,
+    GoalReachedEvent,
+    HealthChangedEvent,
+    KickedEvent,
+    SpawnEvent,
+    WhisperEvent,
+)
+from minethon.models.experience import Experience
+from minethon.models.game_state import GameState
+from minethon.models.item import ItemStack
+from minethon.models.player_info import PlayerInfo
+from minethon.models.recipe import Recipe
+from minethon.models.time_state import TimeState
+from minethon.models.vec3 import Vec3
+from minethon.models.window import TradeOffer, VillagerSession, WindowHandle
+from minethon.raw import RawBotHandle
+
+__all__ = [
+    "Block",
+    "BlockBrokenEvent",
+    "Bot",
+    "BridgeError",
+    "ChatEvent",
+    "CollectCompletedEvent",
+    "DeathEvent",
+    "EndEvent",
+    "Entity",
+    "EntityKind",
+    "Experience",
+    "GameState",
+    "GoalFailedEvent",
+    "GoalReachedEvent",
+    "HealthChangedEvent",
+    "InventoryError",
+    "ItemStack",
+    "KickedEvent",
+    "MinethonConnectionError",
+    "MinethonError",
+    "NavigationAPI",
+    "NavigationError",
+    "NotSpawnedError",
+    "ObserveAPI",
+    "PlayerInfo",
+    "PluginAPI",
+    "PluginError",
+    "RawBotHandle",
+    "Recipe",
+    "SpawnEvent",
+    "TimeState",
+    "TradeOffer",
+    "Vec3",
+    "VillagerSession",
+    "WhisperEvent",
+    "WindowHandle",
+]

minethon/_bridge/_events.py

@@ -0,0 +1,312 @@
+"""Internal bridge events for async JS operations.
+
+These are private to the bridge layer — never import from public API.
+Each event signals completion of a non-blocking JS action started by
+the helpers in ``_bridge/js/helpers.js``.
+"""
+
+from dataclasses import dataclass
+from typing import Any
+
+# -- Existing events --
+
+
+@dataclass(frozen=True, slots=True)
+class DigDoneEvent:
+    """Dig operation finished (success if error is None)."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class PlaceDoneEvent:
+    """Place operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class EquipDoneEvent:
+    """Equip operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class LookAtDoneEvent:
+    """LookAt operation finished."""
+
+    error: str | None = None
+
+
+# -- Movement --
+
+
+@dataclass(frozen=True, slots=True)
+class LookDoneEvent:
+    """Look (yaw/pitch) operation finished."""
+
+    error: str | None = None
+
+
+# -- Sleep --
+
+
+@dataclass(frozen=True, slots=True)
+class SleepDoneEvent:
+    """Sleep operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class WakeDoneEvent:
+    """Wake operation finished."""
+
+    error: str | None = None
+
+
+# -- Inventory --
+
+
+@dataclass(frozen=True, slots=True)
+class UnequipDoneEvent:
+    """Unequip operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class TossStackDoneEvent:
+    """TossStack operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class TossDoneEvent:
+    """Toss operation finished."""
+
+    error: str | None = None
+
+
+# -- Actions --
+
+
+@dataclass(frozen=True, slots=True)
+class ConsumeDoneEvent:
+    """Consume (eat/drink) operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class FishDoneEvent:
+    """Fish operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class ElytraFlyDoneEvent:
+    """Elytra fly activation finished."""
+
+    error: str | None = None
+
+
+# -- Crafting --
+
+
+@dataclass(frozen=True, slots=True)
+class CraftDoneEvent:
+    """Craft operation finished."""
+
+    error: str | None = None
+
+
+# -- Block interaction --
+
+
+@dataclass(frozen=True, slots=True)
+class ActivateBlockDoneEvent:
+    """ActivateBlock operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class ActivateEntityDoneEvent:
+    """ActivateEntity operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class ActivateEntityAtDoneEvent:
+    """ActivateEntityAt operation finished."""
+
+    error: str | None = None
+
+
+# -- Containers (return JS window/instance proxy on success) --
+
+
+@dataclass(frozen=True, slots=True)
+class OpenContainerDoneEvent:
+    """OpenContainer operation finished."""
+
+    error: str | None = None
+    result: Any = None
+
+
+@dataclass(frozen=True, slots=True)
+class OpenFurnaceDoneEvent:
+    """OpenFurnace operation finished."""
+
+    error: str | None = None
+    result: Any = None
+
+
+@dataclass(frozen=True, slots=True)
+class OpenEnchantmentTableDoneEvent:
+    """OpenEnchantmentTable operation finished."""
+
+    error: str | None = None
+    result: Any = None
+
+
+@dataclass(frozen=True, slots=True)
+class OpenAnvilDoneEvent:
+    """OpenAnvil operation finished."""
+
+    error: str | None = None
+    result: Any = None
+
+
+@dataclass(frozen=True, slots=True)
+class OpenVillagerDoneEvent:
+    """OpenVillager operation finished."""
+
+    error: str | None = None
+    result: Any = None
+
+
+# -- Trading --
+
+
+@dataclass(frozen=True, slots=True)
+class TradeDoneEvent:
+    """Trade operation finished."""
+
+    error: str | None = None
+
+
+# -- Tab completion (returns matches) --
+
+
+@dataclass(frozen=True, slots=True)
+class TabCompleteDoneEvent:
+    """TabComplete operation finished."""
+
+    error: str | None = None
+    result: Any = None
+
+
+# -- Writing --
+
+
+@dataclass(frozen=True, slots=True)
+class WriteBookDoneEvent:
+    """WriteBook operation finished."""
+
+    error: str | None = None
+
+
+# -- World --
+
+
+@dataclass(frozen=True, slots=True)
+class ChunksLoadedDoneEvent:
+    """WaitForChunksToLoad finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class WaitForTicksDoneEvent:
+    """WaitForTicks finished."""
+
+    error: str | None = None
+
+
+# -- Lower-level inventory --
+
+
+@dataclass(frozen=True, slots=True)
+class ClickWindowDoneEvent:
+    """ClickWindow operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class TransferDoneEvent:
+    """Transfer operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class MoveSlotItemDoneEvent:
+    """MoveSlotItem operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class PutAwayDoneEvent:
+    """PutAway operation finished."""
+
+    error: str | None = None
+
+
+# -- Creative --
+
+
+@dataclass(frozen=True, slots=True)
+class CreativeFlyToDoneEvent:
+    """Creative flyTo operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class CreativeSetSlotDoneEvent:
+    """Creative setInventorySlot operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class CreativeClearSlotDoneEvent:
+    """Creative clearSlot operation finished."""
+
+    error: str | None = None
+
+
+@dataclass(frozen=True, slots=True)
+class CreativeClearInventoryDoneEvent:
+    """Creative clearInventory operation finished."""
+
+    error: str | None = None
+
+
+# -- Entity placement --
+
+
+@dataclass(frozen=True, slots=True)
+class PlaceEntityDoneEvent:
+    """PlaceEntity operation finished."""
+
+    error: str | None = None
+    result: Any = None

minethon/_bridge/_util.py

@@ -0,0 +1,18 @@
+"""Internal bridge utilities."""
+
+
+def extract_js_stack(exc: BaseException) -> str | None:
+    """Try to extract a JS stack trace from a JSPyBridge exception.
+
+    JSPyBridge exceptions may carry a ``stack`` attribute with the
+    JavaScript stack trace string.
+    """
+    stack = getattr(exc, "stack", None)
+    if isinstance(stack, str):
+        return stack
+    for chained in (exc.__cause__, exc.__context__):
+        if chained is not None:
+            stack = getattr(chained, "stack", None)
+            if isinstance(stack, str):
+                return stack
+    return None