digitalhub 0.8.0b2__py3-none-any.whl → 0.8.0b4__py3-none-any.whl

digitalhub/entities/project/builder.py

@@ -1,68 +1,33 @@
 from __future__ import annotations
 
-from digitalhub.entities._builders.metadata import build_metadata
-from digitalhub.entities._builders.name import build_name
-from digitalhub.entities._builders.spec import build_spec
-from digitalhub.entities._builders.status import build_status
-from digitalhub.entities.project.entity import Project
+import typing
 
+from digitalhub.factory.factory import factory
+from digitalhub.utils.exceptions import BuilderError
 
-def project_from_parameters(
-    name: str,
-    kind: str,
-    description: str | None = None,
-    labels: list[str] | None = None,
-    local: bool = False,
-    context: str | None = None,
-    **kwargs,
-) -> Project:
+if typing.TYPE_CHECKING:
+    from digitalhub.entities.project._base.entity import Project
+
+
+def project_from_parameters(**kwargs) -> Project:
     """
     Create a new object.
 
     Parameters
     ----------
-    name : str
-        Object name.
-    kind : str
-        Kind the object.
-    description : str
-        Description of the object (human readable).
-    labels : list[str]
-        List of labels.
-    local : bool
-        If True, use local backend, if False use DHCore backend. Default to False.
-    context : str
-        The context local folder of the project.
-    **kwargs : dict
-        Spec keyword arguments.
+    **kwargs
+        Keyword arguments.
 
     Returns
     -------
     Project
         Object instance.
     """
-    name = build_name(name)
-    spec = build_spec(
-        kind,
-        context=context,
-        **kwargs,
-    )
-    metadata = build_metadata(
-        kind,
-        project=name,
-        name=name,
-        description=description,
-        labels=labels,
-    )
-    status = build_status(kind)
-    return Project(
-        name=name,
-        kind=kind,
-        metadata=metadata,
-        spec=spec,
-        status=status,
-        local=local,
-    )
+    try:
+        kind = kwargs["kind"]
+    except KeyError:
+        raise BuilderError("Missing 'kind' parameter.")
+    return factory.build_entity_from_params(kind, **kwargs)
 
 
 def project_from_dict(obj: dict) -> Project:
@@ -79,4 +44,8 @@ def project_from_dict(obj: dict) -> Project:
     Project
         Object instance.
     """
-    return Project.from_dict(obj)
+    try:
+        kind = obj["kind"]
+    except KeyError:
+        raise BuilderError("Missing 'kind' parameter.")
+    return factory.build_entity_from_dict(kind, obj)

digitalhub/entities/project/crud.py

@@ -7,13 +7,13 @@ from pathlib import Path
 from digitalhub.client.builder import build_client, get_client
 from digitalhub.context.builder import delete_context
 from digitalhub.entities._base.crud import delete_entity_api_base, read_entity_api_base, update_entity_api_base
-from digitalhub.entities.entity_types import EntityTypes
 from digitalhub.entities.project.builder import project_from_dict, project_from_parameters
+from digitalhub.entities.utils.entity_types import EntityTypes
 from digitalhub.utils.exceptions import BackendError, EntityError
 from digitalhub.utils.io_utils import read_yaml
 
 if typing.TYPE_CHECKING:
-    from digitalhub.entities.project.entity import Project
+    from digitalhub.entities.project._base.entity import Project
 
 
 ENTITY_TYPE = EntityTypes.PROJECT.value

digitalhub/entities/run/_base/builder.py

@@ -0,0 +1,73 @@
+from __future__ import annotations
+
+import typing
+
+from digitalhub.entities._base.unversioned.builder import UnversionedBuilder
+from digitalhub.entities.utils.entity_types import EntityTypes
+
+if typing.TYPE_CHECKING:
+    from digitalhub.entities.run._base.entity import Run
+
+
+class RunBuilder(UnversionedBuilder):
+    """
+    Run builder.
+    """
+
+    ENTITY_TYPE = EntityTypes.RUN.value
+
+    def build(
+        self,
+        project: str,
+        kind: str,
+        uuid: str | None = None,
+        labels: list[str] | None = None,
+        task: str | None = None,
+        local_execution: bool = False,
+        **kwargs,
+    ) -> Run:
+        """
+        Create a new object.
+
+        Parameters
+        ----------
+        project : str
+            Project name.
+        kind : str
+            Kind the object.
+        uuid : str
+            ID of the object.
+        labels : list[str]
+            List of labels.
+        task : str
+            Name of the task associated with the run.
+        local_execution : bool
+            Flag to determine if object has local execution.
+        **kwargs : dict
+            Spec keyword arguments.
+
+        Returns
+        -------
+        Run
+            Object instance.
+        """
+        uuid = self.build_uuid(uuid)
+        metadata = self.build_metadata(
+            project=project,
+            name=uuid,
+            labels=labels,
+        )
+        spec = self.build_spec(
+            task=task,
+            local_execution=local_execution,
+            **kwargs,
+        )
+        status = self.build_status()
+        return self.build_entity(
+            project=project,
+            uuid=uuid,
+            kind=kind,
+            metadata=metadata,
+            spec=spec,
+            status=status,
+        )

digitalhub/entities/run/{entity.py → _base/entity.py}

@@ -2,9 +2,6 @@ from __future__ import annotations
 
 import time
 import typing
-from typing import Any
-
-import requests
 
 from digitalhub.entities._base.crud import (
     list_entity_api_base,
@@ -14,22 +11,18 @@ from digitalhub.entities._base.crud import (
     resume_api,
     stop_api,
 )
-from digitalhub.entities._base.entity.unversioned import UnversionedEntity
-from digitalhub.entities._base.state import State
-from digitalhub.entities._builders.spec import build_spec
-from digitalhub.entities._builders.status import build_status
-from digitalhub.entities.entity_types import EntityTypes
-from digitalhub.registry.registry import registry
-from digitalhub.runtimes.builder import build_runtime
+from digitalhub.entities._base.unversioned.entity import UnversionedEntity
+from digitalhub.entities.utils.entity_types import EntityTypes
+from digitalhub.entities.utils.state import State
+from digitalhub.factory.factory import factory
 from digitalhub.utils.exceptions import EntityError
 from digitalhub.utils.logger import LOGGER
 
 if typing.TYPE_CHECKING:
-    from digitalhub.entities._base.entity.material import MaterialEntity
-    from digitalhub.entities._base.metadata import Metadata
-    from digitalhub.entities.run.spec import RunSpec
-    from digitalhub.entities.run.status import RunStatus
-    from digitalhub.runtimes.base import Runtime
+    from digitalhub.entities._base.entity.metadata import Metadata
+    from digitalhub.entities.run._base.spec import RunSpec
+    from digitalhub.entities.run._base.status import RunStatus
+    from digitalhub.runtimes._base import Runtime
 
 
 class Run(UnversionedEntity):
@@ -70,7 +63,7 @@ class Run(UnversionedEntity):
         executable = self._get_executable(runtime)
         task = self._get_task(runtime)
         new_spec = runtime.build(executable, task, self.to_dict())
-        self.spec = build_spec(
+        self.spec = factory.build_spec(
             self.kind,
             **new_spec,
         )
@@ -147,116 +140,6 @@ class Run(UnversionedEntity):
                     LOGGER.info(f"Run {self.id} finished in {current:.2f} seconds.")
                 return self
 
-    def inputs(self, as_dict: bool = False) -> list[dict]:
-        """
-        Get inputs passed in spec as objects or as dictionaries.
-
-        Parameters
-        ----------
-        as_dict : bool
-            If True, return inputs as dictionaries.
-
-        Returns
-        -------
-        list[dict]
-            List of input objects.
-        """
-        try:
-            return self.spec.get_inputs(as_dict=as_dict)
-        except AttributeError:
-            msg = f"Run of type {self.kind} has no inputs."
-            raise EntityError(msg)
-
-    def results(self) -> dict:
-        """
-        Get results from runtime execution.
-
-        Returns
-        -------
-        dict
-            Results.
-        """
-        try:
-            return self.status.get_results()
-        except AttributeError:
-            msg = f"Run of type {self.kind} has no results."
-            raise EntityError(msg)
-
-    def result(self, key: str) -> Any:
-        """
-        Get result from runtime execution by key.
-
-        Parameters
-        ----------
-        key : str
-            Key of the result.
-
-        Returns
-        -------
-        Any
-            Result.
-        """
-        return self.results().get(key)
-
-    def outputs(self, as_key: bool = False, as_dict: bool = False) -> dict:
-        """
-        Get run objects results.
-
-        Parameters
-        ----------
-        as_key : bool
-            If True, return results as keys.
-        as_dict : bool
-            If True, return results as dictionaries.
-
-        Returns
-        -------
-        dict
-            List of output objects.
-        """
-        try:
-            return self.status.get_outputs(as_key=as_key, as_dict=as_dict)
-        except AttributeError:
-            msg = f"Run of type {self.kind} has no outputs."
-            raise EntityError(msg)
-
-    def output(self, key: str, as_key: bool = False, as_dict: bool = False) -> MaterialEntity | dict | str | None:
-        """
-        Get run object result by key.
-
-        Parameters
-        ----------
-        key : str
-            Key of the result.
-        as_key : bool
-            If True, return result as key.
-        as_dict : bool
-            If True, return result as dictionary.
-
-        Returns
-        -------
-        Entity | dict | str | None
-            Result.
-        """
-        return self.outputs(as_key=as_key, as_dict=as_dict).get(key)
-
-    def values(self) -> dict:
-        """
-        Get values from runtime execution.
-
-        Returns
-        -------
-        dict
-            Values from backend.
-        """
-        try:
-            value_list = getattr(self.spec, "values", [])
-            value_list = value_list if value_list is not None else []
-            return self.status.get_values(value_list)
-        except AttributeError:
-            msg = f"Run of type {self.kind} has no values."
-            raise EntityError(msg)
-
     def logs(self) -> dict:
         """
         Get object from backend.
@@ -307,32 +190,6 @@ class Run(UnversionedEntity):
         # TODO verify the logic and order
         self.run()
 
-    def invoke(self, **kwargs) -> requests.Response:
-        """
-        Invoke run.
-
-        Parameters
-        ----------
-        kwargs
-            Keyword arguments to pass to the request.
-
-        Returns
-        -------
-        requests.Response
-            Response from service.
-        """
-        try:
-            if not self._context().local and not self.spec.local_execution:
-                local = False
-            else:
-                local = True
-            if kwargs is None:
-                kwargs = {}
-            return self.status.invoke(local, **kwargs)
-        except AttributeError:
-            msg = f"Run of type {self.kind} has no invoke operation."
-            raise EntityError(msg)
-
     ##############################
     #  Helpers
     ##############################
@@ -361,7 +218,7 @@ class Run(UnversionedEntity):
         -------
         None
         """
-        self.status: RunStatus = build_status(self.kind, **status)
+        self.status: RunStatus = factory.build_status(self.kind, **status)
 
     def _set_state(self, state: str) -> None:
         """
@@ -402,7 +259,7 @@ class Run(UnversionedEntity):
         Runtime
             Runtime object.
         """
-        return build_runtime(self.kind, self.project)
+        return factory.build_runtime(self.kind, self.project)
 
     def _get_executable(self, runtime: Runtime) -> dict:
         """
@@ -419,7 +276,7 @@ class Run(UnversionedEntity):
             Executable (function or workflow) from backend.
         """
         exec_kind = runtime.get_executable_kind()
-        entity_type = registry.get_entity_type(exec_kind)
+        entity_type = factory.get_entity_type_from_builder(exec_kind)
         splitted = self.spec.task.split("/")
         exec_name = splitted[-1].split(":")[0]
         exec_id = splitted[-1].split(":")[1]

digitalhub/entities/run/{spec.py → _base/spec.py}

@@ -2,16 +2,16 @@ from __future__ import annotations
 
 import typing
 
-from digitalhub.entities._base.spec.base import Spec, SpecParams
+from digitalhub.entities._base.entity.spec import Spec, SpecValidator
 from digitalhub.entities.artifact.crud import get_artifact
 from digitalhub.entities.dataitem.crud import get_dataitem
-from digitalhub.entities.entity_types import EntityTypes
 from digitalhub.entities.model.crud import get_model
-from digitalhub.entities.task.models import K8s
-from digitalhub.entities.utils import parse_entity_key
+from digitalhub.entities.task._base.models import K8s
+from digitalhub.entities.utils.entity_types import EntityTypes
+from digitalhub.entities.utils.utils import parse_entity_key
 
 if typing.TYPE_CHECKING:
-    from digitalhub.entities._base.entity.base import Entity
+    from digitalhub.entities._base.entity.entity import Entity
 
 
 ENTITY_FUNC = {
@@ -22,7 +22,7 @@ ENTITY_FUNC = {
 
 
 class RunSpec(Spec):
-    """Run specification."""
+    """RunSpec specifications."""
 
     def __init__(
         self,
@@ -138,9 +138,9 @@ class RunSpec(Spec):
         return ENTITY_FUNC[entity_type](key)
 
 
-class RunParams(SpecParams, K8s):
+class RunValidator(SpecValidator, K8s):
     """
-    Run parameters.
+    RunValidator validator.
     """
 
     function: str = None

digitalhub/entities/run/{status.py → _base/status.py}

@@ -1,11 +1,11 @@
 from __future__ import annotations
 
-from digitalhub.entities._base.status.base import Status
+from digitalhub.entities._base.entity.status import Status
 from digitalhub.entities.artifact.crud import get_artifact
 from digitalhub.entities.dataitem.crud import get_dataitem
-from digitalhub.entities.entity_types import EntityTypes
 from digitalhub.entities.model.crud import get_model
-from digitalhub.entities.utils import parse_entity_key
+from digitalhub.entities.utils.entity_types import EntityTypes
+from digitalhub.entities.utils.utils import parse_entity_key
 
 ENTITY_FUNC = {
     EntityTypes.ARTIFACT.value: get_artifact,
@@ -16,7 +16,7 @@ ENTITY_FUNC = {
 
 class RunStatus(Status):
     """
-    Status class for run entities.
+    RunStatus status.
     """
 
     def __init__(

digitalhub/entities/run/builder.py

@@ -1,63 +1,33 @@
 from __future__ import annotations
 
-from digitalhub.entities._builders.metadata import build_metadata
-from digitalhub.entities._builders.spec import build_spec
-from digitalhub.entities._builders.status import build_status
-from digitalhub.entities._builders.uuid import build_uuid
-from digitalhub.entities.run.entity import Run
+import typing
 
+from digitalhub.factory.factory import factory
+from digitalhub.utils.exceptions import BuilderError
 
-def run_from_parameters(
-    project: str,
-    kind: str,
-    uuid: str | None = None,
-    labels: list[str] | None = None,
-    task: str | None = None,
-    local_execution: bool = False,
-    **kwargs,
-) -> Run:
+if typing.TYPE_CHECKING:
+    from digitalhub.entities.run._base.entity import Run
+
+
+def run_from_parameters(**kwargs) -> Run:
     """
-    Create run.
+    Create a new object.
 
     Parameters
     ----------
-    project : str
-        Project name.
-    kind : str
-        Kind the object.
-    uuid : str
-        ID of the object (UUID4, e.g. 40f25c4b-d26b-4221-b048-9527aff291e2).
-    labels : list[str]
-        List of labels.
-    task : str
-        Name of the task associated with the run.
-    local_execution : bool
-        Flag to determine if object has local execution.
-    **kwargs : dict
-        Spec keyword arguments.
+    **kwargs
+        Keyword arguments.
 
     Returns
     -------
     Run
         Object instance.
     """
-    uuid = build_uuid(uuid)
-    metadata = build_metadata(
-        kind=kind,
-        project=project,
-        name=uuid,
-        labels=labels,
-    )
-    spec = build_spec(kind, task=task, local_execution=local_execution, **kwargs)
-    status = build_status(kind)
-    return Run(
-        project=project,
-        uuid=uuid,
-        kind=kind,
-        metadata=metadata,
-        spec=spec,
-        status=status,
-    )
+    try:
+        kind = kwargs["kind"]
+    except KeyError:
+        raise BuilderError("Missing 'kind' parameter.")
+    return factory.build_entity_from_params(kind, **kwargs)
 
 
 def run_from_dict(obj: dict) -> Run:
@@ -74,4 +44,8 @@ def run_from_dict(obj: dict) -> Run:
     Run
         Object instance.
     """
-    return Run.from_dict(obj)
+    try:
+        kind = obj["kind"]
+    except KeyError:
+        raise BuilderError("Missing 'kind' parameter.")
+    return factory.build_entity_from_dict(kind, obj)

digitalhub/entities/run/crud.py

@@ -4,13 +4,13 @@ import typing
 
 from digitalhub.context.builder import check_context
 from digitalhub.entities._base.crud import delete_entity_api_ctx, list_entity_api_ctx, read_entity_api_ctx
-from digitalhub.entities.entity_types import EntityTypes
 from digitalhub.entities.run.builder import run_from_dict, run_from_parameters
+from digitalhub.entities.utils.entity_types import EntityTypes
 from digitalhub.utils.exceptions import EntityAlreadyExistsError, EntityError
 from digitalhub.utils.io_utils import read_yaml
 
 if typing.TYPE_CHECKING:
-    from digitalhub.entities.run.entity import Run
+    from digitalhub.entities.run._base.entity import Run
 
 
 ENTITY_TYPE = EntityTypes.RUN.value
@@ -35,7 +35,7 @@ def new_run(
     kind : str
         Kind the object.
     uuid : str
-        ID of the object (UUID4, e.g. 40f25c4b-d26b-4221-b048-9527aff291e2).
+        ID of the object.
     labels : list[str]
         List of labels.
     task : str

digitalhub/entities/secret/_base/builder.py

@@ -0,0 +1,81 @@
+from __future__ import annotations
+
+from digitalhub.entities._base.versioned.builder import VersionedBuilder
+from digitalhub.entities.secret._base.entity import Secret
+from digitalhub.entities.secret._base.spec import SecretSpec, SecretValidator
+from digitalhub.entities.secret._base.status import SecretStatus
+from digitalhub.entities.utils.entity_types import EntityTypes
+
+
+class SecretSecretBuilder(VersionedBuilder):
+    """
+    SecretSecretBuilder builder.
+    """
+
+    ENTITY_TYPE = EntityTypes.SECRET.value
+    ENTITY_CLASS = Secret
+    ENTITY_SPEC_CLASS = SecretSpec
+    ENTITY_SPEC_VALIDATOR = SecretValidator
+    ENTITY_STATUS_CLASS = SecretStatus
+    ENTITY_KIND = "secret"
+
+    def build(
+        self,
+        kind: str,
+        project: str,
+        name: str,
+        uuid: str | None = None,
+        description: str | None = None,
+        labels: list[str] | None = None,
+        **kwargs,
+    ) -> Secret:
+        """
+        Create a new object.
+
+        Parameters
+        ----------
+        project : str
+            Project name.
+        name : str
+            Object name.
+        kind : str
+            Kind the object.
+        uuid : str
+            ID of the object.
+        description : str
+            Description of the object (human readable).
+        labels : list[str]
+            List of labels.
+        **kwargs : dict
+            Spec keyword arguments.
+
+        Returns
+        -------
+        Secret
+            Object instance.
+        """
+        name = self.build_name(name)
+        uuid = self.build_uuid(uuid)
+        metadata = self.build_metadata(
+            project=project,
+            name=name,
+            description=description,
+            labels=labels,
+        )
+        path = f"kubernetes://dhcore-proj-secrets-{project}/{name}"
+        provider = "kubernetes"
+        spec = self.build_spec(
+            path=path,
+            provider=provider,
+            **kwargs,
+        )
+        status = self.build_status()
+        return self.build_entity(
+            project=project,
+            name=name,
+            uuid=uuid,
+            kind=kind,
+            metadata=metadata,
+            spec=spec,
+            status=status,
+        )