toybox-3d-api 0.1.0__tar.gz

toybox_3d_api-0.1.0/LICENSE

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

toybox_3d_api-0.1.0/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: toybox-3d-api
+Version: 0.1.0
+Summary: Python API client for ToyBox 3D printers (make.toys) via Meteor DDP
+Author: stgarrity
+License: MIT
+Project-URL: Homepage, https://github.com/stgarrity/toybox-api
+Project-URL: Repository, https://github.com/stgarrity/toybox-api
+Project-URL: Issues, https://github.com/stgarrity/toybox-api/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Dynamic: license-file
+
+# toybox-api — Python Client for ToyBox 3D Printers
+
+Async Python client for [ToyBox 3D printers](https://www.toybox.com/) via the [make.toys](https://www.make.toys) Meteor DDP protocol.
+
+Used by the [Home Assistant integration](https://github.com/stgarrity/homeassistant-toybox).
+
+## Features
+
+- Meteor DDP WebSocket client (no REST — make.toys is DDP-only)
+- Authentication via Meteor accounts
+- Real-time printer state via DDP subscriptions (`printerStates` collection)
+- Print job tracking via `toyPrints` collection
+- Time remaining / elapsed / progress calculations matching make.toys web app logic
+
+## Installation
+
+```bash
+pip install toybox-api
+```
+
+## Usage
+
+```python
+import asyncio
+from toybox_api import ToyBoxClient
+
+async def main():
+    async with ToyBoxClient() as client:
+        await client.connect()
+        await client.authenticate("email@example.com", "password")
+        await client.subscribe_to_printer_data(["printer_id"])
+
+        data = await client.get_all_data()
+        print(f"Printer: {data.printer.display_name}")
+        print(f"Online: {data.printer.is_online}")
+        print(f"State: {data.print_state}")
+
+        if data.current_request:
+            print(f"Printing: {data.current_request.print_name}")
+            print(f"Remaining: {data.current_request.remaining_seconds}s")
+
+asyncio.run(main())
+```
+
+## Data Model
+
+| Class | Source | Description |
+|-------|--------|-------------|
+| `PrinterStatus` | `printerStates` collection | Online state, model, hardware ID, firmware |
+| `PrintRequest` | `toyPrints` collection | Active/completed prints with timing data |
+| `ToyBoxData` | Coordinator container | Combines printer + current/last print request |
+
+## Status
+
+🟡 **Beta** — Implements real Meteor DDP protocol. Needs live testing with active prints.
+
+## Project Structure
+
+```
+ha-toybox/
+├── toybox_api/
+│   ├── __init__.py
+│   ├── client.py        # DDP WebSocket client
+│   ├── models.py        # PrinterStatus, PrintRequest, ToyBoxData
+│   ├── exceptions.py    # ToyBoxError hierarchy
+│   └── const.py         # DDP URLs, subscription/method names
+├── pyproject.toml
+├── LICENSE
+└── README.md
+```
+
+## License
+
+MIT

toybox_3d_api-0.1.0/README.md

@@ -0,0 +1,74 @@
+# toybox-api — Python Client for ToyBox 3D Printers
+
+Async Python client for [ToyBox 3D printers](https://www.toybox.com/) via the [make.toys](https://www.make.toys) Meteor DDP protocol.
+
+Used by the [Home Assistant integration](https://github.com/stgarrity/homeassistant-toybox).
+
+## Features
+
+- Meteor DDP WebSocket client (no REST — make.toys is DDP-only)
+- Authentication via Meteor accounts
+- Real-time printer state via DDP subscriptions (`printerStates` collection)
+- Print job tracking via `toyPrints` collection
+- Time remaining / elapsed / progress calculations matching make.toys web app logic
+
+## Installation
+
+```bash
+pip install toybox-api
+```
+
+## Usage
+
+```python
+import asyncio
+from toybox_api import ToyBoxClient
+
+async def main():
+    async with ToyBoxClient() as client:
+        await client.connect()
+        await client.authenticate("email@example.com", "password")
+        await client.subscribe_to_printer_data(["printer_id"])
+
+        data = await client.get_all_data()
+        print(f"Printer: {data.printer.display_name}")
+        print(f"Online: {data.printer.is_online}")
+        print(f"State: {data.print_state}")
+
+        if data.current_request:
+            print(f"Printing: {data.current_request.print_name}")
+            print(f"Remaining: {data.current_request.remaining_seconds}s")
+
+asyncio.run(main())
+```
+
+## Data Model
+
+| Class | Source | Description |
+|-------|--------|-------------|
+| `PrinterStatus` | `printerStates` collection | Online state, model, hardware ID, firmware |
+| `PrintRequest` | `toyPrints` collection | Active/completed prints with timing data |
+| `ToyBoxData` | Coordinator container | Combines printer + current/last print request |
+
+## Status
+
+🟡 **Beta** — Implements real Meteor DDP protocol. Needs live testing with active prints.
+
+## Project Structure
+
+```
+ha-toybox/
+├── toybox_api/
+│   ├── __init__.py
+│   ├── client.py        # DDP WebSocket client
+│   ├── models.py        # PrinterStatus, PrintRequest, ToyBoxData
+│   ├── exceptions.py    # ToyBoxError hierarchy
+│   └── const.py         # DDP URLs, subscription/method names
+├── pyproject.toml
+├── LICENSE
+└── README.md
+```
+
+## License
+
+MIT

toybox_3d_api-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[build-system]
+requires = ["setuptools>=45", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "toybox-3d-api"
+version = "0.1.0"
+description = "Python API client for ToyBox 3D printers (make.toys) via Meteor DDP"
+readme = "README.md"
+requires-python = ">=3.11"
+license = {text = "MIT"}
+authors = [
+    {name = "stgarrity"}
+]
+dependencies = [
+    "aiohttp>=3.9.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "pytest-asyncio>=0.21.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/stgarrity/toybox-api"
+Repository = "https://github.com/stgarrity/toybox-api"
+Issues = "https://github.com/stgarrity/toybox-api/issues"

toybox_3d_api-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

toybox_3d_api-0.1.0/tests/test_connection.py

@@ -0,0 +1,16 @@
+#!/usr/bin/env python3
+"""Minimal connection test - no credentials needed."""
+import asyncio
+import sys
+import os
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+
+from toybox_api.client import ToyBoxClient
+
+async def main():
+    client = ToyBoxClient()
+    await client.connect()
+    print("Connected:", client._connected)
+    await client.close()
+
+asyncio.run(main())

toybox_3d_api-0.1.0/tests/test_dump.py

@@ -0,0 +1,48 @@
+#!/usr/bin/env python3
+"""Dump raw DDP collection data for debugging."""
+import asyncio
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+
+from toybox_api.client import ToyBoxClient
+
+async def main():
+    # Read creds from file
+    with open("/tmp/toybox_creds") as f:
+        lines = f.read().strip().split("\n")
+    email, password = lines[0], lines[1]
+
+    client = ToyBoxClient()
+    await client.connect()
+    await client.authenticate(email, password)
+    await client.setup()
+
+    # Dump ALL collections raw
+    for coll_name, docs in client._collections.items():
+        print(f"\n{'='*60}")
+        print(f"Collection: {coll_name} ({len(docs)} docs)")
+        print(f"{'='*60}")
+        for doc_id, doc in docs.items():
+            print(json.dumps(doc, indent=2, default=str))
+
+    # Also try the getPrintRequestsByIds method
+    users = client._collections.get("users", {})
+    for uid, udata in users.items():
+        profile = udata.get("profile", {})
+        last_print_id = profile.get("last_completed_print")
+        if last_print_id:
+            print(f"\n{'='*60}")
+            print(f"Fetching print request: {last_print_id}")
+            print(f"{'='*60}")
+            result = await client._call_method(
+                "getPrintRequestsByIds",
+                [{"requestIds": [last_print_id]}],
+            )
+            print(json.dumps(result, indent=2, default=str))
+
+    await client.close()
+
+asyncio.run(main())

toybox_3d_api-0.1.0/tests/test_live.py

@@ -0,0 +1,168 @@
+#!/usr/bin/env python3
+"""Live test of the ToyBox DDP client.
+
+Usage:
+    TOYBOX_EMAIL=stgarrity TOYBOX_PASSWORD=xxx python3 tests/test_live.py
+"""
+import asyncio
+import json
+import logging
+import os
+import sys
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), ".."))
+logging.basicConfig(
+    level=logging.DEBUG,
+    stream=sys.stderr,
+    format="%(levelname)s %(name)s: %(message)s",
+)
+
+from toybox_api.client import ToyBoxClient
+
+
+async def test():
+    email = os.environ.get("TOYBOX_EMAIL")
+    password = os.environ.get("TOYBOX_PASSWORD")
+
+    # Also try reading from .env file or creds file
+    if not email or not password:
+        for creds_path in [
+            os.path.join(os.path.dirname(__file__), "..", ".env"),
+            "/tmp/toybox_creds",
+        ]:
+            if os.path.exists(creds_path):
+                with open(creds_path) as f:
+                    content = f.read().strip()
+                if "=" in content:
+                    for line in content.split("\n"):
+                        line = line.strip()
+                        if "=" in line and not line.startswith("#"):
+                            k, v = line.split("=", 1)
+                            os.environ[k] = v
+                else:
+                    lines = content.split("\n")
+                    if len(lines) >= 2:
+                        os.environ["TOYBOX_EMAIL"] = lines[0].strip()
+                        os.environ["TOYBOX_PASSWORD"] = lines[1].strip()
+                email = os.environ.get("TOYBOX_EMAIL")
+                password = os.environ.get("TOYBOX_PASSWORD")
+                if email and password:
+                    break
+
+    if not email or not password:
+        print("Set TOYBOX_EMAIL and TOYBOX_PASSWORD env vars or create .env file")
+        sys.exit(1)
+
+    client = ToyBoxClient()
+    try:
+        print("Connecting to DDP...")
+        await client.connect()
+        print("Connected ✓")
+
+        print("Authenticating...")
+        try:
+            await client.authenticate(email, password)
+        except Exception:
+            # Retry with username-style login
+            msg_id = client._next_id()
+            future = asyncio.get_event_loop().create_future()
+            client._pending[msg_id] = future
+            await client._send(
+                {
+                    "msg": "method",
+                    "method": "login",
+                    "id": msg_id,
+                    "params": [
+                        {"user": {"username": email}, "password": password}
+                    ],
+                }
+            )
+            result = await asyncio.wait_for(future, timeout=15)
+            client._login_token = result.get("token")
+            client._user_id = result.get("id")
+
+        print(f"Authenticated ✓ (user_id={client._user_id})")
+
+        print("Running setup (discover printers, subscribe)...")
+        await client.setup()
+        print(f"Printer IDs: {client.printer_ids}")
+        print(f"Collections: {list(client._collections.keys())}")
+        for coll_name, docs in client._collections.items():
+            print(f"  {coll_name}: {len(docs)} docs")
+
+        data = await client.get_all_data()
+        print(f"\n=== Printer ===")
+        print(f"  Name: {data.printer.display_name}")
+        print(f"  Model: {data.printer.model}")
+        print(f"  Online: {data.printer.is_online}")
+        print(f"  State: {data.print_state}")
+        print(f"  Hardware ID: {data.printer.hardware_id}")
+        print(f"  Firmware: {data.printer.firmware_version}")
+        print(f"  Last Completed Print ID: {data.printer.last_completed_print}")
+
+        if data.current_request:
+            r = data.current_request
+            print(f"\n=== Current Print ===")
+            print(f"  Name: {r.print_name}")
+            print(f"  State: {r.state}")
+            print(f"  Remaining: {r.remaining_seconds}s")
+            print(f"  Progress: {r.progress_percent}%")
+        else:
+            print("\n  No active print")
+
+        if data.last_completed_request:
+            r = data.last_completed_request
+            print(f"\n=== Last Completed ===")
+            print(f"  Name: {r.print_name}")
+            print(f"  State: {r.state} (end_reason={r.end_reason})")
+            if r.print_completion_time:
+                print(f"  Completed at: {r.print_completion_time}")
+        else:
+            print("\n  No last completed in subscriptions")
+            if data.printer.last_completed_print:
+                print(
+                    f"  Fetching via method call for ID={data.printer.last_completed_print}..."
+                )
+                details = await client.get_print_request_details(
+                    [data.printer.last_completed_print]
+                )
+                for d in details:
+                    apm = d.get("active_print_model", {})
+                    print(f"  Name: {apm.get('name')}")
+                    print(
+                        f"  State: {d.get('state')} end_reason={d.get('end_reason')}"
+                    )
+
+        print(f"\n=== Raw printerStates ===")
+        for doc_id, doc in client._collections.get("printerStates", {}).items():
+            print(json.dumps(doc, indent=2, default=str)[:800])
+
+        print(f"\n=== Raw toyPrints ===")
+        for doc_id, doc in client._collections.get("toyPrints", {}).items():
+            apm = doc.get("active_print_model", {})
+            name = apm.get("name") if isinstance(apm, dict) else None
+            print(
+                f"  {doc_id}: state={doc.get('state')} "
+                f"active={doc.get('is_active')} name={name}"
+            )
+
+        # Also dump raw users collection to see printer ID structure
+        print(f"\n=== Raw users (printer fields only) ===")
+        for doc_id, doc in client._collections.get("users", {}).items():
+            filtered = {
+                k: v
+                for k, v in doc.items()
+                if k in ("_id", "printers", "profile", "username", "emails")
+            }
+            print(json.dumps(filtered, indent=2, default=str)[:600])
+
+    except Exception:
+        import traceback
+
+        traceback.print_exc()
+    finally:
+        await client.close()
+
+
+if __name__ == "__main__":
+    asyncio.run(test())

toybox_3d_api-0.1.0/toybox_3d_api.egg-info/PKG-INFO

@@ -0,0 +1,92 @@
+Metadata-Version: 2.4
+Name: toybox-3d-api
+Version: 0.1.0
+Summary: Python API client for ToyBox 3D printers (make.toys) via Meteor DDP
+Author: stgarrity
+License: MIT
+Project-URL: Homepage, https://github.com/stgarrity/toybox-api
+Project-URL: Repository, https://github.com/stgarrity/toybox-api
+Project-URL: Issues, https://github.com/stgarrity/toybox-api/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.9.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Dynamic: license-file
+
+# toybox-api — Python Client for ToyBox 3D Printers
+
+Async Python client for [ToyBox 3D printers](https://www.toybox.com/) via the [make.toys](https://www.make.toys) Meteor DDP protocol.
+
+Used by the [Home Assistant integration](https://github.com/stgarrity/homeassistant-toybox).
+
+## Features
+
+- Meteor DDP WebSocket client (no REST — make.toys is DDP-only)
+- Authentication via Meteor accounts
+- Real-time printer state via DDP subscriptions (`printerStates` collection)
+- Print job tracking via `toyPrints` collection
+- Time remaining / elapsed / progress calculations matching make.toys web app logic
+
+## Installation
+
+```bash
+pip install toybox-api
+```
+
+## Usage
+
+```python
+import asyncio
+from toybox_api import ToyBoxClient
+
+async def main():
+    async with ToyBoxClient() as client:
+        await client.connect()
+        await client.authenticate("email@example.com", "password")
+        await client.subscribe_to_printer_data(["printer_id"])
+
+        data = await client.get_all_data()
+        print(f"Printer: {data.printer.display_name}")
+        print(f"Online: {data.printer.is_online}")
+        print(f"State: {data.print_state}")
+
+        if data.current_request:
+            print(f"Printing: {data.current_request.print_name}")
+            print(f"Remaining: {data.current_request.remaining_seconds}s")
+
+asyncio.run(main())
+```
+
+## Data Model
+
+| Class | Source | Description |
+|-------|--------|-------------|
+| `PrinterStatus` | `printerStates` collection | Online state, model, hardware ID, firmware |
+| `PrintRequest` | `toyPrints` collection | Active/completed prints with timing data |
+| `ToyBoxData` | Coordinator container | Combines printer + current/last print request |
+
+## Status
+
+🟡 **Beta** — Implements real Meteor DDP protocol. Needs live testing with active prints.
+
+## Project Structure
+
+```
+ha-toybox/
+├── toybox_api/
+│   ├── __init__.py
+│   ├── client.py        # DDP WebSocket client
+│   ├── models.py        # PrinterStatus, PrintRequest, ToyBoxData
+│   ├── exceptions.py    # ToyBoxError hierarchy
+│   └── const.py         # DDP URLs, subscription/method names
+├── pyproject.toml
+├── LICENSE
+└── README.md
+```
+
+## License
+
+MIT

toybox_3d_api-0.1.0/toybox_3d_api.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+LICENSE
+README.md
+pyproject.toml
+tests/test_connection.py
+tests/test_dump.py
+tests/test_live.py
+toybox_3d_api.egg-info/PKG-INFO
+toybox_3d_api.egg-info/SOURCES.txt
+toybox_3d_api.egg-info/dependency_links.txt
+toybox_3d_api.egg-info/requires.txt
+toybox_3d_api.egg-info/top_level.txt
+toybox_api/__init__.py
+toybox_api/client.py
+toybox_api/const.py
+toybox_api/exceptions.py
+toybox_api/models.py

toybox_3d_api-0.1.0/toybox_3d_api.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

toybox_3d_api-0.1.0/toybox_3d_api.egg-info/requires.txt

@@ -0,0 +1,5 @@
+aiohttp>=3.9.0
+
+[dev]
+pytest>=7.0
+pytest-asyncio>=0.21.0

toybox_3d_api-0.1.0/toybox_3d_api.egg-info/top_level.txt

@@ -0,0 +1 @@
+toybox_api

toybox_3d_api-0.1.0/toybox_api/__init__.py

@@ -0,0 +1,33 @@
+"""ToyBox API client - Python client for make.toys."""
+
+from toybox_api.client import ToyBoxClient
+from toybox_api.models import (
+    PrinterStatus,
+    PrintRequest,
+    ActivePrintModel,
+    PrintState,
+    PrintRequestState,
+    ToyBoxData,
+)
+from toybox_api.exceptions import (
+    ToyBoxError,
+    AuthenticationError,
+    ConnectionError,
+    APIError,
+    SessionExpiredError,
+)
+
+__all__ = [
+    "ToyBoxClient",
+    "PrinterStatus",
+    "PrintRequest",
+    "ActivePrintModel",
+    "PrintState",
+    "PrintRequestState",
+    "ToyBoxData",
+    "ToyBoxError",
+    "AuthenticationError",
+    "ConnectionError",
+    "APIError",
+    "SessionExpiredError",
+]