dotflow 0.15.0.dev7__py3-none-any.whl → 0.16.0.dev2__py3-none-any.whl

dotflow/__init__.py

@@ -1,6 +1,6 @@
 """Dotflow __init__ module."""
 
-__version__ = "0.15.0.dev7"
+__version__ = "0.16.0.dev2"
 __description__ = "🎲 Dotflow turns an idea into flow!"
 
 from .core.action import Action as action

dotflow/abc/server.py

@@ -5,13 +5,7 @@ from typing import Any
 
 
 class Server(ABC):
-    """Server ABC provider for sending workflow and task
-    data to a remote API.
-
-    Implementations should handle HTTP communication with
-    a server like dotflow-api, sending execution data
-    (status, duration, errors, context) in real time.
-    """
+    """Server ABC provider for sending workflow/task data remotely."""
 
     @abstractmethod
     def create_workflow(self, workflow: Any) -> None:

dotflow/cli/commands/cloud.py

@@ -1,5 +1,7 @@
 """Command cloud module"""
 
+from __future__ import annotations
+
 import json
 import re
 from pathlib import Path

dotflow/cli/commands/deploy.py

@@ -1,5 +1,7 @@
 """Command deploy module."""
 
+from __future__ import annotations
+
 from rich import print  # type: ignore
 from rich.prompt import Prompt
 

dotflow/cli/commands/start.py

@@ -1,11 +1,14 @@
 """Command start module"""
 
+import os
 from os import system
 
 from dotflow import Config, DotFlow
 from dotflow.cli.command import Command
 from dotflow.core.types.execution import TypeExecution
 from dotflow.providers import (
+    ServerAPI,
+    ServerDefault,
     StorageDefault,
     StorageFile,
     StorageGCS,
@@ -29,8 +32,36 @@ class StartCommand(Command):
             system("/bin/bash")
 
     def _new_workflow(self):
+        config = self._build_config()
+        workflow_id = os.getenv("WORKFLOW_ID")
+
+        if config is None:
+            return DotFlow(workflow_id=workflow_id)
+        return DotFlow(config=config, workflow_id=workflow_id)
+
+    def _build_config(self):
+        storage = self._build_storage()
+        server = self._build_server()
+
+        if storage is None and server is None:
+            return None
+
+        return Config(
+            storage=storage or StorageDefault(),
+            server=server or ServerDefault(),
+        )
+
+    def _build_server(self):
+        base_url = os.getenv("SERVER_BASE_URL")
+        user_token = os.getenv("SERVER_USER_TOKEN")
+
+        if not base_url or not user_token:
+            return None
+        return ServerAPI(base_url=base_url, user_token=user_token)
+
+    def _build_storage(self):
         if not self.params.storage:
-            return DotFlow()
+            return None
 
         storage_classes = {
             "default": StorageDefault,
@@ -43,10 +74,5 @@ class StartCommand(Command):
         storage_with_path = {StorageDefault, StorageFile}
 
         if storage_cls in storage_with_path:
-            storage = storage_cls(path=self.params.path)
-        else:
-            storage = storage_cls()
-
-        config = Config(storage=storage)
-
-        return DotFlow(config=config)
+            return storage_cls(path=self.params.path)
+        return storage_cls()

dotflow/core/context.py

@@ -37,7 +37,7 @@ class Context(ContextInstance):
     Args:
         storage (Any): Attribute where any type of Python object can be stored.
 
-        task_id (int): Task ID.
+        task_id (str): Task ID (ULID).
 
         workflow_id (UUID): Workflow ID.
     """
@@ -45,7 +45,7 @@ class Context(ContextInstance):
     def __init__(
         self,
         storage: Any = None,
-        task_id: int = 0,
+        task_id: str = "",
         workflow_id: UUID = None,
     ) -> None:
         super().__init__(task_id, storage, task_id, workflow_id)
@@ -67,13 +67,13 @@ class Context(ContextInstance):
         return self._task_id
 
     @task_id.setter
-    def task_id(self, value: int):
+    def task_id(self, value: str):
         if value is None:
             self._task_id = None
             return
-        if not isinstance(value, int):
+        if not isinstance(value, str):
             raise TypeError(
-                f"task_id must be an int, got {type(value).__name__}: {value!r}"
+                f"task_id must be a str, got {type(value).__name__}: {value!r}"
             )
         self._task_id = value
 

dotflow/core/dotflow.py

@@ -48,12 +48,16 @@ class DotFlow:
         config: Config | None = None,
         workflow_id: str | None = None,
     ) -> None:
+        self._externally_provided_id = workflow_id is not None
         self.workflow_id = workflow_id or uuid4()
         self._config = config if config else Config()
-        self._config.server.create_workflow(workflow=self.workflow_id)
+
+        if not self._externally_provided_id:
+            self._config.server.create_workflow(workflow=self.workflow_id)
 
         self.task = TaskBuilder(
-            config=self._config, workflow_id=self.workflow_id
+            config=self._config,
+            workflow_id=self.workflow_id,
         )
 
         self.start = partial(

dotflow/core/engine.py

@@ -2,7 +2,12 @@
 
 import re
 from collections.abc import Callable
-from concurrent.futures import ThreadPoolExecutor
+from concurrent.futures import (
+    ThreadPoolExecutor,
+)
+from concurrent.futures import (
+    TimeoutError as FuturesTimeoutError,
+)
 from contextlib import contextmanager
 from datetime import datetime
 from inspect import getsourcelines
@@ -10,6 +15,8 @@ from time import sleep
 from types import FunctionType
 from uuid import UUID
 
+from ulid import ULID
+
 try:
     from types import NoneType
 except ImportError:
@@ -131,7 +138,7 @@ class TaskEngine:
                 self.task.current_context = result
                 return result
 
-            except TimeoutError:
+            except (TimeoutError, FuturesTimeoutError):
                 raise
 
             except Exception as error:
@@ -173,9 +180,9 @@ class TaskEngine:
         try:
             future = executor.submit(self._execute_single)
             return future.result(timeout=seconds)
-        except TimeoutError:
+        except (TimeoutError, FuturesTimeoutError):
             future.cancel()
-            raise
+            raise TimeoutError() from None
         finally:
             executor.shutdown(wait=False, cancel_futures=True)
 
@@ -248,7 +255,7 @@ class TaskEngine:
             callable_list=callable_list, class_instance=class_instance
         )
 
-        for index, new in enumerate(ordered_list):
+        for new in ordered_list:
             new_object = getattr(class_instance, new[1])
             try:
                 subcontext = new_object(
@@ -256,7 +263,7 @@ class TaskEngine:
                     previous_context=previous_context,
                     task=self.task,
                 )
-                subcontext.task_id = index
+                subcontext.task_id = str(ULID())
                 new_context.storage.append(subcontext)
                 previous_context = subcontext
 
@@ -270,7 +277,7 @@ class TaskEngine:
                     previous_context=previous_context,
                     task=self.task,
                 )
-                subcontext.task_id = index
+                subcontext.task_id = str(ULID())
                 new_context.storage.append(subcontext)
                 previous_context = subcontext
 

dotflow/core/serializers/task.py

@@ -28,7 +28,7 @@ class SerializerTaskError(BaseModel):
 class SerializerTask(BaseModel):
     model_config = ConfigDict(title="task")
 
-    task_id: int = Field(default=None)
+    task_id: str = Field(default=None)
     workflow_id: Optional[UUID] = Field(default=None)
     status: str = Field(default=None, alias="_status")
     duration: Optional[float] = Field(default=None, alias="_duration")
@@ -44,8 +44,9 @@ class SerializerTask(BaseModel):
         default_factory=list, alias="_errors"
     )
     max: Optional[int] = Field(default=None, exclude=True)
-    size_message: Optional[str] = Field(
-        default="Context size exceeded", exclude=True
+    size_message: dict = Field(
+        default={"message": "Context size exceeded"},
+        exclude=True,
     )
 
     @computed_field
@@ -58,17 +59,32 @@ class SerializerTask(BaseModel):
         data = self.model_dump(mode="json", serialize_as_any=True, **kwargs)
         dump_json = json.dumps(data)
 
-        if not self.max or len(dump_json) <= self.max:
+        if self.max is None or len(dump_json) <= self.max:
             return dump_json
 
-        data["initial_context"] = self.size_message
-        data["current_context"] = self.size_message
-        data["previous_context"] = self.size_message
+        context_fields = [
+            "current_context",
+            "previous_context",
+            "initial_context",
+        ]
+
+        for field in sorted(
+            context_fields,
+            key=lambda f: len(str(data.get(f, ""))),
+            reverse=True,
+        ):
+            data[field] = self.size_message
+            dump_json = json.dumps(data)
+            if len(dump_json) <= self.max:
+                return dump_json
+
+        data["errors"] = []
+        data["error"] = None
         dump_json = json.dumps(data)
 
-        if len(dump_json) > self.max:
-            data["errors"] = []
-            data["error"] = None
+        if self.max and len(dump_json) > self.max:
+            for field in context_fields:
+                data[field] = None
             dump_json = json.dumps(data)
 
         return dump_json

dotflow/core/task.py

@@ -6,6 +6,8 @@ from datetime import datetime
 from typing import Any
 from uuid import UUID
 
+from ulid import ULID
+
 from dotflow.core.action import Action
 from dotflow.core.config import Config
 from dotflow.core.context import Context
@@ -56,13 +58,13 @@ class Task(TaskInstance):
         `class` dotflow.core.task.Task
 
             task = Task(
-                task_id=1,
+                task_id="01ARZ3NDEKTSV4RRFFQ69G5FAV",
                 step=my_step,
                 callback=my_callback
             )
 
     Args:
-        task_id (int): Task ID.
+        task_id (str): Task ID (ULID).
 
         step (Callable):
             A argument that receives an object of the callable type,
@@ -85,7 +87,7 @@ class Task(TaskInstance):
 
     def __init__(
         self,
-        task_id: int,
+        task_id: str,
         step: Callable,
         callback: Callable = basic_callback,
         initial_context: Any = None,
@@ -304,11 +306,14 @@ class TaskBuilder:
         workflow_id (UUID): Workflow ID.
     """
 
-    def __init__(self, config: Config, workflow_id: UUID = None) -> None:
+    def __init__(
+        self,
+        config: Config,
+        workflow_id: UUID = None,
+    ) -> None:
         self.queue: list[Callable] = []
         self.workflow_id = workflow_id
         self.config = config
-        self._next_id = 1
 
     def add(
         self,
@@ -348,8 +353,7 @@ class TaskBuilder:
                 )
             return self
 
-        task_id = self._next_id
-        self._next_id += 1
+        task_id = str(ULID())
 
         self.queue.append(
             Task(

dotflow/providers/__init__.py

@@ -6,6 +6,7 @@ from dotflow.providers.notify_default import NotifyDefault
 from dotflow.providers.notify_discord import NotifyDiscord
 from dotflow.providers.notify_telegram import NotifyTelegram
 from dotflow.providers.scheduler_default import SchedulerDefault
+from dotflow.providers.server_api import ServerAPI
 from dotflow.providers.server_default import ServerDefault
 from dotflow.providers.storage_default import StorageDefault
 from dotflow.providers.storage_file import StorageFile
@@ -20,6 +21,7 @@ __all__ = [
     "NotifyTelegram",
     "SchedulerCron",
     "SchedulerDefault",
+    "ServerAPI",
     "ServerDefault",
     "StorageDefault",
     "StorageFile",

dotflow/providers/server_api.py

@@ -0,0 +1,88 @@
+"""ServerAPI — sends workflow/task events to a remote HTTP endpoint."""
+
+from __future__ import annotations
+
+import logging
+from typing import Any
+
+from requests import patch, post
+from requests.exceptions import RequestException
+
+from dotflow.abc.server import Server
+
+logger = logging.getLogger(__name__)
+
+
+class ServerAPI(Server):
+    """HTTP implementation of the Server ABC."""
+
+    def __init__(
+        self,
+        base_url: str,
+        user_token: str,
+        timeout: float = 15.0,
+    ):
+        self._base_url = base_url.rstrip("/")
+        self._user_token = user_token
+        self._timeout = timeout
+
+    @property
+    def _headers(self) -> dict:
+        return {
+            "Authorization": f"Bearer {self._user_token}",
+            "Content-Type": "application/json",
+        }
+
+    def _post(self, url: str, json: dict) -> None:
+        try:
+            response = post(
+                url,
+                json=json,
+                headers=self._headers,
+                timeout=self._timeout,
+            )
+            logger.info("POST %s [%s]", url, response.status_code)
+        except RequestException as error:
+            logger.error("POST %s failed: %s", url, error)
+
+    def _patch(self, url: str, json: dict) -> None:
+        try:
+            response = patch(
+                url,
+                json=json,
+                headers=self._headers,
+                timeout=self._timeout,
+            )
+            logger.info("PATCH %s [%s]", url, response.status_code)
+        except RequestException as error:
+            logger.error("PATCH %s failed: %s", url, error)
+
+    def create_workflow(self, workflow: Any) -> None:
+        self._post(
+            f"{self._base_url}/workflows",
+            json={"id": str(workflow)},
+        )
+
+    def update_workflow(self, workflow: Any, status: str = "") -> None:
+        self._patch(
+            f"{self._base_url}/workflows/{workflow}",
+            json={"status": status},
+        )
+
+    def create_task(self, task: Any) -> None:
+        data = task.result(max=5_000_000)
+        data["id"] = data.pop("task_id", task.task_id)
+        self._post(
+            f"{self._base_url}/workflows/{task.workflow_id}/tasks",
+            json=data,
+        )
+
+    def update_task(self, task: Any) -> None:
+        data = task.result(max=5_000_000)
+        self._patch(
+            (
+                f"{self._base_url}/workflows/{task.workflow_id}"
+                f"/tasks/{task.task_id}"
+            ),
+            json=data,
+        )

{dotflow-0.15.0.dev7.dist-info → dotflow-0.16.0.dev2.dist-info}/METADATA

@@ -1,28 +1,197 @@
 Metadata-Version: 2.4
 Name: dotflow
-Version: 0.15.0.dev7
+Version: 0.16.0.dev2
 Summary: 🎲 Dotflow turns an idea into flow! Lightweight Python library for execution pipelines with retry, parallel, cron and async support.
-License: MIT License
+License: Apache License
+                                    Version 2.0, January 2004
+                                 http://www.apache.org/licenses/
          
-         Copyright (c) 2025 Fernando Celmer
+            TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
          
-         Permission is hereby granted, free of charge, to any person obtaining a copy
-         of this software and associated documentation files (the "Software"), to deal
-         in the Software without restriction, including without limitation the rights
-         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-         copies of the Software, and to permit persons to whom the Software is
-         furnished to do so, subject to the following conditions:
+            1. Definitions.
          
-         The above copyright notice and this permission notice shall be included in all
-         copies or substantial portions of the Software.
+               "License" shall mean the terms and conditions for use, reproduction,
+               and distribution as defined by Sections 1 through 9 of this document.
          
-         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-         SOFTWARE.
+               "Licensor" shall mean the copyright owner or entity authorized by
+               the copyright owner that is granting the License.
+         
+               "Legal Entity" shall mean the union of the acting entity and all
+               other entities that control, are controlled by, or are under common
+               control with that entity. For the purposes of this definition,
+               "control" means (i) the power, direct or indirect, to cause the
+               direction or management of such entity, whether by contract or
+               otherwise, or (ii) ownership of fifty percent (50%) or more of the
+               outstanding shares, or (iii) beneficial ownership of such entity.
+         
+               "You" (or "Your") shall mean an individual or Legal Entity
+               exercising permissions granted by this License.
+         
+               "Source" form shall mean the preferred form for making modifications,
+               including but not limited to software source code, documentation
+               source, and configuration files.
+         
+               "Object" form shall mean any form resulting from mechanical
+               transformation or translation of a Source form, including but
+               not limited to compiled object code, generated documentation,
+               and conversions to other media types.
+         
+               "Work" shall mean the work of authorship, whether in Source or
+               Object form, made available under the License, as indicated by a
+               copyright notice that is included in or attached to the work
+               (an example is provided in the Appendix below).
+         
+               "Derivative Works" shall mean any work, whether in Source or Object
+               form, that is based on (or derived from) the Work and for which the
+               editorial revisions, annotations, elaborations, or other modifications
+               represent, as a whole, an original work of authorship. For the purposes
+               of this License, Derivative Works shall not include works that remain
+               separable from, or merely link (or bind by name) to the interfaces of,
+               the Work and Derivative Works thereof.
+         
+               "Contribution" shall mean any work of authorship, including
+               the original version of the Work and any modifications or additions
+               to that Work or Derivative Works thereof, that is intentionally
+               submitted to the Licensor for inclusion in the Work by the copyright owner
+               or by an individual or Legal Entity authorized to submit on behalf of
+               the copyright owner. For the purposes of this definition, "submitted"
+               means any form of electronic, verbal, or written communication sent
+               to the Licensor or its representatives, including but not limited to
+               communication on electronic mailing lists, source code control systems,
+               and issue tracking systems that are managed by, or on behalf of, the
+               Licensor for the purpose of discussing and improving the Work, but
+               excluding communication that is conspicuously marked or otherwise
+               designated in writing by the copyright owner as "Not a Contribution."
+         
+               "Contributor" shall mean Licensor and any individual or Legal Entity
+               on behalf of whom a Contribution has been received by the Licensor and
+               subsequently incorporated within the Work.
+         
+            2. Grant of Copyright License. Subject to the terms and conditions of
+               this License, each Contributor hereby grants to You a perpetual,
+               worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+               copyright license to reproduce, prepare Derivative Works of,
+               publicly display, publicly perform, sublicense, and distribute the
+               Work and such Derivative Works in Source or Object form.
+         
+            3. Grant of Patent License. Subject to the terms and conditions of
+               this License, each Contributor hereby grants to You a perpetual,
+               worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+               (except as stated in this section) patent license to make, have made,
+               use, offer to sell, sell, import, and otherwise transfer the Work,
+               where such license applies only to those patent claims licensable
+               by such Contributor that are necessarily infringed by their
+               Contribution(s) alone or by combination of their Contribution(s)
+               with the Work to which such Contribution(s) was submitted. If You
+               institute patent litigation against any entity (including a
+               cross-claim or counterclaim in a lawsuit) alleging that the Work
+               or a Contribution incorporated within the Work constitutes direct
+               or contributory patent infringement, then any patent licenses
+               granted to You under this License for that Work shall terminate
+               as of the date such litigation is filed.
+         
+            4. Redistribution. You may reproduce and distribute copies of the
+               Work or Derivative Works thereof in any medium, with or without
+               modifications, and in Source or Object form, provided that You
+               meet the following conditions:
+         
+               (a) You must give any other recipients of the Work or
+                   Derivative Works a copy of this License; and
+         
+               (b) You must cause any modified files to carry prominent notices
+                   stating that You changed the files; and
+         
+               (c) You must retain, in the Source form of any Derivative Works
+                   that You distribute, all copyright, patent, trademark, and
+                   attribution notices from the Source form of the Work,
+                   excluding those notices that do not pertain to any part of
+                   the Derivative Works; and
+         
+               (d) If the Work includes a "NOTICE" text file as part of its
+                   distribution, then any Derivative Works that You distribute must
+                   include a readable copy of the attribution notices contained
+                   within such NOTICE file, excluding any notices that do not
+                   pertain to any part of the Derivative Works, in at least one
+                   of the following places: within a NOTICE text file distributed
+                   as part of the Derivative Works; within the Source form or
+                   documentation, if provided along with the Derivative Works; or,
+                   within a display generated by the Derivative Works, if and
+                   wherever such third-party notices normally appear. The contents
+                   of the NOTICE file are for informational purposes only and
+                   do not modify the License. You may add Your own attribution
+                   notices within Derivative Works that You distribute, alongside
+                   or as an addendum to the NOTICE text from the Work, provided
+                   that such additional attribution notices cannot be construed
+                   as modifying the License.
+         
+               You may add Your own copyright statement to Your modifications and
+               may provide additional or different license terms and conditions
+               for use, reproduction, or distribution of Your modifications, or
+               for any such Derivative Works as a whole, provided Your use,
+               reproduction, and distribution of the Work otherwise complies with
+               the conditions stated in this License.
+         
+            5. Submission of Contributions. Unless You explicitly state otherwise,
+               any Contribution intentionally submitted for inclusion in the Work
+               by You to the Licensor shall be under the terms and conditions of
+               this License, without any additional terms or conditions.
+               Notwithstanding the above, nothing herein shall supersede or modify
+               the terms of any separate license agreement you may have executed
+               with Licensor regarding such Contributions.
+         
+            6. Trademarks. This License does not grant permission to use the trade
+               names, trademarks, service marks, or product names of the Licensor,
+               except as required for reasonable and customary use in describing the
+               origin of the Work and reproducing the content of the NOTICE file.
+         
+            7. Disclaimer of Warranty. Unless required by applicable law or
+               agreed to in writing, Licensor provides the Work (and each
+               Contributor provides its Contributions) on an "AS IS" BASIS,
+               WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+               implied, including, without limitation, any warranties or conditions
+               of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+               PARTICULAR PURPOSE. You are solely responsible for determining the
+               appropriateness of using or redistributing the Work and assume any
+               risks associated with Your exercise of permissions under this License.
+         
+            8. Limitation of Liability. In no event and under no legal theory,
+               whether in tort (including negligence), contract, or otherwise,
+               unless required by applicable law (such as deliberate and grossly
+               negligent acts) or agreed to in writing, shall any Contributor be
+               liable to You for damages, including any direct, indirect, special,
+               incidental, or consequential damages of any character arising as a
+               result of this License or out of the use or inability to use the
+               Work (including but not limited to damages for loss of goodwill,
+               work stoppage, computer failure or malfunction, or any and all
+               other commercial damages or losses), even if such Contributor
+               has been advised of the possibility of such damages.
+         
+            9. Accepting Warranty or Additional Liability. While redistributing
+               the Work or Derivative Works thereof, You may choose to offer,
+               and charge a fee for, acceptance of support, warranty, indemnity,
+               or other liability obligations and/or rights consistent with this
+               License. However, in accepting such obligations, You may act only
+               on Your own behalf and on Your sole responsibility, not on behalf
+               of any other Contributor, and only if You agree to indemnify,
+               defend, and hold each Contributor harmless for any liability
+               incurred by, or claims asserted against, such Contributor by reason
+               of your accepting any such warranty or additional liability.
+         
+            END OF TERMS AND CONDITIONS
+         
+            Copyright 2025 Fernando Celmer
+         
+            Licensed under the Apache License, Version 2.0 (the "License");
+            you may not use this file except in compliance with the License.
+            You may obtain a copy of the License at
+         
+                http://www.apache.org/licenses/LICENSE-2.0
+         
+            Unless required by applicable law or agreed to in writing, software
+            distributed under the License is distributed on an "AS IS" BASIS,
+            WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+            See the License for the specific language governing permissions and
+            limitations under the License.
 License-File: LICENSE
 Keywords: pipeline,workflow,etl,task-runner,orchestration,automation,parallel,async,retry,data-pipeline,scheduler,cron,cron-job
 Author: Fernando Celmer
@@ -32,7 +201,7 @@ Classifier: Development Status :: 4 - Beta
 Classifier: Operating System :: OS Independent
 Classifier: Intended Audience :: Developers
 Classifier: Natural Language :: English
-Classifier: License :: OSI Approved :: MIT License
+Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Topic :: System :: Distributed Computing
@@ -68,6 +237,7 @@ Requires-Dist: google-cloud-storage ; extra == "gcp"
 Requires-Dist: opentelemetry-api ; extra == "otel"
 Requires-Dist: opentelemetry-sdk ; extra == "otel"
 Requires-Dist: pydantic
+Requires-Dist: python-ulid (>=3.0)
 Requires-Dist: requests
 Requires-Dist: rich
 Requires-Dist: sentry-sdk ; extra == "sentry"
@@ -881,5 +1051,5 @@ All examples are available in the [`docs_src/`](https://github.com/dotflow-io/do
 
 ![GitHub License](https://img.shields.io/github/license/dotflow-io/dotflow)
 
-This project is licensed under the terms of the MIT License.
+This project is licensed under the terms of the Apache License 2.0.
 

{dotflow-0.15.0.dev7.dist-info → dotflow-0.16.0.dev2.dist-info}/RECORD

@@ -1,4 +1,4 @@
-dotflow/__init__.py,sha256=wEiccUsT-CWQ6swjbzERxo1k7n53cY9A4MsYXo0S5oM,351
+dotflow/__init__.py,sha256=ZTvhDm0gGdFeA5QstasHnD-4keZBIdwnwvFNYUzDk7c,351
 dotflow/abc/__init__.py,sha256=UIk84jCJYoHAk4In_eVXAaFAnNE63lI3dVP5qunyBJs,32
 dotflow/abc/file.py,sha256=QEDIS-AXaW3GK5q5ckhNdoC5A3p8oOFE7VyNGSvx540,296
 dotflow/abc/flow.py,sha256=j6m9u13UXgBCIhgrUwzvBBYHTDul_DfERD4DWA1BQBw,1436
@@ -7,19 +7,19 @@ dotflow/abc/log.py,sha256=hrj0ONj5cccFKRzoX_Qlegure39gNbz4WgYs_EN2CkQ,3421
 dotflow/abc/metrics.py,sha256=vCsdVOYANj25UCPqPc3RjTL7gHTTjPLsAGfL5k603bk,897
 dotflow/abc/notify.py,sha256=oyOdHKIBdZlwrxiKUBtAjczMzG6qpZ_HC_URNw6Bt2Q,241
 dotflow/abc/scheduler.py,sha256=w3I1kSEbwFiZWJAD82-6UaFbADUGho2fKnBaLiI8hKM,391
-dotflow/abc/server.py,sha256=kXJygIWTBS9FedN1TrR58tUsGdyhzzsFvY_b0XJOFcc,922
+dotflow/abc/server.py,sha256=R0uRjQrSC9Re9AhlM3KKXmbttZYALmwoXgOUl8HYSZI,735
 dotflow/abc/storage.py,sha256=1Xw3zNoSw6KuJ1NX4ampNqTsruBCs9gJD7-ATUsBZzM,562
 dotflow/abc/tcp.py,sha256=v4VzXugCpvtCP8jmHjjBv1sFko7je6c_uh0TCJ4dOXU,577
 dotflow/abc/tracer.py,sha256=S0fKzVydW6m39Wmam6MHcMKXTtzI01WctDjvwEIS0SE,633
 dotflow/cli/__init__.py,sha256=1NhA5RRAaAfhj3LdBgtC2eZ7WPZlmN0f-Kz-biUkUXE,27
 dotflow/cli/command.py,sha256=PRvZSB3VcXROsOHWasBANq3Q6-3qLY7LqJ9ecOY0C0g,236
 dotflow/cli/commands/__init__.py,sha256=5Y7l1GLjID3oMg_0vCSY56Vzhr6nkj0pw94KqEQ1vmw,541
-dotflow/cli/commands/cloud.py,sha256=ICpYd7UiSMV9mPrqLGW0QX7zuRnVpQCDvM60s1_ZJj8,5757
-dotflow/cli/commands/deploy.py,sha256=AXUvrOFBlT6___BY6I4reK_Jz7BdkYAJisdCcFGjZtU,5813
+dotflow/cli/commands/cloud.py,sha256=Y4zDw6u6op3AY7z9yMG7sCF34qT6Gj3B_RXXuHtYoFg,5793
+dotflow/cli/commands/deploy.py,sha256=qUeZx-C00OfOEMURNZ4LMRI4qYOwwDS_ajOGtLa_WbU,5849
 dotflow/cli/commands/init.py,sha256=VySDg1gNx_8jH0vfhc15BhBJR3Yckw91v26ijyGz5Pw,387
 dotflow/cli/commands/log.py,sha256=AJmDQM1ulbQg7_wZRsx3xac_7_6WlP8eA4pBWhpNBTo,590
 dotflow/cli/commands/schedule.py,sha256=C9wvgSowV4xgQqrx6pjNZk5-709uNDfsA7xGBjjbZYA,1442
-dotflow/cli/commands/start.py,sha256=yF5ZI5ioscyBoGTY-70RYkKdWicFZMJAcT0OeK-iA0M,1308
+dotflow/cli/commands/start.py,sha256=kvnJIme_NJdK80GUXKZhxteEqpQS9V_WB-v_eFyR3q0,2075
 dotflow/cli/commands/storage.py,sha256=b3CMBSFGEqYxaI9gwiO90MIirnW82CcM3GUf4XJGVYs,1549
 dotflow/cli/setup.py,sha256=baCsFM8jHoWYsQtYnq0t8NkLg8ScvV_ihmSEofuPfHo,7708
 dotflow/cli/validators/__init__.py,sha256=JKD-C4igDghgLjU2eBbpHkThUapoJ2mJRtC_YkeEvHg,121
@@ -64,18 +64,18 @@ dotflow/cloud/github/deployers/actions.py,sha256=0P752J6R0aMuhCI8cKQnoJjff61iewY
 dotflow/core/__init__.py,sha256=baoenc4kd9OQjCrnmOKRm9JRinEjd5xb7luCeyQ-npY,28
 dotflow/core/action.py,sha256=TpNHX0euI1cRHwzUCElgE_JqiBUx5BFKC3Tid1AnDys,5715
 dotflow/core/config.py,sha256=GBJKGrYejrkBr5GJAk2JvVAF1QRow1hBUAUy3FJ1Opk,3252
-dotflow/core/context.py,sha256=Rw3jNO3aauZj_8xvu1LkGRz2A5M7HElbeb-0WDonGOg,2886
+dotflow/core/context.py,sha256=X72lG-ISBHIhS03X_FalG0THdgcLpiWrJEsyH2u-g3Q,2893
 dotflow/core/decorators/__init__.py,sha256=xPQMuZWV8TnIAH8uTF-Be9NoG46K7OmfJx_7GSWO_bc,101
 dotflow/core/decorators/time.py,sha256=46mI6Q8EZYkxU5DRnPJ5B8KgDBdR1bKivEm0u4pqwAg,300
-dotflow/core/dotflow.py,sha256=qNbGlGMKCgMcqvWE9Ku-1iKFZpBvCUPL3gc2jVLlmHE,2483
-dotflow/core/engine.py,sha256=kqDW-fsh4H_TRfeupCHfgRzBY4_JJcSiMx7shzXF-ug,9045
+dotflow/core/dotflow.py,sha256=1dj854Q9GwIyznkU6P5nmNInPCFA7F_lcHswKScEj-E,2609
+dotflow/core/engine.py,sha256=4J8ZmM8vymhc0q6m1e65PPM4t23eDEGXLFgnQDHhxv4,9218
 dotflow/core/exception.py,sha256=wxNLcDE3n2HjRsSioNo86Fd9V4K7oZZDL-FD0mcZxDg,2242
 dotflow/core/module.py,sha256=5-19cKMa-BW3TVD1XVxiB_mPLTaeTIHfvVAvkkK3lmU,760
 dotflow/core/serializers/__init__.py,sha256=2b2vyCuXmvS8N_K-ePuCrWC9yvMqLPBMeORjAWS5U70,35
-dotflow/core/serializers/task.py,sha256=DlKatju4tmhmv6O7U2vejaBiIVyCczwI2Klr1C82Iuw,4286
+dotflow/core/serializers/task.py,sha256=zpiXyQGzKsdA3dGUysFFlNdmGBsyqk-w0C5Uj4ubex0,4668
 dotflow/core/serializers/transport.py,sha256=gRlMTmyJrZrOS6fq7MUVtBqoerQrs2TJJyozGn6OfDk,489
 dotflow/core/serializers/workflow.py,sha256=ZoytQHb1wWa4kxyqfuwx_QwVdwJf6ocjUEszfnaB3w0,349
-dotflow/core/task.py,sha256=mVqfiBXS1eclK7hSJnUvvtNp7qEYuCBdLpcVxAgWSX0,10825
+dotflow/core/task.py,sha256=CzBEhecGsTLzuCEWnaJUaylgJKP2M8byyvYI-nPbzIA,10858
 dotflow/core/types/__init__.py,sha256=8PX9QQrZ08beDSoSZb4SJDI257CY5hbfY9lctO3OaT4,405
 dotflow/core/types/execution.py,sha256=GxgdznWYOI8nGIrgSaJ5E9XvJtX8UnARgjJIGYz-lEM,487
 dotflow/core/types/overlap.py,sha256=suC2sX62y9j9CksNq09RVoziiSA205FzjcmhaQGxWL8,805
@@ -85,7 +85,7 @@ dotflow/core/types/workflow.py,sha256=Obc3SpXCFW-ZDxPAirdYVK7W21G_j8WYY6e0nwYIk6
 dotflow/core/workflow.py,sha256=d16JEi33I8kw9cju5Tt7v7-GIfu2HKNkhTFfY-c9tMI,14813
 dotflow/logging.py,sha256=xjzHyAHIMLCtt1Kto_gZaFCzr_fyc51z1C9je2sm3ds,292
 dotflow/main.py,sha256=ZxGTH_gX6CnKO9wb1vfjHpLQwaD5dLIBWM82K_puZEI,252
-dotflow/providers/__init__.py,sha256=aQigvJuf1vq5X-5-nWp3ET6uDp-Ek0l34nflGcZbjX8,2205
+dotflow/providers/__init__.py,sha256=1U_tgpbCglgbq0sv7ft56vZXjlCA-n0XX67SnMNEV0o,2273
 dotflow/providers/log_default.py,sha256=1X9jYqylwTMy1AJt5552SgmVWMR_B_JFcMe8QE8XHgQ,1796
 dotflow/providers/log_opentelemetry.py,sha256=6A1LEVH3qNxAnqt6Zil23Tb7lZqL920SfstZ_TYX988,3094
 dotflow/providers/log_sentry.py,sha256=ttVHkiFc1SRbt04xNtKJGtRlpfaN4JBVg5ZJnlD0-04,2695
@@ -96,6 +96,7 @@ dotflow/providers/notify_discord.py,sha256=9cOt3YwJzuZzpNQlMLdc3sfJ5hfFRBBAmpNoU
 dotflow/providers/notify_telegram.py,sha256=xiyeqVSo_xQg3FR3_Q6Dnx2Qk8Sih2J7tkIVxkFSefk,3230
 dotflow/providers/scheduler_cron.py,sha256=wRXI5g0fDrYkBgD5zAMa5T8xxjU9v1SjDNpmsQD8nwA,8245
 dotflow/providers/scheduler_default.py,sha256=mkgMz5D6mROTDDY5juGXV4IgEDRPM0yW8_NJWDVfRTQ,258
+dotflow/providers/server_api.py,sha256=VNFfWly8EVNo7PSoVBF1hQJIwb1cPtULv34v3KHeu0U,2515
 dotflow/providers/server_default.py,sha256=RRJMwN2oyyS_gHPif2fPJRGNsmTw2e3BmXVuQMYSR2M,500
 dotflow/providers/storage_default.py,sha256=ijE6cN0TlmTn8J5TiNvq_xakoK3JmciqI7qJWxesEBM,568
 dotflow/providers/storage_file.py,sha256=N4BPiDWWDOUbh5suzWvYzX6ZUtjhrfdZgSqwBPDW__I,2154
@@ -110,8 +111,8 @@ dotflow/utils/__init__.py,sha256=AXiUm5p-FVG9SBWPxdG6jV0ft49EK6c40ME4aznPWQc,366
 dotflow/utils/basic_functions.py,sha256=S-maghYauG5QkMtHdm7qNcxBkKkSoE4akHSiI178Bwg,131
 dotflow/utils/error_handler.py,sha256=I8DY2AKR-WxKl8k7aUJPExS6wlzKVPy_u42ZJ9gYyts,272
 dotflow/utils/tools.py,sha256=RtC0D1SnaNCB02cT-l0Dw8Wl6uDSQSABoZH2kdD1PJQ,787
-dotflow-0.15.0.dev7.dist-info/METADATA,sha256=8_GXXfbKWiai4uVbyaqJNUih3Ge0_VQ4vIT7xRZ3Gaw,29495
-dotflow-0.15.0.dev7.dist-info/WHEEL,sha256=Vz2fHgx6HFtSwhs8KvkHLqH5Ea4w1_rner5uNVGCeIE,88
-dotflow-0.15.0.dev7.dist-info/entry_points.txt,sha256=3AW0pYKZpaMW6WZmN3t71X0FuwxQdivmQwe47_6yBp4,45
-dotflow-0.15.0.dev7.dist-info/licenses/LICENSE,sha256=UnmVHQt00UH2v7RBXqtIo_0D3vGBh0ujTdBKPKopAFk,1072
-dotflow-0.15.0.dev7.dist-info/RECORD,,
+dotflow-0.16.0.dev2.dist-info/METADATA,sha256=i6enVoDSnIaKacPBZnBEIgPatqWtSTysXE9Nal97FOM,40731
+dotflow-0.16.0.dev2.dist-info/WHEEL,sha256=Vz2fHgx6HFtSwhs8KvkHLqH5Ea4w1_rner5uNVGCeIE,88
+dotflow-0.16.0.dev2.dist-info/entry_points.txt,sha256=3AW0pYKZpaMW6WZmN3t71X0FuwxQdivmQwe47_6yBp4,45
+dotflow-0.16.0.dev2.dist-info/licenses/LICENSE,sha256=0h5VY_8dcAiTIGt0weGPV6cjxdPGB37Pjusxm_WAiPU,10766
+dotflow-0.16.0.dev2.dist-info/RECORD,,

dotflow-0.16.0.dev2.dist-info/licenses/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to the Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by the Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding any notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2025 Fernando Celmer
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

dotflow-0.15.0.dev7.dist-info/licenses/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2025 Fernando Celmer
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.