extend triggers to on_start and on_stop methods

This commit also replaces old run method to new on_result

src/ahriman/application/ahriman.py

@@ -473,7 +473,7 @@ def _set_repo_rebuild_parser(root: SubParserAction) -> argparse.ArgumentParser:
     parser.add_argument("--from-database",
                         help="read packages from database instead of filesystem. This feature in particular is "
                              "required in case if you would like to restore repository from another repository "
-                             "instance. Note however that in order to restore packages you need to have original "
+                             "instance. Note, however, that in order to restore packages you need to have original "
                              "ahriman instance run with web service and have run repo-update at least once.",
                         action="store_true")
     parser.add_argument("-e", "--exit-code", help="return non-zero exit status if result is empty", action="store_true")

src/ahriman/core/report/report_trigger.py

@@ -45,7 +45,7 @@ class ReportTrigger(Trigger):
         Trigger.__init__(self, architecture, configuration)
         self.targets = configuration.getlist("report", "target")
 
-    def run(self, result: Result, packages: Iterable[Package]) -> None:
+    def on_result(self, result: Result, packages: Iterable[Package]) -> None:
         """
         run trigger
 

src/ahriman/core/repository/executor.py

@@ -151,7 +151,7 @@ class Executor(Cleaner):
         Args:
             result(Result): build result
         """
-        self.triggers.process(result, self.packages())
+        self.triggers.on_result(result, self.packages())
 
     def process_update(self, packages: Iterable[Path]) -> Result:
         """

src/ahriman/core/sign/gpg.py

@@ -181,7 +181,7 @@ class GPG(LazyLogging):
         sign repository if required by configuration
 
         Note:
-            more likely you just want to pass ``repository_sign_args`` to repo wrapper
+            More likely you just want to pass ``repository_sign_args`` to repo wrapper
 
         Args:
             path(Path): path to repository database

src/ahriman/core/triggers/trigger.py

@@ -37,7 +37,7 @@ class Trigger(LazyLogging):
         This class must be used in order to create own extension. Basically idea is the following::
 
             >>> class CustomTrigger(Trigger):
-            >>>     def run(self, result: Result, packages: Iterable[Package]) -> None:
+            >>>     def on_result(self, result: Result, packages: Iterable[Package]) -> None:
             >>>         perform_some_action()
 
         Having this class you can pass it to ``configuration`` and it will be run on action::
@@ -48,7 +48,7 @@ class Trigger(LazyLogging):
             >>> configuration.set_option("build", "triggers", "my.awesome.package.CustomTrigger")
             >>>
             >>> loader = TriggerLoader("x86_64", configuration)
-            >>> loader.process(Result(), [])
+            >>> loader.on_result(Result(), [])
     """
 
     def __init__(self, architecture: str, configuration: Configuration) -> None:
@@ -62,15 +62,35 @@ class Trigger(LazyLogging):
         self.architecture = architecture
         self.configuration = configuration
 
-    def run(self, result: Result, packages: Iterable[Package]) -> None:
+    def on_result(self, result: Result, packages: Iterable[Package]) -> None:
         """
-        run trigger
+        trigger action which will be called after build process with process result
+
+        Args:
+            result(Result): build result
+            packages(Iterable[Package]): list of all available packages
+        """
+        self.run(result, packages)  # compatibility with old triggers
+
+    def on_start(self) -> None:
+        """
+        trigger action which will be called at the start of the application
+        """
+
+    def on_stop(self) -> None:
+        """
+        trigger action which will be called before the stop of the application
+        """
+
+    def run(self, result: Result, packages: Iterable[Package]) -> None:
+        """
+        run trigger
+
+        Note:
+            This method is deprecated and will be removed in the future versions. In order to run old-style trigger
+            action the ``on_result`` method must be used.
 
         Args:
             result(Result): build result
             packages(Iterable[Package]): list of all available packages
-
-        Raises:
-            NotImplementedError: not implemented method
         """
-        raise NotImplementedError

src/ahriman/core/triggers/trigger_loader.py

@@ -17,12 +17,14 @@
 # You should have received a copy of the GNU General Public License
 # along with this program. If not, see <http://www.gnu.org/licenses/>.
 #
+import contextlib
 import importlib
 import os
+import weakref
 
 from pathlib import Path
 from types import ModuleType
-from typing import Iterable
+from typing import Generator, Iterable
 
 from ahriman.core.configuration import Configuration
 from ahriman.core.exceptions import InvalidExtension
@@ -54,7 +56,7 @@ class TriggerLoader(LazyLogging):
 
         After that you are free to run triggers::
 
-            >>> loader.process(Result(), [])
+            >>> loader.on_result(Result(), [])
     """
 
     def __init__(self, architecture: str, configuration: Configuration) -> None:
@@ -73,6 +75,25 @@ class TriggerLoader(LazyLogging):
             for trigger in configuration.getlist("build", "triggers")
         ]
 
+        self.on_start()
+        self._finalizer = weakref.finalize(self, self.on_stop)
+
+    @contextlib.contextmanager
+    def __execute_trigger(self, trigger: Trigger) -> Generator[None, None, None]:
+        """
+        decorator for calling triggers
+
+        Args:
+            trigger(Trigger): trigger instance to be called
+        """
+        trigger_name = type(trigger).__name__
+
+        try:
+            self.logger.info("executing extension %s", trigger_name)
+            yield
+        except Exception:
+            self.logger.exception("got exception while run trigger %s", trigger_name)
+
     def _load_module_from_file(self, module_path: str, implementation: str) -> ModuleType:
         """
         load module by given file path
@@ -149,18 +170,30 @@ class TriggerLoader(LazyLogging):
 
         return trigger
 
-    def process(self, result: Result, packages: Iterable[Package]) -> None:
+    def on_result(self, result: Result, packages: Iterable[Package]) -> None:
         """
-        run remote sync
+        run trigger with result of application run
 
         Args:
             result(Result): build result
             packages(Iterable[Package]): list of all available packages
         """
         for trigger in self.triggers:
-            trigger_name = type(trigger).__name__
-            try:
-                self.logger.info("executing extension %s", trigger_name)
-                trigger.run(result, packages)
-            except Exception:
-                self.logger.exception("got exception while run trigger %s", trigger_name)
+            with self.__execute_trigger(trigger):
+                trigger.on_result(result, packages)
+
+    def on_start(self) -> None:
+        """
+        run triggers on load
+        """
+        for trigger in self.triggers:
+            with self.__execute_trigger(trigger):
+                trigger.on_start()
+
+    def on_stop(self) -> None:
+        """
+        run triggers before the application exit
+        """
+        for trigger in self.triggers:
+            with self.__execute_trigger(trigger):
+                trigger.on_stop()

src/ahriman/core/upload/upload_trigger.py

@@ -45,7 +45,7 @@ class UploadTrigger(Trigger):
         Trigger.__init__(self, architecture, configuration)
         self.targets = configuration.getlist("upload", "target")
 
-    def run(self, result: Result, packages: Iterable[Package]) -> None:
+    def on_result(self, result: Result, packages: Iterable[Package]) -> None:
         """
         run trigger