dotflow 0.16.0.dev3__tar.gz → 1.0.0.dev1__tar.gz

{dotflow-0.16.0.dev3 → dotflow-1.0.0.dev1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dotflow
-Version: 0.16.0.dev3
+Version: 1.0.0.dev1
 Summary: 🎲 Dotflow turns an idea into flow! Lightweight Python library for execution pipelines with retry, parallel, cron and async support.
 License: Apache License
                                     Version 2.0, January 2004

{dotflow-0.16.0.dev3 → dotflow-1.0.0.dev1}/dotflow/__init__.py

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

{dotflow-0.16.0.dev3 → dotflow-1.0.0.dev1}/dotflow/cli/commands/start.py

@@ -1,6 +1,5 @@
 """Command start module"""
 
-import os
 from os import system
 
 from dotflow import Config, DotFlow
@@ -9,8 +8,6 @@ from dotflow.core.exception import InvalidWorkflowFactory, WorkflowFlagConflict
 from dotflow.core.module import Module
 from dotflow.core.types.execution import TypeExecution
 from dotflow.providers import (
-    ServerAPI,
-    ServerDefault,
     StorageDefault,
     StorageFile,
     StorageGCS,
@@ -62,32 +59,10 @@ class StartCommand(Command):
         result.start(mode=self.params.mode)
 
     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)
+        if storage is None:
+            return DotFlow()
+        return DotFlow(config=Config(storage=storage))
 
     def _build_storage(self):
         if not self.params.storage:

{dotflow-0.16.0.dev3 → dotflow-1.0.0.dev1}/dotflow/core/module.py

@@ -14,7 +14,8 @@ class Module:
 
     @classmethod
     def import_module(cls, value: str):
-        module_path, _, attr_name = value.rpartition(".")
+        separator = ":" if ":" in value else "."
+        module_path, _, attr_name = value.rpartition(separator)
 
         if not module_path:
             raise ImportModuleError(module=value)

{dotflow-0.16.0.dev3 → dotflow-1.0.0.dev1}/dotflow/providers/__init__.py

@@ -6,7 +6,6 @@ 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
@@ -21,7 +20,6 @@ __all__ = [
     "NotifyTelegram",
     "SchedulerCron",
     "SchedulerDefault",
-    "ServerAPI",
     "ServerDefault",
     "StorageDefault",
     "StorageFile",

dotflow-1.0.0.dev1/dotflow/providers/server_default.py

@@ -0,0 +1,116 @@
+"""ServerDefault — no-op or managed HTTP server provider."""
+
+from __future__ import annotations
+
+import os
+from functools import wraps
+from typing import Any
+
+from requests import patch, post
+from requests.exceptions import RequestException
+
+from dotflow.abc.server import Server
+from dotflow.logging import logger
+
+
+def managed(method):
+    @wraps(method)
+    def wrapper(self, *args, **kwargs):
+        if not self._managed:
+            return
+        return method(self, *args, **kwargs)
+
+    return wrapper
+
+
+class ServerDefault(Server):
+    """Default Server provider with auto-detected managed mode.
+
+    When ``SERVER_BASE_URL`` and ``SERVER_USER_TOKEN`` env vars are set,
+    sends workflow and task events to the remote API. Otherwise, all
+    methods are no-ops.
+    """
+
+    MAX_RESULT_SIZE = 5_000_000
+    TIMEOUT = 15.0
+
+    ENDPOINT_WORKFLOWS = "/workflows"
+    ENDPOINT_WORKFLOW = "/workflows/{workflow_id}"
+    ENDPOINT_TASKS = "/workflows/{workflow_id}/tasks"
+    ENDPOINT_TASK = "/workflows/{workflow_id}/tasks/{task_id}"
+
+    def __init__(self) -> None:
+        base_url = os.getenv("SERVER_BASE_URL")
+        user_token = os.getenv("SERVER_USER_TOKEN")
+        self._managed = bool(base_url and user_token)
+
+        self._base_url = base_url.rstrip("/") if base_url else None
+        self._user_token = user_token
+
+    @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)
+
+    @managed
+    def create_workflow(self, workflow: Any) -> None:
+        self._post(
+            self._base_url + self.ENDPOINT_WORKFLOWS,
+            json={"id": str(workflow)},
+        )
+
+    @managed
+    def update_workflow(self, workflow: Any, status: str = "") -> None:
+        self._patch(
+            self._base_url
+            + self.ENDPOINT_WORKFLOW.format(workflow_id=workflow),
+            json={"status": status},
+        )
+
+    @managed
+    def create_task(self, task: Any) -> None:
+        data = task.result(max=self.MAX_RESULT_SIZE)
+        data["id"] = data.pop("task_id", task.task_id)
+        self._post(
+            self._base_url
+            + self.ENDPOINT_TASKS.format(workflow_id=task.workflow_id),
+            json=data,
+        )
+
+    @managed
+    def update_task(self, task: Any) -> None:
+        data = task.result(max=self.MAX_RESULT_SIZE)
+        self._patch(
+            self._base_url
+            + self.ENDPOINT_TASK.format(
+                workflow_id=task.workflow_id,
+                task_id=task.task_id,
+            ),
+            json=data,
+        )

{dotflow-0.16.0.dev3 → dotflow-1.0.0.dev1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "dotflow"
-version = "0.16.0.dev3"
+version = "1.0.0.dev1"
 authors = [
   { name="Fernando Celmer", email="email@fernandocelmer.com" },
 ]
@@ -67,7 +67,7 @@ sentry = ["sentry-sdk"]
 
 [tool.poetry]
 name = "dotflow"
-version = "0.16.0.dev3"
+version = "1.0.0.dev1"
 description = "🎲 Dotflow turns an idea into flow! Lightweight Python library for execution pipelines with retry, parallel, cron and async support."
 authors = ["Fernando Celmer <email@fernandocelmer.com>"]
 readme = "README.md"

dotflow-0.16.0.dev3/dotflow/providers/server_api.py

@@ -1,89 +0,0 @@
-"""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)
-        data["id"] = data.pop("task_id", task.task_id)
-        self._patch(
-            (
-                f"{self._base_url}/workflows/{task.workflow_id}"
-                f"/tasks/{task.task_id}"
-            ),
-            json=data,
-        )

dotflow-0.16.0.dev3/dotflow/providers/server_default.py

@@ -1,23 +0,0 @@
-"""ServerDefault — no-op server provider."""
-
-from __future__ import annotations
-
-from typing import Any
-
-from dotflow.abc.server import Server
-
-
-class ServerDefault(Server):
-    """Default Server implementation (no-op)."""
-
-    def create_workflow(self, workflow: Any) -> None:
-        pass
-
-    def update_workflow(self, workflow: Any, status: str = "") -> None:
-        pass
-
-    def create_task(self, task: Any) -> None:
-        pass
-
-    def update_task(self, task: Any) -> None:
-        pass