automizor 0.4.10__py3-none-any.whl → 0.4.11__py3-none-any.whl

automizor/__init__.py

@@ -1 +1 @@
-version = "0.4.10"
+version = "0.4.11"

automizor/datastore/_datastore.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 import requests
 
 from automizor.exceptions import AutomizorError
@@ -17,12 +19,12 @@ class DataStore:
 
     _instance = None
 
-    def __init__(self, api_token: str | None = None):
+    def __init__(self, api_token: Optional[str] = None):
         self.url, self.token = get_api_config(api_token)
         self.headers = get_headers(self.token)
 
     @classmethod
-    def configure(cls, api_token: str | None = None):
+    def configure(cls, api_token: Optional[str] = None):
         cls._instance = cls(api_token)
 
     @classmethod
@@ -34,8 +36,8 @@ class DataStore:
     def get_values(
         self,
         name: str,
-        primary_key: str | None = None,
-        secondary_key: str | None = None,
+        primary_key: Optional[str] = None,
+        secondary_key: Optional[str] = None,
     ) -> JSON:
         """
         Retrieves values from the specified data store.
@@ -65,8 +67,8 @@ class DataStore:
     def _get_values(
         self,
         name: str,
-        primary_key: str | None = None,
-        secondary_key: str | None = None,
+        primary_key: Optional[str] = None,
+        secondary_key: Optional[str] = None,
     ) -> JSON:
         params = (
             {"primary_key": primary_key, "secondary_key": secondary_key}

automizor/job/_job.py

@@ -1,5 +1,6 @@
 import json
 import os
+from typing import Optional
 
 import requests
 
@@ -48,7 +49,7 @@ class Job:
 
     _instance = None
 
-    def __init__(self, api_token: str | None = None):
+    def __init__(self, api_token: Optional[str] = None):
         self._context_file = os.getenv("AUTOMIZOR_CONTEXT_FILE", None)
         self._job_id = os.getenv("AUTOMIZOR_JOB_ID", None)
 
@@ -56,7 +57,7 @@ class Job:
         self.headers = get_headers(self.token)
 
     @classmethod
-    def configure(cls, api_token: str | None = None):
+    def configure(cls, api_token: Optional[str] = None):
         cls._instance = cls(api_token)
 
     @classmethod

automizor/storage/__init__.py

@@ -1,7 +1,7 @@
 import json
 import mimetypes
 from pathlib import Path
-from typing import List
+from typing import List, Optional
 
 from automizor.utils import JSON
 
@@ -114,7 +114,7 @@ def set_bytes(name: str, data: bytes, content_type="application/octet-stream"):
     storage.set_bytes(name, data, content_type)
 
 
-def set_file(name: str, path: str, content_type: str = None):
+def set_file(name: str, path: str, content_type: Optional[str] = None):
     """
     Uploads a file as an asset.
 

automizor/storage/_storage.py

@@ -1,4 +1,4 @@
-from typing import List
+from typing import List, Optional
 
 import requests
 
@@ -50,12 +50,12 @@ class Storage:
 
     _instance = None
 
-    def __init__(self, api_token: str | None = None):
+    def __init__(self, api_token: Optional[str] = None):
         self.url, self.token = get_api_config(api_token)
         self.headers = get_headers(self.token)
 
     @classmethod
-    def configure(cls, api_token: str | None = None):
+    def configure(cls, api_token: Optional[str] = None):
         cls._instance = cls(api_token)
 
     @classmethod

automizor/utils/__init__.py

@@ -1,6 +1,6 @@
 import os
 import platform
-from typing import Dict, List, Union
+from typing import Dict, List, Optional, Union
 
 from automizor import version
 from automizor.exceptions import AutomizorError
@@ -13,7 +13,7 @@ OS_SYSTEM, OS_RELEASE, _ = platform.system_alias(
 )
 
 
-def get_api_config(api_token: str | None = None) -> tuple[str, str]:
+def get_api_config(api_token: Optional[str] = None) -> tuple[str, str]:
     if api_token is None:
         api_token = os.getenv("AUTOMIZOR_AGENT_TOKEN")
 

automizor/vault/_vault.py

@@ -1,4 +1,5 @@
 from dataclasses import asdict
+from typing import Optional
 
 import requests
 
@@ -44,12 +45,12 @@ class Vault:
 
     _instance = None
 
-    def __init__(self, api_token: str | None = None):
+    def __init__(self, api_token: Optional[str] = None):
         self.url, self.token = get_api_config(api_token)
         self.headers = get_headers(self.token)
 
     @classmethod
-    def configure(cls, api_token: str | None = None):
+    def configure(cls, api_token: Optional[str] = None):
         cls._instance = cls(api_token)
 
     @classmethod

automizor/workflow/__init__.py

@@ -0,0 +1,40 @@
+import json
+from typing import Optional
+
+from automizor.utils import JSON
+
+from ._workflow import Workflow
+
+
+def configure(api_token: str):
+    """
+    Configures the Worflow instance with the provided API token.
+    """
+    Workflow.configure(api_token)
+
+
+def start_by_name(
+    process_model: str,
+    workspace: str,
+    business_key: Optional[str] = None,
+    data: Optional[JSON] = None,
+):
+    """
+    Starts a workflow instance by process model and workspace name.
+
+    Parameters:
+        process_model: The name of the process model to start.
+        workspace: The workspace name to which the process model belongs.
+        business_key: An optional business identifier.
+        data: Optional initial instance data.
+    """
+    payload = json.dumps(data).encode("utf-8")
+
+    workflow = Workflow.get_instance()
+    workflow.start_by_name(process_model, workspace, business_key, payload)
+
+
+__all__ = [
+    "configure",
+    "start_by_name",
+]

automizor/workflow/_workflow.py

@@ -0,0 +1,102 @@
+from typing import Optional
+
+import requests
+
+from automizor.exceptions import AutomizorError
+from automizor.utils import get_api_config, get_headers
+
+
+class Workflow:
+    """
+    The `Workflow` class is designed to interact with the `Automizor Platform` to manage
+    workflow instances and facilitate the initiation of workflows based on specified
+    process models and workspaces.
+
+    This class uses environment variables for configuration, particularly to retrieve the
+    API host and API token, which are essential for authenticating requests to the
+    `Automizor Workflow API`. These variables are typically configured by the `Automizor Agent`.
+
+    Required environment variable:
+    - ``AUTOMIZOR_AGENT_TOKEN``: The token used for authenticating API requests.
+
+    Example usage:
+
+    .. code-block:: python
+
+        from automizor import workflow
+
+        # Start a workflow instance by name
+        workflow.start_by_name("ModelName", "WorkspaceName")
+        workflow.start_by_name("ModelName", "WorkspaceName", "BusinessKey")
+        workflow.start_by_name("ModelName", "WorkspaceName", "BusinessKey", {"initial": "data"})
+    """
+
+    _instance = None
+
+    def __init__(self, api_token: Optional[str] = None):
+        self.url, self.token = get_api_config(api_token)
+        self.headers = get_headers(self.token)
+
+    @classmethod
+    def configure(cls, api_token: Optional[str] = None):
+        cls._instance = cls(api_token)
+
+    @classmethod
+    def get_instance(cls):
+        if cls._instance is None:
+            cls.configure()
+        return cls._instance
+
+    def start_by_name(
+        self,
+        process_model: str,
+        workspace: str,
+        business_key: Optional[str],
+        payload: Optional[bytes],
+    ):
+        """
+        Initiates a workflow instance based on a given process model and workspace.
+
+        Parameters:
+            process_model: The name of the process model to start.
+            workspace: The workspace name to which the process model belongs.
+            business_key: An optional business identifier.
+            payload: Optional json payload in bytes.
+        """
+        self._create_instance(process_model, workspace, business_key, payload)
+
+    def _create_instance(
+        self,
+        process_model: str,
+        workspace: str,
+        business_key: Optional[str],
+        payload: Optional[bytes],
+    ):
+        """
+        Creates a new workflow instance based on a given process model and workspace.
+
+        Parameters:
+            process_model: The name of the process model to start.
+            workspace: The workspace name to which the process model belongs.
+            business_key: An optional business identifier.
+            payload: Optional json payload in bytes.
+
+        Raises:
+            AutomizorError: If there is an error in creating the instance.
+        """
+        url = f"https://{self.url}/api/v1/workflow/instance/"
+        try:
+            data = {
+                "business_key": business_key,
+                "initial_data": payload,
+                "process_model": process_model,
+                "workspace": workspace,
+            }
+            response = requests.post(url, headers=self.headers, data=data, timeout=10)
+            response.raise_for_status()
+        except requests.HTTPError as exc:
+            raise AutomizorError.from_response(
+                exc.response, "Failed to create instance"
+            ) from exc
+        except Exception as exc:
+            raise AutomizorError(f"Failed to create instance: {exc}") from exc

{automizor-0.4.10.dist-info → automizor-0.4.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: automizor
-Version: 0.4.10
+Version: 0.4.11
 Summary: Python Automizor framework
 Home-page: https://github.com/automizor/automizor-python
 Author: Christian Fischer

automizor-0.4.11.dist-info/RECORD

@@ -0,0 +1,22 @@
+automizor/__init__.py,sha256=BgTmI_pMMS3dXctT_oRAuEr_Pn2I3qHQCFooYZOzQ1Q,19
+automizor/exceptions.py,sha256=P5imySIOtG3ZIk2kh41Yod4RnlgTj7Vf0P3M-RuxQJs,1382
+automizor/datastore/__init__.py,sha256=_rAdRfKnTa4SuSLl9GkAYziBPPLsy6yGfS0HprgokOk,2418
+automizor/datastore/_container.py,sha256=rHRkSWaRgy2rk6Qy-7ADFKvuET_COZ2i9VD7gvRDnlM,745
+automizor/datastore/_datastore.py,sha256=Tv0vRjIyeUfVy3V8pcZVN1dX7q7v8JbJ9L3SCIxX8aM,3396
+automizor/job/__init__.py,sha256=pDqSfR4lAyJNCi-fpG6byUPidHz8sntBs0bB2lJFVAY,1118
+automizor/job/_job.py,sha256=XJX9Q7GeOErb7U9Wb01Wv1twIlBqNnJePb0Epc8NdTs,5440
+automizor/log/__init__.py,sha256=gEr2SuwN1FgX1NMnbphjg8_gfSic9L15H3WC868A-TQ,2104
+automizor/log/_log.py,sha256=P9jAFXVANs5bAGH6-S0pzuSbRKEcX8VlQ_3uu690awE,2948
+automizor/storage/__init__.py,sha256=vCez0LucHQeRZDfX5xZulxf06i3ezVyFl4vL3-EYXXU,4160
+automizor/storage/_storage.py,sha256=VPIahpIjCBU7pT-2qvleWcYOMWoffR_x3XUk6nGzUmI,11372
+automizor/utils/__init__.py,sha256=UDYuSERa3IrS_1NreBTNBYf6j25ga2AiwRdq0c3kfvM,965
+automizor/vault/__init__.py,sha256=21Ag2zQk7x27Bh0yt_kSO2MkgT3eafbdlKe0NuQEqr8,1796
+automizor/vault/_container.py,sha256=-2y7kASigoIVAebuQBk-0R_sI4gfmvjsMLuMg_tR1xA,1945
+automizor/vault/_vault.py,sha256=n_ZgzSOdG0nTFnO8J3D69fgmcsRPRwmSDd5fvn2ZkUI,5112
+automizor/workflow/__init__.py,sha256=rfaqZojz35cEPN4WnqlvG_G9xzMDUDZIfwib17AQLQw,952
+automizor/workflow/_workflow.py,sha256=l4kb-eMdBpewa0inmseQMREorImjY829dDLA3DzCC7c,3561
+automizor-0.4.11.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
+automizor-0.4.11.dist-info/METADATA,sha256=WKjbnfWNrOW_QZ_mrVdD0baRkmhZM9uTB0MnGBPwYcQ,669
+automizor-0.4.11.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
+automizor-0.4.11.dist-info/top_level.txt,sha256=gScDy4I3tP6BMYAsTAlBXrxVh3E00zV0UioxwXJOI3Y,10
+automizor-0.4.11.dist-info/RECORD,,

automizor-0.4.10.dist-info/RECORD

@@ -1,20 +0,0 @@
-automizor/__init__.py,sha256=XxfULjVU_ewxlK1iP8zCIo68qAo_TYC2AAlK0zPbeS8,19
-automizor/exceptions.py,sha256=P5imySIOtG3ZIk2kh41Yod4RnlgTj7Vf0P3M-RuxQJs,1382
-automizor/datastore/__init__.py,sha256=_rAdRfKnTa4SuSLl9GkAYziBPPLsy6yGfS0HprgokOk,2418
-automizor/datastore/_container.py,sha256=rHRkSWaRgy2rk6Qy-7ADFKvuET_COZ2i9VD7gvRDnlM,745
-automizor/datastore/_datastore.py,sha256=Xtl64A-q3N9xP2lppPwgLNpqNMTHA5VoCO74T0vi-ZE,3349
-automizor/job/__init__.py,sha256=pDqSfR4lAyJNCi-fpG6byUPidHz8sntBs0bB2lJFVAY,1118
-automizor/job/_job.py,sha256=TvZYxrl9JNXV5RZolOSdGMIQTNkiIy_MIPlDP2_-euM,5406
-automizor/log/__init__.py,sha256=gEr2SuwN1FgX1NMnbphjg8_gfSic9L15H3WC868A-TQ,2104
-automizor/log/_log.py,sha256=P9jAFXVANs5bAGH6-S0pzuSbRKEcX8VlQ_3uu690awE,2948
-automizor/storage/__init__.py,sha256=RF4ccSAd0UepvJx5NFiotKt9mVr5WiZCb_4qrJ5OKx0,4140
-automizor/storage/_storage.py,sha256=fnYsvcExh6nMZg9YnSrDjbRWDD-szzRFTjcxXh4wIyY,11356
-automizor/utils/__init__.py,sha256=W0JNrn7GByjJXi60djS6vluo__Tj6AyJioqu9D41tto,952
-automizor/vault/__init__.py,sha256=21Ag2zQk7x27Bh0yt_kSO2MkgT3eafbdlKe0NuQEqr8,1796
-automizor/vault/_container.py,sha256=-2y7kASigoIVAebuQBk-0R_sI4gfmvjsMLuMg_tR1xA,1945
-automizor/vault/_vault.py,sha256=WTKmm4QQhnBx2oWvYRuXi4hQEcf0srlJ64EN1hUJa6o,5078
-automizor-0.4.10.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-automizor-0.4.10.dist-info/METADATA,sha256=plaIwWyN4HB2QZh87NHhHn6uRIvu_4t4Dc5NR6vOYX4,669
-automizor-0.4.10.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-automizor-0.4.10.dist-info/top_level.txt,sha256=gScDy4I3tP6BMYAsTAlBXrxVh3E00zV0UioxwXJOI3Y,10
-automizor-0.4.10.dist-info/RECORD,,