# Part of the LLVM Project, 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 """ Frontend to the compiler, allowing various ways to import code. """ import ast import inspect from typing import Optional from _npcomp.mlir import ir from _npcomp.mlir.dialect import ScfDialectHelper from npcomp.dialect import Numpy from . import logging from .environment import * from .importer import * from .target import * __all__ = [ "ImportFrontend", ] class ImportFrontend: """Frontend for importing various entities into a Module.""" __slots__ = [ "_ir_context", "_ir_module", "_helper", "_target_factory", "_value_coder", "_partial_eval_hook", ] def __init__(self, ir_context: ir.MLIRContext = None, *, target_factory: TargetFactory = GenericTarget64, value_coder: Optional[ValueCoder] = None, partial_eval_hook: Optional[PartialEvalHook] = None): self._ir_context = ir.MLIRContext() if not ir_context else ir_context self._ir_module = self._ir_context.new_module() self._helper = AllDialectHelper(self._ir_context, ir.OpBuilder(self._ir_context)) self._target_factory = target_factory self._value_coder = value_coder if value_coder else BuiltinsValueCoder() self._partial_eval_hook = (partial_eval_hook if partial_eval_hook else build_default_partial_eval_hook()) @property def ir_context(self): return self._ir_context @property def ir_module(self): return self._ir_module @property def ir_h(self): return self._helper @property def partial_eval_hook(self): return self._partial_eval_hook def import_global_function(self, f): """Imports a global function. This facility is not general and does not allow customization of the containing environment, method import, etc. Most errors are emitted via the MLIR context's diagnostic infrastructure, but errors related to extracting source, etc are raised directly. Args: f: The python callable. """ h = self.ir_h ir_c = self.ir_context ir_m = self.ir_module target = self._target_factory(h) filename = inspect.getsourcefile(f) source_lines, start_lineno = inspect.getsourcelines(f) source = "".join(source_lines) ast_root = ast.parse(source, filename=filename) ast.increment_lineno(ast_root, start_lineno - 1) ast_fd = ast_root.body[0] filename_ident = ir_c.identifier(filename) # Define the function. # TODO: Much more needs to be done here (arg/result mapping, etc) logging.debug(":::::::") logging.debug("::: Importing global function {}:\n{}", ast_fd.name, ast.dump(ast_fd, include_attributes=True)) # TODO: VERY BAD: Assumes all positional params. f_signature = inspect.signature(f) f_params = f_signature.parameters f_input_types = [ self._resolve_signature_annotation(target, p.annotation) for p in f_params.values() ] f_return_type = self._resolve_signature_annotation( target, f_signature.return_annotation) ir_f_type = h.function_type(f_input_types, [f_return_type]) h.builder.set_file_line_col(filename_ident, ast_fd.lineno, ast_fd.col_offset) h.builder.insert_before_terminator(ir_m.first_block) # TODO: Do not hardcode this IREE attribute. attrs = ir_c.dictionary_attr({"iree.module.export": ir_c.unit_attr}) ir_f = h.func_op(ast_fd.name, ir_f_type, create_entry_block=True, attrs=attrs) env = Environment.for_const_global_function( h, f, parameter_bindings=zip(f_params.keys(), ir_f.first_block.args), value_coder=self._value_coder, target=target, partial_eval_hook=self._partial_eval_hook) fctx = FunctionContext(ir_c=ir_c, ir_f=ir_f, ir_h=h, filename_ident=filename_ident, target=target, environment=env) fdimport = FunctionDefImporter(fctx, ast_fd) fdimport.import_body() return ir_f def _resolve_signature_annotation(self, target: Target, annot): ir_h = self._helper if annot is inspect.Signature.empty: return ir_h.basicpy_UnknownType # TODO: Do something real here once we need more than the primitive types. if annot is int: return target.impl_int_type elif annot is float: return target.impl_float_type elif annot is bool: return ir_h.basicpy_BoolType elif annot is str: return ir_h.basicpy_StrType else: return ir_h.basicpy_UnknownType ################################################################################ # Support ################################################################################ # TODO: Remove this hack in favor of a helper function that combines # multiple dialect helpers so that we don't need to deal with the sharp # edge of initializing multiple native base classes. class AllDialectHelper(Numpy.DialectHelper, ScfDialectHelper): def __init__(self, *args, **kwargs): Numpy.DialectHelper.__init__(self, *args, **kwargs) ScfDialectHelper.__init__(self, *args, **kwargs) def build_default_partial_eval_hook() -> PartialEvalHook: mr = PartialEvalHook() ### Modules mr.enable_getattr(for_type=ast.__class__) # The module we use is arbitrary. ### Tuples # Enable attribute resolution on tuple, which includes namedtuple (which is # really what we want). mr.enable_getattr(for_type=tuple) return mr