opencomputer-sdk 1.0.0__tar.gz → 1.2.0__tar.gz

{opencomputer_sdk-1.0.0 → opencomputer_sdk-1.2.0}/.gitignore

@@ -97,3 +97,4 @@ cloudflare-workers/api-edge/wrangler.ci.toml
 
 .dev.vars*
 !.dev.vars.example
+cloudflare-workers/api-edge/wrangler.*.generated.jsonc

{opencomputer_sdk-1.0.0 → opencomputer_sdk-1.2.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.5
 Name: opencomputer-sdk
-Version: 1.0.0
-Summary: Python SDK for OpenComputer - cloud sandbox platform
+Version: 1.2.0
+Summary: Deprecated: Python SDK for the retired OpenComputer sandbox platform. 1.2.0 is the final release.
 Project-URL: Homepage, https://github.com/diggerhq/opensandbox
 Project-URL: Repository, https://github.com/diggerhq/opensandbox
 Project-URL: Documentation, https://github.com/diggerhq/opensandbox/tree/main/sdks/python
@@ -9,7 +9,7 @@ Project-URL: Issues, https://github.com/diggerhq/opensandbox/issues
 Author: OpenComputer
 License-Expression: MIT
 Keywords: cloud,code-execution,containers,opencomputer,sandbox
-Classifier: Development Status :: 3 - Alpha
+Classifier: Development Status :: 7 - Inactive
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
@@ -28,6 +28,10 @@ Description-Content-Type: text/markdown
 
 # opencomputer
 
+> **Deprecated.** `opencomputer-sdk` 1.2.0 is the final release; the package receives no further updates. It is a client for the OpenComputer sandbox platform, which is shut down. Importing `opencomputer` emits a `FutureWarning`.
+>
+> There is no Python replacement. For [Serverless Agents](https://opencomputer.dev/agents) call the [management API](https://opencomputer.dev/agents/api) over HTTP, or use the TypeScript client `@opencomputer/sdk/agents` (`npm install @opencomputer/sdk`). Pinning `opencomputer-sdk<1.2` avoids the warning.
+
 Python SDK for [OpenComputer](https://github.com/diggerhq/opensandbox) — cloud sandbox platform.
 
 ## Install

{opencomputer_sdk-1.0.0 → opencomputer_sdk-1.2.0}/README.md

@@ -1,5 +1,9 @@
 # opencomputer
 
+> **Deprecated.** `opencomputer-sdk` 1.2.0 is the final release; the package receives no further updates. It is a client for the OpenComputer sandbox platform, which is shut down. Importing `opencomputer` emits a `FutureWarning`.
+>
+> There is no Python replacement. For [Serverless Agents](https://opencomputer.dev/agents) call the [management API](https://opencomputer.dev/agents/api) over HTTP, or use the TypeScript client `@opencomputer/sdk/agents` (`npm install @opencomputer/sdk`). Pinning `opencomputer-sdk<1.2` avoids the warning.
+
 Python SDK for [OpenComputer](https://github.com/diggerhq/opensandbox) — cloud sandbox platform.
 
 ## Install

{opencomputer_sdk-1.0.0 → opencomputer_sdk-1.2.0}/opencomputer/__init__.py

@@ -1,4 +1,17 @@
-"""OpenComputer Python SDK - cloud sandbox platform."""
+"""OpenComputer Python SDK - cloud sandbox platform. Deprecated: 1.2.0 is the final release."""
+
+import warnings as _warnings
+
+#: Shown once per process, on the first ``import opencomputer``. A
+#: FutureWarning, not a DeprecationWarning: Python's default filters show it
+#: to end users wherever the import happens, not only in ``__main__``.
+DEPRECATION_MESSAGE = (
+    "opencomputer-sdk is deprecated and receives no further releases: the "
+    "OpenComputer sandbox platform it targets is shut down. For Serverless "
+    "Agents use the management API (https://opencomputer.dev/agents/api) or "
+    "the TypeScript client @opencomputer/sdk/agents (npm install @opencomputer/sdk)."
+)
+_warnings.warn(DEPRECATION_MESSAGE, FutureWarning, stacklevel=2)
 
 from opencomputer.sandbox import Sandbox, ScalingLockedError, PlanLimitError, SandboxFamilyLimitError
 from opencomputer.browser import Browser, BrowserProfile

{opencomputer_sdk-1.0.0 → opencomputer_sdk-1.2.0}/opencomputer/sandbox.py

@@ -77,6 +77,18 @@ class Sandbox:
     #: a successful ``rotate_preview_auth_token()`` this value is replaced
     #: with the new token. Empty string when not enabled or when reconnecting.
     preview_auth_token: str = ""
+    #: RFC3339 instant at which the provider destroys this sandbox's host, or
+    #: ``None`` when the runtime imposes no lifetime.
+    #:
+    #: Two uses. It is the deadline to plan against — checkpoint and roll over
+    #: before it, because the disk goes with the host. And because only some
+    #: runtimes have one, its presence identifies which runtime served the
+    #: create, which is what the upgrade guide's smoke test checks.
+    #:
+    #: Read this rather than computing a deadline from the create time:
+    #: sandboxes are served from a warm pool, so the host is usually older
+    #: than the create.
+    end_at: str | None = None
     _api_url: str = ""
     _api_key: str = ""
     _connect_url: str = ""
@@ -219,6 +231,7 @@ class Sandbox:
             status=data.get("status", "running"),
             template=template,
             preview_auth_token=data.get("previewAuthToken", ""),
+            end_at=data.get("endAt"),
             _api_url=url,
             _api_key=key,
             _connect_url=connect_url,
@@ -278,6 +291,7 @@ class Sandbox:
             sandbox_id=sandbox_id,
             status=data.get("status", "running"),
             template=data.get("templateID", ""),
+            end_at=data.get("endAt"),
             _api_url=url,
             _api_key=key,
             _connect_url=connect_url,
@@ -748,6 +762,10 @@ class Sandbox:
         return cls(
             sandbox_id=data["sandboxID"],
             status=data.get("status", "running"),
+            # Absent on the runtime that serves this call today, but populated
+            # rather than dropped so a reader does not have to wonder why one
+            # constructor omits it.
+            end_at=data.get("endAt"),
             _api_url=url,
             _api_key=key,
             _connect_url=connect_url,

{opencomputer_sdk-1.0.0 → opencomputer_sdk-1.2.0}/opencomputer/version.py

@@ -26,7 +26,7 @@ this docstring start with that name: two readers of this file are greps.
 
 from __future__ import annotations
 
-__version__ = "1.0.0"
+__version__ = "1.2.0"
 
 #: Header carrying the version above. Lower-case to match the TypeScript SDK;
 #: HTTP/2 requires it there and consistency costs nothing here.

{opencomputer_sdk-1.0.0 → opencomputer_sdk-1.2.0}/pyproject.toml

@@ -8,7 +8,7 @@ name = "opencomputer-sdk"
 # server in x-oc-sdk-version. One source, so the published version and the
 # routed-on version cannot disagree.
 dynamic = ["version"]
-description = "Python SDK for OpenComputer - cloud sandbox platform"
+description = "Deprecated: Python SDK for the retired OpenComputer sandbox platform. 1.2.0 is the final release."
 readme = "README.md"
 requires-python = ">=3.10"
 license = "MIT"
@@ -17,7 +17,7 @@ authors = [
 ]
 keywords = ["sandbox", "opencomputer", "cloud", "containers", "code-execution"]
 classifiers = [
-    "Development Status :: 3 - Alpha",
+    "Development Status :: 7 - Inactive",
     "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",

opencomputer_sdk-1.2.0/tests/test_deprecation.py

@@ -0,0 +1,37 @@
+import importlib
+import sys
+import warnings
+
+import pytest
+
+
+def _fresh_import():
+    for name in [m for m in sys.modules if m == "opencomputer" or m.startswith("opencomputer.")]:
+        del sys.modules[name]
+    return importlib.import_module("opencomputer")
+
+
+def test_import_warns_deprecated_and_points_to_replacement():
+    with pytest.warns(FutureWarning, match="deprecated") as record:
+        mod = _fresh_import()
+    message = str(record[0].message)
+    assert "@opencomputer/sdk/agents" in message
+    assert "https://opencomputer.dev/agents/api" in message
+    assert mod.DEPRECATION_MESSAGE == message
+
+
+def test_final_release_version_stays_on_major_1():
+    # The server routes on the SDK's major (x-oc-sdk-version); the deprecation
+    # release must not move callers.
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore", FutureWarning)
+        mod = _fresh_import()
+    assert mod.__version__ == "1.2.0"
+
+
+def test_existing_exports_still_import():
+    with warnings.catch_warnings():
+        warnings.simplefilter("ignore", FutureWarning)
+        mod = _fresh_import()
+    for name in mod.__all__:
+        assert hasattr(mod, name), name