pangea-sdk 3.8.0b4__py3-none-any.whl → 3.9.0__py3-none-any.whl

pangea/asyncio/services/authn.py

@@ -1,10 +1,12 @@
 # Copyright 2022 Pangea Cyber Corporation
 # Author: Pangea Cyber Corporation
+from __future__ import annotations
 
 from typing import Dict, List, Optional, Union
 
 import pangea.services.authn.models as m
 from pangea.asyncio.services.base import ServiceBaseAsync
+from pangea.config import PangeaConfig
 from pangea.response import PangeaResponse
 
 SERVICE_NAME = "authn"
@@ -23,24 +25,38 @@ class AuthNAsync(ServiceBaseAsync):
         import os
 
         # Pangea SDK
+        from pangea.asyncio.services import AuthNAsync
         from pangea.config import PangeaConfig
-        from pangea.services import AuthN
 
         PANGEA_TOKEN = os.getenv("PANGEA_AUTHN_TOKEN")
         authn_config = PangeaConfig(domain="pangea.cloud")
 
         # Setup Pangea AuthN service
-        authn = AuthN(token=PANGEA_TOKEN, config=authn_config)
+        authn = AuthNAsync(token=PANGEA_TOKEN, config=authn_config)
     """
 
     service_name = SERVICE_NAME
 
     def __init__(
         self,
-        token,
-        config=None,
-        logger_name="pangea",
-    ):
+        token: str,
+        config: PangeaConfig | None = None,
+        logger_name: str = "pangea",
+    ) -> None:
+        """
+        AuthN client
+
+        Initializes a new AuthN client.
+
+        Args:
+            token: Pangea API token.
+            config: Configuration.
+            logger_name: Logger name.
+
+        Examples:
+             config = PangeaConfig(domain="pangea_domain")
+             authn = AuthNAsync(token="pangea_token", config=config)
+        """
         super().__init__(token, config, logger_name=logger_name)
         self.user = AuthNAsync.UserAsync(token, config, logger_name=logger_name)
         self.flow = AuthNAsync.FlowAsync(token, config, logger_name=logger_name)
@@ -53,10 +69,10 @@ class AuthNAsync(ServiceBaseAsync):
 
         def __init__(
             self,
-            token,
-            config=None,
-            logger_name="pangea",
-        ):
+            token: str,
+            config: PangeaConfig | None = None,
+            logger_name: str = "pangea",
+        ) -> None:
             super().__init__(token, config, logger_name=logger_name)
 
         async def invalidate(self, session_id: str) -> PangeaResponse[m.SessionInvalidateResult]:
@@ -148,10 +164,10 @@ class AuthNAsync(ServiceBaseAsync):
 
         def __init__(
             self,
-            token,
-            config=None,
-            logger_name="pangea",
-        ):
+            token: str,
+            config: PangeaConfig | None = None,
+            logger_name: str = "pangea",
+        ) -> None:
             super().__init__(token, config, logger_name=logger_name)
             self.session = AuthNAsync.ClientAsync.SessionAsync(token, config, logger_name=logger_name)
             self.password = AuthNAsync.ClientAsync.PasswordAsync(token, config, logger_name=logger_name)
@@ -208,10 +224,10 @@ class AuthNAsync(ServiceBaseAsync):
 
             def __init__(
                 self,
-                token,
-                config=None,
-                logger_name="pangea",
-            ):
+                token: str,
+                config: PangeaConfig | None = None,
+                logger_name: str = "pangea",
+            ) -> None:
                 super().__init__(token, config, logger_name=logger_name)
 
             async def invalidate(self, token: str, session_id: str) -> PangeaResponse[m.ClientSessionInvalidateResult]:
@@ -343,10 +359,10 @@ class AuthNAsync(ServiceBaseAsync):
 
             def __init__(
                 self,
-                token,
-                config=None,
-                logger_name="pangea",
-            ):
+                token: str,
+                config: PangeaConfig | None = None,
+                logger_name: str = "pangea",
+            ) -> None:
                 super().__init__(token, config, logger_name=logger_name)
 
             async def change(
@@ -384,10 +400,10 @@ class AuthNAsync(ServiceBaseAsync):
 
             def __init__(
                 self,
-                token,
-                config=None,
-                logger_name="pangea",
-            ):
+                token: str,
+                config: PangeaConfig | None = None,
+                logger_name: str = "pangea",
+            ) -> None:
                 super().__init__(token, config, logger_name=logger_name)
 
             async def check(self, token: str) -> PangeaResponse[m.ClientTokenCheckResult]:
@@ -421,10 +437,10 @@ class AuthNAsync(ServiceBaseAsync):
 
         def __init__(
             self,
-            token,
-            config=None,
-            logger_name="pangea",
-        ):
+            token: str,
+            config: PangeaConfig | None = None,
+            logger_name: str = "pangea",
+        ) -> None:
             super().__init__(token, config, logger_name=logger_name)
             self.profile = AuthNAsync.UserAsync.ProfileAsync(token, config, logger_name=logger_name)
             self.authenticators = AuthNAsync.UserAsync.AuthenticatorsAsync(token, config, logger_name=logger_name)
@@ -434,6 +450,8 @@ class AuthNAsync(ServiceBaseAsync):
             self,
             email: str,
             profile: m.Profile,
+            *,
+            username: str | None = None,
         ) -> PangeaResponse[m.UserCreateResult]:
             """
             Create User
@@ -443,8 +461,9 @@ class AuthNAsync(ServiceBaseAsync):
             OperationId: authn_post_v2_user_create
 
             Args:
-                email (str): An email address
-                profile (m.Profile): A user profile as a collection of string properties
+                email: An email address.
+                profile: A user profile as a collection of string properties.
+                username: A username.
 
             Returns:
                 A PangeaResponse with a user and its information in the response.result field.
@@ -463,11 +482,12 @@ class AuthNAsync(ServiceBaseAsync):
             input = m.UserCreateRequest(
                 email=email,
                 profile=profile,
+                username=username,
             )
             return await self.request.post("v2/user/create", m.UserCreateResult, data=input.dict(exclude_none=True))
 
         async def delete(
-            self, email: Optional[str] = None, id: Optional[str] = None
+            self, email: str | None = None, id: str | None = None, *, username: str | None = None
         ) -> PangeaResponse[m.UserDeleteResult]:
             """
             Delete User
@@ -477,8 +497,9 @@ class AuthNAsync(ServiceBaseAsync):
             OperationId: authn_post_v2_user_delete
 
             Args:
-                email (str, optional): An email address
-                id (str, optional): The id of a user or a service
+                email: An email address.
+                id: The id of a user or a service.
+                username: A username.
 
             Returns:
                 A PangeaResponse with an empty object in the response.result field.
@@ -486,7 +507,7 @@ class AuthNAsync(ServiceBaseAsync):
             Examples:
                 authn.user.delete(email="example@example.com")
             """
-            input = m.UserDeleteRequest(email=email, id=id)
+            input = m.UserDeleteRequest(email=email, id=id, username=username)
             return await self.request.post("v2/user/delete", m.UserDeleteResult, data=input.dict(exclude_none=True))
 
         async def invite(
@@ -533,8 +554,10 @@ class AuthNAsync(ServiceBaseAsync):
         async def update(
             self,
             disabled: bool,
-            id: Optional[str] = None,
-            email: Optional[str] = None,
+            id: str | None = None,
+            email: str | None = None,
+            *,
+            username: str | None = None,
         ) -> PangeaResponse[m.UserUpdateResult]:
             """
             Update user's settings
@@ -544,10 +567,11 @@ class AuthNAsync(ServiceBaseAsync):
             OperationId: authn_post_v2_user_update
 
             Args:
-                disabled (bool): New disabled value.
+                disabled: New disabled value.
                     Disabling a user account will prevent them from logging in.
-                id (str, optional): The identity of a user or a service
-                email (str, optional): An email address
+                id: The identity of a user or a service.
+                email: An email address.
+                username: A username.
 
             Returns:
                 A PangeaResponse with a user and its information in the response.result field.
@@ -564,6 +588,7 @@ class AuthNAsync(ServiceBaseAsync):
                 id=id,
                 email=email,
                 disabled=disabled,
+                username=username,
             )
 
             return await self.request.post("v2/user/update", m.UserUpdateResult, data=input.dict(exclude_none=True))
@@ -615,10 +640,10 @@ class AuthNAsync(ServiceBaseAsync):
 
             def __init__(
                 self,
-                token,
-                config=None,
-                logger_name="pangea",
-            ):
+                token: str,
+                config: PangeaConfig | None = None,
+                logger_name: str = "pangea",
+            ) -> None:
                 super().__init__(token, config, logger_name=logger_name)
 
             async def list(
@@ -687,14 +712,19 @@ class AuthNAsync(ServiceBaseAsync):
 
             def __init__(
                 self,
-                token,
-                config=None,
-                logger_name="pangea",
-            ):
+                token: str,
+                config: PangeaConfig | None = None,
+                logger_name: str = "pangea",
+            ) -> None:
                 super().__init__(token, config, logger_name=logger_name)
 
             async def delete(
-                self, authenticator_id: str, id: Optional[str] = None, email: Optional[str] = None
+                self,
+                authenticator_id: str,
+                id: str | None = None,
+                email: str | None = None,
+                *,
+                username: str | None = None,
             ) -> PangeaResponse[m.UserAuthenticatorsDeleteResult]:
                 """
                 Delete user authenticator
@@ -704,9 +734,10 @@ class AuthNAsync(ServiceBaseAsync):
                 OperationId: authn_post_v2_user_authenticators_delete
 
                 Args:
-                    authenticator_id (str): An ID for an authenticator
-                    id (str, optional): The identity of a user or a service
-                    email (str, optional): An email address
+                    authenticator_id: An ID for an authenticator.
+                    id: The identity of a user or a service.
+                    email: An email address.
+                    username: A username.
 
                 Returns:
                     A PangeaResponse with an empty object in the response.result field.
@@ -717,7 +748,9 @@ class AuthNAsync(ServiceBaseAsync):
                         id="pui_xpkhwpnz2cmegsws737xbsqnmnuwtbm5",
                     )
                 """
-                input = m.UserAuthenticatorsDeleteRequest(authenticator_id=authenticator_id, email=email, id=id)
+                input = m.UserAuthenticatorsDeleteRequest(
+                    authenticator_id=authenticator_id, email=email, id=id, username=username
+                )
                 return await self.request.post(
                     "v2/user/authenticators/delete",
                     m.UserAuthenticatorsDeleteResult,
@@ -725,7 +758,7 @@ class AuthNAsync(ServiceBaseAsync):
                 )
 
             async def list(
-                self, email: Optional[str] = None, id: Optional[str] = None
+                self, email: str | None = None, id: str | None = None, *, username: str | None = None
             ) -> PangeaResponse[m.UserAuthenticatorsListResult]:
                 """
                 Get user authenticators
@@ -735,8 +768,9 @@ class AuthNAsync(ServiceBaseAsync):
                 OperationId: authn_post_v2_user_authenticators_list
 
                 Args:
-                    email (str, optional): An email address
-                    id (str, optional): The identity of a user or a service
+                    email: An email address.
+                    id: The identity of a user or a service.
+                    username: A username.
 
                 Returns:
                     A PangeaResponse with a list of authenticators in the response.result field.
@@ -748,7 +782,7 @@ class AuthNAsync(ServiceBaseAsync):
                         id="pui_xpkhwpnz2cmegsws737xbsqnmnuwtbm5",
                     )
                 """
-                input = m.UserAuthenticatorsListRequest(email=email, id=id)
+                input = m.UserAuthenticatorsListRequest(email=email, id=id, username=username)
                 return await self.request.post(
                     "v2/user/authenticators/list", m.UserAuthenticatorsListResult, data=input.dict(exclude_none=True)
                 )
@@ -758,14 +792,14 @@ class AuthNAsync(ServiceBaseAsync):
 
             def __init__(
                 self,
-                token,
-                config=None,
-                logger_name="pangea",
-            ):
+                token: str,
+                config: PangeaConfig | None = None,
+                logger_name: str = "pangea",
+            ) -> None:
                 super().__init__(token, config, logger_name=logger_name)
 
             async def get(
-                self, id: Optional[str] = None, email: Optional[str] = None
+                self, id: str | None = None, email: str | None = None, *, username: str | None = None
             ) -> PangeaResponse[m.UserProfileGetResult]:
                 """
                 Get user
@@ -775,8 +809,9 @@ class AuthNAsync(ServiceBaseAsync):
                 OperationId: authn_post_v2_user_profile_get
 
                 Args:
-                    id (str, optional): The identity of a user or a service
-                    email (str, optional): An email address
+                    id: The identity of a user or a service.
+                    email: An email address.
+                    username: A username.
 
                 Returns:
                     A PangeaResponse with a user and its information in the response.result field.
@@ -788,7 +823,7 @@ class AuthNAsync(ServiceBaseAsync):
                         email="joe.user@email.com",
                     )
                 """
-                input = m.UserProfileGetRequest(id=id, email=email)
+                input = m.UserProfileGetRequest(id=id, email=email, username=username)
                 return await self.request.post(
                     "v2/user/profile/get", m.UserProfileGetResult, data=input.dict(exclude_none=True)
                 )
@@ -796,8 +831,10 @@ class AuthNAsync(ServiceBaseAsync):
             async def update(
                 self,
                 profile: m.Profile,
-                id: Optional[str] = None,
-                email: Optional[str] = None,
+                id: str | None = None,
+                email: str | None = None,
+                *,
+                username: str | None = None,
             ) -> PangeaResponse[m.UserProfileUpdateResult]:
                 """
                 Update user
@@ -807,9 +844,10 @@ class AuthNAsync(ServiceBaseAsync):
                 OperationId: authn_post_v2_user_profile_update
 
                 Args:
-                    profile (m.Profile): Updates to a user profile
-                    id (str, optional): The identity of a user or a service
-                    email (str, optional): An email address
+                    profile: Updates to a user profile.
+                    id: The identity of a user or a service.
+                    email: An email address.
+                    username: A username.
 
                 Returns:
                     A PangeaResponse with a user and its information in the response.result field.
@@ -828,6 +866,7 @@ class AuthNAsync(ServiceBaseAsync):
                     id=id,
                     email=email,
                     profile=profile,
+                    username=username,
                 )
                 return await self.request.post(
                     "v2/user/profile/update", m.UserProfileUpdateResult, data=input.dict(exclude_none=True)
@@ -838,10 +877,10 @@ class AuthNAsync(ServiceBaseAsync):
 
         def __init__(
             self,
-            token,
-            config=None,
-            logger_name="pangea",
-        ):
+            token: str,
+            config: PangeaConfig | None = None,
+            logger_name: str = "pangea",
+        ) -> None:
             super().__init__(token, config, logger_name=logger_name)
 
         async def complete(self, flow_id: str) -> PangeaResponse[m.FlowCompleteResult]:
@@ -978,10 +1017,10 @@ class AuthNAsync(ServiceBaseAsync):
 
         def __init__(
             self,
-            token,
-            config=None,
-            logger_name="pangea",
-        ):
+            token: str,
+            config: PangeaConfig | None = None,
+            logger_name: str = "pangea",
+        ) -> None:
             super().__init__(token, config, logger_name=logger_name)
 
         async def create(

pangea/asyncio/services/authz.py

@@ -28,12 +28,11 @@ from pangea.services.authz import (
 
 
 class AuthZAsync(ServiceBaseAsync):
-    """AuthZ service client. (Beta)
+    """AuthZ service client.
 
     Provides methods to interact with the Pangea AuthZ Service.
     Documentation for the AuthZ Service API can be found at
-    <https://pangea.cloud/docs/api/authz>. Note that this service is in Beta and
-    is subject to change.
+    <https://pangea.cloud/docs/api/authz>.
 
     Examples:
         import os
@@ -54,11 +53,10 @@ class AuthZAsync(ServiceBaseAsync):
         super().__init__(token, config, logger_name, config_id=config_id)
 
     async def tuple_create(self, tuples: List[Tuple]) -> PangeaResponse[TupleCreateResult]:
-        """Create tuples. (Beta)
+        """Create tuples.
 
         Create tuples in the AuthZ Service. The request will fail if there is no schema
         or the tuples do not validate against the schema.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
 
         Args:
             tuples (List[Tuple]): List of tuples to be created.
@@ -69,24 +67,22 @@ class AuthZAsync(ServiceBaseAsync):
         Returns:
             Pangea Response with empty result.
             Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1beta/tuple/create).
+            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/tuple/create).
 
         Examples:
             await authz.tuple_create(
                 tuples=[
                     Tuple(
-                        resource=Resource(namespace="file", id="file_1"),
+                        resource=Resource(type="file", id="file_1"),
                         relation="owner",
-                        subject=Subject(namespace="user", id="user_1"),
+                        subject=Subject(type="user", id="user_1"),
                     )
                 ]
             )
         """
 
         input_data = TupleCreateRequest(tuples=tuples)
-        return await self.request.post(
-            "v1beta/tuple/create", TupleCreateResult, data=input_data.dict(exclude_none=True)
-        )
+        return await self.request.post("v1/tuple/create", TupleCreateResult, data=input_data.dict(exclude_none=True))
 
     async def tuple_list(
         self,
@@ -96,12 +92,11 @@ class AuthZAsync(ServiceBaseAsync):
         order: Optional[ItemOrder] = None,
         order_by: Optional[TupleOrderBy] = None,
     ) -> PangeaResponse[TupleListResult]:
-        """List tuples. (Beta)
+        """List tuples.
 
         Return a paginated list of filtered tuples. The filter is given in terms
         of a tuple. Fill out the fields that you want to filter. If the filter
         is empty it will return all the tuples.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
 
         Args:
             filter (TupleListFilter): The filter for listing tuples.
@@ -116,21 +111,20 @@ class AuthZAsync(ServiceBaseAsync):
         Returns:
             Pangea Response with a list of tuples and the last token.
             Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1beta/tuple/list).
+            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/tuple/list).
 
         Examples:
-            await authz.tuple_list(TupleListFilter(subject_namespace="user", subject_id="user_1"))
+            await authz.tuple_list(TupleListFilter(subject_type="user", subject_id="user_1"))
         """
         input_data = TupleListRequest(
             filter=filter.dict(exclude_none=True), size=size, last=last, order=order, order_by=order_by
         )
-        return await self.request.post("v1beta/tuple/list", TupleListResult, data=input_data.dict(exclude_none=True))
+        return await self.request.post("v1/tuple/list", TupleListResult, data=input_data.dict(exclude_none=True))
 
     async def tuple_delete(self, tuples: List[Tuple]) -> PangeaResponse[TupleDeleteResult]:
-        """Delete tuples. (Beta)
+        """Delete tuples.
 
         Delete tuples in the AuthZ Service.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
 
         Args:
             tuples (List[Tuple]): List of tuples to be deleted.
@@ -141,24 +135,22 @@ class AuthZAsync(ServiceBaseAsync):
         Returns:
             Pangea Response with empty result.
             Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1beta/tuple/delete).
+            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/tuple/delete).
 
         Examples:
             await authz.tuple_delete(
                 tuples=[
                     Tuple(
-                        resource=Resource(namespace="file", id="file_1"),
+                        resource=Resource(type="file", id="file_1"),
                         relation="owner",
-                        subject=Subject(namespace="user", id="user_1"),
+                        subject=Subject(type="user", id="user_1"),
                     )
                 ]
             )
         """
 
         input_data = TupleDeleteRequest(tuples=tuples)
-        return await self.request.post(
-            "v1beta/tuple/delete", TupleDeleteResult, data=input_data.dict(exclude_none=True)
-        )
+        return await self.request.post("v1/tuple/delete", TupleDeleteResult, data=input_data.dict(exclude_none=True))
 
     async def check(
         self,
@@ -168,10 +160,9 @@ class AuthZAsync(ServiceBaseAsync):
         debug: Optional[bool] = None,
         attributes: Optional[Dict[str, Union[int, str]]] = None,
     ) -> PangeaResponse[CheckResult]:
-        """Perform a check request. (Beta)
+        """Perform a check request.
 
         Check if a subject has permission to perform an action on the resource.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
 
         Args:
             resource (Resource): The resource to check.
@@ -186,31 +177,28 @@ class AuthZAsync(ServiceBaseAsync):
         Returns:
             Pangea Response with the result of the check.
             Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1beta/check).
+            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/check).
 
         Examples:
             await authz.check(
-                resource=Resource(namespace="file", id="file_1"),
+                resource=Resource(type="file", id="file_1"),
                 action="update",
-                subject=Subject(namespace="user", id="user_1"),
+                subject=Subject(type="user", id="user_1"),
                 debug=True,
             )
         """
 
         input_data = CheckRequest(resource=resource, action=action, subject=subject, debug=debug, attributes=attributes)
-        return await self.request.post("v1beta/check", CheckResult, data=input_data.dict(exclude_none=True))
+        return await self.request.post("v1/check", CheckResult, data=input_data.dict(exclude_none=True))
 
-    async def list_resources(
-        self, namespace: str, action: str, subject: Subject
-    ) -> PangeaResponse[ListResourcesResult]:
-        """List resources. (Beta)
+    async def list_resources(self, type: str, action: str, subject: Subject) -> PangeaResponse[ListResourcesResult]:
+        """List resources.
 
-        Given a namespace, action, and subject, list all the resources in the
-        namespace that the subject has access to the action with.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
+        Given a type, action, and subject, list all the resources in the
+        type that the subject has access to the action with.
 
         Args:
-            namespace (str): The namespace to filter resources.
+            type (str): The type to filter resources.
             action (str): The action to filter resources.
             subject (Subject): The subject to filter resources.
 
@@ -220,27 +208,26 @@ class AuthZAsync(ServiceBaseAsync):
         Returns:
             Pangea Response with a list of resource IDs.
             Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1beta/list-resources).
+            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/list-resources).
 
         Examples:
             await authz.list_resources(
-                namespace="file",
+                type="file",
                 action="update",
-                subject=Subject(namespace="user", id="user_1"),
+                subject=Subject(type="user", id="user_1"),
             )
         """
 
-        input_data = ListResourcesRequest(namespace=namespace, action=action, subject=subject)
+        input_data = ListResourcesRequest(type=type, action=action, subject=subject)
         return await self.request.post(
-            "v1beta/list-resources", ListResourcesResult, data=input_data.dict(exclude_none=True)
+            "v1/list-resources", ListResourcesResult, data=input_data.dict(exclude_none=True)
         )
 
     async def list_subjects(self, resource: Resource, action: str) -> PangeaResponse[ListSubjectsResult]:
-        """List subjects. (Beta)
+        """List subjects.
 
         Given a resource and an action, return the list of subjects who have
         access to the action for the given resource.
-        How to install a [Beta release](https://pangea.cloud/docs/sdk/python/#beta-releases).
 
         Args:
             resource (Resource): The resource to filter subjects.
@@ -252,16 +239,14 @@ class AuthZAsync(ServiceBaseAsync):
         Returns:
             Pangea Response with a list of subjects.
             Available response fields can be found in our
-            [API Documentation](https://pangea.cloud/docs/api/authz#/v1beta/list-subjects).
+            [API Documentation](https://pangea.cloud/docs/api/authz#/v1/list-subjects).
 
         Examples:
             await authz.list_subjects(
-                resource=Resource(namespace="file", id="file_1"),
+                resource=Resource(type="file", id="file_1"),
                 action="update",
             )
         """
 
         input_data = ListSubjectsRequest(resource=resource, action=action)
-        return await self.request.post(
-            "v1beta/list-subjects", ListSubjectsResult, data=input_data.dict(exclude_none=True)
-        )
+        return await self.request.post("v1/list-subjects", ListSubjectsResult, data=input_data.dict(exclude_none=True))