scripts: module: helper script to create a new module from template

This scripts creates a new module from template and renames files, code
to the new module name alongside creating uuid and Cmake and Kconfig
entries.

Signed-off-by: Liam Girdwood <liam.r.girdwood@linux.intel.com>

Author: lrgirdwo

scripts/sdk-create-module.py

@@ -0,0 +1,397 @@
+#!/usr/bin/env python3
+# SPDX-License-Identifier: BSD-3-Clause
+#
+# Create a new module directory with a basic structure
+
+import os
+import sys
+import shutil
+import uuid
+import re
+
+def process_directory(directory_path, old_text, new_text):
+    """
+    Recursively walks through a directory to rename files and replace content.
+    This function processes files first, then directories, to allow for renaming
+    of the directories themselves after their contents are handled.
+    """
+    # Walk through the directory tree
+    for dirpath, dirnames, filenames in os.walk(directory_path, topdown=False):
+        # --- Process Files ---
+        for filename in filenames:
+            original_filepath = os.path.join(dirpath, filename)
+
+            # a) Replace content within files
+            # Only process C/H files for content replacement
+            if filename.endswith(('.c', '.h', '.cpp', '.hpp', '.txt', '.toml', 'Kconfig')):
+                replace_text_in_file(original_filepath, old_text, new_text)
+            if filename.endswith(('.c', '.h', '.cpp', '.hpp', '.txt', '.toml', 'Kconfig')):
+                replace_text_in_file(original_filepath, old_text.upper(), new_text.upper())
+            if filename.endswith(('.c', '.h', '.cpp', '.hpp', '.txt', '.toml', 'Kconfig')):
+                replace_text_in_file(original_filepath, "template", new_text)
+            if filename.endswith(('.c', '.h', '.cpp', '.hpp', '.txt', '.toml', 'Kconfig')):
+                replace_text_in_file(original_filepath, "TEMPLATE", new_text.upper())
+
+            # b) Rename the file if its name contains the template text
+            if "template" in filename:
+                new_filename = filename.replace("template", new_text)
+                new_filepath = os.path.join(dirpath, new_filename)
+                print(f"  -> Renaming file: '{original_filepath}' to '{new_filepath}'")
+                os.rename(original_filepath, new_filepath)
+
+def replace_text_in_file(filepath, old_text, new_text):
+    """
+    Replaces all occurrences of old_text with new_text in a given file.
+    """
+    try:
+        # Read the file content
+        with open(filepath, 'r', encoding='utf-8') as file:
+            content = file.read()
+
+        # Perform the replacement
+        new_content = content.replace(old_text, new_text)
+
+        # If content has changed, write it back
+        if new_content != content:
+            print(f"  -> Updating content in: '{filepath}'")
+            with open(filepath, 'w', encoding='utf-8') as file:
+                file.write(new_content)
+
+    except Exception as e:
+        print(f"  -> [WARNING] Could not process file '{filepath}'. Reason: {e}")
+
+def insert_uuid_name(filepath: str, new_name: str):
+    """
+    Inserts a newly generated UUID and a given name into a file, maintaining
+    alphabetical order by name. Ignores and preserves lines starting with '#'.
+
+    Args:
+        filepath (str): The path to the file to be updated.
+        new_name (str): The name to associate with the new UUID.
+    """
+    data_entries = []
+    other_lines = []  # To store comments and blank lines
+
+    # --- 1. Read existing entries and comments from the file ---
+    try:
+        with open(filepath, 'r', encoding='utf-8') as f:
+            for line in f:
+                stripped_line = line.strip()
+                # Check for comments or blank lines
+                if not stripped_line or stripped_line.startswith('#'):
+                    other_lines.append(line)  # Preserve the original line with newline
+                    continue
+
+                # It's a data line, so process it
+                # Split only on the first space to handle names that might contain spaces
+                parts = stripped_line.split(' ', 1)
+                if len(parts) == 2:
+                    data_entries.append((parts[0], parts[1]))
+    except FileNotFoundError:
+        print(f"File '{filepath}' not found. A new file will be created.")
+    except Exception as e:
+        print(f"An error occurred while reading the file: {e}")
+        return
+
+    # --- 2. Check if the name already exists in data entries ---
+    if any(name == new_name for _, name in data_entries):
+        print(f"Name '{new_name}' already exists in the file. No changes made.")
+        return
+
+    # --- 3. Add the new entry to the data list ---
+    new_uuid = str(uuid.uuid4())
+
+    # We split the string from the right at the last hyphen and then join the parts.
+    parts = new_uuid.rsplit('-', 1)
+    custom_format_uuid = ''.join(parts)
+
+    data_entries.append((custom_format_uuid, new_name))
+    print(f"Generated new entry: {new_uuid} {new_name}")
+
+    # --- 4. Sort the list of data entries by name (the second element of the tuple) ---
+    data_entries.sort(key=lambda item: item[1])
+
+    # --- 5. Write the comments and then the sorted data back to the file ---
+    try:
+        with open(filepath, 'w', encoding='utf-8') as f:
+            # Write all the comments and other non-data lines first
+            for line in other_lines:
+                f.write(line)
+
+            # Write the sorted data entries
+            for entry_uuid, entry_name in data_entries:
+                f.write(f"{entry_uuid} {entry_name}\n")
+        print(f"Successfully updated '{filepath}'.")
+    except Exception as e:
+        print(f"An error occurred while writing to the file: {e}")
+
+# Define the markers for the managed block in the CMakeLists.txt file.
+CMAKE_START_MARKER = "	# directories and files included conditionally (alphabetical order)"
+CMAKE_END_MARKER = "	# end of directories and files included conditionally (alphabetical order)"
+
+def insert_cmake_rule(filepath: str, kconfig_option: str, subdir_name: str):
+    """
+    Reads a CMakeLists.txt file, adds a new rule, and writes it back.
+
+    Args:
+        filepath (str): Path to the CMakeLists.txt file.
+        kconfig_option (str): The Kconfig flag to check.
+        subdir_name (str): The subdirectory to add.
+    """
+    if not os.path.exists(filepath):
+        print(f"[ERROR] File not found at: '{filepath}'")
+        return
+
+    # --- 1. Read the entire file content ---
+    with open(filepath, 'r', encoding='utf-8') as f:
+        lines = f.readlines()
+
+    # --- 2. Find the start and end of the managed block ---
+    try:
+        start_index = lines.index(CMAKE_START_MARKER + '\n')
+        end_index = lines.index(CMAKE_END_MARKER + '\n')
+    except ValueError:
+        print(f"[ERROR] Could not find the required marker blocks in '{filepath}'.")
+        print(f"Please ensure the file contains both '{CMAKE_START_MARKER}' and '{CMAKE_END_MARKER}'.")
+        return
+
+    # --- 3. Extract the lines before, during, and after the block ---
+    lines_before = lines[:start_index + 1]
+    block_lines = lines[start_index + 1 : end_index]
+    lines_after = lines[end_index:]
+
+    # --- 4. Parse the existing rules within the block ---
+    rules = []
+    # Regex to find: if(CONFIG_NAME) ... add_subdirectory(subdir) ... endif()
+    # This is robust against extra whitespace and blank lines.
+    block_content = "".join(block_lines)
+    pattern = re.compile(
+        r"if\s*\((?P<kconfig>CONFIG_[A-Z0-9_]+)\)\s*"
+        r"add_subdirectory\s*\((?P<subdir>[a-zA-Z0-9_]+)\)\s*"
+        r"endif\(\)",
+        re.DOTALL
+    )
+
+    for match in pattern.finditer(block_content):
+        rules.append(match.groupdict())
+
+    # --- 5. Check if the rule already exists ---
+    if any(rule['kconfig'] == kconfig_option for rule in rules):
+        print(f"[INFO] Rule for '{kconfig_option}' already exists. No changes made.")
+        return
+
+    # --- 6. Add the new rule and sort alphabetically ---
+    rules.append({'kconfig': kconfig_option, 'subdir': subdir_name})
+    rules.sort(key=lambda r: r['kconfig'])
+    print(f"Adding rule for '{kconfig_option}' -> '{subdir_name}' and re-sorting.")
+
+    # --- 7. Rebuild the block content from the sorted rules ---
+    new_block_lines = []
+    for i, rule in enumerate(rules):
+        new_block_lines.append(f"\tif({rule['kconfig']})\n")
+        new_block_lines.append(f"\t\tadd_subdirectory({rule['subdir']})\n")
+        new_block_lines.append("\tendif()\n")
+
+    # --- 8. Assemble the new file content and write it back ---
+    new_content = "".join(lines_before + new_block_lines + lines_after)
+    with open(filepath, 'w', encoding='utf-8') as f:
+        f.write(new_content)
+
+    print(f"Successfully updated '{filepath}'.")
+
+# ======================================================================================
+#
+# Title:          add_kconfig_source.py
+# Description:    A script to insert a new 'rsource' entry into a Kconfig file.
+#                 The script maintains alphabetical order of the Kconfig options
+#                 within a specially marked, managed block.
+#
+# Usage:          python3 add_kconfig_source.py <path_to_kconfig> <KCONFIG_OPTION> <path_to_source_kconfig>
+#
+# Arguments:
+#   path_to_kconfig:        The full path to the main Kconfig file to be edited.
+#   KCONFIG_OPTION:         The Kconfig boolean (e.g., CONFIG_USE_ADC_DRIVER).
+#   path_to_source_kconfig: The path to the Kconfig file to be sourced,
+#                           typically relative (e.g., "drivers/adc/Kconfig").
+#
+# Example:
+#   python3 add_kconfig_source.py project/Kconfig CONFIG_USE_GPIO_DRIVER "drivers/gpio/Kconfig"
+#
+# Pre-requisite:
+#   The target Kconfig file must contain a managed block, like this:
+#
+#   # --- Kconfig Sources (Managed by script) ---
+#   # (Content is managed here)
+#   # --- End Kconfig Sources ---
+#
+# ======================================================================================
+
+# Define the markers for the managed block in the Kconfig file.
+KCONFIG_START_MARKER = "# --- Kconfig Sources (alphabetical order) ---"
+KCONFIG_END_MARKER = "# --- End Kconfig Sources (alphabetical order) ---"
+
+def insert_kconfig_source(filepath: str, source_path: str):
+    """
+    Reads a Kconfig file, adds a new rsource rule, and writes it back.
+
+    Args:
+        filepath (str): Path to the Kconfig file.
+        source_path (str): The path to the Kconfig file to be sourced.
+    """
+    if not os.path.exists(filepath):
+        print(f"[ERROR] File not found at: '{filepath}'")
+        return
+
+    # --- 1. Read the entire file content ---
+    try:
+        with open(filepath, 'r', encoding='utf-8') as f:
+            lines = f.readlines()
+    except Exception as e:
+        print(f"[ERROR] Could not read file: {e}")
+        return
+
+    # --- 2. Find the start and end of the managed block ---
+    try:
+        start_index = lines.index(KCONFIG_START_MARKER + '\n')
+        end_index = lines.index(KCONFIG_END_MARKER + '\n')
+    except ValueError:
+        print(f"[ERROR] Could not find the required marker blocks in '{filepath}'.")
+        print(f"Please ensure the file contains both '{KCONFIG_START_MARKER}' and '{KCONFIG_END_MARKER}'.")
+        return
+
+    # --- 3. Extract the lines before, during, and after the block ---
+    lines_before = lines[:start_index + 1]
+    block_lines = lines[start_index + 1 : end_index]
+    lines_after = lines[end_index:]
+
+    # --- 4. Parse the existing rsource rules within the block ---
+    source_paths = []
+    # Regex to find: rsource "path/to/file"
+    pattern = re.compile(r'rsource\s+"(?P<path>.*?)"')
+
+    for line in block_lines:
+        match = pattern.search(line)
+        if match:
+            source_paths.append(match.group('path'))
+
+    # --- 5. Check if the source path already exists ---
+    if source_path in source_paths:
+        print(f"[INFO] Source path '{source_path}' already exists. No changes made.")
+        return
+
+    # --- 6. Add the new path and sort alphabetically ---
+    source_paths.append(source_path)
+    source_paths.sort()
+    print(f"Adding source '{source_path}' and re-sorting.")
+
+    # --- 7. Rebuild the block content from the sorted paths ---
+    new_block_lines = []
+    for path in source_paths:
+        new_block_lines.append(f'rsource "{path}"\n')
+
+    # --- 8. Assemble the new file content and write it back ---
+    new_content = "".join(lines_before + new_block_lines + lines_after)
+    with open(filepath, 'w', encoding='utf-8') as f:
+        f.write(new_content)
+
+    print(f"Successfully updated '{filepath}'.")
+
+
+# ======================================================================================
+#
+# Title:          create_c_module.py
+# Description:    A script to create a new C module by copying a template
+#                 directory. It renames the directory, renames files within it,
+#                 and replaces all occurrences of the template name inside
+#                 the relevant C source and header files.
+#
+# Usage:          python3 create_c_module.py <modules_root_dir> <template_name> <new_module_name>
+#
+# Arguments:
+#   modules_root_dir: The top-level directory where all modules are stored.
+#   template_name:    The name of the template directory to be copied.
+#   new_module_name:  The name for the new module.
+#
+# Example:
+#   # Creates a new module 'adc_driver' from the 'template' module
+#   # located in the 'src/drivers' directory.
+#   python3 create_c_module.py src/drivers template adc_driver
+#
+# To run with command-line arguments:
+# python3 insert_sorted_uuid.py data/users.txt "My Name"
+#
+# ======================================================================================
+
+def main():
+    """
+    Main function to drive the script logic.
+    """
+    print("--- C Module Creator ---")
+
+    # Argument Validation ---
+    if len(sys.argv) != 7:
+        print("\n[ERROR] Invalid number of arguments.")
+        print("Usage: python3 create_c_module.py <modules_root_dir> <template_name> <new_module_name> uuid")
+        sys.exit(1)
+
+    modules_root = sys.argv[1]
+    template_name = sys.argv[2]
+    new_module_name = sys.argv[3]
+    uuid_file = sys.argv[4]
+    cmake_file = sys.argv[5]
+    kconfig_file = sys.argv[6]
+
+    template_dir = os.path.join(modules_root, template_name)
+    new_module_dir = os.path.join(modules_root, new_module_name)
+
+    print(f"\nConfiguration:")
+    print(f"  - Modules Root:   '{modules_root}'")
+    print(f"  - Template Name:  '{template_name}'")
+    print(f"  - New Module Name:'{new_module_name}'")
+    print(f"  - UUID file:      '{uuid_file}'")
+    print(f"  - Cmake file:    '{cmake_file}'")
+    print(f"  - Kconfig file:  '{kconfig_file}'")
+
+    # Check for Pre-existing Directories ---
+    if not os.path.isdir(template_dir):
+        print(f"\n[ERROR] Template directory not found at: '{template_dir}'")
+        sys.exit(1)
+
+    if os.path.exists(new_module_dir):
+        print(f"\n[ERROR] A directory with the new module name already exists: '{new_module_dir}'")
+        sys.exit(1)
+
+    # Copy Template Directory ---
+    try:
+        print(f"\n[1/6] Copying template directory...")
+        shutil.copytree(template_dir, new_module_dir)
+        print(f"  -> Successfully copied to '{new_module_dir}'")
+    except OSError as e:
+        print(f"\n[ERROR] Could not copy directory. Reason: {e}")
+        sys.exit(1)
+
+    # Rename Files and Replace Content ---
+    # We walk through the newly created directory.
+    print(f"\n[2/6] Renaming files and replacing content...")
+    process_directory(new_module_dir, template_name, new_module_name)
+
+    # Generate UUID for the new module ---
+    print("\n[3/6] Generating UUID for module...")
+    insert_uuid_name(uuid_file, new_module_name)
+
+    # Add CMake rule for new module ---
+    print("\n[4/6] Module creation process finished successfully!")
+    kconfig_option = f"CONFIG_COMP_{new_module_name.upper()}"
+    print(f"  -> Adding CMake rule for '{kconfig_option}'")
+    insert_cmake_rule(cmake_file, kconfig_option, new_module_name)
+
+    # Add Kconfig rsource for new module
+    print("\n[5/6] Module creation process finished successfully!")
+    insert_kconfig_source(kconfig_file, f"{new_module_name}/Kconfig")
+
+    print("\n[6/6] Module creation process finished successfully!")
+    print("--- Done ---")
+
+if __name__ == "__main__":
+    main()
+