bloqade.core.device.local_storage.DictStorage
classDictStorage¶source
bloqade.core.device.local_storage.DictStorage
Bases: StorageBackend
In-memory storage backend for shot results.
class DictStorageThis backend is useful for tests, examples, and short-lived sessions. Data is not persisted across Python processes.
methodadd_shots¶source
bloqade.core.device.local_storage.DictStorage.add_shots
def add_shots(shots: Iterable[ShotResult]) -> NoneStore shot result rows in memory.
Parameters
| Name | Type | Description |
|---|---|---|
shots | Iterable[ShotResult] | Shot rows to store. |
methodget_shots¶source
bloqade.core.device.local_storage.DictStorage.get_shots
Signature
def get_shots(*, shot_filter: ShotFilter | None = None) -> Iterable[ShotResult]Return in-memory shot rows matching a filter.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
shot_filter | ShotFilter | None | None |
Other Parameters
| Name | Type | Description |
|---|---|---|
shot_filter | ShotFilter | None | Optional shot filter. When None, all shots are returned. Defaults to None. |
Returns
Iterable[ShotResult]Matching shot rows.
methodtask_ids¶source
bloqade.core.device.local_storage.DictStorage.task_ids
def task_ids() -> set[str]Return task IDs with stored task definitions.
Returns
set[str]Stored task IDs.
methodadd_task_definition¶source
bloqade.core.device.local_storage.DictStorage.add_task_definition
Signature
def add_task_definition(task_id: str, task_definition: TaskDefinition, creation_time: datetime.datetime)Store a task definition and creation time in memory.
Parameters
| Name | Type | Description |
|---|---|---|
task_id | str | Backend task ID. |
task_definition | TaskDefinition | Task definition to store. |
creation_time | datetime.datetime | Backend task creation time. |
methodget_program_language¶source
bloqade.core.device.local_storage.DictStorage.get_program_language
def get_program_language(task_id: str) -> strReturn the program language for a stored task definition.
Parameters
| Name | Type | Description |
|---|---|---|
task_id | str | Backend task ID. |
Returns
strstr: Stored program language.
Raises
| Type | Description |
|---|---|
KeyError | If `task_id` is not present. |
methodget_profile_id¶source
bloqade.core.device.local_storage.DictStorage.get_profile_id
def get_profile_id(task_id: str) -> UUID | NoneParameters
| Name | Type | Description |
|---|---|---|
task_id | str |
Returns
UUID | None
methodget_task_creation_time¶source
bloqade.core.device.local_storage.DictStorage.get_task_creation_time
def get_task_creation_time(task_id: str) -> datetime.datetimeReturn the creation time for a stored task.
Parameters
| Name | Type | Description |
|---|---|---|
task_id | str | Backend task ID. |
Returns
datetime.datetimeStored task creation time.
Raises
| Type | Description |
|---|---|
KeyError | If `task_id` is not present. |
methodget_task_group_id¶source
bloqade.core.device.local_storage.DictStorage.get_task_group_id
def get_task_group_id(task_id: str) -> UUID | NoneReturn the QLAM group stored for a task definition.
Parameters
| Name | Type | Description |
|---|---|---|
task_id | str |
Returns
UUID | None
methodget_programs¶source
bloqade.core.device.local_storage.DictStorage.get_programs
def get_programs(task_ids: tuple[str, ...] | None = None) -> list[dict]Return stored program records.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
task_ids | tuple[str, ...] | None | None | Optional task IDs to include. When None, programs for all stored tasks are returned. Defaults to None. |
Returns
list[dict]Independent program dictionaries.
methodget_subtasks¶source
bloqade.core.device.local_storage.DictStorage.get_subtasks
Signature
def get_subtasks(storage_filter: StorageFilter | None = None) -> list[dict]Return stored subtask records.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
storage_filter | StorageFilter | None | None | Optional metadata filter. When None, all subtasks are returned. Defaults to None. |
Returns
list[dict]Independent subtask dictionaries.
methodupdate_subtasks_completed_date¶source
bloqade.core.device.local_storage.DictStorage.update_subtasks_completed_date
Signature
def update_subtasks_completed_date(task_id, subtasks: list[dict]) -> NoneUpdate completion times for stored subtasks.
Parameters
| Name | Type | Description |
|---|---|---|
task_id | str | Backend task ID. |
subtasks | list[dict] | API subtask dictionaries containing `completed_date` and `shot_results` whose entries carry the `subtask_index`. The subtask object itself has no index. |