ddeutil-workflow 0.0.74__py3-none-any.whl → 0.0.75__py3-none-any.whl

ddeutil/workflow/__about__.py

@@ -1 +1 @@
-__version__: str = "0.0.74"
+__version__: str = "0.0.75"

ddeutil/workflow/__cron.py

@@ -793,10 +793,11 @@ class CronRunner:
                     "Invalid type of `tz` parameter, it should be str or "
                     "ZoneInfo instance."
                 )
-            try:
-                self.tz = ZoneInfo(tz)
-            except ZoneInfoNotFoundError as err:
-                raise ValueError(f"Invalid timezone: {tz}") from err
+            else:
+                try:
+                    self.tz = ZoneInfo(tz)
+                except ZoneInfoNotFoundError as err:
+                    raise ValueError(f"Invalid timezone: {tz}") from err
 
         # NOTE: Prepare date
         if date:
@@ -807,6 +808,7 @@ class CronRunner:
             if tz is not None:
                 self.date: datetime = date.astimezone(self.tz)
             else:
+                self.tz = date.tzinfo
                 self.date: datetime = date
         else:
             self.date: datetime = datetime.now(tz=self.tz)

ddeutil/workflow/conf.py

@@ -89,16 +89,6 @@ class Config:  # pragma: no cov
         """
         return Path(env("CORE_CONF_PATH", "./conf"))
 
-    @property
-    def tz(self) -> ZoneInfo:
-        """Timezone value that return with the `ZoneInfo` object and use for all
-        datetime object in this workflow engine.
-
-        Returns:
-            ZoneInfo: The timezone configuration for the workflow engine.
-        """
-        return ZoneInfo(env("CORE_TIMEZONE", "UTC"))
-
     @property
     def generate_id_simple_mode(self) -> bool:
         """Flag for generate running ID with simple mode. That does not use
@@ -143,6 +133,16 @@ class Config:  # pragma: no cov
         """
         return str2bool(env("LOG_DEBUG_MODE", "true"))
 
+    @property
+    def log_tz(self) -> ZoneInfo:
+        """Timezone value that return with the `ZoneInfo` object and use for all
+        datetime object in this workflow engine.
+
+        Returns:
+            ZoneInfo: The timezone configuration for the workflow engine.
+        """
+        return ZoneInfo(env("LOG_TIMEZONE", "UTC"))
+
     @property
     def log_format(self) -> str:
         return env(

ddeutil/workflow/params.py

@@ -52,7 +52,7 @@ from pydantic import BaseModel, Field
 
 from .__types import StrOrInt
 from .errors import ParamError
-from .utils import get_d_now, get_dt_now
+from .utils import UTC, get_d_now, get_dt_now
 
 T = TypeVar("T")
 
@@ -169,16 +169,18 @@ class DatetimeParam(DefaultParam):
             return self.default
 
         if isinstance(value, datetime):
-            return value
+            if value.tzinfo is None:
+                return value.replace(tzinfo=UTC)
+            return value.astimezone(UTC)
         elif isinstance(value, date):
-            return datetime(value.year, value.month, value.day)
+            return datetime(value.year, value.month, value.day, tzinfo=UTC)
         elif not isinstance(value, str):
             raise ParamError(
                 f"Value that want to convert to datetime does not support for "
                 f"type: {type(value)}"
             )
         try:
-            return datetime.fromisoformat(value)
+            return datetime.fromisoformat(value).replace(tzinfo=UTC)
         except ValueError:
             raise ParamError(
                 f"Invalid the ISO format string for datetime: {value!r}"

ddeutil/workflow/result.py

@@ -43,7 +43,7 @@ from . import (
 from .__types import DictData
 from .audits import Trace, get_trace
 from .errors import ResultError
-from .utils import default_gen_id, get_dt_ntz_now
+from .utils import default_gen_id, get_dt_now
 
 
 class Status(str, Enum):
@@ -190,7 +190,7 @@ class Result:
     info: DictData = field(default_factory=dict)
     run_id: Optional[str] = field(default_factory=default_gen_id)
     parent_run_id: Optional[str] = field(default=None, compare=False)
-    ts: datetime = field(default_factory=get_dt_ntz_now, compare=False)
+    ts: datetime = field(default_factory=get_dt_now, compare=False)
     trace: Optional[Trace] = field(default=None, compare=False, repr=False)
     extras: DictData = field(default_factory=dict, compare=False, repr=False)
 
@@ -266,7 +266,7 @@ class Result:
 
         :rtype: float
         """
-        return (get_dt_ntz_now() - self.ts).total_seconds()
+        return (get_dt_now() - self.ts).total_seconds()
 
 
 def catch(

ddeutil/workflow/traces.py

@@ -167,7 +167,9 @@ class TraceMeta(BaseModel):  # pragma: no cov
 
     mode: Literal["stdout", "stderr"] = Field(description="A meta mode.")
     level: str = Field(description="A log level.")
-    datetime: str = Field(description="A datetime in string format.")
+    datetime: str = Field(
+        description="A datetime string with the specific config format."
+    )
     process: int = Field(description="A process ID.")
     thread: int = Field(description="A thread ID.")
     message: str = Field(description="A message log.")
@@ -234,9 +236,9 @@ class TraceMeta(BaseModel):  # pragma: no cov
             mode=mode,
             level=level,
             datetime=(
-                get_dt_now(tz=dynamic("tz", extras=extras)).strftime(
-                    dynamic("log_datetime_format", extras=extras)
-                )
+                get_dt_now()
+                .astimezone(dynamic("log_tz", extras=extras))
+                .strftime(dynamic("log_datetime_format", extras=extras))
             ),
             process=os.getpid(),
             thread=get_ident(),

ddeutil/workflow/utils.py

@@ -109,45 +109,32 @@ def replace_sec(dt: datetime) -> datetime:
 
 
 def clear_tz(dt: datetime) -> datetime:
-    """Replace timezone info on an input datetime object to None."""
-    return dt.replace(tzinfo=None)
+    """Replace timezone info on an input datetime object to UTC."""
+    return dt.replace(tzinfo=UTC)
 
 
-def get_dt_now(tz: Optional[ZoneInfo] = None, offset: float = 0.0) -> datetime:
+def get_dt_now(offset: float = 0.0) -> datetime:
     """Return the current datetime object.
 
-    :param tz: A ZoneInfo object for replace timezone of return datetime object.
     :param offset: An offset second value.
 
     :rtype: datetime
     :return: The current datetime object that use an input timezone or UTC.
     """
-    return datetime.now(tz=tz) - timedelta(seconds=offset)
+    return datetime.now().replace(tzinfo=UTC) - timedelta(seconds=offset)
 
 
-def get_dt_ntz_now() -> datetime:  # pragma: no cov
-    """Get current datetime with no timezone.
-
-    Returns the current datetime object using the None timezone.
-
-    Returns:
-        datetime: Current datetime with no timezone
-    """
-    return get_dt_now(tz=None)
-
-
-def get_d_now(
-    tz: Optional[ZoneInfo] = None, offset: float = 0.0
-) -> date:  # pragma: no cov
+def get_d_now(offset: float = 0.0) -> date:  # pragma: no cov
     """Return the current date object.
 
-    :param tz: A ZoneInfo object for replace timezone of return date object.
     :param offset: An offset second value.
 
     :rtype: date
     :return: The current date object that use an input timezone or UTC.
     """
-    return (datetime.now(tz=tz) - timedelta(seconds=offset)).date()
+    return (
+        datetime.now().replace(tzinfo=UTC) - timedelta(seconds=offset)
+    ).date()
 
 
 def get_diff_sec(dt: datetime, offset: float = 0.0) -> int:
@@ -240,7 +227,7 @@ def gen_id(
     if not isinstance(value, str):
         value: str = str(value)
 
-    dt: datetime = datetime.now(tz=dynamic("tz", extras=extras))
+    dt: datetime = datetime.now(tz=UTC)
     if dynamic("generate_id_simple_mode", f=simple_mode, extras=extras):
         return (f"{dt:%Y%m%d%H%M%S%f}T" if unique else "") + hash_str(
             f"{(value if sensitive else value.lower())}", n=10

ddeutil/workflow/workflow.py

@@ -36,7 +36,6 @@ from queue import Queue
 from textwrap import dedent
 from threading import Event as ThreadEvent
 from typing import Any, Optional, Union
-from zoneinfo import ZoneInfo
 
 from pydantic import BaseModel, Field
 from pydantic.functional_validators import field_validator, model_validator
@@ -64,8 +63,9 @@ from .result import (
 from .reusables import has_template, param2template
 from .traces import Trace, get_trace
 from .utils import (
+    UTC,
     gen_id,
-    get_dt_ntz_now,
+    get_dt_now,
     replace_sec,
 )
 
@@ -153,14 +153,14 @@ class Workflow(BaseModel):
         description="A mapping of job ID and job model that already loaded.",
     )
     created_at: datetime = Field(
-        default_factory=get_dt_ntz_now,
+        default_factory=get_dt_now,
         description=(
             "A created datetime of this workflow template when loading from "
             "file."
         ),
     )
     updated_dt: datetime = Field(
-        default_factory=get_dt_ntz_now,
+        default_factory=get_dt_now,
         description=(
             "A updated datetime of this workflow template when loading from "
             "file."
@@ -369,12 +369,15 @@ class Workflow(BaseModel):
         Returns:
             datetime: The validated release datetime.
         """
-        release: datetime = replace_sec(dt.replace(tzinfo=None))
+        if dt.tzinfo is None:
+            dt = dt.replace(tzinfo=UTC)
+
+        release: datetime = replace_sec(dt.astimezone(UTC))
         if not self.on:
             return release
 
         for on in self.on.schedule:
-            if release == on.cronjob.schedule(release).next:
+            if release == on.cronjob.schedule(release, tz=UTC).next:
                 return release
         raise WorkflowError(
             "Release datetime does not support for this workflow"
@@ -385,8 +388,8 @@ class Workflow(BaseModel):
         release: datetime,
         params: DictData,
         *,
-        release_type: ReleaseType = NORMAL,
         run_id: Optional[str] = None,
+        release_type: ReleaseType = NORMAL,
         audit: type[Audit] = None,
         override_log_name: Optional[str] = None,
         timeout: int = 600,
@@ -420,25 +423,27 @@ class Workflow(BaseModel):
         :rtype: Result
         """
         name: str = override_log_name or self.name
+
+        # NOTE: Generate the parent running ID with not None value.
         if run_id:
             parent_run_id: str = run_id
             run_id: str = gen_id(name, unique=True)
         else:
             run_id: str = gen_id(name, unique=True)
             parent_run_id: str = run_id
+
         context: DictData = {}
         trace: Trace = get_trace(
             run_id, parent_run_id=parent_run_id, extras=self.extras
         )
         release: datetime = self.validate_release(dt=release)
         trace.info(f"[RELEASE]: Start {name!r} : {release:%Y-%m-%d %H:%M:%S}")
-        tz: ZoneInfo = dynamic("tz", extras=self.extras)
         values: DictData = param2template(
             params,
             params={
                 "release": {
                     "logical_date": release,
-                    "execute_date": datetime.now(tz=tz),
+                    "execute_date": get_dt_now(),
                     "run_id": run_id,
                 }
             },

{ddeutil_workflow-0.0.74.dist-info → ddeutil_workflow-0.0.75.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ddeutil-workflow
-Version: 0.0.74
+Version: 0.0.75
 Summary: Lightweight workflow orchestration with YAML template
 Author-email: ddeutils <korawich.anu@gmail.com>
 License: MIT
@@ -68,7 +68,7 @@ by a `.yaml` template.
 3. All parallel tasks inside workflow core engine use **Multi-Threading** pool
    (Python 3.13 unlock GIL 🐍🔓)
 4. Recommend to pass a **Secret Value** with environment variable in YAML template 🔐
-5. Any datatime value convert to **No Timezone**
+5. Any datatime value convert to **UTC Timezone** 🌐
 
 ---
 
@@ -288,10 +288,10 @@ it will use default value and do not raise any error to you.
 | **REGISTRY_CALLER**         |   CORE    | `.`                                                                                                                             | List of importable string for the call stage.                                          |
 | **REGISTRY_FILTER**         |   CORE    | `ddeutil.workflow.templates`                                                                                                    | List of importable string for the filter template.                                     |
 | **CONF_PATH**               |   CORE    | `./conf`                                                                                                                        | The config path that keep all template `.yaml` files.                                  |
-| **TIMEZONE**                |   CORE    | `Asia/Bangkok`                                                                                                                  | A Timezone string value that will pass to `ZoneInfo` object.                           |
 | **STAGE_DEFAULT_ID**        |   CORE    | `false`                                                                                                                         | A flag that enable default stage ID that use for catch an execution output.            |
 | **GENERATE_ID_SIMPLE_MODE** |   CORE    | `true`                                                                                                                          | A flog that enable generating ID with `md5` algorithm.                                 |
 | **DEBUG_MODE**              |    LOG    | `true`                                                                                                                          | A flag that enable logging with debug level mode.                                      |
+| **TIMEZONE**                |    LOG    | `Asia/Bangkok`                                                                                                                  | A Timezone string value that will pass to `ZoneInfo` object.                           |
 | **FORMAT**                  |    LOG    | `%(asctime)s.%(msecs)03d (%(name)-10s, %(process)-5d,%(thread)-5d) [%(levelname)-7s] %(message)-120s (%(filename)s:%(lineno)s)` | A trace message console format.                                                        |
 | **FORMAT_FILE**             |    LOG    | `{datetime} ({process:5d}, {thread:5d}) {message:120s} ({filename}:{lineno})`                                                   | A trace message format that use to write to target pointer.                            |
 | **DATETIME_FORMAT**         |    LOG    | `%Y-%m-%d %H:%M:%S`                                                                                                             | A datetime format of the trace log.                                                    |

{ddeutil_workflow-0.0.74.dist-info → ddeutil_workflow-0.0.75.dist-info}/RECORD

@@ -1,30 +1,30 @@
-ddeutil/workflow/__about__.py,sha256=ovscLwcOTC_clQ-KeqVwtDeutK0Mcfq20RBXHRUIFew,28
-ddeutil/workflow/__cron.py,sha256=9I_gAXgZu1agInPoDi9r1lH7LUWq7gnDOmUrLxXmkWE,28840
+ddeutil/workflow/__about__.py,sha256=iaM2-rdtvV7sEgUAaF8bPdKBNJ3_zhFdOi5A1NC-s3U,28
+ddeutil/workflow/__cron.py,sha256=0_40rdL3QEChMcikrLQfQPb67YfHmbYr_aPCp6NM7Cw,28912
 ddeutil/workflow/__init__.py,sha256=kjKFdRNOh19IiLdmSFPKesU8BqSijEWHRZ8_fKGXFUk,3276
 ddeutil/workflow/__main__.py,sha256=Qd-f8z2Q2vpiEP2x6PBFsJrpACWDVxFKQk820MhFmHo,59
 ddeutil/workflow/__types.py,sha256=tA2vsr6mzTSzbWB1sb62c5GgxODlfVRz6FvgLNJtQao,4788
 ddeutil/workflow/audits.py,sha256=PZ0dDBBANpXoLHlDrmlEoIXr0iYK9PCw4-9tPJX9UXE,12528
 ddeutil/workflow/cli.py,sha256=V42C3lmtzRUiIjgMjLlr7v600PX0A3Aqbp8ccUSgQew,5244
-ddeutil/workflow/conf.py,sha256=aXclEcxQKYYDb09O5EBQxmJmjPXNT73NMxeq238xO3s,16264
+ddeutil/workflow/conf.py,sha256=UCw6v2GFD3tA2LRbp7vLifXniey0P5Ef0U9eBPknrWk,16267
 ddeutil/workflow/errors.py,sha256=n10YjXptY4iiY57FFVq22aedlUojpMuB5cM7aQ0KNpo,5522
 ddeutil/workflow/event.py,sha256=siChcBhsu4ejzW1fK0tjHPXQVaSUCSxPYDgDrh6duwo,13676
 ddeutil/workflow/job.py,sha256=oCjxG1Zz2D9Yc2SuZth3k1geIQ-AJ3oLs_38g5NMXLE,43994
-ddeutil/workflow/params.py,sha256=5DMDp7ZJwa1pM-oATV4kEPDQsaL7Ol8NavR9FZk_uqg,13519
-ddeutil/workflow/result.py,sha256=XBRZtD6b_5kJCFKvyk0ECWG1IjKIHc1Ad1mFvzpoPpY,9147
+ddeutil/workflow/params.py,sha256=Cyz142OcvENIZrM7Efc2xuGPmmFBhROifP5ojoaCezg,13658
+ddeutil/workflow/result.py,sha256=LBzBdVlqXsG4vgHQadb_bfuxY32yQ-dlBf-HmnX-dBk,9135
 ddeutil/workflow/reusables.py,sha256=q_OA-oifCGIhW_5j6hTZXZk7FBOmDt0xVrtNnscJfNg,23294
 ddeutil/workflow/stages.py,sha256=2Rz9NGVOftIqiYaSgasHDS8MvgvLp3jtAjBHEwdtx7U,121837
-ddeutil/workflow/traces.py,sha256=nSHOF7DPolLjNEKCu1OwiFg1z2xLvQp_eu-mY5BZCOA,28288
-ddeutil/workflow/utils.py,sha256=NqekWLsU2YK2ejvYk83N-8mjSXjxmBxGN7gPXRKONko,11337
-ddeutil/workflow/workflow.py,sha256=lcW2sYRWaYpq2dKoeKS5sQSV5lF2sF6loeUU-AGJ5kE,41159
+ddeutil/workflow/traces.py,sha256=KFGeIFk1ocDWsaNkjXJk3LQHvq8dRfIf3hZsTuCpF1Y,28334
+ddeutil/workflow/utils.py,sha256=EXhIuWzOJHvlcoAdyvuDUomGtMTIB59HxOLpj2VJ1bI,10857
+ddeutil/workflow/workflow.py,sha256=izGz5teb0unlKtnpklvcdWFHK1af60IJVeSbUhMdPtA,41206
 ddeutil/workflow/api/__init__.py,sha256=5DzYL3ngceoRshh5HYCSVWChqNJSiP01E1bEd8XxPi0,4799
 ddeutil/workflow/api/log_conf.py,sha256=WfS3udDLSyrP-C80lWOvxxmhd_XWKvQPkwDqKblcH3E,1834
 ddeutil/workflow/api/routes/__init__.py,sha256=JRaJZB0D6mgR17MbZo8yLtdYDtD62AA8MdKlFqhG84M,420
 ddeutil/workflow/api/routes/job.py,sha256=-lbZ_hS9pEdSy6zeke5qrXEgdNxtQ2w9in7cHuM2Jzs,2536
 ddeutil/workflow/api/routes/logs.py,sha256=RiZ62eQVMWArPHE3lpan955U4DdLLkethlvSMlwF7Mg,5312
 ddeutil/workflow/api/routes/workflows.py,sha256=1Mqx4Hft4uJglgJI-Wcw-JzkhomFYZrtP0DnQDBkAFQ,4410
-ddeutil_workflow-0.0.74.dist-info/licenses/LICENSE,sha256=nGFZ1QEhhhWeMHf9n99_fdt4vQaXS29xWKxt-OcLywk,1085
-ddeutil_workflow-0.0.74.dist-info/METADATA,sha256=ZLpNyhuTVBCxVMLFegOvMfCLBkQXjrULcbaCwvY6F0I,15775
-ddeutil_workflow-0.0.74.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-ddeutil_workflow-0.0.74.dist-info/entry_points.txt,sha256=qDTpPSauL0ciO6T4iSVt8bJeYrVEkkoEEw_RlGx6Kgk,63
-ddeutil_workflow-0.0.74.dist-info/top_level.txt,sha256=m9M6XeSWDwt_yMsmH6gcOjHZVK5O0-vgtNBuncHjzW4,8
-ddeutil_workflow-0.0.74.dist-info/RECORD,,
+ddeutil_workflow-0.0.75.dist-info/licenses/LICENSE,sha256=nGFZ1QEhhhWeMHf9n99_fdt4vQaXS29xWKxt-OcLywk,1085
+ddeutil_workflow-0.0.75.dist-info/METADATA,sha256=sJGNuv_qmZziEljC1T-9tCCOAGT3ovafMkAdRg-BvPo,15781
+ddeutil_workflow-0.0.75.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ddeutil_workflow-0.0.75.dist-info/entry_points.txt,sha256=qDTpPSauL0ciO6T4iSVt8bJeYrVEkkoEEw_RlGx6Kgk,63
+ddeutil_workflow-0.0.75.dist-info/top_level.txt,sha256=m9M6XeSWDwt_yMsmH6gcOjHZVK5O0-vgtNBuncHjzW4,8
+ddeutil_workflow-0.0.75.dist-info/RECORD,,