auth0-python 4.0.0__tar.gz → 4.1.0__tar.gz

{auth0-python-4.0.0 → auth0-python-4.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: auth0-python
-Version: 4.0.0
+Version: 4.1.0
 Summary: Auth0 Python SDK
 Home-page: https://github.com/auth0/auth0-python
 Author: Auth0
@@ -52,15 +52,6 @@ pip install auth0-python
 #### Authentication SDK
 The Authentication SDK is organized into components that mirror the structure of the
 [API documentation](https://auth0.com/docs/auth-api).
-For example:
-
-```python
-from auth0.authentication import Social
-
-social = Social('my-domain.us.auth0.com', 'my-client-id')
-
-social.login(access_token='...', connection='facebook')
-```
 
 If you need to sign up a user using their email and password, you can use the Database object.
 

{auth0-python-4.0.0 → auth0-python-4.1.0}/README.md

@@ -29,15 +29,6 @@ pip install auth0-python
 #### Authentication SDK
 The Authentication SDK is organized into components that mirror the structure of the
 [API documentation](https://auth0.com/docs/auth-api).
-For example:
-
-```python
-from auth0.authentication import Social
-
-social = Social('my-domain.us.auth0.com', 'my-client-id')
-
-social.login(access_token='...', connection='facebook')
-```
 
 If you need to sign up a user using their email and password, you can use the Database object.
 

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "4.0.0"
+__version__ = "4.1.0"
 
 from auth0.exceptions import Auth0Error, RateLimitError, TokenValidationError
 

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/asyncify.py

@@ -31,10 +31,10 @@ def asyncify(cls):
         ):
             if token is None:
                 # Wrap the auth client
-                super(AsyncClient, self).__init__(domain, telemetry, timeout, protocol)
+                super().__init__(domain, telemetry, timeout, protocol)
             else:
                 # Wrap the mngtmt client
-                super(AsyncClient, self).__init__(
+                super().__init__(
                     domain, token, telemetry, timeout, protocol, rest_options
                 )
             self.client = AsyncRestClient(
@@ -53,10 +53,10 @@ def asyncify(cls):
         ):
             if token is None:
                 # Wrap the auth client
-                super(Wrapper, self).__init__(domain, telemetry, timeout, protocol)
+                super().__init__(domain, telemetry, timeout, protocol)
             else:
                 # Wrap the mngtmt client
-                super(Wrapper, self).__init__(
+                super().__init__(
                     domain, token, telemetry, timeout, protocol, rest_options
                 )
 
@@ -66,7 +66,7 @@ def asyncify(cls):
             for method in methods:
                 setattr(
                     self,
-                    "{}_async".format(method),
+                    f"{method}_async",
                     _gen_async(self._async_client, method),
                 )
 

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/async_token_verifier.py

@@ -13,7 +13,7 @@ class AsyncAsymmetricSignatureVerifier(AsymmetricSignatureVerifier):
     """
 
     def __init__(self, jwks_url, algorithm="RS256"):
-        super(AsyncAsymmetricSignatureVerifier, self).__init__(jwks_url, algorithm)
+        super().__init__(jwks_url, algorithm)
         self._fetcher = AsyncJwksFetcher(jwks_url)
 
     def set_session(self, session):
@@ -58,7 +58,7 @@ class AsyncJwksFetcher(JwksFetcher):
     """
 
     def __init__(self, *args, **kwargs):
-        super(AsyncJwksFetcher, self).__init__(*args, **kwargs)
+        super().__init__(*args, **kwargs)
         self._async_client = AsyncRestClient(None)
 
     def set_session(self, session):
@@ -111,9 +111,7 @@ class AsyncJwksFetcher(JwksFetcher):
             keys = await self._fetch_jwks(force=True)
             if keys and key_id in keys:
                 return keys[key_id]
-        raise TokenValidationError(
-            'RSA Public Key with ID "{}" was not found.'.format(key_id)
-        )
+        raise TokenValidationError(f'RSA Public Key with ID "{key_id}" was not found.')
 
 
 class AsyncTokenVerifier(TokenVerifier):

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/base.py

@@ -5,7 +5,7 @@ from .client_authentication import add_client_authentication
 UNKNOWN_ERROR = "a0.sdk.internal.unknown"
 
 
-class AuthenticationBase(object):
+class AuthenticationBase:
     """Base authentication object providing simple REST methods.
 
     Args:

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/client_authentication.py

@@ -24,7 +24,7 @@ def create_client_assertion_jwt(
         {
             "iss": client_id,
             "sub": client_id,
-            "aud": "https://{}/".format(domain),
+            "aud": f"https://{domain}/",
             "iat": now,
             "exp": now + datetime.timedelta(seconds=180),
             "jti": str(uuid.uuid4()),

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/database.py

@@ -72,7 +72,7 @@ class Database(AuthenticationBase):
             body.update({"picture": picture})
 
         return self.post(
-            "{}://{}/dbconnections/signup".format(self.protocol, self.domain), data=body
+            f"{self.protocol}://{self.domain}/dbconnections/signup", data=body
         )
 
     def change_password(self, email, connection, password=None):
@@ -89,6 +89,6 @@ class Database(AuthenticationBase):
         }
 
         return self.post(
-            "{}://{}/dbconnections/change_password".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/dbconnections/change_password",
             data=body,
         )

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/delegated.py

@@ -17,7 +17,6 @@ class Delegated(AuthenticationBase):
         refresh_token=None,
         scope="openid",
     ):
-
         """Obtain a delegation token."""
 
         if id_token and refresh_token:
@@ -38,6 +37,4 @@ class Delegated(AuthenticationBase):
         else:
             raise ValueError("Either id_token or refresh_token must have a value")
 
-        return self.post(
-            "{}://{}/delegation".format(self.protocol, self.domain), data=data
-        )
+        return self.post(f"{self.protocol}://{self.domain}/delegation", data=data)

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/get_token.py

@@ -36,7 +36,7 @@ class GetToken(AuthenticationBase):
         """
 
         return self.authenticated_post(
-            "{}://{}/oauth/token".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/oauth/token",
             data={
                 "client_id": self.client_id,
                 "code": code,
@@ -74,7 +74,7 @@ class GetToken(AuthenticationBase):
         """
 
         return self.post(
-            "{}://{}/oauth/token".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/oauth/token",
             data={
                 "client_id": self.client_id,
                 "code_verifier": code_verifier,
@@ -106,7 +106,7 @@ class GetToken(AuthenticationBase):
         """
 
         return self.authenticated_post(
-            "{}://{}/oauth/token".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/oauth/token",
             data={
                 "client_id": self.client_id,
                 "audience": audience,
@@ -154,7 +154,7 @@ class GetToken(AuthenticationBase):
         """
 
         return self.authenticated_post(
-            "{}://{}/oauth/token".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/oauth/token",
             data={
                 "client_id": self.client_id,
                 "username": username,
@@ -190,7 +190,7 @@ class GetToken(AuthenticationBase):
         """
 
         return self.authenticated_post(
-            "{}://{}/oauth/token".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/oauth/token",
             data={
                 "client_id": self.client_id,
                 "refresh_token": refresh_token,
@@ -223,7 +223,7 @@ class GetToken(AuthenticationBase):
         """
 
         return self.authenticated_post(
-            "{}://{}/oauth/token".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/oauth/token",
             data={
                 "client_id": self.client_id,
                 "username": username,

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/passwordless.py

@@ -45,7 +45,7 @@ class Passwordless(AuthenticationBase):
             data.update({"authParams": auth_params})
 
         return self.authenticated_post(
-            "{}://{}/passwordless/start".format(self.protocol, self.domain), data=data
+            f"{self.protocol}://{self.domain}/passwordless/start", data=data
         )
 
     def sms(self, phone_number):
@@ -68,5 +68,5 @@ class Passwordless(AuthenticationBase):
         }
 
         return self.authenticated_post(
-            "{}://{}/passwordless/start".format(self.protocol, self.domain), data=data
+            f"{self.protocol}://{self.domain}/passwordless/start", data=data
         )

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/revoke_token.py

@@ -26,5 +26,5 @@ class RevokeToken(AuthenticationBase):
         }
 
         return self.authenticated_post(
-            "{}://{}/oauth/revoke".format(self.protocol, self.domain), data=body
+            f"{self.protocol}://{self.domain}/oauth/revoke", data=body
         )

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/social.py

@@ -27,7 +27,7 @@ class Social(AuthenticationBase):
         """
 
         return self.post(
-            "{}://{}/oauth/access_token".format(self.protocol, self.domain),
+            f"{self.protocol}://{self.domain}/oauth/access_token",
             data={
                 "client_id": self.client_id,
                 "access_token": access_token,

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/token_verifier.py

@@ -8,7 +8,7 @@ import requests
 from auth0.exceptions import TokenValidationError
 
 
-class SignatureVerifier(object):
+class SignatureVerifier:
     """Abstract class that will verify a given JSON web token's signature
     using the key fetched internally given its key id.
 
@@ -119,7 +119,7 @@ class SymmetricSignatureVerifier(SignatureVerifier):
     """
 
     def __init__(self, shared_secret, algorithm="HS256"):
-        super(SymmetricSignatureVerifier, self).__init__(algorithm)
+        super().__init__(algorithm)
         self._shared_secret = shared_secret
 
     def _fetch_key(self, key_id=None):
@@ -135,14 +135,14 @@ class AsymmetricSignatureVerifier(SignatureVerifier):
     """
 
     def __init__(self, jwks_url, algorithm="RS256"):
-        super(AsymmetricSignatureVerifier, self).__init__(algorithm)
+        super().__init__(algorithm)
         self._fetcher = JwksFetcher(jwks_url)
 
     def _fetch_key(self, key_id=None):
         return self._fetcher.get_key(key_id)
 
 
-class JwksFetcher(object):
+class JwksFetcher:
     """Class that fetches and holds a JSON web key set.
     This class makes use of an in-memory cache. For it to work properly, define this instance once and re-use it.
 
@@ -236,9 +236,7 @@ class JwksFetcher(object):
             keys = self._fetch_jwks(force=True)
             if keys and key_id in keys:
                 return keys[key_id]
-        raise TokenValidationError(
-            'RSA Public Key with ID "{}" was not found.'.format(key_id)
-        )
+        raise TokenValidationError(f'RSA Public Key with ID "{key_id}" was not found.')
 
 
 class TokenVerifier:

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/authentication/users.py

@@ -1,7 +1,7 @@
 from auth0.rest import RestClient, RestClientOptions
 
 
-class Users(object):
+class Users:
     """Users client.
 
     Args:
@@ -32,7 +32,6 @@ class Users(object):
     """
 
     def userinfo(self, access_token):
-
         """Returns the user information based on the Auth0 access token.
         This endpoint will work only if openid was granted as a scope for the access_token.
 
@@ -44,6 +43,6 @@ class Users(object):
         """
 
         return self.client.get(
-            url="{}://{}/userinfo".format(self.protocol, self.domain),
-            headers={"Authorization": "Bearer {}".format(access_token)},
+            url=f"{self.protocol}://{self.domain}/userinfo",
+            headers={"Authorization": f"Bearer {access_token}"},
         )

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/exceptions.py

@@ -6,14 +6,12 @@ class Auth0Error(Exception):
         self.content = content
 
     def __str__(self):
-        return "{}: {}".format(self.status_code, self.message)
+        return f"{self.status_code}: {self.message}"
 
 
 class RateLimitError(Auth0Error):
     def __init__(self, error_code, message, reset_at):
-        super(RateLimitError, self).__init__(
-            status_code=429, error_code=error_code, message=message
-        )
+        super().__init__(status_code=429, error_code=error_code, message=message)
         self.reset_at = reset_at
 
 

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/actions.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class Actions(object):
+class Actions:
     """Auth0 Actions endpoints
 
     Args:
@@ -39,10 +39,10 @@ class Actions(object):
         )
 
     def _url(self, *args):
-        url = "{}://{}/api/v2/actions".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/actions"
         for p in args:
             if p is not None:
-                url = "{}/{}".format(url, p)
+                url = f"{url}/{p}"
         return url
 
     def get_actions(

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/async_auth0.py

@@ -4,7 +4,7 @@ from ..asyncify import asyncify
 from .auth0 import modules
 
 
-class AsyncAuth0(object):
+class AsyncAuth0:
     """Provides easy access to all endpoint classes
 
     Args:

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/attack_protection.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class AttackProtection(object):
+class AttackProtection:
     """Auth0 attack protection endpoints
 
     Args:

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/auth0.py

@@ -64,7 +64,7 @@ modules = {
 }
 
 
-class Auth0(object):
+class Auth0:
     """Provides easy access to all endpoint classes
 
     Args:

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/blacklists.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class Blacklists(object):
+class Blacklists:
     """Auth0 blacklists endpoints
 
     Args:
@@ -32,7 +32,7 @@ class Blacklists(object):
         protocol="https",
         rest_options=None,
     ):
-        self.url = "{}://{}/api/v2/blacklists/tokens".format(protocol, domain)
+        self.url = f"{protocol}://{domain}/api/v2/blacklists/tokens"
         self.client = RestClient(
             jwt=token, telemetry=telemetry, timeout=timeout, options=rest_options
         )

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/branding.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class Branding(object):
+class Branding:
     """Auth0 Branding endpoints
 
     Args:
@@ -39,10 +39,10 @@ class Branding(object):
         )
 
     def _url(self, *args):
-        url = "{}://{}/api/v2/branding".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/branding"
         for p in args:
             if p is not None:
-                url = "{}/{}".format(url, p)
+                url = f"{url}/{p}"
         return url
 
     def get(self, aud=None):
@@ -93,3 +93,56 @@ class Branding(object):
             self._url("templates", "universal-login"),
             body={"template": body},
         )
+
+    def get_default_branding_theme(self):
+        """Retrieve default branding theme.
+
+        See: https://auth0.com/docs/api/management/v2#!/Branding/get_default_branding_theme
+        """
+
+        return self.client.get(self._url("themes", "default"))
+
+    def get_branding_theme(self, theme_id):
+        """Retrieve branding theme.
+
+        Args:
+            theme_id (str): The theme_id to retrieve branding theme for.
+
+        See: https://auth0.com/docs/api/management/v2#!/Branding/get_branding_theme
+        """
+
+        return self.client.get(self._url("themes", theme_id))
+
+    def delete_branding_theme(self, theme_id):
+        """Delete branding theme.
+
+        Args:
+            theme_id (str): The theme_id to delete branding theme for.
+
+        See: https://auth0.com/docs/api/management/v2#!/Branding/delete_branding_theme
+        """
+
+        return self.client.delete(self._url("themes", theme_id))
+
+    def update_branding_theme(self, theme_id, body):
+        """Update branding theme.
+
+        Args:
+            theme_id (str): The theme_id to update branding theme for.
+            body (dict): The attributes to set on the theme.
+
+        See: https://auth0.com/docs/api/management/v2#!/Branding/patch_branding_theme
+        """
+
+        return self.client.patch(self._url("themes", theme_id), data=body)
+
+    def create_branding_theme(self, body):
+        """Create branding theme.
+
+        Args:
+            body (dict): The attributes to set on the theme.
+
+        See: https://auth0.com/docs/api/management/v2#!/Branding/post_branding_theme
+        """
+
+        return self.client.post(self._url("themes"), data=body)

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/client_credentials.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class ClientCredentials(object):
+class ClientCredentials:
     """Auth0 client credentials endpoints.
 
     Args:
@@ -43,7 +43,7 @@ class ClientCredentials(object):
             self.protocol, self.domain, client_id
         )
         if id is not None:
-            return "{}/{}".format(url, id)
+            return f"{url}/{id}"
         return url
 
     def all(self, client_id):

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/client_grants.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class ClientGrants(object):
+class ClientGrants:
     """Auth0 client grants endpoints
 
     Args:
@@ -39,9 +39,9 @@ class ClientGrants(object):
         )
 
     def _url(self, id=None):
-        url = "{}://{}/api/v2/client-grants".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/client-grants"
         if id is not None:
-            return "{}/{}".format(url, id)
+            return f"{url}/{id}"
         return url
 
     def all(

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/clients.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class Clients(object):
+class Clients:
     """Auth0 applications endpoints
 
     Args:
@@ -39,9 +39,9 @@ class Clients(object):
         )
 
     def _url(self, id=None):
-        url = "{}://{}/api/v2/clients".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/clients"
         if id is not None:
-            return "{}/{}".format(url, id)
+            return f"{url}/{id}"
         return url
 
     def all(

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/connections.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class Connections(object):
+class Connections:
     """Auth0 connection endpoints
 
     Args:
@@ -39,9 +39,9 @@ class Connections(object):
         )
 
     def _url(self, id=None):
-        url = "{}://{}/api/v2/connections".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/connections"
         if id is not None:
-            return "{}/{}".format(url, id)
+            return f"{url}/{id}"
         return url
 
     def all(

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/custom_domains.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class CustomDomains(object):
+class CustomDomains:
     """Auth0 custom domains endpoints
 
     Args:
@@ -39,7 +39,7 @@ class CustomDomains(object):
         )
 
     def _url(self, id=None):
-        url = "{}://{}/api/v2/custom-domains".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/custom-domains"
         if id is not None:
             return url + "/" + id
         return url

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/device_credentials.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class DeviceCredentials(object):
+class DeviceCredentials:
     """Auth0 connection endpoints
 
     Args:
@@ -39,9 +39,9 @@ class DeviceCredentials(object):
         )
 
     def _url(self, id=None):
-        url = "{}://{}/api/v2/device-credentials".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/device-credentials"
         if id is not None:
-            return "{}/{}".format(url, id)
+            return f"{url}/{id}"
         return url
 
     def get(

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/email_templates.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class EmailTemplates(object):
+class EmailTemplates:
     """Auth0 email templates endpoints
 
     Args:
@@ -39,9 +39,9 @@ class EmailTemplates(object):
         )
 
     def _url(self, id=None):
-        url = "{}://{}/api/v2/email-templates".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/email-templates"
         if id is not None:
-            return "{}/{}".format(url, id)
+            return f"{url}/{id}"
         return url
 
     def create(self, body):

{auth0-python-4.0.0 → auth0-python-4.1.0}/auth0/management/emails.py

@@ -1,7 +1,7 @@
 from ..rest import RestClient
 
 
-class Emails(object):
+class Emails:
     """Auth0 email endpoints
 
     Args:
@@ -39,9 +39,9 @@ class Emails(object):
         )
 
     def _url(self, id=None):
-        url = "{}://{}/api/v2/emails/provider".format(self.protocol, self.domain)
+        url = f"{self.protocol}://{self.domain}/api/v2/emails/provider"
         if id is not None:
-            return "{}/{}".format(url, id)
+            return f"{url}/{id}"
         return url
 
     def get(self, fields=None, include_fields=True):