From e31bac63d7e7871c0b3dc8a67cd559132fe8f89f Mon Sep 17 00:00:00 2001
From: Chris Caron
Date: Tue, 17 Dec 2024 20:37:08 -0500
Subject: [PATCH] bumped version to v1.9.1
---
apprise/__init__.py | 2 +-
apprise/i18n/apprise.pot | 32 +++++++++++++++-------
packaging/man/apprise.1 | 20 ++++++++++++--
packaging/man/apprise.1.html | 40 ++++++++++++++++++++++++----
packaging/redhat/python-apprise.spec | 5 +++-
setup.py | 2 +-
6 files changed, 81 insertions(+), 20 deletions(-)
diff --git a/apprise/__init__.py b/apprise/__init__.py
index 6feaffba..c231d5e3 100644
--- a/apprise/__init__.py
+++ b/apprise/__init__.py
@@ -27,7 +27,7 @@
# POSSIBILITY OF SUCH DAMAGE.
__title__ = 'Apprise'
-__version__ = '1.9.0'
+__version__ = '1.9.1'
__author__ = 'Chris Caron'
__license__ = 'BSD'
__copywrite__ = 'Copyright (C) 2024 Chris Caron '
diff --git a/apprise/i18n/apprise.pot b/apprise/i18n/apprise.pot
index 45ba7b52..c2e4cec1 100644
--- a/apprise/i18n/apprise.pot
+++ b/apprise/i18n/apprise.pot
@@ -6,16 +6,16 @@
#, fuzzy
msgid ""
msgstr ""
-"Project-Id-Version: apprise 1.9.0\n"
+"Project-Id-Version: apprise 1.9.1\n"
"Report-Msgid-Bugs-To: lead2gold@gmail.com\n"
-"POT-Creation-Date: 2024-09-02 12:59-0400\n"
+"POT-Creation-Date: 2024-12-17 19:32-0500\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME \n"
"Language-Team: LANGUAGE \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: 8bit\n"
-"Generated-By: Babel 2.15.0\n"
+"Generated-By: Babel 2.16.0\n"
msgid "A local Gnome environment is required."
msgstr ""
@@ -50,7 +50,7 @@ msgstr ""
msgid "Access Token"
msgstr ""
-msgid "Account Email"
+msgid "Account Email or Object ID"
msgstr ""
msgid "Account SID"
@@ -107,6 +107,9 @@ msgstr ""
msgid "Attach Filename"
msgstr ""
+msgid "Auth ID"
+msgstr ""
+
msgid "Auth Token"
msgstr ""
@@ -493,6 +496,12 @@ msgstr ""
msgid "Overflow Mode"
msgstr ""
+msgid "PGP Encryption"
+msgstr ""
+
+msgid "PGP Public Key Path"
+msgstr ""
+
msgid "Packages are recommended to improve functionality."
msgstr ""
@@ -616,6 +625,9 @@ msgstr ""
msgid "Sensitive Attachments"
msgstr ""
+msgid "Server Discovery"
+msgstr ""
+
msgid "Server Key"
msgstr ""
@@ -709,9 +721,6 @@ msgstr ""
msgid "Target Device"
msgstr ""
-msgid "Target Device ID"
-msgstr ""
-
msgid "Target Email"
msgstr ""
@@ -763,9 +772,6 @@ msgstr ""
msgid "Target Subreddit"
msgstr ""
-msgid "Target Tag ID"
-msgstr ""
-
msgid "Target Team"
msgstr ""
@@ -853,6 +859,9 @@ msgstr ""
msgid "Token C"
msgstr ""
+msgid "Token D"
+msgstr ""
+
msgid "Topic"
msgstr ""
@@ -916,6 +925,9 @@ msgstr ""
msgid "Visibility"
msgstr ""
+msgid "Volume"
+msgstr ""
+
msgid "Web Based"
msgstr ""
diff --git a/packaging/man/apprise.1 b/packaging/man/apprise.1
index 90479d42..6baba4ca 100644
--- a/packaging/man/apprise.1
+++ b/packaging/man/apprise.1
@@ -1,6 +1,6 @@
.\" generated with Ronn-NG/v0.9.1
.\" http://github.com/apjanke/ronn-ng/tree/0.9.1
-.TH "APPRISE" "1" "August 2024" "Chris Caron "
+.TH "APPRISE" "1" "December 2024" "Chris Caron "
.SH "NAME"
\fBapprise\fR \- Push Notifications that work with just about every platform!
.SH "SYNOPSIS"
@@ -108,6 +108,8 @@ The \fBstorage\fR action has the following sub actions:
.IP "" 0
.SH "SERVICE URLS"
There are to many service URL and combinations to list here\. It\'s best to visit the Apprise GitHub page \fIhttps://github\.com/caronc/apprise/wiki#notification\-services\fR and see what\'s available\.
+.P
+The \fBenvironment variable\fR of \fBAPPRISE_URLS\fR (comma/space delimited) can be specified to provide the default set of URLs you wish to notify if none are otherwise specified\.
.SH "EXAMPLES"
Send a notification to as many servers as you want to specify as you can easily chain them together:
.IP "" 4
@@ -183,9 +185,13 @@ By default \fBapprise\fR looks in the following local locations for custom plugi
.fi
.IP "" 0
.P
-Simply create your own python file with the following bare minimum content in it: from apprise\.decorators import notify
+The \fBenvironment variable\fR of \fBAPPRISE_PLUGIN_PATH\fR can be specified to override the list identified above with one of your own\. use a semi\-colon (\fB;\fR), line\-feed (\fB\en\fR), and/or carriage return (\fB\er\fR) to delimit multiple entries\.
+.P
+Simply create your own python file with the following bare minimum content in it:
.IP "" 4
.nf
+from apprise\.decorators import notify
+
# This example assumes you want your function to trigger on foobar://
# references:
@notify(on="foobar", name="My Custom Notification")
@@ -223,6 +229,8 @@ Configuration files can be directly referenced via \fBapprise\fR when referencin
.P
The \fBconfiguration files\fR specified above can also be identified with a \fB\.yml\fR extension or even just entirely removing the \fB\.conf\fR extension altogether\.
.P
+The \fBenvironment variable\fR of \fBAPPRISE_CONFIG_PATH\fR can be specified to override the list identified above with one of your own\. use a semi\-colon (\fB;\fR), line\-feed (\fB\en\fR), and/or carriage return (\fB\er\fR) to delimit multiple entries\.
+.P
If a default configuration file is referenced in any way by the \fBapprise\fR tool, you no longer need to provide it a Service URL\. Usage of the \fBapprise\fR tool simplifies to:
.IP "" 4
.nf
@@ -238,6 +246,14 @@ $ apprise \-vv \-\-title "Will Be Late Getting Home" \e
\-\-tag=family
.fi
.IP "" 0
+.SH "ENVIRONMENT VARIABLES"
+\fBAPPRISE_URLS\fR: Specify the default URLs to notify IF none are otherwise specified on the command line explicitly\. If the \fB\-\-config\fR (\fB\-c\fR) is specified, then this will over\-rides any reference to this variable\. Use white space and/or a comma (\fB,\fR) to delimit multiple entries\.
+.P
+\fBAPPRISE_CONFIG_PATH\fR: Explicitly specify the config search path to use (over\-riding the default)\. Use a semi\-colon (\fB;\fR), line\-feed (\fB\en\fR), and/or carriage return (\fB\er\fR) to delimit multiple entries\.
+.P
+\fBAPPRISE_PLUGIN_PATH\fR: Explicitly specify the custom plugin search path to use (over\-riding the default)\. Use a semi\-colon (\fB;\fR), line\-feed (\fB\en\fR), and/or carriage return (\fB\er\fR) to delimit multiple entries\.
+.P
+\fBAPPRISE_STORAGE_PATH\fR: Explicitly specify the persistent storage path to use (over\-riding the default)\.
.SH "BUGS"
If you find any bugs, please make them known at: \fIhttps://github\.com/caronc/apprise/issues\fR
.SH "DONATIONS"
diff --git a/packaging/man/apprise.1.html b/packaging/man/apprise.1.html
index 6e7dd455..e333fddf 100644
--- a/packaging/man/apprise.1.html
+++ b/packaging/man/apprise.1.html
@@ -63,6 +63,7 @@
EXAMPLES
CUSTOM PLUGIN/NOTIFICATIONS
CONFIGURATION
+ ENVIRONMENT VARIABLES
BUGS
DONATIONS
COPYRIGHT
@@ -246,6 +247,9 @@ loaded but none could be notified due to user filtering (via tags).
There are to many service URL and combinations to list here. It's best to
visit the Apprise GitHub page and see what's available.
+The environment variable of APPRISE_URLS
(comma/space delimited) can be specified to
+provide the default set of URLs you wish to notify if none are otherwise specified.
+
EXAMPLES
Send a notification to as many servers as you want to specify as you can
@@ -311,11 +315,16 @@ files and loads them:
/var/lib/apprise/plugins
-Simply create your own python file with the following bare minimum content in
-it:
- from apprise.decorators import notify
+The environment variable of APPRISE_PLUGIN_PATH
can be specified to override
+the list identified above with one of your own. use a semi-colon (;
), line-feed (\n
),
+and/or carriage return (\r
) to delimit multiple entries.
-# This example assumes you want your function to trigger on foobar://
+Simply create your own python file with the following bare minimum content in
+it:
+
+from apprise.decorators import notify
+
+# This example assumes you want your function to trigger on foobar://
# references:
@notify(on="foobar", name="My Custom Notification")
def my_wrapper(body, title, notify_type, *args, **kwargs):
@@ -361,6 +370,10 @@ in the following local locations for configuration files and loads them:
The configuration files specified above can also be identified with a .yml
extension or even just entirely removing the .conf
extension altogether.
+The environment variable of APPRISE_CONFIG_PATH
can be specified to override
+the list identified above with one of your own. use a semi-colon (;
), line-feed (\n
),
+and/or carriage return (\r
) to delimit multiple entries.
+
If a default configuration file is referenced in any way by the apprise
tool, you no longer need to provide it a Service URL. Usage of the apprise
tool simplifies to:
@@ -376,6 +389,23 @@ configuration that you want and only specifically notify a subset of them:
--tag=family
+ENVIRONMENT VARIABLES
+APPRISE_URLS
:
+ Specify the default URLs to notify IF none are otherwise specified on the command line
+ explicitly. If the --config
(-c
) is specified, then this will over-rides any
+ reference to this variable. Use white space and/or a comma (,
) to delimit multiple entries.
+
+APPRISE_CONFIG_PATH
:
+ Explicitly specify the config search path to use (over-riding the default).
+ Use a semi-colon (;
), line-feed (\n
), and/or carriage return (\r
) to delimit multiple entries.
+
+APPRISE_PLUGIN_PATH
:
+ Explicitly specify the custom plugin search path to use (over-riding the default).
+ Use a semi-colon (;
), line-feed (\n
), and/or carriage return (\r
) to delimit multiple entries.
+
+APPRISE_STORAGE_PATH
:
+ Explicitly specify the persistent storage path to use (over-riding the default).
+
BUGS
If you find any bugs, please make them known at:
@@ -390,7 +420,7 @@ configuration that you want and only specifically notify a subset of them:
diff --git a/packaging/redhat/python-apprise.spec b/packaging/redhat/python-apprise.spec
index e8eeb9f6..7f8b76dd 100644
--- a/packaging/redhat/python-apprise.spec
+++ b/packaging/redhat/python-apprise.spec
@@ -55,7 +55,7 @@ Telegram, Threema Gateway, Twilio, Twitter, Twist, VictorOps, Voipms, Vonage,
WeCom Bot, WhatsApp, Webex Teams, Workflows, WxPusher, XBMC}
Name: python-%{pypi_name}
-Version: 1.9.0
+Version: 1.9.1
Release: 1%{?dist}
Summary: A simple wrapper to many popular notification services used today
License: BSD
@@ -149,6 +149,9 @@ LANG=C.UTF-8 PYTHONPATH=%{buildroot}%{python3_sitelib} py.test-%{python3_version
%{python3_sitelib}/%{pypi_name}/cli.*
%changelog
+* Tue Dec 17 2024 Chris Caron - 1.9.1
+- Updated to v1.9.1
+
* Mon Sep 2 2024 Chris Caron - 1.9.0
- Updated to v1.9.0
diff --git a/setup.py b/setup.py
index b6a9eb34..068830d4 100755
--- a/setup.py
+++ b/setup.py
@@ -63,7 +63,7 @@ else:
setup(
name='apprise',
- version='1.9.0',
+ version='1.9.1',
description='Push Notifications that work with just about every platform!',
license='BSD',
long_description=open('README.md', encoding="utf-8").read(),