-
-
Notifications
You must be signed in to change notification settings - Fork 421
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
5 changed files
with
282 additions
and
9 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,88 @@ | ||
| # -*- coding: utf-8 -*- | ||
| # | ||
| # Copyright (C) 2019 Chris Caron <[email protected]> | ||
| # All rights reserved. | ||
| # | ||
| # This code is licensed under the MIT License. | ||
| # | ||
| # Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| # of this software and associated documentation files(the "Software"), to deal | ||
| # in the Software without restriction, including without limitation the rights | ||
| # to use, copy, modify, merge, publish, distribute, sublicense, and / or sell | ||
| # copies of the Software, and to permit persons to whom the Software is | ||
| # furnished to do so, subject to the following conditions : | ||
| # | ||
| # The above copyright notice and this permission notice shall be included in | ||
| # all copies or substantial portions of the Software. | ||
| # | ||
| # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE | ||
| # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | ||
| # THE SOFTWARE. | ||
|
|
||
| # 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://media.guilded.gg/webhooks/417429632418316298/\ | ||
| # JHZ7lQml277CDHmQKMHI8qBe7bk2ZwO5UKjCiOAF7711o33MyqU344Qpgv7YTpadV_js | ||
| # | ||
| # Simplified, it looks like this: | ||
| # https://media.guilded.gg/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN | ||
| # | ||
| # This plugin will simply work using the url of: | ||
| # guilded://WEBHOOK_ID/WEBHOOK_TOKEN | ||
| # | ||
| # API Documentation on Webhooks: | ||
| # - https://discord.com/developers/docs/resources/webhook | ||
| # | ||
|
|
||
| import re | ||
| from .NotifyDiscord import NotifyDiscord | ||
|
|
||
|
|
||
| class NotifyGuilded(NotifyDiscord): | ||
| """ | ||
| A wrapper to Guilded Notifications | ||
| """ | ||
|
|
||
| # The default descriptive name associated with the Notification | ||
| service_name = 'Guilded' | ||
|
|
||
| # The services URL | ||
| service_url = 'https://guilded.gg/' | ||
|
|
||
| # The default secure protocol | ||
| secure_protocol = 'guilded' | ||
|
|
||
| # Guilded Webhook | ||
| notify_url = 'https://media.guilded.gg/webhooks' | ||
|
|
||
| @staticmethod | ||
| def parse_native_url(url): | ||
| """ | ||
| Support https://media.guilded.gg/webhooks/WEBHOOK_ID/WEBHOOK_TOKEN | ||
| """ | ||
|
|
||
| result = re.match( | ||
| r'^https?://(media\.)?guilded\.gg/webhooks/' | ||
| # a UUID, but we do we really need to be _that_ picky? | ||
| r'(?P<webhook_id>[-0-9a-f]+)/' | ||
| r'(?P<webhook_token>[A-Z0-9_-]+)/?' | ||
| r'(?P<params>\?.+)?$', url, re.I) | ||
|
|
||
| if result: | ||
| return NotifyGuilded.parse_url( | ||
| '{schema}://{webhook_id}/{webhook_token}/{params}'.format( | ||
| schema=NotifyGuilded.secure_protocol, | ||
| webhook_id=result.group('webhook_id'), | ||
| webhook_token=result.group('webhook_token'), | ||
| params='' if not result.group('params') | ||
| else result.group('params'))) | ||
|
|
||
| return None |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
|
|
@@ -71,14 +71,14 @@ | |
| url='https://github.com/caronc/apprise', | ||
| keywords='Push Notifications Alerts Email AWS SES SNS Boxcar ClickSend ' | ||
| 'DAPNET Dingtalk Discord Dbus Emby Faast FCM Flock Gitter Gnome ' | ||
| 'Google Chat Gotify Growl Home Assistant IFTTT Join Kavenegar KODI ' | ||
| 'Kumulos LaMetric MacOS Mailgun Matrix Mattermost MessageBird MQTT ' | ||
| 'MSG91 Nexmo Nextcloud NextcloudTalk Notica Notifico Ntfy Office365 ' | ||
| 'OneSignal Opsgenie ParsePlatform PopcornNotify Prowl PushBullet ' | ||
| 'Pushjet Pushed Pushover PushSafer Reddit Rocket.Chat Ryver SendGrid ' | ||
| 'ServerChan Signal SimplePush Sinch Slack SMTP2Go SparkPost Spontit ' | ||
| 'Streamlabs Stride Syslog Techulus Telegram Twilio Twist Twitter XBMC ' | ||
| 'MSTeams Microsoft Windows Webex CLI API', | ||
| 'Google Chat Gotify Growl Guilded Home Assistant IFTTT Join Kavenegar ' | ||
| 'KODI Kumulos LaMetric MacOS Mailgun Matrix Mattermost MessageBird ' | ||
| 'MQTT MSG91 Nexmo Nextcloud NextcloudTalk Notica Notifico Ntfy ' | ||
| 'Office365 OneSignal Opsgenie ParsePlatform PopcornNotify Prowl ' | ||
| 'PushBullet Pushjet Pushed Pushover PushSafer Reddit Rocket.Chat ' | ||
| 'Ryver SendGrid ServerChan Signal SimplePush Sinch Slack SMTP2Go ' | ||
| 'SparkPost Spontit Streamlabs Stride Syslog Techulus Telegram Twilio ' | ||
| 'Twist Twitter XBMC MSTeams Microsoft Windows Webex CLI API', | ||
| author='Chris Caron', | ||
| author_email='[email protected]', | ||
| packages=find_packages(), | ||
|
|
||
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,184 @@ | ||
| # -*- coding: utf-8 -*- | ||
| # | ||
| # Copyright (C) 2020 Chris Caron <[email protected]> | ||
| # All rights reserved. | ||
| # | ||
| # This code is licensed under the MIT License. | ||
| # | ||
| # Permission is hereby granted, free of charge, to any person obtaining a copy | ||
| # of this software and associated documentation files(the "Software"), to deal | ||
| # in the Software without restriction, including without limitation the rights | ||
| # to use, copy, modify, merge, publish, distribute, sublicense, and / or sell | ||
| # copies of the Software, and to permit persons to whom the Software is | ||
| # furnished to do so, subject to the following conditions : | ||
| # | ||
| # The above copyright notice and this permission notice shall be included in | ||
| # all copies or substantial portions of the Software. | ||
| # | ||
| # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR | ||
| # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, | ||
| # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE | ||
| # AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER | ||
| # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, | ||
| # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN | ||
| # THE SOFTWARE. | ||
|
|
||
| import os | ||
| import six | ||
| import mock | ||
| import pytest | ||
| import requests | ||
| from helpers import AppriseURLTester | ||
| from apprise import plugins | ||
|
|
||
| # Disable logging for a cleaner testing output | ||
| import logging | ||
| logging.disable(logging.CRITICAL) | ||
|
|
||
| # Attachment Directory | ||
| TEST_VAR_DIR = os.path.join(os.path.dirname(__file__), 'var') | ||
|
|
||
| # Our Testing URLs | ||
| apprise_url_tests = ( | ||
| ('guilded://', { | ||
| 'instance': TypeError, | ||
| }), | ||
| # An invalid url | ||
| ('guilded://:@/', { | ||
| 'instance': TypeError, | ||
| }), | ||
| # No webhook_token specified | ||
| ('guilded://%s' % ('i' * 24), { | ||
| 'instance': TypeError, | ||
| }), | ||
| # Provide both an webhook id and a webhook token | ||
| ('guilded://%s/%s' % ('i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| # Provide a temporary username | ||
| ('guilded://l2g@%s/%s' % ('i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| # test image= field | ||
| ('guilded://%s/%s?format=markdown&footer=Yes&image=Yes' % ( | ||
| 'i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| # don't include an image by default | ||
| 'include_image': False, | ||
| }), | ||
| ('guilded://%s/%s?format=markdown&footer=Yes&image=No&fields=no' % ( | ||
| 'i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| ('guilded://%s/%s?format=markdown&footer=Yes&image=Yes' % ( | ||
| 'i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| ('https://media.guilded.gg/webhooks/{}/{}'.format( | ||
| '0' * 10, 'B' * 40), { | ||
| # Native URL Support, support the provided guilded URL from their | ||
| # webpage. | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| ('guilded://%s/%s?format=markdown&avatar=No&footer=No' % ( | ||
| 'i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| # different format support | ||
| ('guilded://%s/%s?format=markdown' % ('i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| ('guilded://%s/%s?format=text' % ('i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| # Test with avatar URL | ||
| ('guilded://%s/%s?avatar_url=http://localhost/test.jpg' % ( | ||
| 'i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| }), | ||
| # Test without image set | ||
| ('guilded://%s/%s' % ('i' * 24, 't' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| 'requests_response_code': requests.codes.no_content, | ||
| # don't include an image by default | ||
| 'include_image': False, | ||
| }), | ||
| ('guilded://%s/%s/' % ('a' * 24, 'b' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| # force a failure | ||
| 'response': False, | ||
| 'requests_response_code': requests.codes.internal_server_error, | ||
| }), | ||
| ('guilded://%s/%s/' % ('a' * 24, 'b' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| # throw a bizzare code forcing us to fail to look it up | ||
| 'response': False, | ||
| 'requests_response_code': 999, | ||
| }), | ||
| ('guilded://%s/%s/' % ('a' * 24, 'b' * 64), { | ||
| 'instance': plugins.NotifyGuilded, | ||
| # Throws a series of connection and transfer exceptions when this flag | ||
| # is set and tests that we gracfully handle them | ||
| 'test_requests_exceptions': True, | ||
| }), | ||
| ) | ||
|
|
||
|
|
||
| def test_plugin_guilded_urls(): | ||
| """ | ||
| NotifyGuilded() Apprise URLs | ||
| """ | ||
|
|
||
| # Run our general tests | ||
| AppriseURLTester(tests=apprise_url_tests).run_all() | ||
|
|
||
|
|
||
| @mock.patch('requests.post') | ||
| def test_plugin_guilded_general(mock_post): | ||
| """ | ||
| NotifyGuilded() General Checks | ||
| """ | ||
| # Disable Throttling to speed testing | ||
| plugins.NotifyBase.request_rate_per_sec = 0 | ||
|
|
||
| # Initialize some generic (but valid) tokens | ||
| webhook_id = 'A' * 24 | ||
| webhook_token = 'B' * 64 | ||
|
|
||
| # Prepare Mock | ||
| mock_post.return_value = requests.Request() | ||
| mock_post.return_value.status_code = requests.codes.ok | ||
|
|
||
| # Invalid webhook id | ||
| with pytest.raises(TypeError): | ||
| plugins.NotifyGuilded(webhook_id=None, webhook_token=webhook_token) | ||
| # Invalid webhook id (whitespace) | ||
| with pytest.raises(TypeError): | ||
| plugins.NotifyGuilded(webhook_id=" ", webhook_token=webhook_token) | ||
|
|
||
| # Invalid webhook token | ||
| with pytest.raises(TypeError): | ||
| plugins.NotifyGuilded(webhook_id=webhook_id, webhook_token=None) | ||
| # Invalid webhook token (whitespace) | ||
| with pytest.raises(TypeError): | ||
| plugins.NotifyGuilded(webhook_id=webhook_id, webhook_token=" ") | ||
|
|
||
| obj = plugins.NotifyGuilded( | ||
| webhook_id=webhook_id, | ||
| webhook_token=webhook_token, | ||
| footer=True, thumbnail=False) | ||
|
|
||
| # Test that we get a string response | ||
| assert isinstance(obj.url(), six.string_types) is True |