auth0-python 3.2.2__tar.gz → 3.3.0__tar.gz

usr/local/lib/python3.7/site-packages/auth0/__init__.py

@@ -0,0 +1 @@
+__version__ = '3.3.0'

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/authentication/get_token.py

@@ -30,7 +30,7 @@ class GetToken(AuthenticationBase):
 
             code (str): The Authorization Code received from the /authorize Calls
 
-            redirect_uri (srt, optional): This is required only if it was set at
+            redirect_uri (str, optional): This is required only if it was set at
             the GET /authorize endpoint. The values must match
 
         Returns:
@@ -67,7 +67,7 @@ class GetToken(AuthenticationBase):
 
             code (str): The Authorization Code received from the /authorize Calls
 
-            redirect_uri (srt, optional): This is required only if it was set at
+            redirect_uri (str, optional): This is required only if it was set at
             the GET /authorize endpoint. The values must match
 
         Returns:
@@ -146,7 +146,7 @@ class GetToken(AuthenticationBase):
 
             password (str): resource owner's Secret
 
-            scope(srt): String value of the different scopes the client is asking for.
+            scope(str): String value of the different scopes the client is asking for.
             Multiple scopes are separated with whitespace.
 
             realm (str): String value of the realm the user belongs.

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/authentication/passwordless.py

@@ -12,7 +12,7 @@ class Passwordless(AuthenticationBase):
     def __init__(self, domain):
         self.domain = domain
 
-    def email(self, client_id, email, send='link', auth_params={}):
+    def email(self, client_id, email, send='link', auth_params=None):
         """Start flow sending an email.
 
         Given the user email address, it will send an email with:
@@ -43,7 +43,7 @@ class Passwordless(AuthenticationBase):
                 'connection': 'email',
                 'email': email,
                 'send': send,
-                'authParams': auth_params,
+                'authParams': auth_params
             },
             headers={'Content-Type': 'application/json'}
         )

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/__init__.py

@@ -1,10 +1,11 @@
 from .auth0 import Auth0
 from .blacklists import Blacklists
-from .client_grants import ClientGrants
 from .clients import Clients
+from .client_grants import ClientGrants
 from .connections import Connections
 from .device_credentials import DeviceCredentials
 from .emails import Emails
+from .email_templates import EmailTemplates
 from .guardian import Guardian
 from .jobs import Jobs
 from .logs import Logs
@@ -15,4 +16,4 @@ from .tenants import Tenants
 from .tickets import Tickets
 from .user_blocks import UserBlocks
 from .users import Users
-
+from .users_by_email import UsersByEmail

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/auth0.py

@@ -1,19 +1,21 @@
-from .connections import Connections
+from .blacklists import Blacklists
 from .clients import Clients
+from .client_grants import ClientGrants
+from .connections import Connections
 from .device_credentials import DeviceCredentials
-from .blacklists import Blacklists
 from .emails import Emails
+from .email_templates import EmailTemplates
+from .guardian import Guardian
 from .jobs import Jobs
+from .logs import Logs
+from .resource_servers import ResourceServers
 from .rules import Rules
 from .stats import Stats
-from .tickets import Tickets
-from .users import Users
 from .tenants import Tenants
-from .client_grants import ClientGrants
-from .guardian import Guardian
-from .logs import Logs
-from .resource_servers import ResourceServers
+from .tickets import Tickets
 from .user_blocks import UserBlocks
+from .users import Users
+from .users_by_email import UsersByEmail
 
 class Auth0(object):
     """Provides easy access to all endpoint classes
@@ -25,19 +27,21 @@ class Auth0(object):
     """
 
     def __init__(self, domain, token):
+        self.blacklists = Blacklists(domain, token)
         self.clients = Clients(domain, token)
+        self.client_grants = ClientGrants(domain, token)
         self.connections = Connections(domain, token)
         self.device_credentials = DeviceCredentials(domain, token)
-        self.blacklists = Blacklists(domain, token)
         self.emails = Emails(domain, token)
+        self.email_templates = EmailTemplates(domain, token)
+        self.guardian = Guardian(domain, token)
         self.jobs = Jobs(domain, token)
+        self.logs = Logs(domain, token)
+        self.resource_servers = ResourceServers(domain, token)
         self.rules = Rules(domain, token)
         self.stats = Stats(domain, token)
-        self.tickets = Tickets(domain, token)
-        self.users = Users(domain, token)
         self.tenants = Tenants(domain, token)
-        self.client_grants = ClientGrants(domain, token)
-        self.guardian = Guardian(domain, token)
-        self.logs = Logs(domain, token)
-        self.resource_servers = ResourceServers(domain, token)
+        self.tickets = Tickets(domain, token)
         self.user_blocks = UserBlocks(domain, token)
+        self.users = Users(domain, token)
+        self.users_by_email = UsersByEmail(domain, token)

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/client_grants.py

@@ -24,15 +24,27 @@ class ClientGrants(object):
             return url + '/' + id
         return url
 
-    def all(self, audience=None):
+    def all(self, audience=None, page=None, per_page=None, include_totals=False):
         """Retrieves all client grants.
 
         Args:
-           audience (str, optional): URL Encoded audience of a Resource Server
-               to filter
+            audience (str, optional): URL encoded audience of a Resource Server
+                to filter
+
+            page (int, optional): The result's page number (zero based).
+
+            per_page (int, optional): The amount of entries per page.
+
+            include_totals (bool, optional): True if the query summary is
+                to be included in the result, False otherwise.
         """
 
-        params = {'audience': audience or None}
+        params = {
+            'audience': audience,
+            'page': page,
+            'per_page': per_page,
+            'include_totals': str(include_totals).lower()
+        }
 
         return self.client.get(self._url(), params=params)
 
@@ -62,6 +74,7 @@ class ClientGrants(object):
            id (str): The id of the client grant to modify.
 
            body (dict): Attributes to modify.
+              See: https://auth0.com/docs/api/management/v2#!/Client_Grants/patch_client_grants_by_id
         """
 
         return self.client.patch(self._url(id), data=body)

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/clients.py

@@ -24,7 +24,7 @@ class Clients(object):
             return url + '/' + id
         return url
 
-    def all(self, fields=[], include_fields=True):
+    def all(self, fields=None, include_fields=True, page=None, per_page=None, extra_params=None):
         """Retrieves a list of all the applications.
 
         Important: The client_secret and encryption_key attributes can only be
@@ -36,12 +36,22 @@ class Clients(object):
               retrieve all fields.
 
            include_fields (bool, optional): True if the fields specified are
-              to be include in the result, False otherwise.
-        """
+              to be included in the result, False otherwise.
 
-        params = {'fields': ','.join(fields) or None,
-                  'include_fields': str(include_fields).lower()}
+           page (int): The result's page number (zero based).
 
+           per_page (int, optional): The amount of entries per page.
+
+           extra_params (dictionary, optional): The extra parameters to add to
+             the request. The fields, include_fields, page and per_page values
+             specified as parameters take precedence over the ones defined here.
+        """
+        params = extra_params or {}
+        params['fields'] = fields and ','.join(fields) or None
+        params['include_fields'] = str(include_fields).lower()
+        params['page'] = page
+        params['per_page'] = per_page
+        
         return self.client.get(self._url(), params=params)
 
     def create(self, body):
@@ -54,7 +64,7 @@ class Clients(object):
 
         return self.client.post(self._url(), data=body)
 
-    def get(self, id, fields=[], include_fields=True):
+    def get(self, id, fields=None, include_fields=True):
         """Retrieves an application by its id.
 
         Important: The client_secret, encryption_key and signing_keys
@@ -68,10 +78,10 @@ class Clients(object):
               retrieve all fields.
 
            include_fields (bool, optional): True if the fields specified are
-              to be include in the result, False otherwise.
+              to be included in the result, False otherwise.
         """
 
-        params = {'fields': ','.join(fields) or None,
+        params = {'fields': fields and ','.join(fields) or None,
                   'include_fields': str(include_fields).lower()}
 
         return self.client.get(self._url(id), params=params)

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/connections.py

@@ -23,7 +23,7 @@ class Connections(object):
             return url + '/' + id
         return url
 
-    def all(self, strategy=None, fields=[], include_fields=True):
+    def all(self, strategy=None, fields=None, include_fields=True, page=None, per_page=None, extra_params=None):
         """Retrieves all connections.
 
         Args:
@@ -35,19 +35,30 @@ class Connections(object):
               retrieve all fields.
 
            include_fields (bool, optional): True if the fields specified are
-              to be include in the result, False otherwise.
+              to be included in the result, False otherwise.
+
+           page (int): The result's page number (zero based).
+
+           per_page (int, optional): The amount of entries per page.
+
+           extra_params (dictionary, optional): The extra parameters to add to
+             the request. The fields, include_fields, page and per_page values
+             specified as parameters take precedence over the ones defined here.
 
         Returns:
            A list of connection objects.
         """
-
-        params = {'strategy': strategy or None,
-                  'fields': ','.join(fields) or None,
-                  'include_fields': str(include_fields).lower()}
+        
+        params = extra_params or {}
+        params['strategy'] = strategy or None
+        params['fields'] = fields and ','.join(fields) or None
+        params['include_fields'] = str(include_fields).lower()
+        params['page'] = page
+        params['per_page'] = per_page
 
         return self.client.get(self._url(), params=params)
 
-    def get(self, id, fields=[], include_fields=True):
+    def get(self, id, fields=None, include_fields=True):
         """Retrieve connection by id.
 
         Args:
@@ -58,13 +69,13 @@ class Connections(object):
               retrieve all fields.
 
            include_fields (bool, optional): True if the fields specified are
-              to be include in the result, False otherwise.
+              to be included in the result, False otherwise.
 
         Returns:
             A connection object.
         """
 
-        params = {'fields': ','.join(fields) or None,
+        params = {'fields': fields and ','.join(fields) or None,
                   'include_fields': str(include_fields).lower()}
 
         return self.client.get(self._url(id), params=params)

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/device_credentials.py

@@ -24,7 +24,7 @@ class DeviceCredentials(object):
             return url + '/' + id
         return url
 
-    def get(self, user_id, client_id, type, fields=[], include_fields=True):
+    def get(self, user_id, client_id, type, fields=None, include_fields=True):
         """List device credentials.
 
         Args:
@@ -39,12 +39,12 @@ class DeviceCredentials(object):
                 retrieve all fields
 
             include_fields (bool, optional): True if the fields specified are
-                to be excluded from the result, false otherwise
+                to be included in the result, False otherwise
                 (defaults to true)
         """
 
         params = {
-            'fields': ','.join(fields) or None,
+            'fields': fields and ','.join(fields) or None,
             'include_fields': str(include_fields).lower(),
             'user_id': user_id,
             'client_id': client_id,

usr/local/lib/python3.7/site-packages/auth0/v3/management/email_templates.py

@@ -0,0 +1,65 @@
+from .rest import RestClient
+
+
+class EmailTemplates(object):
+
+    """Auth0 email templates endpoints
+
+    Args:
+        domain (str): Your Auth0 domain, e.g: 'username.auth0.com'
+
+        token (str): Management API v2 Token
+
+        telemetry (bool, optional): Enable or disable Telemetry
+            (defaults to True)
+    """
+
+    def __init__(self, domain, token, telemetry=True):
+        self.domain = domain
+        self.client = RestClient(jwt=token, telemetry=telemetry)
+
+    def _url(self, id=None):
+        url = 'https://%s/api/v2/email-templates' % self.domain
+        if id is not None:
+            return url + '/' + id
+        return url
+
+    def create(self, body):
+        """Create a new email template.
+
+        Args: 
+           body (dict): Attributes for the new email template.
+              See: https://auth0.com/docs/api/management/v2#!/Email_Templates/post_email_templates
+        """
+
+        return self.client.post(self._url(), data=body)
+
+
+    def get(self, template_name):
+        """Retrieves an email template by its name.
+
+        Args:
+           template_name (str): Name of the email template to get. 
+              Must be one of: 'verify_email', 'reset_email', 'welcome_email', 
+              'blocked_account', 'stolen_credentials', 'enrollment_email', 
+              'change_password', 'password_reset', 'mfa_oob_code'.
+              See: https://auth0.com/docs/api/management/v2#!/Email_Templates/get_email_templates_by_templateName
+        """
+
+        return self.client.get(self._url(template_name))
+
+
+    def update(self, template_name, body):
+        """Update an existing email template.
+
+        Args:
+           template_name (str): Name of the email template to update. 
+              Must be one of: 'verify_email', 'reset_email', 'welcome_email', 
+              'blocked_account', 'stolen_credentials', 'enrollment_email', 
+              'change_password', 'password_reset', 'mfa_oob_code'. 
+
+           body (dict): Attributes to update on the email template.
+              See: https://auth0.com/docs/api/management/v2#!/Email_Templates/patch_email_templates_by_templateName
+        """
+
+        return self.client.patch(self._url(template_name), data=body)

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/emails.py

@@ -24,7 +24,7 @@ class Emails(object):
             return url + '/' + id
         return url
 
-    def get(self, fields=[], include_fields=True):
+    def get(self, fields=None, include_fields=True):
         """Get the email provider.
 
         Args:
@@ -33,9 +33,9 @@ class Emails(object):
                 to retrieve all fields.
 
             include_fields (bool, optional): True if the fields specified are
-                to be include in the result, False otherwise.
+                to be included in the result, False otherwise.
         """
-        params = {'fields': ','.join(fields) or None,
+        params = {'fields': fields and ','.join(fields) or None,
                   'include_fields': str(include_fields).lower()}
 
         return self.client.get(self._url(), params=params)

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/logs.py

@@ -44,10 +44,10 @@ class Logs(object):
                 retrieve all fields.
 
             include_fields (bool, optional): True if the fields specified are
-                to be include in the result, False otherwise.
+                to be included in the result, False otherwise.
 
-            include_totals (bool, optional): true if a query summary must be
-                included in the result, false otherwise. Default false.
+            include_totals (bool, optional): True if the query summary is
+                to be included in the result, False otherwise.
 
             from_param (str, optional): Log Event Id to start retrieving logs. You can
                 limit the amount of logs using the take parameter

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/resource_servers.py

@@ -34,11 +34,25 @@ class ResourceServers(object):
 
         return self.client.post(self._url(), data=body)
 
-    def get_all(self):
+    def get_all(self, page=None, per_page=None, include_totals=False):
         """Retrieves all resource servers
+
+        Args:
+            page (int, optional): The result's page number (zero based).
+
+            per_page (int, optional): The amount of entries per page.
+
+            include_totals (bool, optional): True if the query summary is
+                to be included in the result, False otherwise.
         """
 
-        return self.client.get(self._url())
+        params = {
+            'page': page,
+            'per_page': per_page,
+            'include_totals': str(include_totals).lower()
+        }
+
+        return self.client.get(self._url(), params=params)
 
     def get(self, id):
         """Retrieves a resource server by its id.
@@ -65,6 +79,7 @@ class ResourceServers(object):
            id (str): The id of the resource server to update.
 
            body (dict): Attributes to modify.
+              See: https://auth0.com/docs/api/management/v2#!/Resource_Servers/patch_resource_servers_by_id
         """
 
         return self.client.patch(self._url(id), data=body)

usr/local/lib/{python3.6 → python3.7}/site-packages/auth0/v3/management/rest.py

@@ -47,7 +47,7 @@ class RestClient(object):
         else:
             self.base_headers = {}
 
-    def get(self, url, params={}):
+    def get(self, url, params=None):
         headers = self.base_headers.copy()
         headers.update({
             'Authorization': 'Bearer %s' % self.jwt,
@@ -56,17 +56,17 @@ class RestClient(object):
         response = requests.get(url, params=params, headers=headers)
         return self._process_response(response)
 
-    def post(self, url, data={}):
+    def post(self, url, data=None):
         headers = self.base_headers.copy()
         headers.update({
             'Authorization': 'Bearer %s' % self.jwt,
             'Content-Type': 'application/json'
         })
 
-        response = requests.post(url, data=json.dumps(data), headers=headers)
+        response = requests.post(url, data=json.dumps(data or {}), headers=headers)
         return self._process_response(response)
 
-    def file_post(self, url, data={}, files={}):
+    def file_post(self, url, data=None, files=None):
         headers = self.base_headers.copy()
         headers.pop('Content-Type', None)
         headers.update({
@@ -76,33 +76,33 @@ class RestClient(object):
         response = requests.post(url, data=data, files=files, headers=headers)
         return self._process_response(response)
 
-    def patch(self, url, data={}):
+    def patch(self, url, data=None):
         headers = self.base_headers.copy()
         headers.update({
             'Authorization': 'Bearer %s' % self.jwt,
             'Content-Type': 'application/json'
         })
 
-        response = requests.patch(url, data=json.dumps(data), headers=headers)
+        response = requests.patch(url, data=json.dumps(data or {}), headers=headers)
         return self._process_response(response)
 
-    def put(self, url, data={}):
+    def put(self, url, data=None):
         headers = self.base_headers.copy()
         headers.update({
             'Authorization': 'Bearer %s' % self.jwt,
             'Content-Type': 'application/json'
         })
 
-        response = requests.put(url, data=json.dumps(data), headers=headers)
+        response = requests.put(url, data=json.dumps(data or {}), headers=headers)
         return self._process_response(response)
 
-    def delete(self, url, params={}):
+    def delete(self, url, params=None):
         headers = self.base_headers.copy()
         headers.update({
             'Authorization': 'Bearer %s' % self.jwt,
         })
 
-        response = requests.delete(url, headers=headers, params=params)
+        response = requests.delete(url, headers=headers, params=params or {})
         return self._process_response(response)
 
     def _process_response(self, response):
@@ -153,7 +153,10 @@ class JsonResponse(Response):
             return UNKNOWN_ERROR
 
     def _error_message(self):
-        return self._content.get('error', self._content.get('message', ''))
+        message = self._content.get('message', '')
+        if message is not None and message != '':
+            return message
+        return self._content.get('error', '')
 
 class PlainResponse(Response):
     def __init__(self, response):