ddeutil-workflow 0.0.55__tar.gz → 0.0.57__tar.gz

{ddeutil_workflow-0.0.55 → ddeutil_workflow-0.0.57}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ddeutil-workflow
-Version: 0.0.55
+Version: 0.0.57
 Summary: Lightweight workflow orchestration
 Author-email: ddeutils <korawich.anu@gmail.com>
 License: MIT
@@ -22,8 +22,8 @@ Classifier: Programming Language :: Python :: 3.13
 Requires-Python: >=3.9.13
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: ddeutil[checksum]>=0.4.7
-Requires-Dist: ddeutil-io[toml,yaml]>=0.2.11
+Requires-Dist: ddeutil[checksum]>=0.4.8
+Requires-Dist: ddeutil-io[toml,yaml]>=0.2.12
 Requires-Dist: pydantic==2.11.1
 Requires-Dist: python-dotenv==1.1.0
 Requires-Dist: schedule<2.0.0,==1.2.2
@@ -250,42 +250,48 @@ from ddeutil.workflow import Workflow, Result
 
 workflow: Workflow = Workflow.from_conf('run-py-local')
 result: Result = workflow.execute(
-   params={"source-extract": "USD-THB", "asat-dt": "2024-01-01"}
+   params={"source-extract": "USD-THB", "run-date": "2024-01-01"}
 )
 ```
 
-So, this package provide the `Schedule` template for this action, and you can dynamic
-pass the parameters for changing align with that running time by the `release` prefix.
-
-```yaml
-schedule-run-local-wf:
-
-   # Validate model that use to parsing exists for template file
-   type: Schedule
-   workflows:
-
-      # Map existing workflow that want to deploy with scheduler application.
-      # It allows you to pass release parameter that dynamic change depend on the
-      # current context of this scheduler application releasing that time.
-      - name: run-py-local
-        params:
-          source-extract: "USD-THB"
-          asat-dt: "${{ release.logical_date }}"
-```
-
-The main method of the `Schedule` model that use to running is `pending`. If you
-do not pass the `stop` date on this method, it will use config with `WORKFLOW_APP_STOP_BOUNDARY_DELTA`
-key for generate this stop date.
-
-```python
-from ddeutil.workflow import Schedule
+> [!NOTE]
+> So, this package provide the `Schedule` template for this action, and you can
+> pass the parameters dynamically for changing align with that running time by
+> the `release` prefix.
+>
+> ```yaml
+> schedule-run-local-wf:
+>
+>    # Validate model that use to parsing exists for template file
+>    type: Schedule
+>    workflows:
+>
+>       # Map existing workflow that want to deploy with scheduler application.
+>       # It allows you to pass release parameter that dynamic change depend on the
+>       # current context of this scheduler application releasing that time.
+>       - name: run-py-local
+>         params:
+>           source-extract: "USD-THB"
+>           run-date: "${{ release.logical_date }}"
+> ```
+>
+> The main method of the `Schedule` model that use to running is `pending`. If you
+> do not pass the `stop` date on this method, it will use config with
+> `WORKFLOW_APP_STOP_BOUNDARY_DELTA` key for generate this stop date.
+>
+> ```python
+> from ddeutil.workflow import Schedule
+>
+> (
+>    Schedule
+>    .from_conf("schedule-run-local-wf")
+>    .pending(stop=None)
+> )
+> ```
 
-(
-   Schedule
-   .from_conf("schedule-run-local-wf")
-   .pending(stop=None)
-)
-```
+> [!WARNING]
+> The scheduler feature is the expensive feature of this project. You should
+> avoid to use it and find a scheduler tool instead.
 
 ## :cookie: Configuration
 

{ddeutil_workflow-0.0.55 → ddeutil_workflow-0.0.57}/README.md

@@ -205,42 +205,48 @@ from ddeutil.workflow import Workflow, Result
 
 workflow: Workflow = Workflow.from_conf('run-py-local')
 result: Result = workflow.execute(
-   params={"source-extract": "USD-THB", "asat-dt": "2024-01-01"}
+   params={"source-extract": "USD-THB", "run-date": "2024-01-01"}
 )
 ```
 
-So, this package provide the `Schedule` template for this action, and you can dynamic
-pass the parameters for changing align with that running time by the `release` prefix.
-
-```yaml
-schedule-run-local-wf:
-
-   # Validate model that use to parsing exists for template file
-   type: Schedule
-   workflows:
-
-      # Map existing workflow that want to deploy with scheduler application.
-      # It allows you to pass release parameter that dynamic change depend on the
-      # current context of this scheduler application releasing that time.
-      - name: run-py-local
-        params:
-          source-extract: "USD-THB"
-          asat-dt: "${{ release.logical_date }}"
-```
-
-The main method of the `Schedule` model that use to running is `pending`. If you
-do not pass the `stop` date on this method, it will use config with `WORKFLOW_APP_STOP_BOUNDARY_DELTA`
-key for generate this stop date.
-
-```python
-from ddeutil.workflow import Schedule
+> [!NOTE]
+> So, this package provide the `Schedule` template for this action, and you can
+> pass the parameters dynamically for changing align with that running time by
+> the `release` prefix.
+>
+> ```yaml
+> schedule-run-local-wf:
+>
+>    # Validate model that use to parsing exists for template file
+>    type: Schedule
+>    workflows:
+>
+>       # Map existing workflow that want to deploy with scheduler application.
+>       # It allows you to pass release parameter that dynamic change depend on the
+>       # current context of this scheduler application releasing that time.
+>       - name: run-py-local
+>         params:
+>           source-extract: "USD-THB"
+>           run-date: "${{ release.logical_date }}"
+> ```
+>
+> The main method of the `Schedule` model that use to running is `pending`. If you
+> do not pass the `stop` date on this method, it will use config with
+> `WORKFLOW_APP_STOP_BOUNDARY_DELTA` key for generate this stop date.
+>
+> ```python
+> from ddeutil.workflow import Schedule
+>
+> (
+>    Schedule
+>    .from_conf("schedule-run-local-wf")
+>    .pending(stop=None)
+> )
+> ```
 
-(
-   Schedule
-   .from_conf("schedule-run-local-wf")
-   .pending(stop=None)
-)
-```
+> [!WARNING]
+> The scheduler feature is the expensive feature of this project. You should
+> avoid to use it and find a scheduler tool instead.
 
 ## :cookie: Configuration
 

{ddeutil_workflow-0.0.55 → ddeutil_workflow-0.0.57}/pyproject.toml

@@ -25,8 +25,8 @@ classifiers = [
 ]
 requires-python = ">=3.9.13"
 dependencies = [
-    "ddeutil[checksum]>=0.4.7",
-    "ddeutil-io[yaml,toml]>=0.2.11",
+    "ddeutil[checksum]>=0.4.8",
+    "ddeutil-io[yaml,toml]>=0.2.12",
     "pydantic==2.11.1",
     "python-dotenv==1.1.0",
     "schedule==1.2.2,<2.0.0",
@@ -57,6 +57,9 @@ docker = [
 Homepage = "https://github.com/ddeutils/ddeutil-workflow/"
 "Source Code" = "https://github.com/ddeutils/ddeutil-workflow/"
 
+[project.scripts]
+workflow-cli = "ddeutil.workflow.__main__:app"
+
 [tool.setuptools.dynamic]
 version = {attr = "ddeutil.workflow.__about__.__version__"}
 
@@ -79,9 +82,10 @@ source = ["src.ddeutil.workflow"]
 omit = [
     "src/ddeutil/workflow/__about__.py",
     "src/ddeutil/workflow/__cron.py",
+    "src/ddeutil/workflow/__main__.py",
     "src/ddeutil/workflow/api/__init__.py",
-    "src/ddeutil/workflow/api/log.py",
-    "src/ddeutil/workflow/api/repeat.py",
+    "src/ddeutil/workflow/api/logs.py",
+    "src/ddeutil/workflow/api/utils.py",
     "src/ddeutil/workflow/api/routes/__init__.py",
     "src/ddeutil/workflow/api/routes/job.py",
     "src/ddeutil/workflow/api/routes/logs.py",

ddeutil_workflow-0.0.57/src/ddeutil/workflow/__about__.py

@@ -0,0 +1 @@
+__version__: str = "0.0.57"

{ddeutil_workflow-0.0.55 → ddeutil_workflow-0.0.57}/src/ddeutil/workflow/__cron.py

@@ -502,10 +502,10 @@ class CronPart:
             except IndexError:
                 next_value: int = -1
             if value != (next_value - 1):
-                # NOTE: ``next_value`` is not the subsequent number
+                # NOTE: `next_value` is not the subsequent number
                 if start_number is None:
                     # NOTE:
-                    #   The last number of the list ``self.values`` is not in a
+                    #   The last number of the list `self.values` is not in a
                     #   range.
                     multi_dim_values.append(value)
                 else:
@@ -703,11 +703,14 @@ class CronJob:
         *,
         tz: str | None = None,
     ) -> CronRunner:
-        """Returns the schedule datetime runner with this cronjob. It would run
-        ``next``, ``prev``, or ``reset`` to generate running date that you want.
+        """Returns CronRunner instance that be datetime runner with this
+        cronjob. It can use `next`, `prev`, or `reset` methods to generate
+        running date.
 
-        :param date: An initial date that want to mark as the start point.
-        :param tz: A string timezone that want to change on runner.
+        :param date: (datetime) An initial date that want to mark as the start
+            point. (Default is use the current datetime)
+        :param tz: (str) A string timezone that want to change on runner.
+            (Default is None)
 
         :rtype: CronRunner
         """
@@ -743,6 +746,10 @@ class CronJobYear(CronJob):
 class CronRunner:
     """Create an instance of Date Runner object for datetime generate with
     cron schedule object value.
+
+    :param cron: (CronJob | CronJobYear)
+    :param date: (datetime)
+    :param tz: (str)
     """
 
     shift_limit: ClassVar[int] = 25
@@ -761,11 +768,17 @@ class CronRunner:
         cron: CronJob | CronJobYear,
         date: datetime | None = None,
         *,
-        tz: str | None = None,
+        tz: str | ZoneInfo | None = None,
     ) -> None:
-        # NOTE: Prepare timezone if this value does not set, it will use UTC.
-        self.tz: ZoneInfo = ZoneInfo("UTC")
+        self.tz: ZoneInfo | None = None
         if tz:
+            if isinstance(tz, ZoneInfo):
+                self.tz = tz
+            elif not isinstance(tz, str):
+                raise TypeError(
+                    "Invalid type of `tz` parameter, it should be str or "
+                    "ZoneInfo instance."
+                )
             try:
                 self.tz = ZoneInfo(tz)
             except ZoneInfoNotFoundError as err:
@@ -777,9 +790,10 @@ class CronRunner:
                 raise ValueError(
                     "Input schedule start time is not a valid datetime object."
                 )
-            if tz is None:
-                self.tz = date.tzinfo
-            self.date: datetime = date.astimezone(self.tz)
+            if tz is not None:
+                self.date: datetime = date.astimezone(self.tz)
+            else:
+                self.date: datetime = date
         else:
             self.date: datetime = datetime.now(tz=self.tz)
 

{ddeutil_workflow-0.0.55 → ddeutil_workflow-0.0.57}/src/ddeutil/workflow/__init__.py

@@ -7,16 +7,18 @@ from .__cron import CronJob, CronRunner
 from .__types import DictData, DictStr, Matrix, Re, TupleStr
 from .conf import (
     Config,
-    Loader,
+    FileLoad,
     config,
     env,
 )
-from .cron import *
+from .event import *
 from .exceptions import *
 from .job import *
 from .logs import (
     Audit,
     AuditModel,
+    FileAudit,
+    FileTrace,
     Trace,
     TraceData,
     TraceMeta,

ddeutil_workflow-0.0.57/src/ddeutil/workflow/__main__.py

@@ -0,0 +1,30 @@
+import typer
+
+app = typer.Typer()
+
+
+@app.callback()
+def callback():
+    """
+    Awesome Portal Gun
+    """
+
+
+@app.command()
+def provision():
+    """
+    Shoot the portal gun
+    """
+    typer.echo("Shooting portal gun")
+
+
+@app.command()
+def job():
+    """
+    Load the portal gun
+    """
+    typer.echo("Loading portal gun")
+
+
+if __name__ == "__main__":
+    app()

{ddeutil_workflow-0.0.55 → ddeutil_workflow-0.0.57}/src/ddeutil/workflow/__types.py

@@ -20,6 +20,7 @@ from typing import Any, Optional, TypedDict, Union
 
 from typing_extensions import Self
 
+StrOrInt = Union[str, int]
 TupleStr = tuple[str, ...]
 DictData = dict[str, Any]
 DictStr = dict[str, str]