# 21.06.24

import os
import inspect


def get_call_stack():
    """
    Retrieves the current call stack with details about each call.

    This function inspects the current call stack and returns a list of dictionaries,
    where each dictionary contains details about a function call in the stack.

    Returns:
        list: A list of dictionaries, each containing the following keys:
            - function (str): The name of the function.
            - folder (str): The directory path of the script containing the function.
            - folder_base (str): The base name of the directory path.
            - script (str): The name of the script file containing the function.
            - line (int): The line number in the script where the function is defined.
    """
    
    stack = inspect.stack()
    call_stack = []

    for frame_info in stack:
        function_name = frame_info.function
        filename = frame_info.filename
        lineno = frame_info.lineno
        folder_name = os.path.dirname(filename)
        folder_base = os.path.basename(folder_name)
        script_name = os.path.basename(filename)

        call_stack.append({
            "function": function_name,
            "folder": folder_name,
            "folder_base": folder_base,
            "script": script_name,
            "line": lineno
        })
        
    return call_stack