Method make_canonical_with_extension

std/src/storage/mod.rs:423–440

Converts a `raw_location`, which needn't exist but must represent a file (not a directory), to its canonical form. If `extension` is not empty, adds it to the location if it didn't not yet have nay.

(
        &self,
        raw_location: &str,
        extension: &str,
    )

    ///
    /// If `extension` is not empty, adds it to the location if it didn't not yet have nay.
    pub fn make_canonical_with_extension(
        &self,
        raw_location: &str,
        extension: &str,
    ) -> io::Result<String> {
        let mut location = Location::new(raw_location)?;
        if location.drive.is_none() {
            location.drive = Some(self.current.clone());
        }
        if location.leaf_name().is_none() {
            return Err(io::Error::new(
                io::ErrorKind::NotFound,
                format!("Missing file name in path '{}'", raw_location),
            ));
        }
        location.set_extension(extension);
        Ok(location.to_string())
    }

    /// Attaches a new `drive` with `name`, which was instantiated with `uri`.
    ///