fastsim.api.artifacts

Current public Python API for fastsim.api.artifacts; signatures are extracted directly from the vNext AST.

Source src/fastsim/api/artifacts.py

ArtifactDescriptor ResolvedArtifact ScopedArtifactReadService

Public symbols 3

class

ArtifactDescriptor

L37

class ArtifactDescriptor(object)

Path-free catalog metadata for one plugin-owned artifact.

Field	Type	Default
artifact_id	str	—
format	str	—
sha256	str	—
cache_hit	bool	—

class

ResolvedArtifact

L57

class ResolvedArtifact(ArtifactDescriptor)

Artifact location returned only after an asynchronous digest check. The digest and byte count describe the content observed during ``resolve``. A returned path is a verified-at-resolution capability, not an open-file snapshot; callers that retain it remain inside FastSim's cooperative plugin trust boundary.

Field	Type	Default
requested_uri	str	—
resolved_uri	str	—
local_path	str	—
size_bytes	int	—

class

ScopedArtifactReadService

L83

class ScopedArtifactReadService(Protocol)

Resolve only the artifacts compiled for one plugin instance. ``resolve`` revalidates the file digest outside the application loop before returning its path. Retaining a path after service revocation is outside the cooperative in-process plugin trust boundary.

service_id

ScopedArtifactReadService.service_id(self) -> str

No public docstring is provided in the current source.

descriptors

ScopedArtifactReadService.descriptors(self) -> tuple[ArtifactDescriptor, ...]

No public docstring is provided in the current source.

resolve

async ScopedArtifactReadService.resolve(self, artifact_id: str) -> ResolvedArtifact

No public docstring is provided in the current source.