ddeutil-workflow 0.0.68__py3-none-any.whl → 0.0.70__py3-none-any.whl

ddeutil/workflow/conf.py

@@ -7,12 +7,11 @@ from __future__ import annotations
 
 import copy
 import os
-from abc import ABC, abstractmethod
 from collections.abc import Iterator
 from functools import cached_property
 from inspect import isclass
 from pathlib import Path
-from typing import Final, Optional, Protocol, TypeVar, Union
+from typing import Final, Optional, TypeVar, Union
 from zoneinfo import ZoneInfo
 
 from ddeutil.core import str2bool
@@ -145,18 +144,6 @@ class Config:  # pragma: no cov
     def stage_default_id(self) -> bool:
         return str2bool(env("CORE_STAGE_DEFAULT_ID", "false"))
 
-    @property
-    def max_cron_per_workflow(self) -> int:
-        """The maximum on value that store in workflow model.
-
-        :rtype: int
-        """
-        return int(env("CORE_MAX_CRON_PER_WORKFLOW", "5"))
-
-    @property
-    def max_queue_complete_hist(self) -> int:
-        return int(env("CORE_MAX_QUEUE_COMPLETE_HIST", "16"))
-
 
 class APIConfig:
     """API Config object."""
@@ -170,23 +157,7 @@ class APIConfig:
         return env("API_PREFIX_PATH", f"/api/v{self.version}")
 
 
-class BaseLoad(ABC):  # pragma: no cov
-    """Base Load object is the abstraction object for any Load object that
-    should to inherit from this base class.
-    """
-
-    @classmethod
-    @abstractmethod
-    def find(cls, name: str, *args, **kwargs) -> DictData: ...
-
-    @classmethod
-    @abstractmethod
-    def finds(
-        cls, obj: object, *args, **kwargs
-    ) -> Iterator[tuple[str, DictData]]: ...
-
-
-class FileLoad(BaseLoad):
+class YamlParser:
     """Base Load object that use to search config data by given some identity
     value like name of `Workflow` or `Crontab` templates.
 
@@ -356,13 +327,13 @@ class FileLoad(BaseLoad):
         *,
         ignore_filename: Optional[str] = None,
     ) -> bool:
-        """Check this file was ignored.
+        """Check this file was ignored from the `.confignore` format.
 
         :param file: (Path) A file path that want to check.
         :param path: (Path) A config path that want to read the config
             ignore file.
         :param ignore_filename: (str) An ignore filename. Default is
-            `.confignore` filename.
+            ``.confignore`` filename.
 
         :rtype: bool
         """
@@ -428,24 +399,6 @@ def dynamic(
     return extra
 
 
-class Loader(Protocol):  # pragma: no cov
-    type: str
-    path: Path
-    data: DictData
-    extras: DictData
-    externals: DictData
-
-    def __init__(self, *args, **kwargs) -> None: ...
-
-    @classmethod
-    def find(cls, name: str, *args, **kwargs) -> DictData: ...
-
-    @classmethod
-    def finds(
-        cls, obj: object, *args, **kwargs
-    ) -> Iterator[tuple[str, DictData]]: ...
-
-
 def pass_env(value: T) -> T:  # pragma: no cov
     """Passing environment variable to an input value.
 

ddeutil/workflow/errors.py

@@ -38,8 +38,14 @@ def to_dict(exception: Exception, **kwargs) -> ErrorData:  # pragma: no cov
 
 
 class BaseError(Exception):
-    """Base Workflow exception class will implement the `refs` argument for
+    """Base Workflow exception class will implement the ``refs`` argument for
     making an error context to the result context.
+
+    Attributes:
+        refs: (:obj:str, optional)
+        context: (:obj:DictData)
+        params: (:obj:DictData)
+
     """
 
     def __init__(

ddeutil/workflow/event.py

@@ -23,7 +23,7 @@ from typing_extensions import Self
 
 from .__cron import WEEKDAYS, CronJob, CronJobYear, CronRunner, Options
 from .__types import DictData, DictStr
-from .conf import FileLoad
+from .conf import YamlParser
 
 Interval = Literal["daily", "weekly", "monthly"]
 
@@ -139,7 +139,7 @@ class Crontab(BaseModel):
         :rtype: Self
         """
         extras: DictData = extras or {}
-        loader: FileLoad = FileLoad(name, extras=extras)
+        loader: YamlParser = YamlParser(name, extras=extras)
 
         # NOTE: Validate the config type match with current connection model
         if loader.type != cls.__name__:

ddeutil/workflow/job.py

@@ -402,13 +402,19 @@ class Job(BaseModel):
         """
         # VALIDATE: Validate stage id should not duplicate.
         rs: list[str] = []
+        rs_raise: list[str] = []
         for stage in value:
             name: str = stage.iden
             if name in rs:
-                raise ValueError(
-                    f"Stage name, {name!r}, should not be duplicate."
-                )
+                rs_raise.append(name)
+                continue
             rs.append(name)
+
+        if rs_raise:
+            raise ValueError(
+                f"Stage name, {', '.join(repr(s) for s in rs_raise)}, should "
+                f"not be duplicate."
+            )
         return value
 
     @model_validator(mode="after")

ddeutil/workflow/result.py

@@ -13,6 +13,7 @@ from dataclasses import field
 from datetime import datetime
 from enum import Enum
 from typing import Optional, Union
+from zoneinfo import ZoneInfo
 
 from pydantic import ConfigDict
 from pydantic.dataclasses import dataclass
@@ -30,12 +31,20 @@ from . import (
     WorkflowError,
 )
 from .__types import DictData
+from .audits import TraceModel, get_trace
 from .conf import dynamic
 from .errors import ResultError
-from .logs import TraceModel, get_dt_tznow, get_trace
 from .utils import default_gen_id, gen_id, get_dt_now
 
 
+def get_dt_tznow(tz: Optional[ZoneInfo] = None) -> datetime:  # pragma: no cov
+    """Return the current datetime object that passing the config timezone.
+
+    :rtype: datetime
+    """
+    return get_dt_now(tz=dynamic("tz", f=tz))
+
+
 class Status(str, Enum):
     """Status Int Enum object that use for tracking execution status to the
     Result dataclass object.

ddeutil/workflow/reusables.py

@@ -44,7 +44,7 @@ from .errors import UtilError
 T = TypeVar("T")
 P = ParamSpec("P")
 
-# NOTE: Adjust logging level of the `asyncio` to INFO level.
+# NOTE: Adjust logging level of the ``asyncio`` to INFO level.
 logging.getLogger("asyncio").setLevel(logging.INFO)