# A simple yet functional SSDP client written in Rust

A little personal experiment to:
1) learn the Rust's networking (and specifically UDP related) APIs
1) implement a working and easy to use SSDP Client 
1) learn a little more about SSDP

Currently, ~~documentation and~~ testing coverage is pretty lacking. This will be addressed in subsequent commits.

## Building

    cargo build

### Release Candidate

    cargo build --release

## Running

### Local Testing

    $ ./target/debug/simple_ssdp_client --help

### Release Candidate

    $ ./target/release/simple_ssdp_client --help

## Example Usage
   
### As an App
    
    $ ./target/debug/simple_ssdp_client --server=roku
    {"server" : "roku/9.2.0 upnp/1.0 roku/9.2.0", "location: "http://192.168.1.25:8060/"}
    
#### Showing SSDP M-Search Payload

    $ ./target/debug/simple_ssdp_client --print-payload

        M-SEARCH * HTTP/1.1
        Host: 239.255.255.250:1900
        Man: "ssdp:discover"
        ST: ssdp:all
        MX: 5

### As a Lib

### Cargo.toml
    
    ssdp = { package = "simple-ssdp-client", version = "0.1.4" }

### mod declaration

    extern crate ssdp;
    

#### Code

    # optionally if you wanted to use a server response outside of this context
    let mut url = String::new(); 
    let print_headers = |response_headers: &ResponseHeaders| {
        fn determine_server(abc: &ArgMatches) -> String {
            match abc.value_of("server_pattern") {
                Some(server) => { return String::from(server) }
                None => { return String::new() }
            };
        }
        let resolved_server = determine_server( &args());
        if response_headers.server.contains(resolved_server.as_str()) {
            println!("{{\"server\" : \"{}\", \"location: \"{}\"}}", response_headers.server, response_headers.location);
            url = response_headers.location.clone(); # see above
            exit(0);
        }
    };

    ssdp::listen( print_headers)