hyperbrowser 0.86.0__tar.gz → 0.87.0__tar.gz

{hyperbrowser-0.86.0 → hyperbrowser-0.87.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: hyperbrowser
-Version: 0.86.0
+Version: 0.87.0
 Summary: Python SDK for hyperbrowser
 License: MIT
 License-File: LICENSE

{hyperbrowser-0.86.0 → hyperbrowser-0.87.0}/hyperbrowser/client/managers/async_manager/sandbox.py

@@ -7,9 +7,14 @@ from ....models.sandbox import (
     SandboxExecParams,
     SandboxExposeParams,
     SandboxExposeResult,
+    SandboxImageListResponse,
+    SandboxListParams,
+    SandboxListResponse,
     SandboxMemorySnapshotParams,
     SandboxMemorySnapshotResult,
     SandboxRuntimeSession,
+    SandboxSnapshotListParams,
+    SandboxSnapshotListResponse,
     StartSandboxFromSnapshotParams,
 )
 from ....models.session import BasicResponse
@@ -288,6 +293,34 @@ class SandboxManager:
         await sandbox.connect()
         return sandbox
 
+    async def list(
+        self, params: SandboxListParams = SandboxListParams()
+    ) -> SandboxListResponse:
+        if not isinstance(params, SandboxListParams):
+            raise TypeError("params must be a SandboxListParams instance")
+        payload = await self._request(
+            "GET",
+            "/sandboxes",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxListResponse(**payload)
+
+    async def list_images(self) -> SandboxImageListResponse:
+        payload = await self._request("GET", "/images")
+        return SandboxImageListResponse(**payload)
+
+    async def list_snapshots(
+        self, params: SandboxSnapshotListParams = SandboxSnapshotListParams()
+    ) -> SandboxSnapshotListResponse:
+        if not isinstance(params, SandboxSnapshotListParams):
+            raise TypeError("params must be a SandboxSnapshotListParams instance")
+        payload = await self._request(
+            "GET",
+            "/snapshots",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxSnapshotListResponse(**payload)
+
     async def stop(self, sandbox_id: str) -> BasicResponse:
         payload = await self._request("PUT", f"/sandbox/{sandbox_id}/stop")
         return BasicResponse(**payload)

{hyperbrowser-0.86.0 → hyperbrowser-0.87.0}/hyperbrowser/client/managers/sync_manager/sandbox.py

@@ -7,9 +7,14 @@ from ....models.sandbox import (
     SandboxExecParams,
     SandboxExposeParams,
     SandboxExposeResult,
+    SandboxImageListResponse,
+    SandboxListParams,
+    SandboxListResponse,
     SandboxMemorySnapshotParams,
     SandboxMemorySnapshotResult,
     SandboxRuntimeSession,
+    SandboxSnapshotListParams,
+    SandboxSnapshotListResponse,
     StartSandboxFromSnapshotParams,
 )
 from ....models.session import BasicResponse
@@ -288,6 +293,34 @@ class SandboxManager:
         sandbox.connect()
         return sandbox
 
+    def list(
+        self, params: SandboxListParams = SandboxListParams()
+    ) -> SandboxListResponse:
+        if not isinstance(params, SandboxListParams):
+            raise TypeError("params must be a SandboxListParams instance")
+        payload = self._request(
+            "GET",
+            "/sandboxes",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxListResponse(**payload)
+
+    def list_images(self) -> SandboxImageListResponse:
+        payload = self._request("GET", "/images")
+        return SandboxImageListResponse(**payload)
+
+    def list_snapshots(
+        self, params: SandboxSnapshotListParams = SandboxSnapshotListParams()
+    ) -> SandboxSnapshotListResponse:
+        if not isinstance(params, SandboxSnapshotListParams):
+            raise TypeError("params must be a SandboxSnapshotListParams instance")
+        payload = self._request(
+            "GET",
+            "/snapshots",
+            params=params.model_dump(exclude_none=True, by_alias=True),
+        )
+        return SandboxSnapshotListResponse(**payload)
+
     def stop(self, sandbox_id: str) -> BasicResponse:
         payload = self._request("PUT", f"/sandbox/{sandbox_id}/stop")
         return BasicResponse(**payload)

{hyperbrowser-0.86.0 → hyperbrowser-0.87.0}/hyperbrowser/models/__init__.py

@@ -246,6 +246,12 @@ from .sandbox import (
     StartSandboxFromSnapshotParams,
     SandboxListParams,
     SandboxListResponse,
+    SandboxImageListResponse,
+    SandboxImageSummary,
+    SandboxSnapshotStatus,
+    SandboxSnapshotListResponse,
+    SandboxSnapshotSummary,
+    SandboxSnapshotListParams,
     SandboxMemorySnapshotParams,
     SandboxMemorySnapshotResult,
     SandboxExposeParams,
@@ -490,6 +496,12 @@ __all__ = [
     "StartSandboxFromSnapshotParams",
     "SandboxListParams",
     "SandboxListResponse",
+    "SandboxImageListResponse",
+    "SandboxImageSummary",
+    "SandboxSnapshotStatus",
+    "SandboxSnapshotListResponse",
+    "SandboxSnapshotSummary",
+    "SandboxSnapshotListParams",
     "SandboxMemorySnapshotParams",
     "SandboxMemorySnapshotResult",
     "SandboxExposeParams",

{hyperbrowser-0.86.0 → hyperbrowser-0.87.0}/hyperbrowser/models/sandbox.py

@@ -23,6 +23,7 @@ SandboxProcessStatus = Literal[
     "killed",
     "timed_out",
 ]
+SandboxSnapshotStatus = Literal["creating", "created", "failed"]
 SandboxFileType = Literal["file", "dir"]
 SandboxFileEncoding = Literal["utf8", "base64"]
 SandboxFileReadFormat = Literal["text", "bytes", "blob", "stream"]
@@ -164,10 +165,9 @@ class StartSandboxFromSnapshotParams(CreateSandboxParams):
 
 
 class SandboxListParams(SandboxBaseModel):
-    status: Optional[SandboxStatus] = None
-    page: Optional[int] = None
-    limit: Optional[int] = None
-    search: Optional[str] = None
+    status: Optional[SandboxStatus] = Field(default=None, exclude=None)
+    page: int = Field(default=1, ge=1)
+    limit: int = Field(default=10, ge=1)
 
 
 class SandboxListResponse(SandboxBaseModel):
@@ -177,6 +177,51 @@ class SandboxListResponse(SandboxBaseModel):
     per_page: int = Field(alias="perPage")
 
 
+class SandboxImageSummary(SandboxBaseModel):
+    id: str
+    image_name: str = Field(alias="imageName")
+    namespace: str
+    uploaded: bool
+    created_at: datetime = Field(alias="createdAt")
+    updated_at: datetime = Field(alias="updatedAt")
+
+
+class SandboxImageListResponse(SandboxBaseModel):
+    images: List[SandboxImageSummary]
+    # TODO: add pagination metadata when /api/images supports it.
+    # total_count: Optional[int] = Field(default=None, alias="totalCount")
+    # page: Optional[int] = None
+    # per_page: Optional[int] = Field(default=None, alias="perPage")
+
+
+class SandboxSnapshotSummary(SandboxBaseModel):
+    id: str
+    snapshot_name: str = Field(alias="snapshotName")
+    namespace: str
+    image_namespace: str = Field(alias="imageNamespace")
+    image_name: str = Field(alias="imageName")
+    image_id: str = Field(alias="imageId")
+    status: SandboxSnapshotStatus
+    compatibility_tag: Optional[str] = Field(default=None, alias="compatibilityTag")
+    metadata: Dict[str, object]
+    uploaded: bool
+    created_at: datetime = Field(alias="createdAt")
+    updated_at: datetime = Field(alias="updatedAt")
+
+
+class SandboxSnapshotListParams(SandboxBaseModel):
+    status: Optional[SandboxSnapshotStatus] = Field(default=None, exclude=None)
+    limit: Optional[int] = Field(default=None, ge=1)
+
+
+class SandboxSnapshotListResponse(SandboxBaseModel):
+    snapshots: List[SandboxSnapshotSummary]
+    # TODO: add pagination metadata when /api/snapshots supports it.
+    # total_count: Optional[int] = Field(default=None, alias="totalCount")
+    # page: Optional[int] = None
+    # per_page: Optional[int] = Field(default=None, alias="perPage")
+
+
 class SandboxMemorySnapshotParams(SandboxBaseModel):
     snapshot_name: Optional[str] = Field(
         default=None, serialization_alias="snapshotName"

{hyperbrowser-0.86.0 → hyperbrowser-0.87.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "hyperbrowser"
-version = "0.86.0"
+version = "0.87.0"
 description = "Python SDK for hyperbrowser"
 authors = ["Nikhil Shahi <nshahi1998@gmail.com>"]
 license = "MIT"