dotflow 1.0.0.dev2__py3-none-any.whl → 1.0.0.dev4__py3-none-any.whl

dotflow/__init__.py

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

dotflow/cli/commands/__init__.py

@@ -4,6 +4,8 @@ from dotflow.cli.commands.cloud import CloudGenerateCommand, CloudListCommand
 from dotflow.cli.commands.deploy import DeployCommand
 from dotflow.cli.commands.init import InitCommand
 from dotflow.cli.commands.log import LogCommand
+from dotflow.cli.commands.login import LoginCommand
+from dotflow.cli.commands.logout import LogoutCommand
 from dotflow.cli.commands.schedule import ScheduleCommand
 from dotflow.cli.commands.start import StartCommand
 
@@ -13,6 +15,8 @@ __all__ = [
     "DeployCommand",
     "InitCommand",
     "LogCommand",
+    "LoginCommand",
+    "LogoutCommand",
     "ScheduleCommand",
     "StartCommand",
 ]

dotflow/cli/commands/login.py

@@ -0,0 +1,123 @@
+"""Command login module."""
+
+from __future__ import annotations
+
+import os
+import time
+import webbrowser
+
+from requests import RequestException, post
+from rich import print  # type: ignore
+
+from dotflow.cli.command import Command
+from dotflow.core.config_file import save_cloud_config
+from dotflow.settings import Settings as settings
+
+DEFAULT_BASE_URL = "https://www.host.dotflow.io/api/v1"
+DEVICE_ENDPOINT = "/cli/device"
+TOKEN_ENDPOINT = "/cli/token"
+TIMEOUT = 15
+DEFAULT_INTERVAL = 5
+MAX_POLL_INTERVAL = 60
+
+
+class LoginCommand(Command):
+    def setup(self):
+        token = getattr(self.params, "token", None)
+        base_url = self._resolve_base_url()
+
+        if token:
+            save_cloud_config(token=token, base_url=base_url)
+            print(settings.INFO_ALERT, "Token saved.")
+            return
+
+        handshake = self._start_device(base_url)
+        if handshake is None:
+            return
+
+        print(settings.INFO_ALERT, f"Opening {handshake['verification_uri']}")
+        print(settings.INFO_ALERT, f"Code: {handshake['user_code']}")
+
+        webbrowser.open(handshake["verification_uri"])
+
+        token = self._poll_token(base_url, handshake)
+
+        if not token:
+            return
+
+        save_cloud_config(token=token, base_url=base_url)
+        print(settings.INFO_ALERT, "Authenticated.")
+
+    def _resolve_base_url(self) -> str:
+        """Flag or env var wins over the default."""
+        explicit = getattr(self.params, "base_url", None) or os.environ.get(
+            "SERVER_BASE_URL"
+        )
+        return explicit.rstrip("/") if explicit else DEFAULT_BASE_URL
+
+    def _start_device(self, base_url: str) -> dict | None:
+        try:
+            response = post(
+                f"{base_url}{DEVICE_ENDPOINT}",
+                timeout=TIMEOUT,
+            )
+            response.raise_for_status()
+            return response.json()
+        except RequestException as error:
+            print(
+                settings.ERROR_ALERT,
+                f"Could not reach Dotflow Cloud: {error}",
+            )
+            return None
+
+    def _poll_token(self, base_url: str, handshake: dict) -> str | None:
+        interval = handshake.get("interval") or DEFAULT_INTERVAL
+        deadline = time.monotonic() + (handshake.get("expires_in") or 300)
+
+        while time.monotonic() < deadline:
+            try:
+                response = post(
+                    f"{base_url}{TOKEN_ENDPOINT}",
+                    json={"device_code": handshake["device_code"]},
+                    timeout=TIMEOUT,
+                )
+            except RequestException as error:
+                print(settings.ERROR_ALERT, f"Network error: {error}")
+                return None
+
+            if response.status_code == 200:
+                return response.json().get("api_token")
+
+            detail = self._detail(response)
+
+            if (
+                response.status_code == 400
+                and detail == "authorization_pending"
+            ):
+                time.sleep(interval)
+                continue
+
+            if response.status_code == 400 and detail in (
+                "slow_down",
+                "slow down",
+            ):
+                interval = min(interval + 5, MAX_POLL_INTERVAL)
+                time.sleep(interval)
+                continue
+
+            if response.status_code == 410:
+                print(settings.ERROR_ALERT, "Authorization expired.")
+                return None
+
+            print(settings.ERROR_ALERT, f"{response.status_code}: {detail}")
+            return None
+
+        print(settings.ERROR_ALERT, "Timed out waiting for authorization.")
+        return None
+
+    @staticmethod
+    def _detail(response) -> str:
+        try:
+            return str(response.json().get("detail", response.text))
+        except ValueError:
+            return response.text

dotflow/cli/commands/logout.py

@@ -0,0 +1,15 @@
+"""Command logout module."""
+
+from rich import print  # type: ignore
+
+from dotflow.cli.command import Command
+from dotflow.core.config_file import clear_cloud_config
+from dotflow.settings import Settings as settings
+
+
+class LogoutCommand(Command):
+    def setup(self):
+        if clear_cloud_config():
+            print(settings.INFO_ALERT, "Signed out.")
+        else:
+            print(settings.WARNING_ALERT, "No saved credentials.")

dotflow/cli/commands/start.py

@@ -35,7 +35,7 @@ class StartCommand(Command):
             initial_context=self.params.initial_context,
         )
 
-        workflow.start(mode=self.params.mode)
+        workflow.start(mode=self.params.mode, resume=self.params.resume)
 
     def _start_from_factory(self):
         step_only_flags = {
@@ -56,7 +56,7 @@ class StartCommand(Command):
         if not isinstance(result, DotFlow):
             raise InvalidWorkflowFactory(factory=self.params.workflow)
 
-        result.start(mode=self.params.mode)
+        result.start(mode=self.params.mode, resume=self.params.resume)
 
     def _new_workflow(self):
         storage = self._build_storage()

dotflow/cli/setup.py

@@ -9,6 +9,8 @@ from dotflow.cli.commands import (
     DeployCommand,
     InitCommand,
     LogCommand,
+    LoginCommand,
+    LogoutCommand,
     ScheduleCommand,
     StartCommand,
 )
@@ -42,12 +44,37 @@ class Command:
 
         self.setup_init()
         self.setup_logs()
+        self.setup_login()
+        self.setup_logout()
         self.setup_start()
         self.setup_schedule()
         self.setup_cloud()
         self.setup_deploy()
         self.command()
 
+    def setup_login(self):
+        cmd = self.subparsers.add_parser(
+            "login", help="Authenticate the CLI via browser"
+        )
+        cmd_group = cmd.add_argument_group("Usage: dotflow login [OPTIONS]")
+        cmd_group.add_argument(
+            "--base-url",
+            default=None,
+            help="Override the Dotflow Cloud API base URL",
+        )
+        cmd_group.add_argument(
+            "--token",
+            default=None,
+            help="Skip the browser flow and save a pre-obtained API token",
+        )
+        cmd.set_defaults(exec=LoginCommand)
+
+    def setup_logout(self):
+        cmd = self.subparsers.add_parser(
+            "logout", help="Remove saved CLI credentials"
+        )
+        cmd.set_defaults(exec=LogoutCommand)
+
     def setup_init(self):
         self.cmd_init = self.subparsers.add_parser(
             "init", help="Scaffold a new dotflow project"
@@ -93,6 +120,12 @@ class Command:
                 TypeExecution.PARALLEL,
             ],
         )
+        self.cmd_start.add_argument(
+            "--resume",
+            action="store_true",
+            default=False,
+            help="Enable checkpoint-based resume",
+        )
 
         cmd_start_parser.set_defaults(exec=StartCommand)
 

dotflow/core/config_file.py

@@ -0,0 +1,95 @@
+"""Persistent CLI config stored at ``~/.dotflow/config.json``."""
+
+from __future__ import annotations
+
+import contextlib
+import json
+import os
+from pathlib import Path
+
+CONFIG_DIR_NAME = ".dotflow"
+CONFIG_FILE_NAME = "config.json"
+CLOUD_SECTION = "cloud"
+
+
+def config_path() -> Path:
+    """Return the absolute path of the CLI config file."""
+    return Path.home() / CONFIG_DIR_NAME / CONFIG_FILE_NAME
+
+
+def load_cloud_config() -> dict[str, str]:
+    """Read the ``cloud`` section from the config file. ``{}`` when absent."""
+    path = config_path()
+
+    if not path.exists():
+        return {}
+
+    try:
+        raw = path.read_text(encoding="utf-8")
+    except OSError:
+        return {}
+
+    try:
+        data = json.loads(raw)
+    except json.JSONDecodeError:
+        return {}
+
+    section = data.get(CLOUD_SECTION) if isinstance(data, dict) else None
+    if not isinstance(section, dict):
+        return {}
+
+    return {
+        key: str(value)
+        for key, value in section.items()
+        if isinstance(value, str)
+    }
+
+
+def save_cloud_config(token: str, base_url: str) -> Path:
+    """Persist ``cloud`` with the given token/base_url. Returns the file path."""
+    path = config_path()
+    path.parent.mkdir(parents=True, exist_ok=True)
+
+    payload = {
+        CLOUD_SECTION: {
+            "base_url": base_url,
+            "token": token,
+        }
+    }
+    content = json.dumps(payload, indent=2) + "\n"
+
+    fd = os.open(
+        str(path),
+        os.O_WRONLY | os.O_CREAT | os.O_TRUNC,
+        0o600,
+    )
+    with contextlib.suppress(OSError):
+        os.fchmod(fd, 0o600)
+    with os.fdopen(fd, "w", encoding="utf-8") as fh:
+        fh.write(content)
+
+    return path
+
+
+def clear_cloud_config() -> bool:
+    """Remove the config file. Returns True when something was deleted."""
+    path = config_path()
+
+    if not path.exists():
+        return False
+
+    try:
+        path.unlink()
+        return True
+    except OSError:
+        return False
+
+
+def resolve(key: str, env_var: str) -> str | None:
+    """Resolve a setting with env > file precedence. ``None`` when absent."""
+    env_value = os.environ.get(env_var)
+
+    if env_value:
+        return env_value
+
+    return load_cloud_config().get(key) or None

dotflow/providers/server_default.py

@@ -1,4 +1,4 @@
-"""ServerDefault — no-op or managed HTTP server provider."""
+"""ServerDefault - managed HTTP server provider."""
 
 from __future__ import annotations
 
@@ -24,24 +24,19 @@ def managed(method):
 
 
 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.
-    """
+    """Default Server provider with auto-detected managed mode."""
 
     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}"
+    ENDPOINT_WORKFLOWS = "/cli/workflows"
+    ENDPOINT_WORKFLOW = "/cli/workflows/{workflow_id}"
+    ENDPOINT_TASKS = "/cli/workflows/{workflow_id}/tasks"
+    ENDPOINT_TASK = "/cli/workflows/{workflow_id}/tasks/{task_id}"
 
     def __init__(self) -> None:
-        base_url = os.getenv("SERVER_BASE_URL")
-        user_token = os.getenv("SERVER_USER_TOKEN")
+        base_url = os.environ.get("SERVER_BASE_URL") or None
+        user_token = os.environ.get("SERVER_USER_TOKEN") or None
         self._managed = bool(base_url and user_token)
 
         self._base_url = base_url.rstrip("/") if base_url else None
@@ -56,25 +51,23 @@ class ServerDefault(Server):
 
     def _post(self, url: str, json: dict) -> None:
         try:
-            response = post(
+            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(
+            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)
 

{dotflow-1.0.0.dev2.dist-info → dotflow-1.0.0.dev4.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dotflow
-Version: 1.0.0.dev2
+Version: 1.0.0.dev4
 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-1.0.0.dev2.dist-info → dotflow-1.0.0.dev4.dist-info}/RECORD

@@ -1,4 +1,4 @@
-dotflow/__init__.py,sha256=ZrN0peVdiBsWAm9h8w9HQbs5XFGOU_fwP-OtU-_MLKs,350
+dotflow/__init__.py,sha256=uorc8dzhoW2e0vy6-4AgHvGOzHXG1Y0tGipyWFod15Y,350
 dotflow/abc/__init__.py,sha256=UIk84jCJYoHAk4In_eVXAaFAnNE63lI3dVP5qunyBJs,32
 dotflow/abc/file.py,sha256=QEDIS-AXaW3GK5q5ckhNdoC5A3p8oOFE7VyNGSvx540,296
 dotflow/abc/flow.py,sha256=j6m9u13UXgBCIhgrUwzvBBYHTDul_DfERD4DWA1BQBw,1436
@@ -13,15 +13,17 @@ 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/__init__.py,sha256=7GjVzmVDSK1KGixZru0DQo-_aCHfDL59k17TgNfuA4M,688
 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/login.py,sha256=z9nmjLLjtmdX2fiwp9O3N8OuBNEeh8M1mRQs0ku1jOw,3839
+dotflow/cli/commands/logout.py,sha256=d8F7v6KKiqXsTpsK4CspaH5qeDLyIi7sgRXhJNfN2kY,437
 dotflow/cli/commands/schedule.py,sha256=C9wvgSowV4xgQqrx6pjNZk5-709uNDfsA7xGBjjbZYA,1442
-dotflow/cli/commands/start.py,sha256=FBtuSY5KKuNWbqxppKVG-QrSc5fLbqtwrRELgGk7c9g,2425
+dotflow/cli/commands/start.py,sha256=ruF_FEMMgB4TGkOjbCpWy6koA_8HtqLIwU-d6PuQ_bA,2479
 dotflow/cli/commands/storage.py,sha256=b3CMBSFGEqYxaI9gwiO90MIirnW82CcM3GUf4XJGVYs,1549
-dotflow/cli/setup.py,sha256=MDt_yNOdyDIhQHQfrWjXCvvnO5i0Ul-fwa7Dag2F6h0,8094
+dotflow/cli/setup.py,sha256=zECGX3QBQbQAxx8NsYAHVhz0YjQtc0GlKxDSDULxyjw,9135
 dotflow/cli/validators/__init__.py,sha256=JKD-C4igDghgLjU2eBbpHkThUapoJ2mJRtC_YkeEvHg,121
 dotflow/cli/validators/start.py,sha256=ziQQWpLds6K_XnkiZt3m8bSs3KPdDSQzIuEiea5slks,466
 dotflow/cloud/__init__.py,sha256=N8XuL0M9P2vbP3WssHI85J8TSofVHo5llOI8EXp9RU0,21
@@ -64,6 +66,7 @@ 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/config_file.py,sha256=Y2_RZ2IxW8RjnsU_aOCferljV2X7DgW91RqPKinNsKM,2235
 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
@@ -96,7 +99,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_default.py,sha256=T-Ex3BHkXWiF5pWFu65fKtaoJUdjOLnxaRA40H44qjk,3418
+dotflow/providers/server_default.py,sha256=KniaNtNH8kiQ4coD3HC4P5bxSIiloMT9YtlenNnd4Ik,3120
 dotflow/providers/storage_default.py,sha256=ijE6cN0TlmTn8J5TiNvq_xakoK3JmciqI7qJWxesEBM,568
 dotflow/providers/storage_file.py,sha256=N4BPiDWWDOUbh5suzWvYzX6ZUtjhrfdZgSqwBPDW__I,2154
 dotflow/providers/storage_gcs.py,sha256=LgkS0zjlPElbvPhk7-uVKbNTnVn2OTtk8h5XltWIOH0,2484
@@ -110,8 +113,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-1.0.0.dev2.dist-info/METADATA,sha256=o4qcR74cIGtpnaqHVR6xQ7ygY2AaCDPIylXUr967ZhQ,40730
-dotflow-1.0.0.dev2.dist-info/WHEEL,sha256=Vz2fHgx6HFtSwhs8KvkHLqH5Ea4w1_rner5uNVGCeIE,88
-dotflow-1.0.0.dev2.dist-info/entry_points.txt,sha256=3AW0pYKZpaMW6WZmN3t71X0FuwxQdivmQwe47_6yBp4,45
-dotflow-1.0.0.dev2.dist-info/licenses/LICENSE,sha256=0h5VY_8dcAiTIGt0weGPV6cjxdPGB37Pjusxm_WAiPU,10766
-dotflow-1.0.0.dev2.dist-info/RECORD,,
+dotflow-1.0.0.dev4.dist-info/METADATA,sha256=5-HwzHn6e-WQTasE6ce9dwwQ_9C9QGnE8lQqSyhmXTI,40730
+dotflow-1.0.0.dev4.dist-info/WHEEL,sha256=Vz2fHgx6HFtSwhs8KvkHLqH5Ea4w1_rner5uNVGCeIE,88
+dotflow-1.0.0.dev4.dist-info/entry_points.txt,sha256=3AW0pYKZpaMW6WZmN3t71X0FuwxQdivmQwe47_6yBp4,45
+dotflow-1.0.0.dev4.dist-info/licenses/LICENSE,sha256=0h5VY_8dcAiTIGt0weGPV6cjxdPGB37Pjusxm_WAiPU,10766
+dotflow-1.0.0.dev4.dist-info/RECORD,,