This package contains a Rust Dredd hook handler which provides a bridge between the Dredd API Testing Framework and Rust environment to ease implementation of testing hooks provided by Dredd. Write Dredd hooks in Rust to glue together API Blueprint with your Rust project.
Not sure what these Dredd Hooks are? Read the Dredd documentation on them.
The following are a few examples of what hooks can be used for:
If you don't have it already, install the Dredd CLI via npm:
bash
npm install -g dredd
In order for the Dredd CLI to be able to interface with your test binaries, you need to have the dredd-hooks-rust binary installed, which you can get by running:
```bash
dredd-hooks-rust and cargo-dreddcargo install dredd-hooks ```
To start testing your Rust project with Dredd, just add dredd-hooks to your Cargo.toml:
toml
[dependencies]
dredd-hooks = "0.3.0"
Or if you have cargo-edit installed you can just run this on the command line:
bash
cargo add dredd-hooks
Following this is a short example showcasing Dredd tests running against an iron server.
The name of the project in this example is assumed to be dredd-rust-test:
test.apib
```apib
main.rs:
```rust
extern crate iron;
extern crate router;
extern crate dredd_hooks;
use iron::prelude::*; use router::Router; use dredd_hooks::{HooksServer};
// HTTP endpoint
fn endpoint(_: &mut Request) -> IronResult
fn main() { let mut hooks = HooksServer::new(); // Start the server before any of the tests are running. hooks.before_all(Box::new(|tr| { ::std::thread::spawn(move || { let mut router = Router::new(); router.get("/message", endpoint, "endpoint");
Iron::new(router).http("127.0.0.1:3000").unwrap();
});
tr
}));
// Execute a hook before a specific test.
hooks.before("/message > GET", Box::new(|mut tr| {
// Set the skip flag on this test.
// Comment out the next line and you should see a passing test.
tr.insert("skip".to_owned(), true.into());
tr
}));
HooksServer::start_from_env(hooks);
} ```
Run the command:
bash
cargo build && dredd ./test.apib http://127.0.0.1:3000 --language=dredd-hooks-rust --hookfiles=target/debug/dredd-rust-test
You should now see Dredd trying to run the tests against the binary that was just compiled, but actually skipping the single test it tries to run because we told Dredd to do so via a before hook.
The quickstart example above assumes that the hookfile is compiled as a bin target.
However, in most projects, you will probably want to have a more robust setup that looks like this:
Cargo.toml:
```toml [[test]] name = "dreddtesthooks" path = "tests/dredd/hooks.rs" test = false harness = false
[package.metadata.dreddhooks] hooktargets = ["dreddtesthooks"] ```
Setting the test value to false, is needed so that our blocking hookserver doesn't interfere with the other tests when running cargo test.
Setting the harness to false will result in the test binary being compiled without a test harness, because we already have dredd as our test harness.
Finally the values under package.metadata.dredd_hooks give us some additional metadata about our test setup, which allows us to use the cargo dredd command to simplify the invocation:
cargo dredd ./test.apib http://127.0.0.1:3000
Licensed under either of
at your option.
Thank you to: - The developers behind goodman for providing a good example of how to integrate Dredd with a compiled language.