From 87e6eb6cf23d12fb25bf443acdbdfb99a2912d87 Mon Sep 17 00:00:00 2001
From: Chris Caron <lead2gold@gmail.com>
Date: Sun, 25 Feb 2018 19:59:37 -0500
Subject: [PATCH] Added Discord Support; refs #4

---
 README.md                                     |   1 +
 apprise/AppriseAsset.py                       |  76 +++++-
 .../assets/themes/default/apprise-logo.png    | Bin 0 -> 42935 bytes
 apprise/plugins/NotifyBase.py                 |  33 ++-
 apprise/plugins/NotifyDiscord.py              | 251 ++++++++++++++++++
 apprise/plugins/NotifySlack.py                |   2 +-
 apprise/plugins/__init__.py                   |   3 +-
 test/test_api.py                              |  26 +-
 test/test_notify_base.py                      |  10 +
 test/test_rest_plugins.py                     | 104 ++++++++
 10 files changed, 490 insertions(+), 16 deletions(-)
 create mode 100644 apprise/assets/themes/default/apprise-logo.png
 create mode 100644 apprise/plugins/NotifyDiscord.py

diff --git a/README.md b/README.md
index 3c3c54bb..9c43c41d 100644
--- a/README.md
+++ b/README.md
@@ -22,6 +22,7 @@ The table below identifies the services this tool supports and some example serv
 | Notification Service | Service ID | Default Port | Example Syntax |
 | -------------------- | ---------- | ------------ | -------------- |
 | [Boxcar](https://github.com/caronc/apprise/wiki/Notify_boxcar)  | boxcar://   | (TCP) 443   | boxcar://hostname<br />boxcar://hostname/@tag<br/>boxcar://hostname/device_token<br />boxcar://hostname/device_token1/device_token2/device_tokenN<br />boxcar://hostname/@tag/@tag2/device_token
+| [Discord](https://github.com/caronc/apprise/wiki/Notify_discord)  | discord://   | (TCP) 443   | discord://webhook_id/webhook_token<br />discord://avatar@webhook_id/webhook_token
 | [Faast](https://github.com/caronc/apprise/wiki/Notify_faast) | faast://    | (TCP) 443    | faast://authorizationtoken
 | [Growl](https://github.com/caronc/apprise/wiki/Notify_growl)  | growl://   | (UDP) 23053   | growl://hostname<br />growl://hostname:portno<br />growl://password@hostname<br />growl://password@hostname:port</br>_Note: you can also use the get parameter _version_ which can allow the growl request to behave using the older v1.x protocol. An example would look like: growl://hostname?version=1
 | [Join](https://github.com/caronc/apprise/wiki/Notify_join) | join://   | (TCP) 443    | join://apikey/device<br />join://apikey/device1/device2/deviceN/<br />join://apikey/group<br />join://apikey/groupA/groupB/groupN<br />join://apikey/DeviceA/groupA/groupN/DeviceN/
diff --git a/apprise/AppriseAsset.py b/apprise/AppriseAsset.py
index 691ca05d..5353357a 100644
--- a/apprise/AppriseAsset.py
+++ b/apprise/AppriseAsset.py
@@ -33,6 +33,15 @@ class AppriseAsset(object):
     URL masks.
 
     """
+    # Application Identifier
+    app_id = 'Apprise'
+
+    # Application Description
+    app_desc = 'Apprise Notifications'
+
+    # Provider URL
+    app_url = 'https://github.com/caronc/apprise'
+
     # A Simple Mapping of Colors; For every NOTIFY_TYPE identified,
     # there should be a mapping to it's color here:
     html_notify_map = {
@@ -52,6 +61,10 @@ class AppriseAsset(object):
     image_url_mask = \
         'http://nuxref.com/apprise/themes/{THEME}/apprise-{TYPE}-{XY}.png'
 
+    # Application Logo
+    image_url_logo = \
+        'http://nuxref.com/apprise/themes/{THEME}/apprise-logo.png'
+
     # Image Path Mask
     image_path_mask = abspath(join(
         dirname(__file__),
@@ -76,20 +89,48 @@ class AppriseAsset(object):
         if image_url_mask is not None:
             self.image_url_mask = image_url_mask
 
-    def html_color(self, notify_type):
+    def color(self, notify_type, color_type=None):
         """
         Returns an HTML mapped color based on passed in notify type
+
+        if color_type is:
+           None    then a standard hex string is returned as
+                   a string format ('#000000').
+
+           int     then the integer representation is returned
+           tuple   then the the red, green, blue is returned in a tuple
+
         """
+
         # Attempt to get the type, otherwise return a default grey
         # if we couldn't look up the entry
-        return self.html_notify_map.get(notify_type, self.default_html_color)
+        color = self.html_notify_map.get(notify_type, self.default_html_color)
+        if color_type is None:
+            # This is the default return type
+            return color
 
-    def image_url(self, notify_type, image_size):
+        elif color_type is int:
+            # Convert the color to integer
+            return AppriseAsset.hex_to_int(color)
+
+        # The only other type is tuple
+        elif color_type is tuple:
+            return AppriseAsset.hex_to_rgb(color)
+
+        # Unsupported type
+        raise ValueError(
+            'AppriseAsset html_color(): An invalid color_type was specified.')
+
+    def image_url(self, notify_type, image_size, logo=False):
         """
         Apply our mask to our image URL
 
+        if logo is set to True, then the logo_url is used instead
+
         """
-        if not self.image_url_mask:
+
+        url_mask = self.image_url_logo if logo else self.image_url_mask
+        if not url_mask:
             # No image to return
             return None
 
@@ -105,7 +146,7 @@ class AppriseAsset(object):
             re.IGNORECASE,
         )
 
-        return re_table.sub(lambda x: re_map[x.group()], self.image_url_mask)
+        return re_table.sub(lambda x: re_map[x.group()], url_mask)
 
     def image_path(self, notify_type, image_size, must_exist=True):
         """
@@ -154,3 +195,28 @@ class AppriseAsset(object):
                 return None
 
         return None
+
+    @staticmethod
+    def hex_to_rgb(value):
+        """
+        Takes a hex string (such as #00ff00) and returns a tuple in the form
+        of (red, green, blue)
+
+        eg: #00ff00 becomes : (0, 65535, 0)
+
+        """
+        value = value.lstrip('#')
+        lv = len(value)
+        return tuple(int(value[i:i + lv // 3], 16)
+                     for i in range(0, lv, lv // 3))
+
+    @staticmethod
+    def hex_to_int(value):
+        """
+        Takes a hex string (such as #00ff00) and returns its integer
+        equivalent
+
+        eg: #00000f becomes : 15
+
+        """
+        return int(value.lstrip('#'), 16)
diff --git a/apprise/assets/themes/default/apprise-logo.png b/apprise/assets/themes/default/apprise-logo.png
new file mode 100644
index 0000000000000000000000000000000000000000..44df0c7cd2957ce04aad18f5574c52bc11f034f7
GIT binary patch
literal 42935
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

literal 0
HcmV?d00001

diff --git a/apprise/plugins/NotifyBase.py b/apprise/plugins/NotifyBase.py
index cb62093a..a9ecf20d 100644
--- a/apprise/plugins/NotifyBase.py
+++ b/apprise/plugins/NotifyBase.py
@@ -95,12 +95,6 @@ class NotifyBase(object):
     # This value can be the same as the defined protocol.
     secure_protocol = ''
 
-    # our Application identifier
-    app_id = 'Apprise'
-
-    # our Application description
-    app_desc = 'Apprise Notifications'
-
     # Most Servers do not like more then 1 request per 5 seconds, so 5.5 gives
     # us a safe play range...
     throttle_attempt = 5.5
@@ -177,7 +171,7 @@ class NotifyBase(object):
 
         return
 
-    def image_url(self, notify_type):
+    def image_url(self, notify_type, logo=False):
         """
         Returns Image URL if possible
         """
@@ -191,6 +185,7 @@ class NotifyBase(object):
         return self.asset.image_url(
             notify_type=notify_type,
             image_size=self.image_size,
+            logo=logo,
         )
 
     def image_path(self, notify_type):
@@ -223,6 +218,30 @@ class NotifyBase(object):
             image_size=self.image_size,
         )
 
+    def color(self, notify_type, color_type=None):
+        """
+        Returns the html color (hex code) associated with the notify_type
+        """
+        if notify_type not in NOTIFY_TYPES:
+            return None
+
+        return self.asset.color(
+            notify_type=notify_type,
+            color_type=color_type,
+        )
+
+    @property
+    def app_id(self):
+        return self.asset.app_id
+
+    @property
+    def app_desc(self):
+        return self.asset.app_desc
+
+    @property
+    def app_url(self):
+        return self.asset.app_url
+
     @staticmethod
     def escape_html(html, convert_new_lines=False):
         """
diff --git a/apprise/plugins/NotifyDiscord.py b/apprise/plugins/NotifyDiscord.py
new file mode 100644
index 00000000..6022a920
--- /dev/null
+++ b/apprise/plugins/NotifyDiscord.py
@@ -0,0 +1,251 @@
+# -*- coding: utf-8 -*-
+#
+# Discord Notify Wrapper
+#
+# Copyright (C) 2018 Chris Caron <lead2gold@gmail.com>
+#
+# This file is part of apprise.
+#
+# This program is free software; you can redistribute it and/or modify it
+# under the terms of the GNU Lesser General Public License as published by
+# the Free Software Foundation; either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU Lesser General Public License for more details.
+
+# For this to work correctly you need to create a webhook. To do this just
+# click on the little gear icon next to the channel you're part of. From
+# here you'll be able to access the Webhooks menu and create a new one.
+#
+#  When you've completed, you'll get a URL that looks a little like this:
+#  https://discordapp.com/api/webhooks/417429632418316298/\
+#         JHZ7lQml277CDHmQKMHI8qBe7bk2ZwO5UKjCiOAF7711o33MyqU344Qpgv7YTpadV_js
+#
+#  Simplified, it looks like this:
+#     https://discordapp.com/api/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN
+#
+#  This plugin will simply work using the url of:
+#     discord://WEBHOOK_ID/WEBHOOK_TOKEN
+#
+# API Documentation on Webhooks:
+#    - https://discordapp.com/developers/docs/resources/webhook
+#
+import requests
+from json import dumps
+
+from .NotifyBase import NotifyBase
+from .NotifyBase import HTTP_ERROR_MAP
+from ..common import NotifyImageSize
+from ..utils import parse_bool
+
+# Image Support (256x256)
+DISCORD_IMAGE_XY = NotifyImageSize.XY_256
+
+
+class NotifyDiscord(NotifyBase):
+    """
+    A wrapper to Discord Notifications
+
+    """
+
+    # The default secure protocol
+    secure_protocol = 'discord'
+
+    # Discord Webhook
+    notify_url = 'https://discordapp.com/api/webhooks'
+
+    def __init__(self, webhook_id, webhook_token, tts=False, avatar=True,
+                 footer=False, thumbnail=True, **kwargs):
+        """
+        Initialize Discord Object
+
+        """
+        super(NotifyDiscord, self).__init__(
+            title_maxlen=250, body_maxlen=2000,
+            image_size=DISCORD_IMAGE_XY, **kwargs)
+
+        if not webhook_id:
+            raise TypeError(
+                'An invalid Client ID was specified.'
+            )
+
+        if not webhook_token:
+            raise TypeError(
+                'An invalid Webhook Token was specified.'
+            )
+
+        # Store our data
+        self.webhook_id = webhook_id
+        self.webhook_token = webhook_token
+
+        # Text To Speech
+        self.tts = tts
+
+        # Over-ride Avatar Icon
+        self.avatar = avatar
+
+        # Place a footer icon
+        self.footer = footer
+
+        # Place a thumbnail image inline with the message body
+        self.thumbnail = thumbnail
+
+        return
+
+    def notify(self, title, body, notify_type, **kwargs):
+        """
+        Perform Discord Notification
+        """
+
+        headers = {
+            'User-Agent': self.app_id,
+            'Content-Type': 'multipart/form-data',
+        }
+
+        # Prepare JSON Object
+        payload = {
+            # Text-To-Speech
+            'tts': self.tts,
+
+            # If Text-To-Speech is set to True, then we do not want to wait
+            # for the whole message before continuing. Otherwise, we wait
+            'wait': self.tts is False,
+
+            # Our color associated with our notification
+            'color': self.color(notify_type, int),
+
+            'embeds': [{
+                'provider': {
+                    'name': self.app_id,
+                    'url': self.app_url,
+                },
+                'title': title,
+                'type': 'rich',
+                'description': body,
+            }]
+        }
+
+        if self.footer:
+            logo_url = self.image_url(notify_type, logo=True)
+            payload['embeds'][0]['footer'] = {
+                'text': self.app_desc,
+            }
+            if logo_url:
+                payload['embeds'][0]['footer']['icon_url'] = logo_url
+
+        image_url = self.image_url(notify_type)
+        if image_url:
+            if self.thumbnail:
+                payload['embeds'][0]['thumbnail'] = {
+                    'url': image_url,
+                    'height': 256,
+                    'width': 256,
+                }
+
+            if self.avatar:
+                payload['avatar_url'] = image_url
+
+        if self.user:
+            # Optionally override the default username of the webhook
+            payload['username'] = self.user
+
+        # Construct Notify URL
+        notify_url = '{0}/{1}/{2}'.format(
+            self.notify_url,
+            self.webhook_id,
+            self.webhook_token,
+        )
+
+        self.logger.debug('Discord POST URL: %s (cert_verify=%r)' % (
+            notify_url, self.verify_certificate,
+        ))
+        self.logger.debug('Discord Payload: %s' % str(payload))
+        try:
+            r = requests.post(
+                notify_url,
+                data=dumps(payload),
+                headers=headers,
+                verify=self.verify_certificate,
+            )
+            if r.status_code not in (
+                    requests.codes.ok, requests.codes.no_content):
+                # We had a problem
+                try:
+                    self.logger.warning(
+                        'Failed to send Discord notification: '
+                        '%s (error=%s).' % (
+                            HTTP_ERROR_MAP[r.status_code],
+                            r.status_code))
+
+                except KeyError:
+                    self.logger.warning(
+                        'Failed to send Discord notification '
+                        '(error=%s).' % r.status_code)
+
+                self.logger.debug('Response Details: %s' % r.raw.read())
+
+                # Return; we're done
+                return False
+
+            else:
+                self.logger.info('Sent Discord notification.')
+
+        except requests.RequestException as e:
+            self.logger.warning(
+                'A Connection error occured sending Discord '
+                'notification.'
+            )
+            self.logger.debug('Socket Exception: %s' % str(e))
+            return False
+
+        return True
+
+    @staticmethod
+    def parse_url(url):
+        """
+        Parses the URL and returns enough arguments that can allow
+        us to substantiate this object.
+
+        Syntax:
+          discord://webhook_id/webhook_token
+
+        """
+        results = NotifyBase.parse_url(url)
+
+        if not results:
+            # We're done early as we couldn't load the results
+            return results
+
+        # Store our webhook ID
+        webhook_id = results['host']
+
+        # Now fetch our tokens
+        try:
+            webhook_token = [x for x in filter(bool, NotifyBase.split_path(
+                results['fullpath']))][0]
+
+        except (ValueError, AttributeError, IndexError):
+            # Force some bad values that will get caught
+            # in parsing later
+            webhook_token = None
+
+        results['webhook_id'] = webhook_id
+        results['webhook_token'] = webhook_token
+
+        # Text To Speech
+        results['tts'] = parse_bool(results['qsd'].get('tts', False))
+
+        # Use Footer
+        results['footer'] = parse_bool(results['qsd'].get('footer', False))
+
+        # Update Avatar Icon
+        results['avatar'] = parse_bool(results['qsd'].get('avatar', True))
+
+        # Use Thumbnail
+        results['thumbnail'] = \
+            parse_bool(results['qsd'].get('thumbnail', True))
+
+        return results
diff --git a/apprise/plugins/NotifySlack.py b/apprise/plugins/NotifySlack.py
index f8781232..802ea734 100644
--- a/apprise/plugins/NotifySlack.py
+++ b/apprise/plugins/NotifySlack.py
@@ -220,7 +220,7 @@ class NotifySlack(NotifyBase):
                 'attachments': [{
                     'title': title,
                     'text': body,
-                    'color': self.asset.html_color(notify_type),
+                    'color': self.color(notify_type),
                     # Time
                     'ts': time(),
                     'footer': self.app_id,
diff --git a/apprise/plugins/__init__.py b/apprise/plugins/__init__.py
index b0213a56..19699182 100644
--- a/apprise/plugins/__init__.py
+++ b/apprise/plugins/__init__.py
@@ -21,6 +21,7 @@
 from . import NotifyEmail as NotifyEmailBase
 
 from .NotifyBoxcar import NotifyBoxcar
+from .NotifyDiscord import NotifyDiscord
 from .NotifyEmail import NotifyEmail
 from .NotifyFaast import NotifyFaast
 from .NotifyGrowl.NotifyGrowl import NotifyGrowl
@@ -55,7 +56,7 @@ __all__ = [
     'NotifyMyAndroid', 'NotifyProwl', 'NotifyPushalot', 'NotifyPushBullet',
     'NotifyPushover', 'NotifyRocketChat', 'NotifyToasty', 'NotifyTwitter',
     'NotifyXBMC', 'NotifyXML', 'NotifySlack', 'NotifyJoin', 'NotifyTelegram',
-    'NotifyMatterMost', 'NotifyPushjet',
+    'NotifyMatterMost', 'NotifyPushjet', 'NotifyDiscord',
 
     # Reference
     'NotifyImageSize', 'NOTIFY_IMAGE_SIZES', 'NotifyType', 'NOTIFY_TYPES',
diff --git a/test/test_api.py b/test/test_api.py
index 0238b654..bbaa6a53 100644
--- a/test/test_api.py
+++ b/test/test_api.py
@@ -298,8 +298,30 @@ def test_apprise_asset(tmpdir):
     a.default_html_color = '#abcabc'
     a.html_notify_map[NotifyType.INFO] = '#aaaaaa'
 
-    assert(a.html_color('invalid') == '#abcabc')
-    assert(a.html_color(NotifyType.INFO) == '#aaaaaa')
+    assert(a.color('invalid', tuple) == (171, 202, 188))
+    assert(a.color(NotifyType.INFO, tuple) == (170, 170, 170))
+
+    assert(a.color('invalid', int) == 11258556)
+    assert(a.color(NotifyType.INFO, int) == 11184810)
+
+    assert(a.color('invalid', None) == '#abcabc')
+    assert(a.color(NotifyType.INFO, None) == '#aaaaaa')
+    # None is the default
+    assert(a.color(NotifyType.INFO) == '#aaaaaa')
+
+    # Invalid Type
+    try:
+        a.color(NotifyType.INFO, dict)
+        # We should not get here (exception should be thrown)
+        assert(False)
+
+    except ValueError:
+        # The exception we expect since dict is not supported
+        assert(True)
+
+    except:
+        # Any other exception is not good
+        assert(False)
 
     assert(a.image_url(NotifyType.INFO, NotifyImageSize.XY_256) ==
            'http://localhost/dark/info-256x256.png')
diff --git a/test/test_notify_base.py b/test/test_notify_base.py
index f4af0a19..8d0bb709 100644
--- a/test/test_notify_base.py
+++ b/test/test_notify_base.py
@@ -20,6 +20,7 @@ from apprise.plugins.NotifyBase import NotifyBase
 from apprise import NotifyType
 from apprise import NotifyImageSize
 from timeit import default_timer
+from apprise.utils import compat_is_basestring
 
 
 def test_notify_base():
@@ -75,6 +76,15 @@ def test_notify_base():
     assert nb.image_path(notify_type=NotifyType.INFO) is None
     assert nb.image_raw(notify_type=NotifyType.INFO) is None
 
+    # Color handling
+    assert nb.color(notify_type='invalid') is None
+    assert compat_is_basestring(
+        nb.color(notify_type=NotifyType.INFO, color_type=None))
+    assert isinstance(
+        nb.color(notify_type=NotifyType.INFO, color_type=int), int)
+    assert isinstance(
+        nb.color(notify_type=NotifyType.INFO, color_type=tuple), tuple)
+
     # Create an object with an ImageSize loaded into it
     nb = NotifyBase(image_size=NotifyImageSize.XY_256)
 
diff --git a/test/test_rest_plugins.py b/test/test_rest_plugins.py
index d11ee2a5..2ed184ca 100644
--- a/test/test_rest_plugins.py
+++ b/test/test_rest_plugins.py
@@ -87,6 +87,65 @@ TEST_URLS = (
         'test_requests_exceptions': True,
     }),
 
+    ##################################
+    # NotifyDiscord
+    ##################################
+    ('discord://', {
+        'instance': None,
+    }),
+    # No webhook_token specified
+    ('discord://%s' % ('i' * 24), {
+        'instance': TypeError,
+    }),
+    # Provide both an webhook id and a webhook token
+    ('discord://%s/%s' % ('i' * 24, 't' * 64), {
+        'instance': plugins.NotifyDiscord,
+        'requests_response_code': requests.codes.no_content,
+    }),
+    # Provide a temporary username
+    ('discord://l2g@%s/%s' % ('i' * 24, 't' * 64), {
+        'instance': plugins.NotifyDiscord,
+        'requests_response_code': requests.codes.no_content,
+    }),
+    # Enable other options
+    ('discord://%s/%s?footer=Yes&thumbnail=Yes' % ('i' * 24, 't' * 64), {
+        'instance': plugins.NotifyDiscord,
+        'requests_response_code': requests.codes.no_content,
+    }),
+    ('discord://%s/%s?avatar=No&footer=No' % ('i' * 24, 't' * 64), {
+        'instance': plugins.NotifyDiscord,
+        'requests_response_code': requests.codes.no_content,
+    }),
+    # Test without image set
+    ('discord://%s/%s' % ('i' * 24, 't' * 64), {
+        'instance': plugins.NotifyDiscord,
+        'requests_response_code': requests.codes.no_content,
+        # don't include an image by default
+        'include_image': False,
+    }),
+    # An invalid url
+    ('discord://:@/', {
+        'instance': None,
+    }),
+    ('discord://%s/%s/' % ('a' * 24, 'b' * 64), {
+        'instance': plugins.NotifyDiscord,
+        # force a failure
+        'response': False,
+        'requests_response_code': requests.codes.internal_server_error,
+    }),
+    ('discord://%s/%s/' % ('a' * 24, 'b' * 64), {
+        'instance': plugins.NotifyDiscord,
+        # throw a bizzare code forcing us to fail to look it up
+        'response': False,
+        'requests_response_code': 999,
+    }),
+    ('discord://%s/%s/' % ('a' * 24, 'b' * 64), {
+        'instance': plugins.NotifyDiscord,
+        # Throws a series of connection and transfer exceptions when this flag
+        # is set and tests that we gracfully handle them
+        'test_requests_exceptions': True,
+    }),
+
     ##################################
     # NotifyFaast
     ##################################
@@ -1384,6 +1443,51 @@ def test_notify_boxcar_plugin(mock_post, mock_get):
     p.notify(body=None, title=None, notify_type=NotifyType.INFO) is True
 
 
+@mock.patch('requests.get')
+@mock.patch('requests.post')
+def test_notify_discord_plugin(mock_post, mock_get):
+    """
+    API: NotifyDiscord() Extra Checks
+
+    """
+
+    # Initialize some generic (but valid) tokens
+    webhook_id = 'A' * 24
+    webhook_token = 'B' * 64
+
+    # Prepare Mock
+    mock_get.return_value = requests.Request()
+    mock_post.return_value = requests.Request()
+    mock_post.return_value.status_code = requests.codes.ok
+    mock_get.return_value.status_code = requests.codes.ok
+
+    # Empty Channel list
+    try:
+        plugins.NotifyDiscord(webhook_id=None, webhook_token=webhook_token)
+        assert(False)
+
+    except TypeError:
+        # we'll thrown because no webhook_id was specified
+        assert(True)
+
+    obj = plugins.NotifyDiscord(
+        webhook_id=webhook_id,
+        webhook_token=webhook_token,
+        footer=True, thumbnail=False)
+
+    # Disable throttling to speed up unit tests
+    obj.throttle_attempt = 0
+
+    # This call includes an image with it's payload:
+    assert obj.notify(title='title', body='body',
+                      notify_type=NotifyType.INFO) is True
+
+    # Toggle our logo availability
+    obj.asset.image_url_logo = None
+    assert obj.notify(title='title', body='body',
+                      notify_type=NotifyType.INFO) is True
+
+
 @mock.patch('requests.get')
 @mock.patch('requests.post')
 def test_notify_join_plugin(mock_post, mock_get):