ddeutil-workflow 0.0.36__py3-none-any.whl → 0.0.38__py3-none-any.whl

ddeutil/workflow/logs.py

@@ -234,7 +234,7 @@ class FileTraceLog(BaseTraceLog):  # pragma: no cov
         return f"({self.cut_id}) {message}"
 
     def writer(self, message: str, is_err: bool = False) -> None:
-        """ "Write a trace message after making to target file and write metadata
+        """Write a trace message after making to target file and write metadata
         in the same path of standard files.
 
             The path of logging data will store by format:
@@ -279,6 +279,11 @@ class FileTraceLog(BaseTraceLog):  # pragma: no cov
                 + "\n"
             )
 
+    async def awriter(
+        self, message: str, is_err: bool = False
+    ):  # pragma: no cov
+        """TODO: Use `aiofiles` for make writer method support async."""
+
 
 class SQLiteTraceLog(BaseTraceLog):  # pragma: no cov
     """Trace Log object that write trace log to the SQLite database file."""

ddeutil/workflow/result.py

@@ -91,7 +91,7 @@ class Result:
     @model_validator(mode="after")
     def __prepare_trace(self) -> Self:
         """Prepare trace field that want to pass after its initialize step."""
-        if self.trace is None:  # pragma: no cove
+        if self.trace is None:  # pragma: no cov
             self.trace: TraceLog = get_trace(self.run_id, self.parent_run_id)
 
         return self

ddeutil/workflow/scheduler.py

@@ -83,6 +83,11 @@ class ScheduleWorkflow(BaseModel):
     the Schedule model. it should not use Workflow model directly because on the
     schedule config it can adjust crontab value that different from the Workflow
     model.
+
+        This on field does not equal to the on field of Workflow model, but it
+    uses same logic to generate running release date with crontab object. It use
+    for override the on field if the schedule time was change but you do not
+    want to change on the workflow model.
     """
 
     alias: Optional[str] = Field(
@@ -97,7 +102,7 @@ class ScheduleWorkflow(BaseModel):
     values: DictData = Field(
         default_factory=dict,
         description=(
-            "A value that want to pass to the workflow parameters when "
+            "A value that want to pass to the workflow params field when auto "
             "calling release method."
         ),
         alias="params",
@@ -222,8 +227,8 @@ class ScheduleWorkflow(BaseModel):
 class Schedule(BaseModel):
     """Schedule Pydantic model that use to run with any scheduler package.
 
-        It does not equal the on value in Workflow model, but it uses same logic
-    to running release date with crontab interval.
+        The workflows field of this model include ScheduleWorkflow objects that
+    enhance the workflow object by adding the alias and values fields.
     """
 
     desc: Optional[str] = Field(
@@ -477,7 +482,9 @@ def schedule_task(
         current_release: datetime = current_date.replace(
             second=0, microsecond=0
         )
-        if (first_date := q.first_queue.date) > current_release:
+        if (
+            first_date := q.first_queue.date
+        ) > current_release:  # pragma: no cov
             result.trace.debug(
                 f"[WORKFLOW]: Skip schedule "
                 f"{first_date:%Y-%m-%d %H:%M:%S} for : {task.alias!r}"