From 9ba74413e3bfb497583003d8f9ee2d4b93918ef9 Mon Sep 17 00:00:00 2001
From: Evgenii Alekseev <i@arcanis.me>
Date: Fri, 6 Nov 2026 13:40:47 +0200
Subject: [PATCH] feat: add module entrypoint

small useless feature, but the application can now be run with python -m
ahriman
---
 ahriman-core/src/ahriman/__main__.py    | 26 +++++++++++++++++++++++++
 ahriman-core/tests/ahriman/test_main.py | 15 ++++++++++++++
 tests/test_tests.py                     |  8 +++++++-
 3 files changed, 48 insertions(+), 1 deletion(-)
 create mode 100644 ahriman-core/src/ahriman/__main__.py
 create mode 100644 ahriman-core/tests/ahriman/test_main.py

diff --git a/ahriman-core/src/ahriman/__main__.py b/ahriman-core/src/ahriman/__main__.py
new file mode 100644
index 00000000..3cacb0ad
--- /dev/null
+++ b/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())
diff --git a/ahriman-core/tests/ahriman/test_main.py b/ahriman-core/tests/ahriman/test_main.py
new file mode 100644
index 00000000..d89a484b
--- /dev/null
+++ b/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)
diff --git a/tests/test_tests.py b/tests/test_tests.py
index 9703b648..0221078b 100644
--- a/tests/test_tests.py
+++ b/tests/test_tests.py
@@ -29,6 +29,8 @@ def _test_path(source_root: Path, source_file: Path) -> Path:
                 return relative_path.parent / f"test_{source_name}"
             else:
                 return relative_path.parent / f"test_view_{source_name}"
+        case (*_, source_name) if source_name.startswith("__"):
+            return relative_path.parent / f"test_{source_name.replace("__", "")}"
         case _:
             return relative_path.parent / f"test_{source_file.name}"
 
@@ -37,6 +39,10 @@ def test_test_coverage() -> None:
     """
     must have test files for each source file
     """
+    def filter_files(filename: str) -> bool:
+        return filename.suffix == ".py" \
+            and filename.name not in ("__init__.py",)
+
     package_roots = [
         Path("ahriman-core"),
         Path("ahriman-triggers"),
@@ -46,6 +52,6 @@ def test_test_coverage() -> None:
     for package_root in package_roots:
         source_root = package_root / "src"
 
-        for source_file in filter(lambda fn: fn.suffix == ".py" and fn.name != "__init__.py", walk(source_root)):
+        for source_file in filter(filter_files, walk(source_root)):
             test_file = package_root / "tests" / _test_path(source_root, source_file)
             assert test_file.is_file(), test_file