zscaler-sdk-python 0.6.1__tar.gz → 0.6.2__tar.gz

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/PKG-INFO

@@ -1,23 +1,23 @@
 Metadata-Version: 2.1
 Name: zscaler-sdk-python
-Version: 0.6.1
+Version: 0.6.2
 Summary: Official Python SDK for the Zscaler Products (Beta)
 Home-page: https://github.com/zscaler/zscaler-sdk-python
 License: MIT
 Keywords: zscaler,sdk,zpa,zia,zdx,zcc,zcon
 Author: Zscaler, Inc.
 Author-email: devrel@zscaler.com
-Requires-Python: >=3.8,<4.0
+Requires-Python: >=3.9,<4.0
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.8
 Classifier: Topic :: Security
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Provides-Extra: dev

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "zscaler-sdk-python"
-version = "0.6.1"
+version = "0.6.2"
 description = "Official Python SDK for the Zscaler Products (Beta)"
 authors = ["Zscaler, Inc. <devrel@zscaler.com>"]
 license = "MIT"
@@ -28,7 +28,7 @@ packages = [
 "Bug Tracker" = "https://github.com/zscaler/zscaler-sdk-python/issues"
 
 [tool.poetry.dependencies]
-python = ">=3.8,<4.0"
+python = ">=3.9,<4.0"
 arrow = "*"
 certifi = ">=2024.2.2"
 charset-normalizer = "*"
@@ -55,15 +55,15 @@ okta = ">=2.9.7"
 
 [tool.poetry.dev-dependencies]
 black = ">=24.3.0"
-pytest = ">=8.2.1"
-pytest-asyncio = ">=0.23.7"
+pytest = ">=8.2.2"
+pytest-asyncio = "^0.23.8"
 pytest-mock = "*"
-pytest-recording = "*"
+pytest-recording = "^0.13.2"
 pytest-cov = "*"
-pyfakefs = "*"
+pyfakefs = "^5.6.0"
 isort = "*"
 wheel = "*"
-sphinx = "*"
+sphinx = "^7.4.6"
 sphinx-autobuild = "*"
 sphinx_rtd_theme = "*"
 

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/zscaler/__init__.py

@@ -29,7 +29,7 @@ __license__ = "MIT"
 __contributors__ = [
     "William Guilherme",
 ]
-__version__ = "0.6.1"
+__version__ = "0.6.2"
 
 from zscaler.zia import ZIAClientHelper  # noqa
 from zscaler.zpa import ZPAClientHelper  # noqa

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/zscaler/constants.py

@@ -14,7 +14,7 @@ ZPA_BASE_URLS = {
 
 DEV_AUTH_URL = "https://authn1.dev.zpath.net/authn/v1/oauth/token"
 
-RETRYABLE_STATUS_CODES = {409, 429, 500, 502, 503, 504}
+RETRYABLE_STATUS_CODES = {409, 412, 429, 500, 502, 503, 504}
 MAX_RETRIES = 5
 BACKOFF_FACTOR = 1
 BACKOFF_BASE_DURATION = 2

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/zscaler/zia/__init__.py

@@ -12,6 +12,7 @@ from box import Box, BoxList
 from zscaler import __version__
 from zscaler.cache.no_op_cache import NoOpCache
 from zscaler.cache.zscaler_cache import ZscalerCache
+from zscaler.constants import MAX_RETRIES
 from zscaler.errors.http_error import HTTPError, ZscalerAPIError
 from zscaler.exceptions.exceptions import HTTPException, ZscalerAPIException
 from zscaler.logger import setup_logging
@@ -118,7 +119,7 @@ class ZIAClientHelper(ZIAClient):
         self.sandbox_token = kw.get("sandbox_token") or os.getenv(f"{self._env_base}_SANDBOX_TOKEN")
         self.timeout = timeout
         self.fail_safe = fail_safe
-        cache_enabled = os.environ.get("ZSCALER_CLIENT_CACHE_ENABLED", "true").lower() == "true"
+        cache_enabled = os.environ.get("ZSCALER_CLIENT_CACHE_ENABLED", "false").lower() == "true"
         if cache is None:
             if cache_enabled:
                 ttl = int(os.environ.get("ZSCALER_CLIENT_CACHE_DEFAULT_TTL", 3600))
@@ -168,13 +169,11 @@ class ZIAClientHelper(ZIAClient):
         if self.auth_details is None:
             return True
         now = datetime.datetime.now()
-        if self.auth_details["passwordExpiryTime"] > 0 and (
-            self.session_refreshed + datetime.timedelta(seconds=-self.session_timeout_offset) < now
-        ):
+        if self.auth_details["passwordExpiryTime"] > 0 and (self.session_refreshed - self.session_timeout_offset < now):
             return True
         return False
 
-    @retry_with_backoff(retries=5)
+    @retry_with_backoff(MAX_RETRIES)
     def authenticate(self) -> Box:
         """
         Creates a ZIA authentication session.

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/zscaler/zia/locations.py

@@ -482,7 +482,7 @@ class LocationsAPI:
             status_code = response.status_code
             raise Exception(f"API call failed with status {status_code}: {response.json()}")
         return response
-    
+
     def list_location_groups(self) -> BoxList:
         """
         Return a list of location groups in ZIA.
@@ -602,7 +602,7 @@ class LocationsAPI:
         Keyword Args:
             group_type (str): The location group's type (i.e., Static or Dynamic).
             last_mod_user (str): The admin who modified the location group last.
-            version (int): The version parameter is for Zscaler internal use only. The version is used by the service for backup operations.
+            version (int): The version parameter is for Zscaler internal use only. Used by the service for backup operations.
             name (str): The location group's name.
             comments (str): Additional comments or information about the location group.
             location_id (int): The unique identifier for a location within a location group.
@@ -615,8 +615,8 @@ class LocationsAPI:
             >>> location = zia.locations.list_location_groups_count(group_type='Static', name='Corporate')
         """
         params = {}
-        optional_params = ['group_type', 'last_mod_user', 'version', 'name', 'comments', 'location_id']
-        
+        optional_params = ["group_type", "last_mod_user", "version", "name", "comments", "location_id"]
+
         for key in optional_params:
             if key in kwargs:
                 params[key] = kwargs[key]

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/zscaler/zia/workload_groups.py

@@ -26,14 +26,14 @@ class WorkloadGroupsAPI:
 
     def list_groups(self, **kwargs) -> BoxList:
         """
-        Returns a list of all firewall filter rules.
+        Returns a list of all workload groups configured in the ZIA Admin Portal.
 
         Returns:
-            :obj:`BoxList`: The list of firewall filter rules
+            :obj:`BoxList`: The list of workload groups
 
         Examples:
-            >>> for rule in zia.workload_groups.list_groups():
-            ...    pprint(rule)
+            >>> for workloads in zia.workload_groups.list_groups():
+            ...    pprint(workloads)
 
         """
         response = self.rest.get("/workloadGroups")
@@ -43,6 +43,19 @@ class WorkloadGroupsAPI:
 
     # Search Workload Group By Name
     def get_group_by_name(self, name):
+        """
+        Retrieves a specific workload group by its name.
+
+        Args:
+            name (str): The name of the workload group  to retrieve.
+
+        Returns:
+            :obj:`Box`: The workload group  if found, otherwise None.
+
+        Examples:
+            >>> workload = zia.workload_groups.get_group_by_name('BD_WORKLOAD_GROUP01')
+            ...    print(workload)
+        """
         groups = self.list_groups()
         for group in groups:
             if group.get("name") == name:
@@ -51,6 +64,19 @@ class WorkloadGroupsAPI:
 
     # Search Workload Group By ID
     def get_group_by_id(self, group_id):
+        """
+        Retrieves a specific workload group by its unique identifier.
+
+        Args:
+            profile_id (str): The ID of the workload group  to retrieve.
+
+        Returns:
+            :obj:`Box`: The workload group if found, otherwise None.
+
+        Examples:
+            >>> workload = zia.get_group_by_name.get_group_by_id('12345')
+            ...    print(workload)
+        """
         groups = self.list_groups()
         for group in groups:
             if group.get("id") == group_id:

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/zscaler/zpa/__init__.py

@@ -11,7 +11,7 @@ from box import BoxList
 from zscaler import __version__
 from zscaler.cache.no_op_cache import NoOpCache
 from zscaler.cache.zscaler_cache import ZscalerCache
-from zscaler.constants import ZPA_BASE_URLS, DEV_AUTH_URL
+from zscaler.constants import ZPA_BASE_URLS, DEV_AUTH_URL, MAX_RETRIES
 from zscaler.errors.http_error import HTTPError, ZscalerAPIError
 from zscaler.exceptions.exceptions import HTTPException, ZscalerAPIException
 from zscaler.logger import setup_logging
@@ -148,7 +148,7 @@ class ZPAClientHelper(ZPAClient):
                 "User-Agent": self.user_agent,
             }
 
-    @retry_with_backoff(retries=5)
+    @retry_with_backoff(MAX_RETRIES)
     def login(self):
         params = {"client_id": self.client_id, "client_secret": self.client_secret}
         headers = {

{zscaler_sdk_python-0.6.1 → zscaler_sdk_python-0.6.2}/zscaler/zpa/isolation.py

@@ -368,7 +368,7 @@ class IsolationAPI:
                 return profile
         return None
 
-    def list_cbi_profiles(self: str) -> Box:
+    def list_cbi_profiles(self) -> Box:
         """
         Returns information on the specified Cloud browser isolation.