Function resolve_path

perro_source/io_stack/perro_io/src/asset_io.rs:295–385

Resolve virtual path (res://foo/bar.png or user://save.dat) to actual location

(path: &str)

    Excluded(String),
    Disk(PathBuf),
    WebUserStorage(String),
    PerroAssets(String),
    StaticBinary(String),
    DlcStaticBinary { dlc: String, path: String },
    DlcPerroAssets { dlc: String, virtual_path: String },
}

fn normalize_user_app_name(name: &str) -> String {
    name.replace(' ', "_")
}

fn user_app_name(project_root_opt: &Option<ProjectRoot>) -> String {
    let app_name = project_root_opt
        .as_ref()
        .map(|root| match root {
            ProjectRoot::Disk { name, .. } => name.as_str(),
            ProjectRoot::PerroAssets { name, .. } => name.as_str(),
        })
        .expect("Project root not set");
    normalize_user_app_name(app_name)
}

#[cfg(any(test, target_arch = "wasm32"))]
fn user_storage_key(app_name: &str, relative_path: &str) -> String {
    format!("perro:user:{app_name}:data:{relative_path}")
}

pub fn validate_virtual_asset_path(path: &str) -> io::Result<()> {
    if let Some(stripped) = path.strip_prefix("user://") {
        return validate_asset_relative_path(stripped);
    }

    if let Some(stripped) = path.strip_prefix("res://") {
        return validate_asset_relative_path(stripped);
    }

    if let Some(rest) = path.strip_prefix("dlc://") {
        let (mount_raw, rel_raw) = rest.split_once('/').unwrap_or((rest, ""));
        validate_dlc_mount_name(mount_raw)?;
        return validate_asset_relative_path(rel_raw.trim_start_matches('/'));
    }

    let path_buf = Path::new(path);
    if path_buf.is_absolute() {
        return Ok(());
    }
    validate_asset_relative_path(path)
}

pub fn validate_asset_relative_path(path: &str) -> io::Result<()> {
    if path.contains('\\') {
        return Err(io::Error::new(
            io::ErrorKind::InvalidInput,
            "asset paths must use `/` separators",
        ));
    }
    if Path::new(path).is_absolute() {
        return Err(io::Error::new(