2018-09-17 00:27:00 +00:00
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
#
|
2019-06-07 11:16:07 +00:00
|
|
|
# Copyright (C) 2019 Chris Caron <lead2gold@gmail.com>
|
|
|
|
# All rights reserved.
|
2018-09-17 00:27:00 +00:00
|
|
|
#
|
2019-06-07 11:16:07 +00:00
|
|
|
# This code is licensed under the MIT License.
|
2018-09-17 00:27:00 +00:00
|
|
|
#
|
2019-06-07 11:16:07 +00:00
|
|
|
# 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 :
|
2018-09-17 00:27:00 +00:00
|
|
|
#
|
2019-06-07 11:16:07 +00:00
|
|
|
# The above copyright notice and this permission notice shall be included in
|
|
|
|
# all copies or substantial portions of the Software.
|
2018-09-17 00:27:00 +00:00
|
|
|
#
|
2019-06-07 11:16:07 +00:00
|
|
|
# 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.
|
2018-09-17 00:27:00 +00:00
|
|
|
|
|
|
|
|
|
|
|
class NotifyType(object):
|
|
|
|
"""
|
|
|
|
A simple mapping of notification types most commonly used with
|
|
|
|
all types of logging and notification services.
|
|
|
|
"""
|
|
|
|
INFO = 'info'
|
|
|
|
SUCCESS = 'success'
|
|
|
|
WARNING = 'warning'
|
2020-09-14 12:24:26 +00:00
|
|
|
FAILURE = 'failure'
|
2018-09-17 00:27:00 +00:00
|
|
|
|
|
|
|
|
|
|
|
NOTIFY_TYPES = (
|
|
|
|
NotifyType.INFO,
|
|
|
|
NotifyType.SUCCESS,
|
|
|
|
NotifyType.WARNING,
|
2020-09-14 12:24:26 +00:00
|
|
|
NotifyType.FAILURE,
|
2018-09-17 00:27:00 +00:00
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
class NotifyImageSize(object):
|
|
|
|
"""
|
|
|
|
A list of pre-defined image sizes to make it easier to work with defined
|
|
|
|
plugins.
|
|
|
|
"""
|
|
|
|
XY_32 = '32x32'
|
|
|
|
XY_72 = '72x72'
|
|
|
|
XY_128 = '128x128'
|
|
|
|
XY_256 = '256x256'
|
|
|
|
|
|
|
|
|
|
|
|
NOTIFY_IMAGE_SIZES = (
|
|
|
|
NotifyImageSize.XY_32,
|
|
|
|
NotifyImageSize.XY_72,
|
|
|
|
NotifyImageSize.XY_128,
|
|
|
|
NotifyImageSize.XY_256,
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
class NotifyFormat(object):
|
|
|
|
"""
|
|
|
|
A list of pre-defined text message formats that can be passed via the
|
|
|
|
apprise library.
|
|
|
|
"""
|
|
|
|
TEXT = 'text'
|
|
|
|
HTML = 'html'
|
|
|
|
MARKDOWN = 'markdown'
|
|
|
|
|
|
|
|
|
|
|
|
NOTIFY_FORMATS = (
|
|
|
|
NotifyFormat.TEXT,
|
|
|
|
NotifyFormat.HTML,
|
|
|
|
NotifyFormat.MARKDOWN,
|
|
|
|
)
|
2019-06-07 11:16:07 +00:00
|
|
|
|
|
|
|
|
|
|
|
class OverflowMode(object):
|
|
|
|
"""
|
|
|
|
A list of pre-defined modes of how to handle the text when it exceeds the
|
|
|
|
defined maximum message size.
|
|
|
|
"""
|
|
|
|
|
|
|
|
# Send the data as is; untouched. Let the upstream server decide how the
|
|
|
|
# content is handled. Some upstream services might gracefully handle this
|
|
|
|
# with expected intentions; others might not.
|
|
|
|
UPSTREAM = 'upstream'
|
|
|
|
|
|
|
|
# Always truncate the text when it exceeds the maximum message size and
|
|
|
|
# send it anyway
|
|
|
|
TRUNCATE = 'truncate'
|
|
|
|
|
|
|
|
# Split the message into multiple smaller messages that fit within the
|
|
|
|
# limits of what is expected. The smaller messages are sent
|
|
|
|
SPLIT = 'split'
|
|
|
|
|
|
|
|
|
|
|
|
# Define our modes so we can verify if we need to
|
|
|
|
OVERFLOW_MODES = (
|
|
|
|
OverflowMode.UPSTREAM,
|
|
|
|
OverflowMode.TRUNCATE,
|
|
|
|
OverflowMode.SPLIT,
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
class ConfigFormat(object):
|
|
|
|
"""
|
|
|
|
A list of pre-defined config formats that can be passed via the
|
|
|
|
apprise library.
|
|
|
|
"""
|
|
|
|
|
|
|
|
# A text based configuration. This consists of a list of URLs delimited by
|
|
|
|
# a new line. pound/hashtag (#) or semi-colon (;) can be used as comment
|
|
|
|
# characters.
|
|
|
|
TEXT = 'text'
|
|
|
|
|
|
|
|
# YAML files allow a more rich of an experience when settig up your
|
|
|
|
# apprise configuration files.
|
|
|
|
YAML = 'yaml'
|
|
|
|
|
|
|
|
|
|
|
|
# Define our configuration formats mostly used for verification
|
|
|
|
CONFIG_FORMATS = (
|
|
|
|
ConfigFormat.TEXT,
|
|
|
|
ConfigFormat.YAML,
|
|
|
|
)
|
2019-11-25 01:15:30 +00:00
|
|
|
|
2020-09-14 12:24:26 +00:00
|
|
|
|
2021-12-02 02:19:18 +00:00
|
|
|
class ContentIncludeMode(object):
|
2020-09-14 12:24:26 +00:00
|
|
|
"""
|
2021-12-02 02:19:18 +00:00
|
|
|
The different Content inclusion modes. All content based plugins will
|
|
|
|
have one of these associated with it.
|
2020-09-14 12:24:26 +00:00
|
|
|
"""
|
2021-12-02 02:19:18 +00:00
|
|
|
# - Content inclusion of same type only; hence a file:// can include
|
2020-09-14 12:24:26 +00:00
|
|
|
# a file://
|
|
|
|
# - Cross file inclusion is not allowed unless insecure_includes (a flag)
|
|
|
|
# is set to True. In these cases STRICT acts as type ALWAYS
|
|
|
|
STRICT = 'strict'
|
|
|
|
|
2021-12-02 02:19:18 +00:00
|
|
|
# This content type can never be included
|
2020-09-14 12:24:26 +00:00
|
|
|
NEVER = 'never'
|
|
|
|
|
2021-12-02 02:19:18 +00:00
|
|
|
# This content can always be included
|
2020-09-14 12:24:26 +00:00
|
|
|
ALWAYS = 'always'
|
|
|
|
|
|
|
|
|
2021-12-02 02:19:18 +00:00
|
|
|
CONTENT_INCLUDE_MODES = (
|
|
|
|
ContentIncludeMode.STRICT,
|
|
|
|
ContentIncludeMode.NEVER,
|
|
|
|
ContentIncludeMode.ALWAYS,
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
class ContentLocation(object):
|
|
|
|
"""
|
|
|
|
This is primarily used for handling file attachments. The idea is
|
|
|
|
to track the source of the attachment itself. We don't want
|
|
|
|
remote calls to a server to access local attachments for example.
|
|
|
|
|
|
|
|
By knowing the attachment type and cross-associating it with how
|
|
|
|
we plan on accessing the content, we can make a judgement call
|
|
|
|
(for security reasons) if we will allow it.
|
|
|
|
|
|
|
|
Obviously local uses of apprise can access both local and remote
|
|
|
|
type files.
|
|
|
|
"""
|
|
|
|
# Content is located locally (on the same server as apprise)
|
|
|
|
LOCAL = 'local'
|
|
|
|
|
|
|
|
# Content is located in a remote location
|
|
|
|
HOSTED = 'hosted'
|
|
|
|
|
|
|
|
# Content is inaccessible
|
|
|
|
INACCESSIBLE = 'n/a'
|
|
|
|
|
|
|
|
|
|
|
|
CONTENT_LOCATIONS = (
|
|
|
|
ContentLocation.LOCAL,
|
|
|
|
ContentLocation.HOSTED,
|
|
|
|
ContentLocation.INACCESSIBLE,
|
2020-09-14 12:24:26 +00:00
|
|
|
)
|
|
|
|
|
2019-11-25 01:15:30 +00:00
|
|
|
# This is a reserved tag that is automatically assigned to every
|
|
|
|
# Notification Plugin
|
|
|
|
MATCH_ALL_TAG = 'all'
|
2022-05-08 13:50:49 +00:00
|
|
|
|
|
|
|
# Will cause notification to trigger under any circumstance even if an
|
|
|
|
# exclusive tagging was provided.
|
|
|
|
MATCH_ALWAYS_TAG = 'always'
|