feat: add module entrypoint

small useless feature, but the application can now be run with python -m
ahriman

ahriman-core/src/ahriman/__main__.py

@@ -0,0 +1,26 @@
+#
+# Copyright (c) 2021-2026 ahriman team.
+#
+# This file is part of ahriman
+# (see https://github.com/arcan1s/ahriman).
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# 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 sys
+
+from ahriman.application.ahriman import run
+
+
+if __name__ == "__main__":
+    sys.exit(run())

ahriman-core/tests/ahriman/test_main.py

@@ -0,0 +1,15 @@
+import runpy
+
+from pytest_mock import MockerFixture
+
+
+def test_main(mocker: MockerFixture) -> None:
+    """
+    must run the application and exit with its status
+    """
+    run = mocker.patch("ahriman.application.ahriman.run", return_value=42)
+    exit_mock = mocker.patch("sys.exit")
+
+    runpy.run_module("ahriman", run_name="__main__")
+    run.assert_called_once_with()
+    exit_mock.assert_called_once_with(42)