Added new user generation script and optimized mail config

cli/generate_users.py

@@ -0,0 +1,163 @@
+#!/usr/bin/env python3
+import os
+import sys
+import argparse
+import yaml
+import glob
+from collections import OrderedDict
+
+
+def build_users(defs, primary_domain, start_id, become_pwd):
+    """
+    Build user entries with auto-incremented uid/gid and default username/email.
+
+    Args:
+        defs (OrderedDict): Keys are user IDs, values are dicts with optional overrides.
+        primary_domain (str): e.g., 'example.com'.
+        start_id (int): Starting uid/gid (e.g., 1001).
+        become_pwd (str): Password string for all users.
+
+    Returns:
+        OrderedDict: Merged user definitions with full fields.
+    """
+    users = OrderedDict()
+    next_id = start_id
+
+    for key, overrides in defs.items():
+        username = overrides.get('username', key)
+        email = overrides.get('email', f"{username}@{primary_domain}")
+        uid = overrides.get('uid', next_id)
+        gid = overrides.get('gid', next_id)
+        is_admin = overrides.get('is_admin', False)
+
+        entry = {
+            'username': username,
+            'email':    email,
+            'password': become_pwd,
+            'uid':      uid,
+            'gid':      gid
+        }
+        if is_admin:
+            entry['is_admin'] = True
+
+        users[key] = entry
+        next_id += 1
+
+    return users
+
+
+def load_user_defs(roles_dir):
+    """
+    Scan all roles/*/vars/configuration.yml files and extract 'users:' sections.
+
+    Raises an exception if conflicting definitions are found.
+
+    Args:
+        roles_dir (str): Path to the directory containing role subdirectories.
+
+    Returns:
+        OrderedDict: Merged user definitions.
+
+    Raises:
+        ValueError: On invalid format or conflicting field values.
+    """
+    pattern = os.path.join(roles_dir, '*/vars/configuration.yml')
+    files = sorted(glob.glob(pattern))
+    merged = OrderedDict()
+
+    for filepath in files:
+        with open(filepath, 'r') as f:
+            data = yaml.safe_load(f) or {}
+        users = data.get('users', {})
+        if not isinstance(users, dict):
+            continue
+
+        for key, overrides in users.items():
+            if not isinstance(overrides, dict):
+                raise ValueError(f"Invalid definition for user '{key}' in {filepath}")
+
+            if key not in merged:
+                merged[key] = overrides.copy()
+            else:
+                existing = merged[key]
+                for field, value in overrides.items():
+                    if field in existing and existing[field] != value:
+                        raise ValueError(
+                            f"Conflict for user '{key}': field '{field}' has existing value "
+                            f"'{existing[field]}', tried to set '{value}' in {filepath}"
+                        )
+                existing.update(overrides)
+
+    return merged
+
+
+def dictify(data):
+    """
+    Recursively convert OrderedDict to regular dict before YAML dump.
+    """
+    if isinstance(data, OrderedDict):
+        return {k: dictify(v) for k, v in data.items()}
+    if isinstance(data, dict):
+        return {k: dictify(v) for k, v in data.items()}
+    if isinstance(data, list):
+        return [dictify(v) for v in data]
+    return data
+
+
+def parse_args():
+    parser = argparse.ArgumentParser(
+        description='Generate a users.yml by merging all roles/*/vars/configuration.yml users sections.'
+    )
+    parser.add_argument(
+        '--roles-dir', '-r', required=True,
+        help='Directory containing roles (e.g., roles/*/vars/configuration.yml).'
+    )
+    parser.add_argument(
+        '--output', '-o', required=True,
+        help='Path to the output YAML file (e.g., users.yml).'
+    )
+    parser.add_argument(
+        '--start-id', '-s', type=int, default=1001,
+        help='Starting uid/gid number (default: 1001).'
+    )
+    return parser.parse_args()
+
+
+def main():
+    args = parse_args()
+    primary_domain = '{{ primary_domain }}'
+    become_pwd = '{{ ansible_become_password }}'
+
+    try:
+        user_defs = load_user_defs(args.roles_dir)
+    except ValueError as e:
+        print(f"Error merging user definitions: {e}", file=sys.stderr)
+        sys.exit(1)
+
+    users = build_users(
+        defs=user_defs,
+        primary_domain=primary_domain,
+        start_id=args.start_id,
+        become_pwd=become_pwd
+    )
+
+    default_users = {'default_users': users}
+    plain_data = dictify(default_users)
+
+    # Ensure strings are represented without Python-specific tags
+    yaml.SafeDumper.add_representer(
+        str,
+        lambda dumper, data: dumper.represent_scalar('tag:yaml.org,2002:str', data)
+    )
+
+    with open(args.output, 'w') as f:
+        yaml.safe_dump(
+            plain_data,
+            f,
+            default_flow_style=False,
+            sort_keys=False,
+            width=120
+        )
+
+if __name__ == '__main__':
+    main()