#![deny( future_incompatible, let_underscore, nonstandard_style, rust_2024_compatibility, clippy::all )] #![warn(clippy::pedantic)] #![allow( unsafe_op_in_unsafe_fn, clippy::cast_possible_truncation, clippy::cast_sign_loss, clippy::enum_glob_use, clippy::similar_names, clippy::too_many_lines, clippy::wildcard_imports )] use std::collections::{HashMap, HashSet}; use std::fs; use std::io::Write; use std::process::Command; use std::rc::Rc; use std::sync::Arc; use itertools::Itertools; use nac3core::codegen::{gen_func_impl, CodeGenLLVMOptions, CodeGenTargetMachineOptions}; use nac3core::inkwell::{ context::Context, memory_buffer::MemoryBuffer, module::{Linkage, Module}, passes::PassBuilderOptions, support::is_multithreaded, targets::*, OptimizationLevel, }; use nac3core::nac3parser::{ ast::{ExprKind, Stmt, StmtKind, StrRef}, parser::parse_program, }; use nac3core::toplevel::builtins::get_exn_constructor; use nac3core::typecheck::typedef::{into_var_map, TypeEnum, Unifier, VarMap}; use pyo3::{ create_exception, exceptions, prelude::*, types::{PyBytes, PyDict, PySet}, }; use parking_lot::{Mutex, RwLock}; use nac3core::{ codegen::irrt::load_irrt, codegen::{concrete_type::ConcreteTypeStore, CodeGenTask, WithCall, WorkerRegistry}, symbol_resolver::SymbolResolver, toplevel::{ composer::{BuiltinFuncCreator, BuiltinFuncSpec, ComposerConfig, TopLevelComposer}, DefinitionId, GenCall, TopLevelDef, }, typecheck::typedef::{FunSignature, FuncArg}, typecheck::{type_inferencer::PrimitiveStore, typedef::Type}, }; use nac3ld::Linker; use crate::{ codegen::{ attributes_writeback, gen_core_log, gen_rtio_log, rpc_codegen_callback, ArtiqCodeGenerator, }, symbol_resolver::{DeferredEvaluationStore, InnerResolver, PythonHelper, Resolver}, }; use tempfile::{self, TempDir}; mod codegen; mod symbol_resolver; mod timeline; use timeline::TimeFns; #[derive(PartialEq, Clone, Copy)] enum Isa { Host, RiscV32G, RiscV32IMA, CortexA9, } impl Isa { /// Returns the number of bits in `size_t` for the [`Isa`]. fn get_size_type(self) -> u32 { if self == Isa::Host { 64u32 } else { 32u32 } } } #[derive(Clone)] pub struct PrimitivePythonId { int: u64, int32: u64, int64: u64, uint32: u64, uint64: u64, float: u64, float64: u64, bool: u64, np_bool_: u64, string: u64, np_str_: u64, list: u64, ndarray: u64, tuple: u64, typevar: u64, const_generic_marker: u64, none: u64, exception: u64, generic_alias: (u64, u64), virtual_id: u64, option: u64, } type TopLevelComponent = (Stmt, String, PyObject); // TopLevelComposer is unsendable as it holds the unification table, which is // unsendable due to Rc. Arc would cause a performance hit. #[pyclass(unsendable, name = "NAC3")] struct Nac3 { isa: Isa, time_fns: &'static (dyn TimeFns + Sync), primitive: PrimitiveStore, builtins: Vec, pyid_to_def: Arc>>, primitive_ids: PrimitivePythonId, working_directory: TempDir, top_levels: Vec, string_store: Arc>>, exception_ids: Arc>>, deferred_eval_store: DeferredEvaluationStore, /// LLVM-related options for code generation. llvm_options: CodeGenLLVMOptions, } create_exception!(nac3artiq, CompileError, exceptions::PyException); impl Nac3 { fn register_module( &mut self, module: &PyObject, registered_class_ids: &HashSet, ) -> PyResult<()> { let (module_name, source_file) = Python::with_gil(|py| -> PyResult<(String, String)> { let module = module.bind_borrowed(py); Ok((module.getattr("__name__")?.extract()?, module.getattr("__file__")?.extract()?)) })?; let source = fs::read_to_string(&source_file).map_err(|e| { exceptions::PyIOError::new_err(format!("failed to read input file: {e}")) })?; let parser_result = parse_program(&source, source_file.into()) .map_err(|e| exceptions::PySyntaxError::new_err(format!("parse error: {e}")))?; for mut stmt in parser_result { let include = match stmt.node { StmtKind::ClassDef { ref decorator_list, ref mut body, ref mut bases, .. } => { let nac3_class = decorator_list.iter().any(|decorator| { if let ExprKind::Name { id, .. } = decorator.node { id.to_string() == "nac3" } else { false } }); if !nac3_class { continue; } // Drop unregistered (i.e. host-only) base classes. bases.retain(|base| { Python::with_gil(|py| -> PyResult { let module = module.bind_borrowed(py); let id_fn = PyModule::import_bound(py, "builtins")?.getattr("id")?; match &base.node { ExprKind::Name { id, .. } => { if *id == "Exception".into() { Ok(true) } else { let base_obj = module.getattr(id.to_string().as_str())?; let base_id = id_fn.call1((base_obj,))?.extract()?; Ok(registered_class_ids.contains(&base_id)) } } _ => Ok(true), } }) .unwrap() }); body.retain(|stmt| { if let StmtKind::FunctionDef { ref decorator_list, .. } = stmt.node { decorator_list.iter().any(|decorator| { if let ExprKind::Name { id, .. } = decorator.node { id.to_string() == "kernel" || id.to_string() == "portable" || id.to_string() == "rpc" } else { false } }) } else { true } }); true } StmtKind::FunctionDef { ref decorator_list, .. } => { decorator_list.iter().any(|decorator| { if let ExprKind::Name { id, .. } = decorator.node { let id = id.to_string(); id == "extern" || id == "portable" || id == "kernel" || id == "rpc" } else { false } }) } _ => false, }; if include { self.top_levels.push((stmt, module_name.clone(), module.clone())); } } Ok(()) } fn report_modinit( arg_names: &[String], method_name: &str, resolver: &Arc, top_level_defs: &[Arc>], unifier: &mut Unifier, primitives: &PrimitiveStore, ) -> Option { let base_ty = match resolver.get_symbol_type(unifier, top_level_defs, primitives, "base".into()) { Ok(ty) => ty, Err(e) => return Some(format!("type error inside object launching kernel: {e}")), }; let fun_ty = if method_name.is_empty() { base_ty } else if let TypeEnum::TObj { fields, .. } = &*unifier.get_ty(base_ty) { match fields.get(&(*method_name).into()) { Some(t) => t.0, None => { return Some(format!( "object launching kernel does not have method `{method_name}`" )) } } } else { return Some("cannot launch kernel by calling a non-callable".into()); }; if let TypeEnum::TFunc(FunSignature { args, .. }) = &*unifier.get_ty(fun_ty) { if arg_names.len() > args.len() { return Some(format!( "launching kernel function with too many arguments (expect {}, found {})", args.len(), arg_names.len(), )); } for (i, FuncArg { ty, default_value, name, .. }) in args.iter().enumerate() { let in_name = match arg_names.get(i) { Some(n) => n, None if default_value.is_none() => { return Some(format!( "argument `{name}` not provided when launching kernel function" )) } _ => break, }; let in_ty = match resolver.get_symbol_type( unifier, top_level_defs, primitives, in_name.clone().into(), ) { Ok(t) => t, Err(e) => { return Some(format!( "type error ({e}) at parameter #{i} when calling kernel function" )) } }; if let Err(e) = unifier.unify(in_ty, *ty) { return Some(format!( "type error ({}) at parameter #{i} when calling kernel function", e.to_display(unifier), )); } } } else { return Some("cannot launch kernel by calling a non-callable".into()); } None } /// Returns a [`Vec`] of builtins that needs to be initialized during method compilation time. fn get_lateinit_builtins() -> Vec> { vec![ Box::new(|primitives, unifier| { let arg_ty = unifier.get_fresh_var(Some("T".into()), None); ( "core_log".into(), FunSignature { args: vec![FuncArg { name: "arg".into(), ty: arg_ty.ty, default_value: None, is_vararg: false, }], ret: primitives.none, vars: into_var_map([arg_ty]), }, Arc::new(GenCall::new(Box::new(move |ctx, obj, fun, args, generator| { gen_core_log(ctx, &obj, fun, &args, generator)?; Ok(None) }))), ) }), Box::new(|primitives, unifier| { let arg_ty = unifier.get_fresh_var(Some("T".into()), None); ( "rtio_log".into(), FunSignature { args: vec![ FuncArg { name: "channel".into(), ty: primitives.str, default_value: None, is_vararg: false, }, FuncArg { name: "arg".into(), ty: arg_ty.ty, default_value: None, is_vararg: false, }, ], ret: primitives.none, vars: into_var_map([arg_ty]), }, Arc::new(GenCall::new(Box::new(move |ctx, obj, fun, args, generator| { gen_rtio_log(ctx, &obj, fun, &args, generator)?; Ok(None) }))), ) }), ] } fn compile_method( &self, obj: &Bound, method_name: &str, args: Vec>, embedding_map: &Bound, py: Python, link_fn: &dyn Fn(&Module) -> PyResult, ) -> PyResult { let size_t = self.isa.get_size_type(); let (mut composer, mut builtins_def, mut builtins_ty) = TopLevelComposer::new( self.builtins.clone(), Self::get_lateinit_builtins(), ComposerConfig { kernel_ann: Some("Kernel"), kernel_invariant_ann: "KernelInvariant" }, size_t, ); let builtins = PyModule::import_bound(py, "builtins")?; let typings = PyModule::import_bound(py, "typing")?; let id_fn = builtins.getattr("id")?; let issubclass = builtins.getattr("issubclass")?; let exn_class = builtins.getattr("Exception")?; let store_obj = embedding_map.getattr("store_object").unwrap().to_object(py); let store_str = embedding_map.getattr("store_str").unwrap().to_object(py); let store_fun = embedding_map.getattr("store_function").unwrap().to_object(py); let host_attributes = embedding_map.getattr("attributes_writeback").unwrap().to_object(py); let global_value_ids: Arc>> = Arc::new(RwLock::new(HashMap::new())); let helper = PythonHelper { id_fn: builtins.getattr("id").unwrap().to_object(py), len_fn: builtins.getattr("len").unwrap().to_object(py), type_fn: builtins.getattr("type").unwrap().to_object(py), origin_ty_fn: typings.getattr("get_origin").unwrap().to_object(py), args_ty_fn: typings.getattr("get_args").unwrap().to_object(py), store_obj: store_obj.clone(), store_str, }; let pyid_to_type = Arc::new(RwLock::new(HashMap::::new())); let exception_names = [ "ZeroDivisionError", "IndexError", "ValueError", "RuntimeError", "AssertionError", "KeyError", "NotImplementedError", "OverflowError", "IOError", "UnwrapNoneError", ]; add_exceptions(&mut composer, &mut builtins_def, &mut builtins_ty, &exception_names); let mut module_to_resolver_cache: HashMap = HashMap::new(); let mut rpc_ids = vec![]; for (stmt, path, module) in &self.top_levels { let py_module = module.bind_borrowed(py); let module_id: u64 = id_fn.call1((py_module,))?.extract()?; let helper = helper.clone(); let class_obj; if let StmtKind::ClassDef { name, .. } = &stmt.node { let class = py_module.getattr(name.to_string().as_str()).unwrap(); if issubclass .call1((class.as_borrowed(), exn_class.as_borrowed())) .unwrap() .extract() .unwrap() && class.getattr("artiq_builtin").is_err() { class_obj = Some(class); } else { class_obj = None; } } else { class_obj = None; } let (name_to_pyid, resolver) = module_to_resolver_cache.get(&module_id).cloned().unwrap_or_else(|| { let mut name_to_pyid: HashMap = HashMap::new(); let members = py_module.getattr("__dict__").unwrap(); let members = members.downcast::().unwrap(); for (key, val) in members { let key: &str = key.extract().unwrap(); let val = id_fn.call1((val,)).unwrap().extract().unwrap(); name_to_pyid.insert(key.into(), val); } let resolver = Arc::new(Resolver(Arc::new(InnerResolver { id_to_type: builtins_ty.clone().into(), id_to_def: builtins_def.clone().into(), pyid_to_def: self.pyid_to_def.clone(), pyid_to_type: pyid_to_type.clone(), primitive_ids: self.primitive_ids.clone(), global_value_ids: global_value_ids.clone(), name_to_pyid: name_to_pyid.clone(), module: module.clone(), id_to_pyval: RwLock::default(), id_to_primitive: RwLock::default(), field_to_val: RwLock::default(), helper, string_store: self.string_store.clone(), exception_ids: self.exception_ids.clone(), deferred_eval_store: self.deferred_eval_store.clone(), }))) as Arc; let name_to_pyid = Rc::new(name_to_pyid); module_to_resolver_cache .insert(module_id, (name_to_pyid.clone(), resolver.clone())); (name_to_pyid, resolver) }); let (name, def_id, ty) = composer .register_top_level(stmt.clone(), Some(resolver.clone()), path, false) .map_err(|e| { CompileError::new_err(format!("compilation failed\n----------\n{e}")) })?; if let Some(class_obj) = class_obj { self.exception_ids .write() .insert(def_id.0, store_obj.call1(py, (class_obj,))?.extract(py)?); } match &stmt.node { StmtKind::FunctionDef { decorator_list, .. } => { if decorator_list.iter().any(|decorator| matches!(decorator.node, ExprKind::Name { id, .. } if id == "rpc".into())) { store_fun.call1(py, (def_id.0.into_py(py), module.getattr(py, name.to_string().as_str()).unwrap())).unwrap(); rpc_ids.push((None, def_id)); } } StmtKind::ClassDef { name, body, .. } => { let class_name = name.to_string(); let class_obj = module.getattr(py, class_name.as_str()).unwrap(); for stmt in body { if let StmtKind::FunctionDef { name, decorator_list, .. } = &stmt.node { if decorator_list.iter().any(|decorator| matches!(decorator.node, ExprKind::Name { id, .. } if id == "rpc".into())) { if name == &"__init__".into() { return Err(CompileError::new_err(format!( "compilation failed\n----------\nThe constructor of class {} should not be decorated with rpc decorator (at {})", class_name, stmt.location ))); } rpc_ids.push((Some((class_obj.clone(), *name)), def_id)); } } } } _ => () } let id = *name_to_pyid.get(&name).unwrap(); self.pyid_to_def.write().insert(id, def_id); { let mut pyid_to_ty = pyid_to_type.write(); if let Some(ty) = ty { pyid_to_ty.insert(id, ty); } } } let id_fun = PyModule::import_bound(py, "builtins")?.getattr("id")?; let mut name_to_pyid: HashMap = HashMap::new(); let module = PyModule::new_bound(py, "tmp")?; module.add("base", obj)?; name_to_pyid.insert("base".into(), id_fun.call1((obj,))?.extract()?); let mut arg_names = vec![]; for (i, arg) in args.into_iter().enumerate() { let name = format!("tmp{i}"); module.add(&*name, arg.clone())?; name_to_pyid.insert(name.clone().into(), id_fun.call1((arg,))?.extract()?); arg_names.push(name); } let synthesized = if method_name.is_empty() { format!("def __modinit__():\n base({})", arg_names.join(", ")) } else { format!("def __modinit__():\n base.{}({})", method_name, arg_names.join(", ")) }; let mut synthesized = parse_program(&synthesized, "".to_string().into()).unwrap(); let inner_resolver = Arc::new(InnerResolver { id_to_type: builtins_ty.clone().into(), id_to_def: builtins_def.clone().into(), pyid_to_def: self.pyid_to_def.clone(), pyid_to_type: pyid_to_type.clone(), primitive_ids: self.primitive_ids.clone(), global_value_ids: global_value_ids.clone(), id_to_pyval: RwLock::default(), id_to_primitive: RwLock::default(), field_to_val: RwLock::default(), name_to_pyid, module: module.to_object(py), helper, string_store: self.string_store.clone(), exception_ids: self.exception_ids.clone(), deferred_eval_store: self.deferred_eval_store.clone(), }); let resolver = Arc::new(Resolver(inner_resolver.clone())) as Arc; let (_, def_id, _) = composer .register_top_level(synthesized.pop().unwrap(), Some(resolver.clone()), "", false) .unwrap(); // Process IRRT let context = Context::create(); let irrt = load_irrt(&context, resolver.as_ref()); let fun_signature = FunSignature { args: vec![], ret: self.primitive.none, vars: VarMap::new() }; let mut store = ConcreteTypeStore::new(); let mut cache = HashMap::new(); let signature = store.from_signature( &mut composer.unifier, &self.primitive, &fun_signature, &mut cache, ); let signature = store.add_cty(signature); if let Err(e) = composer.start_analysis(true) { // report error of __modinit__ separately return if e.iter().any(|err| err.contains("")) { let msg = Self::report_modinit( &arg_names, method_name, &resolver, &composer.extract_def_list(), &mut composer.unifier, &self.primitive, ); Err(CompileError::new_err(format!( "compilation failed\n----------\n{}", msg.unwrap_or(e.iter().sorted().join("\n----------\n")) ))) } else { Err(CompileError::new_err(format!( "compilation failed\n----------\n{}", e.iter().sorted().join("\n----------\n"), ))) }; } let top_level = Arc::new(composer.make_top_level_context()); { let rpc_codegen = rpc_codegen_callback(); let defs = top_level.definitions.read(); for (class_data, id) in &rpc_ids { let mut def = defs[id.0].write(); match &mut *def { TopLevelDef::Function { codegen_callback, .. } => { *codegen_callback = Some(rpc_codegen.clone()); } TopLevelDef::Class { methods, .. } => { let (class_def, method_name) = class_data.as_ref().unwrap(); for (name, _, id) in &*methods { if name != method_name { continue; } if let TopLevelDef::Function { codegen_callback, .. } = &mut *defs[id.0].write() { *codegen_callback = Some(rpc_codegen.clone()); store_fun .call1( py, ( id.0.into_py(py), class_def .getattr(py, name.to_string().as_str()) .unwrap(), ), ) .unwrap(); } } } } } } let instance = { let defs = top_level.definitions.read(); let mut definition = defs[def_id.0].write(); let TopLevelDef::Function { instance_to_stmt, instance_to_symbol, .. } = &mut *definition else { unreachable!() }; instance_to_symbol.insert(String::new(), "__modinit__".into()); instance_to_stmt[""].clone() }; let task = CodeGenTask { subst: Vec::default(), symbol_name: "__modinit__".to_string(), body: instance.body, signature, resolver: resolver.clone(), store, unifier_index: instance.unifier_id, calls: instance.calls, id: 0, }; let mut store = ConcreteTypeStore::new(); let mut cache = HashMap::new(); let signature = store.from_signature( &mut composer.unifier, &self.primitive, &fun_signature, &mut cache, ); let signature = store.add_cty(signature); let attributes_writeback_task = CodeGenTask { subst: Vec::default(), symbol_name: "attributes_writeback".to_string(), body: Arc::new(Vec::default()), signature, resolver, store, unifier_index: instance.unifier_id, calls: Arc::new(HashMap::default()), id: 0, }; let membuffers: Arc>>> = Arc::default(); let membuffer = membuffers.clone(); let f = Arc::new(WithCall::new(Box::new(move |module| { let buffer = module.write_bitcode_to_memory(); let buffer = buffer.as_slice().into(); membuffer.lock().push(buffer); }))); let size_t = context .ptr_sized_int_type(&self.get_llvm_target_machine().get_target_data(), None) .get_bit_width(); let num_threads = if is_multithreaded() { 4 } else { 1 }; let thread_names: Vec = (0..num_threads).map(|_| "main".to_string()).collect(); let threads: Vec<_> = thread_names .iter() .map(|s| Box::new(ArtiqCodeGenerator::new(s.to_string(), size_t, self.time_fns))) .collect(); let membuffer = membuffers.clone(); py.allow_threads(|| { let (registry, handles) = WorkerRegistry::create_workers(threads, top_level.clone(), &self.llvm_options, &f); registry.add_task(task); registry.wait_tasks_complete(handles); let mut generator = ArtiqCodeGenerator::new("attributes_writeback".to_string(), size_t, self.time_fns); let context = Context::create(); let module = context.create_module("attributes_writeback"); let target_machine = self.llvm_options.create_target_machine().unwrap(); module.set_data_layout(&target_machine.get_target_data().get_data_layout()); module.set_triple(&target_machine.get_triple()); let builder = context.create_builder(); let (_, module, _) = gen_func_impl( &context, &mut generator, ®istry, builder, module, attributes_writeback_task, |generator, ctx| { attributes_writeback(ctx, generator, inner_resolver.as_ref(), &host_attributes) }, ) .unwrap(); let buffer = module.write_bitcode_to_memory(); let buffer = buffer.as_slice().into(); membuffer.lock().push(buffer); }); // Link all modules into `main`. let buffers = membuffers.lock(); let main = context .create_module_from_ir(MemoryBuffer::create_from_memory_range(&buffers[0], "main")) .unwrap(); for buffer in buffers.iter().skip(1) { let other = context .create_module_from_ir(MemoryBuffer::create_from_memory_range(buffer, "main")) .unwrap(); main.link_in_module(other).map_err(|err| CompileError::new_err(err.to_string()))?; } let builder = context.create_builder(); let modinit_return = main .get_function("__modinit__") .unwrap() .get_last_basic_block() .unwrap() .get_terminator() .unwrap(); builder.position_before(&modinit_return); builder .build_call( main.get_function("attributes_writeback").unwrap(), &[], "attributes_writeback", ) .unwrap(); main.link_in_module(irrt).map_err(|err| CompileError::new_err(err.to_string()))?; let mut function_iter = main.get_first_function(); while let Some(func) = function_iter { if func.count_basic_blocks() > 0 && func.get_name().to_str().unwrap() != "__modinit__" { func.set_linkage(Linkage::Private); } function_iter = func.get_next_function(); } // Demote all global variables that will not be referenced in the kernel to private let preserved_symbols: Vec<&'static [u8]> = vec![b"typeinfo", b"now"]; let mut global_option = main.get_first_global(); while let Some(global) = global_option { if !preserved_symbols.contains(&(global.get_name().to_bytes())) { global.set_linkage(Linkage::Private); } global_option = global.get_next_global(); } let target_machine = self .llvm_options .target .create_target_machine(self.llvm_options.opt_level) .expect("couldn't create target machine"); let pass_options = PassBuilderOptions::create(); pass_options.set_merge_functions(true); let passes = format!("default", self.llvm_options.opt_level as u32); let result = main.run_passes(passes.as_str(), &target_machine, pass_options); if let Err(err) = result { panic!("Failed to run optimization for module `main`: {}", err.to_string()); } link_fn(&main) } /// Returns the [`TargetTriple`] used for compiling to [isa]. fn get_llvm_target_triple(isa: Isa) -> TargetTriple { match isa { Isa::Host => TargetMachine::get_default_triple(), Isa::RiscV32G | Isa::RiscV32IMA => TargetTriple::create("riscv32-unknown-linux"), Isa::CortexA9 => TargetTriple::create("armv7-unknown-linux-gnueabihf"), } } /// Returns the [`String`] representing the target CPU used for compiling to [isa]. fn get_llvm_target_cpu(isa: Isa) -> String { match isa { Isa::Host => TargetMachine::get_host_cpu_name().to_string(), Isa::RiscV32G | Isa::RiscV32IMA => "generic-rv32".to_string(), Isa::CortexA9 => "cortex-a9".to_string(), } } /// Returns the [`String`] representing the target features used for compiling to [isa]. fn get_llvm_target_features(isa: Isa) -> String { match isa { Isa::Host => TargetMachine::get_host_cpu_features().to_string(), Isa::RiscV32G => "+a,+m,+f,+d".to_string(), Isa::RiscV32IMA => "+a,+m".to_string(), Isa::CortexA9 => "+dsp,+fp16,+neon,+vfp3,+long-calls".to_string(), } } /// Returns an instance of [`CodeGenTargetMachineOptions`] representing the target machine /// options used for compiling to [isa]. fn get_llvm_target_options(isa: Isa) -> CodeGenTargetMachineOptions { CodeGenTargetMachineOptions { triple: Nac3::get_llvm_target_triple(isa).as_str().to_string_lossy().into_owned(), cpu: Nac3::get_llvm_target_cpu(isa), features: Nac3::get_llvm_target_features(isa), reloc_mode: RelocMode::PIC, ..CodeGenTargetMachineOptions::from_host() } } /// Returns an instance of [`TargetMachine`] used in compiling and linking of a program to the /// target [isa]. fn get_llvm_target_machine(&self) -> TargetMachine { Nac3::get_llvm_target_options(self.isa) .create_target_machine(self.llvm_options.opt_level) .expect("couldn't create target machine") } } fn link_with_lld(elf_filename: String, obj_filename: String) -> PyResult<()> { let linker_args = vec![ "-shared".to_string(), "--eh-frame-hdr".to_string(), "-x".to_string(), "-o".to_string(), elf_filename, obj_filename, ]; #[cfg(not(windows))] let lld_command = "ld.lld"; #[cfg(windows)] let lld_command = "ld.lld.exe"; if let Ok(linker_status) = Command::new(lld_command).args(linker_args).status() { if !linker_status.success() { return Err(CompileError::new_err("failed to start linker")); } } else { return Err(CompileError::new_err("linker returned non-zero status code")); } Ok(()) } fn add_exceptions( composer: &mut TopLevelComposer, builtin_def: &mut HashMap, builtin_ty: &mut HashMap, error_names: &[&str], ) -> Vec { let mut types = Vec::new(); // note: this is only for builtin exceptions, i.e. the exception name is "0:{exn}" for name in error_names { let def_id = composer.definition_ast_list.len(); let (exception_fn, exception_class, exception_cons, exception_type) = get_exn_constructor( name, // class id def_id, // constructor id def_id + 1, &mut composer.unifier, &composer.primitives_ty, ); composer.definition_ast_list.push((Arc::new(RwLock::new(exception_class)), None)); composer.definition_ast_list.push((Arc::new(RwLock::new(exception_fn)), None)); builtin_ty.insert((*name).into(), exception_cons); builtin_def.insert((*name).into(), DefinitionId(def_id)); types.push(exception_type); } types } #[pymethods] impl Nac3 { #[new] fn new(isa: &str, artiq_builtins: &Bound, py: Python) -> PyResult { let isa = match isa { "host" => Isa::Host, "rv32g" => Isa::RiscV32G, "rv32ima" => Isa::RiscV32IMA, "cortexa9" => Isa::CortexA9, _ => return Err(exceptions::PyValueError::new_err("invalid ISA")), }; let time_fns: &(dyn TimeFns + Sync) = match isa { Isa::RiscV32G => &timeline::NOW_PINNING_TIME_FNS_64, Isa::RiscV32IMA => &timeline::NOW_PINNING_TIME_FNS, Isa::CortexA9 | Isa::Host => &timeline::EXTERN_TIME_FNS, }; let (primitive, _) = TopLevelComposer::make_primitives(isa.get_size_type()); let builtins = vec![ ( "now_mu".into(), FunSignature { args: vec![], ret: primitive.int64, vars: VarMap::new() }, Arc::new(GenCall::new(Box::new(move |ctx, _, _, _, _| { Ok(Some(time_fns.emit_now_mu(ctx))) }))), ), ( "at_mu".into(), FunSignature { args: vec![FuncArg { name: "t".into(), ty: primitive.int64, default_value: None, is_vararg: false, }], ret: primitive.none, vars: VarMap::new(), }, Arc::new(GenCall::new(Box::new(move |ctx, _, fun, args, generator| { let arg_ty = fun.0.args[0].ty; let arg = args[0].1.clone().to_basic_value_enum(ctx, generator, arg_ty).unwrap(); time_fns.emit_at_mu(ctx, arg); Ok(None) }))), ), ( "delay_mu".into(), FunSignature { args: vec![FuncArg { name: "dt".into(), ty: primitive.int64, default_value: None, is_vararg: false, }], ret: primitive.none, vars: VarMap::new(), }, Arc::new(GenCall::new(Box::new(move |ctx, _, fun, args, generator| { let arg_ty = fun.0.args[0].ty; let arg = args[0].1.clone().to_basic_value_enum(ctx, generator, arg_ty).unwrap(); time_fns.emit_delay_mu(ctx, arg); Ok(None) }))), ), ]; let builtins_mod = PyModule::import_bound(py, "builtins").unwrap(); let id_fn = builtins_mod.getattr("id").unwrap(); let numpy_mod = PyModule::import_bound(py, "numpy").unwrap(); let typing_mod = PyModule::import_bound(py, "typing").unwrap(); let types_mod = PyModule::import_bound(py, "types").unwrap(); let get_id = |x: Borrowed| id_fn.call1((x,)).and_then(|id| id.extract()).unwrap(); let get_attr_id = |obj: Borrowed, attr| { id_fn.call1((obj.getattr(attr).unwrap(),)).unwrap().extract().unwrap() }; let primitive_ids = PrimitivePythonId { virtual_id: get_id( artiq_builtins.get_item("virtual").ok().flatten().unwrap().as_borrowed(), ), generic_alias: ( get_attr_id(typing_mod.as_borrowed(), "_GenericAlias"), get_attr_id(types_mod.as_borrowed(), "GenericAlias"), ), none: get_id(artiq_builtins.get_item("none").ok().flatten().unwrap().as_borrowed()), typevar: get_attr_id(typing_mod.as_borrowed(), "TypeVar"), const_generic_marker: get_id( artiq_builtins .get_item("_ConstGenericMarker") .ok() .flatten() .unwrap() .as_borrowed(), ), int: get_attr_id(builtins_mod.as_borrowed(), "int"), int32: get_attr_id(numpy_mod.as_borrowed(), "int32"), int64: get_attr_id(numpy_mod.as_borrowed(), "int64"), uint32: get_attr_id(numpy_mod.as_borrowed(), "uint32"), uint64: get_attr_id(numpy_mod.as_borrowed(), "uint64"), bool: get_attr_id(builtins_mod.as_borrowed(), "bool"), np_bool_: get_attr_id(numpy_mod.as_borrowed(), "bool_"), string: get_attr_id(builtins_mod.as_borrowed(), "str"), np_str_: get_attr_id(numpy_mod.as_borrowed(), "str_"), float: get_attr_id(builtins_mod.as_borrowed(), "float"), float64: get_attr_id(numpy_mod.as_borrowed(), "float64"), list: get_attr_id(builtins_mod.as_borrowed(), "list"), ndarray: get_attr_id(numpy_mod.as_borrowed(), "ndarray"), tuple: get_attr_id(builtins_mod.as_borrowed(), "tuple"), exception: get_attr_id(builtins_mod.as_borrowed(), "Exception"), option: get_id(artiq_builtins.get_item("Option").ok().flatten().unwrap().as_borrowed()), }; let working_directory = tempfile::Builder::new().prefix("nac3-").tempdir().unwrap(); fs::write(working_directory.path().join("kernel.ld"), include_bytes!("kernel.ld")).unwrap(); Ok(Nac3 { isa, time_fns, primitive, builtins, primitive_ids, top_levels: Vec::default(), pyid_to_def: Arc::default(), working_directory, string_store: Arc::default(), exception_ids: Arc::default(), deferred_eval_store: DeferredEvaluationStore::new(), llvm_options: CodeGenLLVMOptions { opt_level: OptimizationLevel::Default, target: Nac3::get_llvm_target_options(isa), }, }) } fn analyze(&mut self, functions: &Bound, classes: &Bound) -> PyResult<()> { let (modules, class_ids) = Python::with_gil(|py| -> PyResult<(HashMap, HashSet)> { let mut modules: HashMap = HashMap::new(); let mut class_ids: HashSet = HashSet::new(); let id_fn = PyModule::import_bound(py, "builtins")?.getattr("id")?; let getmodule_fn = PyModule::import_bound(py, "inspect")?.getattr("getmodule")?; for function in functions { let module = getmodule_fn.call1((function,))?.extract()?; modules.insert(id_fn.call1((&module,))?.extract()?, module); } for class in classes { let module = getmodule_fn.call1((class.as_borrowed(),))?.extract()?; modules.insert(id_fn.call1((&module,))?.extract()?, module); class_ids.insert(id_fn.call1((class,))?.extract()?); } Ok((modules, class_ids)) })?; for module in modules.into_values() { self.register_module(&module, &class_ids)?; } Ok(()) } fn compile_method_to_file( &mut self, obj: &Bound, method_name: &str, args: Vec>, filename: &str, embedding_map: &Bound, py: Python, ) -> PyResult<()> { let target_machine = self.get_llvm_target_machine(); if self.isa == Isa::Host { let link_fn = |module: &Module| { let working_directory = self.working_directory.path().to_owned(); target_machine .write_to_file(module, FileType::Object, &working_directory.join("module.o")) .expect("couldn't write module to file"); link_with_lld( filename.to_string(), working_directory.join("module.o").to_string_lossy().to_string(), )?; Ok(()) }; self.compile_method(obj, method_name, args, embedding_map, py, &link_fn) } else { let link_fn = |module: &Module| { let object_mem = target_machine .write_to_memory_buffer(module, FileType::Object) .expect("couldn't write module to object file buffer"); if let Ok(dyn_lib) = Linker::ld(object_mem.as_slice()) { if let Ok(mut file) = fs::File::create(filename) { file.write_all(&dyn_lib).expect("couldn't write linked library to file"); Ok(()) } else { Err(CompileError::new_err("failed to create file")) } } else { Err(CompileError::new_err("linker failed to process object file")) } }; self.compile_method(obj, method_name, args, embedding_map, py, &link_fn) } } fn compile_method_to_mem( &mut self, obj: &Bound, method_name: &str, args: Vec>, embedding_map: &Bound, py: Python, ) -> PyResult { let target_machine = self.get_llvm_target_machine(); if self.isa == Isa::Host { let link_fn = |module: &Module| { let working_directory = self.working_directory.path().to_owned(); target_machine .write_to_file(module, FileType::Object, &working_directory.join("module.o")) .expect("couldn't write module to file"); let filename_path = self.working_directory.path().join("module.elf"); let filename = filename_path.to_str().unwrap(); link_with_lld( filename.to_string(), working_directory.join("module.o").to_string_lossy().to_string(), )?; Ok(PyBytes::new_bound(py, &fs::read(filename).unwrap()).into()) }; self.compile_method(obj, method_name, args, embedding_map, py, &link_fn) } else { let link_fn = |module: &Module| { let object_mem = target_machine .write_to_memory_buffer(module, FileType::Object) .expect("couldn't write module to object file buffer"); if let Ok(dyn_lib) = Linker::ld(object_mem.as_slice()) { Ok(PyBytes::new_bound(py, &dyn_lib).into()) } else { Err(CompileError::new_err("linker failed to process object file")) } }; self.compile_method(obj, method_name, args, embedding_map, py, &link_fn) } } } #[cfg(feature = "init-llvm-profile")] extern "C" { fn __llvm_profile_initialize(); } #[pymodule] fn nac3artiq(py: Python, m: &Bound) -> PyResult<()> { #[cfg(feature = "init-llvm-profile")] unsafe { __llvm_profile_initialize(); } Target::initialize_all(&InitializationConfig::default()); m.add("CompileError", py.get_type_bound::())?; m.add_class::()?; Ok(()) }