Session
yosoi.browser.Session
class Session:
An acquired Rust Session, released by async context exit.
This Python bridge exposes one Work lease at a time. Rust watcher streams and explicit tab creation are not exposed through this first pass. Omitted settings inherit the bound policy’s browser mode; explicit settings retain their configured mode and must agree with that policy.
Attributes: policy: Policy serialized when acquisition or operations require it. settings: Optional retained Session settings, or None to use native defaults.
Source: python/yosoi/browser.py:2268
Members below are declared on this class. Inherited Pydantic methods and generated constructor signatures are not expanded.
Methods
Section titled “Methods”def __init__(self, policy: Policy | None=None, settings: SessionPolicy | None=None, *, cancellation: CancellationToken | None=None) -> None:
Prepare a Session owner without acquiring a browser yet.
Args: policy: Policy serialized on acquisition; None creates the default policy. settings: Optional Session settings, with mode agreeing with the policy. cancellation: Default cancellation token for acquisition and operations.
Raises: TypeError: An argument has the wrong SDK type.
Source: python/yosoi/browser.py:2281
aenter
Section titled “aenter”async def __aenter__(self) -> Session:
Acquire the native browser Session and return this owner.
Raises: BrowserError: This Session is already acquired or acquisition fails.
Source: python/yosoi/browser.py:2311
async def __aexit__(self, exc_type: type[BaseException] | None, exc: BaseException | None, traceback: TracebackType | None) -> Literal[False]:
Close the owned Session and preserve the context’s original exception.
Args: exc_type: Exception type supplied by async context management. exc: Original operation exception, if any. traceback: Original traceback supplied by async context management.
Returns: False so successful cleanup does not suppress the original exception.
Raises: BrowserCleanupError: Cleanup fails while an original exception is active.
Source: python/yosoi/browser.py:2326
closed
Section titled “closed”@property
def closed(self) -> bool:
Return whether no native handle is held, including before first entry.
Source: python/yosoi/browser.py:2354
def work(self) -> Work:
Create a lazy Work wrapper for this acquired Session.
Returns: Caller-owned wrapper; control is acquired on entry or its first operation.
Raises: BrowserError: The Session has not been entered or is closed.
Source: python/yosoi/browser.py:2358
async def run(self, flow: Flow, *, policy: Policy | None=None, cancellation: CancellationToken | None=None) -> FlowOutcome:
Run on an explicitly leased Work control, then release that lease.
Source: python/yosoi/browser.py:2371
invoke
Section titled “invoke”async def invoke(self, flow: Flow, *, policy: Policy | None=None, cancellation: CancellationToken | None=None) -> FlowOutcome:
Run a Flow with temporary Work ownership, retaining this Session.
Args: flow: Declaration executed on this Session’s leased tab. policy: Optional operation policy; None inherits the Session policy. cancellation: Explicit token, or the Session token when omitted.
Returns: Flow outcome after the temporary Work lease is released.
Raises: BrowserError: Work acquisition or native invocation fails. BrowserCleanupError: Lease cleanup fails after an operation exception.
Source: python/yosoi/browser.py:2382
async def send(self, request: PageRequest | BoundPageRequest, *, cancellation: CancellationToken | None=None) -> Response:
Send a PageRequest through this retained Session without closing it.
Source: python/yosoi/browser.py:2405
async def close(self) -> None:
Await owned Session cleanup, then clear its native handle.
Repeated calls on a closed Session are harmless. Cleanup settlement is shielded from caller task cancellation; cancellation is re-raised after settlement. Closing does not undo already dispatched browser operations.
Raises: BrowserError: Native cleanup fails; retained state is not claimed closed. BrowserCleanupError: Cleanup fails while caller cancellation is pending.