RemoteRepository

RemoteRepository is a read-only browsing facade returned by blosc2.open("https://host/base") when a Caterva2-compatible service has zero or multiple accessible roots. A single root instead opens directly.

The facade subclasses RemoteStore for hierarchy consumers such as b2view. keys() lists roots without opening them; repository["@public"] returns an independent group handle. Direct descendant lookup is supported. Closing the repository leaves previously returned child handles usable. Alias handles from repository[""] share root owners and lifetime accounting.

Cache policy and allowance are per root. cache_bytes and metadata_bytes sum opened roots; traffic counts their reads and excludes the initial roots probe. Source descriptors contain no authentication token. Root owners bind the authentication context at repository creation and use existing isolated cache identities.

Repository persistence, materialization, refresh, and root-level shared sparse cache opening are intentionally unsupported. Select a specific root for those operations. get_info at a root name reports the roots registry metadata; select/open that root for its actual source attributes. No synthetic empty path is sent to the server’s info endpoint.

class blosc2.RemoteRepository(urlbase, roots, *, auth_token=None, **options)

Read-only, nonpersistent group of Caterva2 roots.

Returned by blosc2.open for empty or multi-root services. Root owners open lazily. Cache allowances are per root, not a repository-wide bound. Closing this facade leaves previously returned child handles usable. Open a specific root to persist or materialize a selection.

Attributes:

attrs

Read-only group attributes, or None when discovery cannot decode them.

cache_bytes

Retained payload bytes; NONE retains no payload between reads.

cache_policy

Configured payload-retention policy.

max_cache_bytes

Configured allowance per root (not a total repository allowance).

metadata_bytes

Encoded discovery manifest size, separate from retained payload.

source

Credential-free source descriptor, including this group’s full path.

traffic

Shared counter for opened roots; the initial roots probe is excluded.

Methods

close()	Release this handle; the last dependent handle closes shared resources.
get_info([path])	Return node kind, known attributes and unsupported-node diagnostics.
keys()	Return sorted immediate child names, using only discovery metadata.

property attrs

Read-only group attributes, or None when discovery cannot decode them.

property cache_bytes

Retained payload bytes; NONE retains no payload between reads.

property cache_policy

Configured payload-retention policy.

close()

Release this handle; the last dependent handle closes shared resources.

get_info(path='')

Return node kind, known attributes and unsupported-node diagnostics.

keys()

Return sorted immediate child names, using only discovery metadata.

property max_cache_bytes

Configured allowance per root (not a total repository allowance).

property metadata_bytes

Encoded discovery manifest size, separate from retained payload.

property source

Credential-free source descriptor, including this group’s full path.

property traffic

Shared counter for opened roots; the initial roots probe is excluded.