Phase 4b: Unit Testing

tests/conftest.py

@@ -0,0 +1,63 @@
+"""Pytest configuration and shared fixtures for GAM tests.
+
+Path setup: GAM's modules use bare 'from util.X import ...' which requires the
+gam package directory on sys.path. We add it in a fixture (not at module level)
+to avoid shadowing Python's stdlib 'cmd' module during pytest configuration.
+"""
+
+import os
+import sys
+
+import pytest
+
+
+@pytest.fixture(autouse=True)
+def _gam_path_and_globals():
+    """Add GAM's package dir to sys.path and initialize minimal global state.
+
+    Done in a fixture rather than at module level to avoid polluting sys.path
+    during pytest's own import of stdlib modules (e.g. cmd, which would collide
+    with gam/cmd/).
+    """
+    gam_pkg_dir = os.path.join(os.path.dirname(__file__), '..', 'src', 'gam')
+    gam_pkg_dir = os.path.normpath(gam_pkg_dir)
+
+    # Temporarily prepend — will be cleaned up after test
+    inserted = False
+    if gam_pkg_dir not in sys.path:
+        sys.path.insert(0, gam_pkg_dir)
+        inserted = True
+
+    # Also need src/ on path for 'gam' package imports
+    src_dir = os.path.join(os.path.dirname(__file__), '..', 'src')
+    src_dir = os.path.normpath(src_dir)
+    src_inserted = False
+    if src_dir not in sys.path:
+        sys.path.insert(0, src_dir)
+        src_inserted = True
+
+    from gamlib import glcfg as GC
+    from gamlib import glglobals as GM
+
+    # Ensure Values dict exists with minimal defaults
+    if not GC.Values:
+        GC.Values = {}
+    GC.Values.setdefault(GC.DOMAIN, 'example.com')
+    GC.Values.setdefault(GC.CUSTOMER_ID, 'C00000000')
+    GC.Values.setdefault(GC.TIMEZONE, 'UTC')
+    GC.Values.setdefault(GC.SHOW_COUNTS_MIN, 0)
+
+    # Ensure Globals dict exists
+    if not GM.Globals:
+        GM.Globals = {}
+    GM.Globals.setdefault(GM.STDOUT, None)
+    GM.Globals.setdefault(GM.STDERR, None)
+    GM.Globals.setdefault(GM.SYSEXITRC, 0)
+
+    yield
+
+    # Clean up sys.path to avoid side effects between test files
+    if inserted and gam_pkg_dir in sys.path:
+        sys.path.remove(gam_pkg_dir)
+    if src_inserted and src_dir in sys.path:
+        sys.path.remove(src_dir)