coap-rs

Travis Build Status Windows Build Status Downloads Coverage Status MIT licensed

A fast and stable Constrained Application Protocol(CoAP) library implemented in Rust.

Features: - CoAP core protocol RFC 7252 - CoAP Observe option RFC 7641

Documentation

Installation

First add this to your Cargo.toml:

toml [dependencies] coap = "0.7"

Then, add this to your crate root:

rust extern crate coap;

Example

Server:

```rust extern crate coap;

use std::io; use coap::{CoAPServer, CoAPResponse, CoAPRequest, Method};

fn requesthandler(request: CoAPRequest) -> Option { match request.getmethod() { &Method::Get => println!("request by get {}", request.getpath()), &Method::Post => println!("request by post {}", String::fromutf8(request.message.payload).unwrap()), _ => println!("request by other method"), };

// Return the auto-generated response
request.response

}

fn main() { let addr = "127.0.0.1:5683";

let mut server = CoAPServer::new(addr).unwrap();
server.handle(request_handler).unwrap();

println!("Server up on {}", addr);
println!("Press any key to stop...");
io::stdin().read_line(&mut String::new()).unwrap();

println!("Server shutdown");

} ```

Client:

```rust extern crate coap;

use coap::{CoAPClient, CoAPResponse};

fn main() { let url = "coap://127.0.0.1:5683/Rust"; println!("Client request: {}", url);

let response = CoAPClient::get(url).unwrap();
println!("Server reply: {}", String::from_utf8(response.message.payload).unwrap());

} ```

Benchmark

bash $ cargo run --example server $ cargo bench