# BSD 2-Clause License # # Apprise - Push Notification Library. # Copyright (c) 2025, Chris Caron # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions are met: # # 1. Redistributions of source code must retain the above copyright notice, # this list of conditions and the following disclaimer. # # 2. Redistributions in binary form must reproduce the above copyright notice, # this list of conditions and the following disclaimer in the documentation # and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE # LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR # CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF # SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS # INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN # CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) # ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE # POSSIBILITY OF SUCH DAMAGE. import sys from unittest import mock import pytest import apprise from apprise import NotifyBase from apprise.plugins.growl import GrowlPriority, NotifyGrowl try: from gntp import errors TEST_GROWL_EXCEPTIONS = ( errors.NetworkError(0, "gntp.ParseError() not handled"), errors.AuthError(0, "gntp.AuthError() not handled"), errors.ParseError(0, "gntp.ParseError() not handled"), errors.UnsupportedError(0, "gntp.UnsupportedError() not handled"), ) except ImportError: # no problem; gntp isn't available to us pass # Disable logging for a cleaner testing output import logging logging.disable(logging.CRITICAL) @pytest.mark.skipif( "gntp" in sys.modules, reason="Requires that gntp NOT be installed" ) def test_plugin_growl_gntp_import_error(): """NotifyGrowl() Import Error.""" # If the object is disabled, then it can't be instantiated obj = apprise.Apprise.instantiate("growl://growl.server") assert obj is None @pytest.mark.skipif("gntp" not in sys.modules, reason="Requires gntp") @mock.patch("gntp.notifier.GrowlNotifier") def test_plugin_growl_exception_handling(mock_gntp): """NotifyGrowl() Exception Handling.""" TEST_GROWL_EXCEPTIONS = ( errors.NetworkError(0, "gntp.ParseError() not handled"), errors.AuthError(0, "gntp.AuthError() not handled"), errors.ParseError(0, "gntp.ParseError() not handled"), errors.UnsupportedError(0, "gntp.UnsupportedError() not handled"), ) mock_notifier = mock.Mock() mock_gntp.return_value = mock_notifier mock_notifier.notify.return_value = True # First we test the growl.register() function for exception in TEST_GROWL_EXCEPTIONS: mock_notifier.register.side_effect = exception # instantiate our object obj = apprise.Apprise.instantiate( "growl://growl.server.hostname", suppress_exceptions=False ) # Verify Growl object was instantiated assert obj is not None # We will fail to send the notification because our registration # would have failed assert ( obj.notify( title="test", body="body", notify_type=apprise.NotifyType.INFO ) is False ) # Now we test the growl.notify() function mock_notifier.register.side_effect = None for exception in TEST_GROWL_EXCEPTIONS: mock_notifier.notify.side_effect = exception # instantiate our object obj = apprise.Apprise.instantiate( "growl://growl.server.hostname", suppress_exceptions=False ) # Verify Growl object was instantiated assert obj is not None # We will fail to send the notification because of the underlining # notify() call throws an exception assert ( obj.notify( title="test", body="body", notify_type=apprise.NotifyType.INFO ) is False ) @pytest.mark.skipif("gntp" not in sys.modules, reason="Requires gntp") @mock.patch("gntp.notifier.GrowlNotifier") def test_plugin_growl_general(mock_gntp): """NotifyGrowl() General Checks.""" urls = ( ################################## # NotifyGrowl ################################## ( "growl://", { "instance": None, }, ), ("growl://:@/", {"instance": None}), ( "growl://pass@growl.server", { "instance": NotifyGrowl, }, ), ( "growl://ignored:pass@growl.server", { "instance": NotifyGrowl, }, ), ( "growl://growl.server", { "instance": NotifyGrowl, # don't include an image by default "include_image": False, }, ), ( "growl://growl.server?version=1", { "instance": NotifyGrowl, }, ), # Test sticky flag ( "growl://growl.server?sticky=yes", { "instance": NotifyGrowl, }, ), ( "growl://growl.server?sticky=no", { "instance": NotifyGrowl, }, ), # Force a failure ( "growl://growl.server?version=1", { "instance": NotifyGrowl, "growl_response": None, }, ), ( "growl://growl.server?version=2", { # don't include an image by default "include_image": False, "instance": NotifyGrowl, }, ), ( "growl://growl.server?version=2", { # don't include an image by default "include_image": False, "instance": NotifyGrowl, "growl_response": None, }, ), # Priorities ( "growl://pass@growl.server?priority=low", { "instance": NotifyGrowl, }, ), ( "growl://pass@growl.server?priority=moderate", { "instance": NotifyGrowl, }, ), ( "growl://pass@growl.server?priority=normal", { "instance": NotifyGrowl, }, ), ( "growl://pass@growl.server?priority=high", { "instance": NotifyGrowl, }, ), ( "growl://pass@growl.server?priority=emergency", { "instance": NotifyGrowl, }, ), # Invalid Priorities ( "growl://pass@growl.server?priority=invalid", { "instance": NotifyGrowl, }, ), ( "growl://pass@growl.server?priority=", { "instance": NotifyGrowl, }, ), # invalid version ( "growl://growl.server?version=", { "instance": NotifyGrowl, }, ), ( "growl://growl.server?version=crap", { "instance": NotifyGrowl, }, ), # Ports ( "growl://growl.changeport:2000", { "instance": NotifyGrowl, }, ), ( "growl://growl.garbageport:garbage", { "instance": NotifyGrowl, }, ), ( "growl://growl.colon:", { "instance": NotifyGrowl, }, ), ) # iterate over our dictionary and test it out for url, meta in urls: # Our expected instance instance = meta.get("instance", None) # Our expected exception exception = meta.get("exception", None) # Our expected server objects self = meta.get("self", None) # Our expected Query response (True, False, or exception type) response = meta.get("response", True) # Allow us to force the server response code to be something other then # the defaults growl_response = meta.get("growl_response", bool(response)) mock_notifier = mock.Mock() mock_gntp.return_value = mock_notifier mock_notifier.notify.side_effect = None # Store our response mock_notifier.notify.return_value = growl_response try: obj = apprise.Apprise.instantiate(url, suppress_exceptions=False) assert exception is None if obj is None: # We're done continue if instance is None: # Expected None but didn't get it raise AssertionError() assert isinstance(obj, instance) is True # Test our URL Identifier is generated assert isinstance(obj.url_id(), str) is True if isinstance(obj, NotifyBase): # We loaded okay; now lets make sure we can reverse this url assert isinstance(obj.url(), str) is True # Test our privacy=True flag assert isinstance(obj.url(privacy=True), str) is True # Instantiate the exact same object again using the URL from # the one that was already created properly obj_cmp = apprise.Apprise.instantiate(obj.url()) # Our object should be the same instance as what we had # originally expected above. if not isinstance(obj_cmp, NotifyBase): # Assert messages are hard to trace back with the way # these tests work. Just printing before throwing our # assertion failure makes things easier to debug later on raise AssertionError() if self: # Iterate over our expected entries inside of our object for key, val in self.items(): # Test that our object has the desired key assert hasattr(key, obj) assert getattr(key, obj) == val try: # check that we're as expected assert ( obj.notify( title="test", body="body", notify_type=apprise.NotifyType.INFO, ) == response ) except Exception as e: # Check that we were expecting this exception to happen assert isinstance(e, response) except AssertionError: # Don't mess with these entries raise except Exception as e: # Handle our exception assert exception is not None assert isinstance(e, exception) @pytest.mark.skipif("gntp" not in sys.modules, reason="Requires gntp") @mock.patch("gntp.notifier.GrowlNotifier") def test_plugin_growl_config_files(mock_gntp): """NotifyGrowl() Config File Cases.""" content = """ urls: - growl://pass@growl.server: - priority: -2 tag: growl_int low - priority: "-2" tag: growl_str_int low - priority: low tag: growl_str low # This will take on moderate (default) priority - priority: invalid tag: growl_invalid - growl://pass@growl.server: - priority: 2 tag: growl_int emerg - priority: "2" tag: growl_str_int emerg - priority: emergency tag: growl_str emerg """ mock_notifier = mock.Mock() mock_gntp.return_value = mock_notifier mock_notifier.notify.return_value = True # Create ourselves a config object ac = apprise.AppriseConfig() assert ac.add_config(content=content) is True aobj = apprise.Apprise() # Add our configuration aobj.add(ac) # We should be able to read our 7 servers from that # 3x low # 3x emerg # 1x invalid (so takes on normal priority) assert len(ac.servers()) == 7 assert len(aobj) == 7 assert len(list(aobj.find(tag="low"))) == 3 for s in aobj.find(tag="low"): assert s.priority == GrowlPriority.LOW assert len(list(aobj.find(tag="emerg"))) == 3 for s in aobj.find(tag="emerg"): assert s.priority == GrowlPriority.EMERGENCY assert len(list(aobj.find(tag="growl_str"))) == 2 assert len(list(aobj.find(tag="growl_str_int"))) == 2 assert len(list(aobj.find(tag="growl_int"))) == 2 assert len(list(aobj.find(tag="growl_invalid"))) == 1 assert ( next(aobj.find(tag="growl_invalid")).priority == GrowlPriority.NORMAL )