source-fs 0.3.0

A virtual filesystem implementation for Source Engine games, handling gameinfo.txt search paths, VPK archives, and cross-platform file resolution.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

use std::path::PathBuf;
use thiserror::Error;

/// Errors that can occur when loading or using the FileSystem.
#[derive(Error, Debug)]
pub enum FileSystemError {
    /// The `gameinfo.txt` file was not found in the specified path.
    #[error("gameinfo.txt not found in {0}")]
    GameInfoNotFound(PathBuf),

    /// The provided game path is invalid (e.g., it has no parent or file name).
    #[error("invalid game path (missing parent or file name): {0}")]
    InvalidGamePath(PathBuf),

    /// The `gameinfo.txt` file could not be parsed.
    #[error("failed to parse gameinfo.txt")]
    GameInfoParseError,

    /// An error occurred while using `steamlocate`.
    #[cfg(feature = "steam")]
    #[error("steamlocate error: {0}")]
    SteamLocateError(#[from] steamlocate::Error),

    /// The specified Steam App ID was not found.
    #[cfg(feature = "steam")]
    #[error("steam app {0} not found")]
    SteamAppNotFound(u32),

    /// The Steam installation could not be found.
    #[cfg(feature = "steam")]
    #[error("steam installation not found")]
    SteamNotFound,
}