chore: automate development version and release generation (#772)

This change introduces a GitHub Action to automate release creation, including
proper tagging and automatic addition of a development marker to the version.

A hash is also appended to development versions to make their state easier to
distinguish.

Tests and release documentation have been updated to reflect the revised
release workflow. Several files now retrieve the current version dynamically.

The test --full-run option has been rename to --finalize to make
clear it is to do commit finalization testing.

Signed-off-by: Bobby Noelte <b0661n0e17e@gmail.com>

tests/conftest.py

@@ -1,3 +1,4 @@
+import hashlib
 import json
 import logging
 import os
@@ -7,6 +8,7 @@ import sys
 import tempfile
 import time
 from contextlib import contextmanager
+from fnmatch import fnmatch
 from http import HTTPStatus
 from pathlib import Path
 from typing import Generator, Optional, Union
@@ -21,12 +23,14 @@ from loguru import logger
 from xprocess import ProcessStarter, XProcess
 
 from akkudoktoreos.config.config import ConfigEOS, get_config
+from akkudoktoreos.core.version import _version_hash, version
 from akkudoktoreos.server.server import get_default_host
 
 # -----------------------------------------------
 # Adapt pytest logging handling to Loguru logging
 # -----------------------------------------------
 
+
 @pytest.fixture
 def caplog(caplog: LogCaptureFixture):
     """Propagate Loguru logs to the pytest caplog handler."""
@@ -88,7 +92,7 @@ def disable_debug_logging(scope="session", autouse=True):
 
 def pytest_addoption(parser):
     parser.addoption(
-        "--full-run", action="store_true", default=False, help="Run with all optimization tests."
+        "--finalize", action="store_true", default=False, help="Run with all tests."
     )
     parser.addoption(
         "--check-config-side-effect",
@@ -105,8 +109,8 @@ def pytest_addoption(parser):
 
 
 @pytest.fixture
-def is_full_run(request):
-    yield bool(request.config.getoption("--full-run"))
+def is_finalize(request):
+    yield bool(request.config.getoption("--finalize"))
 
 
 @pytest.fixture(autouse=True)
@@ -123,6 +127,12 @@ def is_system_test(request):
     yield bool(request.config.getoption("--system-test"))
 
 
+@pytest.fixture
+def is_ci() -> bool:
+    """Returns True if running on GitHub Actions CI, False otherwise."""
+    return os.getenv("CI") == "true"
+
+
 @pytest.fixture
 def prediction_eos():
     from akkudoktoreos.prediction.prediction import get_prediction
@@ -528,6 +538,25 @@ def server_setup_for_function(xprocess) -> Generator[dict[str, Union[str, int]],
         yield result
 
 
+# --------------------------------------
+# Provide version and hash check support
+# --------------------------------------
+
+
+@pytest.fixture(scope="session")
+def version_and_hash() -> Generator[dict[str, Optional[str]], None, None]:
+    """Return version info as in in version.py and calculate current hash.
+
+    Runs once per test session.
+    """
+    info = version()
+    info["hash_current"] = _version_hash()
+
+    yield info
+
+    # After all tests
+
+
 # ------------------------------
 # Provide pytest timezone change
 # ------------------------------