build_tools/python/e2e_test_artifacts/iree_artifacts.py

## Copyright 2022 The IREE Authors
#
# Licensed under the Apache License v2.0 with LLVM Exceptions.
# See https://llvm.org/LICENSE.txt for license information.
# SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
"""Helpers that generate paths for IREE artifacts."""

from typing import Dict, Iterable
import pathlib

from e2e_test_artifacts import model_artifacts, utils
from e2e_test_framework.definitions import common_definitions, iree_definitions

IREE_ARTIFACT_PREFIX = "iree"
MODULE_FILENAME = "module.vmfb"
SCHEDULING_STATS_FILENAME = "scheduling_stats.json"


def get_imported_model_path(
    imported_model: iree_definitions.ImportedModel,
    root_path: pathlib.PurePath = pathlib.PurePath(),
) -> pathlib.PurePath:
    """Returns the path of an IREE imported MLIR model. If the source model is
    in MLIR format, returns the path of source model.

    Args:
      imported_model: IREE model importing config.
      root_path: path of the root artifact directory, on which the returned path
        will base.
    Returns:
      Path of the imported model file.
    """
    model = imported_model.model
    if model.source_type in [
        common_definitions.ModelSourceType.EXPORTED_LINALG_MLIR,
        common_definitions.ModelSourceType.EXPORTED_STABLEHLO_MLIR,
    ]:
        # Uses the MLIR model directly.
        return model_artifacts.get_model_path(model=model, root_path=root_path)

    # Imported model path: <root_path>/<iree_artifact_prefix>_<imported_model_name>.mlir
    filename = utils.get_safe_name(f"{IREE_ARTIFACT_PREFIX}_{imported_model.name}.mlir")
    return root_path / filename


def get_module_dir_path(
    module_generation_config: iree_definitions.ModuleGenerationConfig,
    root_path: pathlib.PurePath = pathlib.PurePath(),
) -> pathlib.PurePath:
    """Returns the path of an IREE module directory, which contains the compiled
    module and related flag files.

    Args:
      module_generation_config: IREE module generation config.
      root_path: path of the root artifact directory, on which the returned path
        will base.
    Returns:
      Path of the module directory.
    """
    # Module dir path: <root_path>/<iree_artifact_prefix>_module_<gen_config_name>
    filename = utils.get_safe_name(
        f"{IREE_ARTIFACT_PREFIX}_module_{module_generation_config.name}"
    )
    return root_path / filename


def get_dependent_model_map(
    module_generation_configs: Iterable[iree_definitions.ModuleGenerationConfig],
) -> Dict[str, common_definitions.Model]:
    """Returns an ordered map of the dependent models keyed by model id."""
    return dict(
        (config.imported_model.model.id, config.imported_model.model)
        for config in module_generation_configs
    )