compiler/src/iree/compiler/Utils/ModuleUtils.h

// Copyright 2021 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

#ifndef IREE_COMPILER_UTILS_MODULEUTILS_H_
#define IREE_COMPILER_UTILS_MODULEUTILS_H_

#include "mlir/IR/Builders.h"
#include "mlir/IR/BuiltinOps.h"
#include "mlir/IR/Operation.h"

namespace mlir::iree_compiler {

// Finds the first file location in |baseLoc|, if one exists.
// This will traverse FusedLoc, CallSiteLoc, and NameLoc locations as needed.
std::optional<FileLineColLoc> findFirstFileLoc(Location baseLoc);

// Guesses the name of the module from the source locations attached unless a
// name is already specified. If no source locations are found then
// |defaultName| is returned.
std::string guessModuleName(mlir::ModuleOp moduleOp, StringRef defaultName);

// Destructively merges |sourceOp| into |targetOp| using |targetBuilder|.
//
// If a private symbol in |sourceOp| conflicts with another symbol
// (public or private) in |targetOp|, it will be renamed.
//
// Fails if a public symbol in the |sourceOp| conflicts with another public
// symbol in the |targetOp|.
LogicalResult mergeModuleInto(Operation *sourceOp, Operation *targetOp,
                              OpBuilder &targetBuilder);

// Merges an MLIR module text in |source| into the |targetOp| using
// |targetBuilder|. See mergeModuleInto for details on symbol renaming.
LogicalResult mergeSourceModuleInto(Location loc, StringRef source,
                                    Operation *targetOp,
                                    OpBuilder &targetBuilder);

} // namespace mlir::iree_compiler

#endif // IREE_COMPILER_UTILS_MODULEUTILS_H_