Method from_path

icicle-cortexm/src/config.rs:147–240

(target: &std::path::Path)

    }

    pub fn from_path(target: &std::path::Path) -> anyhow::Result<Self> {
        // Allow the config to specified either with a full path to a config file or to a folder
        // containing a `config.yml`.
        let (root, config_path) = match target.extension().map_or(false, |x| x == "yml") {
            true => {
                let root = target.parent().unwrap_or(std::path::Path::new(".")).to_owned();
                (root, target.to_owned())
            }
            false => (target.to_owned(), target.join("config.yml")),
        };

        // If config file does not exist, attempt to generate one for the user.
        if root.exists() && !config_path.exists() {
            eprintln!(
                "WARNING: Config file not found. Generating default config at: {}",
                config_path.display()
            );
            crate::genconfig::generate_and_save(target, false)?;
        }

        let mut config: Self = serde_yaml::from_slice(
            &std::fs::read(&config_path)
                .with_context(|| format!("failed to read '{}'", config_path.display()))?,
        )
        .with_context(|| format!("error parsing: {}", config_path.display()))?;
        config.path = config_path;

        let num_entry_regions = config.memory_map.values().filter(|x| x.is_entry).count();
        if num_entry_regions > 1 {
            anyhow::bail!("expected at most one memory region (got {num_entry_regions})");
        }

        // Try to automatically set entry region if none was specified.
        if num_entry_regions == 0 && config.entry_point.is_none() {
            // Find the file-backed region with the lowest base address.
            let mut min_region = None;
            for (name, region) in config.memory_map.iter() {
                let file = match &region.file {
                    Some(name) => name,
                    None => continue,
                };

                let (_, prev_region) = min_region.unwrap_or((name, region));
                if file != prev_region.file.as_ref().unwrap() {
                    anyhow::bail!(
                        "explicit entry point must be set when there are multiple file regions."
                    );
                }
                if prev_region.base_addr < region.base_addr {
                    // Previous region was at a lower base address.
                    continue;
                }
                min_region = Some((name, region));
            }

            let (name, _) = min_region.ok_or_else(|| {
                anyhow::format_err!("No entrypoints and no file backed regions were defined")
            })?;