dotflow 0.15.0.dev3__tar.gz → 0.15.0.dev4__tar.gz

{dotflow-0.15.0.dev3 → dotflow-0.15.0.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dotflow
-Version: 0.15.0.dev3
+Version: 0.15.0.dev4
 Summary: 🎲 Dotflow turns an idea into flow! Lightweight Python library for execution pipelines with retry, parallel, cron and async support.
 License: MIT License
          
@@ -42,6 +42,7 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Provides-Extra: aws
+Provides-Extra: deploy-alibaba
 Provides-Extra: deploy-aws
 Provides-Extra: deploy-gcp
 Provides-Extra: deploy-github
@@ -51,6 +52,8 @@ Provides-Extra: scheduler
 Provides-Extra: sentry
 Requires-Dist: GitPython ; extra == "deploy-github"
 Requires-Dist: PyGithub ; extra == "deploy-github"
+Requires-Dist: alibabacloud-fc-open20210406 ; extra == "deploy-alibaba"
+Requires-Dist: alibabacloud-tea-openapi ; extra == "deploy-alibaba"
 Requires-Dist: boto3 ; extra == "aws"
 Requires-Dist: boto3 ; extra == "deploy-aws"
 Requires-Dist: cookiecutter (>=2.0)
@@ -78,9 +81,9 @@ Description-Content-Type: text/markdown
 
 <div align="center">
 
-![](docs/assets/dotflow.png)
+![](https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/dotflow.png)
 
-**Build production-ready data pipelines in minutes, not days.**
+**import dotflow. @action. deploy. Done.**
 
 [![PyPI](https://img.shields.io/pypi/v/dotflow?style=flat-square)](https://pypi.org/project/dotflow/)
 [![Python](https://img.shields.io/pypi/pyversions/dotflow?style=flat-square)](https://pypi.org/project/dotflow/)
@@ -103,7 +106,7 @@ Dotflow is a lightweight Python library for execution pipelines. Define tasks wi
 - **Resilient** — Retry, backoff, timeout, checkpoints, and error handling out of the box.
 - **Observable** — OpenTelemetry traces, metrics, and logs. Sentry error tracking.
 - **Deployable** — `dotflow deploy --platform lambda` ships your pipeline to AWS in one command.
-- **Portable** — Same code runs on Lambda, ECS, Cloud Run, Kubernetes, Docker, or GitHub Actions.
+- **Portable** — Same code runs on Lambda, ECS, Cloud Run, Alibaba FC, Kubernetes, Docker, or GitHub Actions.
 
 ## Install
 
@@ -150,16 +153,20 @@ dotflow deploy --platform lambda --project my_pipeline
 
 | Platform | Deploy method |
 |----------|---------------|
-| <img src="https://cdn.simpleicons.org/docker" width="16" /> **Docker** | `docker compose up` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + EventBridge** | `dotflow deploy --schedule` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + S3 Trigger** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + SQS Trigger** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + API Gateway** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_ecs/amazon_ecs-icon.svg" width="16" /> **AWS ECS Fargate** | `dotflow deploy` |
-| <img src="https://cdn.simpleicons.org/googlecloud" width="16" /> **Google Cloud Run** | `gcloud run deploy` |
-| <img src="https://cdn.simpleicons.org/kubernetes" width="16" /> **Kubernetes** | `kubectl apply` |
-| <img src="https://cdn.simpleicons.org/githubactions" width="16" /> **GitHub Actions** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-docker.svg" width="16" /> **Docker** | `docker compose up` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> **AWS Lambda** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-eventbridge.svg" width="16" /> **AWS Lambda + EventBridge** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-s3.svg" width="16" /> **AWS Lambda + S3 Trigger** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-sqs.svg" width="16" /> **AWS Lambda + SQS Trigger** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-api-gateway.svg" width="16" /> **AWS Lambda + API Gateway** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-ecs.svg" width="16" /> **AWS ECS Fargate** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-ecs.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-eventbridge.svg" width="16" /> **AWS ECS + EventBridge** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-google-cloud.svg" width="16" /> **Google Cloud Run** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-google-cloud.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-google-cloud-scheduler.svg" width="16" /> **Cloud Run + Scheduler** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-kubernetes.svg" width="16" /> **Kubernetes** | `kubectl apply` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-alibaba-cloud.svg" width="16" /> **Alibaba Cloud FC** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-alibaba-cloud.svg" width="16" /> **Alibaba Cloud FC + Timer** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-github-actions.svg" width="16" /> **GitHub Actions** | `dotflow deploy` |
 
 > [See all 34+ platforms →](https://dotflow-io.github.io/dotflow/nav/cloud/)
 
@@ -171,9 +178,10 @@ pip install dotflow[gcp]            # Google Cloud Storage
 pip install dotflow[scheduler]      # Cron scheduler
 pip install dotflow[otel]           # OpenTelemetry
 pip install dotflow[sentry]         # Sentry error tracking
-pip install dotflow[deploy-aws]     # AWS deploy (Lambda, ECS)
-pip install dotflow[deploy-gcp]     # GCP deploy (Cloud Run)
-pip install dotflow[deploy-github]  # GitHub Actions deploy
+pip install dotflow[deploy-aws]      # AWS deploy (Lambda, ECS)
+pip install dotflow[deploy-gcp]      # GCP deploy (Cloud Run)
+pip install dotflow[deploy-alibaba]  # Alibaba Cloud deploy (FC)
+pip install dotflow[deploy-github]   # GitHub Actions deploy
 ```
 
 > **[Read the full documentation →](https://dotflow-io.github.io/dotflow/)**
@@ -184,8 +192,8 @@ pip install dotflow[deploy-github]  # GitHub Actions deploy
 |---------|-------------|
 | [Concepts](https://dotflow-io.github.io/dotflow/nav/concepts/concept-workflow-and-tasks/) | Workflows, tasks, context, providers, process modes |
 | [How-to Guides](https://dotflow-io.github.io/dotflow/nav/how-to/) | Step-by-step tutorials for workflows, tasks, and CLI |
-| [Cloud Deployment](https://dotflow-io.github.io/dotflow/nav/cloud/) | Deploy to AWS, GCP, Kubernetes, Docker, GitHub Actions |
-| [Integrations](https://dotflow-io.github.io/dotflow/nav/integrations/) | OpenTelemetry, Sentry, Telegram, Discord, S3, GCS |
+| [Cloud Deployment](https://dotflow-io.github.io/dotflow/nav/cloud/) | Deploy to AWS, GCP, Alibaba, Kubernetes, Docker, GitHub Actions |
+| [Integrations](https://dotflow-io.github.io/dotflow/nav/integrations/) | OpenTelemetry, Sentry, Telegram, Discord, S3, GCS, Server |
 | [Examples](https://dotflow-io.github.io/dotflow/nav/examples/) | Real-world pipelines: ETL, health checks, async, scheduler |
 | [Reference](https://dotflow-io.github.io/dotflow/nav/reference/dotflow/) | API reference for all classes and providers |
 | [Custom Providers](https://dotflow-io.github.io/dotflow/nav/development/custom-providers/) | Build your own storage, notify, log, tracer, or metrics provider |
@@ -723,20 +731,64 @@ Available CLI commands:
 
 </details>
 
+<details>
+<summary><strong>Server Provider</strong></summary>
+
+> [Server docs](https://dotflow-io.github.io/dotflow/nav/tutorial/server-default/)
+
+Send workflow and task execution data to a remote API (e.g. dotflow-api) in real time.
+
+```python
+from dotflow import DotFlow, Config, action
+from dotflow.providers import ServerDefault
+
+@action
+def my_task():
+    return {"result": "ok"}
+
+config = Config(
+    server=ServerDefault(
+        base_url="http://localhost:8000/api/v1",
+        user_token="your-api-token",
+    )
+)
+
+workflow = DotFlow(config=config)
+workflow.task.add(step=my_task)
+workflow.start()
+```
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `base_url` | `str` | `""` | API base URL |
+| `user_token` | `str` | `""` | API token (`X-User-Token` header) |
+| `timeout` | `float` | `5.0` | HTTP request timeout in seconds |
+
+The server provider automatically:
+- Creates the workflow on `DotFlow()` init
+- Creates each task on `task.add()`
+- Updates task status on each transition (In progress, Completed, Failed, Retry)
+- Updates workflow status on completion (In progress → Completed)
+
+---
+
+</details>
+
 <details>
 <summary><strong>Dependency Injection via Config</strong></summary>
 
-The `Config` class lets you swap providers for storage, notifications, logging, and scheduling:
+The `Config` class lets you swap providers for storage, notifications, logging, scheduling, and server:
 
 ```python
 from dotflow import DotFlow, Config
-from dotflow.providers import StorageFile, NotifyTelegram, LogDefault, SchedulerCron
+from dotflow.providers import StorageFile, NotifyTelegram, LogDefault, SchedulerCron, ServerDefault
 
 config = Config(
     storage=StorageFile(path=".output"),
     notify=NotifyTelegram(token="...", chat_id=123),
     log=LogDefault(),
     scheduler=SchedulerCron(cron="0 * * * *"),
+    server=ServerDefault(base_url="...", user_token="..."),
 )
 
 workflow = DotFlow(config=config)
@@ -748,8 +800,11 @@ Extend Dotflow by implementing the abstract base classes:
 |-----|---------|---------|
 | `Storage` | `post`, `get`, `key` | Custom storage backends |
 | `Notify` | `hook_status_task` | Custom notification channels |
-| `Log` | `info`, `error` | Custom logging |
+| `Log` | `info`, `error`, `warning`, `debug` | Custom logging |
 | `Scheduler` | `start`, `stop` | Custom scheduling strategies |
+| `Tracer` | `start_workflow`, `end_workflow`, `start_task`, `end_task` | Distributed tracing |
+| `Metrics` | `workflow_started`, `workflow_completed`, `workflow_failed`, `task_completed`, `task_failed`, `task_retried` | Counters and histograms |
+| `Server` | `create_workflow`, `update_workflow`, `create_task`, `update_task` | Remote API communication |
 
 ---
 

{dotflow-0.15.0.dev3 → dotflow-0.15.0.dev4}/README.md

@@ -1,8 +1,8 @@
 <div align="center">
 
-![](docs/assets/dotflow.png)
+![](https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/dotflow.png)
 
-**Build production-ready data pipelines in minutes, not days.**
+**import dotflow. @action. deploy. Done.**
 
 [![PyPI](https://img.shields.io/pypi/v/dotflow?style=flat-square)](https://pypi.org/project/dotflow/)
 [![Python](https://img.shields.io/pypi/pyversions/dotflow?style=flat-square)](https://pypi.org/project/dotflow/)
@@ -25,7 +25,7 @@ Dotflow is a lightweight Python library for execution pipelines. Define tasks wi
 - **Resilient** — Retry, backoff, timeout, checkpoints, and error handling out of the box.
 - **Observable** — OpenTelemetry traces, metrics, and logs. Sentry error tracking.
 - **Deployable** — `dotflow deploy --platform lambda` ships your pipeline to AWS in one command.
-- **Portable** — Same code runs on Lambda, ECS, Cloud Run, Kubernetes, Docker, or GitHub Actions.
+- **Portable** — Same code runs on Lambda, ECS, Cloud Run, Alibaba FC, Kubernetes, Docker, or GitHub Actions.
 
 ## Install
 
@@ -72,16 +72,20 @@ dotflow deploy --platform lambda --project my_pipeline
 
 | Platform | Deploy method |
 |----------|---------------|
-| <img src="https://cdn.simpleicons.org/docker" width="16" /> **Docker** | `docker compose up` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + EventBridge** | `dotflow deploy --schedule` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + S3 Trigger** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + SQS Trigger** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_awslambda/amazon_awslambda-icon.svg" width="16" /> **AWS Lambda + API Gateway** | `dotflow deploy` |
-| <img src="https://www.vectorlogo.zone/logos/amazon_ecs/amazon_ecs-icon.svg" width="16" /> **AWS ECS Fargate** | `dotflow deploy` |
-| <img src="https://cdn.simpleicons.org/googlecloud" width="16" /> **Google Cloud Run** | `gcloud run deploy` |
-| <img src="https://cdn.simpleicons.org/kubernetes" width="16" /> **Kubernetes** | `kubectl apply` |
-| <img src="https://cdn.simpleicons.org/githubactions" width="16" /> **GitHub Actions** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-docker.svg" width="16" /> **Docker** | `docker compose up` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> **AWS Lambda** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-eventbridge.svg" width="16" /> **AWS Lambda + EventBridge** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-s3.svg" width="16" /> **AWS Lambda + S3 Trigger** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-sqs.svg" width="16" /> **AWS Lambda + SQS Trigger** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-lambda.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-api-gateway.svg" width="16" /> **AWS Lambda + API Gateway** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-ecs.svg" width="16" /> **AWS ECS Fargate** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-ecs.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-aws-eventbridge.svg" width="16" /> **AWS ECS + EventBridge** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-google-cloud.svg" width="16" /> **Google Cloud Run** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-google-cloud.svg" width="16" /> <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-google-cloud-scheduler.svg" width="16" /> **Cloud Run + Scheduler** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-kubernetes.svg" width="16" /> **Kubernetes** | `kubectl apply` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-alibaba-cloud.svg" width="16" /> **Alibaba Cloud FC** | `dotflow deploy` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-alibaba-cloud.svg" width="16" /> **Alibaba Cloud FC + Timer** | `dotflow deploy --schedule` |
+| <img src="https://raw.githubusercontent.com/dotflow-io/dotflow/develop/docs/assets/icon-github-actions.svg" width="16" /> **GitHub Actions** | `dotflow deploy` |
 
 > [See all 34+ platforms →](https://dotflow-io.github.io/dotflow/nav/cloud/)
 
@@ -93,9 +97,10 @@ pip install dotflow[gcp]            # Google Cloud Storage
 pip install dotflow[scheduler]      # Cron scheduler
 pip install dotflow[otel]           # OpenTelemetry
 pip install dotflow[sentry]         # Sentry error tracking
-pip install dotflow[deploy-aws]     # AWS deploy (Lambda, ECS)
-pip install dotflow[deploy-gcp]     # GCP deploy (Cloud Run)
-pip install dotflow[deploy-github]  # GitHub Actions deploy
+pip install dotflow[deploy-aws]      # AWS deploy (Lambda, ECS)
+pip install dotflow[deploy-gcp]      # GCP deploy (Cloud Run)
+pip install dotflow[deploy-alibaba]  # Alibaba Cloud deploy (FC)
+pip install dotflow[deploy-github]   # GitHub Actions deploy
 ```
 
 > **[Read the full documentation →](https://dotflow-io.github.io/dotflow/)**
@@ -106,8 +111,8 @@ pip install dotflow[deploy-github]  # GitHub Actions deploy
 |---------|-------------|
 | [Concepts](https://dotflow-io.github.io/dotflow/nav/concepts/concept-workflow-and-tasks/) | Workflows, tasks, context, providers, process modes |
 | [How-to Guides](https://dotflow-io.github.io/dotflow/nav/how-to/) | Step-by-step tutorials for workflows, tasks, and CLI |
-| [Cloud Deployment](https://dotflow-io.github.io/dotflow/nav/cloud/) | Deploy to AWS, GCP, Kubernetes, Docker, GitHub Actions |
-| [Integrations](https://dotflow-io.github.io/dotflow/nav/integrations/) | OpenTelemetry, Sentry, Telegram, Discord, S3, GCS |
+| [Cloud Deployment](https://dotflow-io.github.io/dotflow/nav/cloud/) | Deploy to AWS, GCP, Alibaba, Kubernetes, Docker, GitHub Actions |
+| [Integrations](https://dotflow-io.github.io/dotflow/nav/integrations/) | OpenTelemetry, Sentry, Telegram, Discord, S3, GCS, Server |
 | [Examples](https://dotflow-io.github.io/dotflow/nav/examples/) | Real-world pipelines: ETL, health checks, async, scheduler |
 | [Reference](https://dotflow-io.github.io/dotflow/nav/reference/dotflow/) | API reference for all classes and providers |
 | [Custom Providers](https://dotflow-io.github.io/dotflow/nav/development/custom-providers/) | Build your own storage, notify, log, tracer, or metrics provider |
@@ -645,20 +650,64 @@ Available CLI commands:
 
 </details>
 
+<details>
+<summary><strong>Server Provider</strong></summary>
+
+> [Server docs](https://dotflow-io.github.io/dotflow/nav/tutorial/server-default/)
+
+Send workflow and task execution data to a remote API (e.g. dotflow-api) in real time.
+
+```python
+from dotflow import DotFlow, Config, action
+from dotflow.providers import ServerDefault
+
+@action
+def my_task():
+    return {"result": "ok"}
+
+config = Config(
+    server=ServerDefault(
+        base_url="http://localhost:8000/api/v1",
+        user_token="your-api-token",
+    )
+)
+
+workflow = DotFlow(config=config)
+workflow.task.add(step=my_task)
+workflow.start()
+```
+
+| Parameter | Type | Default | Description |
+|-----------|------|---------|-------------|
+| `base_url` | `str` | `""` | API base URL |
+| `user_token` | `str` | `""` | API token (`X-User-Token` header) |
+| `timeout` | `float` | `5.0` | HTTP request timeout in seconds |
+
+The server provider automatically:
+- Creates the workflow on `DotFlow()` init
+- Creates each task on `task.add()`
+- Updates task status on each transition (In progress, Completed, Failed, Retry)
+- Updates workflow status on completion (In progress → Completed)
+
+---
+
+</details>
+
 <details>
 <summary><strong>Dependency Injection via Config</strong></summary>
 
-The `Config` class lets you swap providers for storage, notifications, logging, and scheduling:
+The `Config` class lets you swap providers for storage, notifications, logging, scheduling, and server:
 
 ```python
 from dotflow import DotFlow, Config
-from dotflow.providers import StorageFile, NotifyTelegram, LogDefault, SchedulerCron
+from dotflow.providers import StorageFile, NotifyTelegram, LogDefault, SchedulerCron, ServerDefault
 
 config = Config(
     storage=StorageFile(path=".output"),
     notify=NotifyTelegram(token="...", chat_id=123),
     log=LogDefault(),
     scheduler=SchedulerCron(cron="0 * * * *"),
+    server=ServerDefault(base_url="...", user_token="..."),
 )
 
 workflow = DotFlow(config=config)
@@ -670,8 +719,11 @@ Extend Dotflow by implementing the abstract base classes:
 |-----|---------|---------|
 | `Storage` | `post`, `get`, `key` | Custom storage backends |
 | `Notify` | `hook_status_task` | Custom notification channels |
-| `Log` | `info`, `error` | Custom logging |
+| `Log` | `info`, `error`, `warning`, `debug` | Custom logging |
 | `Scheduler` | `start`, `stop` | Custom scheduling strategies |
+| `Tracer` | `start_workflow`, `end_workflow`, `start_task`, `end_task` | Distributed tracing |
+| `Metrics` | `workflow_started`, `workflow_completed`, `workflow_failed`, `task_completed`, `task_failed`, `task_retried` | Counters and histograms |
+| `Server` | `create_workflow`, `update_workflow`, `create_task`, `update_task` | Remote API communication |
 
 ---
 

{dotflow-0.15.0.dev3 → dotflow-0.15.0.dev4}/dotflow/__init__.py

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

dotflow-0.15.0.dev4/dotflow/abc/server.py

@@ -0,0 +1,30 @@
+"""Abstract base for remote server communication."""
+
+from abc import ABC, abstractmethod
+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.
+    """
+
+    @abstractmethod
+    def create_workflow(self, workflow: Any) -> None:
+        """Register a new workflow on the remote server."""
+
+    @abstractmethod
+    def update_workflow(self, workflow: Any, status: str = "") -> None:
+        """Update workflow status on the remote server."""
+
+    @abstractmethod
+    def create_task(self, task: Any) -> None:
+        """Register a new task on the remote server."""
+
+    @abstractmethod
+    def update_task(self, task: Any) -> None:
+        """Update task data on the remote server."""

{dotflow-0.15.0.dev3 → dotflow-0.15.0.dev4}/dotflow/cli/commands/cloud.py

@@ -126,6 +126,7 @@ class CloudGenerateCommand(Command):
             if not project_name:
                 project_name = Path.cwd().name
 
+        project_name = project_name.replace("_", "-").lower()
         module_name = project_name.replace("-", "_")
 
         print(

dotflow-0.15.0.dev4/dotflow/cli/commands/deploy.py

@@ -0,0 +1,171 @@
+"""Command deploy module."""
+
+from rich import print  # type: ignore
+from rich.prompt import Prompt
+
+from dotflow.cli.command import Command
+from dotflow.cloud.alibaba.constants import (
+    DEFAULT_REGION as ALI_DEFAULT_REGION,
+)
+from dotflow.cloud.alibaba.constants import PLATFORMS as ALI_PLATFORMS
+from dotflow.cloud.alibaba.constants import (
+    SCHEDULED_PLATFORMS as ALI_SCHEDULED,
+)
+from dotflow.cloud.aws.constants import DEFAULT_REGION as AWS_DEFAULT_REGION
+from dotflow.cloud.aws.constants import PLATFORMS as AWS_PLATFORMS
+from dotflow.cloud.aws.constants import SCHEDULED_PLATFORMS as AWS_SCHEDULED
+from dotflow.cloud.gcp.constants import DEFAULT_REGION as GCP_DEFAULT_REGION
+from dotflow.cloud.gcp.constants import PLATFORMS as GCP_PLATFORMS
+from dotflow.cloud.gcp.constants import SCHEDULED_PLATFORMS as GCP_SCHEDULED
+from dotflow.settings import Settings as settings
+
+DEFAULT_REGIONS = {
+    **dict.fromkeys(AWS_PLATFORMS, AWS_DEFAULT_REGION),
+    **dict.fromkeys(GCP_PLATFORMS, GCP_DEFAULT_REGION),
+    **dict.fromkeys(ALI_PLATFORMS, ALI_DEFAULT_REGION),
+}
+
+SCHEDULED_PLATFORMS = AWS_SCHEDULED | GCP_SCHEDULED | ALI_SCHEDULED
+
+
+class ScheduleResolver:
+    """Resolves a schedule expression.
+
+    From CLI args, template, or user input.
+    """
+
+    @classmethod
+    def _get_provider(cls, platform: str) -> type | None:
+        if platform in AWS_PLATFORMS:
+            from dotflow.cloud.aws.schedule import AWSSchedule
+
+            return AWSSchedule
+
+        return None
+
+    @classmethod
+    def resolve(cls, schedule: str | None, platform: str) -> str | None:
+        if platform not in SCHEDULED_PLATFORMS:
+            return schedule
+
+        provider = cls._get_provider(platform)
+
+        if schedule:
+            return provider.convert(schedule) if provider else schedule
+
+        raw = cls._ask_schedule(provider)
+
+        if not raw:
+            raise SystemExit(
+                f"{settings.ERROR_ALERT} --schedule (cron) is required for {platform}"
+            )
+
+        return provider.convert(raw) if provider else raw
+
+    @classmethod
+    def _ask_schedule(cls, provider: type | None) -> str | None:
+        template_schedule = None
+        if provider:
+            template_schedule = provider.read_from_template()
+
+        choices = {}
+        if template_schedule:
+            choices["1"] = f"Use from template.yaml: {template_schedule}"
+        choices["2"] = "Enter cron expression"
+
+        print(settings.QUESTION_ALERT, "Cron schedule is required:")
+        for key, label in choices.items():
+            print(f"  [bold cyan]{key}[/bold cyan] - {label}")
+
+        choice = Prompt.ask("  Select", choices=list(choices.keys()))
+
+        if choice == "1" and template_schedule:
+            print(settings.INFO_ALERT, f"Using cron: {template_schedule}")
+            return template_schedule
+
+        print("  Format: [bold]min hour day month weekday[/bold]")
+        return Prompt.ask("  Cron (e.g. */5 * * * *)") or None
+
+
+class DeployCommand(Command):
+    def setup(self):
+        platform = self.params.platform
+        name = self.params.project
+        region = self.params.region or DEFAULT_REGIONS.get(platform)
+        schedule = ScheduleResolver.resolve(
+            getattr(self.params, "schedule", None), platform
+        )
+
+        method_name = f"_deploy_{platform.replace('-', '_')}"
+        handler = getattr(self, method_name, None)
+        if not handler:
+            print(
+                settings.ERROR_ALERT, f"Deploy not supported for '{platform}'."
+            )
+            return
+
+        handler(name=name, region=region, schedule=schedule)
+
+    def _deploy_lambda(self, name, region, schedule=None):
+        from dotflow.cloud.aws import LambdaDeployer
+
+        LambdaDeployer(region=region).deploy(name, schedule=schedule)
+
+    def _deploy_lambda_scheduled(self, name, region, schedule=None):
+        from dotflow.cloud.aws import LambdaDeployer
+
+        LambdaDeployer(region=region).deploy(name, schedule=schedule)
+
+    def _deploy_lambda_s3_trigger(self, name, region, **kwargs):
+        from dotflow.cloud.aws import LambdaS3Deployer
+
+        LambdaS3Deployer(region=region).deploy(name)
+
+    def _deploy_lambda_sqs_trigger(self, name, region, **kwargs):
+        from dotflow.cloud.aws import LambdaSQSDeployer
+
+        LambdaSQSDeployer(region=region).deploy(name)
+
+    def _deploy_lambda_api_trigger(self, name, region, **kwargs):
+        from dotflow.cloud.aws import LambdaApiDeployer
+
+        LambdaApiDeployer(region=region).deploy(name)
+
+    def _deploy_ecs(self, name, region, **kwargs):
+        from dotflow.cloud.aws import ECSDeployer
+
+        ECSDeployer(region=region).deploy(name)
+
+    def _deploy_ecs_scheduled(self, name, region, schedule=None):
+        from dotflow.cloud.aws import ECSScheduledDeployer
+
+        ECSScheduledDeployer(region=region).deploy(name, schedule=schedule)
+
+    def _deploy_cloud_run(self, name, region, **kwargs):
+        from dotflow.cloud.gcp import CloudRunDeployer
+
+        CloudRunDeployer(region=region).deploy(name)
+
+    def _deploy_cloud_run_scheduled(self, name, region, **kwargs):
+        from dotflow.cloud.gcp import CloudRunDeployer
+
+        CloudRunDeployer(region=region).deploy(name)
+
+    def _deploy_github_actions(self, name, **kwargs):
+        from dotflow.cloud.github import ActionsDeployer
+
+        ActionsDeployer().deploy(name)
+
+    def _deploy_alibaba_fc(self, name, region, **kwargs):
+        from dotflow.cloud.alibaba import AliyunFCDeployer
+
+        AliyunFCDeployer(region=region).deploy(name)
+
+    def _deploy_alibaba_fc_scheduled(self, name, region, schedule=None):
+        from dotflow.cloud.alibaba import (
+            AliyunFCScheduledDeployer,
+        )
+
+        AliyunFCScheduledDeployer(region=region).deploy(
+            name, schedule=schedule
+        )

{dotflow-0.15.0.dev3 → dotflow-0.15.0.dev4}/dotflow/cli/commands/log.py

@@ -14,7 +14,8 @@ class LogCommand(Command):
 
             print(
                 settings.INFO_ALERT,
-                f"To access all logs, open the file ({settings.LOG_PATH.resolve()}).",
+                "To access all logs, open the file"
+                f" ({settings.LOG_PATH.resolve()}).",
             )
         else:
             print(settings.WARNING_ALERT, "Log file not found.")

{dotflow-0.15.0.dev3 → dotflow-0.15.0.dev4}/dotflow/cli/setup.py

@@ -163,7 +163,7 @@ class Command:
         cmd_generate.add_argument(
             "--platform",
             required=True,
-            help="Target platform (e.g. docker, lambda, cloud-run, ecs, kubernetes)",
+            help=("Target platform (e.g. docker, lambda, cloud-run)"),
         )
         cmd_generate.add_argument(
             "--project",
@@ -206,7 +206,7 @@ class Command:
         self.cmd_deploy.add_argument(
             "--schedule",
             default=None,
-            help="Schedule expression (e.g. 'rate(6 hours)')",
+            help="Cron expression (e.g. '*/5 * * * *')",
         )
         self.cmd_deploy.set_defaults(exec=DeployCommand)
 
@@ -233,6 +233,9 @@ class Command:
         except ImportModuleError as err:
             print(settings.WARNING_ALERT, err)
 
+        except KeyboardInterrupt:
+            print("\n", settings.INFO_ALERT, "Aborted.")
+
         except Exception as err:
             logger.error(f"Internal problem: {str(err)}")
             print(settings.ERROR_ALERT, MESSAGE_UNKNOWN_ERROR)

dotflow-0.15.0.dev4/dotflow/cloud/alibaba/__init__.py

@@ -0,0 +1,11 @@
+"""Alibaba Cloud module."""
+
+from dotflow.cloud.alibaba.deployers import (
+    AliyunFCDeployer,
+    AliyunFCScheduledDeployer,
+)
+
+__all__ = [
+    "AliyunFCDeployer",
+    "AliyunFCScheduledDeployer",
+]

dotflow-0.15.0.dev4/dotflow/cloud/alibaba/constants.py

@@ -0,0 +1,22 @@
+"""Alibaba Cloud constants."""
+
+SDK_NOT_FOUND = (
+    "alibabacloud-fc-open20210406 is required: "
+    "pip install dotflow[deploy-alibaba]"
+)
+
+CREDENTIALS_NOT_FOUND = (
+    "Alibaba Cloud credentials not found. "
+    "Run 'aliyun configure' or set "
+    "ALIBABA_CLOUD_ACCESS_KEY_ID and "
+    "ALIBABA_CLOUD_ACCESS_KEY_SECRET."
+)
+
+PLATFORMS = {
+    "alibaba-fc",
+    "alibaba-fc-scheduled",
+}
+
+SCHEDULED_PLATFORMS = {"alibaba-fc-scheduled"}
+
+DEFAULT_REGION = "cn-hangzhou"