Iron Test

A suite of convenience methods and constructors for making requests to Iron Handlers.

Documentation

Example

```rust extern crate iron; extern crate iron_test;

use iron::prelude::*; use iron::{Handler, Headers, status}; use iron_test::{request, response};

struct HelloWorldHandler;

impl Handler for HelloWorldHandler { fn handle(&self, _: &mut Request) -> IronResult { Ok(Response::with((status::Ok, "Hello, world!"))) } }

[test]

fn testhelloworld() { let response = request::get("http://localhost:3000/hello", Headers::new(), &HelloWorldHandler).unwrap(); let resultbody = response::extractbodytobytes(response);

assert_eq!(result_body, b"Hello, world!");

} ```

API

request

The request API implements convenience methods for all the major HTTP verbs except CONNECT and TRACE. They're broken down as follows.

```Rust // Generates empty body request::get(path: &str, headers: Headers, handler: &H) -> IronResult request::options(path: &str, headers: Headers, handler: &H) -> IronResult request::delete(path: &str, headers: Headers, handler: &H) -> IronResult request::head(path: &str, headers: Headers, handler: &H) -> IronResult

// Accepts a &str body request::post(path: &str, headers: Headers, body: &str, handler: &H) -> IronResult request::patch(path: &str, headers: Headers, body: &str, handler: &H) -> IronResult request::put(path: &str, headers: Headers, body: &str, handler: &H) -> IronResult ```

The requests that it makes sense for accept a &str body, while the other requests generate an empty body for you. The request is passed directly to the handle call on the Handler, and the raw result is returned to you.

For examples of testing different handlers, head over to the examples directory.

Creating project layout for tests

Sometimes it is useful to have a predefined directory layout with specific files in it. You can easily create a simple project directory using a ProjectBuilder.

Ex:

```rust use iron_test::ProjectBuilder;

[test]

fn test_a() { let builder = ProjectBuilder::new("foo") .file("index.html", "

hello

// At this point you will have your project directory in: // target/iron-integration-tests/test-/foo/ } `` To access current project root, usep.root()`.

ProjectBuilder implements Drop and will clean up the project when it is dropped.

Installation

If you're using Cargo, just add iron-test to your Cargo.toml, and point it at the git url. ```Rust [dependencies]

iron-test = { git = "https://github.com/reem/iron-test" } ```

Author

Jonathan Reem

Get Help

Come find us on #iron or #rust on irc.mozilla.net

License

MIT