zscaler-sdk-python 1.5.3__tar.gz → 1.5.5__tar.gz

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: zscaler-sdk-python
-Version: 1.5.3
+Version: 1.5.5
 Summary: Official Python SDK for the Zscaler Products
 Home-page: https://github.com/zscaler/zscaler-sdk-python
 License: MIT

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "zscaler-sdk-python"
-version = "1.5.3"
+version = "1.5.5"
 description = "Official Python SDK for the Zscaler Products"
 authors = ["Zscaler, Inc. <devrel@zscaler.com>"]
 license = "MIT"

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/zscaler/__init__.py

@@ -29,7 +29,7 @@ __license__ = "MIT"
 __contributors__ = [
     "William Guilherme",
 ]
-__version__ = "1.5.3"
+__version__ = "1.5.5"
 
 
 from zscaler.oneapi_client import Client as ZscalerClient  # noqa

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/zscaler/oneapi_response.py

@@ -211,6 +211,35 @@ class ZscalerAPIResponse:
         return results, self, None
 
 
+    # def _fetch_next_page(self):
+    #     if not self._has_next():
+    #         logger.debug("No more pages to fetch")
+    #         return [], None
+
+    #     if self._service_type == "ZDX":
+    #         self._params["offset"] = self._next_offset
+    #     else:
+    #         self._page += 1
+    #         self._params["page"] = self._page
+
+    #     logger.debug(f"Requesting next page with params: {self._params}")
+
+    #     req = {
+    #         "method": "GET",
+    #         "url": self._url,
+    #         "headers": self._headers,
+    #         "params": self._params,
+    #         "uuid": uuid.uuid4(),
+    #     }
+    #     _, _, response_body, error = self._request_executor.fire_request(req)
+
+    #     if error:
+    #         logger.error(f"Error fetching the next page: {error}")
+    #         return None, error
+
+    #     self._build_json_response(response_body)
+    #     return self._list, None
+
     def _fetch_next_page(self):
         if not self._has_next():
             logger.debug("No more pages to fetch")
@@ -220,7 +249,13 @@ class ZscalerAPIResponse:
             self._params["offset"] = self._next_offset
         else:
             self._page += 1
-            self._params["page"] = self._page
+
+            # ✅ Patch: support alternate pagination keys (e.g., Shadow IT)
+            if "pageNumber" in self._params:
+                self._params["pageNumber"] = str(self._page)
+                self._params.pop("page", None)  # Ensure no conflict
+            else:
+                self._params["page"] = self._page
 
         logger.debug(f"Requesting next page with params: {self._params}")
 
@@ -263,3 +298,9 @@ class ZscalerAPIResponse:
             # If the API doesn't give a clear signal that there's another page, we may need a heuristic.
             logger.debug("Has next page for ZIA/ZCC: %s", has_next)
             return has_next
+
+    def __str__(self):
+        try:
+            return json.dumps(self.get_results(), indent=2)
+        except Exception as e:
+            return f"<ZscalerAPIResponse error displaying results: {e}>"

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/zscaler/zia/cloud_firewall.py

@@ -1872,7 +1872,7 @@ class FirewallResourcesAPI(APIClient):
             Gets a list of all network services.
 
             >>> service_list, response, error = zia.cloud_firewall.list_network_services():
-            ... if error:
+            >>> if error:
             ...     print(f"Error listing network services: {error}")
             ...     return
             ... print(f"Total network services found: {len(service_list)}")

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/zscaler/zia/models/bandwidth_classes.py

@@ -34,9 +34,10 @@ class BandwidthClasses(ZscalerObject):
 
         if config:
             self.id = config["id"] if "id" in config else None
+            self.name = config["name"] if "name" in config else None
             self.is_name_l10n_tag = config["isNameL10nTag"] if "isNameL10nTag" in config else None
             self.type = config["type"] if "type" in config else None
-            self.name = config["name"] if "name" in config else None
+            self.file_size = config["fileSize"] if "fileSize" in config else None
             self.applications = ZscalerCollection.form_list(config["applications"] if "applications" in config else [], str)
             self.web_applications = ZscalerCollection.form_list(
                 config["webApplications"] if "webApplications" in config else [], str
@@ -47,13 +48,14 @@ class BandwidthClasses(ZscalerObject):
             )
         else:
             self.id = None
-            self.is_name_l10n_tag = None
-            self.type = None
             self.name = None
+            self.file_size = None
+            self.type = None
             self.applications = []
             self.web_applications = []
             self.urls = []
             self.url_categories = []
+            self.is_name_l10n_tag = None
 
     def request_format(self):
         """
@@ -62,13 +64,14 @@ class BandwidthClasses(ZscalerObject):
         parent_req_format = super().request_format()
         current_obj_format = {
             "id": self.id,
-            "isNameL10nTag": self.is_name_l10n_tag,
-            "type": self.type,
             "name": self.name,
+            "type": self.type,
+            "fileSize": self.file_size,
             "applications": self.applications,
             "webApplications": self.web_applications,
             "urls": self.urls,
             "urlCategories": self.url_categories,
+            "isNameL10nTag": self.is_name_l10n_tag,
         }
         parent_req_format.update(current_obj_format)
         return parent_req_format

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/zscaler/zia/models/shadow_it_report.py

@@ -251,15 +251,34 @@ class ShadowITReport(ZscalerObject):
 
 class CloudapplicationsAndTags(ZscalerObject):
     def __init__(self, config=None):
+        """
+        Initialize the Cloud Applications and Tags model based on API response.
+
+        Args:
+            config (dict): A dictionary representing the Cloud Applications and Tags configuration.
+        """
         super().__init__(config)
-        self.id = config["id"] if "id" in config else None
-        self.name = config["name"] if "name" in config else None
+    
+        if config:
+            self.id = config["id"] if "id" in config else None
+            self.name = config["name"] if "name" in config else None
+        else:
+            # Initialize with default None or 0 values
+            self.id = None
+            self.name = None
 
     def request_format(self):
-        return {
+        """
+        Return the object as a dictionary in the format expected for API requests.
+        """
+        parent_req_format = super().request_format()
+        current_obj_format = {
             "id": self.id,
             "name": self.name,
         }
+        parent_req_format.update(current_obj_format)
+        return parent_req_format
+
 
 
 class CloudApplicationBulkUpdate(ZscalerObject):

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/zscaler/zia/pac_files.py

@@ -41,12 +41,35 @@ class PacFilesAPI(APIClient):
             query_params {dict}: Map of query parameters for the request.
                 ``[query_params.search]`` {str}: Search string for filtering results.
 
+                ``[query_params.filter]`` {str}: Excludes specific information about the PAC file
+                    from the response such as the PAC file content
+                    Available values: pac_content
+
+                ``[query_params.page]`` {str}: Specifies the page offset
+
+                ``[query_params.page_size]`` {str}: Specifies the page size. The default size is 100.
+
         Returns:
             tuple: A tuple containing (list of Pac Files instances, Response, error)
 
         Examples:
-            List all Pac Files using default settings:
-            >>> pac_files, response, err = zia.pac_files.list_pac_files()
+            Retrieves the list of all PAC files in deployed state
+
+            >>> pac_file_list, _, error = client.zia.pac_files.list_pac_files()
+            >>> if error:
+            ...     print(f"Error listing all pac files: {error}")
+            ...     return
+            ... print(f"Total pac files found: {len(pac_file_list)}")
+
+        Examples:
+            Retrieves the list of all PAC files in deployed state excluding pac_content
+
+            >>> pac_file_list, _, error = client.zia.pac_files.list_pac_files(query_params={
+            ... 'search': 'kerberos.pac', 'filter':'pac_content'})
+            >>> if error:
+            ...     print(f"Error listing all pac files: {error}")
+            ...     return
+            ... print(f"Total pac files found: {len(pac_file_list)}")
 
         """
         http_method = "get".upper()
@@ -59,17 +82,14 @@ class PacFilesAPI(APIClient):
 
         query_params = query_params or {}
 
-        # Prepare request body and headers
         body = {}
         headers = {}
 
-        # Create the request
         request, error = self._request_executor.create_request(http_method, api_url, body, headers, params=query_params)
 
         if error:
             return (None, None, error)
 
-        # Execute the request
         response, error = self._request_executor.execute(request)
 
         if error:
@@ -83,15 +103,42 @@ class PacFilesAPI(APIClient):
             return (None, response, error)
         return (result, response, None)
 
-    def get_pac_file(self, pac_id: int, query_params=None) -> tuple:
+    def get_pac_file(self, pac_id: int, query_params=None,) -> tuple:
         """
         Retrieves all versions of a PAC file based on the specified ID
 
         Args:
+            query_params {dict}: Map of query parameters for the request.
+
+                ``[query_params.filter]`` {str}: Excludes specific information about the PAC file
+                    from the response such as the PAC file content. Available values: `pac_content`
+
             pac_id (int): The unique identifier for the Pac File.
 
         Returns:
             tuple: A tuple containing (Pac File instance, Response, error).
+
+        Examples:
+            Gets a list of all pac files including the pac content.
+
+            >>> pac_files, _, error = client.zia.pac_files.get_pac_file('18805')
+            >>> if error:
+            ...     print(f"Error fetching PAC files by ID: {error}")
+            ...     return
+            ... print(f"Total PAC file versions fetched: {len(pac_files)}")
+            ... for version in pac_files:
+            ...     print(version.as_dict())
+
+            Gets a list of all pac files excluding the pac content.
+
+            >>> pac_files, _, error = client.zia.pac_files.get_pac_file('18805', query_params={'filter': 'pac_content'})
+            >>> if error:
+            ...     print(f"Error fetching PAC files by ID: {error}")
+            ...     return
+            ... print(f"Total PAC file versions fetched: {len(pac_files)}")
+            ... for version in pac_files:
+            ...     print(version.as_dict())
+
         """
         http_method = "get".upper()
         api_url = format_url(
@@ -113,10 +160,11 @@ class PacFilesAPI(APIClient):
             return (None, response, error)
 
         try:
-            result = PacFiles(self.form_response_body(response.get_body()))
+            result = []
+            for item in response.get_results():
+                result.append(PacFiles(self.form_response_body(item)))
         except Exception as error:
             return (None, response, error)
-
         return (result, response, None)
 
     def get_pac_file_version(self, pac_id: int, pac_version: int, query_params=None) -> tuple:
@@ -124,23 +172,32 @@ class PacFilesAPI(APIClient):
         Returns the PAC file version details for a given PAC ID and version.
 
         Args:
+            query_params {dict}: Map of query parameters for the request.
+
+                ``[query_params.filter]`` {str, optional}: Excludes specific information about the PAC file
+                                    the response such as the PAC file content.
+                                    Accepts only the value 'pac_content'
+
             pac_id (str): The unique identifier for the PAC file.
             pac_version (str): The specific version of the PAC file.
-            filter (str, optional): Excludes specific information about the PAC file from
-                                    the response such as the PAC file content.
-                                    Accepts only the value 'pac_content'.
 
         Returns:
             :obj:`Tuple`: The PAC file version resource record.
 
-        Example:
-            >>> pac_file_version = zia.get_pac_file_version('12345', '1', filter='pac_content')
+            Gets a list of all pac files excluding the pac content.
+
+            >>> pac_files, _, error = client.zia.pac_files.get_pac_file_version(pac_id='18805', pac_version='1',
+            ... query_params={'filter': 'pac_content'})
+            >>> if error:
+            ...     print(f"Error fetching pac_file by ID: {error}")
+            ...     return
+            ... print(f"Fetched pac_file by ID: {pac_file.as_dict()}")
         """
         http_method = "get".upper()
         api_url = format_url(
             f"""
             {self._zia_base_endpoint}
-            /pacFiles/{pac_id}/version
+            /pacFiles/{pac_id}/version/{pac_version}
         """
         )
 
@@ -185,14 +242,13 @@ class PacFilesAPI(APIClient):
 
         Example:
             >>> pac_file = zia.add_pac_file(
-                    name="Test_Pac_File_01",
-                    description="Test_Pac_File_01",
-                    domain="bd-hashicorp.com",
-                    pac_commit_message="Test_Pac_File_01",
-                    pac_verification_status="VERIFY_NOERR",
-                    pac_version_status="DEPLOYED",
-                    pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }"
-                )
+            ...     name="Test_Pac_File_01",
+            ...     description="Test_Pac_File_01",
+            ...     domain="bd-hashicorp.com",
+            ...     pac_commit_message="Test_Pac_File_01",
+            ...     pac_verification_status="VERIFY_NOERR",
+            ...     pac_version_status="DEPLOYED",
+            ...     pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }")
         """
         # Validate the PAC file content before proceeding
         pac_content = kwargs.get("pac_content")
@@ -262,17 +318,17 @@ class PacFilesAPI(APIClient):
 
         Example:
             >>> pac_file = zia.clone_pac_file(
-                    pac_id=12345,
-                    pac_version="1",
-                    name="Cloned_Pac_File_01",
-                    description="Cloned_Pac_File_01",
-                    domain="bd-hashicorp.com",
-                    pac_commit_message="Clone of Test_Pac_File_01",
-                    pac_verification_status="VERIFY_NOERR",
-                    pac_version_status="DEPLOYED",
-                    pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }",
-                    delete_version=5
-                )
+            ...     pac_id=12345,
+            ...     pac_version="1",
+            ...     name="Cloned_Pac_File_01",
+            ...     description="Cloned_Pac_File_01",
+            ...     domain="bd-hashicorp.com",
+            ...     pac_commit_message="Clone of Test_Pac_File_01",
+            ...     pac_verification_status="VERIFY_NOERR",
+            ...     pac_version_status="DEPLOYED",
+            ...     pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }",
+            ...     delete_version=5
+            ... )
         """
         # Step 1: Validate the PAC content
         pac_content = kwargs.get("pac_content")
@@ -354,11 +410,11 @@ class PacFilesAPI(APIClient):
             >>> '''
             >>> validation_result, response, error = client.zia.validate_pac_file(pac_file_content)
             >>> if error:
-            >>>     print(f"Validation failed: {error}")
-            >>> elif validation_result.get("success", False):
-            >>>     print("PAC file is valid.")
-            >>> else:
-            >>>     print("PAC file validation failed.")
+            ...     print(f"Validation failed: {error}")
+            ... elif validation_result.get("success", False):
+            ...     print("PAC file is valid.")
+            ... else:
+            ...     print("PAC file validation failed.")
         """
         http_method = "post".upper()
         api_url = format_url(
@@ -426,18 +482,18 @@ class PacFilesAPI(APIClient):
 
         Example:
             >>> pac_file = zia.update_pac_file(
-                    pac_id=12345,
-                    pac_version=1,
-                    pac_version_action="DEPLOY",
-                    name="Update_Pac_File_01",
-                    description="Update_Pac_File_01",
-                    domain="bd-hashicorp.com",
-                    pac_commit_message="Update_Pac_File_01",
-                    pac_verification_status="VERIFY_NOERR",
-                    pac_version_status="DEPLOYED",
-                    pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }",
-                    new_lkg_ver=5
-                )
+            ...     pac_id=12345,
+            ...     pac_version=1,
+            ...     pac_version_action="DEPLOY",
+            ...     name="Update_Pac_File_01",
+            ...     description="Update_Pac_File_01",
+            ...     domain="bd-hashicorp.com",
+            ...     pac_commit_message="Update_Pac_File_01",
+            ...     pac_verification_status="VERIFY_NOERR",
+            ...     pac_version_status="DEPLOYED",
+            ...     pac_content="function FindProxyForURL(url, host) { return 'PROXY gateway.example.com:80'; }",
+            ...     new_lkg_ver=5
+            ... )
         """
         http_method = "put".upper()
         api_url = format_url(
@@ -486,6 +542,13 @@ class PacFilesAPI(APIClient):
 
         Returns:
             tuple: A tuple containing the response object and error (if any).
+
+        Example:
+            >>> _, _, error = client.zia.pac_files.delete_pac_file('18805')
+            >>> if error:
+            ...     print(f"Error deleting pac file: {error}")
+            ...     return
+            ... print(f"Pac File with ID '18805'} deleted successfully.")
         """
         http_method = "delete".upper()
         api_url = format_url(

{zscaler_sdk_python-1.5.3 → zscaler_sdk_python-1.5.5}/zscaler/zia/shadow_it_report.py

@@ -47,13 +47,21 @@ class ShadowITAPI(APIClient):
         """
         Gets the list of predefined and custom cloud applications
 
+        Args:
+            query_params (dict):
+                Map of query parameters for the request.
+
+                ``[query_params.page_number]`` (int): Specifies the page number. The numbering starts at 0.
+
+                ``[query_params.limit]`` (int): Specifies the maximum number of cloud applications that must be retrieved in a page
+
         Returns:
             obj:`Tuple`: A list of cloud applications.
 
         Examples:
             Get a list of 10 custom cloud applications:
 
-            >>> app_list, response, error = client.zia.shadow_it_report.list_apps(query_params={'limit': '10'})
+            >>> app_list, response, error = client.zia.shadow_it_report.list_apps(query_params={'page_number': 1, 'limit': '10'})
             ... if error:
             ...     print(f"Error listing custom cloud applications: {error}")
             ...     return
@@ -83,7 +91,7 @@ class ShadowITAPI(APIClient):
 
         if error:
             return (None, response, error)
-
+    
         try:
             result = []
             for item in response.get_results():