fix(web): add startup help and logging guidance

This commit is contained in:
二丫讲梵 authored and GitHub committed 2026-10-03 23:24:50 +08:00
1 parent 895aaa0944
commit 4c7f8e8196
5 files changed
+174 -1

No files matched your search

+78
View File
@@ -39,6 +39,51 @@ use web_mcp::WebMcpRuntime;
const XLSX_CONTENT_TYPE: &str = "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet";
const DATA_GRID_EXTRACTOR_BODY_LIMIT_BYTES: usize = 96 * 1024 * 1024;
const NON_WINDOWS_HELP_TEXT: &str = r#"Usage: dbx-web [OPTION]
Start the DBX Web browser service.
Options:
-h, --help, /help Show this help message and exit.
Environment variables:
DBX_PORT Listen port (default: 4224)
DBX_DATA_DIR Data directory (default: ~/.dbx-web)
DBX_PUBLIC_BASE_PATH URL path prefix (default: /)
DBX_PASSWORD Set the Web login password
DBX_DISABLE_PASSWORD Set to 1 to disable login protection
DBX_STATIC_DIR Serve frontend assets from this directory
RUST_LOG Configure backend log filtering
RUST_BACKTRACE Set to 1 to include Rust backtraces
Examples:
DBX_PORT=8080 dbx-web
RUST_LOG=dbx_web=debug,tower_http=info dbx-web
RUST_BACKTRACE=1 RUST_LOG=dbx_web=debug dbx-web
"#;
const WINDOWS_HELP_TEXT: &str = r#"Usage: dbx-web [OPTION]
Start the DBX Web browser service.
Options:
-h, --help, /help Show this help message and exit.
Environment variables:
DBX_PORT Listen port (default: 4224)
DBX_DATA_DIR Data directory (default: %HOME%\.dbx-web; .\.dbx-web if HOME is unset)
DBX_PUBLIC_BASE_PATH URL path prefix (default: /)
DBX_PASSWORD Set the Web login password
DBX_DISABLE_PASSWORD Set to 1 to disable login protection
DBX_STATIC_DIR Serve frontend assets from this directory
RUST_LOG Configure backend log filtering
RUST_BACKTRACE Set to 1 to include Rust backtraces
Examples:
set "DBX_PORT=8080" && dbx-web.exe
set "RUST_LOG=dbx_web=debug,tower_http=info" && dbx-web.exe
set "RUST_BACKTRACE=1" && set "RUST_LOG=dbx_web=debug" && dbx-web.exe
"#;
const HELP_TEXT: &str = if cfg!(windows) { WINDOWS_HELP_TEXT } else { NON_WINDOWS_HELP_TEXT };
#[derive(OpenApi)]
#[openapi(
@@ -56,6 +101,29 @@ async fn openapi_json() -> axum::Json<utoipa::openapi::OpenApi> {
mod data_grid_extractor_openapi_tests {
use super::*;
#[test]
fn help_flags_are_detected_without_starting_the_server() {
for flag in ["-h", "--help", "/help"] {
assert!(help_requested(&[flag.to_string()]));
}
assert!(help_requested(&["extra".to_string(), "--help".to_string()]));
assert!(!help_requested(&["--helpful".to_string()]));
}
#[test]
fn native_help_matches_the_target_shell() {
assert!(WINDOWS_HELP_TEXT.contains(r".\.dbx-web if HOME is unset"));
assert!(WINDOWS_HELP_TEXT.contains(r#"set "DBX_PORT=8080" && dbx-web.exe"#));
assert!(!WINDOWS_HELP_TEXT.contains("DBX_PORT=8080 dbx-web\n"));
if cfg!(windows) {
assert!(HELP_TEXT.contains(r#"set "DBX_PORT=8080" && dbx-web.exe"#));
assert!(!HELP_TEXT.contains("DBX_PORT=8080 dbx-web\n"));
} else {
assert!(HELP_TEXT.contains("DBX_PORT=8080 dbx-web\n"));
assert!(!HELP_TEXT.contains("dbx-web.exe"));
}
}
#[test]
fn extractor_openapi_contains_the_versioned_request_and_error_responses() {
let document = serde_json::to_value(ApiDoc::openapi()).expect("serialize extractor OpenAPI document");
@@ -175,6 +243,10 @@ where
)
}
fn help_requested(args: &[String]) -> bool {
args.iter().any(|arg| matches!(arg.as_str(), "-h" | "--help" | "/help"))
}
/// Frontend build output compiled into the binary by the `embed-static` feature.
/// The folder is relative to this crate's manifest (crates/dbx-web) and points
/// at the workspace root `dist` directory produced by the frontend build.
@@ -385,6 +457,12 @@ fn add_mq_routes(router: Router<Arc<WebState>>) -> Router<Arc<WebState>> {
}
fn main() {
let args: Vec<String> = std::env::args().skip(1).collect();
if help_requested(&args) {
print!("{HELP_TEXT}");
return;
}
let runtime = dbx_core::scheduled_backup::worker_runtime().expect("Failed to build tokio runtime");
runtime.block_on(serve());
}