Rusqbin
Rusqbin is a web server that stashes your requests for later retrieval. It is available as both a binary and a library through crates.io.
Rusdocs are published for:
Usage
Web API
The web server has the following API for dealing with request bins.
POST
/rusqbins To create a bin and get back bin_idGET
/rusqbins To list bin summariesGET
/rusqbins/${bin_id} To get bin-specific information (lists all requests in the bin)GET
/rusqbins/${bin_id}/requests To get detailed request information for a binDELETE
/rusqbins/${bin_id} To delete a bin
In any other case, send requests with a X-Rusqbin-Id header with a bin_id to have your requests logged to a bin for later retrieval.
Binary
To use Rusqbin as a binary, simply install it using cargo install rusqbin
and then run rusqbin-server
,
and follow the simple usage instructions. The port the server runs on can be set by optionally adding a port argument.
Logging is handled by env_logger
, so you can configure it at runtime using
a RUST_LOG
environment variable.
Library
To use it as a library, add it to your project as a crate dependency, then from within Rust code:
extern crate rusqbin;
extern crate hyper;
extern crate rustc_serialize;
use *;
use *;
use *;
use json;
use Client;
use Read;
// Start a BinsServer on port 9000
let s = new;
let mut l = s.start.unwrap;
let client = new;
// Create a bin via HTTP
let mut resp = client.post.send.unwrap;
let mut string = String new;
let _ = resp.read_to_string.unwrap;
let bin: BinSummary = decode.unwrap;
let bin_id = bin.id.value;
// Fire an HTTP request with the proper X-Rusqbin-Id header
let _ = client.get.header.send.unwrap;
// Access bin storage from within Rust code.
let ref storage = s.storage.lock.unwrap;
let bin_requests: &Bin = storage.get_bin.unwrap;
let ref req = bin_requests;
assert_eq!;
assert_eq!;
l.close.unwrap;
In the example above, we use the out-of-the-box InMemoryBins
for storage, but you can pass any given implementation of
rusqbin::storage::Bins
when creating a BinsServer.
Credit
Rusqbin is a simple port of Requestbin written in Rust. Inspired by Requestinator