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 unvalidated_output_banner() -> String {
const RULE: &str = "────────────────────────────────────────────────────────────";
format!(
"{RULE}\n\
WARNING: no speaker responded — this output was not verified.\n\
\n\
Every request this command made failed. The names and values it\n\
printed came from the cached list of speakers on disk, not from any\n\
speaker, so they may be stale or simply wrong.\n\
\n\
{hint}\n\
\n\
Use --require-live to make this an error instead, or --offline to\n\
accept cached data quietly.\n\
{RULE}",
hint = discovery_hint()
)
}
pub fn unvalidated_output_note() -> &'static str {
"note: no speaker responded; showing cached data (--offline)"
}
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,
no_input: true,
..Default::default()
};
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"
);
}
}