wherobots-python-sdk 0.1.0__py3-none-any.whl

wherobots/utils/__init__.py

@@ -0,0 +1,6 @@
+"""Utility helpers for the Wherobots Jobs SDK."""
+
+from wherobots.utils.logger import get_logger
+from wherobots.utils.validation import validate_name
+
+__all__ = ["get_logger", "validate_name"]

wherobots/utils/logger.py

@@ -0,0 +1,34 @@
+"""Library-safe logging for the Wherobots Jobs SDK.
+
+Uses a ``NullHandler`` so the library never forces log output on
+applications that embed it.  Consumers who *do* want to see SDK logs
+can attach their own handler to the ``"wherobots"`` logger::
+
+    import logging
+    logging.getLogger("wherobots").addHandler(logging.StreamHandler())
+    logging.getLogger("wherobots").setLevel(logging.DEBUG)
+"""
+
+from __future__ import annotations
+
+import logging
+
+
+def get_logger(name: str | None = None) -> logging.Logger:
+    """Return a child logger under the ``wherobots`` namespace.
+
+    Args:
+        name: Optional suffix appended to ``"wherobots"``.
+            If *None*, the root ``"wherobots"`` logger is returned.
+
+    Returns:
+        A ``logging.Logger`` instance for the requested namespace.
+    """
+    base = "wherobots"
+    logger_name = f"{base}.{name}" if name else base
+    return logging.getLogger(logger_name)
+
+
+# Attach the NullHandler once at import time so that library consumers
+# never see "No handler found" warnings.
+logging.getLogger("wherobots").addHandler(logging.NullHandler())

wherobots/utils/validation.py

@@ -0,0 +1,31 @@
+"""Validation utilities for Wherobots Jobs client."""
+
+import re
+
+from wherobots.exceptions import WherobotsValidationError
+
+NAME_PATTERN = re.compile(r"^[a-zA-Z0-9_.-]+$")
+
+
+def validate_name(name: str) -> str:
+    """Validate that a job name meets Wherobots API requirements.
+
+    Names must be 8-255 characters and contain only alphanumeric
+    characters, underscores, hyphens, and periods.
+
+    Args:
+        name: The job name to validate.
+
+    Returns:
+        The validated name (unchanged).
+
+    Raises:
+        WherobotsValidationError: If the name is too short, too long,
+            or contains invalid characters.
+    """
+    if not 8 <= len(name) <= 255:
+        raise WherobotsValidationError("Name must be 8-255 characters")
+
+    if not NAME_PATTERN.match(name):
+        raise WherobotsValidationError("Name must contain only letters, numbers, _, -, and .")
+    return name

wherobots_python_sdk-0.1.0.dist-info/METADATA

@@ -0,0 +1,580 @@
+Metadata-Version: 2.4
+Name: wherobots-python-sdk
+Version: 0.1.0
+Summary: Python SDK for Wherobots (currently covers the Jobs REST API)
+Author-email: Wherobots <support@wherobots.com>
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://www.wherobots.com
+Project-URL: Repository, https://github.com/wherobots/wherobots-python-sdk
+Project-URL: Issues, https://github.com/wherobots/wherobots-python-sdk/issues
+Project-URL: Documentation, https://docs.wherobots.com
+Keywords: wherobots,spark,sedona,geospatial,jobs,sdk,rest-api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+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
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.33.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.11.1; extra == "dev"
+Requires-Dist: ruff>=0.6.0; extra == "dev"
+Requires-Dist: mypy>=1.5.0; extra == "dev"
+Requires-Dist: types-requests>=2.31; extra == "dev"
+Dynamic: license-file
+
+# Wherobots Python SDK
+
+[![CI](https://github.com/wherobots/wherobots-python-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/wherobots/wherobots-python-sdk/actions/workflows/ci.yml)
+[![Python](https://img.shields.io/badge/python-3.10%2B-blue)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue)](LICENSE)
+[![Version](https://img.shields.io/pypi/v/wherobots-python-sdk?color=orange)](https://pypi.org/project/wherobots-python-sdk/)
+
+The official Python SDK for Wherobots. Currently wraps the
+[Wherobots Jobs REST API](https://docs.wherobots.com/reference/runs) —
+submit, monitor, cancel, and inspect Spark/Sedona job runs from Python.
+Additional Wherobots surfaces will be added over time.
+
+## Features
+
+- Submit Python scripts or JARs as Wherobots jobs
+- Auto-upload local scripts via presigned URLs (only needs an API key)
+- Stream or iterate logs with pagination
+- List runs with status, name, and date filters
+- Typed dataclass models for all API responses (no pydantic dependency)
+- Environment-based configuration
+
+## Installation
+
+```bash
+pip install wherobots-python-sdk
+```
+
+## Quickstart
+
+The simplest way to run a local script — only an API key is needed:
+
+```python
+from wherobots import WherobotsJob
+
+job = WherobotsJob(
+    script="my_analysis.py",       # local file — auto-uploaded via presigned URL
+    name="analysis-job-001",
+    runtime="tiny",
+    region="aws-us-west-2",
+    api_key="wbk_...",             # or set WHEROBOTS_API_KEY env var
+)
+
+run_id = job.submit()
+print("Run ID:", run_id)
+
+# Block until done, streaming logs to stdout
+job.wait_for_completion(stream_logs=True)
+```
+
+You can also pass an S3 URI directly if the script is already uploaded:
+
+```python
+job = WherobotsJob(
+    script="s3://my-bucket/scripts/analysis.py",
+    name="analysis-job-001",
+    runtime="tiny",
+)
+```
+
+### Script Upload Behavior
+
+When `script` is a local file path (not an `s3://` URI) and `auto_upload=True`
+(the default), the SDK uploads your script via a presigned S3 URL to Wherobots
+managed storage. Only needs a valid API key — no AWS credentials required.
+
+You can also reference scripts already in a
+[Storage Integration](https://docs.wherobots.com/latest/develop/storage-management/storage/)
+bucket by passing the S3 URI directly:
+
+```python
+job = WherobotsJob(
+    script="s3://my-integration-bucket/scripts/my_analysis.py",
+    name="analysis-job-001",
+    runtime="tiny",
+    auto_upload=False,
+)
+```
+
+## Authentication
+
+The SDK uses API key authentication via the `X-API-Key` header.
+
+```python
+job = WherobotsJob(
+    script="s3://bucket/script.py",
+    name="my-job-001",
+    api_key="wbk_...",
+)
+```
+
+The API key can also be set via the `WHEROBOTS_API_KEY` environment variable.
+
+## Configuration
+
+### Environment Variables
+
+| Variable                           | Description                     | Default                              |
+|------------------------------------|---------------------------------|--------------------------------------|
+| `WHEROBOTS_API_KEY`                | API key                         | *(required)*                         |
+| `WHEROBOTS_REGION`                 | Default AWS region              | `aws-us-west-2`                      |
+| `WHEROBOTS_API_BASE_URL`          | API base URL                    | `https://api.cloud.wherobots.com`    |
+| `WHEROBOTS_VERSION`               | Wherobots version               | `latest`                             |
+| `WHEROBOTS_REQUEST_TIMEOUT_SECONDS`| HTTP request timeout (seconds) | `30`                                 |
+
+### WherobotsConfig
+
+```python
+from wherobots.config import WherobotsConfig
+
+# Build from env vars with optional overrides
+config = WherobotsConfig.from_env(
+    api_key="wbk_...",
+    region="aws-us-west-2",
+)
+
+# Or construct directly
+config = WherobotsConfig(
+    api_key="wbk_...",
+    region="aws-us-west-2",
+    base_url="https://api.cloud.wherobots.com",
+    request_timeout_seconds=30,
+    version="latest",
+)
+```
+
+| Parameter                  | Type           | Default                             |
+|----------------------------|----------------|-------------------------------------|
+| `api_key`                  | `str \| None`  | `None` (read from env)              |
+| `region`                   | `str \| None`  | `None`                              |
+| `base_url`                 | `str`          | `"https://api.cloud.wherobots.com"` |
+| `version`                  | `str`          | `"latest"`                          |
+| `request_timeout_seconds`  | `int`          | `30`                                |
+
+## SDK Reference
+
+### WherobotsJob
+
+The primary class for managing job runs.
+
+#### Constructor
+
+```python
+WherobotsJob(
+    script: str,                             # Path or S3 URI to .py or .jar
+    name: str,                               # Job name (8-255 chars, [a-zA-Z0-9_\-.]+)
+    runtime: str | Runtime = "tiny",         # Compute size
+    region: str | Region | None = None,      # AWS region
+    api_key: str | None = None,              # API key (or env var)
+    version: str | None = None,              # "latest" | "preview"
+    timeout_seconds: int = 3600,             # Job timeout
+    args: list[str] | None = None,           # Script arguments
+    spark_configs: dict[str, str] | None = None,  # Spark config overrides
+    dependencies: list[dict] | None = None,  # PyPI or file dependencies
+    spark_driver_disk_gb: int | None = None, # Driver disk size (GB)
+    spark_executor_disk_gb: int | None = None, # Executor disk size (GB)
+    jar_main_class: str | None = None,       # Main class (required for JARs)
+    auto_upload: bool = True,                # Upload local files to S3
+    base_url: str | None = None,             # Override API URL
+    request_timeout_seconds: int | None = None,  # HTTP timeout
+    config: WherobotsConfig | None = None,   # Full config object
+)
+```
+
+#### Instance Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `submit()` | `str` | Submit the job. Returns the run ID. Idempotent (returns existing ID if already submitted). |
+| `get_status()` | `RunView` | Get current job status and full details. |
+| `get_logs(cursor=0, size=100)` | `LogsResponse` | Fetch a page of log entries. |
+| `get_metrics()` | `RunMetricsResponse` | Fetch CPU/memory metrics for the run. |
+| `iter_logs(cursor=0, size=100)` | `Iterator[dict]` | Iterate over all log entries, handling pagination automatically. |
+| `poll_for_logs(follow=True, interval=2.0, log_handler=None, max_errors=10)` | `None` | Poll and print logs. If `follow=True`, continues until job completes. `max_errors` sets the max consecutive transient errors before giving up. |
+| `cancel()` | `bool` | Request cancellation. Returns `True` on success. |
+| `wait_for_completion(poll_interval=5.0, stream_logs=True, log_interval=2.0, max_wait_seconds=None)` | `JobStatus` | Block until the job reaches a terminal state. Set `max_wait_seconds` to limit wait time (raises `WherobotsTimeoutError`). |
+| `close()` | `None` | Close the underlying HTTP session and release resources. |
+
+`WherobotsJob` supports the context manager protocol for automatic cleanup:
+
+```python
+with WherobotsJob(script="s3://bucket/script.py", name="my-job") as job:
+    run_id = job.submit()
+    job.wait_for_completion()
+# session is automatically closed
+```
+
+> **Alias:** `Job` is a convenience alias for `WherobotsJob`:
+> ```python
+> from wherobots import Job
+> job = Job(script="s3://bucket/script.py", name="my-job")
+> ```
+
+#### Class Methods
+
+| Method | Returns | Description |
+|--------|---------|-------------|
+| `list_runs(...)` | `RunListPage` | List runs with optional filters. No instance required. |
+| `add_pypi_dependency(name, version)` | `dict` | Create a PyPI dependency dict for the `dependencies` parameter. |
+| `add_file_dependency(file_path)` | `dict` | Create a file dependency dict (`.jar`, `.whl`, `.zip`, `.json`). |
+
+#### Listing Runs
+
+```python
+from wherobots import WherobotsJob, JobStatus
+
+page = WherobotsJob.list_runs(
+    api_key="wbk_...",
+    region="aws-us-west-2",
+    status=[JobStatus.RUNNING, JobStatus.PENDING],
+    name_pattern="etl-*",
+    size=20,
+)
+
+for run in page.items:
+    print(f"{run.id}  {run.name}  {run.status.value}")
+
+# Paginate
+if page.next_page:
+    next_page = WherobotsJob.list_runs(cursor=page.next_page)
+```
+
+#### Dependencies
+
+```python
+from wherobots import WherobotsJob
+
+job = WherobotsJob(
+    script="s3://bucket/script.py",
+    name="dep-test-job",
+    dependencies=[
+        WherobotsJob.add_pypi_dependency("pandas", "2.0.0"),
+        WherobotsJob.add_pypi_dependency("numpy", "1.24.0"),
+        WherobotsJob.add_file_dependency("s3://bucket/libs/my_lib-1.0-py3-none-any.whl"),
+    ],
+    spark_configs={
+        "spark.executor.memory": "4g",
+        "spark.executor.cores": "2",
+    },
+)
+```
+
+#### JAR Jobs
+
+```python
+job = WherobotsJob(
+    script="s3://bucket/jars/my-app.jar",
+    name="jar-job-001",
+    jar_main_class="com.example.Main",
+    args=["--input", "s3://data/input", "--output", "s3://data/output"],
+    runtime="medium",
+)
+```
+
+## Enums
+
+### JobStatus
+
+| Value        | Terminal | Description     |
+|--------------|----------|-----------------|
+| `PENDING`    | No       | Queued          |
+| `RUNNING`    | No       | Executing       |
+| `COMPLETED`  | Yes      | Finished OK     |
+| `FAILED`     | Yes      | Errored out     |
+| `CANCELLED`  | Yes      | User cancelled  |
+
+```python
+from wherobots import JobStatus
+
+status = JobStatus.RUNNING
+status.is_terminal  # False
+```
+
+### Runtime
+
+Available compute sizes (API string values):
+
+| Enum                        | Value                  |
+|-----------------------------|------------------------|
+| `Runtime.MICRO`             | `micro`                |
+| `Runtime.TINY`              | `tiny`                 |
+| `Runtime.SMALL`             | `small`                |
+| `Runtime.MEDIUM`            | `medium`               |
+| `Runtime.LARGE`             | `large`                |
+| `Runtime.X_LARGE`           | `x-large`              |
+| `Runtime.DOUBLE_X_LARGE`    | `2x-large`             |
+| `Runtime.QUAD_X_LARGE`      | `4x-large`             |
+| `Runtime.MEDIUM_HIMEM`      | `medium-himem`         |
+| `Runtime.LARGE_HIMEM`       | `large-himem`          |
+| `Runtime.X_LARGE_HIMEM`     | `x-large-himem`        |
+| `Runtime.DOUBLE_X_LARGE_HIMEM` | `2x-large-himem`    |
+| `Runtime.QUAD_X_LARGE_HIMEM`| `4x-large-himem`       |
+| `Runtime.X_LARGE_HICPU`     | `x-large-hicpu`        |
+| `Runtime.DOUBLE_X_LARGE_HICPU` | `2x-large-hicpu`    |
+| `Runtime.X_LARGE_MATCHER`   | `x-large-matcher`      |
+| `Runtime.DOUBLE_X_LARGE_MATCHER` | `2x-large-matcher` |
+| `Runtime.MICRO_A10_GPU`     | `micro-a10-gpu`        |
+| `Runtime.TINY_A10_GPU`      | `tiny-a10-gpu`         |
+| `Runtime.SMALL_A10_GPU`     | `small-a10-gpu`        |
+| `Runtime.MEDIUM_A10_GPU`    | `medium-a10-gpu`       |
+| `Runtime.LARGE_A10_GPU`     | `large-a10-gpu`        |
+| `Runtime.X_LARGE_A10_GPU`   | `x-large-a10-gpu`      |
+
+```python
+from wherobots import Runtime
+
+job = WherobotsJob(
+    script="s3://bucket/script.py",
+    name="gpu-job-001",
+    runtime=Runtime.SMALL_A10_GPU,
+)
+```
+
+### Region
+
+| Enum               | Value             |
+|--------------------|-------------------|
+| `Region.US_WEST_2` | `aws-us-west-2`  |
+| `Region.US_EAST_1` | `aws-us-east-1`  |
+| `Region.EU_WEST_1` | `aws-eu-west-1`  |
+| `Region.AP_SOUTH_1`| `aws-ap-south-1` |
+
+### DependencyType
+
+| Enum                  | Value  |
+|-----------------------|--------|
+| `DependencyType.PYPI` | `PYPI` |
+| `DependencyType.FILE` | `FILE` |
+
+### DependencyFileType
+
+| Enum                          | Value          |
+|-------------------------------|----------------|
+| `DependencyFileType.JAR`      | `JAR`          |
+| `DependencyFileType.PYTHON_WHEEL` | `PYTHON_WHEEL` |
+| `DependencyFileType.ZIP`      | `ZIP`          |
+| `DependencyFileType.OTHER`    | `OTHER`        |
+
+## Models
+
+All models are Python dataclasses with `from_dict()` and `to_dict()` methods
+for JSON round-tripping.
+
+### RunView
+
+Returned by `get_status()` and `list_runs()`. Represents a single job run.
+
+| Field              | Type                      | Description                    |
+|--------------------|---------------------------|--------------------------------|
+| `id`               | `str`                     | Run ID                         |
+| `name`             | `str`                     | Job name                       |
+| `status`           | `JobStatus \| None`       | Current status                 |
+| `runtime`          | `str \| None`             | Compute runtime size           |
+| `region`           | `str \| None`             | AWS region                     |
+| `version`          | `str \| None`             | Wherobots version              |
+| `timeout_seconds`  | `int \| None`             | Job timeout                    |
+| `create_time`      | `str \| None`             | ISO-8601 creation timestamp    |
+| `update_time`      | `str \| None`             | ISO-8601 last update timestamp |
+| `start_time`       | `str \| None`             | ISO-8601 start timestamp       |
+| `complete_time`    | `str \| None`             | ISO-8601 completion timestamp  |
+| `run_python`       | `RunPythonPayload \| None`| Python script payload          |
+| `run_jar`          | `RunJarPayload \| None`   | JAR payload                    |
+| `environment`      | `RunEnvironment \| None`  | Spark config & dependencies    |
+| `triggered_by`     | `dict \| None`            | User who triggered the run     |
+| `kube_app`         | `RunKubeApp \| None`      | Kubernetes app details         |
+| `app_meta`         | `RunAppMeta \| None`      | Spark/Sedona UI URLs           |
+| `organization`     | `OrganizationCustomer \| None` | Org info                  |
+| `extra`            | `dict`                    | Any additional API fields      |
+
+### LogsResponse
+
+Returned by `get_logs()`.
+
+| Field          | Type                   | Description                  |
+|----------------|------------------------|------------------------------|
+| `items`        | `list[LogItem]`        | Log entries                  |
+| `next_page`    | `int \| str \| None`   | Next page cursor             |
+| `current_page` | `int \| str \| None`   | Current page cursor          |
+
+### LogItem
+
+| Field       | Type                   | Description                     |
+|-------------|------------------------|---------------------------------|
+| `raw`       | `str`                  | Raw log line text               |
+| `timestamp` | `int \| str \| None`   | Epoch int or ISO-8601 string    |
+| `level`     | `str \| None`          | Log level (INFO, ERROR, etc.)   |
+| `message`   | `str \| None`          | Parsed message                  |
+| `extra`     | `dict`                 | Additional fields               |
+
+### RunListPage
+
+Returned by `list_runs()`.
+
+| Field                    | Type              | Description                    |
+|--------------------------|-------------------|--------------------------------|
+| `items`                  | `list[RunView]`   | Runs on this page              |
+| `total`                  | `int`             | Total matching runs            |
+| `next_page`              | `str \| None`     | Next page cursor               |
+| `previous_page`          | `str \| None`     | Previous page cursor           |
+| `current_page`           | `str \| None`     | Current page cursor            |
+| `current_page_backwards` | `str \| None`     | Backward pagination cursor     |
+
+### RunMetricsResponse
+
+Returned by `get_metrics()`.
+
+| Field             | Type   | Description              |
+|-------------------|--------|--------------------------|
+| `series_metrics`  | `dict` | Time-series metrics      |
+| `instant_metrics` | `dict` | Point-in-time metrics    |
+| `extra`           | `dict` | Additional fields        |
+
+## Exceptions
+
+All exceptions inherit from `WherobotsJobError`.
+
+| Exception                  | Description                                          |
+|----------------------------|------------------------------------------------------|
+| `WherobotsJobError`        | Base exception for all SDK errors.                   |
+| `WherobotsAPIError`        | API returned an error response. Has `status_code`, `response`, `request_id` attributes. |
+| `WherobotsValidationError` | Client-side validation failed (e.g., invalid name).  |
+| `WherobotsS3Error`         | S3 upload or access operation failed. Deprecated — presigned uploads raise `WherobotsAPIError` instead. |
+| `WherobotsConfigError`     | Configuration is missing or invalid.                 |
+| `WherobotsTimeoutError`    | Job exceeded the specified timeout.                  |
+
+```python
+from wherobots import WherobotsAPIError, WherobotsJobError
+
+try:
+    job.submit()
+except WherobotsAPIError as e:
+    print(f"HTTP {e.status_code}: {e}")
+    print(f"Request ID: {e.request_id}")
+except WherobotsJobError as e:
+    print(f"Error: {e}")
+```
+
+## Storage Integrations
+
+The SDK can run scripts stored in
+[Storage Integrations](https://docs.wherobots.com/latest/develop/storage-management/storage/) —
+user-configured S3 buckets registered with your Wherobots organization. Pass the
+S3 URI directly as the `script` parameter:
+
+```python
+job = WherobotsJob(
+    script="s3://my-integration-bucket/scripts/pipeline.py",
+    name="pipeline-job-001",
+    runtime="small",
+    auto_upload=False,
+)
+```
+
+To discover your integration paths programmatically:
+
+```python
+from wherobots.api.files import FilesAPI
+from wherobots.config import WherobotsConfig
+
+config = WherobotsConfig.from_env()
+with FilesAPI.from_config(config) as files_api:
+    for si in files_api.list_integrations():
+        print(f"{si.name}: {si.path} ({si.region})")
+```
+
+To set up a Storage Integration, follow the
+[S3 Storage Integration guide](https://docs.wherobots.com/latest/develop/storage-management/s3-storage-integration/).
+
+## API Endpoints
+
+| Method | Endpoint               | Description        |
+|--------|------------------------|--------------------|
+| POST   | `/runs?region=<region>`| Create a run       |
+| GET    | `/runs/{id}`           | Get run details    |
+| POST   | `/runs/{id}/cancel`    | Cancel a run       |
+| GET    | `/runs/{id}/logs`      | Get run logs       |
+| GET    | `/runs/{id}/metrics`   | Get run metrics    |
+| GET    | `/runs`                | List runs          |
+
+Base URL: `https://api.cloud.wherobots.com`
+
+## Development
+
+### Setup
+
+```bash
+git clone https://github.com/wherobots/wherobots-python-sdk.git
+cd wherobots-python-sdk
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+pre-commit install
+```
+
+### Quality checks
+
+```bash
+make lint        # ruff check + ruff format --check
+make format      # auto-fix lint issues and reformat
+make typecheck   # mypy (strict)
+make check       # lint + typecheck + tests + build
+```
+
+### Releasing
+
+See [`RELEASING.md`](RELEASING.md) for the release flow (version
+bump → GitHub release → automated PyPI publish).
+
+### Running Tests
+
+```bash
+make test               # unit tests (integration tests skipped by default)
+
+# Or directly:
+pytest -o "addopts="    # override pyproject.toml --cov flags if pytest-cov missing
+pytest -v               # verbose
+pytest --cov=wherobots --cov-report=term-missing  # with coverage
+```
+
+#### Integration Tests
+
+Integration tests run against the live Wherobots API and are **skipped by
+default**. To run them:
+
+```bash
+export WHEROBOTS_API_KEY="your-key"
+make test-integration
+
+# Or pass the key via CLI option:
+pytest -m integration -v -o "addopts=" --wherobots-api-key="your-key"
+```
+
+### Linting & Formatting
+
+```bash
+make format             # auto-format with ruff
+make lint               # ruff check + ruff format --check (same as CI)
+```
+
+### Before You Push
+
+```bash
+make check              # lint + test + build — mirrors the CI pipeline
+```
+
+## License
+
+Apache-2.0. See [LICENSE](LICENSE) for details.

wherobots_python_sdk-0.1.0.dist-info/RECORD

@@ -0,0 +1,20 @@
+wherobots/__init__.py,sha256=UGvPiw86dJwrZiA-7u-Nx4thyZj7QmdOio343-vscHg,1754
+wherobots/__version__.py,sha256=gdQx5awJ980s8gFK_3u0b4RogasTty0-FJ6cROVHjZo,111
+wherobots/client.py,sha256=go2-usZMWm74zUXupiy5k-M3Faprn_WJaH1wK0Sr0po,23467
+wherobots/config.py,sha256=Ib20Y5mGsE4aP_g99ZKEyZvV8q-aOXq7RVpYP8i0lpo,6679
+wherobots/enums.py,sha256=YsxXN3ZcY99aoEsUtjYs4otHDevsSPizAgCp-vShds8,4154
+wherobots/exceptions.py,sha256=ERoTU7Edf-dFCE4-ScyuEcC-2O2d5JRa8issQWc-PNA,1296
+wherobots/models.py,sha256=RKmxMpHTLzhOdb3FcvxWLgrxjpSCBpuc9l-BacbqLl4,35673
+wherobots/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+wherobots/api/__init__.py,sha256=jUb587jazP_FA-sH_6yCYfvGxsNiUOyIYAPb3CHOYtQ,218
+wherobots/api/base.py,sha256=IiT3k17G19bT0rM2zYZs9Tpob8pgTrSLAWdKlLUVM1o,8769
+wherobots/api/files.py,sha256=c2yGQ-yQKzvp1O-47JrFp1H6Uj7FDCBRiyJ0ym8g-TE,14040
+wherobots/api/runs.py,sha256=25Hz0evE0gfu7YCQma77AcxAbrk89iKgzdoE0XFJr7U,8442
+wherobots/utils/__init__.py,sha256=cTM2QNJDauQWyGBTJPE5yH4ULc4Ucg_4KFzemjM3HaA,193
+wherobots/utils/logger.py,sha256=eclhD9Vf2LsSm4engRzT3jE2v0wdHJH01OfeI3ml4HM,1103
+wherobots/utils/validation.py,sha256=R0iG4OqzER4prdP8-TOQV_pQFJ3emEQyWYYuc3aCefU,890
+wherobots_python_sdk-0.1.0.dist-info/licenses/LICENSE,sha256=U1EH466XmvxbqaWOY0cax49w0R87_6w6yJLyV14v4bc,10767
+wherobots_python_sdk-0.1.0.dist-info/METADATA,sha256=EH_LfjKliEImWBAi3a2t2a5HvbvokyzpIsqV0p-jqWI,21512
+wherobots_python_sdk-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+wherobots_python_sdk-0.1.0.dist-info/top_level.txt,sha256=oL-n-9GIG0rmUeukuytUqdN6yfROIsVh8bNrgZsOdxw,10
+wherobots_python_sdk-0.1.0.dist-info/RECORD,,

wherobots_python_sdk-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+