dotflow 0.12.0.dev3__tar.gz → 0.13.0.dev2__tar.gz

{dotflow-0.12.0.dev3 → dotflow-0.13.0.dev2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: dotflow
-Version: 0.12.0.dev3
+Version: 0.13.0.dev2
 Summary: 🎲 Dotflow turns an idea into flow!
 License: MIT License
          
@@ -34,9 +34,11 @@ Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Provides-Extra: mongodb
 Requires-Dist: dotflow-mongodb ; extra == "mongodb"
 Requires-Dist: pydantic
+Requires-Dist: requests
 Requires-Dist: rich
 Requires-Dist: typing-extensions
 Project-URL: Documentation, https://github.com/dotflow-io/dotflow/blob/master/README.md
@@ -143,7 +145,7 @@ def my_callback(*args, **kwargs):
 def my_task_x():
     print("task")
 
-@action(retry=5)
+@action
 def my_task_y():
     print("task")
 
@@ -157,7 +159,7 @@ workflow.start()
 
 ## First Steps
 
-#### Import
+#### 1. Import
 
 Start with the basics, which is importing the necessary classes and methods. ([DotFlow](https://dotflow-io.github.io/dotflow/nav/reference/dotflow/), [action](https://dotflow-io.github.io/dotflow/nav/reference/action/))
 
@@ -165,7 +167,7 @@ Start with the basics, which is importing the necessary classes and methods. ([D
 from dotflow import DotFlow, action
 ```
 
-#### Callback function
+#### 2. Callback function
 
 Create a `my_callback` function to receive execution information of a task. `It is not necessary` to include this function, as you will still have a report at the end of the execution in the instantiated object of the `DotFlow` class. This `my_callback` function is only needed if you need to do something after the execution of the task, for example: sending a message to someone, making a phone call, or sending a letter. [More details](https://dotflow-io.github.io/dotflow/nav/reference/utils/#dotflow.utils.basic_functions.basic_callback)
 
@@ -174,17 +176,17 @@ def my_callback(*args, **kwargs):
     print(args, kwargs)
 ```
 
-#### Task function
+#### 3. Task function
 
-Now, create the function responsible for executing your task. It's very simple; just use the [action](https://dotflow-io.github.io/dotflow/nav/reference/action/) decorator above the function, and that's it—you've created a task. If necessary, you can also add the parameter called `retry` to set the maximum number of execution attempts if the function fails. [More details](https://dotflow-io.github.io/dotflow/nav/reference/utils/#dotflow.utils.basic_functions.basic_function)
+Now, create the function responsible for executing your task. It's very simple; just use the [action](https://dotflow-io.github.io/dotflow/nav/reference/action/) decorator above the function, and that's it—you've created a task.
 
 ```python
-@action(retry=5)
+@action
 def my_task_x():
     print("task")
 ```
 
-#### DotFlow Class
+#### 4. DotFlow Class
 
 Instantiate the DotFlow class in a `workflow` variable to be used in the following steps. [More details](https://dotflow-io.github.io/dotflow/nav/reference/dotflow/).
 
@@ -192,7 +194,7 @@ Instantiate the DotFlow class in a `workflow` variable to be used in the followi
 workflow = DotFlow()
 ```
 
-#### Add Task
+#### 5. Add Task
 
 Now, simply add the `my_task_x` and `my_callback` functions you created earlier to the workflow using the code below. This process is necessary to define which tasks will be executed and the order in which they will run. The execution order follows the sequence in which they were added to the workflow. [More details](https://dotflow-io.github.io/dotflow/nav/reference/task-builder/#dotflow.core.task.TaskBuilder.add)
 
@@ -215,7 +217,7 @@ workflow.task.add(step=[my_task_x, my_task_y], callback=my_callback)
 workflow.task.add(step="module.task.my_task_x", callback=my_callback)
 ```
 
-#### Start
+#### 6. Start
 
 Finally, just execute the workflow with the following code snippet. [More details](https://dotflow-io.github.io/dotflow/nav/reference/workflow/#dotflow.core.workflow.Manager)
 
@@ -357,37 +359,43 @@ flowchart TD
 
 ## More Examples
 
-| Example                                                                                                                          | Command                                                                                                        |
-| -------------------------------------------------------------------------------------------------------------------------------- |----------------------------------------------------------------------------------------------------------------|
-| [cli_with_callback](https://github.com/dotflow-io/examples/blob/master/cli_with_callback.py)                                     | `dotflow start --step examples.cli_with_callback.simple_step --callback examples.cli_with_callback.callback`   |
-| [cli_with_initial_context](https://github.com/dotflow-io/examples/blob/master/cli_with_initial_context.py)                       | `dotflow start --step examples.cli_with_initial_context.simple_step --initial-context abc`                     |
-| [cli_with_mode](https://github.com/dotflow-io/examples/blob/master/cli_with_mode.py)                                             | `dotflow start --step examples.cli_with_mode.simple_step --mode sequential`                                    |
-| [cli_with_output_context](https://github.com/dotflow-io/examples/blob/master/cli_with_output_context.py)                         | `dotflow start --step examples.cli_with_output_context.simple_step --storage file`                             |
-| [cli_with_path](https://github.com/dotflow-io/examples/blob/master/cli_with_path.py)                                             | `dotflow start --step examples.cli_with_path.simple_step --path .storage --storage file`                       |
-| [simple_cli](https://github.com/dotflow-io/examples/blob/master/simple_cli.py)                                                   | `dotflow start --step examples.simple_cli.simple_step`                                                         |
-| [simple_class_workflow](https://github.com/dotflow-io/examples/blob/master/simple_class_workflow.py)                             | `python examples/simple_class_workflow.py`                                                                     |
-| [simple_function_workflow_with_error](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow_with_error.py) | `python examples/simple_function_workflow_with_error.py`                                                       |
-| [simple_function_workflow](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow.py)                       | `python examples/simple_function_workflow.py`                                                                  |
-| [step_class_result_context](https://github.com/dotflow-io/examples/blob/master/step_class_result_context.py)                     | `python examples/step_class_result_context.py`                                                                 |
-| [step_class_result_storage](https://github.com/dotflow-io/examples/blob/master/step_class_result_storage.py)                     | `python examples/step_class_result_storage.py`                                                                 |
-| [step_class_result_task](https://github.com/dotflow-io/examples/blob/master/step_class_result_task.py)                           | `python examples/step_class_result_task.py`                                                                    |
-| [step_function_result_context](https://github.com/dotflow-io/examples/blob/master/step_function_result_context.py)               | `python examples/step_function_result_context.py`                                                              |
-| [step_function_result_storage](https://github.com/dotflow-io/examples/blob/master/step_function_result_storage.py)               | `python examples/step_function_result_storage.py`                                                              |
-| [step_function_result_task](https://github.com/dotflow-io/examples/blob/master/step_function_result_task.py)                     | `python examples/step_function_result_task.py`                                                                 |
-| [step_with_initial_context](https://github.com/dotflow-io/examples/blob/master/step_with_initial_context.py)                     | `python examples/step_with_initial_context.py`                                                                 |
-| [step_with_many_contexts](https://github.com/dotflow-io/examples/blob/master/step_with_many_contexts.py)                         | `python examples/step_with_many_contexts.py`                                                                   |
-| [step_with_previous_context](https://github.com/dotflow-io/examples/blob/master/step_with_previous_context.py)                   | `python examples/step_with_previous_context.py`                                                                |
-| [workflow_keep_going_true](https://github.com/dotflow-io/examples/blob/master/workflow_keep_going_true.py)                       | `python examples/workflow_keep_going_true.py`                                                                  |
-| [workflow_step_callback](https://github.com/dotflow-io/examples/blob/master/workflow_step_callback.py)                           | `python examples/workflow_step_callback.py`                                                                    |
-| [workflow_with_callback_failure](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_failure.py)           | `python examples/workflow_with_callback_failure.py`                                                            |
-| [workflow_with_callback_success](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_success.py)           | `python examples/workflow_with_callback_success.py`                                                            |
-| [workflow_with_retry](https://github.com/dotflow-io/examples/blob/master/workflow_with_retry.py)                                 | `python examples/workflow_with_retry.py`                                                                       |
-| [step_with_groups](https://github.com/dotflow-io/examples/blob/master/step_with_groups.py)                                       | `python examples/step_with_groups.py`                                                                          |
-| [workflow_background_mode](https://github.com/dotflow-io/examples/blob/master/workflow_background_mode.py)                       | `python examples/workflow_background_mode.py`                                                                  |
-| [workflow_parallel_mode](https://github.com/dotflow-io/examples/blob/master/workflow_parallel_mode.py)                           | `python examples/workflow_parallel_mode.py`                                                                    |
-| [workflow_sequential_group_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_group_mode.py)           | `python examples/workflow_sequential_group_mode.py`                                                            |
-| [workflow_sequential_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_mode.py)                       | `python examples/workflow_sequential_mode.py`                                                                  |
-
+| Example | Command |
+| ------- | ------- |
+| [cli_with_callback](https://github.com/dotflow-io/examples/blob/master/cli_with_callback.py) | `dotflow start --step examples.cli_with_callback.simple_step --callback examples.cli_with_callback.callback` |
+| [cli_with_initial_context](https://github.com/dotflow-io/examples/blob/master/cli_with_initial_context.py) | `dotflow start --step examples.cli_with_initial_context.simple_step --initial-context abc` |
+| [cli_with_mode](https://github.com/dotflow-io/examples/blob/master/cli_with_mode.py) | `dotflow start --step examples.cli_with_mode.simple_step --mode sequential` |
+| [cli_with_output_context](https://github.com/dotflow-io/examples/blob/master/cli_with_output_context.py) | `dotflow start --step examples.cli_with_output_context.simple_step --storage file` |
+| [cli_with_path](https://github.com/dotflow-io/examples/blob/master/cli_with_path.py) | `dotflow start --step examples.cli_with_path.simple_step --path .storage --storage file` |
+| [flow](https://github.com/dotflow-io/examples/blob/master/flow.py) | `python examples/flow.py` |
+| [simple_class_workflow](https://github.com/dotflow-io/examples/blob/master/simple_class_workflow.py) | `python examples/simple_class_workflow.py` |
+| [simple_cli](https://github.com/dotflow-io/examples/blob/master/simple_cli.py) | `dotflow start --step examples.simple_cli.simple_step` |
+| [simple_function_workflow](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow.py) | `python examples/simple_function_workflow.py` |
+| [simple_function_workflow_with_error](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow_with_error.py) | `python examples/simple_function_workflow_with_error.py` |
+| [step_class_result_context](https://github.com/dotflow-io/examples/blob/master/step_class_result_context.py) | `python examples/step_class_result_context.py` |
+| [step_class_result_storage](https://github.com/dotflow-io/examples/blob/master/step_class_result_storage.py) | `python examples/step_class_result_storage.py` |
+| [step_class_result_task](https://github.com/dotflow-io/examples/blob/master/step_class_result_task.py) | `python examples/step_class_result_task.py` |
+| [step_function_result_context](https://github.com/dotflow-io/examples/blob/master/step_function_result_context.py) | `python examples/step_function_result_context.py` |
+| [step_function_result_storage](https://github.com/dotflow-io/examples/blob/master/step_function_result_storage.py) | `python examples/step_function_result_storage.py` |
+| [step_function_result_task](https://github.com/dotflow-io/examples/blob/master/step_function_result_task.py) | `python examples/step_function_result_task.py` |
+| [step_with_groups](https://github.com/dotflow-io/examples/blob/master/step_with_groups.py) | `python examples/step_with_groups.py` |
+| [step_with_initial_context](https://github.com/dotflow-io/examples/blob/master/step_with_initial_context.py) | `python examples/step_with_initial_context.py` |
+| [step_with_many_contexts](https://github.com/dotflow-io/examples/blob/master/step_with_many_contexts.py) | `python examples/step_with_many_contexts.py` |
+| [step_with_notify_telegram](https://github.com/dotflow-io/examples/blob/master/step_with_notify_telegram.py) | `python examples/step_with_notify_telegram.py` |
+| [step_with_previous_context](https://github.com/dotflow-io/examples/blob/master/step_with_previous_context.py) | `python examples/step_with_previous_context.py` |
+| [step_with_storage_file](https://github.com/dotflow-io/examples/blob/master/step_with_storage_file.py) | `python examples/step_with_storage_file.py` |
+| [step_with_storage_mongodb](https://github.com/dotflow-io/examples/blob/master/step_with_storage_mongodb.py) | `python examples/step_with_storage_mongodb.py` |
+| [workflow_background_mode](https://github.com/dotflow-io/examples/blob/master/workflow_background_mode.py) | `python examples/workflow_background_mode.py` |
+| [workflow_keep_going_true](https://github.com/dotflow-io/examples/blob/master/workflow_keep_going_true.py) | `python examples/workflow_keep_going_true.py` |
+| [workflow_parallel_mode](https://github.com/dotflow-io/examples/blob/master/workflow_parallel_mode.py) | `python examples/workflow_parallel_mode.py` |
+| [workflow_sequential_group_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_group_mode.py) | `python examples/workflow_sequential_group_mode.py` |
+| [workflow_sequential_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_mode.py) | `python examples/workflow_sequential_mode.py` |
+| [workflow_step_callback](https://github.com/dotflow-io/examples/blob/master/workflow_step_callback.py) | `python examples/workflow_step_callback.py` |
+| [workflow_with_backoff](https://github.com/dotflow-io/examples/blob/master/workflow_with_backoff.py) | `python examples/workflow_with_backoff.py` |
+| [workflow_with_callback_failure](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_failure.py) | `python examples/workflow_with_callback_failure.py` |
+| [workflow_with_callback_success](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_success.py) | `python examples/workflow_with_callback_success.py` |
+| [workflow_with_retry](https://github.com/dotflow-io/examples/blob/master/workflow_with_retry.py) | `python examples/workflow_with_retry.py` |
+| [workflow_with_retry_delay](https://github.com/dotflow-io/examples/blob/master/workflow_with_retry_delay.py) | `python examples/workflow_with_retry_delay.py` |
+| [workflow_with_timeout](https://github.com/dotflow-io/examples/blob/master/workflow_with_timeout.py) | `python examples/workflow_with_timeout.py` |
 
 ## Commit Style
 

{dotflow-0.12.0.dev3 → dotflow-0.13.0.dev2}/README.md

@@ -96,7 +96,7 @@ def my_callback(*args, **kwargs):
 def my_task_x():
     print("task")
 
-@action(retry=5)
+@action
 def my_task_y():
     print("task")
 
@@ -110,7 +110,7 @@ workflow.start()
 
 ## First Steps
 
-#### Import
+#### 1. Import
 
 Start with the basics, which is importing the necessary classes and methods. ([DotFlow](https://dotflow-io.github.io/dotflow/nav/reference/dotflow/), [action](https://dotflow-io.github.io/dotflow/nav/reference/action/))
 
@@ -118,7 +118,7 @@ Start with the basics, which is importing the necessary classes and methods. ([D
 from dotflow import DotFlow, action
 ```
 
-#### Callback function
+#### 2. Callback function
 
 Create a `my_callback` function to receive execution information of a task. `It is not necessary` to include this function, as you will still have a report at the end of the execution in the instantiated object of the `DotFlow` class. This `my_callback` function is only needed if you need to do something after the execution of the task, for example: sending a message to someone, making a phone call, or sending a letter. [More details](https://dotflow-io.github.io/dotflow/nav/reference/utils/#dotflow.utils.basic_functions.basic_callback)
 
@@ -127,17 +127,17 @@ def my_callback(*args, **kwargs):
     print(args, kwargs)
 ```
 
-#### Task function
+#### 3. Task function
 
-Now, create the function responsible for executing your task. It's very simple; just use the [action](https://dotflow-io.github.io/dotflow/nav/reference/action/) decorator above the function, and that's it—you've created a task. If necessary, you can also add the parameter called `retry` to set the maximum number of execution attempts if the function fails. [More details](https://dotflow-io.github.io/dotflow/nav/reference/utils/#dotflow.utils.basic_functions.basic_function)
+Now, create the function responsible for executing your task. It's very simple; just use the [action](https://dotflow-io.github.io/dotflow/nav/reference/action/) decorator above the function, and that's it—you've created a task.
 
 ```python
-@action(retry=5)
+@action
 def my_task_x():
     print("task")
 ```
 
-#### DotFlow Class
+#### 4. DotFlow Class
 
 Instantiate the DotFlow class in a `workflow` variable to be used in the following steps. [More details](https://dotflow-io.github.io/dotflow/nav/reference/dotflow/).
 
@@ -145,7 +145,7 @@ Instantiate the DotFlow class in a `workflow` variable to be used in the followi
 workflow = DotFlow()
 ```
 
-#### Add Task
+#### 5. Add Task
 
 Now, simply add the `my_task_x` and `my_callback` functions you created earlier to the workflow using the code below. This process is necessary to define which tasks will be executed and the order in which they will run. The execution order follows the sequence in which they were added to the workflow. [More details](https://dotflow-io.github.io/dotflow/nav/reference/task-builder/#dotflow.core.task.TaskBuilder.add)
 
@@ -168,7 +168,7 @@ workflow.task.add(step=[my_task_x, my_task_y], callback=my_callback)
 workflow.task.add(step="module.task.my_task_x", callback=my_callback)
 ```
 
-#### Start
+#### 6. Start
 
 Finally, just execute the workflow with the following code snippet. [More details](https://dotflow-io.github.io/dotflow/nav/reference/workflow/#dotflow.core.workflow.Manager)
 
@@ -310,37 +310,43 @@ flowchart TD
 
 ## More Examples
 
-| Example                                                                                                                          | Command                                                                                                        |
-| -------------------------------------------------------------------------------------------------------------------------------- |----------------------------------------------------------------------------------------------------------------|
-| [cli_with_callback](https://github.com/dotflow-io/examples/blob/master/cli_with_callback.py)                                     | `dotflow start --step examples.cli_with_callback.simple_step --callback examples.cli_with_callback.callback`   |
-| [cli_with_initial_context](https://github.com/dotflow-io/examples/blob/master/cli_with_initial_context.py)                       | `dotflow start --step examples.cli_with_initial_context.simple_step --initial-context abc`                     |
-| [cli_with_mode](https://github.com/dotflow-io/examples/blob/master/cli_with_mode.py)                                             | `dotflow start --step examples.cli_with_mode.simple_step --mode sequential`                                    |
-| [cli_with_output_context](https://github.com/dotflow-io/examples/blob/master/cli_with_output_context.py)                         | `dotflow start --step examples.cli_with_output_context.simple_step --storage file`                             |
-| [cli_with_path](https://github.com/dotflow-io/examples/blob/master/cli_with_path.py)                                             | `dotflow start --step examples.cli_with_path.simple_step --path .storage --storage file`                       |
-| [simple_cli](https://github.com/dotflow-io/examples/blob/master/simple_cli.py)                                                   | `dotflow start --step examples.simple_cli.simple_step`                                                         |
-| [simple_class_workflow](https://github.com/dotflow-io/examples/blob/master/simple_class_workflow.py)                             | `python examples/simple_class_workflow.py`                                                                     |
-| [simple_function_workflow_with_error](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow_with_error.py) | `python examples/simple_function_workflow_with_error.py`                                                       |
-| [simple_function_workflow](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow.py)                       | `python examples/simple_function_workflow.py`                                                                  |
-| [step_class_result_context](https://github.com/dotflow-io/examples/blob/master/step_class_result_context.py)                     | `python examples/step_class_result_context.py`                                                                 |
-| [step_class_result_storage](https://github.com/dotflow-io/examples/blob/master/step_class_result_storage.py)                     | `python examples/step_class_result_storage.py`                                                                 |
-| [step_class_result_task](https://github.com/dotflow-io/examples/blob/master/step_class_result_task.py)                           | `python examples/step_class_result_task.py`                                                                    |
-| [step_function_result_context](https://github.com/dotflow-io/examples/blob/master/step_function_result_context.py)               | `python examples/step_function_result_context.py`                                                              |
-| [step_function_result_storage](https://github.com/dotflow-io/examples/blob/master/step_function_result_storage.py)               | `python examples/step_function_result_storage.py`                                                              |
-| [step_function_result_task](https://github.com/dotflow-io/examples/blob/master/step_function_result_task.py)                     | `python examples/step_function_result_task.py`                                                                 |
-| [step_with_initial_context](https://github.com/dotflow-io/examples/blob/master/step_with_initial_context.py)                     | `python examples/step_with_initial_context.py`                                                                 |
-| [step_with_many_contexts](https://github.com/dotflow-io/examples/blob/master/step_with_many_contexts.py)                         | `python examples/step_with_many_contexts.py`                                                                   |
-| [step_with_previous_context](https://github.com/dotflow-io/examples/blob/master/step_with_previous_context.py)                   | `python examples/step_with_previous_context.py`                                                                |
-| [workflow_keep_going_true](https://github.com/dotflow-io/examples/blob/master/workflow_keep_going_true.py)                       | `python examples/workflow_keep_going_true.py`                                                                  |
-| [workflow_step_callback](https://github.com/dotflow-io/examples/blob/master/workflow_step_callback.py)                           | `python examples/workflow_step_callback.py`                                                                    |
-| [workflow_with_callback_failure](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_failure.py)           | `python examples/workflow_with_callback_failure.py`                                                            |
-| [workflow_with_callback_success](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_success.py)           | `python examples/workflow_with_callback_success.py`                                                            |
-| [workflow_with_retry](https://github.com/dotflow-io/examples/blob/master/workflow_with_retry.py)                                 | `python examples/workflow_with_retry.py`                                                                       |
-| [step_with_groups](https://github.com/dotflow-io/examples/blob/master/step_with_groups.py)                                       | `python examples/step_with_groups.py`                                                                          |
-| [workflow_background_mode](https://github.com/dotflow-io/examples/blob/master/workflow_background_mode.py)                       | `python examples/workflow_background_mode.py`                                                                  |
-| [workflow_parallel_mode](https://github.com/dotflow-io/examples/blob/master/workflow_parallel_mode.py)                           | `python examples/workflow_parallel_mode.py`                                                                    |
-| [workflow_sequential_group_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_group_mode.py)           | `python examples/workflow_sequential_group_mode.py`                                                            |
-| [workflow_sequential_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_mode.py)                       | `python examples/workflow_sequential_mode.py`                                                                  |
-
+| Example | Command |
+| ------- | ------- |
+| [cli_with_callback](https://github.com/dotflow-io/examples/blob/master/cli_with_callback.py) | `dotflow start --step examples.cli_with_callback.simple_step --callback examples.cli_with_callback.callback` |
+| [cli_with_initial_context](https://github.com/dotflow-io/examples/blob/master/cli_with_initial_context.py) | `dotflow start --step examples.cli_with_initial_context.simple_step --initial-context abc` |
+| [cli_with_mode](https://github.com/dotflow-io/examples/blob/master/cli_with_mode.py) | `dotflow start --step examples.cli_with_mode.simple_step --mode sequential` |
+| [cli_with_output_context](https://github.com/dotflow-io/examples/blob/master/cli_with_output_context.py) | `dotflow start --step examples.cli_with_output_context.simple_step --storage file` |
+| [cli_with_path](https://github.com/dotflow-io/examples/blob/master/cli_with_path.py) | `dotflow start --step examples.cli_with_path.simple_step --path .storage --storage file` |
+| [flow](https://github.com/dotflow-io/examples/blob/master/flow.py) | `python examples/flow.py` |
+| [simple_class_workflow](https://github.com/dotflow-io/examples/blob/master/simple_class_workflow.py) | `python examples/simple_class_workflow.py` |
+| [simple_cli](https://github.com/dotflow-io/examples/blob/master/simple_cli.py) | `dotflow start --step examples.simple_cli.simple_step` |
+| [simple_function_workflow](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow.py) | `python examples/simple_function_workflow.py` |
+| [simple_function_workflow_with_error](https://github.com/dotflow-io/examples/blob/master/simple_function_workflow_with_error.py) | `python examples/simple_function_workflow_with_error.py` |
+| [step_class_result_context](https://github.com/dotflow-io/examples/blob/master/step_class_result_context.py) | `python examples/step_class_result_context.py` |
+| [step_class_result_storage](https://github.com/dotflow-io/examples/blob/master/step_class_result_storage.py) | `python examples/step_class_result_storage.py` |
+| [step_class_result_task](https://github.com/dotflow-io/examples/blob/master/step_class_result_task.py) | `python examples/step_class_result_task.py` |
+| [step_function_result_context](https://github.com/dotflow-io/examples/blob/master/step_function_result_context.py) | `python examples/step_function_result_context.py` |
+| [step_function_result_storage](https://github.com/dotflow-io/examples/blob/master/step_function_result_storage.py) | `python examples/step_function_result_storage.py` |
+| [step_function_result_task](https://github.com/dotflow-io/examples/blob/master/step_function_result_task.py) | `python examples/step_function_result_task.py` |
+| [step_with_groups](https://github.com/dotflow-io/examples/blob/master/step_with_groups.py) | `python examples/step_with_groups.py` |
+| [step_with_initial_context](https://github.com/dotflow-io/examples/blob/master/step_with_initial_context.py) | `python examples/step_with_initial_context.py` |
+| [step_with_many_contexts](https://github.com/dotflow-io/examples/blob/master/step_with_many_contexts.py) | `python examples/step_with_many_contexts.py` |
+| [step_with_notify_telegram](https://github.com/dotflow-io/examples/blob/master/step_with_notify_telegram.py) | `python examples/step_with_notify_telegram.py` |
+| [step_with_previous_context](https://github.com/dotflow-io/examples/blob/master/step_with_previous_context.py) | `python examples/step_with_previous_context.py` |
+| [step_with_storage_file](https://github.com/dotflow-io/examples/blob/master/step_with_storage_file.py) | `python examples/step_with_storage_file.py` |
+| [step_with_storage_mongodb](https://github.com/dotflow-io/examples/blob/master/step_with_storage_mongodb.py) | `python examples/step_with_storage_mongodb.py` |
+| [workflow_background_mode](https://github.com/dotflow-io/examples/blob/master/workflow_background_mode.py) | `python examples/workflow_background_mode.py` |
+| [workflow_keep_going_true](https://github.com/dotflow-io/examples/blob/master/workflow_keep_going_true.py) | `python examples/workflow_keep_going_true.py` |
+| [workflow_parallel_mode](https://github.com/dotflow-io/examples/blob/master/workflow_parallel_mode.py) | `python examples/workflow_parallel_mode.py` |
+| [workflow_sequential_group_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_group_mode.py) | `python examples/workflow_sequential_group_mode.py` |
+| [workflow_sequential_mode](https://github.com/dotflow-io/examples/blob/master/workflow_sequential_mode.py) | `python examples/workflow_sequential_mode.py` |
+| [workflow_step_callback](https://github.com/dotflow-io/examples/blob/master/workflow_step_callback.py) | `python examples/workflow_step_callback.py` |
+| [workflow_with_backoff](https://github.com/dotflow-io/examples/blob/master/workflow_with_backoff.py) | `python examples/workflow_with_backoff.py` |
+| [workflow_with_callback_failure](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_failure.py) | `python examples/workflow_with_callback_failure.py` |
+| [workflow_with_callback_success](https://github.com/dotflow-io/examples/blob/master/workflow_with_callback_success.py) | `python examples/workflow_with_callback_success.py` |
+| [workflow_with_retry](https://github.com/dotflow-io/examples/blob/master/workflow_with_retry.py) | `python examples/workflow_with_retry.py` |
+| [workflow_with_retry_delay](https://github.com/dotflow-io/examples/blob/master/workflow_with_retry_delay.py) | `python examples/workflow_with_retry_delay.py` |
+| [workflow_with_timeout](https://github.com/dotflow-io/examples/blob/master/workflow_with_timeout.py) | `python examples/workflow_with_timeout.py` |
 
 ## Commit Style
 

{dotflow-0.12.0.dev3 → dotflow-0.13.0.dev2}/dotflow/__init__.py

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

{dotflow-0.12.0.dev3 → dotflow-0.13.0.dev2}/dotflow/abc/flow.py

@@ -34,7 +34,7 @@ class Flow(ABC):
         return self.queue
 
     @abstractmethod
-    def _internal_callback(self, task: Task) -> None:
+    def _flow_callback(self, task: Task) -> None:
         self.queue.append(task)
 
     @abstractmethod

dotflow-0.13.0.dev2/dotflow/abc/log.py

@@ -0,0 +1,17 @@
+"""Notify ABC"""
+
+from typing import Any
+
+from abc import ABC, abstractmethod
+
+
+class Log(ABC):
+    """Log"""
+
+    @abstractmethod
+    def info(self, task: Any) -> None:
+        """Info"""
+
+    @abstractmethod
+    def error(self, task: Any) -> None:
+        """Error"""

dotflow-0.13.0.dev2/dotflow/abc/notify.py

@@ -0,0 +1,13 @@
+"""Notify ABC"""
+
+from typing import Any
+
+from abc import ABC, abstractmethod
+
+
+class Notify(ABC):
+    """Notify"""
+
+    @abstractmethod
+    def send(self, task: Any) -> None:
+        """Send"""

dotflow-0.13.0.dev2/dotflow/core/action.py

@@ -0,0 +1,185 @@
+"""Action module"""
+
+from time import sleep
+
+from concurrent.futures import ThreadPoolExecutor
+from typing import Callable, Dict
+from types import FunctionType
+
+from dotflow.core.exception import ExecutionWithClassError
+from dotflow.core.context import Context
+
+
+def is_execution_with_class_internal_error(error: Exception) -> bool:
+    message = str(error)
+    patterns = [
+        "initial_context",
+        "previous_context",
+        "missing 1 required positional argument: 'self'",
+    ]
+    return any(pattern in message for pattern in patterns)
+
+
+class Action(object):
+    """
+    Import:
+        You can import the **action** decorator directly from dotflow:
+
+            from dotflow import action
+
+    Example:
+        `class` dotflow.core.action.Action
+
+        Standard
+
+            @action
+            def my_task():
+                print("task")
+
+        With Retry
+
+            @action(retry=5)
+            def my_task():
+                print("task")
+
+
+        With Timeout
+
+            @action(timeout=60)
+            def my_task():
+                print("task")
+
+        With Retry delay
+
+            @action(retry=5, retry_delay=5)
+            def my_task():
+                print("task")
+
+        With Backoff
+
+            @action(retry=5, backoff=True)
+            def my_task():
+                print("task")
+
+    Args:
+        func (Callable):
+
+        task (Callable):
+
+        retry (int): Number of task retries on on_failure.
+
+        timeout (int): Execution timeout for a task. Duration (in seconds)
+
+        retry_delay (int): Retry delay on task on_failure. Duration (in seconds)
+
+        backoff (int): Exponential backoff
+
+    """
+
+    def __init__(
+        self,
+        func: Callable = None,
+        task: Callable = None,
+        retry: int = 1,
+        timeout: int = 0,
+        retry_delay: int = 1,
+        backoff: bool = False,
+    ) -> None:
+        self.func = func
+        self.task = task
+        self.retry = retry
+        self.timeout = timeout
+        self.retry_delay = retry_delay
+        self.backoff = backoff
+        self.params = []
+
+    def __call__(self, *args, **kwargs):
+        # With parameters
+        if self.func:
+            self._set_params()
+
+            task = self._get_task(kwargs=kwargs)
+            contexts = self._get_context(kwargs=kwargs)
+
+            if contexts:
+                return Context(
+                    storage=self._run_action(*args, **contexts),
+                    task_id=task.task_id,
+                    workflow_id=task.workflow_id,
+                )
+
+            return Context(
+                storage=self._run_action(*args),
+                task_id=task.task_id,
+                workflow_id=task.workflow_id,
+            )
+
+        # No parameters
+        def action(*_args, **_kwargs):
+            self.func = args[0]
+            self._set_params()
+
+            task = self._get_task(kwargs=_kwargs)
+            contexts = self._get_context(kwargs=_kwargs)
+
+            if contexts:
+                return Context(
+                    storage=self._run_action(*_args, **contexts),
+                    task_id=task.task_id,
+                    workflow_id=task.workflow_id,
+                )
+
+            return Context(
+                storage=self._run_action(*_args),
+                task_id=task.task_id,
+                workflow_id=task.workflow_id,
+            )
+
+        return action
+
+    def _run_action(self, *args, **kwargs):
+        for attempt in range(1, self.retry + 1):
+            try:
+                if self.timeout:
+                    with ThreadPoolExecutor(max_workers=1) as executor:
+                        future = executor.submit(self.func, *args, **kwargs)
+                        return future.result(timeout=self.timeout)
+
+                return self.func(*args, **kwargs)
+
+            except Exception as error:
+                last_exception = error
+
+                if is_execution_with_class_internal_error(error=last_exception):
+                    raise ExecutionWithClassError()
+
+                if attempt == self.retry:
+                    raise last_exception
+
+                sleep(self.retry_delay)
+                if self.backoff:
+                    self.retry_delay *= 2
+
+    def _set_params(self):
+        if isinstance(self.func, FunctionType):
+            self.params = [param for param in self.func.__code__.co_varnames]
+
+        if type(self.func) is type:
+            if hasattr(self.func, "__init__"):
+                if hasattr(self.func.__init__, "__code__"):
+                    self.params = [
+                        param for param in self.func.__init__.__code__.co_varnames
+                    ]
+
+    def _get_context(self, kwargs: Dict):
+        context = {}
+        if "initial_context" in self.params:
+            context["initial_context"] = Context(kwargs.get("initial_context"))
+
+        if "previous_context" in self.params:
+            context["previous_context"] = Context(kwargs.get("previous_context"))
+
+        return context
+
+    def _get_task(self, kwargs: Dict):
+        return kwargs.get("task")

dotflow-0.13.0.dev2/dotflow/core/config.py

@@ -0,0 +1,55 @@
+"""Config module"""
+
+from typing import Optional
+
+from dotflow.abc.log import Log
+from dotflow.abc.storage import Storage
+from dotflow.abc.notify import Notify
+
+from dotflow.providers.log_default import LogDefault
+from dotflow.providers.storage_default import StorageDefault
+from dotflow.providers.notify_default import NotifyDefault
+
+
+class Config:
+    """
+    Import:
+        You can import the **Config** class with:
+
+            from dotflow import Config
+
+            from dotflow.providers import (
+                StorageDefault,
+                NotifyDefault,
+                LogDefault
+            )
+
+    Example:
+        `class` dotflow.core.config.Config
+
+            config = Config(
+                storage=StorageFile(path=".output"),
+                notify=NotifyDefault(),
+                log=LogDefault()
+            )
+
+    Args:
+        storage (Optional[Storage]): Type of the storage.
+        notify (Optional[Notify]): Type of the notify.
+        log (Optional[Log]): Type of the notify.
+
+    Attributes:
+        storage (Optional[Storage]):
+        notify (Optional[Notify]):
+        log (Optional[Log]):
+    """
+
+    def __init__(
+        self,
+        storage: Optional[Storage] = StorageDefault(),
+        notify: Optional[Notify] = NotifyDefault(),
+        log: Optional[Log] = LogDefault(),
+    ) -> None:
+        self.storage = storage
+        self.notify = notify
+        self.log = log