freenet 0.2.43

Freenet core software
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95

//! Windows setup wizard for first-run installation.
//!
//! When `freenet.exe` is run with no arguments and is NOT in the canonical
//! install location (`%LOCALAPPDATA%\Freenet\bin\`), this module shows a
//! native Windows dialog offering to install Freenet or run without installing.
//!
//! On non-Windows platforms, `maybe_show_setup_wizard()` is a no-op.

#[cfg(target_os = "windows")]
pub mod detection;
#[cfg(target_os = "windows")]
pub mod installer;
#[cfg(target_os = "windows")]
pub mod ui;

// Re-export stubs on non-Windows so the entry point compiles everywhere.
#[cfg(not(target_os = "windows"))]
pub mod ui {
    #[derive(Debug, Clone, PartialEq)]
    #[allow(dead_code)]
    pub enum SetupResult {
        Installed,
        RunWithout,
        Cancelled,
    }
}

/// Check if Freenet needs to be installed and show the setup wizard if so.
///
/// Returns `Ok(true)` if the caller should exit (wizard shown, or service started).
/// Returns `Ok(false)` if the caller should proceed with normal startup
/// (non-Windows, or user chose "Run without installing").
///
/// On Windows, when Freenet is already installed, this starts the background
/// service (with tray icon) instead of returning false — users expect that
/// running `freenet.exe` with no args launches the tray app, not console mode.
pub fn maybe_show_setup_wizard() -> anyhow::Result<bool> {
    #[cfg(target_os = "windows")]
    {
        if detection::is_installed() {
            // Already installed: start the service (tray icon + background node)
            // rather than dropping into raw console mode.
            return start_installed_service();
        }

        // Show the setup dialog. The dialog creates its own window, so the
        // console from Explorer may briefly flash. We detach it AFTER the user
        // makes their choice so that "Run without installing" preserves console
        // output for CLI users who happen to run from a non-install location.
        let result = ui::show_setup_dialog()?;

        match result {
            ui::SetupResult::Installed => Ok(true),
            ui::SetupResult::RunWithout => Ok(false), // Caller runs node with console intact
            ui::SetupResult::Cancelled => Ok(true),
        }
    }

    #[cfg(not(target_os = "windows"))]
    {
        Ok(false)
    }
}

/// Start the background service on an already-installed Windows system.
///
/// Spawns `freenet service start` (which launches the run-wrapper with tray icon
/// as a detached process) and exits. If starting fails, falls back to console mode
/// so the user isn't left with nothing.
#[cfg(target_os = "windows")]
fn start_installed_service() -> anyhow::Result<bool> {
    use std::os::windows::process::CommandExt;
    const CREATE_NO_WINDOW: u32 = 0x08000000;

    let exe = std::env::current_exe()?;

    let status = std::process::Command::new(&exe)
        .args(["service", "start"])
        .creation_flags(CREATE_NO_WINDOW)
        .status();

    match status {
        Ok(s) if s.success() => Ok(true), // Service started, caller should exit
        Ok(_) => {
            eprintln!("Warning: could not start Freenet service, falling back to console mode");
            Ok(false)
        }
        Err(e) => {
            eprintln!(
                "Warning: could not start Freenet service ({e}), falling back to console mode"
            );
            Ok(false)
        }
    }
}