Merge branch 'dev' into 6-get-sections

Author: dynata-bradley

CmixAPIClient/api.py

@@ -213,6 +213,19 @@ def get_survey_respondents(self, survey_id, respondent_type, live):
         respondents_response = requests.get(respondents_url, headers=self._authentication_headers)
         return respondents_response.json()
 
+    def get_survey_locales(self, survey_id):
+        self.check_auth_headers()
+        locales_url = '{}/surveys/{}/locales'.format(CMIX_SERVICES['survey'][self.url_type], survey_id)
+        locales_response = requests.get(locales_url, headers=self._authentication_headers)
+        if locales_response.status_code != 200:
+            raise CmixError(
+                'CMIX returned a non-200 response code while getting locales: {} and error {}'.format(
+                    locales_response.status_code,
+                    locales_response.text
+                )
+            )
+        return locales_response.json()
+
     def get_survey_status(self, survey_id):
         self.check_auth_headers()
         status_url = '{}/surveys/{}'.format(CMIX_SERVICES['survey'][self.url_type], survey_id)

README.md

@@ -31,6 +31,7 @@ A Python client library for the [Dynata Cmix API](https://wiki2.criticalmix.net/
     get_surveys(status, *args, **kwargs)
     get_survey_data_layouts(survey_id)
     get_survey_definition(survey_id)
+    get_survey_locales(survey_id)
     get_survey_xml(survey_id)
     get_survey_sections(survey_id)
     get_survey_simulations(survey_id)

tests/test_api.py

@@ -178,7 +178,18 @@ def test_get_survey_sections(self):
             mock_get.status_code = 200
             mock_get.json.return_value = {}
             mock_request.get.return_value = mock_get
+            self.cmix_api.get_survey_locales(self.survey_id)
 
+            base_url = CMIX_SERVICES['survey']['BASE_URL']
+            surveys_url = '{}/surveys/{}/locales'.format(base_url, self.survey_id)
+            mock_request.get.assert_any_call(surveys_url, headers=self.cmix_api._authentication_headers)
+
+        # error case (survey not found)
+        with mock.patch('CmixAPIClient.api.requests') as mock_request:
+            mock_get = mock.Mock()
+            mock_get.status_code = 404
+            mock_get.json.return_value = {}
+            mock_request.get.return_value = mock_get
             self.cmix_api.get_survey_sections(self.survey_id)
 
             base_url = CMIX_SERVICES['survey']['BASE_URL']
@@ -195,6 +206,31 @@ def test_get_survey_sections(self):
             with self.assertRaises(CmixError):
                 self.cmix_api.get_survey_sections(self.survey_id)
 
+    def test_get_survey_locales(self):
+        self.cmix_api._authentication_headers = {'Authentication': 'Bearer test'}
+
+        # success case
+        with mock.patch('CmixAPIClient.api.requests') as mock_request:
+            mock_get = mock.Mock()
+            mock_get.status_code = 200
+            mock_get.json.return_value = {}
+            mock_request.get.return_value = mock_get
+            self.cmix_api.get_survey_locales(self.survey_id)
+
+            base_url = CMIX_SERVICES['survey']['BASE_URL']
+            surveys_url = '{}/surveys/{}/locales'.format(base_url, self.survey_id)
+            mock_request.get.assert_any_call(surveys_url, headers=self.cmix_api._authentication_headers)
+
+        # error case (survey not found)
+        with mock.patch('CmixAPIClient.api.requests') as mock_request:
+            mock_get = mock.Mock()
+            mock_get.status_code = 404
+            mock_get.json.return_value = {}
+            mock_request.get.return_value = mock_get
+
+            with self.assertRaises(CmixError):
+                self.cmix_api.get_survey_locales(self.survey_id)
+
     def test_get_survey_sources(self):
         self.cmix_api._authentication_headers = {'Authentication': 'Bearer test'}