digitalhub 0.14.0b5__py3-none-any.whl → 0.14.9__py3-none-any.whl

digitalhub/entities/_processors/context/crud.py

@@ -6,14 +6,14 @@ from __future__ import annotations
 
 import typing
 
-from digitalhub.entities._commons.utils import is_valid_key
+from digitalhub.entities._commons.utils import is_valid_key, sanitize_unversioned_key
 from digitalhub.entities._processors.utils import (
+    get_context,
     get_context_from_identifier,
-    get_context_from_project,
     parse_identifier,
 )
 from digitalhub.factory.entity import entity_factory
-from digitalhub.stores.client._base.enums import ApiCategories, BackendOperations
+from digitalhub.stores.client.enums import ApiCategories, BackendOperations
 
 if typing.TYPE_CHECKING:
     from digitalhub.context.context import Context
@@ -77,7 +77,7 @@ class ContextEntityCRUDProcessor:
 
         Parameters
         ----------
-        _entity : ContextEntity, optional
+        _entity : ContextEntity
             An existing context entity object to create. If None,
             a new entity will be built from kwargs.
         **kwargs : dict
@@ -93,7 +93,7 @@ class ContextEntityCRUDProcessor:
             context = _entity._context()
             obj = _entity
         else:
-            context = get_context_from_project(kwargs["project"])
+            context = get_context(kwargs["project"])
             obj: ContextEntity = entity_factory.build_entity_from_params(**kwargs)
         new_obj = self._create_context_entity(context, obj.ENTITY_TYPE, obj.to_dict())
         return entity_factory.build_entity_from_dict(new_obj)
@@ -120,11 +120,11 @@ class ContextEntityCRUDProcessor:
             The project context instance.
         identifier : str
             Entity key (store://...) or entity name identifier.
-        entity_type : str, optional
+        entity_type : str
             The type of entity to read.
-        project : str, optional
+        project : str
             Project name (used for identifier parsing).
-        entity_id : str, optional
+        entity_id : str
             Specific entity ID to read.
         **kwargs : dict
             Additional parameters to pass to the API call.
@@ -185,11 +185,11 @@ class ContextEntityCRUDProcessor:
         ----------
         identifier : str
             Entity key (store://...) or entity name identifier.
-        entity_type : str, optional
+        entity_type : str
             The type of entity to read.
-        project : str, optional
+        project : str
             Project name for context resolution.
-        entity_id : str, optional
+        entity_id : str
             Specific entity ID to read.
         **kwargs : dict
             Additional parameters to pass to the API call.
@@ -230,11 +230,11 @@ class ContextEntityCRUDProcessor:
         ----------
         identifier : str
             Entity key (store://...) or entity ID.
-        entity_type : str, optional
+        entity_type : str
             The type of entity to read.
-        project : str, optional
+        project : str
             Project name for context resolution.
-        entity_id : str, optional
+        entity_id : str
             Specific entity ID to read.
         **kwargs : dict
             Additional parameters to pass to the API call.
@@ -247,9 +247,7 @@ class ContextEntityCRUDProcessor:
         if not is_valid_key(identifier):
             entity_id = identifier
         else:
-            splt = identifier.split(":")
-            if len(splt) == 3:
-                identifier = f"{splt[0]}:{splt[1]}"
+            identifier = sanitize_unversioned_key(identifier)
         return self.read_context_entity(
             identifier,
             entity_type=entity_type,
@@ -278,9 +276,9 @@ class ContextEntityCRUDProcessor:
             The project context instance.
         identifier : str
             Entity key (store://...) or entity name identifier.
-        entity_type : str, optional
+        entity_type : str
             The type of entity to read versions for.
-        project : str, optional
+        project : str
             Project name (used for identifier parsing).
         **kwargs : dict
             Additional parameters to pass to the API call.
@@ -329,9 +327,9 @@ class ContextEntityCRUDProcessor:
         ----------
         identifier : str
             Entity key (store://...) or entity name identifier.
-        entity_type : str, optional
+        entity_type : str
             The type of entity to read versions for.
-        project : str, optional
+        project : str
             Project name for context resolution.
         **kwargs : dict
             Additional parameters to pass to the API call.
@@ -425,7 +423,7 @@ class ContextEntityCRUDProcessor:
         list[ContextEntity]
             List of context entity objects (latest versions only).
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         objs = self._list_context_entities(context, entity_type, **kwargs)
         objects = []
         for o in objs:
@@ -509,7 +507,7 @@ class ContextEntityCRUDProcessor:
         ContextEntity
             The updated context entity object.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         obj = self._update_context_entity(
             context,
             entity_type,
@@ -541,11 +539,11 @@ class ContextEntityCRUDProcessor:
             The project context instance.
         identifier : str
             Entity key (store://...) or entity name identifier.
-        entity_type : str, optional
+        entity_type : str
             The type of entity to delete.
-        project : str, optional
+        project : str
             Project name (used for identifier parsing).
-        entity_id : str, optional
+        entity_id : str
             Specific entity ID to delete.
         **kwargs : dict
             Additional parameters including:
@@ -606,11 +604,11 @@ class ContextEntityCRUDProcessor:
         ----------
         identifier : str
             Entity key (store://...) or entity name identifier.
-        project : str, optional
+        project : str
             Project name for context resolution.
-        entity_type : str, optional
+        entity_type : str
             The type of entity to delete.
-        entity_id : str, optional
+        entity_id : str
             Specific entity ID to delete.
         **kwargs : dict
             Additional parameters including deletion options.

digitalhub/entities/_processors/context/import_export.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import typing
 
 from digitalhub.entities._constructors.uuid import build_uuid
-from digitalhub.entities._processors.utils import get_context_from_identifier, get_context_from_project
+from digitalhub.entities._processors.utils import get_context, get_context_from_identifier
 from digitalhub.factory.entity import entity_factory
 from digitalhub.utils.exceptions import EntityAlreadyExistsError, EntityError, EntityNotExistsError
 from digitalhub.utils.io_utils import read_yaml
@@ -47,7 +47,7 @@ class ContextEntityImportExportProcessor:
             Storage key (store://...) to read the entity from.
         reset_id : bool
             Flag to determine if the ID of context entities should be reset.
-        context : str, optional
+        context : str
             Project name to use for context resolution. If None, uses
             the project specified in the YAML file.
 
@@ -75,7 +75,7 @@ class ContextEntityImportExportProcessor:
         if context is None:
             context = dict_obj["project"]
 
-        ctx = get_context_from_project(context)
+        ctx = get_context(context)
         obj = entity_factory.build_entity_from_dict(dict_obj)
         if reset_id:
             new_id = build_uuid()
@@ -110,7 +110,7 @@ class ContextEntityImportExportProcessor:
             Storage key (store://...) to read the entity from.
         reset_id : bool
             Flag to determine if the ID of executable entities should be reset.
-        context : str, optional
+        context : str
             Project name to use for context resolution.
 
         Returns
@@ -147,7 +147,7 @@ class ContextEntityImportExportProcessor:
         if context is None:
             context = exec_dict["project"]
 
-        ctx = get_context_from_project(context)
+        ctx = get_context(context)
         obj: ExecutableEntity = entity_factory.build_entity_from_dict(exec_dict)
 
         if reset_id:
@@ -190,7 +190,7 @@ class ContextEntityImportExportProcessor:
             The loaded and updated context entity.
         """
         dict_obj: dict = read_yaml(file)
-        context = get_context_from_project(dict_obj["project"])
+        context = get_context(dict_obj["project"])
         obj: ContextEntity = entity_factory.build_entity_from_dict(dict_obj)
         try:
             crud_processor._update_context_entity(context, obj.ENTITY_TYPE, obj.id, obj.to_dict())
@@ -231,7 +231,7 @@ class ContextEntityImportExportProcessor:
             exec_dict = dict_obj
             tsk_dicts = []
 
-        context = get_context_from_project(exec_dict["project"])
+        context = get_context(exec_dict["project"])
         obj: ExecutableEntity = entity_factory.build_entity_from_dict(exec_dict)
 
         try:

digitalhub/entities/_processors/context/material.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import typing
 
 from digitalhub.entities._commons.enums import Relationship, State
-from digitalhub.entities._processors.utils import get_context_from_project
+from digitalhub.entities._processors.utils import get_context
 from digitalhub.factory.entity import entity_factory
 from digitalhub.utils.exceptions import EntityError
 from digitalhub.utils.types import SourcesOrListOfSources
@@ -59,7 +59,7 @@ class ContextEntityMaterialProcessor:
             If file upload fails during the process.
         """
         source: SourcesOrListOfSources = kwargs.pop("source")
-        context = get_context_from_project(kwargs["project"])
+        context = get_context(kwargs["project"])
         obj = entity_factory.build_entity_from_params(**kwargs)
         if context.is_running:
             obj.add_relationship(Relationship.PRODUCEDBY.value, context.get_run_ctx())

digitalhub/entities/_processors/context/special_ops.py

@@ -7,8 +7,8 @@ from __future__ import annotations
 import typing
 from typing import Any
 
-from digitalhub.entities._processors.utils import get_context_from_project
-from digitalhub.stores.client._base.enums import ApiCategories, BackendOperations
+from digitalhub.entities._processors.utils import get_context
+from digitalhub.stores.client.enums import ApiCategories, BackendOperations
 
 if typing.TYPE_CHECKING:
     from digitalhub.entities._base.context.entity import ContextEntity
@@ -47,7 +47,7 @@ class ContextEntitySpecialOpsProcessor:
             The kind/subtype of entity.
         entity_name : str
             The name of the entity.
-        entity_id : str, optional
+        entity_id : str
             The unique identifier of the entity version.
 
         Returns
@@ -55,7 +55,7 @@ class ContextEntitySpecialOpsProcessor:
         str
             The constructed context entity key string.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         return context.client.build_key(
             ApiCategories.CONTEXT.value,
             project=context.name,
@@ -91,7 +91,7 @@ class ContextEntitySpecialOpsProcessor:
         dict
             Secret data retrieved from the backend.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.DATA.value,
@@ -124,7 +124,7 @@ class ContextEntitySpecialOpsProcessor:
         **kwargs : dict
             Additional parameters to pass to the API call.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.DATA.value,
@@ -162,7 +162,7 @@ class ContextEntitySpecialOpsProcessor:
         dict
             Log data retrieved from the backend.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.LOGS.value,
@@ -196,7 +196,7 @@ class ContextEntitySpecialOpsProcessor:
         **kwargs : dict
             Additional parameters to pass to the API call.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.STOP.value,
@@ -204,7 +204,7 @@ class ContextEntitySpecialOpsProcessor:
             entity_type=entity_type,
             entity_id=entity_id,
         )
-        context.client.create_object(api, **kwargs)
+        context.client.create_object(api, obj={}, **kwargs)
 
     def resume_entity(
         self,
@@ -230,7 +230,7 @@ class ContextEntitySpecialOpsProcessor:
         **kwargs : dict
             Additional parameters to pass to the API call.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.RESUME.value,
@@ -238,7 +238,7 @@ class ContextEntitySpecialOpsProcessor:
             entity_type=entity_type,
             entity_id=entity_id,
         )
-        context.client.create_object(api, **kwargs)
+        context.client.create_object(api, obj={}, **kwargs)
 
     def read_files_info(
         self,
@@ -269,7 +269,7 @@ class ContextEntitySpecialOpsProcessor:
         list[dict]
             List of file information dictionaries from the backend.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.FILES.value,
@@ -303,7 +303,7 @@ class ContextEntitySpecialOpsProcessor:
         **kwargs : dict
             Parameters to pass to the API call.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.FILES.value,
@@ -336,7 +336,7 @@ class ContextEntitySpecialOpsProcessor:
             The type of entity to read metrics from.
         entity_id : str
             The unique identifier of the entity.
-        metric_name : str, optional
+        metric_name : str
             The name of a specific metric to retrieve.
             If None, retrieves all available metrics.
         **kwargs : dict
@@ -347,7 +347,7 @@ class ContextEntitySpecialOpsProcessor:
         dict
             Dictionary containing metric data from the backend.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.METRICS.value,
@@ -390,7 +390,7 @@ class ContextEntitySpecialOpsProcessor:
         **kwargs : dict
             Additional parameters to pass to the API call.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         api = context.client.build_api(
             ApiCategories.CONTEXT.value,
             BackendOperations.METRICS.value,
@@ -428,22 +428,22 @@ class ContextEntitySpecialOpsProcessor:
             The CRUD processor instance for entity operations.
         project : str
             The project name to search within.
-        query : str, optional
+        query : str
             Free-text search query to match against entity content.
-        entity_types : list[str], optional
+        entity_types : list[str]
             List of entity types to filter by.
             If None, searches all entity types.
-        name : str, optional
+        name : str
             Entity name pattern to match.
-        kind : str, optional
+        kind : str
             Entity kind to filter by.
-        created : str, optional
+        created : str
             Creation date filter (ISO format).
-        updated : str, optional
+        updated : str
             Last update date filter (ISO format).
-        description : str, optional
+        description : str
             Description pattern to match.
-        labels : list[str], optional
+        labels : list[str]
             List of label patterns to match.
         **kwargs : dict
             Additional search parameters to pass to the API call.
@@ -453,7 +453,7 @@ class ContextEntitySpecialOpsProcessor:
         list[ContextEntity]
             List of matching entity instances from the search.
         """
-        context = get_context_from_project(project)
+        context = get_context(project)
         kwargs = context.client.build_parameters(
             ApiCategories.CONTEXT.value,
             BackendOperations.SEARCH.value,

digitalhub/entities/_processors/utils.py

@@ -7,16 +7,11 @@ from __future__ import annotations
 import typing
 
 from digitalhub.context.api import get_context
-from digitalhub.entities._commons.enums import EntityTypes
 from digitalhub.entities._commons.utils import get_project_from_key, is_valid_key, parse_entity_key
-from digitalhub.factory.entity import entity_factory
-from digitalhub.stores.client._base.enums import ApiCategories, BackendOperations
-from digitalhub.stores.client.api import get_client
-from digitalhub.utils.exceptions import ContextError, EntityError, EntityNotExistsError
+from digitalhub.utils.exceptions import EntityError
 
 if typing.TYPE_CHECKING:
     from digitalhub.context.context import Context
-    from digitalhub.stores.client._base.client import Client
 
 
 def parse_identifier(
@@ -38,13 +33,13 @@ def parse_identifier(
     identifier : str
         The entity identifier to parse. Can be either a full entity key
         (store://project/entity_type/kind/name:id) or a simple entity name.
-    project : str, optional
+    project : str
         The project name. Required when identifier is not a full key.
-    entity_type : str, optional
+    entity_type : str
         The entity type. Required when identifier is not a full key.
-    entity_kind : str, optional
+    entity_kind : str
         The entity kind specification.
-    entity_id : str, optional
+    entity_id : str
         The entity version identifier.
 
     Returns
@@ -81,7 +76,7 @@ def get_context_from_identifier(
     identifier : str
         The entity identifier to extract context from. Can be either
         a full entity key (store://...) or a simple entity name.
-    project : str, optional
+    project : str
         The project name. Required when identifier is not a full key.
 
     Returns
@@ -100,108 +95,4 @@ def get_context_from_identifier(
     else:
         project = get_project_from_key(identifier)
 
-    return get_context_from_project(project)
-
-
-def get_context_from_project(
-    project: str,
-) -> Context:
-    """
-    Retrieve context for a project, fetching from remote if necessary.
-
-    Attempts to get the project context from the local cache first.
-    If the project is not found locally, tries to fetch it from the
-    remote backend and create the context.
-
-    Parameters
-    ----------
-    project : str
-        The name of the project to get context for.
-
-    Returns
-    -------
-    Context
-        The context instance for the specified project.
-
-    Raises
-    ------
-    ContextError
-        If the project cannot be found locally or remotely.
-    """
-    try:
-        return get_context(project)
-    except ContextError:
-        return get_context_from_remote(project)
-
-
-def get_context_from_remote(
-    project: str,
-) -> Context:
-    """
-    Fetch project context from remote backend and create local context.
-
-    Retrieves project information from the remote backend, builds the
-    project entity locally, and returns the corresponding context.
-    Used when a project is not available in the local context cache.
-
-    Parameters
-    ----------
-    project : str
-        The name of the project to fetch from remote.
-
-    Returns
-    -------
-    Context
-        The context instance created from the remote project data.
-
-    Raises
-    ------
-    ContextError
-        If the project is not found on the remote backend.
-    """
-    try:
-        client = get_client()
-        obj = _read_base_entity(client, EntityTypes.PROJECT.value, project)
-        entity_factory.build_entity_from_dict(obj)
-        return get_context(project)
-    except EntityNotExistsError:
-        raise ContextError(f"Project '{project}' not found.")
-
-
-def _read_base_entity(
-    client: Client,
-    entity_type: str,
-    entity_name: str,
-    **kwargs,
-) -> dict:
-    """
-    Read entity data from the backend API.
-
-    Internal utility function that performs a base-level entity read
-    operation through the client API. Builds the appropriate API
-    endpoint and retrieves the entity data as a dictionary.
-
-    Parameters
-    ----------
-    client : Client
-        The client instance to use for the API request.
-    entity_type : str
-        The type of entity to read (e.g., 'project', 'function').
-    entity_name : str
-        The name identifier of the entity to retrieve.
-    **kwargs : dict
-        Additional parameters to pass to the API call, such as
-        version specifications or query filters.
-
-    Returns
-    -------
-    dict
-        Dictionary containing the entity data retrieved from the backend.
-    """
-    api = client.build_api(
-        ApiCategories.BASE.value,
-        BackendOperations.READ.value,
-        entity_type=entity_type,
-        entity_name=entity_name,
-    )
-    return client.read_object(api, **kwargs)
+    return get_context(project)

digitalhub/entities/artifact/crud.py

@@ -212,7 +212,7 @@ def list_artifacts(
     state: str | None = None,
     created: str | None = None,
     updated: str | None = None,
-    version: str | None = None,
+    versions: str | None = None,
 ) -> list[Artifact]:
     """
     List all latest version objects from backend.
@@ -235,7 +235,7 @@ def list_artifacts(
         Creation date filter.
     updated : str
         Update date filter.
-    version : str
+    versions : str
         Object version, default is latest.
 
     Returns
@@ -257,7 +257,7 @@ def list_artifacts(
         state=state,
         created=created,
         updated=updated,
-        version=version,
+        versions=versions,
     )
 
 

digitalhub/entities/artifact/utils.py

@@ -23,7 +23,7 @@ def eval_source(
 
     Parameters
     ----------
-    source : str, list[str], or None, optional
+    source : str, list[str], or None
         The source specification(s) to evaluate. Can be a single
         source string, a list of source strings, or None.
 
@@ -59,7 +59,7 @@ def process_kwargs(
     source : str or list[str]
         The source specification(s) for the artifact content.
         Can be a single source or multiple sources.
-    path : str, optional
+    path : str
         The destination path for the artifact entity.
         If None, a path will be automatically generated.
     **kwargs : dict

digitalhub/entities/builders.py

@@ -10,6 +10,7 @@ from digitalhub.entities.dataitem.table.builder import DataitemTableBuilder
 from digitalhub.entities.model.mlflow.builder import ModelModelBuilder
 from digitalhub.entities.project._base.builder import ProjectProjectBuilder
 from digitalhub.entities.secret._base.builder import SecretSecretBuilder
+from digitalhub.entities.trigger.lifecycle.builder import TriggerLifecycleBuilder
 from digitalhub.entities.trigger.scheduler.builder import TriggerSchedulerBuilder
 
 entity_builders: tuple = (
@@ -20,6 +21,7 @@ entity_builders: tuple = (
     (DataitemTableBuilder.ENTITY_KIND, DataitemTableBuilder),
     (ModelModelBuilder.ENTITY_KIND, ModelModelBuilder),
     (TriggerSchedulerBuilder.ENTITY_KIND, TriggerSchedulerBuilder),
+    (TriggerLifecycleBuilder.ENTITY_KIND, TriggerLifecycleBuilder),
 )
 
 ##############################

digitalhub/entities/dataitem/crud.py

@@ -241,7 +241,7 @@ def list_dataitems(
     state: str | None = None,
     created: str | None = None,
     updated: str | None = None,
-    version: str | None = None,
+    versions: str | None = None,
 ) -> list[Dataitem]:
     """
     List all latest version objects from backend.
@@ -264,7 +264,7 @@ def list_dataitems(
         Creation date filter.
     updated : str
         Update date filter.
-    version : str
+    versions : str
         Object version, default is latest.
 
     Returns
@@ -286,7 +286,7 @@ def list_dataitems(
         state=state,
         created=created,
         updated=updated,
-        version=version,
+        versions=versions,
     )