digitalhub 0.14.0b2__py3-none-any.whl → 0.14.0b3__py3-none-any.whl

digitalhub/entities/workflow/crud.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 import typing
 
 from digitalhub.entities._commons.enums import EntityTypes
-from digitalhub.entities._processors.context import context_processor
+from digitalhub.entities._processors.processors import context_processor
 
 if typing.TYPE_CHECKING:
     from digitalhub.entities.workflow._base.entity import Workflow
@@ -99,9 +99,7 @@ def get_workflow(
     Examples
     --------
     Using entity key:
-    >>> obj = get_workflow(
-    ...     "store://my-workflow-key"
-    ... )
+    >>> obj = get_workflow("store://my-workflow-key")
 
     Using entity name:
     >>> obj = get_workflow("my-workflow-name"
@@ -142,9 +140,7 @@ def get_workflow_versions(
     Examples
     --------
     Using entity key:
-    >>> obj = get_workflow_versions(
-    ...     "store://my-workflow-key"
-    ... )
+    >>> obj = get_workflow_versions("store://my-workflow-key")
 
     Using entity name:
     >>> obj = get_workflow_versions("my-workflow-name"
@@ -176,9 +172,7 @@ def list_workflows(project: str, **kwargs) -> list[Workflow]:
 
     Examples
     --------
-    >>> objs = list_workflows(
-    ...     project="my-project"
-    ... )
+    >>> objs = list_workflows(project="my-project")
     """
     return context_processor.list_context_entities(
         project=project,
@@ -214,9 +208,7 @@ def import_workflow(
 
     Examples
     --------
-    >>> obj = import_workflow(
-    ...     "my-workflow.yaml"
-    ... )
+    >>> obj = import_workflow("my-workflow.yaml")
     """
     return context_processor.import_executable_entity(file, key, reset_id, context)
 
@@ -237,9 +229,7 @@ def load_workflow(file: str) -> Workflow:
 
     Examples
     --------
-    >>> obj = load_workflow(
-    ...     "my-workflow.yaml"
-    ... )
+    >>> obj = load_workflow("my-workflow.yaml")
     """
     return context_processor.load_executable_entity(file)
 
@@ -260,11 +250,7 @@ def update_workflow(entity: Workflow) -> Workflow:
 
     Examples
     --------
-    >>> obj = (
-    ...     update_workflow(
-    ...         obj
-    ...     )
-    ... )
+    >>> obj = update_workflow(obj)
     """
     return context_processor.update_context_entity(
         project=entity.project,
@@ -308,9 +294,7 @@ def delete_workflow(
     Examples
     --------
     If delete_all_versions is False:
-    >>> obj = delete_workflow(
-    ...     "store://my-workflow-key"
-    ... )
+    >>> obj = delete_workflow("store://my-workflow-key")
 
     Otherwise:
     >>> obj = delete_workflow("workflow-name",

digitalhub/factory/registry.py

@@ -47,10 +47,6 @@ class BuilderRegistry:
         builder : type[EntityBuilder] | type[RuntimeEntityBuilder]
             The builder class to register. It will be instantiated immediately.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         BuilderError
@@ -71,10 +67,6 @@ class BuilderRegistry:
         builder : type[RuntimeBuilder]
             The builder class to register. It will be instantiated immediately.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         BuilderError
@@ -141,10 +133,6 @@ class BuilderRegistry:
     def _ensure_entities_registered(self) -> None:
         """
         Ensure core entities are registered on-demand.
-
-        Returns
-        -------
-        None
         """
         if self._entities_registered:
             return
@@ -160,10 +148,6 @@ class BuilderRegistry:
 
         Imports the core entities module and registers all entity
         builders with the registry.
-
-        Returns
-        -------
-        None
         """
         try:
             module = import_module(FactoryEnum.REG_ENTITIES.value)
@@ -178,10 +162,6 @@ class BuilderRegistry:
     def _ensure_runtimes_registered(self) -> None:
         """
         Ensure runtime entities are registered on-demand.
-
-        Returns
-        -------
-        None
         """
         if self._runtimes_registered:
             return
@@ -197,10 +177,6 @@ class BuilderRegistry:
 
         Imports each runtime package and registers its entity and runtime
         builders with the registry.
-
-        Returns
-        -------
-        None
         """
         try:
             for package in list_runtimes():

digitalhub/stores/client/dhcore/client.py

@@ -58,16 +58,6 @@ class ClientDHCore(Client):
         Parses backend responses and raises appropriate exceptions.
     _configurator : ClientDHCoreConfigurator
         Manages client configuration and authentication.
-
-    Examples
-    --------
-    >>> from digitalhub.stores.client.api import (
-    ...     get_client,
-    ... )
-    >>> client = get_client(
-    ...     local=False
-    ... )
-    >>> # Client is now ready for API operations
     """
 
     def __init__(self, config: dict | None = None) -> None:
@@ -79,10 +69,6 @@ class ClientDHCore(Client):
         config : dict, optional
             DHCore environment configuration. If None, loads from environment
             variables and configuration files.
-
-        Returns
-        -------
-        None
         """
         super().__init__()
 
@@ -494,10 +480,6 @@ class ClientDHCore(Client):
         response : Response
             HTTP response containing X-Api-Level header.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         ClientError

digitalhub/stores/client/dhcore/configurator.py

@@ -47,10 +47,6 @@ class ClientDHCoreConfigurator(Configurator):
     def __init__(self) -> None:
         """
         Initialize DHCore configurator and evaluate authentication type.
-
-        Returns
-        -------
-        None
         """
         super().__init__()
         self._auth_type: str | None = None
@@ -66,10 +62,6 @@ class ClientDHCoreConfigurator(Configurator):
 
         Sanitizes endpoint and issuer URLs to ensure proper HTTP/HTTPS schemes
         and removes trailing slashes.
-
-        Returns
-        -------
-        None
         """
         env_creds = self._creds_handler.load_from_env(self.keys)
         env_creds = self._sanitize_env_vars(env_creds)
@@ -107,10 +99,6 @@ class ClientDHCoreConfigurator(Configurator):
 
         Handles keys without "DHCORE_" prefix for CLI compatibility. Falls back
         to environment variables for missing endpoint and personal access token values.
-
-        Returns
-        -------
-        None
         """
         file_creds = self._creds_handler.load_from_file(self.keys)
 
@@ -119,6 +107,11 @@ class ClientDHCoreConfigurator(Configurator):
         if file_creds[pat] is None:
             file_creds[pat] = self._creds_handler.load_from_env([pat]).get(pat)
 
+        # Because in the response there is no endpoint
+        endpoint = CredsEnvVar.DHCORE_ENDPOINT.value
+        if file_creds[endpoint] is None:
+            file_creds[endpoint] = self._creds_handler.load_from_env([endpoint]).get(endpoint)
+
         file_creds = self._sanitize_file_vars(file_creds)
         self._creds_handler.set_credentials(self._file, file_creds)
 
@@ -208,10 +201,6 @@ class ClientDHCoreConfigurator(Configurator):
 
         Changes between environment and file credential sources, then re-evaluates
         authentication type based on the new credentials.
-
-        Returns
-        -------
-        None
         """
         super().change_origin()
 
@@ -230,10 +219,6 @@ class ClientDHCoreConfigurator(Configurator):
         OAUTH2 (access + refresh tokens), ACCESS_TOKEN (access only), BASIC
         (username + password). For EXCHANGE type, automatically exchanges the
         personal access token and switches to file-based credentials storage.
-
-        Returns
-        -------
-        None
         """
         creds = creds_handler.get_credentials(self._origin)
         self._auth_type = self._eval_auth_type(creds)
@@ -305,10 +290,6 @@ class ClientDHCoreConfigurator(Configurator):
         change_origin : bool, default False
             Whether to switch credential sources on auth failure.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         ClientError
@@ -462,10 +443,6 @@ class ClientDHCoreConfigurator(Configurator):
         ----------
         response : dict
             OAuth2 token response with new credentials.
-
-        Returns
-        -------
-        None
         """
         for key in self.keys_to_prefix:
             key = key.lower()

digitalhub/stores/client/dhcore/error_parser.py

@@ -44,10 +44,6 @@ class ErrorParser:
         response : Response
             The HTTP response object from requests.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         TimeoutError

digitalhub/stores/credentials/configurator.py

@@ -53,10 +53,6 @@ class Configurator:
     def load_configs(self) -> None:
         """
         Load the configuration from both environment and file sources.
-
-        Returns
-        -------
-        None
         """
         self.load_env_vars()
         self.load_file_vars()
@@ -71,10 +67,6 @@ class Configurator:
         """
         Check if the current profile has changed and reload
         the file credentials if needed.
-
-        Returns
-        -------
-        None
         """
         if (current := self._creds_handler.get_current_profile()) != self._current_profile:
             self.load_file_vars()
@@ -119,10 +111,6 @@ class Configurator:
         """
         Attempt to change the origin of credentials.
         Raise error if already evaluated.
-
-        Returns
-        -------
-        None
         """
         try:
             self.change_origin()
@@ -132,10 +120,6 @@ class Configurator:
     def change_origin(self) -> None:
         """
         Change the origin of credentials from env to file or vice versa.
-
-        Returns
-        -------
-        None
         """
         if self._changed_origin:
             raise ConfigError("Origin has already been changed.")
@@ -147,10 +131,6 @@ class Configurator:
     def change_to_file(self) -> None:
         """
         Set the credentials origin to file.
-
-        Returns
-        -------
-        None
         """
         if self._origin == self._env:
             self._changed_origin = True
@@ -159,10 +139,6 @@ class Configurator:
     def change_to_env(self) -> None:
         """
         Set the credentials origin to environment.
-
-        Returns
-        -------
-        None
         """
         if self._origin == self._file:
             self._changed_origin = True

digitalhub/stores/credentials/handler.py

@@ -64,10 +64,6 @@ class CredentialHandler:
         ----------
         creds_set : str
             Name of the credentials profile to set.
-
-        Returns
-        -------
-        None
         """
         self._profile = creds_set
         set_current_profile(creds_set)
@@ -127,10 +123,6 @@ class CredentialHandler:
         ----------
         creds : dict
             Credentials to write.
-
-        Returns
-        -------
-        None
         """
         write_config(creds, self._profile)
 
@@ -148,10 +140,6 @@ class CredentialHandler:
             The origin of the credentials ('env' or 'file').
         creds : dict
             Credentials to set.
-
-        Returns
-        -------
-        None
         """
         self._creds_store.set_credentials(self._profile, origin, creds)
 

digitalhub/stores/credentials/store.py

@@ -42,10 +42,6 @@ class CredentialsStore:
             Origin of the credentials ('env' or 'file').
         credentials : dict of str to Any
             Dictionary of credentials to set.
-
-        Returns
-        -------
-        None
         """
         if origin == CredsOrigin.ENV.value:
             for key, value in credentials.items():

digitalhub/stores/data/_base/store.py

@@ -114,10 +114,6 @@ class Store:
         src : str
             The source path.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         StoreError
@@ -135,10 +131,6 @@ class Store:
         dst : str
             The destination path.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         StoreError
@@ -158,10 +150,6 @@ class Store:
         overwrite : bool
             Specify if overwrite an existing file.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         StoreError
@@ -179,10 +167,6 @@ class Store:
         ----------
         path : str | Path
             The path to build.
-
-        Returns
-        -------
-        None
         """
         if not isinstance(path, Path):
             path = Path(path)

digitalhub/stores/data/builder.py

@@ -83,10 +83,6 @@ class StoreBuilder:
             The configurator class for store configuration.
             If None, the store will be instantiated without configuration.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         StoreError

digitalhub/stores/data/remote/store.py

@@ -174,10 +174,6 @@ class RemoteStore(Store):
         src : str
             The source location.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         HTTPError

digitalhub/stores/data/s3/configurator.py

@@ -46,10 +46,6 @@ class S3StoreConfigurator(Configurator):
     def load_env_vars(self) -> None:
         """
         Loads the credentials from the environment variables.
-
-        Returns
-        -------
-        None
         """
         env_creds = self._creds_handler.load_from_env(self.keys)
         self._creds_handler.set_credentials(self._env, env_creds)
@@ -57,10 +53,6 @@ class S3StoreConfigurator(Configurator):
     def load_file_vars(self) -> None:
         """
         Loads the credentials from a file.
-
-        Returns
-        -------
-        None
         """
         file_creds = self._creds_handler.load_from_file(self.keys)
         self._creds_handler.set_credentials(self._file, file_creds)

digitalhub/stores/data/s3/store.py

@@ -350,10 +350,6 @@ class S3Store(Store):
             S3 path of the object to be downloaded (e.g., 's3://bucket
         filename : Path
             Local path where the downloaded object will be saved.
-
-        Returns
-        -------
-        None
         """
         client, bucket = self._check_factory(src)
         key = self._get_key(src)
@@ -575,10 +571,6 @@ class S3Store(Store):
             The S3 client object.
         bucket : str
             The name of the S3 bucket.
-
-        Returns
-        -------
-        None
         """
         extra_args = {}
         mime_type = get_file_mime_type(src)
@@ -612,10 +604,6 @@ class S3Store(Store):
             The S3 client object.
         bucket : str
             The name of the S3 bucket.
-
-        Returns
-        -------
-        None
         """
         client.upload_fileobj(
             Fileobj=fileobj,

digitalhub/stores/data/sql/configurator.py

@@ -56,10 +56,6 @@ class SqlStoreConfigurator(Configurator):
         Retrieves SQL database connection credentials from the system
         environment variables and stores them in the configurator's
         credential handler for use in database connections.
-
-        Returns
-        -------
-        None
         """
         env_creds = self._creds_handler.load_from_env(self.keys)
         self._creds_handler.set_credentials(self._env, env_creds)
@@ -71,10 +67,6 @@ class SqlStoreConfigurator(Configurator):
         Retrieves SQL database connection credentials from a
         configuration file and stores them in the configurator's
         credential handler for use in database connections.
-
-        Returns
-        -------
-        None
         """
         file_creds = self._creds_handler.load_from_file(self.keys)
         self._creds_handler.set_credentials(self._file, file_creds)

digitalhub/stores/data/sql/store.py

@@ -526,10 +526,6 @@ class SqlStore(Store):
         engine : Engine
             The SQLAlchemy engine to test for connectivity.
 
-        Returns
-        -------
-        None
-
         Raises
         ------
         ConfigError

digitalhub/stores/readers/data/factory.py

@@ -33,10 +33,6 @@ class ReaderFactory:
             Reader name.
         builder : DataframeReader
             Builder object.
-
-        Returns
-        -------
-        None
         """
         if self._engine_builders is None:
             self._engine_builders = {}
@@ -104,10 +100,6 @@ class ReaderFactory:
         ----------
         engine : str
             Engine name.
-
-        Returns
-        -------
-        None
         """
         if engine not in self._engine_builders:
             raise BuilderError(f"Engine {engine} not found.")

digitalhub/stores/readers/data/pandas/reader.py

@@ -104,10 +104,6 @@ class DataframeReaderPandas(DataframeReader):
             The destination of the dataframe.
         **kwargs : dict
             Keyword arguments.
-
-        Returns
-        -------
-        None
         """
         if extension == FileExtensions.CSV.value:
             return self.write_csv(df, dst, **kwargs)
@@ -128,10 +124,6 @@ class DataframeReaderPandas(DataframeReader):
             The destination of the dataframe.
         **kwargs : dict
             Keyword arguments.
-
-        Returns
-        -------
-        None
         """
         if "index" not in kwargs:
             kwargs["index"] = False
@@ -150,10 +142,6 @@ class DataframeReaderPandas(DataframeReader):
             The destination of the dataframe.
         **kwargs : dict
             Keyword arguments.
-
-        Returns
-        -------
-        None
         """
         if "index" not in kwargs:
             kwargs["index"] = False
@@ -176,10 +164,6 @@ class DataframeReaderPandas(DataframeReader):
             The destination schema.
         **kwargs : dict
             Keyword arguments.
-
-        Returns
-        -------
-        None
         """
         if "index" not in kwargs:
             kwargs["index"] = False

digitalhub/utils/io_utils.py

@@ -80,10 +80,6 @@ class NoDatesSafeLoader(yaml.SafeLoader):
         ----------
         tag_to_remove : str
             The tag to remove.
-
-        Returns
-        -------
-        None
         """
         if "yaml_implicit_resolvers" not in cls.__dict__:
             cls.yaml_implicit_resolvers = cls.yaml_implicit_resolvers.copy()

{digitalhub-0.14.0b2.dist-info → digitalhub-0.14.0b3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: digitalhub
-Version: 0.14.0b2
+Version: 0.14.0b3
 Summary: Python SDK for Digitalhub
 Project-URL: Homepage, https://github.com/scc-digitalhub/digitalhub-sdk
 Author-email: Fondazione Bruno Kessler <digitalhub@fbk.eu>, Matteo Martini <mmartini@fbk.eu>