thruster 0.5.0-beta2

A middleware based http async web server.
Documentation
use std::collections::HashMap;
use std::vec::Vec;

use middleware::{Middleware};
use route_tree::RouteTree;
use context::Context;
use app::App;

pub struct MatchedRoute<'a, T: 'static + Context + Send> {
  pub value: String,
  pub params: HashMap<String, String>,
  pub query_params: HashMap<String, String>,
  pub middleware: &'a Vec<Middleware<T>>,
  pub sub_app: Option<App<T>>
}

pub struct RouteParser<T: 'static + Context + Send> {
  pub route_tree: RouteTree<T>
}

impl<T: Context + Send> RouteParser<T> {
  pub fn new() -> RouteParser<T> {
    let parser = RouteParser {
      route_tree: RouteTree::new(),
    };

    parser
  }

  pub fn add_method_agnostic_middleware(&mut self, route: &str, middleware: Middleware<T>) {
    self.route_tree.add_use_node(route, vec![middleware]);
  }

  pub fn add_route(&mut self, route: &str, middleware: Vec<Middleware<T>>) {
    self.route_tree.add_route(route, middleware);
  }

  pub fn match_route(&self, route: &str) -> MatchedRoute<T> {
    let mut query_params = HashMap::new();

    let mut iter = route.split("?");
    let route = iter.next().unwrap();
    match iter.next() {
      Some(query_string) => {
        for query_piece in query_string.split("&") {
          let mut query_iterator = query_piece.split("=");
          let key = query_iterator.next().unwrap().to_owned();
          match query_iterator.next() {
            Some(val) => query_params.insert(key, val.to_owned()),
            None => query_params.insert(key, "true".to_owned())
          };
        }
      },
      None => ()
    };

    let matched = self.route_tree.match_route(route);

    MatchedRoute {
      value: route.to_owned(),
      params: matched.1,
      query_params: query_params,
      middleware: matched.0,
      sub_app: None
    }
  }
}

#[cfg(test)]
mod tests {
  use super::RouteParser;
  use context::BasicContext;
  use middleware::{MiddlewareChain, MiddlewareReturnValue};
  use futures::future;
  use std::boxed::Box;

  // #[test]
  // fn it_should_should_be_able_to_generate_a_simple_parsed_route() {
  //   let mut route_parser = RouteParser::<BasicContext>::new();
  //   route_parser.add_route("1/2/3", Vec::new());

  //   let route_node = route_parser._route_root_node.children.get(&"1".to_owned()).unwrap();
  //   let second_child_node = route_node.children.get(&"2".to_owned()).unwrap();
  //   let third_child_node = second_child_node.children.get(&"3".to_owned()).unwrap();

  //   assert!(route_node.value == "1".to_owned());
  //   assert!(route_node.children.len() == 1);

  //   assert!(second_child_node.value == "2".to_owned());
  //   assert!(second_child_node.children.len() == 1);

  //   assert!(third_child_node.value == "3".to_owned());
  //   assert!(third_child_node.children.len() == 0);
  // }

  #[test]
  fn it_should_return_a_matched_path_for_a_good_route() {
    let mut route_parser = RouteParser::<BasicContext>::new();
    route_parser.add_route("1/2/3/4", Vec::new());

    assert!(route_parser.match_route("1/2/3/4").value == "1/2/3/4");
  }

  #[test]
  fn it_should_use_not_found_for_not_handled_routes() {
    let mut route_parser = RouteParser::<BasicContext>::new();
    route_parser.add_route("1/2/3/4", Vec::new());

    assert!(route_parser.match_route("5").value == "5");
  }

  #[test]
  fn it_should_return_a_matched_path_for_a_good_route_with_multiple_similar_routes() {
    let mut route_parser = RouteParser::<BasicContext>::new();
    route_parser.add_route("1/2/3/6", Vec::new());
    route_parser.add_route("1/2/3/4/5", Vec::new());
    route_parser.add_route("1/2/3/4", Vec::new());

    assert!(route_parser.match_route("1/2/3/4").value == "1/2/3/4");
  }

  #[test]
  fn it_should_appropriately_define_route_params() {
    let mut route_parser = RouteParser::<BasicContext>::new();
    route_parser.add_route("1/:param/2", Vec::new());

    let matched = route_parser.match_route("1/somevar/2");

    assert!(matched.params.get("param").unwrap() == "somevar");
  }

  #[test]
  fn when_adding_a_route_it_should_return_a_struct_with_all_appropriate_middleware() {
    fn test_function(context: BasicContext, _chain: &MiddlewareChain<BasicContext>) -> MiddlewareReturnValue<BasicContext> {
      Box::new(future::ok(context))
    }

    let mut route_parser = RouteParser::<BasicContext>::new();
    route_parser.add_route("1/2/3", vec![test_function]);

    let matched = route_parser.match_route("1/2/3");
    assert!(matched.middleware.len() == 1);
    // assert!(matched.middleware.get(0).unwrap() == &(test_function as Middleware));
  }

  #[test]
  fn when_adding_a_route_with_method_agnostic_middleware() {
    fn method_agnostic(context: BasicContext, _chain: &MiddlewareChain<BasicContext>) -> MiddlewareReturnValue<BasicContext> {
      Box::new(future::ok(context))
    }

    fn test_function(context: BasicContext, _chain: &MiddlewareChain<BasicContext>) -> MiddlewareReturnValue<BasicContext> {
      Box::new(future::ok(context))
    }

    let mut route_parser = RouteParser::<BasicContext>::new();
    route_parser.add_method_agnostic_middleware("/", method_agnostic);
    route_parser.add_route("/__GET__/1/2/3", vec![test_function]);

    let matched = route_parser.match_route("__GET__/1/2/3");
    assert!(matched.middleware.len() == 2);
  }
}