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

automizor/__init__.py

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

automizor/datastore/_datastore.py

@@ -1,3 +1,5 @@
+from typing import Optional
+
 import requests
 
 from automizor.exceptions import AutomizorError
@@ -10,27 +12,21 @@ class DataStore:
     to manage and manipulate data stored in various formats. It supports
     operations to retrieve and update data using a unified API.
 
-    The class initializes an HTTP session with the necessary headers for
+    The class initializes an HTTP request with the necessary headers for
     authentication, and provides methods to retrieve values, and set values in
     the store.
-
-    Attributes:
-        url (str): The base URL for the API endpoint.
-        token (str): The authentication token for API access.
-        session (requests.Session): The HTTP session used to make API requests.
     """
 
     _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: str | None = None):
+    def configure(cls, api_token: Optional[str] = None):
         cls._instance = cls(api_token)
 
-    def __init__(self, api_token: str | None = None):
-        self.url, self.token = get_api_config(api_token)
-        self.session = requests.Session()
-        self.session.headers.update(get_headers(self.token))
-
     @classmethod
     def get_instance(cls):
         if cls._instance is None:
@@ -40,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.
@@ -71,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}
@@ -81,7 +77,9 @@ class DataStore:
         )
         url = f"https://{self.url}/api/v1/workflow/datastore/{name}/values/"
         try:
-            response = self.session.get(url, timeout=10, params=params)
+            response = requests.get(
+                url, headers=self.headers, params=params, timeout=10
+            )
             response.raise_for_status()
             return response.json()
         except requests.HTTPError as exc:
@@ -94,7 +92,7 @@ class DataStore:
     def _set_values(self, name: str, values: JSON) -> None:
         url = f"https://{self.url}/api/v1/workflow/datastore/{name}/values/"
         try:
-            response = self.session.post(url, json=values, timeout=10)
+            response = requests.post(url, headers=self.headers, json=values, timeout=10)
             response.raise_for_status()
         except requests.HTTPError as exc:
             raise AutomizorError.from_response(

automizor/job/_job.py

@@ -1,5 +1,6 @@
 import json
 import os
+from typing import Optional
 
 import requests
 
@@ -48,17 +49,16 @@ class Job:
 
     _instance = None
 
-    @classmethod
-    def configure(cls, api_token: str | None = None):
-        cls._instance = cls(api_token)
-
-    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)
 
         self.url, self.token = get_api_config(api_token)
-        self.session = requests.Session()
-        self.session.headers.update(get_headers(self.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):
@@ -129,7 +129,7 @@ class Job:
     def _read_job_context(self) -> dict:
         url = f"https://{self.url}/api/v1/rpa/job/{self._job_id}/"
         try:
-            response = self.session.get(url, timeout=10)
+            response = requests.get(url, headers=self.headers, timeout=10)
             response.raise_for_status()
             return response.json().get("context", {})
         except requests.HTTPError as exc:

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,15 +50,14 @@ class Storage:
 
     _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: str | None = None):
+    def configure(cls, api_token: Optional[str] = None):
         cls._instance = cls(api_token)
 
-    def __init__(self, api_token: str | None = None):
-        self.url, self.token = get_api_config(api_token)
-        self.session = requests.Session()
-        self.session.headers.update(get_headers(self.token))
-
     @classmethod
     def get_instance(cls):
         if cls._instance is None:
@@ -80,7 +79,7 @@ class Storage:
 
         try:
             while url:
-                response = self.session.get(url, timeout=10)
+                response = requests.get(url, headers=self.headers, timeout=10)
                 response.raise_for_status()
                 data = response.json()
 
@@ -109,7 +108,7 @@ class Storage:
 
         url = f"https://{self.url}/api/v1/storage/asset/{name}/"
         try:
-            response = self.session.delete(url, timeout=10)
+            response = requests.delete(url, headers=self.headers, timeout=10)
             response.raise_for_status()
         except requests.HTTPError as exc:
             raise AutomizorError.from_response(
@@ -231,7 +230,9 @@ class Storage:
                 "name": name,
             }
             files = {"file": ("text.txt", content, content_type)}
-            response = self.session.post(url, files=files, data=data, timeout=10)
+            response = requests.post(
+                url, headers=self.headers, files=files, data=data, timeout=10
+            )
             response.raise_for_status()
         except requests.HTTPError as exc:
             raise AutomizorError.from_response(
@@ -265,7 +266,7 @@ class Storage:
     def _get_asset_url(self, name: str) -> str:
         url = f"https://{self.url}/api/v1/storage/asset/{name}/"
         try:
-            response = self.session.get(url, timeout=10)
+            response = requests.get(url, headers=self.headers, timeout=10)
             response.raise_for_status()
 
             url = response.json().get("file")
@@ -300,7 +301,9 @@ class Storage:
                 "name": name,
             }
             files = {"file": ("text.txt", content, content_type)}
-            response = self.session.put(url, files=files, data=data, timeout=10)
+            response = requests.put(
+                url, headers=self.headers, files=files, data=data, timeout=10
+            )
             response.raise_for_status()
         except requests.HTTPError as exc:
             raise AutomizorError.from_response(

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,15 +45,14 @@ class Vault:
 
     _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: str | None = None):
+    def configure(cls, api_token: Optional[str] = None):
         cls._instance = cls(api_token)
 
-    def __init__(self, api_token: str | None = None):
-        self.url, self.token = get_api_config(api_token)
-        self.session = requests.Session()
-        self.session.headers.update(get_headers(self.token))
-
     @classmethod
     def get_instance(cls):
         if cls._instance is None:
@@ -114,7 +114,9 @@ class Vault:
     def _create_secret(self, secret: SecretContainer) -> SecretContainer:
         url = f"https://{self.url}/api/v1/vault/secret/"
         try:
-            response = self.session.post(url, timeout=10, json=asdict(secret))
+            response = requests.post(
+                url, headers=self.headers, timeout=10, json=asdict(secret)
+            )
             response.raise_for_status()
             return SecretContainer(**response.json())
         except requests.HTTPError as exc:
@@ -127,7 +129,7 @@ class Vault:
     def _get_secret(self, name: str) -> SecretContainer:
         url = f"https://{self.url}/api/v1/vault/secret/{name}/"
         try:
-            response = self.session.get(url, timeout=10)
+            response = requests.get(url, headers=self.headers, timeout=10)
             response.raise_for_status()
             return SecretContainer(**response.json())
         except requests.HTTPError as exc:
@@ -140,7 +142,9 @@ class Vault:
     def _update_secret(self, secret: SecretContainer) -> SecretContainer:
         url = f"https://{self.url}/api/v1/vault/secret/{secret.name}/"
         try:
-            response = self.session.put(url, timeout=10, json=asdict(secret))
+            response = requests.put(
+                url, headers=self.headers, timeout=10, json=asdict(secret)
+            )
             response.raise_for_status()
             return SecretContainer(**response.json())
         except requests.HTTPError as exc:

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.9.dist-info → automizor-0.4.11.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: automizor
-Version: 0.4.9
+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.9.dist-info/RECORD

@@ -1,20 +0,0 @@
-automizor/__init__.py,sha256=ElLL68L1maenU2D5V6AoUj5l5Opu9EHBBw3V9qIFxV4,18
-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=EW8AnZPvr32Yz3bC6SxadRgihY7_G-XcwSfLV5CMzMg,3552
-automizor/job/__init__.py,sha256=pDqSfR4lAyJNCi-fpG6byUPidHz8sntBs0bB2lJFVAY,1118
-automizor/job/_job.py,sha256=oVv7utlpaIPVBSnBXcV9jf7B3UNsWCDLtPkw0m3IJio,5444
-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=ah8sCpRQm0MOnZgOgiBQF1Oamq_mz1VWrV17z6XOuFw,11262
-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=-Xi_xMQLRB9patFTiZ4Z817F9VEvhIvx-YOOH8z_BKc,5020
-automizor-0.4.9.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
-automizor-0.4.9.dist-info/METADATA,sha256=uNVJ3mjxM7iZZRRzbzTCdCE6FlUYdkXiNqLCJZZSG_c,668
-automizor-0.4.9.dist-info/WHEEL,sha256=OVMc5UfuAQiSplgO0_WdW7vXVGAt9Hdd6qtN4HotdyA,91
-automizor-0.4.9.dist-info/top_level.txt,sha256=gScDy4I3tP6BMYAsTAlBXrxVh3E00zV0UioxwXJOI3Y,10
-automizor-0.4.9.dist-info/RECORD,,