peak-sdk 1.3.0__py3-none-any.whl → 1.5.0__py3-none-any.whl

peak/cli/resources/webapps.py

@@ -20,7 +20,14 @@
 #
 
 #
-"""Peak Webapps service commands."""
+
+"""Peak Webapps commands.
+
+.. warning::
+    The ``Web Apps`` commands are deprecated and will eventually be removed. It is recommended that users begin transitioning to the ``Service`` commands, which offers all the features of ``Webapp`` along with the added capability of API deployment and other significant updates for enhanced functionality. Transitioning early to the ``Service`` commands will ensure easier adoption of its advanced features and future updates.
+
+    For guidance on migrating to the ``Service`` and taking full advantage of its capabilities, please refer to the ``Service`` documentation.
+"""
 
 from typing import Any, Dict, List, Optional
 
@@ -34,7 +41,11 @@ from peak.resources.webapps import Webapp
 from typing_extensions import Annotated
 
 app = typer.Typer(
-    help="Visualize your data and predictions using Webapps. Please note that only generic (EKS-based) webapps are supported with CLI.",
+    help="""Visualize your data and predictions using Webapps.
+    ```yaml
+    NOTE: Please note that only generic (EKS-based) webapps are supported with CLI. **Note** that, the functionalities provided through the `Webapp` feature are deprecated and will eventually be removed. We recommend using the `Service` feature which offers a more comprehensive and flexible solution for managing web applications and API deployments.
+    ```
+    """,
     short_help="Create and Manage Webapps.",
 )
 
@@ -70,6 +81,8 @@ SESSION_STICKINESS = typer.Option(None, help="Enable session stickiness for the
 
 MAPPING = {"imageId": "imageDetails", "versionId": "imageDetails", "instanceTypeId": "resources"}
 
+DEPRECATION_MESSAGE = "The Web App commands are deprecated and will eventually be removed. We recommend using the Service feature which offers a more comprehensive and flexible solution for managing web applications and API deployments.\n"
+
 
 @app.command("list", short_help="List webapps.", options_metavar="list_webapps")
 def list_webapps(
@@ -83,6 +96,14 @@ def list_webapps(
 ) -> None:
     """***List*** all webapps that exist for the tenant.
 
+    \b
+     ```yaml
+    NOTE: The Web Apps commands are deprecated and will eventually be removed. It is recommended that users begin transitioning to the Service commands, which offers all the features of Webapp along with the added capability of API deployment and other significant updates for enhanced functionality. Transitioning early to the Service commands will ensure easier adoption of its advanced features and future updates.
+    ```
+
+    \b
+    For more information on Services, please refer to the [**Service**](https://docs.peak.ai/sdk/latest/cli/reference.html#peak-services) documentation.
+
     \b
     📝 ***Example usage:***<br/>
     ```bash
@@ -101,7 +122,7 @@ def list_webapps(
     }
     ```
 
-    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Webapps/list-webapp)
+    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Services/list-service)
     """
     webapp_client: Webapp = ctx.obj["client"]
     writer: Writer = ctx.obj["writer"]
@@ -114,7 +135,7 @@ def list_webapps(
             status=parse_list_of_strings(status),
             name=name,
         )
-        writer.write(response)
+        writer.write(response, deprecation_message=DEPRECATION_MESSAGE)
 
 
 @app.command(short_help="Create a new webapp.", options_metavar="create_webapp")
@@ -137,6 +158,14 @@ def create(
 ) -> None:
     """***Create*** a new webapp and start its deployment.
 
+    \b
+     ```yaml
+    NOTE: The Web Apps commands are deprecated and will eventually be removed. It is recommended that users begin transitioning to the Service commands, which offers all the features of Webapp along with the added capability of API deployment and other significant updates for enhanced functionality. Transitioning early to the Service commands will ensure easier adoption of its advanced features and future updates.
+    ```
+
+    \b
+    For more information on Services, please refer to the [**Service**](https://docs.peak.ai/sdk/latest/cli/reference.html#peak-services) documentation.
+
     \b
     🧩 ***Input file schema(yaml):***<br/>
     ```yaml
@@ -172,7 +201,7 @@ def create(
     }
     ```
 
-    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Webapps/create-webapp)
+    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Services/create-service)
     """
     webapp_client: Webapp = ctx.obj["client"]
     writer: Writer = ctx.obj["writer"]
@@ -197,7 +226,7 @@ def create(
 
     with writer.pager():
         response = webapp_client.create_webapp(body=body)
-        writer.write(response)
+        writer.write(response, deprecation_message=DEPRECATION_MESSAGE)
 
 
 @app.command(short_help="Update an existing webapp.", options_metavar="update_webapp")
@@ -220,6 +249,14 @@ def update(
 ) -> None:
     """***Update*** an existing webapp.
 
+    \b
+     ```yaml
+    NOTE: The Web Apps commands are deprecated and will eventually be removed. It is recommended that users begin transitioning to the Service commands, which offers all the features of Webapp along with the added capability of API deployment and other significant updates for enhanced functionality. Transitioning early to the Service commands will ensure easier adoption of its advanced features and future updates.
+    ```
+
+    \b
+    For more information on Services, please refer to the [**Service**](https://docs.peak.ai/sdk/latest/cli/reference.html#peak-services) documentation.
+
     \b
     When updating the webapp, it will trigger a redeployment only under specific conditions.
     Redeployment is triggered if you make changes to any of the following parameters: imageId, versionId, instanceTypeId or sessionStickiness.
@@ -259,7 +296,7 @@ def update(
     }
     ```
 
-    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Webapps/update-webapp)
+    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Services/update-service)
     """
     webapp_client: Webapp = ctx.obj["client"]
     writer: Writer = ctx.obj["writer"]
@@ -282,7 +319,7 @@ def update(
 
     with writer.pager():
         response = webapp_client.update_webapp(webapp_id=webapp_id, body=body)
-        writer.write(response)
+        writer.write(response, deprecation_message=DEPRECATION_MESSAGE)
 
 
 @app.command(short_help="Create a new webapp or Update an existing webapp.", options_metavar="create_or_update_webapp")
@@ -303,6 +340,14 @@ def create_or_update(
 ) -> None:
     """***Create*** a new webapp or ***Update*** an existing webapp based on webapp name and start its deployment.
 
+    \b
+     ```yaml
+    NOTE: The Web Apps commands are deprecated and will eventually be removed. It is recommended that users begin transitioning to the Service commands, which offers all the features of Webapp along with the added capability of API deployment and other significant updates for enhanced functionality. Transitioning early to the Service commands will ensure easier adoption of its advanced features and future updates.
+    ```
+
+    \b
+    For more information on Services, please refer to the [**Service**](https://docs.peak.ai/sdk/latest/cli/reference.html#peak-services) documentation.
+
     \b
     When updating the webapp, it will trigger a redeployment only under specific conditions.
     Redeployment is triggered if you make changes to any of the following parameters: imageId, versionId, instanceTypeId or sessionStickiness.
@@ -343,7 +388,7 @@ def create_or_update(
     }
     ```
 
-    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Webapps/create-webapp)
+    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Services/create-service)
     """
     webapp_client: Webapp = ctx.obj["client"]
     writer: Writer = ctx.obj["writer"]
@@ -367,7 +412,7 @@ def create_or_update(
     body = combine_dictionaries(body.get("body") or {}, user_options)
 
     response = webapp_client.create_or_update_webapp(body=body)
-    writer.write(response)
+    writer.write(response, deprecation_message=DEPRECATION_MESSAGE)
 
 
 @app.command(short_help="Delete an existing webapp.", options_metavar="delete_webapp")
@@ -380,6 +425,14 @@ def delete(
 ) -> None:
     """***Delete*** an existing webapp.
 
+    \b
+     ```yaml
+    NOTE: The Web Apps commands are deprecated and will eventually be removed. It is recommended that users begin transitioning to the Service commands, which offers all the features of Webapp along with the added capability of API deployment and other significant updates for enhanced functionality. Transitioning early to the Service commands will ensure easier adoption of its advanced features and future updates.
+    ```
+
+    \b
+    For more information on Services, please refer to the [**Service**](https://docs.peak.ai/sdk/latest/cli/reference.html#peak-services) documentation.
+
     \b
     📝 ***Example usage:***<br/>
     ```bash
@@ -394,14 +447,14 @@ def delete(
     }
     ```
 
-    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Webapps/delete-webapp)
+    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Services/delete-service)
     """
     webapp_client: Webapp = ctx.obj["client"]
     writer: Writer = ctx.obj["writer"]
 
     with writer.pager():
         response = webapp_client.delete_webapp(webapp_id=webapp_id)
-        writer.write(response)
+        writer.write(response, deprecation_message=DEPRECATION_MESSAGE)
 
 
 @app.command(short_help="Describe details of a webapp.", options_metavar="describe_webapp")
@@ -413,6 +466,14 @@ def describe(
 ) -> None:
     """***Describe*** details for the specific webapp.
 
+    \b
+     ```yaml
+    NOTE: The Web Apps commands are deprecated and will eventually be removed. It is recommended that users begin transitioning to the Service commands, which offers all the features of Webapp along with the added capability of API deployment and other significant updates for enhanced functionality. Transitioning early to the Service commands will ensure easier adoption of its advanced features and future updates.
+    ```
+
+    \b
+    For more information on Services, please refer to the [**Service**](https://docs.peak.ai/sdk/latest/cli/reference.html#peak-services) documentation.
+
     \b
     📝 ***Example usage:***<br/>
     ```bash
@@ -442,11 +503,11 @@ def describe(
     }
     ```
 
-    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Webapps/get-webapp)
+    🔗 [**API Documentation**](https://service.peak.ai/webapps/api-docs/index.htm#/Services/get-service)
     """
     webapp_client: Webapp = ctx.obj["client"]
     writer: Writer = ctx.obj["writer"]
 
     with writer.pager():
         response = webapp_client.describe_webapp(webapp_id=webapp_id)
-        writer.write(response)
+        writer.write(response, deprecation_message=DEPRECATION_MESSAGE)

peak/cli/resources/workflows.py

@@ -106,7 +106,6 @@ def create(
         triggers (list(map) | required: false):
             - cron (string | required: false): A valid cron expression.
               webhook (boolean | required: false): Should be true if webhook type trigger is to be used.
-              webhookPolicy (string | required: false): Policy of the webhook to be used. Should be "generate" when creating new worklfow.
         watchers (list(map) | required: false):
             - events (map):
                 success (boolean | required: false): Whether to call event on success.
@@ -219,7 +218,6 @@ def update(
         triggers (list(map) | required: false):
             - cron (string | required: false): A valid cron expression.
               webhook (boolean | required: false): Should be true if webhook type trigger is to be used.
-              webhookPolicy (string | required: false): Policy of the webhook to be used. Should be "generate" or "preserve".
         watchers (list(map) | required: false):
             - events (map):
                 success (boolean | required: false): Whether to call event on success.
@@ -332,7 +330,6 @@ def create_or_update(
         triggers (list(map) | required: false):
             - cron (string | required: false): A valid cron expression.
               webhook (boolean | required: false): Should be true if webhook type trigger is to be used.
-              webhookPolicy (string | required: false): Policy of the webhook to be used. Should be "generate" when creating new worklfow.
         watchers (list(map) | required: false):
             - events (map):
                 success (boolean | required: false): Whether to call event on success.
@@ -475,7 +472,6 @@ def patch(
         triggers (list(map) | required: false):
             - cron (string | required: false): A valid cron expression.
               webhook (boolean | required: false): Should be true if webhook type trigger is to be used.
-              webhookPolicy (string | required: false): Policy of the webhook to be used. Should be "generate" or "preserve".
         watchers (list(map) | required: false):
             - events (map):
                 success (boolean | required: false): Whether to call event on success.

peak/helpers.py

@@ -239,3 +239,30 @@ def download_logs_helper(
         if config.SOURCE == Sources.CLI:
             writer = Writer()
             writer.write(f"\nLog contents have been saved to: {file_name}")
+
+
+def search_action(current_path: str, current_dict: Dict[str, Any], action: str) -> Dict[str, bool]:
+    """Search for a specified action within a nested dictionary structure and check if deeper levels exist.
+
+    Args:
+        current_path (str): The dot-separated path representing the feature hierarchy.
+        current_dict (Dict[str, Any]): The nested dictionary representing the permissions structure.
+        action (str): The action to search for (e.g., "read" or "write").
+
+    Returns:
+        bool: A dictionary with keys 'has_permission' indicating if the action is found and
+              'deeper_levels' indicating if there are deeper levels that need specification.
+    """
+    keys = current_path.split(".")
+    for key in keys:
+        if key in current_dict:
+            current_dict = current_dict[key]
+        else:
+            return {"has_permission": False, "deeper_levels": False}
+
+    if "actions" in current_dict:
+        actions = current_dict["actions"]
+        has_permission = "*" in actions or action in actions or ("write" in actions and action == "read")
+        return {"has_permission": has_permission, "deeper_levels": False}
+
+    return {"has_permission": False, "deeper_levels": True}

peak/output.py

@@ -24,6 +24,7 @@ from __future__ import annotations
 
 import contextlib
 import json
+import sys
 from typing import Any, List
 
 import yaml
@@ -54,17 +55,21 @@ class Writer:
     def write(
         self,
         data: Any,
+        deprecation_message: str | None = None,
     ) -> None:
         """Write logs to the terminal.
 
         Args:
             data (Any): Data to be printed on the terminal.
                 This handles dry-run, debug mode and exit code for the CLI.
+            deprecation_message (str, optional): Deprecation message to be printed on the terminal.
         """
         output_type = config.OUTPUT_TYPE
         table_params = config.TABLE_PARAMS
 
         if not config.DEBUG_MODE or self.ignore_debug_mode:
+            if deprecation_message:
+                self._print_deprecation_warning(deprecation_message)
             if output_type == OutputTypes.yaml.value:
                 self.__yaml(data)
             elif output_type == OutputTypes.table.value:
@@ -178,5 +183,9 @@ class Writer:
             return console.pager(styles=True)
         return contextlib.nullcontext()
 
+    def _print_deprecation_warning(self, deprecation_message: str) -> None:
+        """Prints a deprecation warning message."""
+        print(f"\nNote: {deprecation_message}", file=sys.stderr)  # noqa: T201
+
 
 __all__: List[str] = ["Writer"]

peak/press/blocks.py

@@ -250,9 +250,6 @@ class Block(BaseClient):
                             {
                                 "webhook": "boolean"
                             },
-                            {
-                                "webhookPolicy": "string"
-                            }
                         ],
                         "watchers": [
                             {
@@ -527,9 +524,6 @@ class Block(BaseClient):
                             },
                             {
                                 "webhook": "boolean"
-                            },
-                            {
-                                "webhookPolicy": "string"
                             }
                         ],
                         "watchers": [
@@ -1271,15 +1265,16 @@ class Block(BaseClient):
             - "status" (str): The current status of the block. The platform resource status can be inferred from this.
 
         Example return value:
-            [
-                {   "id": "12345",
-                    "resource_id": "6789",
-                    "kind": "workflow",
-                    "name": "my-workflow",
-                    "status": "deployed",
-                },
-                # Additional resources...
-            ]
+            .. code-block:: json
+
+                [
+                    {   "id": "12345",
+                        "resource_id": "6789",
+                        "kind": "workflow",
+                        "name": "my-workflow",
+                        "status": "deployed",
+                    },
+                ]
 
         Raises:
             BadRequestException: The given parameters are invalid.

peak/resources/__init__.py

@@ -23,6 +23,6 @@ from __future__ import annotations
 
 from typing import List
 
-from peak.resources import artifacts, images, tenants, webapps, workflows
+from peak.resources import artifacts, images, services, tenants, users, webapps, workflows
 
-__all__: List[str] = ["workflows", "images", "artifacts", "webapps", "tenants"]
+__all__: List[str] = ["artifacts", "images", "services", "tenants", "users", "webapps", "workflows"]