Initial commit: FCCS extraction tool

fccs_config.py

@@ -0,0 +1,70 @@
+"""
+Shared configuration, logging, and utilities for the FCCS extraction tool.
+"""
+
+import os
+import sys
+import argparse
+import configparser
+from datetime import datetime
+
+DEFAULT_CONFIG = "config.ini"
+
+
+def parse_args():
+    """Parse the optional --config argument common to all scripts."""
+    parser = argparse.ArgumentParser()
+    parser.add_argument(
+        "--config",
+        default=None,
+        help=f"Path to config file (default: {DEFAULT_CONFIG} in script directory)",
+    )
+    return parser.parse_args()
+
+
+def load_config(path=None):
+    """Read config.ini and return a ConfigParser object."""
+    if path is None:
+        script_dir = os.path.dirname(os.path.abspath(sys.argv[0]))
+        path = os.path.join(script_dir, DEFAULT_CONFIG)
+    if not os.path.exists(path):
+        print(f"ERROR: config file not found: {path}")
+        sys.exit(1)
+    cfg = configparser.ConfigParser()
+    cfg.read(path, encoding="utf-8")
+    return cfg
+
+
+def make_logger(log_file):
+    """Return a log() function that writes timestamped lines to console and file."""
+    def log(msg):
+        line = f"[{datetime.now():%Y-%m-%d %H:%M:%S}] {msg}"
+        print(line)
+        try:
+            with open(log_file, "a", encoding="utf-8") as f:
+                f.write(line + "\n")
+        except Exception:
+            pass
+    return log
+
+
+def load_folder_list(path):
+    """Load known FCCS folder names from file, one per line."""
+    if not os.path.exists(path):
+        print(f"ERROR: folder list file not found: {path}")
+        sys.exit(1)
+    folders = []
+    with open(path, "r", encoding="utf-8") as f:
+        for line in f:
+            s = line.strip()
+            if s and not s.startswith("#"):
+                folders.append(s)
+    return folders
+
+
+def load_lines(path):
+    """Read non-blank, non-comment lines from a file."""
+    if not os.path.exists(path):
+        return []
+    with open(path, "r", encoding="utf-8") as f:
+        return [line.strip() for line in f if line.strip() and not line.strip().startswith("#")]