Skip to content
YosoiDocs

WebSurface

yosoi.surface.WebSurface

class WebSurface:

Shared read protocol over an immutable HTML or rendered-DOM index.

Args: index: Prepared document index; other document classes are rejected. source: Nonempty continuing-source identity, without browser authority.

Source: python/yosoi/surface.py:585

Members below are declared on this class. Inherited Pydantic methods and generated constructor signatures are not expanded.

def __init__(self, index: Surface, source: str) -> None:

Bind a web observation to its source; no browser is opened.

Source: python/yosoi/surface.py:593

@property
def descriptor(self) -> Descriptor:

Return read capabilities; this immutable adapter is not controllable.

Source: python/yosoi/surface.py:598

@property
def observation(self) -> Observation:

Return the exact source-bound interpretation identity.

Source: python/yosoi/surface.py:603

@property
def root_reference(self) -> Reference:

Return the full web observation’s shared address.

Source: python/yosoi/surface.py:608

def read(self, request: ReadRequest) -> ReadResult:

Read in Rust; the complete tagged result fits the requested byte budget.

Source: python/yosoi/surface.py:612

def reference(self, reference: NativeReference) -> Reference:

Convert an exact index reference into this source-bound shared address.

Source: python/yosoi/surface.py:616

def native_reference(self, reference: Reference) -> NativeReference:

Recover an index reference; foreign observations are rejected by Rust.

Source: python/yosoi/surface.py:622