4 releases
Uses old Rust 2015
0.1.3 | Aug 6, 2018 |
---|---|
0.1.2 | Aug 5, 2018 |
0.1.1 | Aug 5, 2018 |
0.1.0 | Aug 5, 2018 |
#766 in HTTP server
18KB
354 lines
Gabira
A rust library for testing HTTP servers. It focuses on ergonomics and brevity.
Documentation:
Usage
Add the following dependency to your Cargo.toml:
[dev-dependencies]
gabira = "0.1"
and import it in your tests:
extern crate gabira;
use gabira::*;
Example
get("http://localhost:3000/ping")
.expect_status(200) // <- Assert http status code
.expect_body("pong") // <- Assert response body
.end(); // <- Consume the test. Compile-time warnings are issued if forgotten.
Here's an example with actix-web's TestServer:
let srv = TestServer::with_factory(|| {
App::new().resource("/login", |r| r.method(Method::POST).with(login))
});
// POST request with json body
post(&srv.url("/login"))
.send_json(LoginDto {
username: "...",
password: "...",
}).expect_status(200)
.expect_json(TokenDto {
token: "...",
})
.end();
Expectations can be chained:
let invoice: InvoiceDto = post(&url)
.set_header("Authorization", &token)
.set_header("Accept", "application/json")
.send_json(CreateInvoiceDto { ... })
.expect_status(200)
.expect_header("Access-Control-Allow-Origin", "*")
.expect_header("Access-Control-Allow-Credentials", "true")
.expect(|r| println!("{}", r.headers().len()))
.expect(|r| assert!(r.headers().len() > 2))
.end_json_with(|r: &InvoiceDto| {
assert!(r.total > 1000);
});
process_invoice(&invoice);
API
get(path: &str)
post(path: &str)
put(path: &str)
delete(path: &str)
.set_cookie(name: &str, value: &str)
.set_header(field: &str, value: &str)
.send(body: Into<Body>)
.send_json(json: Serialize)
.send_form(json: Serialize)
.expect_status(status: u16)
.expect_cookie(name: &str, value: &str)
.expect_header(field: &str, value: &str)
.expect_json(json: Serialize)
.expect_form(form: Serialize)
.expect_body(body: Into<Body>)
.expect(f: FnMut(&ClientResponse))
.end() -> ClientResponse
.end_with(f: FnMut(&ClientResponse)) -> ClientResponse
.end_json<T: DeserializeOwned>() -> T
.end_json_with<T: DeserializeOwned>(f: FnMut(&T)) -> T
Functionality
- Requests are synchronous
- Expectations (e.g.
expect_status
,expect_json
) are run in the order of definition
Limitations
Range of assertions are limited for the moment. See the documentation.
License
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.
Dependencies
~27MB
~499K SLoC