add CRUD for organization invitations

Author: lbalmaceda

auth0/v3/management/organizations.py

@@ -271,4 +271,66 @@ def delete_organization_member_roles(self, id, user_id, body):
         See: https://auth0.com/docs/api/management/v2#!/Clients/delete_clients_by_id
         """
 
-        return self.client.delete(self._url(id, 'members', user_id, 'roles'), data=body)
+        return self.client.delete(self._url(id, 'members', user_id, 'roles'), data=body)
+
+
+    # Organization Invitations
+    def all_organization_invitations(self, id, page=None, per_page=None):
+        """Retrieves a list of all the organization invitations.
+
+        Args:
+           id (str): the ID of the organization.
+
+           page (int): The result's page number (zero based). When not set,
+              the default value is up to the server.
+
+           per_page (int, optional): The amount of entries per page. When not set,
+              the default value is up to the server.
+
+        See: https://auth0.com/docs/api/management/v2#!/Clients/get_clients
+        """
+        params = {}
+        params['page'] = page
+        params['per_page'] = per_page
+
+        return self.client.get(self._url(id, 'invitations'), params=params)
+
+    def get_organization_invitation(self, id, invitaton_id):
+        """Retrieves an organization invitation by its ID.
+
+        Args:
+           id (str): the ID of the organization.
+
+           invitaton_id (str): the ID of the invitation.
+
+        See: https://auth0.com/docs/api/management/v2#!/Clients/get_clients
+        """
+        params = {}
+
+        return self.client.get(self._url(id, 'invitations', invitaton_id), params=params)
+
+    def create_organization_invitation(self, id, body):
+        """Create an invitation to an organization.
+
+        Args:
+           id (str): the ID of the organization.
+
+           body (dict): Attributes for the invitation to create.
+
+        See: https://auth0.com/docs/api/v2#!/Clients/post_clients
+        """
+
+        return self.client.post(self._url(id, 'invitations'), data=body)
+   
+    def delete_organization_invitation(self, id, invitation_id):
+        """Deletes an invitation from the given organization.
+
+        Args:
+           id (str): Id of organization.
+
+           invitation_id (str): the ID of the invitation to delete.
+
+        See: https://auth0.com/docs/api/management/v2#!/Clients/delete_clients_by_id
+        """
+
+        return self.client.delete(self._url(id, 'invitations', invitation_id))

auth0/v3/test/management/test_organizations.py

@@ -251,4 +251,64 @@ def test_delete_organization_member_roles(self, mock_rc):
         mock_instance.delete.assert_called_with(
             'https://domain/api/v2/organizations/test-org/members/test-user/roles',
             data={'a': 'b', 'c': 'd'}
-        )
+        )
+
+    # Organization Invitations
+    @mock.patch('auth0.v3.management.organizations.RestClient')
+    def test_all_organization_invitations(self, mock_rc):
+        mock_instance = mock_rc.return_value
+
+        c = Organizations(domain='domain', token='jwttoken')
+
+        # Default parameters are requested
+        c.all_organization_invitations('test-org')
+
+        args, kwargs = mock_instance.get.call_args
+
+        self.assertEqual('https://domain/api/v2/organizations/test-org/invitations', args[0])
+        self.assertEqual(kwargs['params'], {'page': None,
+                                            'per_page': None})
+
+        # Specific pagination
+        c.all_organization_invitations('test-org', page=7, per_page=25)
+
+        args, kwargs = mock_instance.get.call_args
+
+        self.assertEqual('https://domain/api/v2/organizations/test-org/invitations', args[0])
+        self.assertEqual(kwargs['params'], {'page': 7,
+                                            'per_page': 25})
+
+    @mock.patch('auth0.v3.management.organizations.RestClient')
+    def test_get_organization_invitation(self, mock_rc):
+        mock_instance = mock_rc.return_value
+
+        c = Organizations(domain='domain', token='jwttoken')
+        c.get_organization_invitation('test-org', 'test-inv')
+
+        args, kwargs = mock_instance.get.call_args
+
+        self.assertEqual('https://domain/api/v2/organizations/test-org/invitations/test-inv', args[0])
+        self.assertEqual(kwargs['params'], {})
+
+    @mock.patch('auth0.v3.management.organizations.RestClient')
+    def test_create_organization_invitation(self, mock_rc):
+        mock_instance = mock_rc.return_value
+
+        c = Organizations(domain='domain', token='jwttoken')
+        c.create_organization_invitation('test-org', {'a': 'b', 'c': 'd'})
+
+        mock_instance.post.assert_called_with(
+            'https://domain/api/v2/organizations/test-org/invitations',
+            data={'a': 'b', 'c': 'd'}
+        )
+   
+    @mock.patch('auth0.v3.management.organizations.RestClient')
+    def test_delete_organization_invitation(self, mock_rc):
+        mock_instance = mock_rc.return_value
+
+        c = Organizations(domain='domain', token='jwttoken')
+        c.delete_organization_invitation('test-org', 'test-inv')
+
+        mock_instance.delete.assert_called_with(
+            'https://domain/api/v2/organizations/test-org/invitations/test-inv'
+        )