appmesh 1.5.4__py3-none-any.whl → 1.5.6__py3-none-any.whl

appmesh/http_client.py

@@ -150,6 +150,7 @@ class AppMeshClient(metaclass=abc.ABCMeta):
                 - `False`: Disables SSL verification (insecure, use cautiously for development).
                 - `str`: Path to a custom CA certificate or directory for verification. This option allows custom CA configuration,
                 which may be necessary in environments requiring specific CA chains that differ from the default system CAs.
+                To use both a custom CA and the system's default CAs, create a combined CA bundle by concatenating them into a single file. (e.g., `cat custom_ca.pem /etc/ssl/certs/ca-certificates.crt > combined_ca.pem`).
 
             ssl_client_cert (Union[str, Tuple[str, str]], optional): Path to the SSL client certificate and key. Can be:
                 - `str`: A path to a single PEM file containing both the client certificate and private key.
@@ -1208,6 +1209,73 @@ class AppMeshClient(metaclass=abc.ABCMeta):
         else:
             raise TypeError(f"Invalid timeout type: {str(timeout)}")
 
+    def run_task(self, app_name: str, data: str) -> str:
+        """Client send an invocation message to a running App Mesh application and wait for result.
+
+        This method posts the provided `data` to the App Mesh service which will
+        forward it to the specified running application instance.
+
+        Args:
+            app_name (str): Name of the target application (as registered in App Mesh).
+            data (str): Payload to deliver to the application. Typically a string.
+
+        Returns:
+            str: The HTTP response body returned by the remote application/service.
+        """
+        resp = self._request_http(AppMeshClient.Method.POST, path=f"/appmesh/app/{app_name}/task", body=data)
+        if resp.status_code != HTTPStatus.OK:
+            raise Exception(resp.text)
+
+        return resp.text
+
+    def task_fetch(self) -> str:
+        """Fetch invocation data in the currently running App Mesh application process.
+
+        This helper is intended to be called by an application process running from App Mesh
+        to obtain the payload that a client pushed to it. It reads two required
+        environment variables set by the runtime:
+
+        - APP_MESH_PROCESS_ID: the process UUID for this invocation
+        - APP_MESH_APPLICATION_NAME: the application name
+
+        Returns:
+            str: The payload provided by the client as returned by the service.
+        """
+        process_uuid = os.environ["APP_MESH_PROCESS_ID"]
+        app_name = os.environ["APP_MESH_APPLICATION_NAME"]
+        while True:
+            resp = self._request_http(
+                AppMeshClient.Method.GET,
+                path=f"/appmesh/app/{app_name}/task",
+                query={"process_uuid": process_uuid},
+            )
+            if resp.status_code != HTTPStatus.OK:
+                time.sleep(0.1)
+                continue
+
+            return resp.text
+
+    def task_return(self, result: str) -> None:
+        """Return the result of a server-side invocation back to the original client.
+
+        The method posts the `result` associated with the current process UUID so
+        the invoking client can retrieve it. The same environment variables used by
+        `task_fetch` are required to identify the target process.
+
+        Args:
+            result (str): Result payload to be delivered back to the client.
+        """
+        process_uuid = os.environ["APP_MESH_PROCESS_ID"]
+        app_name = os.environ["APP_MESH_APPLICATION_NAME"]
+        resp = self._request_http(
+            AppMeshClient.Method.PUT,
+            path=f"/appmesh/app/{app_name}/task",
+            query={"process_uuid": process_uuid},
+            body=result,
+        )
+        if resp.status_code != HTTPStatus.OK:
+            raise Exception(resp.text)
+
     def run_app_async(
         self,
         app: Union[App, str],
@@ -1350,6 +1418,7 @@ class AppMeshClient(metaclass=abc.ABCMeta):
         """
         rest_url = parse.urljoin(self.auth_server_url, path)
 
+        # Prepare headers
         header = {} if header is None else header
         if self.jwt_token:
             token = self.jwt_token["access_token"] if isinstance(self.jwt_token, dict) and "access_token" in self.jwt_token else self.jwt_token
@@ -1361,6 +1430,11 @@ class AppMeshClient(metaclass=abc.ABCMeta):
                 header[self.HTTP_HEADER_KEY_X_TARGET_HOST] = self.forward_to + ":" + str(parse.urlsplit(self.auth_server_url).port)
         header[self.HTTP_HEADER_KEY_USER_AGENT] = self.HTTP_USER_AGENT
 
+        # Convert body to JSON string if it's a dict or list
+        if isinstance(body, (dict, list)):
+            body = json.dumps(body)
+            header.setdefault("Content-Type", "application/json")
+
         try:
             if method is AppMeshClient.Method.GET:
                 return self.session.get(url=rest_url, params=query, headers=header, cert=self.ssl_client_cert, verify=self.ssl_verify, timeout=self.rest_timeout)
@@ -1369,7 +1443,7 @@ class AppMeshClient(metaclass=abc.ABCMeta):
                     url=rest_url,
                     params=query,
                     headers=header,
-                    data=json.dumps(body) if type(body) in (dict, list) else body,
+                    data=body,
                     cert=self.ssl_client_cert,
                     verify=self.ssl_verify,
                     timeout=self.rest_timeout,
@@ -1379,7 +1453,7 @@ class AppMeshClient(metaclass=abc.ABCMeta):
             elif method is AppMeshClient.Method.DELETE:
                 return self.session.delete(url=rest_url, headers=header, cert=self.ssl_client_cert, verify=self.ssl_verify, timeout=self.rest_timeout)
             elif method is AppMeshClient.Method.PUT:
-                return self.session.put(url=rest_url, params=query, headers=header, json=body, cert=self.ssl_client_cert, verify=self.ssl_verify, timeout=self.rest_timeout)
+                return self.session.put(url=rest_url, params=query, headers=header, data=body, cert=self.ssl_client_cert, verify=self.ssl_verify, timeout=self.rest_timeout)
             else:
                 raise Exception("Invalid http method", method)
         except requests.exceptions.RequestException as e:

appmesh/tcp_client.py

@@ -1,5 +1,5 @@
 # TCP-based App Mesh Client
-# pylint: disable=line-too-long,broad-exception-raised,	,broad-exception-caught,import-outside-toplevel,protected-access
+# pylint: disable=line-too-long,broad-exception-raised,broad-exception-caught,import-outside-toplevel,protected-access
 
 import json
 import os

{appmesh-1.5.4.dist-info → appmesh-1.5.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: appmesh
-Version: 1.5.4
+Version: 1.5.6
 Summary: Client SDK for App Mesh
 Home-page: https://github.com/laoshanxi/app-mesh
 Author: laoshanxi
@@ -48,11 +48,11 @@ App Mesh is an open-source, multi-tenant application management platform designe
 
 Feature | Description
 ---|---
-Application management | 1. Manage independent applications with flexible process control (long/short running, periodic, cron schedule, custom timings, error handling) and comprehensive monitoring (start counts, return codes, error messages, health checks) for both native and Docker applications. <br> 2. Run applications on remote hosts using SDK/CLI with sync/async modes and fetch results to the client. <br> 3. Full control over application lifecycle (cgroup resource limitation, specific OS user for execution). <br> 4. Support interactive application start with specific input data via pipe and environment variables. <br> 5. Access all functionalities via [CLI](https://app-mesh.readthedocs.io/en/latest/CLI.html), [REST](https://app-mesh.readthedocs.io/en/latest/Development.html#rest-apis), [SDK](https://github.com/laoshanxi/app-mesh/tree/main/src/sdk) and [WebGUI](https://github.com/laoshanxi/app-mesh-ui) interface.<br>
-Security |  ⚡️ [JWT authentication](https://app-mesh.readthedocs.io/en/latest/JWT.html) for CLI and REST interface <br> ⚡️ [LDAP support](https://app-mesh.readthedocs.io/en/latest/LDAP.html) <br> ⚡️ [Role based permission control](https://app-mesh.readthedocs.io/en/latest/USER_ROLE.html) <br> ⚡️ [Multi-factor authentication](https://app-mesh.readthedocs.io/en/latest/MFA.html)<br> SSL support (ECDH and secure ciphers) for REST http connection  <br> Multi-tenant support
-Cloud native | Schedule cloud-level applications to run on multiple hosts with resource size requests. <br> ⚡️ [Prometheus Exporter (build-in)](https://app-mesh.readthedocs.io/en/latest/PROMETHEUS.html) <br> ⚡️ [Grafana SimpleJson datasource](https://app-mesh.readthedocs.io/en/latest/GrafanaDataSource.html) <br> ⚡️ [Grafana Loki](https://app-mesh.readthedocs.io/en/latest/Loki.html) <br>⚡️ [Dockerfile](https://github.com/laoshanxi/app-mesh/blob/main/Dockerfile)
-Micro service application | ⚡️ [Consul micro-service cluster management](https://app-mesh.readthedocs.io/en/latest/CONSUL.html)
-Extra Features | Collect host/app resource usage <br> Remote shell command execution <br> File upload/download interface <br> Hot-update support `systemctl reload appmesh` <br> Bash completion <br> Reverse proxy <br> [Web GUI](https://github.com/laoshanxi/app-mesh-ui)
+Application management | 🧩 <b>Application Management (CURD) with Full Remote Control</b> – including cgroup, OS user, environment variables, Docker, stdin, and stdout – along with comprehensive monitoring (start counts, exit codes, error messages, health checks). <br> 🧩 <b>Fine-Grained Application Behavior Control & Scheduling</b> – supports long- and short-running tasks, periodic jobs, cron schedules, custom timings, and robust error handling. <br> 🧩 <b>Multi-Tenancy</b> –  built-in user ownership model and access controls. <br> 🧩 <b>Unified Access Interface</b> – interact via [CLI](https://app-mesh.readthedocs.io/en/latest/CLI.html), [REST](https://app-mesh.readthedocs.io/en/latest/Development.html#rest-apis), [SDK](https://github.com/laoshanxi/app-mesh/tree/main/src/sdk) or [WebGUI](https://github.com/laoshanxi/app-mesh-ui).<br>
+Security |  🔐 Authentication: [LDAP](https://app-mesh.readthedocs.io/en/latest/LDAP.html), [OAuth](src/sdk/python/test/test_oauth2.py), [2FA](https://app-mesh.readthedocs.io/en/latest/MFA.html), YAML-based storage (local file or Consul for clustering) <br> 🔐 Authorization: [JWT](https://app-mesh.readthedocs.io/en/latest/JWT.html), [RBAC](https://app-mesh.readthedocs.io/en/latest/USER_ROLE.html), multi-tenant isolation <br> 🔐 Protection: SSL/TLS for TCP/HTTP, CSRF tokens, HMAC with PSK for non-token verification
+Cloud native | Schedule cloud-level applications to run on multiple hosts with resource size requests. <br> 🌩️ [Prometheus Exporter (build-in)](https://app-mesh.readthedocs.io/en/latest/PROMETHEUS.html) <br> 🌩️ [Grafana SimpleJson datasource](https://app-mesh.readthedocs.io/en/latest/GrafanaDataSource.html) <br> 🌩️ [Grafana Loki](https://app-mesh.readthedocs.io/en/latest/Loki.html) <br>🌩️ [Dockerfile](https://github.com/laoshanxi/app-mesh/blob/main/Dockerfile)
+Micro service application | 🧱 [Consul micro-service cluster management](https://app-mesh.readthedocs.io/en/latest/CONSUL.html)
+Extra Features | Collect host/app resource usage <br> Remote shell command execution <br> File upload/download interface <br> Hot-update support `systemctl reload appmesh` <br> Bash completion <br> Reverse proxy <br> 🌐[Web GUI](https://github.com/laoshanxi/app-mesh-ui)
 Platform support | X86_64 <br> ARM32 <br> ARM64
 SDK | [Python](https://app-mesh.readthedocs.io/en/latest/api/appmesh_client.html) <br> [Golang](https://github.com/laoshanxi/app-mesh/blob/main/src/sdk/go/appmesh_client.go) <br> [JavaScript](https://www.npmjs.com/package/appmesh) <br> [Java](https://github.com/laoshanxi/app-mesh/packages/2227502) <br> [Swagger OpenAPI Specification](https://petstore.swagger.io/?url=https://raw.githubusercontent.com/laoshanxi/app-mesh/main/src/daemon/rest/openapi.yaml)
 
@@ -102,6 +102,7 @@ Refer to the [Installation doc](https://app-mesh.readthedocs.io/en/latest/Instal
 | GUI               | √        | √          |
 | Virtual Network   |          | √          |
 | Monitor tools     | √        | √          |
+| [Remote API call](https://app-mesh.readthedocs.io/en/latest/RemoteTask.html)   | √        |            |
 
 ---
 

{appmesh-1.5.4.dist-info → appmesh-1.5.6.dist-info}/RECORD

@@ -3,11 +3,11 @@ appmesh/app.py,sha256=9Q-SOOej-MH13BU5Dv2iTa-p-sECCJQp6ZX9DjWWmwE,10526
 appmesh/app_output.py,sha256=JK_TMKgjvaw4n_ys_vmN5S4MyWVZpmD7NlKz_UyMIM8,1015
 appmesh/app_run.py,sha256=9ISKGZ3k3kkbQvSsPfRfkOLqD9xhbqNOM7ork9F4w9c,1712
 appmesh/appmesh_client.py,sha256=0ltkqHZUq094gKneYmC0bEZCP0X9kHTp9fccKdWFWP0,339
-appmesh/http_client.py,sha256=teJnIAzR7yUJHnQ9HL7DwT_uMlMy_PW8P4tADosKWeg,55973
-appmesh/tcp_client.py,sha256=Id1aIKVWncTSZiKRVa4sgwo1tFX2wRqOLiTnI9-dNkE,11001
+appmesh/http_client.py,sha256=9PUGuo2YCv1KYVeDhYxFegeEGSBqoSim3UK9OJHEsnU,59143
+appmesh/tcp_client.py,sha256=yi0n2NpBBCA-JHYWQPPE_1euE7Oz6JHBe1op7lypTXY,10999
 appmesh/tcp_messages.py,sha256=w1Kehz_aX4X2CYAUsy9mFVJRhxnLQwwc6L58W4YkQqs,969
 appmesh/tcp_transport.py,sha256=-XDTQbsKL3yCbguHeW2jNqXpYgnCyHsH4rwcaJ46AS8,8645
-appmesh-1.5.4.dist-info/METADATA,sha256=6ifFE59KKoLvM0ti58Of96_zSmlPgpEWzzQgOIir3-k,11684
-appmesh-1.5.4.dist-info/WHEEL,sha256=pxyMxgL8-pra_rKaQ4drOZAegBVuX-G_4nRHjjgWbmo,91
-appmesh-1.5.4.dist-info/top_level.txt,sha256=-y0MNQOGJxUzLdHZ6E_Rfv5_LNCkV-GTmOBME_b6pg8,8
-appmesh-1.5.4.dist-info/RECORD,,
+appmesh-1.5.6.dist-info/METADATA,sha256=k241QBT0-fxg36SOh4Y3qHLkYwTkjUgXPRJxYHZ38oY,11768
+appmesh-1.5.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+appmesh-1.5.6.dist-info/top_level.txt,sha256=-y0MNQOGJxUzLdHZ6E_Rfv5_LNCkV-GTmOBME_b6pg8,8
+appmesh-1.5.6.dist-info/RECORD,,

{appmesh-1.5.4.dist-info → appmesh-1.5.6.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: setuptools (79.0.0)
+Generator: setuptools (80.9.0)
 Root-Is-Purelib: true
 Tag: py3-none-any