Add /dbconnections/signup with username and metadata (#169)

* add dbconnections/signup with username and metadata

* chore comments

Author: lbalmaceda

auth0/v3/authentication/database.py

@@ -36,18 +36,38 @@ def login(self, client_id, username, password, connection, id_token=None,
             headers={'Content-Type': 'application/json'}
         )
 
-    def signup(self, client_id, email, password, connection):
-        """Signup using username and password.
+    def signup(self, client_id, email, password, connection, username=None,
+             user_metadata=None):
+        """Signup using email and password.
+        
+        Args:
+           client_id (str): ID of the application to use.
+
+           email (str): The user's email address.
+
+           password (str): The user's desired password.
+
+           connection (str): The name of the database connection where this user should be created.
+
+           username (str, optional): The user's username, if required by the database connection.
+
+           user_metadata (dict, optional): Additional key-value information to store for the user.
+                    Some limitations apply, see: https://auth0.com/docs/metadata#metadata-restrictions
+
+        See: https://auth0.com/docs/api/authentication#signup
         """
+        body = {
+            'client_id': client_id,
+            'email': email,
+            'password': password,
+            'connection': connection,
+            'username': username,
+            'user_metadata': user_metadata
+        }
 
         return self.post(
             'https://{}/dbconnections/signup'.format(self.domain),
-            data={
-                'client_id': client_id,
-                'email': email,
-                'password': password,
-                'connection': connection,
-            },
+            data=body,
             headers={'Content-Type': 'application/json'}
         )
 

auth0/v3/test/authentication/test_database.py

@@ -41,6 +41,7 @@ def test_signup(self, mock_post):
 
         d = Database('my.domain.com')
 
+        # using only email and password
         d.signup(client_id='cid',
                  email='a@b.com',
                  password='pswd',
@@ -54,7 +55,39 @@ def test_signup(self, mock_post):
                          'email': 'a@b.com',
                          'password': 'pswd',
                          'connection': 'conn',
-                         })
+                         'username': None,
+                         'user_metadata': None
+                        })
+        self.assertEqual(kwargs['headers'], {
+            'Content-Type': 'application/json'
+        })
+
+
+        # Using also username and metadata
+        sample_meta = {
+            'hobby': 'surfing',
+            'preference': {
+                'color': 'pink'
+            }
+        }
+        d.signup(client_id='cid',
+                 email='a@b.com',
+                 password='pswd',
+                 connection='conn',
+                 username='usr',
+                 user_metadata=sample_meta)
+
+        args, kwargs = mock_post.call_args
+
+        self.assertEqual(args[0], 'https://my.domain.com/dbconnections/signup')
+        self.assertEqual(kwargs['data'], {
+                         'client_id': 'cid',
+                         'email': 'a@b.com',
+                         'password': 'pswd',
+                         'connection': 'conn',
+                         'username': 'usr',
+                         'user_metadata': sample_meta
+                        })
         self.assertEqual(kwargs['headers'], {
             'Content-Type': 'application/json'
         })