Function run_evolution

api.py:36–61

Run evolution with flexible inputs - this is the main library API. Args: initial_program: Can be a path to a program file, the program code as a string, or a list of code lines. evaluator: Can be a path to an evaluator file or a Python callable that takes a program_path and

(
    initial_program: Union[str, Path, List[str]],
    evaluator: Union[str, Path, Callable],
    config: Union[str, Path, Config, None] = None,
    iterations: Optional[int] = None,
    output_dir: Optional[str] = None,
    cleanup: bool = True,
)

def run_evolution(
    initial_program: Union[str, Path, List[str]],
    evaluator: Union[str, Path, Callable],
    config: Union[str, Path, Config, None] = None,
    iterations: Optional[int] = None,
    output_dir: Optional[str] = None,
    cleanup: bool = True,
) -> EvolutionResult:
    """
    Run evolution with flexible inputs - this is the main library API.

    Args:
        initial_program: Can be a path to a program file, the program code as a string, or a list of code lines.
        evaluator: Can be a path to an evaluator file or a Python callable that takes a program_path and returns a metrics dict.
        config: Can be a path to a config YAML file, a Config object, or None to use defaults.
        iterations: Number of iterations to run (overrides the value in the config).
        output_dir: Directory to save outputs (a temporary directory is used if None).
        cleanup: If True, temporary files and directories created during the run will be deleted.

    Returns:
        An EvolutionResult object containing the best program and its metrics.
    """
    # Use asyncio.run to execute the asynchronous implementation of the evolution process.
    return asyncio.run(
        _run_evolution_async(initial_program, evaluator, config, iterations, output_dir, cleanup)
    )


async def _run_evolution_async(