Method parse

crates/openshell-core/src/forward.rs:555–580

Parse a `[bind_address:]port` string. Examples: - `"8080"` → `ForwardSpec { bind_addr: "127.0.0.1", port: 8080 }` - `"0.0.0.0:8080"` → `ForwardSpec { bind_addr: "0.0.0.0", port: 8080 }` - `"::1:8080"` → `ForwardSpec { bind_addr: "::1", port: 8080 }`

(s: &str)

    /// - `"0.0.0.0:8080"` → `ForwardSpec { bind_addr: "0.0.0.0", port: 8080 }`
    /// - `"::1:8080"` → `ForwardSpec { bind_addr: "::1", port: 8080 }`
    pub fn parse(s: &str) -> Result<Self> {
        // Split on the last ':' to handle IPv6 addresses like "::1:8080".
        if let Some(pos) = s.rfind(':') {
            let addr = &s[..pos];
            let port_str = &s[pos + 1..];
            if let Ok(port) = port_str.parse::<u16>() {
                if port == 0 {
                    return Err(miette::miette!("port must be between 1 and 65535"));
                }
                return Ok(Self {
                    bind_addr: addr.to_string(),
                    port,
                });
            }
        }

        // No colon or the part after the last colon isn't a valid port —
        // treat the entire string as a port number.
        let port: u16 = s.parse().map_err(|_| {
            miette::miette!("invalid forward spec '{s}': expected [bind_address:]port")
        })?;
        if port == 0 {
            return Err(miette::miette!("port must be between 1 and 65535"));
        }
        Ok(Self::new(port))
    }

    /// The SSH `-L` local-forward argument: `bind_addr:port:127.0.0.1:port`.
    pub fn ssh_forward_arg(&self) -> String {