introduce descopeResponse to sdk

Author: ruvenzx

descope/http_client.py

@@ -43,6 +43,102 @@ def sdk_version():
 }
 
 
+class DescopeResponse:
+    def __init__(self, response):
+        self.raw = response
+        self._json_data = None
+    
+    def json(self):
+        if self._json_data is None:
+            self._json_data = self.raw.json()
+        return self._json_data
+    
+    # Make it dict-compatible for backward compatibility
+    def __getitem__(self, key):
+        return self.json()[key]
+    
+    def __contains__(self, key):
+        return key in self.json()
+    
+    def keys(self):
+        return self.json().keys()
+    
+    def values(self):
+        return self.json().values()
+    
+    def items(self):
+        return self.json().items()
+    
+    def get(self, key, default=None):
+        return self.json().get(key, default)
+    
+    # Make it print like a dict for backward compatibility
+    def __str__(self):
+        return str(self.json())
+    
+    def __repr__(self):
+        return repr(self.json())
+    
+    # Make it behave like a dict in boolean context
+    def __bool__(self):
+        return bool(self.json())
+    
+    def __len__(self):
+        return len(self.json())
+    
+    # Equality comparison - compare the underlying JSON data
+    def __eq__(self, other):
+        if isinstance(other, DescopeResponse):
+            return self.json() == other.json()
+        # Allow comparison with dict/list directly
+        return self.json() == other
+    
+    def __ne__(self, other):
+        return not self.__eq__(other)
+    
+    # Iteration support for list responses
+    def __iter__(self):
+        return iter(self.json())
+    
+    # Hashing support (for use in sets/dicts)
+    def __hash__(self):
+        json_data = self.json()
+        if isinstance(json_data, dict):
+            return hash(tuple(sorted(json_data.items())))
+        elif isinstance(json_data, list):
+            return hash(tuple(json_data))
+        return hash(json_data)
+    
+    # Delegate properties
+    @property
+    def headers(self):
+        return self.raw.headers
+    
+    @property
+    def status_code(self):
+        return self.raw.status_code
+    
+    @property
+    def cookies(self):
+        return self.raw.cookies
+    
+    @property
+    def text(self):
+        return self.raw.text
+    
+    @property
+    def content(self):
+        return self.raw.content
+    
+    @property
+    def url(self):
+        return self.raw.url
+    
+    @property
+    def ok(self):
+        return self.raw.ok
+
+
 class HTTPClient:
     def __init__(
         self,
@@ -80,7 +176,7 @@ def get(
         params=None,
         allow_redirects: Optional[bool] = True,
         pswd: Optional[str] = None,
-    ) -> requests.Response:
+    ) -> DescopeResponse:
         response = requests.get(
             f"{self.base_url}{uri}",
             headers=self._get_default_headers(pswd),
@@ -90,7 +186,7 @@ def get(
             timeout=self.timeout_seconds,
         )
         self._raise_from_response(response)
-        return response
+        return DescopeResponse(response)
 
     def post(
         self,
@@ -100,7 +196,7 @@ def post(
         params=None,
         pswd: Optional[str] = None,
         base_url: Optional[str] = None,
-    ) -> requests.Response:
+    ) -> DescopeResponse:
         response = requests.post(
             f"{base_url or self.base_url}{uri}",
             headers=self._get_default_headers(pswd),
@@ -111,7 +207,7 @@ def post(
             timeout=self.timeout_seconds,
         )
         self._raise_from_response(response)
-        return response
+        return DescopeResponse(response)
 
     def patch(
         self,
@@ -120,7 +216,7 @@ def patch(
         body: Optional[Union[dict, list[dict], list[str]]],
         params=None,
         pswd: Optional[str] = None,
-    ) -> requests.Response:
+    ) -> DescopeResponse:
         response = requests.patch(
             f"{self.base_url}{uri}",
             headers=self._get_default_headers(pswd),
@@ -131,15 +227,15 @@ def patch(
             timeout=self.timeout_seconds,
         )
         self._raise_from_response(response)
-        return response
+        return DescopeResponse(response)
 
     def delete(
         self,
         uri: str,
         *,
         params=None,
         pswd: Optional[str] = None,
-    ) -> requests.Response:
+    ) -> DescopeResponse:
         response = requests.delete(
             f"{self.base_url}{uri}",
             params=params,
@@ -149,7 +245,7 @@ def delete(
             timeout=self.timeout_seconds,
         )
         self._raise_from_response(response)
-        return response
+        return DescopeResponse(response)
 
     def get_default_headers(self, pswd: Optional[str] = None) -> dict:
         return self._get_default_headers(pswd)

descope/management/access_key.py

@@ -64,7 +64,7 @@ def create(
                 permitted_ips,
             ),
         )
-        return response.json()
+        return response
 
     def load(
         self,
@@ -88,7 +88,7 @@ def load(
             uri=MgmtV1.access_key_load_path,
             params={"id": id},
         )
-        return response.json()
+        return response
 
     def search_all_access_keys(
         self,
@@ -114,7 +114,7 @@ def search_all_access_keys(
             MgmtV1.access_keys_search_path,
             body={"tenantIds": tenant_ids},
         )
-        return response.json()
+        return response
 
     def update(
         self,

descope/management/authz.py

@@ -68,7 +68,7 @@ def load_schema(self) -> dict:
         response = self._http.post(
             MgmtV1.authz_schema_load,
         )
-        return response.json()["schema"]
+        return response["schema"]
 
     def save_namespace(
         self, namespace: dict, old_name: str = "", schema_name: str = ""
@@ -265,7 +265,7 @@ def has_relations(
             MgmtV1.authz_re_has_relations,
             body={"relationQueries": relation_queries},
         )
-        return response.json()["relationQueries"]
+        return response["relationQueries"]
 
     def who_can_access(
         self, resource: str, relation_definition: str, namespace: str
@@ -289,7 +289,7 @@ def who_can_access(
                 "namespace": namespace,
             },
         )
-        return response.json()["targets"]
+        return response["targets"]
 
     def resource_relations(self, resource: str) -> List[dict]:
         """
@@ -306,7 +306,7 @@ def resource_relations(self, resource: str) -> List[dict]:
             MgmtV1.authz_re_resource,
             body={"resource": resource},
         )
-        return response.json()["relations"]
+        return response["relations"]
 
     def targets_relations(self, targets: List[str]) -> List[dict]:
         """
@@ -323,7 +323,7 @@ def targets_relations(self, targets: List[str]) -> List[dict]:
             MgmtV1.authz_re_targets,
             body={"targets": targets},
         )
-        return response.json()["relations"]
+        return response["relations"]
 
     def what_can_target_access(self, target: str) -> List[dict]:
         """
@@ -340,7 +340,7 @@ def what_can_target_access(self, target: str) -> List[dict]:
             MgmtV1.authz_re_target_all,
             body={"target": target},
         )
-        return response.json()["relations"]
+        return response["relations"]
 
     def what_can_target_access_with_relation(
         self, target: str, relation_definition: str, namespace: str
@@ -365,7 +365,7 @@ def what_can_target_access_with_relation(
                 "namespace": namespace,
             },
         )
-        return response.json()["relations"]
+        return response["relations"]
 
     def get_modified(self, since: Optional[datetime] = None) -> dict:
         """
@@ -388,4 +388,4 @@ def get_modified(self, since: Optional[datetime] = None) -> dict:
                 )
             },
         )
-        return response.json()["relations"]
+        return response["relations"]

descope/management/fga.py

@@ -133,7 +133,7 @@ def check(
         return list(
             map(
                 lambda tuple: {"relation": tuple["tuple"], "allowed": tuple["allowed"]},
-                response.json()["tuples"],
+                response["tuples"],
             )
         )
 
@@ -149,7 +149,7 @@ def load_resources_details(self, resource_identifiers: List[dict]) -> List[dict]
             MgmtV1.fga_resources_load,
             body={"resourceIdentifiers": resource_identifiers},
         )
-        return response.json().get("resourcesDetails", [])
+        return response.get("resourcesDetails", [])
 
     def save_resources_details(self, resources_details: List[dict]) -> None:
         """

descope/management/group.py

@@ -41,7 +41,7 @@ def load_all_groups(
                 "tenantId": tenant_id,
             },
         )
-        return response.json()
+        return response
 
     def load_all_groups_for_members(
         self,
@@ -88,7 +88,7 @@ def load_all_groups_for_members(
                 "userIds": user_ids,
             },
         )
-        return response.json()
+        return response
 
     def load_all_group_members(
         self,
@@ -129,4 +129,4 @@ def load_all_group_members(
                 "groupId": group_id,
             },
         )
-        return response.json()
+        return response

descope/management/project.py

@@ -63,8 +63,7 @@ def list_projects(
             MgmtV1.project_list_projects,
             body={},
         )
-        resp = response.json()
-
+        resp = response
         projects = resp["projects"]
         # Apply the function to the projects list
         formatted_projects = self.remove_tag_field(projects)
@@ -103,7 +102,7 @@ def clone(
                 "tags": tags,
             },
         )
-        return response.json()
+        return response
 
     def export_project(
         self,
@@ -125,7 +124,7 @@ def export_project(
             MgmtV1.project_export,
             body={},
         )
-        return response.json()["files"]
+        return response["files"]
 
     def import_project(
         self,

descope/management/role.py

@@ -114,7 +114,7 @@ def load_all(
         response = self._http.get(
             MgmtV1.role_load_all_path,
         )
-        return response.json()
+        return response
 
     def search(
         self,
@@ -157,4 +157,4 @@ def search(
             MgmtV1.role_search_path,
             body=body,
         )
-        return response.json()
+        return response

descope/management/sso_application.py

@@ -56,7 +56,7 @@ def create_oidc_application(
                 force_authentication,
             ),
         )
-        return response.json()
+        return response
 
     def create_saml_application(
         self,
@@ -153,7 +153,7 @@ def create_saml_application(
                 logout_redirect_url,
             ),
         )
-        return response.json()
+        return response
 
     def update_oidc_application(
         self,
@@ -324,7 +324,7 @@ def load(
         AuthException: raised if load operation fails
         """
         response = self._http.get(MgmtV1.sso_application_load_path, params={"id": id})
-        return response.json()
+        return response
 
     def load_all(
         self,
@@ -346,7 +346,7 @@ def load_all(
         AuthException: raised if load operation fails
         """
         response = self._http.get(MgmtV1.sso_application_load_all_path)
-        return response.json()
+        return response
 
     @staticmethod
     def _compose_create_update_oidc_body(