Implement quick reply (#120)

* Implement quick reply

* Polish

Author: be-hase

README.rst

@@ -600,6 +600,16 @@ TemplateSendMessage - ImageCarouselTemplate
         )
     )
 
+With QuickReply
+^^^^^^^^^^^^^^^
+
+.. code:: python
+
+    text_message = TextSendMessage(text='Hello, world',
+                                   quick_reply=QuickReply(items=[
+                                       QuickReplyButton(action=MessageAction(label="label", text="text"))
+                                   ]))
+
 Webhook
 -------
 

examples/flask-kitchensink/app.py

@@ -19,6 +19,7 @@
 import sys
 import tempfile
 from argparse import ArgumentParser
+
 from flask import Flask, request, abort
 
 from linebot import (
@@ -33,13 +34,14 @@
     TemplateSendMessage, ConfirmTemplate, MessageAction,
     ButtonsTemplate, ImageCarouselTemplate, ImageCarouselColumn, URIAction,
     PostbackAction, DatetimePickerAction,
+    CameraAction, CameraRollAction, LocationAction,
     CarouselTemplate, CarouselColumn, PostbackEvent,
     StickerMessage, StickerSendMessage, LocationMessage, LocationSendMessage,
     ImageMessage, VideoMessage, AudioMessage, FileMessage,
     UnfollowEvent, FollowEvent, JoinEvent, LeaveEvent, BeaconEvent,
     FlexSendMessage, BubbleContainer, ImageComponent, BoxComponent,
     TextComponent, SpacerComponent, IconComponent, ButtonComponent,
-    SeparatorComponent,
+    SeparatorComponent, QuickReply, QuickReplyButton
 )
 
 app = Flask(__name__)
@@ -278,6 +280,34 @@ def handle_text_message(event):
             event.reply_token,
             message
         )
+    elif text == 'quick_reply':
+        line_bot_api.reply_message(
+            event.reply_token,
+            TextSendMessage(
+                text='Quick reply',
+                quick_reply=QuickReply(
+                    items=[
+                        QuickReplyButton(
+                            action=PostbackAction(label="label1", data="data1")
+                        ),
+                        QuickReplyButton(
+                            action=MessageAction(label="label2", text="text2")
+                        ),
+                        QuickReplyButton(
+                            action=DatetimePickerAction(label="label3",
+                                                        data="data3",
+                                                        mode="date")
+                        ),
+                        QuickReplyButton(
+                            action=CameraAction(label="label4")
+                        ),
+                        QuickReplyButton(
+                            action=CameraRollAction(label="label5")
+                        ),
+                        QuickReplyButton(
+                            action=LocationAction(label="label6")
+                        ),
+                    ])))
     else:
         line_bot_api.reply_message(
             event.reply_token, TextSendMessage(text=event.message.text))

linebot/__about__.py

@@ -16,7 +16,7 @@
 
 from __future__ import unicode_literals
 
-__version__ = '1.7.2'
+__version__ = '1.8.0'
 __author__ = 'LINE Corporation'
 __copyright__ = 'Copyright 2016, LINE Corporation'
 __license__ = 'Apache 2.0'

linebot/models/__init__.py

@@ -20,6 +20,9 @@
     MessageAction,
     URIAction,
     DatetimePickerAction,
+    CameraAction,
+    CameraRollAction,
+    LocationAction,
     Action as TemplateAction,  # backward compatibility
     PostbackAction as PostbackTemplateAction,  # backward compatibility
     MessageAction as MessageTemplateAction,  # backward compatibility
@@ -47,6 +50,23 @@
     Beacon,
     Link,
 )
+from .flex_message import (  # noqa
+    FlexSendMessage,
+    FlexContainer,
+    BubbleContainer,
+    BubbleStyle,
+    BlockStyle,
+    CarouselContainer,
+    FlexComponent,
+    BoxComponent,
+    ButtonComponent,
+    FillerComponent,
+    IconComponent,
+    ImageComponent,
+    SeparatorComponent,
+    SpacerComponent,
+    TextComponent
+)
 from .imagemap import (  # noqa
     ImagemapSendMessage,
     BaseSize,
@@ -86,6 +106,8 @@
     AudioSendMessage,
     LocationSendMessage,
     StickerSendMessage,
+    QuickReply,
+    QuickReplyButton,
 )
 from .sources import (  # noqa
     Source,
@@ -103,20 +125,3 @@
     ImageCarouselTemplate,
     ImageCarouselColumn,
 )
-from .flex_message import (  # noqa
-    FlexSendMessage,
-    FlexContainer,
-    BubbleContainer,
-    BubbleStyle,
-    BlockStyle,
-    CarouselContainer,
-    FlexComponent,
-    BoxComponent,
-    ButtonComponent,
-    FillerComponent,
-    IconComponent,
-    ImageComponent,
-    SeparatorComponent,
-    SpacerComponent,
-    TextComponent
-)

linebot/models/actions.py

@@ -30,7 +30,10 @@ def get_action(action):
             'postback': PostbackAction,
             'message': MessageAction,
             'uri': URIAction,
-            'datetimepicker': DatetimePickerAction
+            'datetimepicker': DatetimePickerAction,
+            'camera': CameraAction,
+            'cameraRoll': CameraRollAction,
+            'location': LocationAction,
         }
     )
     return action_obj
@@ -176,3 +179,69 @@ def __init__(self, label=None, data=None, mode=None,
         self.initial = initial
         self.max = max
         self.min = min
+
+
+class CameraAction(Action):
+    """CameraAction.
+
+    https://developers.line.me/en/reference/messaging-api/#camera-action
+
+    This action can be configured only with quick reply buttons.
+    When a button associated with this action is tapped,
+    the camera screen in the LINE app is opened.
+    """
+
+    def __init__(self, label=None, **kwargs):
+        """__init__ method.
+
+        :param str label: Label for the action
+        :param kwargs:
+        """
+        super(CameraAction, self).__init__(**kwargs)
+
+        self.type = 'camera'
+        self.label = label
+
+
+class CameraRollAction(Action):
+    """CameraRollAction.
+
+    https://developers.line.me/en/reference/messaging-api/#camera-roll-action
+
+    This action can be configured only with quick reply buttons.
+    When a button associated with this action is tapped,
+    the camera roll screen in the LINE app is opened.
+    """
+
+    def __init__(self, label=None, **kwargs):
+        """__init__ method.
+
+        :param str label: Label for the action
+        :param kwargs:
+        """
+        super(CameraRollAction, self).__init__(**kwargs)
+
+        self.type = 'cameraRoll'
+        self.label = label
+
+
+class LocationAction(Action):
+    """LocationRollAction.
+
+    https://developers.line.me/en/reference/messaging-api/#location-action
+
+    This action can be configured only with quick reply buttons.
+    When a button associated with this action is tapped,
+    the location screen in the LINE app is opened.
+    """
+
+    def __init__(self, label=None, **kwargs):
+        """__init__ method.
+
+        :param str label: Label for the action
+        :param kwargs:
+        """
+        super(LocationAction, self).__init__(**kwargs)
+
+        self.type = 'location'
+        self.label = label