ocean-runner 0.2.19__py3-none-any.whl → 0.2.23__py3-none-any.whl

ocean_runner/config.py

@@ -27,8 +27,8 @@ class Environment(BaseSettings):
         description="Base data directory, defaults to '/data'",
     )
 
-    dids: str | list[Path] | None = Field(
-        default=None,
+    dids: list[Path] | str | None = Field(
+        default_factory=list,
         validation_alias=Keys.DIDS.value,
         description='Datasets DID\'s, format: ["XXXX"]',
     )

ocean_runner/runner.py

@@ -1,26 +1,31 @@
 from __future__ import annotations
 
-from dataclasses import InitVar, asdict, dataclass, field
+import asyncio
+import inspect
+from dataclasses import InitVar, dataclass, field
 from logging import Logger
 from pathlib import Path
-from typing import Callable, Generic, TypeVar
+from typing import Awaitable, Callable, Generic, TypeAlias, TypeVar
 
-from oceanprotocol_job_details import JobDetails  # type: ignore
+from oceanprotocol_job_details import load_job_details, JobDetails  # type: ignore
 
 from ocean_runner.config import Config
 
 InputT = TypeVar("InputT")
 ResultT = TypeVar("ResultT")
+T = TypeVar("T")
 
-ValidateFuncT = Callable[["Algorithm"], None]
-RunFuncT = Callable[["Algorithm"], ResultT] | None
-SaveFuncT = Callable[["Algorithm", ResultT, Path], None]
-ErrorFuncT = Callable[["Algorithm", Exception], None]
 
+Algo: TypeAlias = "Algorithm[InputT, ResultT]"
+ValidateFuncT: TypeAlias = Callable[[Algo], None | Awaitable[None] | None]
+RunFuncT: TypeAlias = Callable[[Algo], ResultT | Awaitable[ResultT]]
+SaveFuncT: TypeAlias = Callable[[Algo, ResultT, Path], Awaitable[None] | None]
+ErrorFuncT: TypeAlias = Callable[[Algo, Exception], Awaitable[None] | None]
 
-def default_error_callback(algorithm: Algorithm, e: Exception) -> None:
+
+def default_error_callback(algorithm: Algorithm, error: Exception) -> None:
     algorithm.logger.exception("Error during algorithm execution")
-    raise e
+    raise error
 
 
 def default_validation(algorithm: Algorithm) -> None:
@@ -29,10 +34,29 @@ def default_validation(algorithm: Algorithm) -> None:
     assert algorithm.job_details.files, "Files missing"
 
 
-def default_save(algorithm: Algorithm, result: ResultT, base: Path) -> None:
+async def default_save(algorithm: Algorithm, result: ResultT, base: Path) -> None:
+    import aiofiles
+
     algorithm.logger.info("Saving results using default save")
-    with open(base / "result.txt", "w+") as f:
-        f.write(str(result))
+    async with aiofiles.open(base / "result.txt", "w+") as f:
+        await f.write(str(result))
+
+
+async def execute(function: Callable[..., T | Awaitable[T]], *args, **kwargs) -> T:
+    result = function(*args, **kwargs)
+
+    if inspect.isawaitable(result):
+        return await result
+
+    return result
+
+
+@dataclass(slots=True)
+class Functions(Generic[InputT, ResultT]):
+    validate: ValidateFuncT = field(default=default_validation, init=False)
+    run: RunFuncT | None = field(default=None, init=False)
+    save: SaveFuncT = field(default=default_save, init=False)
+    error: ErrorFuncT = field(default=default_error_callback, init=False)
 
 
 @dataclass
@@ -44,33 +68,13 @@ class Algorithm(Generic[InputT, ResultT]):
     """
 
     config: InitVar[Config[InputT] | None] = field(default=None)
-    logger: Logger = field(init=False)
-    _job_details: JobDetails[InputT] = field(init=False)
-    _result: ResultT | None = field(default=None, init=False)
 
-    # Decorator-registered callbacks
-    _validate_fn: ValidateFuncT = field(
-        default=default_validation,
-        init=False,
-        repr=False,
-    )
+    logger: Logger = field(init=False, repr=False)
 
-    _run_fn: RunFuncT = field(
-        default=None,
-        init=False,
-        repr=False,
-    )
-
-    _save_fn: SaveFuncT = field(
-        default=default_save,
-        init=False,
-        repr=False,
-    )
-
-    _error_callback: ErrorFuncT = field(
-        default=default_error_callback,
-        init=False,
-        repr=False,
+    _job_details: JobDetails[InputT] = field(init=False)
+    _result: ResultT | None = field(default=None, init=False)
+    _functions: Functions[InputT, ResultT] = field(
+        default_factory=Functions, init=False, repr=False
     )
 
     def __post_init__(self, config: Config[InputT] | None) -> None:
@@ -127,55 +131,61 @@ class Algorithm(Generic[InputT, ResultT]):
     # ---------------------------
 
     def validate(self, fn: ValidateFuncT) -> ValidateFuncT:
-        self._validate_fn = fn
+        self._functions.validate = fn
         return fn
 
     def run(self, fn: RunFuncT) -> RunFuncT:
-        self._run_fn = fn
+        self._functions.run = fn
         return fn
 
     def save_results(self, fn: SaveFuncT) -> SaveFuncT:
-        self._save_fn = fn
+        self._functions.save = fn
         return fn
 
     def on_error(self, fn: ErrorFuncT) -> ErrorFuncT:
-        self._error_callback = fn
+        self._functions.error = fn
         return fn
 
     # ---------------------------
     # Execution Pipeline
     # ---------------------------
 
-    def __call__(self) -> ResultT | None:
-        """Executes the algorithm pipeline: validate → run → save_results."""
-        # Load job details
-        self._job_details = JobDetails.load(
-            _type=self.configuration.custom_input,
-            base_dir=self.configuration.environment.base_dir,
-            dids=self.configuration.environment.dids,
-            transformation_did=self.configuration.environment.transformation_did,
-            secret=self.configuration.environment.secret,
+    async def execute(self) -> ResultT | None:
+        self._job_details = load_job_details(
+            {
+                "base_dir": self.configuration.environment.base_dir,
+                "dids": self.configuration.environment.dids or [],
+                "secret": self.configuration.environment.secret,
+                "transformation_did": self.configuration.environment.transformation_did,
+            },
+            self.configuration.custom_input,
         )
 
         self.logger.info("Loaded JobDetails")
-        self.logger.debug(asdict(self.job_details))
+        self.logger.debug(self.job_details.model_dump())
 
         try:
-            # Validation step
-            self._validate_fn(self)
+            await execute(self._functions.validate, self)
 
-            # Run step
-            if self._run_fn:
+            if self._functions.run:
                 self.logger.info("Running algorithm...")
-                self._result = self._run_fn(self)
+                self._result = await execute(self._functions.run, self)
             else:
                 self.logger.error("No run() function defined. Skipping execution.")
                 self._result = None
 
-            # Save step
-            self._save_fn(self, self._result, self.job_details.paths.outputs)
+            await execute(
+                self._functions.save,
+                algorithm=self,
+                result=self._result,
+                base=self.job_details.paths.outputs,
+            )
 
         except Exception as e:
-            self._error_callback(self, e)
+            await execute(self._functions.error, self, e)
 
         return self._result
+
+    def __call__(self) -> ResultT | None:
+        """Executes the algorithm pipeline: validate → run → save_results."""
+        return asyncio.run(self.execute())

{ocean_runner-0.2.19.dist-info → ocean_runner-0.2.23.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ocean-runner
-Version: 0.2.19
+Version: 0.2.23
 Summary: A fluent API for OceanProtocol algorithms
 Project-URL: Homepage, https://github.com/AgrospAI/ocean-runner
 Project-URL: Issues, https://github.com/AgrospAI/ocean-runner/issues
@@ -17,7 +17,8 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
 Requires-Python: >=3.10
-Requires-Dist: oceanprotocol-job-details>=0.2.8
+Requires-Dist: aiofiles>=25.1.0
+Requires-Dist: oceanprotocol-job-details>=0.3.4
 Requires-Dist: pydantic-settings>=2.12.0
 Requires-Dist: pydantic>=2.12.5
 Requires-Dist: pytest>=8.4.2

ocean_runner-0.2.23.dist-info/RECORD

@@ -0,0 +1,8 @@
+ocean_runner/__init__.py,sha256=hRyMrE7K0DEbNRa-iNwA2xFOM85JJvjeKIdiWvcOm4Y,154
+ocean_runner/config.py,sha256=_P8MbKGzL36p8LO_m6nj3cPB0h6L2YL8satxUNXXnUI,1927
+ocean_runner/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+ocean_runner/runner.py,sha256=0-McElMM_dzubLUbRdeDaE0WY_dNj0IN_5cGen4-4bM,6242
+ocean_runner-0.2.23.dist-info/METADATA,sha256=HkaOEgMvm98GQT9VsGMSN6FwTNzzMnocGpZyKu4HgSs,6667
+ocean_runner-0.2.23.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+ocean_runner-0.2.23.dist-info/licenses/LICENSE,sha256=_B25KqK4amoADWkMN150tnZFm_Fy7VvZpvIC8ZydWdI,1053
+ocean_runner-0.2.23.dist-info/RECORD,,

ocean_runner-0.2.19.dist-info/RECORD

@@ -1,7 +0,0 @@
-ocean_runner/__init__.py,sha256=hRyMrE7K0DEbNRa-iNwA2xFOM85JJvjeKIdiWvcOm4Y,154
-ocean_runner/config.py,sha256=paN2I3ISIxRO1isCIuUgNsL9dsRhEc_n6KjTH6yNZU4,1919
-ocean_runner/runner.py,sha256=VaayC8UXn2Iyl1RuUcTap9vyTyDYkvm16p3ucaRAOhQ,5527
-ocean_runner-0.2.19.dist-info/METADATA,sha256=4n10dG0cfNAPraB9qJ4WcINyzJNFAxwDQtfZufbs0sU,6635
-ocean_runner-0.2.19.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-ocean_runner-0.2.19.dist-info/licenses/LICENSE,sha256=_B25KqK4amoADWkMN150tnZFm_Fy7VvZpvIC8ZydWdI,1053
-ocean_runner-0.2.19.dist-info/RECORD,,