add support for apprise

fix apprise config schema
remove apprise from required dependencies

@@ -1309,0 +1319,4 @@
+                    List of Apprise service URLs to publish to.
+                example:
+                    - "mastodon://accesskey/host/?visibility=direct"
+                    - "pagerduty://A1BRTD4JD@TIiajkdnlazkcOXrIdevi7F/node01.local/drive_sda/"

@@ -1309,0 +1332,4 @@
+                        type: string
+                        description: |
+                            Specify the message body.
+                        exampe: Your backups have failed.

@@ -1309,0 +1336,4 @@
+                    notification_type:
+                        type: string
+                        description: |
+                            The Apprise message type.

@@ -1309,0 +1356,4 @@
+                        type: string
+                        description: |
+                            Specify the message body.
+                        exampe: Your backups have failed.

@@ -1309,0 +1380,4 @@
+                        type: string
+                        description: |
+                            Specify the message body.
+                        exampe: Your backups have failed.

@@ -0,0 +19,4 @@
+    '''
+    Ping the configured Apprise service URLs.
+    Use the given configuration filename in any log entries.
+    If this is a dry run, then don't actually ping anything.

@@ -0,0 +36,4 @@
+    )
+
+    # TODO: Currently not very meaningful message.
+    # However, the Apprise service URLs can contain sensitive info.

@@ -0,0 +39,4 @@
+    # However, the Apprise service URLs can contain sensitive info.
+    dry_run_label = ' (dry run; not actually pinging)' if dry_run else ''
+    logger.info(f'{config_filename}: Pinging Apprise {dry_run_label}')
+    logger.debug(f'{config_filename}: Using Apprise ping')

@@ -0,0 +45,4 @@
+    body = state_config.get('body')
+    notify_type = state_config.get('notification_type', 'success')
+
+    apobj = apprise.Apprise()

@@ -0,0 +55,4 @@
+        title=title,
+        body=body,
+        body_format=NotifyFormat.TEXT,
+        notify_type=get_notify_type(notify_type)

@@ -0,0 +62,4 @@
+        logger.warning(f'{config_filename}: error sending some apprise notifications')
+
+
+def get_notify_type(s):

@@ -0,0 +70,4 @@
+    if s == 'warning':
+        return NotifyType.WARNING
+    if s == 'failure':
+        return NotifyType.FAILURE

@@ -0,0 +81,4 @@
+    if state == 'fail':
+        return NotifyType.FAILURE
+    if state == 'log':
+        return NotifyType.INFO

@@ -35,6 +35,7 @@ setup(
         'requests',
         'ruamel.yaml>0.15.0,<0.18.0',
         'setuptools',
+        'apprise'

@@ -1309,0 +1341,4 @@
+                    title:
+                        type: string
+                        description: |
+                            Specify the message title.

@@ -0,0 +49,4 @@
+        return
+
+    dry_run_string = ' (dry run; not actually pinging)' if dry_run else ''
+    labels_string = ', '.join(map(lambda service: service['label'], hook_config.get('services')))

@@ -0,0 +54,4 @@
+
+    title = state_config.get('title', '')
+    body = state_config.get('body')
+    notify_type = state_to_notify_type[state.name.lower()]

@@ -0,0 +57,4 @@
+    notify_type = state_to_notify_type[state.name.lower()]
+
+    apprise_object = apprise.Apprise()
+    apprise_object.add(list(map(lambda service: service['url'], hook_config.get('services'))))

@@ -0,0 +66,4 @@
+        title=title,
+        body=body,
+        body_format=NotifyFormat.TEXT,
+        notify_type=notify_type)

@@ -0,0 +68,4 @@
+        body_format=NotifyFormat.TEXT,
+        notify_type=notify_type)
+
+    if result is False:

@@ -0,0 +69,4 @@
+        notify_type=notify_type)
+
+    if result is False:
+        logger.warning(f'{config_filename}: error sending some apprise notifications')

@@ -33,1 +33,4 @@
 zipp==3.15.0; python_version < '3.8'
+certifi==2022.9.24
+PyYAML==6.0
+Markdown==3.4.1

@@ -0,0 +3,4 @@
+from flexmock import flexmock
+
+import borgmatic.hooks.monitor
+from borgmatic.hooks import apprise as module

@@ -0,0 +5,4 @@
+import borgmatic.hooks.monitor
+from borgmatic.hooks import apprise as module
+
+topic = 'borgmatic-unit-testing'

@@ -0,0 +9,4 @@
+
+
+def test_ping_monitor_adheres_dry_run():
+    flexmock(apprise.Apprise).should_receive('notify').never()

@@ -0,0 +34,4 @@
+    )
+
+
+def test_ping_monitor_hits_fail_by_default():

@@ -0,0 +120,4 @@
+    )
+
+
+def test_ping_monitor_with_custom_message_title():