initial work on call feedback

Doug Black · Doug Black · commit d8b28bb5f985 · 2014-03-19T16:51:36.000-07:00
diff --git a/twilio/rest/resources/applications.py b/twilio/rest/resources/applications.py
@@ -25,7 +25,7 @@ class Applications(ListResource):
     def list(self, **kwargs):
         """
         Returns a page of :class:`Application` resources as a list. For paging
-        informtion see :class:`ListResource`
+        information see :class:`ListResource`
 
         :param date friendly_name: List applications with this friendly name
         """
diff --git a/twilio/rest/resources/call_feedback.py b/twilio/rest/resources/call_feedback.py
@@ -0,0 +1,52 @@
+from twilio.rest.resources import ListResource, InstanceResource, transform_params
+
+
+class CallFeedbackFactory(ListResource):
+
+    """
+    CallFeedback is a unique endpoint in the API in that it only
+    has an instance representation, and that instance representation
+    lives at the same URL you POST to to create it. Here, our
+    ListResource class acts as a Factory resource.
+    """
+
+    name = "Feedback"
+    instance = CallFeedback
+
+    def create(self, **kwargs):
+        """
+        Create a :class:`CallFeedback` object for the parent call.
+
+        :param int quality: The score quality. Must be an
+            int between 1 and 5.
+        :param list issue: A list of issues. The issue types are
+            found at the CallFeedback rest docs.
+        """
+        return self.create_instance(kwargs)
+
+    def get(self, **kwargs):
+        """ Get the feedback for this call
+
+         Usage:
+
+         .. code-block:: python
+            feedback = client.calls.get("CA123").feedback
+            print feedback.issues
+
+        :rtype: :class:`~twilio.rest.resources.InstanceResource`
+        :raises: a :exc:`~twilio.TwilioRestException` if the request fails
+        """
+        params = transform_params(kwargs)
+        resp, _ = self.request("GET", self.uri, params=params)
+        return self.load_instance(resp)
+
+    def load_instance(self, data):
+        # Overridden because CallFeedback instances
+        # don't contain sids :(
+        instance = self.instance(self)
+        instance.load(data)
+        return instance
+
+
+class CallFeedback(InstanceResource):
+    pass
diff --git a/twilio/rest/resources/calls.py b/twilio/rest/resources/calls.py
@@ -1,5 +1,6 @@
 from .notifications import Notifications
 from .recordings import Recordings
+from twilio.rest.resources.call_feedback import CallFeedbackFactory
 from .util import normalize_dates, parse_date
 from . import InstanceResource, ListResource
 
@@ -19,6 +20,7 @@ class Call(InstanceResource):
     subresources = [
         Notifications,
         Recordings,
+        CallFeedbackFactory,
     ]
 
     def hangup(self):
