feat: adding A/B testing SPIs to core package (#195)

Co-authored-by: Shreyas Govinda Raju <shreraju@amazon.com>

Author: Shreyas-vgr

ask-sdk-core/ask_sdk_core/response_helper.py

@@ -19,6 +19,8 @@
 import typing
 
 from ask_sdk_model import Response
+from ask_sdk_model.interfaces.alexa.experimentation.experiment_trigger_response import \
+    ExperimentTriggerResponse
 from ask_sdk_model.interfaces.display import PlainText, RichText, TextContent
 from ask_sdk_model.ui import Reprompt, SsmlOutputSpeech
 
@@ -51,7 +53,8 @@ def __init__(self):
         self.response = Response(
             output_speech=None, card=None, reprompt=None,
             directives=None, should_end_session=None,
-            can_fulfill_intent=None, api_response=None)
+            can_fulfill_intent=None, api_response=None,
+            experimentation=None)
 
     def speak(self, speech, play_behavior=None):
         # type: (str, PlayBehavior) -> 'ResponseFactory'
@@ -152,6 +155,22 @@ def add_directive_to_reprompt(self, directive):
         self.set_should_end_session(False)
         return self
 
+    def add_experiment_trigger(self, experiment_id):
+        # type: (str) -> 'ResponseFactory'
+        """Adds experiment id to response.
+        :param experiment_id: the identifier of the experiment.
+        :type experiment_id: str
+        :return: response factory with partial response being built and
+            access from self.response.
+        :rtype: ResponseFactory
+        """
+        if self.response.experimentation is None:
+           triggered_experiments = []  # type: ignore
+           self.response.experimentation = ExperimentTriggerResponse(triggered_experiments=triggered_experiments)
+
+        self.response.experimentation.triggered_experiments.append(experiment_id)
+        return self
+
     def set_should_end_session(self, should_end_session):
         # type: (bool) -> 'ResponseFactory'
         """Sets shouldEndSession value to null/false/true.

ask-sdk-core/tests/unit/test_response_helper.py

@@ -29,6 +29,8 @@
                                       CanUnderstandSlotValues)
 from ask_sdk_model.interfaces.alexa.presentation.apla.render_document_directive import \
     RenderDocumentDirective
+from ask_sdk_model.interfaces.alexa.experimentation.experiment_trigger_response import \
+    ExperimentTriggerResponse
 from ask_sdk_model.interfaces.display import PlainText, RichText, TextContent
 from ask_sdk_model.interfaces.videoapp import (LaunchDirective, Metadata,
                                                VideoItem)
@@ -131,6 +133,15 @@ def test_add_reprompt_directive(self):
             "to add directive"
         )
 
+    def test_add_experiment_trigger_response(self):
+        test_experiment_triggers = ["experimentId"]
+        response_factory = self.response_factory.add_experiment_trigger(
+            experiment_id="experimentId")
+
+        assert response_factory.response.experimentation.triggered_experiments == test_experiment_triggers, (
+            "The add_experiment_trigger method of ResponseFactory fails to "
+            "add experiment_trigger_response value")
+
     def test_response_with_reprompt_directive(self):
         directive = RenderDocumentDirective()
         expected_response = Response(