Function _prepare_program

api.py:172–206

Helper function to convert the flexible 'initial_program' input into a file path.

(
    initial_program: Union[str, Path, List[str]], temp_dir: Optional[str], temp_files: List[str]
)

def _prepare_program(
    initial_program: Union[str, Path, List[str]], temp_dir: Optional[str], temp_files: List[str]
) -> str:
    """Helper function to convert the flexible 'initial_program' input into a file path."""

    # If the input is already a path to an existing file, use it directly.
    if isinstance(initial_program, (str, Path)):
        if os.path.exists(str(initial_program)):
            return str(initial_program)

    # If it's not a path, treat it as code content.
    if isinstance(initial_program, list):
        # Join a list of lines into a single string.
        code = "\n".join(initial_program)
    else:
        # It's already a string.
        code = str(initial_program)

    # Ensure the code has evolution markers. If not, wrap the entire code in them.
    if "EVOLVE-BLOCK-START" not in code:
        code = f"""# EVOLVE-BLOCK-START
{code}
# EVOLVE-BLOCK-END"""

    # Write the code to a temporary file.
    if temp_dir is None:
        temp_dir = tempfile.gettempdir()

    program_file = os.path.join(temp_dir, f"program_{uuid.uuid4().hex[:8]}.py")
    with open(program_file, "w") as f:
        f.write(code)
    # Keep track of the temporary file for later cleanup.
    temp_files.append(program_file)

    return program_file


def _prepare_evaluator(