__init__.py

Go to the documentation of this file.

"""Python initialization path for PineForge HPO."""
 
from importlib import metadata
from pathlib import Path
 
from .artifact import (
    ArtifactBuildError,
    ArtifactBuilder,
    CANONICAL_COMPILE_FLAGS,
    StrategyArtifact,
    build_strategy_artifact,
)
from .study_spec import (
    DatasetSpec,
    ExecutionSpec,
    ObjectiveSpec,
    ParameterSpec,
    SamplerSpec,
    StrategySpec,
    StudySpec,
    StudySpecError,
    TpeSamplerConfig,
    ValidationIssue,
    load_study_spec,
)
from .transpile import (
    CodegenIdentity,
    TranspileDiagnostic,
    TranspileFailure,
    TranspileResult,
    codegen_identity,
    transpile_source,
)
 
from .error import HpoError
 
 
 
 
 
 
 
 
 
 
 
 
 
__version__ = _distribution_version()
 
 
def prepare_run(
    study_path, engine_root=None, cache_dir=None, *, wrapper_launched=False, **options
):
    """Return native argv and artifact JSON; do not launch the native process.
 
    Optional keyword arguments are native, compiler, and eigen_include, matching
    the existing CLI build/executable overrides. Explicit wrapper_launched=True
    requires the wrapper codegen policy and refuses prebuilt/cache bypasses.
    """
    from .cli import prepare_run as prepare
 
    return prepare(
        study_path, engine_root, cache_dir, wrapper_launched=wrapper_launched, **options
    )