Skip to content

Releases: caronc/apprise

Apprise Release v0.9.1

23 Feb 18:00
Compare
Choose a tag to compare

Details

📣 New Notification Services:

💡 Features

  • Slack can now accept email targets. This will perform a lookup on the workspace to see if the user exists and notify them if they do. This feature only works if you've configured a Slack bot.
  • Added support for interpret-able escapes via CLI through the added argument --interpret-escapes (-e). (#349)
    • As an example, this allows you to pass in sequences such as \n and \r and have them translate into their equivalent ascii newline and carriage return characters
  • Gotify now supports for markdown (#358)
  • FCM (Firebase Cloud Messaging) completely re-factored/rewritten to support both the Legacy and OAuth2 Methods (#193)
  • XMPP re-factored to support slixmpp library for Python v3.7+ users (#240)

❤️ Life-Cycle Support

🐛 Bugfixes

  • Corrected issue with 2 CLI unit tests not passing (preventing v0.9.0 from going into EPEL) BZ1913619
  • Better asyncio handling in Python <3.7 using threading (#364)

Installation Instructions

Apprise is available on PyPI through pip:

# Install Apprise v0.9.1 from PyPI
pip install apprise==0.9.1

Apprise Release v0.9.0

30 Dec 21:45
Compare
Choose a tag to compare

Details

📣 New Notification Services:

💡 Features

  • Mailgun significantly enhanced to now support:
    • 📧 Blind Carbon Copy Addresses (bcc)
    • 📧 Carbon Copy Addresses (cc)
    • 📚 Email Attachments support
    • Ⓜ️ Email Headers
    • 🔢 Email Tokens. Mailgun allows you to identify keys/values and populate email with entries like %keyword% which gets swapped with it's corresponding value once the email gets prepared.
  • General email (mailto://) updated to support Email Headers passed in through the Apprise URL.
  • apprise.LogCapture() class introduced allowing users to wrap their calls to notify() and extrapolate the generated logs from each call. This is very useful when notifying more than 1 service and trying to determine where something may have gone wrong. Content can be captured to both memory and files. More details can be found here, #306 and PR #311.
  • 📧 Zoho email (21d7ef1):
    • supports @zohomail.com domain
    • uses STARTTLS (port 567) now vs SSL on 465
  • underscores (_) are now accepted in hostnames during parsing (even though technically they aren't allowed) - #324
  • Amazon SNS services parses responses/messages better - #320
  • Added support for Environment Variables - #334
    1. APPRISE_URLS: When defined, you can pre-provide apprise with a set of one or more URLs it can use to notify by default.
    2. APPRISE_CONFIG: You can set this to the absolute path of an Apprise Configuration File (either TEXT or YAML based).
  • Some new rules/structuring come with the environment variable change too (just enforcing order of detected inputs) and which to use:
    1. URLs by command line
      • A warning is issued to the screen if a (--config or -c) is also specified as it will be ignored
      • A warning is issued to the screen if a (--tag or -g) is also specified as it will be ignored
    2. Configuration by command line
    3. URLs by environment variable: APPRISE_URLS
      • A warning is issued to the screen if a (--tag or -g) is also specified as it will be ignored
    4. Configuration by environment variable: APPRISE_CONFIG
    5. Default Configuration File(s) if found - no change here prior to this commit.

❤️ Life-Cycle Support

  • n/a

🐛 Bugfixes

  • SparkPost handling of cc and bcc messages fixed #309
  • Pushover validation checks on the user_key and token have been eliminated in Apprise. These have been left for the upstream server (in this case Pushover) to validate instead. #313
  • Zulip references stream instead of channel #330

Installation Instructions

Apprise is available on PyPI through pip:

# Install Apprise v0.9.0 from PyPI
pip install apprise==0.9.0

Apprise Release v0.8.9

04 Oct 19:41
Compare
Choose a tag to compare

Details

📣 New Notification Services:

💡 Features

  • Microsoft Teams Templating (#292)! The ability to provide your own MessageCard instead of using the built in one. The templating engine requires no additional includes and additionally supports dynamic tokens that you can pass in through the Apprise URL; see #299 for details.
  • Improved YAML configuration parsing (#288)
  • Added Yandex Email support to mailto:// Plugin (#303)

❤️ Life-Cycle Support

  • n/a

🐛 Bugfixes

  • Lametric Time cloud mode support fixed (#293)
  • Reworked Discord markdown enhancements that Apprise supports (the addition of the # keyword) to parse content better (#229)
  • Async/Sync update to fix warning message appearing in Apprise Home Assistant Integration (#304)

Installation Instructions

Apprise is available on PyPI through pip:

# Install Apprise v0.8.9 from PyPI
pip install apprise==0.8.9

Apprise Release v0.8.7

13 Aug 21:42
Compare
Choose a tag to compare

Details

📣 New Notification Services:

💡 Features

  • Apprise Socket Timeouts enforced and configurable. Queries made to upstream servers can now timeout if the external source isn't available or is taking to log to reply. By default the times are set as follows:
    • Socket Connect Timeout which defaults to 4.0 seconds. This is the length in time Apprise will wait for an upstream server to accept a connection from it before giving up.
      • You can over-ride this value by specifying the cto= parameter on your Apprise URL.
    • Socket Read Timeout which defaults to 4.0 seconds. This is the maximum length in time Apprise will wait for on an already established upstream connection to which the server has gone dormant and no longer appears to be responding.
      • You can over-ride this value by specifying the rto= parameter on your Apprise URL.
  • Improved logging within Apprise to make it a bit more obvious why a URL may have not loaded correctly. Apprise remains to be silent on the CLI out of the box, so improved logging still requires at least one --verbose switch (-v)
  • Apprise URLs that accept valid hostnames:
    • Now additionally support IPv6 entries. To be RFC compliant, IPv6 files should be wrapped in square brackets (such as kodi://[2001:0db8:85a3:0000:0000:8a2e:0370:7334]). However at this time Apprise can safely detect URLs that do not include the square brackets ([]) and improvises by adding them for you.
    • IPv4 support drastically improved. Only valid IP addresses are accepted if provided.

❤️ Life-Cycle Support

  • Discord changing API servers to new location;. Legacy servers will no longer work after November 7th, 2020. Apprise was updated to point to new API location to avoid having any issues at this time.

🐛 Bugfixes

  • Nexmo credentials bugfix (138c8eb)
  • Test cases now pass against Fedora 33 Rawhide mass rebuild (#263) (BZ1865273)
  • Email has better internationalization support now (#268)
  • Growl Notifications Missing Notification Header Issue Resolved (#251)
    • gntp library also removed from Apprise an is a separate dependency instead:
      # The following will allow you to use Growl Notifications again (for those using it)
      pip install gntp
      
      # This has also already been added to the `requirements.txt` file
      # Apprise puts out information to the screen reminding those that have not done this
      #  and are attempting to use Growl to run the pip command below as well.

Installation Instructions

Apprise is available on PyPI through pip:

# Install Apprise v0.8.7 from PyPI
pip install apprise==0.8.7

Apprise Release v0.8.6

13 Jun 15:05
Compare
Choose a tag to compare

Details

Apprise is also available on PyPI through pip:

# Install Apprise v0.8.6 from PyPI
pip install apprise==0.8.6

Apprise Release v0.8.5

30 Mar 21:25
Compare
Choose a tag to compare

Details

  • Features:

    • XMPP Plugin completely refactored/rewritten to now work correctly (#213)
      • This specific notification service requires that sleekxmpp is available on your system.
    • Join now additionally supports targets that identify the Device Names (#205)
  • Bugfixes:

    • Eliminated Slack Token min/max length validation (#219)
    • Email plugin now supports connecting to SMTP server without user/pass (#214)
    • Telegram notifications can correctly pass HTML to the upstream server (#203)

Apprise is also available on PyPI through pip:

# Install Apprise v0.8.5 from PyPI
pip install apprise==0.8.5

Apprise Release v0.8.4

01 Feb 18:46
Compare
Choose a tag to compare

Details

  • New Notification Services:

  • Features:

    • AppriseConfig object now supports a new function called add_config() which allows you to directly add configuration (into the object) v.s. always having to point it at a file or a website. (#199)
  • Bugfixes:

    • Resolved issue where an error response was returned from Apprise even thought successful posted to Slack (#195)

Apprise is also available on PyPI through pip:

# Install Apprise v0.8.4 from PyPI
pip install apprise==0.8.4

Apprise Release v0.8.3

13 Jan 00:04
Compare
Choose a tag to compare

Details

Apprise is also available on PyPI through pip:

# Install Apprise v0.8.3 from PyPI
pip install apprise==0.8.3

Apprise Release v0.8.2

26 Nov 00:36
Compare
Choose a tag to compare

Details

  • New Notification Services:
  • Enhancements:
    • Slack now supports bots too.
    • File Attachment Support
      • AppriseAttachment() class added for working with attachments using the API.
      • --attach (-a) added to CLI allowing users to attach content from both the internet and/or local files to the supported services (See #173 for details). Currently the supported services are:
    • There are not limits to the number of attachments you can provide (assuming the upstream service can handle it).
  • Cleaned up images/icons (look/feel)
  • Configuration files can now be optionally cached or not now; see #175
  • Bugfixes:
    • Discord error code 50006 issue resolved (#180)

Apprise is also available on PyPI through pip:

# Install Apprise v0.8.2 from PyPI
pip install apprise==0.8.2

Apprise Release v0.8.1

14 Oct 01:58
Compare
Choose a tag to compare

Details

  • New Notification Services:
  • Enhancements:
    • Re-factored how most services are instantiated. All QA moved to to class initialization and not during the sending process. This allows users to know right away if they're URL is ready, not after they attempt to send a notification with one.
    • --dry-run (-d) switch added that allow you to determine what services will be notified without actually performing the notification.
    • Tagging is now exclusive. This means if you associate a tag with a URL, you can only trigger that notification if you perform the notification while specifying to match against that very tag. More information can be found in the PR #153
  • Bugfixes:
    • Native URL Parsing from Config file (PR #164)
    • Native URLs can not contain parseable parameters

Apprise is also available on PyPI through pip:

# Install Apprise v0.8.1 from PyPI
pip install apprise==0.8.1