use std::io::IsTerminal;
use crate::cli::GlobalFlags;
pub fn discovery_hint() -> &'static str {
if cfg!(target_os = "macos") {
"hint: this could mean:\n\
\x20 - no Sonos speakers are on this network\n\
\x20 - your terminal lacks Local Network access\n\
\x20 (System Settings > Privacy & Security > Local Network)\n\
\x20 - a firewall is blocking UDP multicast on port 1900"
} else if cfg!(target_os = "windows") {
"hint: this could mean:\n\
\x20 - no Sonos speakers are on this network\n\
\x20 - Network Discovery is disabled or your firewall is\n\
\x20 blocking UDP traffic on port 1900 (SSDP)"
} else {
"hint: this could mean:\n\
\x20 - no Sonos speakers are on this network\n\
\x20 - a firewall is blocking UDP multicast on port 1900\n\
\x20 (ufw: sudo ufw allow proto udp from any to 239.255.255.250 port 1900)"
}
}
pub fn offer_open_settings(global: &GlobalFlags) {
if !can_prompt(global) {
return;
}
let (cmd, args, fallback) = if cfg!(target_os = "macos") {
(
"open",
"x-apple.systempreferences:com.apple.preference.security?Privacy_LocalNetwork",
"System Settings > Privacy & Security > Local Network",
)
} else if cfg!(target_os = "windows") {
(
"cmd",
"/C start ms-settings:privacy-localnetwork",
"Settings > Privacy & Security > Local Network",
)
} else {
return;
};
eprintln!();
eprint!("Open settings? [Y/n] ");
let mut input = String::new();
if std::io::stdin().read_line(&mut input).is_err() {
return;
}
let answer = input.trim();
if answer.is_empty() || answer.eq_ignore_ascii_case("y") {
let result = if cfg!(target_os = "windows") {
std::process::Command::new(cmd)
.args(args.split_whitespace())
.spawn()
} else {
std::process::Command::new(cmd).arg(args).spawn()
};
if result.is_err() {
eprintln!("Could not open settings. Navigate to {fallback} manually.");
}
}
}
fn can_prompt(global: &GlobalFlags) -> bool {
std::io::stdin().is_terminal() && !global.no_input
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn discovery_hint_lists_possible_causes() {
let hint = discovery_hint();
assert!(hint.starts_with("hint: this could mean:"));
assert!(hint.contains("no Sonos speakers are on this network"));
}
#[test]
#[cfg(target_os = "macos")]
fn discovery_hint_macos_mentions_local_network() {
let hint = discovery_hint();
assert!(hint.contains("Local Network"));
assert!(hint.contains("System Settings"));
}
#[test]
#[cfg(target_os = "windows")]
fn discovery_hint_windows_mentions_firewall() {
let hint = discovery_hint();
assert!(hint.contains("Network Discovery"));
}
#[test]
#[cfg(target_os = "linux")]
fn discovery_hint_linux_mentions_ufw() {
let hint = discovery_hint();
assert!(hint.contains("ufw"));
assert!(hint.contains("239.255.255.250"));
}
#[test]
fn no_input_flag_prevents_prompt() {
let global = GlobalFlags {
speaker: None,
group: None,
quiet: false,
verbose: 0,
no_input: true,
};
assert!(!can_prompt(&global));
}
#[test]
fn discovery_failed_triggers_platform_hint() {
let err =
sonos_sdk::SdkError::DiscoveryFailed("no Sonos devices found on the network".into());
assert!(matches!(err, sonos_sdk::SdkError::DiscoveryFailed(_)));
let hint = discovery_hint();
assert!(hint.starts_with("hint:"));
}
#[test]
fn speaker_not_found_routes_to_platform_hint() {
use crate::errors::CliError;
let err = CliError::SpeakerNotFound("no speakers available".into());
let hint = err.recovery_hint().expect("should have a recovery hint");
assert_eq!(hint, discovery_hint());
}
#[test]
fn group_not_found_routes_to_platform_hint() {
use crate::errors::CliError;
let err = CliError::GroupNotFound("no groups available".into());
let hint = err.recovery_hint().expect("should have a recovery hint");
assert_eq!(hint, discovery_hint());
}
#[test]
fn sdk_discovery_failed_uses_platform_hint() {
use crate::errors::CliError;
let err = CliError::Sdk(sonos_sdk::SdkError::DiscoveryFailed("test".into()));
let hint = err.recovery_hint().unwrap();
assert_eq!(hint, discovery_hint());
}
#[test]
fn sdk_non_network_error_uses_generic_hint() {
use crate::errors::CliError;
let err = CliError::Sdk(sonos_sdk::SdkError::LockPoisoned);
let hint = err.recovery_hint().unwrap();
assert_ne!(
hint,
discovery_hint(),
"non-network SDK errors should use generic hint"
);
}
}