wisent-wire-sdk 0.1.0__tar.gz

wisent_wire_sdk-0.1.0/LICENSE

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

wisent_wire_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: wisent-wire-sdk
+Version: 0.1.0
+Summary: Python client library for the Wisent Wire hardware testing platform API
+Author-email: Wisent Wire <info@wisent-wire.com>
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Requires-Dist: tenacity>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: responses>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: types-requests>=2.28; extra == "dev"
+Dynamic: license-file
+
+# Wisent Wire Python SDK
+
+Python client library for the [Wisent Wire](https://wisent-wire.com) hardware testing platform.
+
+## Installation
+
+```bash
+pip install wisent-wire-sdk
+```
+
+## Quick start
+
+```python
+from wisentwire import WisentWireClient
+
+# Cognito auth (production / integration)
+client = WisentWireClient(
+    base_url="https://int.wisent-wire.com",
+    email="user@company.com",
+    password="secret",
+)
+
+# Local dev (header-based, no Cognito)
+client = WisentWireClient(
+    base_url="http://localhost:7998",
+    email="dev@test.com",
+    local=True,
+)
+
+# Pre-existing token
+client = WisentWireClient(
+    base_url="https://int.wisent-wire.com",
+    token="eyJhbGciOi...",
+)
+```
+
+## Usage
+
+### Wires
+
+```python
+wires = client.list_wires()
+wire = client.get_wire(ww_id=1)
+```
+
+### Power supply
+
+```python
+client.set_power_supply(ww_id=1, state="ON", voltage=5.0, current=2.0)
+shadow = client.wait_shadow_state(ww_id=1, expected_state="ON")
+print(shadow.reported.voltage_setpoint)
+```
+
+### Firmware & flash
+
+```python
+fw = client.upload_firmware("app.bin", firmware_bytes, "STM32F4")
+job_id = client.flash(ww_id=1, firmware_id=fw.id)
+client.wait_flash_complete(ww_id=1, job_id=job_id)
+```
+
+### UART
+
+```python
+client.send_uart_ascii(ww_id=1, text="HELLO")
+msg = client.wait_for_uart_rx(ww_id=1, match_hex="48454C4C4F")
+print(msg.bytes_hex)
+```
+
+### Telemetry
+
+```python
+readings = client.get_power_telemetry(ww_id=1)
+```
+
+### Reservations
+
+```python
+reservations = client.list_reservations()
+```
+
+### Organization
+
+```python
+org = client.get_organization()
+members = client.list_members()
+```
+
+## Error handling
+
+All API errors raise typed exceptions inheriting from `WisentWireError`:
+
+```python
+from wisentwire import NotFoundError, ConflictError
+
+try:
+    client.get_wire(ww_id=999)
+except NotFoundError as e:
+    print(f"Wire not found: {e}")
+```
+
+| HTTP status | Exception               |
+|-------------|-------------------------|
+| 400         | `BadRequestError`       |
+| 401         | `AuthenticationError`   |
+| 403         | `ForbiddenError`        |
+| 404         | `NotFoundError`         |
+| 409         | `ConflictError`         |
+| 429         | `RateLimitError`        |
+| 503         | `ServiceUnavailableError` |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## Requirements
+
+- Python >= 3.10
+- `requests` >= 2.28
+- `tenacity` >= 8.0

wisent_wire_sdk-0.1.0/README.md

@@ -0,0 +1,123 @@
+# Wisent Wire Python SDK
+
+Python client library for the [Wisent Wire](https://wisent-wire.com) hardware testing platform.
+
+## Installation
+
+```bash
+pip install wisent-wire-sdk
+```
+
+## Quick start
+
+```python
+from wisentwire import WisentWireClient
+
+# Cognito auth (production / integration)
+client = WisentWireClient(
+    base_url="https://int.wisent-wire.com",
+    email="user@company.com",
+    password="secret",
+)
+
+# Local dev (header-based, no Cognito)
+client = WisentWireClient(
+    base_url="http://localhost:7998",
+    email="dev@test.com",
+    local=True,
+)
+
+# Pre-existing token
+client = WisentWireClient(
+    base_url="https://int.wisent-wire.com",
+    token="eyJhbGciOi...",
+)
+```
+
+## Usage
+
+### Wires
+
+```python
+wires = client.list_wires()
+wire = client.get_wire(ww_id=1)
+```
+
+### Power supply
+
+```python
+client.set_power_supply(ww_id=1, state="ON", voltage=5.0, current=2.0)
+shadow = client.wait_shadow_state(ww_id=1, expected_state="ON")
+print(shadow.reported.voltage_setpoint)
+```
+
+### Firmware & flash
+
+```python
+fw = client.upload_firmware("app.bin", firmware_bytes, "STM32F4")
+job_id = client.flash(ww_id=1, firmware_id=fw.id)
+client.wait_flash_complete(ww_id=1, job_id=job_id)
+```
+
+### UART
+
+```python
+client.send_uart_ascii(ww_id=1, text="HELLO")
+msg = client.wait_for_uart_rx(ww_id=1, match_hex="48454C4C4F")
+print(msg.bytes_hex)
+```
+
+### Telemetry
+
+```python
+readings = client.get_power_telemetry(ww_id=1)
+```
+
+### Reservations
+
+```python
+reservations = client.list_reservations()
+```
+
+### Organization
+
+```python
+org = client.get_organization()
+members = client.list_members()
+```
+
+## Error handling
+
+All API errors raise typed exceptions inheriting from `WisentWireError`:
+
+```python
+from wisentwire import NotFoundError, ConflictError
+
+try:
+    client.get_wire(ww_id=999)
+except NotFoundError as e:
+    print(f"Wire not found: {e}")
+```
+
+| HTTP status | Exception               |
+|-------------|-------------------------|
+| 400         | `BadRequestError`       |
+| 401         | `AuthenticationError`   |
+| 403         | `ForbiddenError`        |
+| 404         | `NotFoundError`         |
+| 409         | `ConflictError`         |
+| 429         | `RateLimitError`        |
+| 503         | `ServiceUnavailableError` |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## Requirements
+
+- Python >= 3.10
+- `requests` >= 2.28
+- `tenacity` >= 8.0

wisent_wire_sdk-0.1.0/pyproject.toml

@@ -0,0 +1,55 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wisent-wire-sdk"
+version = "0.1.0"
+description = "Python client library for the Wisent Wire hardware testing platform API"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [
+    { name = "Wisent Wire", email = "info@wisent-wire.com" },
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+]
+dependencies = [
+    "requests>=2.28",
+    "tenacity>=8.0",
+]
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=7.0",
+    "responses>=0.23",
+    "ruff>=0.4",
+    "mypy>=1.10",
+    "types-requests>=2.28",
+]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 99
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM", "RUF"]
+
+[tool.mypy]
+python_version = "3.10"
+strict = true
+packages = ["wisentwire"]
+mypy_path = "src"

wisent_wire_sdk-0.1.0/setup.cfg

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

wisent_wire_sdk-0.1.0/src/wisent_wire_sdk.egg-info/PKG-INFO

@@ -0,0 +1,149 @@
+Metadata-Version: 2.4
+Name: wisent-wire-sdk
+Version: 0.1.0
+Summary: Python client library for the Wisent Wire hardware testing platform API
+Author-email: Wisent Wire <info@wisent-wire.com>
+License-Expression: MIT
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.28
+Requires-Dist: tenacity>=8.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: responses>=0.23; extra == "dev"
+Requires-Dist: ruff>=0.4; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: types-requests>=2.28; extra == "dev"
+Dynamic: license-file
+
+# Wisent Wire Python SDK
+
+Python client library for the [Wisent Wire](https://wisent-wire.com) hardware testing platform.
+
+## Installation
+
+```bash
+pip install wisent-wire-sdk
+```
+
+## Quick start
+
+```python
+from wisentwire import WisentWireClient
+
+# Cognito auth (production / integration)
+client = WisentWireClient(
+    base_url="https://int.wisent-wire.com",
+    email="user@company.com",
+    password="secret",
+)
+
+# Local dev (header-based, no Cognito)
+client = WisentWireClient(
+    base_url="http://localhost:7998",
+    email="dev@test.com",
+    local=True,
+)
+
+# Pre-existing token
+client = WisentWireClient(
+    base_url="https://int.wisent-wire.com",
+    token="eyJhbGciOi...",
+)
+```
+
+## Usage
+
+### Wires
+
+```python
+wires = client.list_wires()
+wire = client.get_wire(ww_id=1)
+```
+
+### Power supply
+
+```python
+client.set_power_supply(ww_id=1, state="ON", voltage=5.0, current=2.0)
+shadow = client.wait_shadow_state(ww_id=1, expected_state="ON")
+print(shadow.reported.voltage_setpoint)
+```
+
+### Firmware & flash
+
+```python
+fw = client.upload_firmware("app.bin", firmware_bytes, "STM32F4")
+job_id = client.flash(ww_id=1, firmware_id=fw.id)
+client.wait_flash_complete(ww_id=1, job_id=job_id)
+```
+
+### UART
+
+```python
+client.send_uart_ascii(ww_id=1, text="HELLO")
+msg = client.wait_for_uart_rx(ww_id=1, match_hex="48454C4C4F")
+print(msg.bytes_hex)
+```
+
+### Telemetry
+
+```python
+readings = client.get_power_telemetry(ww_id=1)
+```
+
+### Reservations
+
+```python
+reservations = client.list_reservations()
+```
+
+### Organization
+
+```python
+org = client.get_organization()
+members = client.list_members()
+```
+
+## Error handling
+
+All API errors raise typed exceptions inheriting from `WisentWireError`:
+
+```python
+from wisentwire import NotFoundError, ConflictError
+
+try:
+    client.get_wire(ww_id=999)
+except NotFoundError as e:
+    print(f"Wire not found: {e}")
+```
+
+| HTTP status | Exception               |
+|-------------|-------------------------|
+| 400         | `BadRequestError`       |
+| 401         | `AuthenticationError`   |
+| 403         | `ForbiddenError`        |
+| 404         | `NotFoundError`         |
+| 409         | `ConflictError`         |
+| 429         | `RateLimitError`        |
+| 503         | `ServiceUnavailableError` |
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest tests/ -v
+```
+
+## Requirements
+
+- Python >= 3.10
+- `requests` >= 2.28
+- `tenacity` >= 8.0

wisent_wire_sdk-0.1.0/src/wisent_wire_sdk.egg-info/SOURCES.txt

@@ -0,0 +1,63 @@
+LICENSE
+README.md
+pyproject.toml
+src/wisent_wire_sdk.egg-info/PKG-INFO
+src/wisent_wire_sdk.egg-info/SOURCES.txt
+src/wisent_wire_sdk.egg-info/dependency_links.txt
+src/wisent_wire_sdk.egg-info/requires.txt
+src/wisent_wire_sdk.egg-info/top_level.txt
+src/wisentwire/__init__.py
+src/wisentwire/_client_firmware.py
+src/wisentwire/_client_org.py
+src/wisentwire/_client_polling.py
+src/wisentwire/_client_resources.py
+src/wisentwire/auth.py
+src/wisentwire/client.py
+src/wisentwire/errors.py
+src/wisentwire/auth_api/__init__.py
+src/wisentwire/auth_api/api.py
+src/wisentwire/auth_api/models.py
+src/wisentwire/firmware/__init__.py
+src/wisentwire/firmware/api.py
+src/wisentwire/firmware/models.py
+src/wisentwire/flash/__init__.py
+src/wisentwire/flash/api.py
+src/wisentwire/flash/models.py
+src/wisentwire/frame_definitions/__init__.py
+src/wisentwire/frame_definitions/api.py
+src/wisentwire/frame_definitions/models.py
+src/wisentwire/organization/__init__.py
+src/wisentwire/organization/api.py
+src/wisentwire/organization/models.py
+src/wisentwire/reservations/__init__.py
+src/wisentwire/reservations/api.py
+src/wisentwire/reservations/models.py
+src/wisentwire/shadow/__init__.py
+src/wisentwire/shadow/api.py
+src/wisentwire/shadow/models.py
+src/wisentwire/telemetry/__init__.py
+src/wisentwire/telemetry/api.py
+src/wisentwire/telemetry/models.py
+src/wisentwire/uart/__init__.py
+src/wisentwire/uart/api.py
+src/wisentwire/uart/models.py
+src/wisentwire/wisentwires/__init__.py
+src/wisentwire/wisentwires/api.py
+src/wisentwire/wisentwires/models.py
+src/wisentwire/work_setup/__init__.py
+src/wisentwire/work_setup/api.py
+src/wisentwire/work_setup/models.py
+tests/test_auth.py
+tests/test_auth_api.py
+tests/test_errors.py
+tests/test_firmware.py
+tests/test_flash.py
+tests/test_frame_definitions.py
+tests/test_organization.py
+tests/test_polling.py
+tests/test_reservations.py
+tests/test_shadow.py
+tests/test_telemetry.py
+tests/test_uart.py
+tests/test_wisentwires.py
+tests/test_work_setup.py

wisent_wire_sdk-0.1.0/src/wisent_wire_sdk.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

wisent_wire_sdk-0.1.0/src/wisent_wire_sdk.egg-info/requires.txt

@@ -0,0 +1,9 @@
+requests>=2.28
+tenacity>=8.0
+
+[dev]
+pytest>=7.0
+responses>=0.23
+ruff>=0.4
+mypy>=1.10
+types-requests>=2.28

wisent_wire_sdk-0.1.0/src/wisent_wire_sdk.egg-info/top_level.txt

@@ -0,0 +1 @@
+wisentwire

wisent_wire_sdk-0.1.0/src/wisentwire/__init__.py

@@ -0,0 +1,86 @@
+"""WisentWire Python SDK."""
+
+from wisentwire._client_polling import FlashFailedError
+from wisentwire.auth_api.models import MeOrganization, MeResponse, Role
+from wisentwire.client import WisentWireClient
+from wisentwire.errors import (
+    AuthenticationError,
+    BadRequestError,
+    ConflictError,
+    ForbiddenError,
+    NotFoundError,
+    RateLimitError,
+    ServiceUnavailableError,
+    WisentWireError,
+)
+from wisentwire.firmware.models import FirmwareBinary, FirmwareStatus, FirmwareUploadResponse
+from wisentwire.flash.models import FlasherLogEntry, FlashJobStatus
+from wisentwire.frame_definitions.models import (
+    ChecksumAlgorithm,
+    CommandDefinition,
+    CommandFieldValue,
+    ComputationType,
+    FieldCategory,
+    FieldDataType,
+    FrameDefinition,
+    FrameField,
+)
+from wisentwire.organization.models import (
+    Invitation,
+    MembershipRequest,
+    MembershipRole,
+    Organization,
+    OrgMember,
+    RequestStatus,
+)
+from wisentwire.reservations.models import Reservation
+from wisentwire.shadow.models import LabTool, PowerSupplyConfig, PowerSupplyShadow
+from wisentwire.telemetry.models import PowerSupplyTelemetryPoint
+from wisentwire.uart.models import UartDirection, UartMessage
+from wisentwire.wisentwires.models import WisentWire, WisentWireStatus
+from wisentwire.work_setup.models import WorkSetup
+
+__all__ = [
+    "AuthenticationError",
+    "BadRequestError",
+    "ChecksumAlgorithm",
+    "CommandDefinition",
+    "CommandFieldValue",
+    "ComputationType",
+    "ConflictError",
+    "FieldCategory",
+    "FieldDataType",
+    "FirmwareBinary",
+    "FirmwareStatus",
+    "FirmwareUploadResponse",
+    "FlashFailedError",
+    "FlashJobStatus",
+    "FlasherLogEntry",
+    "ForbiddenError",
+    "FrameDefinition",
+    "FrameField",
+    "Invitation",
+    "LabTool",
+    "MeOrganization",
+    "MeResponse",
+    "MembershipRequest",
+    "MembershipRole",
+    "NotFoundError",
+    "OrgMember",
+    "Organization",
+    "PowerSupplyConfig",
+    "PowerSupplyShadow",
+    "PowerSupplyTelemetryPoint",
+    "RateLimitError",
+    "RequestStatus",
+    "Reservation",
+    "Role",
+    "ServiceUnavailableError",
+    "UartDirection",
+    "UartMessage",
+    "WisentWire",
+    "WisentWireClient",
+    "WisentWireError",
+    "WisentWireStatus",
+    "WorkSetup",
+]