peak-sdk 1.4.0__py3-none-any.whl → 1.6.0__py3-none-any.whl

peak/press/specs.py

@@ -19,6 +19,7 @@
 # # along with this program. If not, see <https://apache.org/licenses/LICENSE-2.0>
 #
 """Specs client module."""
+
 from __future__ import annotations
 
 from typing import Any, Dict, Iterator, List, Literal, Optional, overload
@@ -46,8 +47,7 @@ class Spec(BaseClient):
         page_number: Optional[int] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_specs(
@@ -62,8 +62,7 @@ class Spec(BaseClient):
         page_number: Optional[int] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_specs(
         self,
@@ -144,7 +143,7 @@ class Spec(BaseClient):
     def list_spec_release_deployments(
         self,
         spec_id: str,
-        version: str,
+        version: Optional[str],
         status: Optional[List[str]] = None,
         name: Optional[str] = None,
         title: Optional[str] = None,
@@ -153,14 +152,13 @@ class Spec(BaseClient):
         page_number: Optional[int] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_spec_release_deployments(
         self,
         spec_id: str,
-        version: str,
+        version: Optional[str],
         status: Optional[List[str]] = None,
         name: Optional[str] = None,
         title: Optional[str] = None,
@@ -169,13 +167,12 @@ class Spec(BaseClient):
         page_number: Optional[int] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_spec_release_deployments(
         self,
         spec_id: str,
-        version: str,
+        version: Optional[str],
         status: Optional[List[str]] = None,
         name: Optional[str] = None,
         title: Optional[str] = None,
@@ -188,11 +185,11 @@ class Spec(BaseClient):
         """Get all deployments of a App or Block spec release (ordered by most recently created to oldest).
 
         REFERENCE:
-            🔗 `API Documentation <https://press.peak.ai/api-docs/index.htm#/Specs/get_v1_specs__specId__releases__version__deployments>`__
+            🔗 `API Documentation <https://press.peak.ai/api-docs/index.htm#/Specs/get_v1_specs__specId__releases_deployments>`__
 
         Args:
             spec_id (str): The ID of the App or Block spec.
-            version (str): The release version of the spec in valid semantic versioning format.
+            version (str | None): The release version of the spec in valid semantic versioning format. If not provided, all deployments are returned.
             status (List[str] | None): List of statuses to filter deployments.
                 Valid values are `deleting`, `delete_failed`, `deployed`, `deploying`, `failed`, `platform_resource_error`, `redeploying`, `rollback`, `rollback_complete`, `rollback_failed` and `warning`.
             name (str | None): String to filter deployments by name.
@@ -218,13 +215,14 @@ class Spec(BaseClient):
             InternalServerErrorException: the server encountered an unexpected condition that
                 prevented it from fulfilling the request.
         """
-        method, endpoint = HttpMethods.GET, f"{self.BASE_ENDPOINT}/{spec_id}/releases/{version}/deployments"
+        method, endpoint = HttpMethods.GET, f"{self.BASE_ENDPOINT}/{spec_id}/releases/deployments"
 
         params: Dict[str, Any] = {
             "status": status,
             "name": name,
             "title": title,
             "sort": sort,
+            "version": version,
             "pageSize": page_size,
         }
 

peak/resources/__init__.py

@@ -19,10 +19,11 @@
 # # along with this program. If not, see <https://apache.org/licenses/LICENSE-2.0>
 #
 """This module exports all platform resources from the `Peak-Platform`."""
+
 from __future__ import annotations
 
 from typing import List
 
-from peak.resources import artifacts, images, services, tenants, webapps, workflows
+from peak.resources import alerts, artifacts, images, services, tenants, users, webapps, workflows
 
-__all__: List[str] = ["workflows", "images", "artifacts", "webapps", "tenants", "services"]
+__all__: List[str] = ["alerts", "artifacts", "images", "services", "tenants", "users", "webapps", "workflows"]

peak/resources/alerts.py

@@ -0,0 +1,309 @@
+#
+# # Copyright © 2024 Peak AI Limited. or its affiliates. All Rights Reserved.
+# #
+# # Licensed under the Apache License, Version 2.0 (the "License"). You
+# # may not use this file except in compliance with the License. A copy of
+# # the License is located at:
+# #
+# # https://github.com/PeakBI/peak-sdk/blob/main/LICENSE
+# #
+# # or in the "license" file accompanying this file. This file is
+# # distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# # ANY KIND, either express or implied. See the License for the specific
+# # language governing permissions and limitations under the License.
+# #
+# # This file is part of the peak-sdk.
+# # see (https://github.com/PeakBI/peak-sdk)
+# #
+# # You should have received a copy of the APACHE LICENSE, VERSION 2.0
+# # along with this program. If not, see <https://apache.org/licenses/LICENSE-2.0>
+#
+
+"""Alerts client module."""
+
+from __future__ import annotations
+
+from typing import Any, Dict, Iterator, List, Literal, Optional, overload
+
+from peak.base_client import BaseClient
+from peak.constants import ContentType, HttpMethods
+from peak.session import Session
+
+
+class Alert(BaseClient):
+    """Client class for interacting with alerts resource."""
+
+    BASE_ENDPOINT = "notifications/api/v1"
+
+    @overload
+    def list_emails(
+        self,
+        date_from: Optional[str] = None,
+        date_to: Optional[str] = None,
+        page_size: Optional[int] = None,
+        page_number: Optional[int] = None,
+        count: Optional[int] = None,
+        *,
+        return_iterator: Literal[False],
+    ) -> Dict[str, Any]: ...
+
+    @overload
+    def list_emails(
+        self,
+        date_from: Optional[str] = None,
+        date_to: Optional[str] = None,
+        page_size: Optional[int] = None,
+        page_number: Optional[int] = None,
+        count: Optional[int] = None,
+        *,
+        return_iterator: Literal[True] = True,
+    ) -> Iterator[Dict[str, Any]]: ...
+
+    def list_emails(
+        self,
+        date_from: Optional[str] = None,
+        date_to: Optional[str] = None,
+        page_size: Optional[int] = None,
+        page_number: Optional[int] = None,
+        count: Optional[int] = None,
+        *,
+        return_iterator: bool = True,
+    ) -> Iterator[Dict[str, Any]] | Dict[str, Any]:
+        """Retrieve the history of emails sent.
+
+        REFERENCE:
+            🔗 `API Documentation <https://service.peak.ai/notifications/api-docs/index.htm#/emails/get_api_v1_emails>`__
+
+        Args:
+            date_from (str | None): The date after which the emails should be included (in ISO format).
+                It is 90 days from current date by default.
+            date_to (str | None): The date till which the emails should be included (in ISO format).
+                It is current date by default.
+            page_size (int | None): Number of emails to retrieve per page. It is 25 by default.
+            page_number (int | None): Page number to retrieve. Only used when return_iterator is False.
+            count (int | None): Number of emails required (Ordered by latest to earliest).
+                For example, if 5 is provided, it will return last 5 emails.
+                It is -1 by default which means it will return all the available emails within the given dates.
+            return_iterator (bool): Whether to return an iterator object or list of emails for a specified page number, defaults to True.
+
+        Returns:
+            Iterator[Dict[str, Any]] | Dict[str, Any]: an iterator object which returns an element per iteration, until there are no more elements to return.
+            If `return_iterator` is set to False, a dictionary containing the list and pagination details is returned instead.
+
+            Set `return_iterator` to True if you want automatic client-side pagination, or False if you want server-side pagination.
+
+        Raises:
+            BadRequestException: The given request parameters are invalid.
+            UnauthorizedException: The credentials are invalid.
+            ForbiddenException: The user does not have permission to perform the operation.
+            InternalServerErrorException: The server failed to process the request.
+        """
+        method, endpoint = HttpMethods.GET, f"{self.BASE_ENDPOINT}/emails"
+
+        params: Dict[str, Any] = {
+            "dateTo": date_to,
+            "dateFrom": date_from,
+            "pageSize": page_size,
+            "count": -1 if count is None else count,
+        }
+
+        if return_iterator:
+            return self.session.create_generator_request(
+                endpoint,
+                method,
+                content_type=ContentType.APPLICATION_JSON,
+                response_key="emails",
+                params=params,
+            )
+
+        return self.session.create_request(  # type: ignore[no-any-return]
+            endpoint,
+            method,
+            content_type=ContentType.APPLICATION_JSON,
+            params={**params, "pageNumber": page_number},
+        )
+
+    def send_email(
+        self,
+        body: Dict[str, Any],
+    ) -> Dict[str, Any]:
+        """Send an email to the specified recipients using the specified template.
+
+        REFERENCE:
+            🔗 `API Documentation <https://service.peak.ai/notifications/api-docs/index.htm#/Emails/post_api_v1_emails>`__
+
+        Args:
+            body (Dict[str, Any]): A dictionary containing the details of the email to send.
+
+        Returns:
+            Dict[str, Any]: A dictionary containing the ID of the email sent.
+
+        SCHEMA:
+            .. code-block:: json
+
+                {
+                    "recipients": ["string"],
+                    "cc": ["string"],
+                    "bcc": ["string"],
+                    "subject": "string",
+                    "templateName": "string",
+                    "templateParameters": {
+                        "string": "string"
+                    }
+                }
+
+        Raises:
+            UnauthorizedException: The credentials are invalid.
+            ForbiddenException: The user does not have permission to perform the operation.
+            NotFoundException: The given feature does not exist.
+            UnprocessableEntityException: The server was unable to process the request.
+            InternalServerErrorException: The server failed to process the request.
+        """
+        method, endpoint = HttpMethods.POST, f"{self.BASE_ENDPOINT}/emails"
+
+        return self.session.create_request(  # type: ignore[no-any-return]
+            endpoint,
+            method,
+            body=body,
+            content_type=ContentType.APPLICATION_JSON,
+        )
+
+    def describe_email(self, email_id: int) -> Dict[str, Any]:
+        """Retrieve the details of a specific email.
+
+        REFERENCE:
+            🔗 `API Documentation <https://service.peak.ai/notifications/api-docs/index.htm#/Emails/get_api_v1_emails__id_>`__
+
+        Args:
+            email_id (int): The ID of the email to retrieve.
+
+        Returns:
+            Dict[str, Any]: A dictionary containing the details of the email.
+
+        Raises:
+            UnauthorizedException: The credentials are invalid.
+            ForbiddenException: The user does not have permission to perform the operation.
+            NotFoundException: Email with the given ID does not exist.
+            UnprocessableEntityException: The server was unable to process the request.
+            InternalServerErrorException: The server failed to process the request.
+        """
+        method, endpoint = HttpMethods.GET, f"{self.BASE_ENDPOINT}/emails/{email_id}"
+
+        return self.session.create_request(endpoint, method, content_type=ContentType.APPLICATION_JSON)  # type: ignore[no-any-return]
+
+    @overload
+    def list_templates(
+        self,
+        page_size: Optional[int] = None,
+        page_number: Optional[int] = None,
+        name: Optional[str] = None,
+        scope: Optional[List[str]] = None,
+        *,
+        return_iterator: Literal[False],
+    ) -> Dict[str, Any]: ...
+
+    @overload
+    def list_templates(
+        self,
+        page_size: Optional[int] = None,
+        page_number: Optional[int] = None,
+        name: Optional[str] = None,
+        scope: Optional[List[str]] = None,
+        *,
+        return_iterator: Literal[True] = True,
+    ) -> Iterator[Dict[str, Any]]: ...
+
+    def list_templates(
+        self,
+        page_size: Optional[int] = None,
+        page_number: Optional[int] = None,
+        name: Optional[str] = None,
+        scope: Optional[List[str]] = None,
+        *,
+        return_iterator: bool = True,
+    ) -> Iterator[Dict[str, Any]] | Dict[str, Any]:
+        """Retrieve the history of emails sent.
+
+        REFERENCE:
+            🔗 `API Documentation <https://service.peak.ai/notifications/api-docs/index.htm#/Templates/get_api_v1_emails_templates>`__
+
+        Args:
+            name (str | None): The name of the email template
+            scope (List[str] | None): Filter out on the basis of the type of the template - global or custom.
+            page_size (int | None): Number of emails to retrieve per page. It is 25 by default.
+            page_number (int | None): Page number to retrieve. Only used when return_iterator is False.
+            return_iterator (bool): Whether to return an iterator object or list of emails for a specified page number, defaults to True.
+
+        Returns:
+            Iterator[Dict[str, Any]] | Dict[str, Any]: an iterator object which returns an element per iteration, until there are no more elements to return.
+            If `return_iterator` is set to False, a dictionary containing the list and pagination details is returned instead.
+
+            Set `return_iterator` to True if you want automatic client-side pagination, or False if you want server-side pagination.
+
+        Raises:
+            BadRequestException: The given request parameters are invalid.
+            UnauthorizedException: The credentials are invalid.
+            ForbiddenException: The user does not have permission to perform the operation.
+            InternalServerErrorException: The server failed to process the request.
+        """
+        method, endpoint = HttpMethods.GET, f"{self.BASE_ENDPOINT}/emails/templates"
+
+        params: Dict[str, Any] = {
+            "searchTerm": name,
+            "scope": scope,
+            "pageSize": page_size,
+        }
+
+        if return_iterator:
+            return self.session.create_generator_request(
+                endpoint,
+                method,
+                content_type=ContentType.APPLICATION_JSON,
+                response_key="templates",
+                params=params,
+            )
+
+        return self.session.create_request(  # type: ignore[no-any-return]
+            endpoint,
+            method,
+            content_type=ContentType.APPLICATION_JSON,
+            params={**params, "pageNumber": page_number},
+        )
+
+    def describe_template(self, template_name: str) -> Dict[str, Any]:
+        """Retrieve the details of a specific template.
+
+        REFERENCE:
+            🔗 `API Documentation <https://service.peak.ai/notifications/api-docs/index.htm#/Templates/get_api_v1_emails_templates__name_>`__
+
+        Args:
+            template_name (str): The name of the template to retrieve.
+
+        Returns:
+            Dict[str, Any]: A dictionary containing the details of the template.
+
+        Raises:
+            UnauthorizedException: The credentials are invalid.
+            ForbiddenException: The user does not have permission to perform the operation.
+            NotFoundException: Email with the given ID does not exist.
+            UnprocessableEntityException: The server was unable to process the request.
+            InternalServerErrorException: The server failed to process the request.
+        """
+        method, endpoint = HttpMethods.GET, f"{self.BASE_ENDPOINT}/emails/templates/{template_name}"
+
+        return self.session.create_request(endpoint, method, content_type=ContentType.APPLICATION_JSON)  # type: ignore[no-any-return]
+
+
+def get_client(session: Optional[Session] = None) -> Alert:
+    """Returns a Alert client, If no session is provided, a default session is used.
+
+    Args:
+        session (Optional[Session]): A Session Object. Default is None.
+
+    Returns:
+        Alert: The alert client object.
+    """
+    return Alert(session)
+
+
+__all__ = ["get_client"]

peak/resources/artifacts.py

@@ -40,8 +40,7 @@ class Artifact(BaseClient):
         page_number: Optional[int] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_artifacts(
@@ -50,8 +49,7 @@ class Artifact(BaseClient):
         page_number: Optional[int] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_artifacts(
         self,

peak/resources/images.py

@@ -55,8 +55,7 @@ class Image(BaseClient):
         tags: Optional[List[str]] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_images(
@@ -70,8 +69,7 @@ class Image(BaseClient):
         tags: Optional[List[str]] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_images(
         self,
@@ -152,8 +150,7 @@ class Image(BaseClient):
         tags: Optional[List[str]] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_image_versions(
@@ -167,8 +164,7 @@ class Image(BaseClient):
         tags: Optional[List[str]] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_image_versions(
         self,
@@ -556,8 +552,8 @@ class Image(BaseClient):
             PayloadTooLargeException: The artifact exceeds maximum size.
             InternalServerErrorException: The server failed to process the request.
         """
-        image_name = body["name"] if "name" in body else ""
-        version = body["version"] if "version" in body else ""
+        image_name = body.get("name", "")
+        version = body.get("version", "")
         response = (
             {} if not len(image_name) else self.list_images(page_size=100, return_iterator=False, name=image_name)
         )
@@ -698,8 +694,7 @@ class Image(BaseClient):
         build_status: Optional[List[str]] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_image_builds(
@@ -714,8 +709,7 @@ class Image(BaseClient):
         build_status: Optional[List[str]] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_image_builds(
         self,

peak/resources/services.py

@@ -44,8 +44,7 @@ class Service(BaseClient):
         service_type: Optional[List[str]] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_services(
@@ -57,8 +56,7 @@ class Service(BaseClient):
         service_type: Optional[List[str]] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_services(
         self,
@@ -155,7 +153,8 @@ class Service(BaseClient):
                     "description": "string",
                     "sessionStickiness": "boolean. Not required for 'api' service type.",
                     "entrypoint": "string",
-                    "healthCheckURL": "string"
+                    "healthCheckURL": "string",
+                    "minInstances": "number. Default is 1 and maximum is 2",
                 }
 
         Raises:
@@ -218,6 +217,7 @@ class Service(BaseClient):
                     "sessionStickiness": "boolean. Not required for 'api' service type.",
                     "entrypoint": "string",
                     "healthCheckURL": "string",
+                    "minInstances": "number. Default is 1 and maximum is 2",
                 }
 
         Raises:
@@ -276,6 +276,7 @@ class Service(BaseClient):
                     "sessionStickiness": "boolean. Not required for 'api' service type.",
                     "entrypoint": "string",
                     "healthCheckURL": "string",
+                    "minInstances": "number. Default is 1 and maximum is 2",
                 }
 
 
@@ -285,7 +286,7 @@ class Service(BaseClient):
             ForbiddenException: The user does not have permission to perform the operation.
             InternalServerErrorException: The server failed to process the request.
         """
-        service_name = body["name"] if "name" in body else ""
+        service_name = body.get("name", "")
         response = (
             {} if not len(service_name) else self.list_services(page_size=100, return_iterator=False, name=service_name)
         )

peak/resources/users.py

@@ -0,0 +1,93 @@
+#
+# # Copyright © 2024 Peak AI Limited. or its affiliates. All Rights Reserved.
+# #
+# # Licensed under the Apache License, Version 2.0 (the "License"). You
+# # may not use this file except in compliance with the License. A copy of
+# # the License is located at:
+# #
+# # https://github.com/PeakBI/peak-sdk/blob/main/LICENSE
+# #
+# # or in the "license" file accompanying this file. This file is
+# # distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
+# # ANY KIND, either express or implied. See the License for the specific
+# # language governing permissions and limitations under the License.
+# #
+# # This file is part of the peak-sdk.
+# # see (https://github.com/PeakBI/peak-sdk)
+# #
+# # You should have received a copy of the APACHE LICENSE, VERSION 2.0
+# # along with this program. If not, see <https://apache.org/licenses/LICENSE-2.0>
+#
+
+"""User client module."""
+from __future__ import annotations
+
+from typing import Dict, Optional
+
+from peak.base_client import BaseClient
+from peak.constants import ContentType, HttpMethods
+from peak.helpers import search_action
+from peak.session import Session
+from peak.validators import validate_action, validate_feature_path
+
+
+class User(BaseClient):
+    """Client class for interacting with users resource."""
+
+    BASE_ENDPOINT = "access-control/api/v2"
+
+    def check_permissions(self, feature_actions: Dict[str, str]) -> Dict[str, bool]:
+        """Check if the user has the specified permissions for the given features or subfeatures.
+
+        Args:
+            feature_actions (Dict[str, str]): A dictionary where keys are feature paths (e.g., "PRICING.GUARDRAILS")
+                and values are actions (e.g., "read" or "write").
+
+        Returns:
+            Dict[str, bool]: A dictionary where keys are the same feature paths and values are booleans
+                indicating whether the user has the specified action permission for that feature.
+
+        Raises:
+            UnauthorizedException: The credentials are invalid.
+            ForbiddenException: The user does not have permission to perform the operation.
+            NotFoundException: The given feature does not exist.
+            UnprocessableEntityException: The server was unable to process the request.
+            InternalServerErrorException: The server failed to process the request.
+        """
+        method, endpoint = HttpMethods.GET, f"{self.BASE_ENDPOINT}/access/permissions"
+
+        permissions_response = self.session.create_request(
+            endpoint,
+            method,
+            params={
+                "type": "app",
+            },
+            content_type=ContentType.APPLICATION_JSON,
+        )
+
+        result_permissions = {}
+
+        for feature_path, action in feature_actions.items():
+            validate_action(action)
+
+            search_result = search_action(feature_path, permissions_response, action)
+            validate_feature_path(search_result=search_result, feature_path=feature_path)
+
+            result_permissions[feature_path] = search_result["has_permission"]
+
+        return result_permissions
+
+
+def get_client(session: Optional[Session] = None) -> User:
+    """Returns a User client, If no session is provided, a default session is used.
+
+    Args:
+        session (Optional[Session]): A Session Object. Default is None.
+
+    Returns:
+        User: The user client object.
+    """
+    return User(session)
+
+
+__all__ = ["get_client"]

peak/resources/webapps.py

@@ -49,8 +49,7 @@ class Webapp(BaseClient):
         name: Optional[str] = None,
         *,
         return_iterator: Literal[False],
-    ) -> Dict[str, Any]:
-        ...
+    ) -> Dict[str, Any]: ...
 
     @overload
     def list_webapps(
@@ -61,8 +60,7 @@ class Webapp(BaseClient):
         name: Optional[str] = None,
         *,
         return_iterator: Literal[True] = True,
-    ) -> Iterator[Dict[str, Any]]:
-        ...
+    ) -> Iterator[Dict[str, Any]]: ...
 
     def list_webapps(
         self,
@@ -253,7 +251,7 @@ class Webapp(BaseClient):
             ForbiddenException: The user does not have permission to perform the operation.
             InternalServerErrorException: The server failed to process the request.
         """
-        webapp_name = body["name"] if "name" in body else ""
+        webapp_name = body.get("name", "")
         response = (
             {} if not len(webapp_name) else self.list_webapps(page_size=100, return_iterator=False, name=webapp_name)
         )