tlc.core.object_registry#

Module for managing and caching Object instances with URL-based access and serialization support.

Module Contents#

Classes#

Class

Description

ObjectRegistry

Maintains a list of currently existing 3LC objects, and provides functionality for deserializing objects from JSON strings.

Data#

API#

tlc.core.object_registry.IndexerCallbackEventType = None#
tlc.core.object_registry.IndexerCallbackType = None#
class tlc.core.object_registry.ObjectRegistry#

Maintains a list of currently existing 3LC objects, and provides functionality for deserializing objects from JSON strings.

static drop_cache() None#

Probably just a temporary workaround until we resolve ObjectRegistry semantics.

static add_object_at_url(obj: tlc.core.object.Object, url: tlc.core.url.Url) None#

Add the given object with the given URL

static consider_indexing_callbacks(obj: tlc.core.object.Object, url: tlc.core.url.Url, event_type: tlc.core.object_registry.IndexerCallbackEventType) None#

Maybe notify interested indexers of new objects for indexing

Improve indexing performance by push notifications, if wanted. Normally set up when creating indexing singletons.

static get_object_from_url(url: tlc.core.url.Url) tlc.core.object.Object | None#

Get or create object from URL synchronously

static delete_object_from_url(url: tlc.core.url.Url) None#

Tries to delete an object from an URL synchronously

Tries to delete the Url using available adapters Always removes the object from the registry’s internal caches

static delete_object_from_url_async(url: tlc.core.url.Url) concurrent.futures.Future#

Tries to delete an object from an URL asynchronously

Tries to delete the Url using available adapters This also removes the object from the registry’s internal caches

static get_or_create_object_from_url(url: tlc.core.url.Url) tlc.core.object.Object#

Get or create object from URL synchronously

Parameters:

url – The URL to read the object from. This URL must be absolute.

Raises:

ValueError – If the URL is not absolute.

static get_or_create_object_from_url_async(url: tlc.core.url.Url) concurrent.futures.Future#

Get or create object from URL asynchronously

Parameters:

url – The URL to read the object from. This URL must be absolute.

Raises:

ValueError – If the URL is not absolute.

static write_object_to_url(obj: tlc.core.object.Object, url: tlc.core.url.Url) None#

Write an object to a URL synchronously

static write_object_to_url_async(obj: tlc.core.object.Object, url: tlc.core.url.Url) concurrent.futures.Future#

Write an object to a URL asynchronously