1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104
//! Implementation of the [CoAP Protocol][spec]. //! //! This library provides both a client interface (`CoAPClient`) //! and a server interface (`CoAPServer`). //! //! Features: //! - CoAP core protocol [RFC 7252](https://tools.ietf.org/rfc/rfc7252.txt) //! - CoAP Observe option [RFC 7641](https://tools.ietf.org/rfc/rfc7641.txt) //! //! # Installation //! //! First add this to your `Cargo.toml`: //! //! ```toml //! [dependencies] //! coap = "0.7" //! ``` //! //! Then, add this to your crate root: //! //! ``` //! extern crate coap; //! ``` //! //! # Example //! //! ## Server: //! ```no_run //! extern crate coap; //! use std::io; //! use coap::{CoAPServer, CoAPClient, CoAPRequest, CoAPResponse, Method}; //! fn request_handler(request: CoAPRequest) -> Option<CoAPResponse> { //! match request.get_method() { //! &Method::Get => println!("request by get {}", request.get_path()), //! &Method::Post => println!("request by post {}", String::from_utf8(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: //! ```no_run //! 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()); //! } //! ``` extern crate bincode; extern crate rustc_serialize; extern crate mio; extern crate url; extern crate num; extern crate rand; extern crate threadpool; extern crate regex; #[macro_use] extern crate enum_primitive; #[cfg(test)] extern crate quickcheck; #[macro_use] extern crate log; pub use client::CoAPClient; pub use message::header::MessageType; pub use message::IsMessage; pub use message::packet::CoAPOption; pub use message::request::CoAPRequest; pub use message::request::Method; pub use message::response::CoAPResponse; pub use message::response::Status; pub use server::CoAPServer; pub mod message; pub mod client; pub mod server; mod observer;