easybrowser-local-api-sdk 0.1.4__tar.gz → 0.1.6__tar.gz

{easybrowser_local_api_sdk-0.1.4/easybrowser_local_api_sdk.egg-info → easybrowser_local_api_sdk-0.1.6}/PKG-INFO

@@ -1,102 +1,136 @@
-Metadata-Version: 2.4
-Name: easybrowser-local-api-sdk
-Version: 0.1.4
-Summary: EasyBrowser local API SDK
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.31
-Requires-Dist: loguru>=0.7
-Requires-Dist: patchright
-Requires-Dist: PySocks>=1.7
-
-# EasyBrowser Local API SDK
-
-EasyBrowser Local API SDK is a small Python client for the EasyBrowser local API.
-
-Website: https://easybrowser.pages.dev/
-
-## Install
-
-```bash
-pip install easybrowser-local-api-sdk
-```
-
-## Quick Start
-
-```python
-from easybrowser_sdk import EasyBrowserAPI
-
-api = EasyBrowserAPI()
-api.ensure_local_api_available()
-
-environment = api.ensure_container(
-    name="TestEnv",
-    defaultUrl="https://example.com",
-)
-print(environment["id"])
-```
-
-## Requirements
-
-- Python 3.10+
-- EasyLauncher installed and running
-
-Free VIP activation is available inside EasyLauncher.
-
-## Publish
-
-```bash
-python -m pip install build twine
-python -m build
-python -m twine check dist/*
-python -m twine upload dist/*
-```
-
-Use `__token__` as the username and a PyPI API token as the password.
-
----
-
-# EasyBrowser Local API SDK
-
-EasyBrowser Local API SDK 是一个用于 EasyBrowser 本地 API 的简洁 Python 客户端。
-
-官网：https://easybrowser.pages.dev/
-
-## 安装
-
-```bash
-pip install easybrowser-local-api-sdk
-```
-
-## 快速开始
-
-```python
-from easybrowser_sdk import EasyBrowserAPI
-
-api = EasyBrowserAPI()
-api.ensure_local_api_available()
-
-environment = api.ensure_container(
-    name="TestEnv",
-    defaultUrl="https://example.com",
-)
-print(environment["id"])
-```
-
-## 运行要求
-
-- Python 3.10 及以上
-- 已安装并运行 EasyLauncher
-
-EasyLauncher 内可免费开通 VIP。
-
-## 发布
-
-```bash
-python -m pip install build twine
-python -m build
-python -m twine check dist/*
-python -m twine upload dist/*
-```
-
-用户名使用 `__token__`，密码使用 PyPI API token。
+Metadata-Version: 2.4
+Name: easybrowser-local-api-sdk
+Version: 0.1.6
+Summary: EasyBrowser local API SDK
+Project-URL: Homepage, https://easybrowser.pages.dev/
+Project-URL: Repository, https://github.com/EasyBrowserMaster/easybrowser-local-api-sdk
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31
+Requires-Dist: loguru>=0.7
+Requires-Dist: patchright
+Requires-Dist: PySocks>=1.7
+
+# EasyBrowser Local API SDK
+
+EasyBrowser Local API SDK is a small Python client for the EasyBrowser local API.
+
+Website: https://easybrowser.pages.dev/
+
+## Install
+
+```bash
+pip install easybrowser-local-api-sdk
+```
+
+## Quick Start
+
+```python
+from easybrowser_sdk import EasyBrowserAPI
+
+api = EasyBrowserAPI()
+api.ensure_local_api_available()
+
+environment = api.ensure_container(
+    name="TestEnv",
+    defaultUrl="https://example.com",
+)
+print(environment["id"])
+```
+
+## Container lifecycle
+
+```python
+# Soft delete (moves to trash, recoverable)
+api.delete_container(env_id)
+
+# Restore from trash
+api.restore_container(env_id)
+
+# List trashed containers
+api.trash_list()
+
+# Permanently delete + clean browser data (cookies/storage). Irreversible.
+api.delete_permanently(env_id)
+```
+
+## Requirements
+
+- Python 3.10+
+- EasyLauncher installed and running
+
+Free VIP activation is available inside EasyLauncher.
+
+## Publish
+
+```bash
+python -m pip install build twine
+python -m build
+python -m twine check dist/*
+python -m twine upload dist/*
+```
+
+Use `__token__` as the username and a PyPI API token as the password.
+
+---
+
+# EasyBrowser Local API SDK
+
+EasyBrowser Local API SDK 是一个用于 EasyBrowser 本地 API 的简洁 Python 客户端。
+
+官网：https://easybrowser.pages.dev/
+
+## 安装
+
+```bash
+pip install easybrowser-local-api-sdk
+```
+
+## 快速开始
+
+```python
+from easybrowser_sdk import EasyBrowserAPI
+
+api = EasyBrowserAPI()
+api.ensure_local_api_available()
+
+environment = api.ensure_container(
+    name="TestEnv",
+    defaultUrl="https://example.com",
+)
+print(environment["id"])
+```
+
+## 环境生命周期
+
+```python
+# 软删除（移入回收站，可恢复）
+api.delete_container(env_id)
+
+# 从回收站恢复
+api.restore_container(env_id)
+
+# 查看回收站
+api.trash_list()
+
+# 彻底删除 + 清理浏览器数据（Cookie/存储），不可恢复
+api.delete_permanently(env_id)
+```
+
+## 运行要求
+
+- Python 3.10 及以上
+- 已安装并运行 EasyLauncher
+
+EasyLauncher 内可免费开通 VIP。
+
+## 发布
+
+```bash
+python -m pip install build twine
+python -m build
+python -m twine check dist/*
+python -m twine upload dist/*
+```
+
+用户名使用 `__token__`，密码使用 PyPI API token。

easybrowser_local_api_sdk-0.1.4/PKG-INFO → easybrowser_local_api_sdk-0.1.6/README.md

@@ -1,102 +1,123 @@
-Metadata-Version: 2.4
-Name: easybrowser-local-api-sdk
-Version: 0.1.4
-Summary: EasyBrowser local API SDK
-Requires-Python: >=3.10
-Description-Content-Type: text/markdown
-Requires-Dist: requests>=2.31
-Requires-Dist: loguru>=0.7
-Requires-Dist: patchright
-Requires-Dist: PySocks>=1.7
-
-# EasyBrowser Local API SDK
-
-EasyBrowser Local API SDK is a small Python client for the EasyBrowser local API.
-
-Website: https://easybrowser.pages.dev/
-
-## Install
-
-```bash
-pip install easybrowser-local-api-sdk
-```
-
-## Quick Start
-
-```python
-from easybrowser_sdk import EasyBrowserAPI
-
-api = EasyBrowserAPI()
-api.ensure_local_api_available()
-
-environment = api.ensure_container(
-    name="TestEnv",
-    defaultUrl="https://example.com",
-)
-print(environment["id"])
-```
-
-## Requirements
-
-- Python 3.10+
-- EasyLauncher installed and running
-
-Free VIP activation is available inside EasyLauncher.
-
-## Publish
-
-```bash
-python -m pip install build twine
-python -m build
-python -m twine check dist/*
-python -m twine upload dist/*
-```
-
-Use `__token__` as the username and a PyPI API token as the password.
-
----
-
-# EasyBrowser Local API SDK
-
-EasyBrowser Local API SDK 是一个用于 EasyBrowser 本地 API 的简洁 Python 客户端。
-
-官网：https://easybrowser.pages.dev/
-
-## 安装
-
-```bash
-pip install easybrowser-local-api-sdk
-```
-
-## 快速开始
-
-```python
-from easybrowser_sdk import EasyBrowserAPI
-
-api = EasyBrowserAPI()
-api.ensure_local_api_available()
-
-environment = api.ensure_container(
-    name="TestEnv",
-    defaultUrl="https://example.com",
-)
-print(environment["id"])
-```
-
-## 运行要求
-
-- Python 3.10 及以上
-- 已安装并运行 EasyLauncher
-
-EasyLauncher 内可免费开通 VIP。
-
-## 发布
-
-```bash
-python -m pip install build twine
-python -m build
-python -m twine check dist/*
-python -m twine upload dist/*
-```
-
-用户名使用 `__token__`，密码使用 PyPI API token。
+# EasyBrowser Local API SDK
+
+EasyBrowser Local API SDK is a small Python client for the EasyBrowser local API.
+
+Website: https://easybrowser.pages.dev/
+
+## Install
+
+```bash
+pip install easybrowser-local-api-sdk
+```
+
+## Quick Start
+
+```python
+from easybrowser_sdk import EasyBrowserAPI
+
+api = EasyBrowserAPI()
+api.ensure_local_api_available()
+
+environment = api.ensure_container(
+    name="TestEnv",
+    defaultUrl="https://example.com",
+)
+print(environment["id"])
+```
+
+## Container lifecycle
+
+```python
+# Soft delete (moves to trash, recoverable)
+api.delete_container(env_id)
+
+# Restore from trash
+api.restore_container(env_id)
+
+# List trashed containers
+api.trash_list()
+
+# Permanently delete + clean browser data (cookies/storage). Irreversible.
+api.delete_permanently(env_id)
+```
+
+## Requirements
+
+- Python 3.10+
+- EasyLauncher installed and running
+
+Free VIP activation is available inside EasyLauncher.
+
+## Publish
+
+```bash
+python -m pip install build twine
+python -m build
+python -m twine check dist/*
+python -m twine upload dist/*
+```
+
+Use `__token__` as the username and a PyPI API token as the password.
+
+---
+
+# EasyBrowser Local API SDK
+
+EasyBrowser Local API SDK 是一个用于 EasyBrowser 本地 API 的简洁 Python 客户端。
+
+官网：https://easybrowser.pages.dev/
+
+## 安装
+
+```bash
+pip install easybrowser-local-api-sdk
+```
+
+## 快速开始
+
+```python
+from easybrowser_sdk import EasyBrowserAPI
+
+api = EasyBrowserAPI()
+api.ensure_local_api_available()
+
+environment = api.ensure_container(
+    name="TestEnv",
+    defaultUrl="https://example.com",
+)
+print(environment["id"])
+```
+
+## 环境生命周期
+
+```python
+# 软删除（移入回收站，可恢复）
+api.delete_container(env_id)
+
+# 从回收站恢复
+api.restore_container(env_id)
+
+# 查看回收站
+api.trash_list()
+
+# 彻底删除 + 清理浏览器数据（Cookie/存储），不可恢复
+api.delete_permanently(env_id)
+```
+
+## 运行要求
+
+- Python 3.10 及以上
+- 已安装并运行 EasyLauncher
+
+EasyLauncher 内可免费开通 VIP。
+
+## 发布
+
+```bash
+python -m pip install build twine
+python -m build
+python -m twine check dist/*
+python -m twine upload dist/*
+```
+
+用户名使用 `__token__`，密码使用 PyPI API token。

easybrowser_local_api_sdk-0.1.4/README.md → easybrowser_local_api_sdk-0.1.6/easybrowser_local_api_sdk.egg-info/PKG-INFO

@@ -1,3 +1,16 @@
+Metadata-Version: 2.4
+Name: easybrowser-local-api-sdk
+Version: 0.1.6
+Summary: EasyBrowser local API SDK
+Project-URL: Homepage, https://easybrowser.pages.dev/
+Project-URL: Repository, https://github.com/EasyBrowserMaster/easybrowser-local-api-sdk
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.31
+Requires-Dist: loguru>=0.7
+Requires-Dist: patchright
+Requires-Dist: PySocks>=1.7
+
 # EasyBrowser Local API SDK
 
 EasyBrowser Local API SDK is a small Python client for the EasyBrowser local API.
@@ -25,6 +38,22 @@ environment = api.ensure_container(
 print(environment["id"])
 ```
 
+## Container lifecycle
+
+```python
+# Soft delete (moves to trash, recoverable)
+api.delete_container(env_id)
+
+# Restore from trash
+api.restore_container(env_id)
+
+# List trashed containers
+api.trash_list()
+
+# Permanently delete + clean browser data (cookies/storage). Irreversible.
+api.delete_permanently(env_id)
+```
+
 ## Requirements
 
 - Python 3.10+
@@ -72,6 +101,22 @@ environment = api.ensure_container(
 print(environment["id"])
 ```
 
+## 环境生命周期
+
+```python
+# 软删除（移入回收站，可恢复）
+api.delete_container(env_id)
+
+# 从回收站恢复
+api.restore_container(env_id)
+
+# 查看回收站
+api.trash_list()
+
+# 彻底删除 + 清理浏览器数据（Cookie/存储），不可恢复
+api.delete_permanently(env_id)
+```
+
 ## 运行要求
 
 - Python 3.10 及以上

{easybrowser_local_api_sdk-0.1.4 → easybrowser_local_api_sdk-0.1.6}/easybrowser_local_api_sdk.egg-info/SOURCES.txt

@@ -1,6 +1,7 @@
 README.md
 easybrowser_sdk.py
 pyproject.toml
+setup.cfg
 easybrowser_local_api_sdk.egg-info/PKG-INFO
 easybrowser_local_api_sdk.egg-info/SOURCES.txt
 easybrowser_local_api_sdk.egg-info/dependency_links.txt

{easybrowser_local_api_sdk-0.1.4 → easybrowser_local_api_sdk-0.1.6}/easybrowser_sdk.py

@@ -261,6 +261,22 @@ class EasyBrowserAPI:
         except ValueError as exc:
             raise RuntimeError(f"Invalid JSON response from {self.base}{path}: {exc}") from exc
 
+    def _post_raw(self, path, data=None):
+        """POST 并返回原始响应 dict（不校验 code，供需要判断 msg 的调用方使用）。"""
+        try:
+            r = requests.post(
+                f"{self.base}{path}",
+                json=data,
+                headers=self.headers,
+                timeout=self.timeout,
+            )
+        except requests.RequestException as exc:
+            raise RuntimeError(format_api_unavailable_error(self.base, exc)) from exc
+        try:
+            return r.json()
+        except ValueError as exc:
+            raise RuntimeError(f"Invalid JSON response from {self.base}{path}: {exc}") from exc
+
     def create_container(self, name, **kw):
         return self._post("/api/v1/container/create", {"name": name, **kw})
 
@@ -305,6 +321,33 @@ class EasyBrowserAPI:
             ids = list(env_ids)
         return self._post("/api/v1/container/delete", {"ids": ids})
 
+    def restore_container(self, env_ids):
+        """Restore one or more containers from the trash. Accepts a single id or a list of ids."""
+        if isinstance(env_ids, str):
+            ids = [env_ids]
+        else:
+            ids = list(env_ids)
+        return self._post("/api/v1/container/restore", {"ids": ids})
+
+    def delete_permanently(self, env_ids):
+        """Permanently delete containers and their browser data (incl. cookies). Irreversible.
+
+        Calls /api/v1/container/delete_permanently; falls back to the legacy
+        /api/v1/container/purge when talking to older clients that only expose purge.
+        """
+        if isinstance(env_ids, str):
+            ids = [env_ids]
+        else:
+            ids = list(env_ids)
+        res = self._post_raw("/api/v1/container/delete_permanently", {"ids": ids})
+        # 老客户端没有新路由，会返回 {"code":-1,"msg":"not found"}，回退到旧别名 purge
+        if res.get("code") != 0 and "not found" in str(res.get("msg", "")).lower():
+            res = self._post_raw("/api/v1/container/purge", {"ids": ids})
+        return self._check(res)
+
+    def trash_list(self):
+        return self._get("/api/v1/container/trash")
+
     def list_containers(self, page=1, page_size=100):
         return self._get(
             "/api/v1/container/list",

{easybrowser_local_api_sdk-0.1.4 → easybrowser_local_api_sdk-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "easybrowser-local-api-sdk"
-version = "0.1.4"
+version = "0.1.6"
 description = "EasyBrowser local API SDK"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -15,5 +15,9 @@ dependencies = [
     "PySocks>=1.7",
 ]
 
+[project.urls]
+Homepage = "https://easybrowser.pages.dev/"
+Repository = "https://github.com/EasyBrowserMaster/easybrowser-local-api-sdk"
+
 [tool.setuptools]
 py-modules = ["easybrowser_sdk"]

{easybrowser_local_api_sdk-0.1.4 → easybrowser_local_api_sdk-0.1.6}/setup.cfg

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