digitalhub 0.10.0b5__tar.gz → 0.10.0b6__tar.gz

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: digitalhub
-Version: 0.10.0b5
+Version: 0.10.0b6
 Summary: Python SDK for Digitalhub
 Project-URL: Homepage, https://github.com/scc-digitalhub/digitalhub-sdk
 Author-email: Fondazione Bruno Kessler <dslab@fbk.eu>, Matteo Martini <mmartini@fbk.eu>
@@ -244,16 +244,13 @@ Requires-Dist: jsonschema; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Provides-Extra: full
-Requires-Dist: fsspec; extra == 'full'
 Requires-Dist: mlflow; extra == 'full'
 Requires-Dist: pandas; extra == 'full'
-Requires-Dist: s3fs; extra == 'full'
 Provides-Extra: mlflow
 Requires-Dist: mlflow; extra == 'mlflow'
 Provides-Extra: pandas
 Requires-Dist: fsspec; extra == 'pandas'
 Requires-Dist: pandas; extra == 'pandas'
-Requires-Dist: s3fs; extra == 'pandas'
 Description-Content-Type: text/markdown
 
 # Digitalhub Library

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/client/_base/api_builder.py

@@ -10,7 +10,7 @@ class ClientApiBuilder:
     """
 
     @abstractmethod
-    def build_api(self) -> str:
+    def build_api(self, category: str, operation: str, **kwargs) -> str:
         """
         Build the API for the client.
         """

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/client/_base/client.py

@@ -7,6 +7,7 @@ from typing import Any
 if typing.TYPE_CHECKING:
     from digitalhub.client._base.api_builder import ClientApiBuilder
     from digitalhub.client._base.key_builder import ClientKeyBuilder
+    from digitalhub.client._base.params_builder import ClientParametersBuilder
 
 
 class Client:
@@ -21,6 +22,7 @@ class Client:
     def __init__(self) -> None:
         self._api_builder: ClientApiBuilder = None
         self._key_builder: ClientKeyBuilder = None
+        self._params_builder: ClientParametersBuilder = None
 
     ##############################
     # CRUD methods
@@ -112,6 +114,26 @@ class Client:
         """
         return self._key_builder.build_key(category, *args, **kwargs)
 
+    def build_parameters(self, category: str, operation: str, **kwargs) -> dict:
+        """
+        Build the parameters for the client call.
+
+        Parameters
+        ----------
+        category : str
+            API category.
+        operation : str
+            API operation.
+        **kwargs : dict
+            Parameters to build.
+
+        Returns
+        -------
+        dict
+            Parameters formatted.
+        """
+        return self._params_builder.build_parameters(category, operation, **kwargs)
+
     ##############################
     # Interface methods
     ##############################

digitalhub-0.10.0b6/digitalhub/client/_base/params_builder.py

@@ -0,0 +1,16 @@
+from __future__ import annotations
+
+from abc import abstractmethod
+
+
+class ClientParametersBuilder:
+    """
+    This class is used to build the parameters for the client call.
+    Depending on the client, the parameters are built differently.
+    """
+
+    @abstractmethod
+    def build_parameters(self, category: str, operation: str, **kwargs) -> dict:
+        """
+        Build the parameters for the client call.
+        """

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/client/dhcore/api_builder.py

@@ -71,8 +71,11 @@ class ClientDHCoreApiBuilder(ClientApiBuilder):
         """
         Build the context API for the client.
         """
-        entity_type = kwargs["entity_type"] + "s"
         project = kwargs["project"]
+        if operation == BackendOperations.SEARCH.value:
+            return f"{API_CONTEXT}/{project}/solr/search/item"
+
+        entity_type = kwargs["entity_type"] + "s"
         if operation in (
             BackendOperations.CREATE.value,
             BackendOperations.LIST.value,
@@ -94,8 +97,6 @@ class ClientDHCoreApiBuilder(ClientApiBuilder):
             return f"{API_CONTEXT}/{project}/{entity_type}/data"
         elif operation == BackendOperations.FILES.value:
             return f"{API_CONTEXT}/{project}/{entity_type}/{kwargs['entity_id']}/files/info"
-        elif operation == BackendOperations.SEARCH.value:
-            return f"{API_CONTEXT}/{project}/solr/search/item"
         elif operation == BackendOperations.METRICS.value:
             if kwargs["metric_name"] is not None:
                 return f"{API_CONTEXT}/{project}/{entity_type}/{kwargs['entity_id']}/metrics/{kwargs['metric_name']}"

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/client/dhcore/client.py

@@ -11,6 +11,7 @@ from digitalhub.client.dhcore.api_builder import ClientDHCoreApiBuilder
 from digitalhub.client.dhcore.configurator import ClientDHCoreConfigurator
 from digitalhub.client.dhcore.error_parser import ErrorParser
 from digitalhub.client.dhcore.key_builder import ClientDHCoreKeyBuilder
+from digitalhub.client.dhcore.params_builder import ClientDHCoreParametersBuilder
 from digitalhub.utils.exceptions import BackendError
 from digitalhub.utils.generic_utils import dump_json
 
@@ -43,6 +44,9 @@ class ClientDHCore(Client):
         # Key builder
         self._key_builder = ClientDHCoreKeyBuilder()
 
+        # Parameters builder
+        self._params_builder = ClientDHCoreParametersBuilder()
+
         # Error parser
         self._error_parser = ErrorParser()
 

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/client/dhcore/configurator.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+import os
 import typing
 from warnings import warn
 
@@ -8,6 +9,8 @@ from requests import request
 from digitalhub.client.dhcore.enums import AuthType, DhcoreEnvVar
 from digitalhub.client.dhcore.models import BasicAuth, OAuth2TokenAuth
 from digitalhub.configurator.configurator import configurator
+from digitalhub.stores.s3.enums import S3StoreEnv
+from digitalhub.stores.sql.enums import SqlStoreEnv
 from digitalhub.utils.exceptions import ClientError
 from digitalhub.utils.uri_utils import has_remote_scheme
 
@@ -264,6 +267,20 @@ class ClientDHCoreConfigurator:
         configurator.set_credential(DhcoreEnvVar.ACCESS_TOKEN.value, dict_response["access_token"])
         configurator.set_credential(DhcoreEnvVar.REFRESH_TOKEN.value, dict_response["refresh_token"])
 
+        # Set new credential in stores
+        if (access_key := dict_response.get("aws_access_key_id")) is not None:
+            configurator.set_credential(S3StoreEnv.ACCESS_KEY_ID.value, access_key)
+            os.environ[S3StoreEnv.ACCESS_KEY_ID.value] = access_key
+        if (secret_key := dict_response.get("aws_secret_access_key")) is not None:
+            configurator.set_credential(S3StoreEnv.SECRET_ACCESS_KEY.value,secret_key )
+            os.environ[S3StoreEnv.SECRET_ACCESS_KEY.value] = secret_key
+        if (db_username := dict_response.get("db_username")) is not None:
+            configurator.set_credential(SqlStoreEnv.USERNAME.value, db_username)
+            os.environ[SqlStoreEnv.USERNAME.value] = db_username
+        if (db_password := dict_response.get("db_password")) is not None:
+            configurator.set_credential(SqlStoreEnv.PASSWORD.value, db_password)
+            os.environ[SqlStoreEnv.PASSWORD.value] = db_password
+
         # Propagate new access token to config file
         self._write_env()
 
@@ -280,6 +297,10 @@ class ClientDHCoreConfigurator:
             [
                 DhcoreEnvVar.ACCESS_TOKEN.value,
                 DhcoreEnvVar.REFRESH_TOKEN.value,
+                S3StoreEnv.ACCESS_KEY_ID.value,
+                S3StoreEnv.SECRET_ACCESS_KEY.value,
+                SqlStoreEnv.USERNAME.value,
+                SqlStoreEnv.PASSWORD.value
             ]
         )
 
@@ -334,6 +355,7 @@ class ClientDHCoreConfigurator:
             "grant_type": "refresh_token",
             "client_id": client_id,
             "refresh_token": refresh_token,
+            "scope": "openid credentials offline_access",
         }
         headers = {"Content-Type": "application/x-www-form-urlencoded"}
         return request("POST", url, data=payload, headers=headers, timeout=60)

digitalhub-0.10.0b6/digitalhub/client/dhcore/params_builder.py

@@ -0,0 +1,174 @@
+from __future__ import annotations
+
+from digitalhub.client._base.params_builder import ClientParametersBuilder
+from digitalhub.entities._commons.enums import ApiCategories, BackendOperations
+
+
+class ClientDHCoreParametersBuilder(ClientParametersBuilder):
+    """
+    This class is used to build the parameters for the DHCore client calls.
+    """
+
+    def build_parameters(self, category: str, operation: str, **kwargs) -> dict:
+        """
+        Build the parameters for the client call.
+
+        Parameters
+        ----------
+        category : str
+            API category.
+        operation : str
+            API operation.
+        **kwargs : dict
+            Parameters to build.
+
+        Returns
+        -------
+        dict
+            Parameters formatted.
+        """
+        if category == ApiCategories.BASE.value:
+            return self.build_parameters_base(operation, **kwargs)
+        return self.build_parameters_context(operation, **kwargs)
+
+    def build_parameters_base(self, operation: str, **kwargs) -> dict:
+        """
+        Build the base parameters for the client call.
+
+        Parameters
+        ----------
+        operation : str
+            API operation.
+        **kwargs : dict
+            Parameters to build.
+
+        Returns
+        -------
+        dict
+            Parameters formatted.
+        """
+        kwargs = self._set_params(**kwargs)
+        if operation == BackendOperations.DELETE.value:
+            if (cascade := kwargs.pop("cascade", None)) is not None:
+                kwargs["params"]["cascade"] = str(cascade).lower()
+        elif operation == BackendOperations.SHARE.value:
+            kwargs["params"]["user"] = kwargs.pop("user")
+            if kwargs.pop("unshare", False):
+                kwargs["params"]["id"] = kwargs.pop("id")
+
+        return kwargs
+
+    def build_parameters_context(self, operation: str, **kwargs) -> dict:
+        """
+        Build the context parameters for the client call.
+
+        Parameters
+        ----------
+        operation : str
+            API operation.
+        **kwargs : dict
+            Parameters to build.
+
+        Returns
+        -------
+        dict
+            Parameters formatted.
+        """
+        kwargs = self._set_params(**kwargs)
+
+        # Handle read
+        if operation == BackendOperations.READ_ALL_VERSIONS.value:
+            kwargs["params"]["versions"] = "all"
+            kwargs["params"]["name"] = kwargs.pop("entity_name")
+        # Handle delete
+        elif operation == BackendOperations.DELETE.value:
+            # Handle cascade
+            if (cascade := kwargs.pop("cascade", None)) is not None:
+                kwargs["params"]["cascade"] = str(cascade).lower()
+
+            # Handle delete all versions
+            entity_id = kwargs.pop("entity_id")
+            entity_name = kwargs.pop("entity_name")
+            if not kwargs.pop("delete_all_versions", False):
+                if entity_id is None:
+                    raise ValueError(
+                        "If `delete_all_versions` is False, `entity_id` must be provided,"
+                        " either as an argument or in key `identifier`.",
+                    )
+            else:
+                kwargs["params"]["name"] = entity_name
+        # Handle search
+        elif operation == BackendOperations.SEARCH.value:
+            # Handle fq
+            if (fq := kwargs.pop("fq", None)) is not None:
+                kwargs["params"]["fq"] = fq
+
+            # Add search query
+            if (query := kwargs.pop("query", None)) is not None:
+                kwargs["params"]["q"] = query
+
+            # Add search filters
+            fq = []
+
+            # Entity types
+            if (entity_types := kwargs.pop("entity_types", None)) is not None:
+                if not isinstance(entity_types, list):
+                    entity_types = [entity_types]
+                if len(entity_types) == 1:
+                    entity_types = entity_types[0]
+                else:
+                    entity_types = " OR ".join(entity_types)
+                fq.append(f"type:({entity_types})")
+
+            # Name
+            if (name := kwargs.pop("name", None)) is not None:
+                fq.append(f'metadata.name:"{name}"')
+
+            # Kind
+            if (kind := kwargs.pop("kind", None)) is not None:
+                fq.append(f'kind:"{kind}"')
+
+            # Time
+            created = kwargs.pop("created", None)
+            updated = kwargs.pop("updated", None)
+            created = created if created is not None else "*"
+            updated = updated if updated is not None else "*"
+            fq.append(f"metadata.updated:[{created} TO {updated}]")
+
+            # Description
+            if (description := kwargs.pop("description", None)) is not None:
+                fq.append(f'metadata.description:"{description}"')
+
+            # Labels
+            if (labels := kwargs.pop("labels", None)) is not None:
+                if len(labels) == 1:
+                    labels = labels[0]
+                else:
+                    labels = " AND ".join(labels)
+                fq.append(f"metadata.labels:({labels})")
+
+            # Add filters
+            kwargs["params"]["fq"] = fq
+
+        return kwargs
+
+    @staticmethod
+    def _set_params(**kwargs) -> dict:
+        """
+        Format params parameter.
+
+        Parameters
+        ----------
+        **kwargs : dict
+            Keyword arguments.
+
+        Returns
+        -------
+        dict
+            Parameters with initialized params.
+        """
+        if not kwargs:
+            kwargs = {}
+        if "params" not in kwargs:
+            kwargs["params"] = {}
+        return kwargs

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/client/local/api_builder.py

@@ -70,7 +70,10 @@ class ClientLocalApiBuilder(ClientApiBuilder):
         """
         Build the context API for the client.
         """
-        entity_type = kwargs["entity_type"] + "s"
+        try:
+            entity_type = kwargs["entity_type"] + "s"
+        except KeyError:
+            pass
         project = kwargs["project"]
         if operation in (
             BackendOperations.CREATE.value,

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/client/local/client.py

@@ -8,6 +8,7 @@ from digitalhub.client._base.client import Client
 from digitalhub.client.local.api_builder import ClientLocalApiBuilder
 from digitalhub.client.local.enums import LocalClientVar
 from digitalhub.client.local.key_builder import ClientLocalKeyBuilder
+from digitalhub.client.local.params_builder import ClientLocalParametersBuilder
 from digitalhub.utils.exceptions import BackendError
 
 
@@ -28,6 +29,7 @@ class ClientLocal(Client):
         super().__init__()
         self._api_builder = ClientLocalApiBuilder()
         self._key_builder = ClientLocalKeyBuilder()
+        self._params_builder = ClientLocalParametersBuilder()
         self._db: dict[str, dict[str, dict]] = {}
 
     ##############################
@@ -50,6 +52,8 @@ class ClientLocal(Client):
         dict
             The created object.
         """
+        if api == LocalClientVar.EMPTY.value:
+            return {}
         if not isinstance(obj, dict):
             raise TypeError("Object must be a dictionary")
 
@@ -178,6 +182,8 @@ class ClientLocal(Client):
         dict
             The updated object.
         """
+        if api == LocalClientVar.EMPTY.value:
+            return {}
         if not isinstance(obj, dict):
             raise TypeError("Object must be a dictionary")
 

digitalhub-0.10.0b6/digitalhub/client/local/params_builder.py

@@ -0,0 +1,116 @@
+from __future__ import annotations
+
+from digitalhub.client._base.params_builder import ClientParametersBuilder
+from digitalhub.entities._commons.enums import ApiCategories, BackendOperations
+
+
+class ClientLocalParametersBuilder(ClientParametersBuilder):
+    """
+    This class is used to build the parameters for the Local client calls.
+    """
+
+    def build_parameters(self, category: str, operation: str, **kwargs) -> dict:
+        """
+        Build the parameters for the client call.
+
+        Parameters
+        ----------
+        category : str
+            API category.
+        operation : str
+            API operation.
+        **kwargs : dict
+            Parameters to build.
+
+        Returns
+        -------
+        dict
+            Parameters formatted.
+        """
+        if category == ApiCategories.BASE.value:
+            return self.build_parameters_base(operation, **kwargs)
+        return self.build_parameters_context(operation, **kwargs)
+
+    def build_parameters_base(self, operation: str, **kwargs) -> dict:
+        """
+        Build the base parameters for the client call.
+
+        Parameters
+        ----------
+        operation : str
+            API operation.
+        **kwargs : dict
+            Parameters to build.
+
+        Returns
+        -------
+        dict
+            Parameters formatted.
+        """
+        kwargs = self._set_params(**kwargs)
+        if operation == BackendOperations.DELETE.value:
+            if (cascade := kwargs.pop("cascade", None)) is not None:
+                kwargs["params"]["cascade"] = str(cascade).lower()
+        return kwargs
+
+    def build_parameters_context(self, operation: str, **kwargs) -> dict:
+        """
+        Build the context parameters for the client call.
+
+        Parameters
+        ----------
+        operation : str
+            API operation.
+        **kwargs : dict
+            Parameters to build.
+
+        Returns
+        -------
+        dict
+            Parameters formatted.
+        """
+        kwargs = self._set_params(**kwargs)
+
+        # Handle read
+        if operation == BackendOperations.READ_ALL_VERSIONS.value:
+            kwargs["params"]["versions"] = "all"
+            kwargs["params"]["name"] = kwargs.pop("entity_name")
+        # Handle delete
+        elif operation == BackendOperations.DELETE.value:
+            # Handle cascade
+            if cascade := kwargs.pop("cascade", None) is not None:
+                kwargs["params"]["cascade"] = str(cascade).lower()
+
+            # Handle delete all versions
+            entity_id = kwargs.pop("entity_id")
+            entity_name = kwargs.pop("entity_name")
+            if not kwargs.pop("delete_all_versions", False):
+                if entity_id is None:
+                    raise ValueError(
+                        "If `delete_all_versions` is False, `entity_id` must be provided,"
+                        " either as an argument or in key `identifier`.",
+                    )
+            else:
+                kwargs["params"]["name"] = entity_name
+        return kwargs
+
+    @staticmethod
+    def _set_params(**kwargs) -> dict:
+        """
+        Format params parameter.
+
+        Parameters
+        ----------
+        **kwargs : dict
+            Keyword arguments.
+
+        Returns
+        -------
+        dict
+            Parameters with initialized params.
+        """
+        if not kwargs:
+            kwargs = {}
+        if "params" not in kwargs:
+            kwargs["params"] = {}
+        return kwargs

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/entities/_base/context/entity.py

@@ -4,7 +4,7 @@ import typing
 
 from digitalhub.context.api import get_context
 from digitalhub.entities._base.entity.entity import Entity
-from digitalhub.entities._operations.processor import processor
+from digitalhub.entities._processors.context import context_processor
 from digitalhub.utils.generic_utils import get_timestamp
 from digitalhub.utils.io_utils import write_yaml
 
@@ -64,7 +64,7 @@ class ContextEntity(Entity):
         ContextEntity
             Entity saved.
         """
-        new_obj = processor.create_context_entity(_entity=self)
+        new_obj = context_processor.create_context_entity(_entity=self)
         self._update_attributes(new_obj)
         return self
 
@@ -79,7 +79,7 @@ class ContextEntity(Entity):
         """
         if self._context().local:
             self.metadata.updated = self.metadata.updated = get_timestamp()
-        new_obj = processor.update_context_entity(self.project, self.ENTITY_TYPE, self.id, self.to_dict())
+        new_obj = context_processor.update_context_entity(self.project, self.ENTITY_TYPE, self.id, self.to_dict())
         self._update_attributes(new_obj)
         return self
 
@@ -106,7 +106,7 @@ class ContextEntity(Entity):
         ContextEntity
             Entity refreshed.
         """
-        new_obj = processor.read_context_entity(self.key)
+        new_obj = context_processor.read_context_entity(self.key)
         self._update_attributes(new_obj)
         return self
 

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/entities/_base/executable/entity.py

@@ -4,7 +4,7 @@ import typing
 
 from digitalhub.entities._base.versioned.entity import VersionedEntity
 from digitalhub.entities._commons.enums import EntityTypes
-from digitalhub.entities._operations.processor import processor
+from digitalhub.entities._processors.context import context_processor
 from digitalhub.entities.run.crud import delete_run, get_run, list_runs
 from digitalhub.entities.task.crud import delete_task
 from digitalhub.factory.api import build_entity_from_dict, build_entity_from_params
@@ -247,7 +247,7 @@ class ExecutableEntity(VersionedEntity):
             Response from backend.
         """
         params = {self.ENTITY_TYPE: self._get_executable_string(), "kind": kind}
-        return processor.list_context_entities(self.project, EntityTypes.TASK.value, params=params)
+        return context_processor.list_context_entities(self.project, EntityTypes.TASK.value, params=params)
 
     def _check_task_in_backend(self, kind: str) -> bool:
         """

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/entities/_base/material/entity.py

@@ -4,7 +4,7 @@ import typing
 from pathlib import Path
 
 from digitalhub.entities._base.versioned.entity import VersionedEntity
-from digitalhub.entities._operations.processor import processor
+from digitalhub.entities._processors.context import context_processor
 from digitalhub.stores.api import get_store
 from digitalhub.utils.types import SourcesOrListOfSources
 
@@ -59,7 +59,7 @@ class MaterialEntity(VersionedEntity):
 
         # Handle files info
         if files is not None:
-            processor.update_files_info(self.project, self.ENTITY_TYPE, self.id, files)
+            context_processor.update_files_info(self.project, self.ENTITY_TYPE, self.id, files)
             self.add_files_info(files)
 
         return obj
@@ -238,7 +238,7 @@ class MaterialEntity(VersionedEntity):
         None
         """
         if not self._context().local and not self.status.files:
-            files = processor.read_files_info(
+            files = context_processor.read_files_info(
                 project=self.project,
                 entity_type=self.ENTITY_TYPE,
                 entity_id=self.id,

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/entities/_base/unversioned/entity.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import typing
 
 from digitalhub.entities._base.context.entity import ContextEntity
-from digitalhub.entities._operations.processor import processor
+from digitalhub.entities._processors.context import context_processor
 
 if typing.TYPE_CHECKING:
     from digitalhub.entities._base.entity.metadata import Metadata
@@ -25,4 +25,4 @@ class UnversionedEntity(ContextEntity):
         super().__init__(project, kind, metadata, spec, status, user)
         self.id = uuid
         self.name = uuid
-        self.key = processor.build_context_entity_key(project, self.ENTITY_TYPE, kind, uuid)
+        self.key = context_processor.build_context_entity_key(project, self.ENTITY_TYPE, kind, uuid)

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/entities/_base/versioned/entity.py

@@ -3,7 +3,7 @@ from __future__ import annotations
 import typing
 
 from digitalhub.entities._base.context.entity import ContextEntity
-from digitalhub.entities._operations.processor import processor
+from digitalhub.entities._processors.context import context_processor
 
 if typing.TYPE_CHECKING:
     from digitalhub.entities._base.entity.metadata import Metadata
@@ -26,4 +26,4 @@ class VersionedEntity(ContextEntity):
         super().__init__(project, kind, metadata, spec, status, user)
         self.name = name
         self.id = uuid
-        self.key = processor.build_context_entity_key(project, self.ENTITY_TYPE, kind, name, uuid)
+        self.key = context_processor.build_context_entity_key(project, self.ENTITY_TYPE, kind, name, uuid)

{digitalhub-0.10.0b5 → digitalhub-0.10.0b6}/digitalhub/entities/_commons/enums.py

@@ -73,6 +73,7 @@ class BackendOperations(Enum):
 
     CREATE = "create"
     READ = "read"
+    READ_ALL_VERSIONS = "read_all_versions"
     UPDATE = "update"
     DELETE = "delete"
     LIST = "list"