feat(Speech to Text): New param force in upgrade_acoustic_model

Author: ehdsouza

test/unit/test_speech_to_text_v1.py

@@ -297,6 +297,29 @@ def test_acoustic_model():
 
     assert len(responses.calls) == 6
 
+@responses.activate
+def test_upgrade_acoustic_model():
+    acoustic_customization_url = 'https://stream.watsonplatform.net/speech-to-text/api/v1/acoustic_customizations'
+    upgrade_url = "{0}/{1}/upgrade_model".format(acoustic_customization_url, 'customid')
+
+    responses.add(
+        responses.POST,
+        upgrade_url,
+        body='{"bogus_response": "yep"}',
+        status=200,
+        content_type='application/json')
+
+    speech_to_text = watson_developer_cloud.SpeechToTextV1(
+        username="username", password="password")
+
+    speech_to_text.upgrade_acoustic_model(
+        'customid',
+        'model_x',
+        force=True)
+    assert responses.calls[0].response.json() == {"bogus_response": "yep"}
+
+    assert len(responses.calls) == 1
+
 
 def test_custom_corpora():
 

watson_developer_cloud/speech_to_text_v1.py

@@ -2306,6 +2306,7 @@ def train_acoustic_model(self,
     def upgrade_acoustic_model(self,
                                customization_id,
                                custom_language_model_id=None,
+                               force=None,
                                **kwargs):
         """
         Upgrade a custom acoustic model.
@@ -2339,7 +2340,15 @@ def upgrade_acoustic_model(self,
         :param str custom_language_model_id: If the custom acoustic model was trained with
         a custom language model, the customization ID (GUID) of that custom language
         model. The custom language model must be upgraded before the custom acoustic model
-        can be upgraded.
+        can be upgraded. The credentials specified with the request must own both custom
+        models.
+        :param bool force: If `true`, forces the upgrade of a custom acoustic model for
+        which no input data has been modified since it was last trained. Use this
+        parameter only to force the upgrade of a custom acoustic model that is trained
+        with a custom language model, and only if you receive a 400 response code and the
+        message `No input data modified since last training`. See [Upgrading a custom
+        acoustic
+        model](https://cloud.ibm.com/docs/services/speech-to-text/custom-upgrade.html#upgradeAcoustic).
         :param dict headers: A `dict` containing the request headers
         :return: A `DetailedResponse` containing the result, headers and HTTP status code.
         :rtype: DetailedResponse
@@ -2351,8 +2360,13 @@ def upgrade_acoustic_model(self,
         headers = {}
         if 'headers' in kwargs:
             headers.update(kwargs.get('headers'))
+        headers[
+            'X-IBMCloud-SDK-Analytics'] = 'service_name=speech_to_text;service_version=V1;operation_id=upgrade_acoustic_model'
 
-        params = {'custom_language_model_id': custom_language_model_id}
+        params = {
+            'custom_language_model_id': custom_language_model_id,
+            'force': force
+        }
 
         url = '/v1/acoustic_customizations/{0}/upgrade_model'.format(
             *self._encode_path_vars(customization_id))