def upgrade_info(output_file):
    """
    Appends the upgrade information single-source to the end of the new release notes.

    Args:
        output_file (str): Path to the file to append.

    Returns:
        None
    """
    include_directive = "\n\n{{< include /releases/_how-to-upgrade.qmd >}}\n"

    try:
        with open(output_file, "a") as file:
            file.write(include_directive)
            print(f"Include _how-to-upgrade.qmd added to {file.name}.")
    except Exception as e:
        print(f"Failed to include _how-to-upgrade.qmd to {output_file}: {e}")

def update_index_qmd(release_date):
    """Updates the index.qmd file to include the new releases in `Latest Releases` and removes the oldest release from the list.

    Params:
        release_date - release notes use the release date as the file name.
    
    Modifies:
        index.qmd file
    """

    index_filename = "../site/index.qmd"
    temp_index_filename = "../site/index_temp.qmd"

    # Copy the original QMD file to a temporary file
    shutil.copyfile(index_filename, temp_index_filename)

    with open(temp_index_filename, 'r') as file:
        lines = file.readlines()

    # Format the release date for insertion into the QMD file
    formatted_release_date = release_date.strftime("%Y-%b-%d").lower()

    with open(index_filename, 'w') as file:
        add_release_content = False
        insert_index = -1

        for i, line in enumerate(lines):
            file.write(line)
            if line.strip() == "# MAKE-RELEASE-NOTES-LATEST-MARKER":
                add_release_content = True
                insert_index = i

            if add_release_content and i == insert_index:
                file.write(f'      - /releases/{formatted_release_date}/release-notes.qmd\n')
                add_release_content = False

    # Remove the temporary file
    os.remove(temp_index_filename)
    
    print(f"Added new release notes to index.qmd, line {insert_index + 2}")

    removed_line = None  # To store the line that gets removed

    with open(index_filename, 'r') as file:
        updated_lines = file.readlines()

    with open(index_filename, 'w') as file:
        for i, line in enumerate(updated_lines):
            # Identify the marker line
            if line.strip() == "# MAKE-RELEASE-NOTES-OLDEST-MARKER":
                # Check if the line above exists and starts with a list indicator "-"
                if i > 0 and updated_lines[i - 1].strip().startswith("-"):
                    # Store the line being removed
                    removed_line = updated_lines[i - 1].strip()
                    # Write all lines up to the one before the line to remove
                    file.writelines(updated_lines[:i - 1])
                    # Write the marker and subsequent lines
                    file.writelines(updated_lines[i:])
                    break
        else:
            # If no marker is found, rewrite the file as is
            file.writelines(updated_lines)

    print(f"Removed the oldest release note entry: '{removed_line}'")

def show_files():
    """Print files to commit by running 'git status --short'."""
    try:
        # Get the absolute path of the current directory
        current_dir = os.getcwd()

        # Run 'git status --short'
        result = subprocess.run(
            ["git", "status", "--short"], check=True, text=True, capture_output=True
        )
        
        # Process and display the output
        lines = result.stdout.strip().split('\n')

        if not lines:
            print("No changes detected.")
            return

        print("\nFiles to commit (excluding 'release-scripts'):")
        for line in lines:
            # Get the full path of the file
            parts = line.split()
            if len(parts) > 1:
                file_path = os.path.abspath(parts[-1])
            else:
                continue

            # Exclude files in the 'release-scripts' folder
            if 'release-scripts' not in file_path and line.startswith((' M', '??', 'A ')):
                print(line)

    except subprocess.CalledProcessError as e:
        print("Failed to run 'git status':", e)