brave-locations 1.0.1

Locate Brave executables across desktop platforms.
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

//! Brave executable discovery helpers.

use std::path::PathBuf;

use browser_locations_core::{
    Browser, discover_browser, locate_any_latest, locate_any_stable, locate_browser,
};
pub use browser_locations_core::{BrowserLocation, LocateError, ReleaseChannel, define_getter};

/// Locates a Brave executable for a specific channel.
///
/// # Errors
///
/// Returns [`LocateError`] if the channel is unsupported or no executable is found.
pub fn locate(channel: ReleaseChannel) -> Result<BrowserLocation, LocateError> {
    locate_browser(Browser::Brave, channel)
}

/// Discovers installed Brave executables.
#[must_use]
pub fn discover() -> Vec<BrowserLocation> {
    discover_browser(Browser::Brave)
}

define_getter!(
    get_brave_path,
    ReleaseChannel::Stable,
    "Returns the stable Brave executable path."
);
define_getter!(
    get_brave_beta_path,
    ReleaseChannel::Beta,
    "Returns the Brave beta executable path."
);
define_getter!(
    get_brave_nightly_path,
    ReleaseChannel::Nightly,
    "Returns the Brave nightly executable path."
);

/// Returns the best available Brave executable, preferring stable first.
///
/// # Errors
///
/// Returns [`LocateError`] if no installed executable is found.
pub fn get_any_brave_stable() -> Result<PathBuf, LocateError> {
    locate_any_stable(Browser::Brave).map(|location| location.path)
}

/// Returns the best available Brave executable, preferring the newest channel first.
///
/// # Errors
///
/// Returns [`LocateError`] if no installed executable is found.
pub fn get_any_brave_latest() -> Result<PathBuf, LocateError> {
    locate_any_latest(Browser::Brave).map(|location| location.path)
}