Struct winepath::WineConfig

pub struct WineConfig { /* fields omitted */ }

The main conversion struct: create one of these to do conversions.

Tracks the WINEPREFIX and the drive letter mappings so they don't have to be recomputed every time you convert a path.

Methods

impl WineConfig

pub fn from_env() -> Result<Self, WinePathError>

Determine the wine prefix from the environment.

pub fn from_prefix(path: impl Into<PathBuf>) -> Self

Create a config assuming that the given path is a valid WINEPREFIX.

Note that this is not validated, and you will end up with empty drive mappings if it is not actually a wine prefix.

You can manually validate if a directory is Wine-y enough by doing:

use std::path::Path;
fn is_wineprefix_like(some_path: &Path) -> bool {
    some_path.join("dosdevices").is_dir()
}

pub fn prefix(&self) -> &Path

Get the current wine prefix.

pub fn to_wine_path(
    &self,
    path: impl AsRef<Path>
) -> Result<WinePath, WinePathError>

Convert a native file path to a Wine path.

use winepath::WineConfig;
let config = WineConfig::from_env().unwrap();
let path = config.to_wine_path("/home/username/.wine/drive_c/Program Files/CoolApp/start.exe").unwrap();
assert_eq!(path.to_string(), r"c:\Program Files\CoolApp\start.exe");
let path = config.to_wine_path("/home/username/some-path/some-file").unwrap();
assert_eq!(path.to_string(), r"z:\home\username\some-path\some-file");

pub fn to_native_path(
    &self,
    path: impl Into<WinePath>
) -> Result<PathBuf, WinePathError>

Convert a Wine path to a native file path.

use winepath::WineConfig;
use std::path::PathBuf;
let config = WineConfig::from_env().unwrap();
let path = config.to_native_path(r"c:\Program Files\CoolApp\start.exe").unwrap();
assert_eq!(path, PathBuf::from("/home/username/.wine/drive_c/Program Files/CoolApp/start.exe"));
let path = config.to_native_path(r"z:\home\username\some-path\some-file").unwrap();
assert_eq!(path, PathBuf::from("/home/username/some-path/some-file"));

Trait Implementations

impl Debug for WineConfig

fn fmt(&self, f: &mut Formatter) -> Result

Formats the value using the given formatter.