bevy_brp_mcp 0.22.2

MCP server for Bevy Remote Protocol (BRP) integration
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

use std::fs::File;
use std::io::Write;
use std::path::Path;
use std::path::PathBuf;
use std::time::UNIX_EPOCH;

use error_stack::ResultExt;

use super::constants::LOG_WRITE_ERROR_MESSAGE;
use crate::app_tools::targets::TargetType;
use crate::brp_tools::Port;
use crate::error::Error;
use crate::error::Result;

pub(super) fn create_log_file(
    name: &str,
    target_type: TargetType,
    profile: &str,
    binary_path: &Path,
    manifest_dir: &Path,
    port: Port,
) -> Result<(PathBuf, File)> {
    // Generate unique log file name in temp directory
    let timestamp = std::time::SystemTime::now()
        .duration_since(UNIX_EPOCH)
        .change_context(Error::LogOperation("Failed to get timestamp".to_string()))
        .attach("System time error")?
        .as_millis();

    // Port provides uniqueness for multiple instances
    let log_file_path =
        std::env::temp_dir().join(format!("bevy_brp_mcp_{name}_port{port}_{timestamp}.log"));

    // Create log file
    let mut log_file = File::create(&log_file_path)
        .change_context(Error::LogOperation("Failed to create log file".to_string()))
        .attach(format!("Path: {}", log_file_path.display()))?;

    // Write header
    writeln!(log_file, "=== Bevy BRP MCP Launch Log ===")
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;
    writeln!(log_file, "Started at: {:?}", std::time::SystemTime::now())
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;
    writeln!(log_file, "{target_type}: {name}")
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;
    writeln!(log_file, "Profile: {profile}")
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;
    writeln!(log_file, "Binary: {}", binary_path.display())
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;
    writeln!(log_file, "Working directory: {}", manifest_dir.display())
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;
    writeln!(log_file, "============================================\n")
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;
    log_file
        .sync_all()
        .change_context(Error::LogOperation("Failed to sync log file".to_string()))?;

    Ok((log_file_path, log_file))
}

/// Open an existing log file for appending (for stdout/stderr redirection)
pub(super) fn open_log_file_for_redirect(log_file_path: &Path) -> Result<File> {
    File::options()
        .append(true)
        .open(log_file_path)
        .change_context(Error::LogOperation(
            "Failed to open log file for redirect".to_string(),
        ))
        .attach(format!("Path: {}", log_file_path.display()))
}

/// Appends additional text to an existing log file
pub(super) fn append_to_log_file(log_file_path: &Path, content: &str) -> Result<()> {
    let mut file = File::options()
        .append(true)
        .open(log_file_path)
        .change_context(Error::LogOperation(
            "Failed to open log file for appending".to_string(),
        ))
        .attach(format!("Path: {}", log_file_path.display()))?;

    write!(file, "{content}")
        .change_context(Error::LogOperation(LOG_WRITE_ERROR_MESSAGE.to_owned()))?;

    file.sync_all()
        .change_context(Error::LogOperation("Failed to sync log file".to_string()))?;

    Ok(())
}