//! The debug configuration. pub mod ir_type; use std::path::PathBuf; use serde::Deserialize; use serde::Serialize; use self::ir_type::IRType; /// The debug configuration. #[derive(Debug, Default, Serialize, Deserialize, Clone)] pub struct DebugConfig { /// The directory to dump the IRs to. pub output_directory: Option, /// Whether debug info should be emitted. pub emit_debug_info: bool, } impl DebugConfig { /// A shortcut constructor. pub const fn new(output_directory: Option, emit_debug_info: bool) -> Self { Self { output_directory, emit_debug_info, } } /// Dumps the Yul IR. pub fn dump_yul(&self, contract_path: &str, code: &str) -> anyhow::Result<()> { if let Some(output_directory) = self.output_directory.as_ref() { let mut file_path = output_directory.to_owned(); let full_file_name = Self::full_file_name(contract_path, None, IRType::Yul); file_path.push(full_file_name); std::fs::write(file_path, code)?; } Ok(()) } /// Dumps the unoptimized LLVM IR. pub fn dump_llvm_ir_unoptimized( &self, contract_path: &str, module: &inkwell::module::Module, ) -> anyhow::Result<()> { if let Some(output_directory) = self.output_directory.as_ref() { let llvm_code = module.print_to_string().to_string(); let mut file_path = output_directory.to_owned(); let full_file_name = Self::full_file_name(contract_path, Some("unoptimized"), IRType::LLVM); file_path.push(full_file_name); std::fs::write(file_path, llvm_code)?; } Ok(()) } /// Dumps the optimized LLVM IR. pub fn dump_llvm_ir_optimized( &self, contract_path: &str, module: &inkwell::module::Module, ) -> anyhow::Result<()> { if let Some(output_directory) = self.output_directory.as_ref() { let llvm_code = module.print_to_string().to_string(); let mut file_path = output_directory.to_owned(); let full_file_name = Self::full_file_name(contract_path, Some("optimized"), IRType::LLVM); file_path.push(full_file_name); std::fs::write(file_path, llvm_code)?; } Ok(()) } /// Dumps the assembly. pub fn dump_assembly(&self, contract_path: &str, code: &str) -> anyhow::Result<()> { if let Some(output_directory) = self.output_directory.as_ref() { let mut file_path = output_directory.to_owned(); let full_file_name = Self::full_file_name(contract_path, None, IRType::Assembly); file_path.push(full_file_name); std::fs::write(file_path, code)?; } Ok(()) } /// Dumps the code object. pub fn dump_object(&self, contract_path: &str, code: &[u8]) -> anyhow::Result<()> { if let Some(output_directory) = self.output_directory.as_ref() { let mut file_path = output_directory.to_owned(); let full_file_name = Self::full_file_name(contract_path, None, IRType::SO); file_path.push(full_file_name); std::fs::write(file_path, code)?; } Ok(()) } /// Dumps the stage output as a json file suitable for use with --recursive-process #[cfg(debug_assertions)] pub fn dump_stage_output( &self, contract_path: &str, contract_suffix: Option<&str>, stage_json: &Vec, ) -> anyhow::Result<()> { if let Some(output_directory) = self.output_directory.as_ref() { let mut file_path = output_directory.to_owned(); let full_file_name = Self::full_file_name(contract_path, contract_suffix, IRType::JSON); file_path.push(full_file_name); std::fs::write(file_path, stage_json)?; } Ok(()) } /// Creates a full file name, given the contract full path, suffix, and extension. fn full_file_name(contract_path: &str, suffix: Option<&str>, ir_type: IRType) -> String { let mut full_file_name = contract_path.replace('/', "_").replace(':', "."); if let Some(suffix) = suffix { full_file_name.push('.'); full_file_name.push_str(suffix); } full_file_name.push('.'); full_file_name.push_str(ir_type.file_extension()); full_file_name } }