daniel156161
fd5447cbb9
Testing / remote-protocol-compat (0.9.3) (push) Successful in 42s
Testing / remote-protocol-compat (0.9.5) (push) Successful in 44s
Package Extension / package-extension (push) Successful in 43s
Build & Publish Package / publish (push) Successful in 43s
Testing / test (push) Successful in 45s
Restructure the Python API and internals around composable namespaces and a standalone transport/endpoint layer. Bump to 0.12.0. Python API: - Replace flat methods (b.tabs_list(), b.group_list()) with namespaces: b.nav, b.tabs, b.groups, b.windows, b.dom, b.extract, b.page, b.storage, b.cookies, b.session, b.perf, b.extension. - Shrink browser_cli/__init__.py to a thin composition root; move all behaviour into browser_cli/sdk/ (one module per namespace + factories, base, routing). Internals: - Add browser_cli/transport.py and remote_transport.py to isolate IPC from command logic; client.py now delegates instead of owning transport. - Add browser_cli/endpoints.py for endpoint resolution and browser_cli/errors.py for shared error types. - Extract markdown rendering into browser_cli/markdown.py (out of extract). - Add USER_AGENT to version_manager. Tooling & tests: - Add justfile with common dev tasks. - Update CLI commands and demo to the namespaced API. - Rework tests for the new layout; add test_transport.py and test_refactor_boundaries.py to lock in module boundaries. BREAKING CHANGE: flat API methods are removed in favour of namespaces (e.g. b.tabs_list() -> b.tabs.list(), b.group_list() -> b.groups.list()).
67 lines
2.1 KiB
Python
67 lines
2.1 KiB
Python
"""Storage and cookies namespaces: ``b.storage.*``, ``b.cookies.*``."""
|
|
from __future__ import annotations
|
|
|
|
from browser_cli.sdk.base import Namespace
|
|
|
|
class StorageNS(Namespace):
|
|
"""Read and write localStorage / sessionStorage."""
|
|
|
|
def get(
|
|
self,
|
|
key: str | None = None,
|
|
*,
|
|
type: str = "local",
|
|
tab_id: int | None = None,
|
|
) -> str | dict | None:
|
|
"""Get a localStorage/sessionStorage entry (or all entries if key omitted)."""
|
|
return self._c._cmd("storage.get", {"key": key, "type": type, "tabId": tab_id})
|
|
|
|
def set(
|
|
self,
|
|
key: str,
|
|
value: str,
|
|
*,
|
|
type: str = "local",
|
|
tab_id: int | None = None,
|
|
) -> None:
|
|
"""Set a localStorage/sessionStorage entry."""
|
|
self._c._cmd("storage.set", {"key": key, "value": value, "type": type, "tabId": tab_id})
|
|
|
|
class CookiesNS(Namespace):
|
|
"""List, get, and set cookies."""
|
|
|
|
def list(
|
|
self,
|
|
*,
|
|
url: str | None = None,
|
|
domain: str | None = None,
|
|
name: str | None = None,
|
|
) -> list[dict]:
|
|
"""List cookies, optionally filtered by url, domain, or name."""
|
|
return self._c._cmd("cookies.list", {"url": url, "domain": domain, "name": name}) or []
|
|
|
|
def get(self, url: str, name: str) -> dict | None:
|
|
"""Get a single cookie by url and name."""
|
|
return self._c._cmd("cookies.get", {"url": url, "name": name})
|
|
|
|
def set(
|
|
self,
|
|
url: str,
|
|
name: str,
|
|
value: str,
|
|
*,
|
|
domain: str | None = None,
|
|
path: str | None = None,
|
|
secure: bool | None = None,
|
|
http_only: bool | None = None,
|
|
expiration_date: float | None = None,
|
|
same_site: str | None = None,
|
|
) -> dict:
|
|
"""Set a cookie. Returns the created cookie dict."""
|
|
return self._c._cmd("cookies.set", {
|
|
"url": url, "name": name, "value": value,
|
|
"domain": domain, "path": path,
|
|
"secure": secure, "httpOnly": http_only,
|
|
"expirationDate": expiration_date, "sameSite": same_site,
|
|
})
|