Completed
Pull Request — master (#353)
by James
02:04
created

SlackSensor._handle_message_channel_join()   A

Complexity

Conditions 1

Size

Total Lines 23

Duplication

Lines 0
Ratio 0 %
Metric Value
cc 1
dl 0
loc 23
rs 9.0857
1
import json
2
import re
3
4
import eventlet
5
from slackclient import SlackClient
6
7
from st2reactor.sensor.base import PollingSensor
8
9
eventlet.monkey_patch(
10
    os=True,
11
    select=True,
12
    socket=True,
13
    thread=True,
14
    time=True)
15
16
EVENT_TYPE_WHITELIST = [
17
    'message'
18
]
19
20
21
class SlackSensor(PollingSensor):
22
    DATASTORE_KEY_NAME = 'last_message_timestamp'
23
24
    def __init__(self, sensor_service, config=None, poll_interval=None):
25
        super(SlackSensor, self).__init__(sensor_service=sensor_service,
26
                                          config=config,
27
                                          poll_interval=poll_interval)
28
        self._logger = self._sensor_service.get_logger(__name__)
29
        self._token = self._config['sensor']['token']
30
        self._strip_formatting = self._config['sensor'].get('strip_formatting',
31
                                                            False)
32
        self._handlers = {
33
            'message': self._handle_message_ignore_errors,
34
        }
35
        self._message_subtype_handlers = {
36
            'channel_join': self._handle_message_channel_join,
37
        }
38
39
        self._user_info_cache = {}
40
        self._channel_info_cache = {}
41
        self._group_info_cache = {}
42
43
        self._last_message_timestamp = None
44
45
    def setup(self):
46
        self._client = SlackClient(self._token)
47
        data = self._client.rtm_connect()
48
49
        if not data:
50
            msg = 'Failed to connect to the Slack API. Invalid token?'
51
            raise Exception(msg)
52
53
        self._populate_cache(user_data=self._api_call('users.list'),
54
                             channel_data=self._api_call('channels.list'),
55
                             group_data=self._api_call('groups.list'),)
56
57
    def poll(self):
58
        result = self._client.rtm_read()
59
60
        if not result:
61
            return
62
63
        last_message_timestamp = self._handle_result(result=result)
64
65
        if last_message_timestamp:
66
            self._set_last_message_timestamp(
67
                last_message_timestamp=last_message_timestamp)
68
69
    def cleanup(self):
70
        pass
71
72
    def add_trigger(self, trigger):
73
        pass
74
75
    def update_trigger(self, trigger):
76
        pass
77
78
    def remove_trigger(self, trigger):
79
        pass
80
81
    def _get_last_message_timestamp(self):
82
        """
83
        :rtype: ``int``
84
        """
85
        if not self._last_message_timestamp:
86
            name = self.DATASTORE_KEY_NAME
87
            value = self._sensor_service.get_value(name=name)
88
            self._last_message_timestamp = int(value) if value else 0
89
90
        return self._last_message_timestamp
91
92
    def _set_last_message_timestamp(self, last_message_timestamp):
93
        self._last_message_timestamp = last_message_timestamp
94
        name = self.DATASTORE_KEY_NAME
95
        value = str(last_message_timestamp)
96
        self._sensor_service.set_value(name=name, value=value)
97
        return last_message_timestamp
98
99
    def _populate_cache(self, user_data, channel_data, group_data):
100
        """
101
        Populate users, channels and group cache from info which is returned on
102
        rtm.start
103
        """
104
105
        for user in user_data.get('members', []):
106
            self._user_info_cache[user['id']] = user
107
108
        for channel in channel_data.get('channels', []):
109
            self._channel_info_cache[channel['id']] = channel
110
111
        for group in group_data.get('groups', []):
112
            self._group_info_cache[group['id']] = group
113
114
    def _handle_result(self, result):
115
        """
116
        Handle / process the result and return timestamp of the last message.
117
        """
118
        existing_last_message_timestamp = self._get_last_message_timestamp()
119
        new_last_message_timestamp = existing_last_message_timestamp
120
121
        for item in result:
122
            item_type = item['type']
123
            item_timestamp = int(float(item.get('ts', 0)))
124
125
            if (existing_last_message_timestamp and
126
                    item_timestamp <= existing_last_message_timestamp):
127
                # We have already seen this message, skip it
128
                continue
129
130
            if item_timestamp > new_last_message_timestamp:
131
                new_last_message_timestamp = item_timestamp
132
133
            handler_func = self._handlers.get(item_type, lambda data: data)
134
            handler_func(data=item)
135
136
        return new_last_message_timestamp
137
138
    def _handle_message(self, data):
139
        trigger = 'slack.message'
140
        event_type = data['type']
141
142
        if event_type not in EVENT_TYPE_WHITELIST or 'subtype' in data:
143
            # Skip unsupported event
144
            return
145
146
        if 'subtype' in data and data['subtype'] in self._message_subtype_handlers:
147
            subtype = data['subtype']
148
            handler = self._message_subtype_handlers.get(subtype)
149
            handler(data)
150
        else:
151
          # Note: We resolve user and channel information to provide more context
152
          user_info = self._get_user_info(user_id=data['user'])
153
          channel_info = None
154
          channel_id = data.get('channel', '')
155
          # Grabbing info based on the type of channel the message is in.
156
          if channel_id.startswith('C'):
157
              channel_info = self._get_channel_info(channel_id=channel_id)
158
          elif channel_id.startswith('G'):
159
              channel_info = self._get_group_info(group_id=channel_id)
160
161
          if not user_info or not channel_info:
162
              # Deleted user or channel
163
              return
164
165
          # Removes formatting from messages if enabled by the user in config
166
          if self._strip_formatting:
167
              text = re.sub("<http.*[|](.*)>", "\\1", data['text'])
168
          else:
169
              text = data['text']
170
171
          payload = {
172
              'user': {
173
                  'id': user_info['id'],
174
                  'name': user_info['name'],
175
                  'first_name': user_info['profile'].get('first_name',
176
                                                        'Unknown'),
177
                  'last_name': user_info['profile'].get('last_name',
178
                                                        'Unknown'),
179
                  'real_name': user_info['profile'].get('real_name',
180
                                                        'Unknown'),
181
                  'is_admin': user_info['is_admin'],
182
                  'is_owner': user_info['is_owner']
183
              },
184
              'channel': {
185
                  'id': channel_info['id'],
186
                  'name': channel_info['name'],
187
                  'topic': channel_info['topic']['value'],
188
                  'is_group': channel_info.get('is_group', False),
189
              },
190
              'timestamp': int(float(data['ts'])),
191
              'timestamp_raw': data['ts'],
192
              'text': text
193
          }
194
195
          self._sensor_service.dispatch(trigger=trigger, payload=payload)
196
197
    def _handle_message_ignore_errors(self, data):
198
        try:
199
            self._handle_message(data)
200
        except Exception as exc:
201
            self._logger.info("Slack sensor encountered an error "
202
                              "handling message: %s" % exc)
203
            pass
204
205
    def _get_user_info(self, user_id):
206
        if user_id not in self._user_info_cache:
207
            result = self._api_call('users.info', user=user_id)
208
209
            if 'user' not in result:
210
                # User doesn't exist or other error
211
                return None
212
213
            result = result['user']
214
            self._user_info_cache[user_id] = result
215
216
        return self._user_info_cache[user_id]
217
218
    def _get_channel_info(self, channel_id):
219
        if channel_id not in self._channel_info_cache:
220
            result = self._api_call('channels.info', channel=channel_id)
221
222
            if 'channel' not in result:
223
                # Channel doesn't exist or other error
224
                return None
225
226
            result = result['channel']
227
            self._channel_info_cache[channel_id] = result
228
229
        return self._channel_info_cache[channel_id]
230
231
    def _get_group_info(self, group_id):
232
        if group_id not in self._group_info_cache:
233
            result = self._api_call('groups.info', channel=group_id)
234
            self._logger.warn('GROUP DATA: %s' % result)
235
            if 'group' not in result:
236
                # Group doesn't exist or other error
237
                return None
238
239
            result = result['group']
240
            self._group_info_cache[group_id] = result
241
242
        return self._group_info_cache[group_id]
243
244
    def _api_call(self, method, **kwargs):
245
        result = self._client.api_call(method, **kwargs)
246
        result = json.loads(result)
247
        return result
248
249
    def _handle_message_channel_join(self, data):
250
        trigger = 'slack.message_channel_join'
251
        user_info = self._get_user_info(user_id=data['user'])
252
253
        payload = {
254
            'user': {
255
                'id': user_info['id'],
256
                'name': user_info['name'],
257
                'first_name': user_info['profile'].get('first_name',
258
                                                      'Unknown'),
259
                'last_name': user_info['profile'].get('last_name',
260
                                                      'Unknown'),
261
                'real_name': user_info['profile'].get('real_name',
262
                                                      'Unknown'),
263
                'is_admin': user_info['is_admin'],
264
                'is_owner': user_info['is_owner']
265
            },
266
            'timestamp': int(float(data['ts'])),
267
            'timestamp_raw': data['ts'],
268
            'text': text
269
        }
270
271
        self._sensor_service.dispatch(trigger=trigger, payload=payload)
272