wherobots-python-sdk 0.1.0__tar.gz → 0.2.0__tar.gz

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wherobots-python-sdk
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python SDK for Wherobots (currently covers the Jobs REST API)
 Author-email: Wherobots <support@wherobots.com>
 License-Expression: Apache-2.0
@@ -130,7 +130,7 @@ The API key can also be set via the `WHEROBOTS_API_KEY` environment variable.
 | Variable                           | Description                     | Default                              |
 |------------------------------------|---------------------------------|--------------------------------------|
 | `WHEROBOTS_API_KEY`                | API key                         | *(required)*                         |
-| `WHEROBOTS_REGION`                 | Default AWS region              | `aws-us-west-2`                      |
+| `WHEROBOTS_REGION`                 | Region override (else org default) | *(none — org default)*            |
 | `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`                                 |
@@ -176,8 +176,8 @@ The primary class for managing job runs.
 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
+    runtime: str | Runtime | None = None,    # Compute size (None -> org default)
+    region: str | Region | None = None,      # Region; str passed as-is (None -> org default)
     api_key: str | None = None,              # API key (or env var)
     version: str | None = None,              # "latest" | "preview"
     timeout_seconds: int = 3600,             # Job timeout

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/README.md

@@ -97,7 +97,7 @@ The API key can also be set via the `WHEROBOTS_API_KEY` environment variable.
 | Variable                           | Description                     | Default                              |
 |------------------------------------|---------------------------------|--------------------------------------|
 | `WHEROBOTS_API_KEY`                | API key                         | *(required)*                         |
-| `WHEROBOTS_REGION`                 | Default AWS region              | `aws-us-west-2`                      |
+| `WHEROBOTS_REGION`                 | Region override (else org default) | *(none — org default)*            |
 | `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`                                 |
@@ -143,8 +143,8 @@ The primary class for managing job runs.
 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
+    runtime: str | Runtime | None = None,    # Compute size (None -> org default)
+    region: str | Region | None = None,      # Region; str passed as-is (None -> org default)
     api_key: str | None = None,              # API key (or env var)
     version: str | None = None,              # "latest" | "preview"
     timeout_seconds: int = 3600,             # Job timeout

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/tests/test_api.py

@@ -145,6 +145,21 @@ class TestCreate:
         assert "/runs" in call_args[0][1]
         assert call_args[1]["params"]["region"] == "aws-us-east-1"
 
+    def test_omits_region_when_not_provided(self, api, mock_session):
+        mock_session.request.return_value = _make_response(
+            {"id": "r2", "name": "t", "status": "PENDING"}
+        )
+        payload = CreateRunPayload(
+            name="default-region-job",
+            run_python=RunPythonPayload(uri="s3://b/s.py"),
+        )
+        api.create(payload)  # no region -> API applies org default
+
+        call_kwargs = mock_session.request.call_args[1]
+        assert "region" not in call_kwargs["params"]
+        # runtime omitted from the body too -> org default applies
+        assert "runtime" not in call_kwargs["json"]
+
     def test_sends_payload_as_json(self, api, mock_session):
         mock_session.request.return_value = _make_response(
             {"id": "r1", "name": "test", "status": "PENDING"}

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/tests/test_client.py

@@ -69,6 +69,37 @@ def test_build_payload_jar_job(mock_env):
     assert payload.run_python is None
 
 
+def test_no_region_or_runtime_uses_no_default(monkeypatch, mock_api_key):
+    """When neither arg, config, nor env supplies region/runtime, they stay
+    unset so the API applies the organization's configured defaults."""
+    monkeypatch.setenv("WHEROBOTS_API_KEY", mock_api_key)
+    monkeypatch.delenv("WHEROBOTS_REGION", raising=False)
+
+    job = WherobotsJob(script="s3://test-bucket/test-script.py", name="defaults-job")
+
+    assert job.region is None
+    assert job.runtime is None
+    payload = job._build_payload()
+    assert payload.runtime is None
+    assert "runtime" not in payload.to_dict()
+
+
+def test_string_region_runtime_passthrough(monkeypatch, mock_api_key):
+    """Raw region/runtime strings (e.g. BYOC regions) are kept as-is."""
+    monkeypatch.setenv("WHEROBOTS_API_KEY", mock_api_key)
+    monkeypatch.delenv("WHEROBOTS_REGION", raising=False)
+
+    job = WherobotsJob(
+        script="s3://test-bucket/test-script.py",
+        name="byoc-job",
+        runtime="x-large",
+        region="byoc-acme-us-east-1",
+    )
+
+    assert job.region == "byoc-acme-us-east-1"
+    assert job.runtime == "x-large"
+
+
 def test_submit_sets_run_id(mock_env, sample_job_config):
     job = WherobotsJob(**sample_job_config)
 

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/tests/test_models.py

@@ -196,6 +196,16 @@ class TestCreateRunPayload:
         out = payload.to_dict()
         assert "environment" not in out
 
+    def test_runtime_omitted_when_none(self):
+        payload = CreateRunPayload(name="no-runtime")
+        out = payload.to_dict()
+        assert "runtime" not in out
+
+    def test_runtime_included_when_set(self):
+        payload = CreateRunPayload(name="with-runtime", runtime="large")
+        out = payload.to_dict()
+        assert out["runtime"] == "large"
+
 
 # ---------------------------------------------------------------------------
 # RunView

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/wherobots/__version__.py

@@ -1,5 +1,5 @@
 """Version information."""
 
-__version__ = "0.1.0"
+__version__ = "0.2.0"
 __author__ = "Wherobots"
 __email__ = "support@wherobots.com"

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/wherobots/api/runs.py

@@ -101,15 +101,15 @@ class RunsAPI:
     def create(
         self,
         payload: CreateRunPayload,
-        region: str = "aws-us-west-2",
+        region: str | None = None,
     ) -> RunView:
         """Submit a new job run (``POST /runs``).
 
         Args:
             payload: The run configuration including script/JAR
                 details, runtime, and resource settings.
-            region: Wherobots deployment region (default
-                ``"aws-us-west-2"``).
+            region: Wherobots deployment region. When omitted, the API
+                applies the organization's configured default region.
 
         Returns:
             A ``RunView`` representing the created run.
@@ -117,9 +117,11 @@ class RunsAPI:
         Raises:
             WherobotsAPIError: On HTTP or JSON-parsing failures.
         """
-        params = {"region": region}
+        params = {}
+        if region:
+            params["region"] = region
         body = payload.to_dict()
-        logger.info("Creating run '%s' in %s", payload.name, region)
+        logger.info("Creating run '%s' in %s", payload.name, region or "org default")
         response = self._client.post("/runs", params=params, json_body=body)
         return RunView.from_dict(self._parse_json(response))
 

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/wherobots/client.py

@@ -58,7 +58,7 @@ class WherobotsJob:
         self,
         script: str,
         name: str,
-        runtime: str | Runtime = "tiny",
+        runtime: str | Runtime | None = None,
         region: str | Region | None = None,
         api_key: str | None = None,
         version: str | None = None,
@@ -82,8 +82,19 @@ class WherobotsJob:
             script: Path to Python script (.py) or JAR file (.jar).
                    Can be local path or S3 URI (s3://bucket/key)
             name: Job name (8-255 chars, alphanumeric, _, -, .)
-            runtime: Compute runtime size (default: "tiny")
-            region: AWS region (default: from config or env)
+            runtime: The compute runtime to use. Accepts a ``Runtime`` enum
+                value or a raw string; strings are passed to the API as-is.
+                Override the default runtime set for your organization — only
+                set this if you need a specific runtime instead of the one your
+                administrator has configured. When omitted, your organization's
+                default runtime is used.
+            region: The compute region to run in. Accepts a ``Region`` enum
+                value or a raw string (e.g. a BYOC region such as
+                ``byoc-acme-us-east-1``); strings are passed to the API as-is.
+                Override the default region set for your organization — only set
+                this if you intend to use a specific region instead of the one
+                your administrator has configured. When omitted, your
+                organization's default region is used.
             api_key: Wherobots API key (or set WHEROBOTS_API_KEY env var)
             version: Wherobots version ("latest" or "preview")
             timeout_seconds: Job timeout in seconds (default: 3600)
@@ -138,7 +149,9 @@ class WherobotsJob:
             request_timeout_seconds=request_timeout_seconds,
         )
 
-        self.region = region_value or self._config.region or "aws-us-west-2"
+        # No hardcoded fallback: when neither the argument nor the config
+        # supplies a region, leave it unset so the API applies the org default.
+        self.region = region_value or self._config.region
         self.version = version or self._config.version
         self.timeout_seconds = timeout_seconds
         self.args = args or []

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/wherobots/models.py

@@ -244,8 +244,8 @@ class RunJarPayload:
 class CreateRunPayload:
     """Full payload for ``POST /runs``."""
 
-    runtime: str
     name: str
+    runtime: str | None = None
     version: str = "latest"
     timeout_seconds: int = 3600
     run_python: RunPythonPayload | None = None
@@ -259,11 +259,13 @@ class CreateRunPayload:
             Dict suitable for ``POST /runs`` request body.
         """
         d: dict[str, Any] = {
-            "runtime": self.runtime,
             "name": self.name,
             "version": self.version,
             "timeoutSeconds": self.timeout_seconds,
         }
+        # Omit runtime when unset so the API applies the org default.
+        if self.runtime is not None:
+            d["runtime"] = self.runtime
         if self.run_python is not None:
             d["runPython"] = self.run_python.to_dict()
         if self.run_jar is not None:
@@ -296,7 +298,7 @@ class CreateRunPayload:
         if "environment" in data and data["environment"] is not None:
             environment = RunEnvironment.from_dict(data["environment"])
         return cls(
-            runtime=data.get("runtime", ""),
+            runtime=data.get("runtime"),
             name=data.get("name", ""),
             version=data.get("version", "latest"),
             timeout_seconds=data.get("timeoutSeconds", 3600),

{wherobots_python_sdk-0.1.0 → wherobots_python_sdk-0.2.0}/wherobots_python_sdk.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wherobots-python-sdk
-Version: 0.1.0
+Version: 0.2.0
 Summary: Python SDK for Wherobots (currently covers the Jobs REST API)
 Author-email: Wherobots <support@wherobots.com>
 License-Expression: Apache-2.0
@@ -130,7 +130,7 @@ The API key can also be set via the `WHEROBOTS_API_KEY` environment variable.
 | Variable                           | Description                     | Default                              |
 |------------------------------------|---------------------------------|--------------------------------------|
 | `WHEROBOTS_API_KEY`                | API key                         | *(required)*                         |
-| `WHEROBOTS_REGION`                 | Default AWS region              | `aws-us-west-2`                      |
+| `WHEROBOTS_REGION`                 | Region override (else org default) | *(none — org default)*            |
 | `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`                                 |
@@ -176,8 +176,8 @@ The primary class for managing job runs.
 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
+    runtime: str | Runtime | None = None,    # Compute size (None -> org default)
+    region: str | Region | None = None,      # Region; str passed as-is (None -> org default)
     api_key: str | None = None,              # API key (or env var)
     version: str | None = None,              # "latest" | "preview"
     timeout_seconds: int = 3600,             # Job timeout