use failure::*; use std::collections::HashMap; use serde_json::{json, Value}; use url::form_urlencoded; use regex::Regex; use std::fmt; pub type PropertyMap = HashMap<&'static str, Schema>; #[derive(Debug, Fail)] pub struct ParameterError { error_list: Vec, } impl ParameterError { fn new() -> Self { Self { error_list: vec![] } } fn push(&mut self, value: Error) { self.error_list.push(value); } fn len(&self) -> usize { self.error_list.len() } } impl fmt::Display for ParameterError { fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result { let msg = self.error_list.iter().fold(String::from(""), |acc, item| { acc + &item.to_string() + "\n" }); write!(f, "{}", msg) } } #[derive(Debug)] pub struct BooleanSchema { pub description: &'static str, pub optional: bool, pub default: Option, } #[derive(Debug)] pub struct IntegerSchema { pub description: &'static str, pub optional: bool, pub minimum: Option, pub maximum: Option, pub default: Option, } #[derive(Debug)] pub struct StringSchema { pub description: &'static str, pub optional: bool, pub default: Option<&'static str>, pub min_length: Option, pub max_length: Option, pub format: ApiStringFormat, } #[derive(Debug)] pub struct ArraySchema { pub description: &'static str, pub optional: bool, pub items: Box, } #[derive(Debug)] pub struct ObjectSchema { pub description: &'static str, pub optional: bool, pub additional_properties: bool, pub properties: HashMap<&'static str, Schema>, } #[derive(Debug)] pub enum Schema { Null, Boolean(BooleanSchema), Integer(IntegerSchema), String(StringSchema), Object(ObjectSchema), Array(ArraySchema), } pub const DEFAULTBOOL: BooleanSchema = BooleanSchema { description: "", optional: false, default: None, }; #[macro_export] macro_rules! Boolean { ($($name:ident => $e:expr),*) => {{ Schema::Boolean(BooleanSchema { $($name: $e, )* ..DEFAULTBOOL}) }} } pub const DEFAULTINTEGER: IntegerSchema = IntegerSchema { description: "", optional: false, default: None, minimum: None, maximum: None, }; #[macro_export] macro_rules! Integer { ($($name:ident => $e:expr),*) => {{ Schema::Integer(IntegerSchema { $($name: $e, )* ..DEFAULTINTEGER}) }} } pub const DEFAULTSTRING: StringSchema = StringSchema { description: "", optional: false, default: None, min_length: None, max_length: None, format: ApiStringFormat::None, }; #[derive(Debug)] pub enum ApiStringFormat { None, Enum(Vec), Pattern(Box), Complex(Box), } #[macro_export] macro_rules! ApiString { ($($name:ident => $e:expr),*) => {{ Schema::String(StringSchema { $($name: $e, )* ..DEFAULTSTRING}) }} } #[macro_export] macro_rules! parameter { () => {{ let inner = ObjectSchema { description: "", optional: false, additional_properties: false, properties: HashMap::<&'static str, Schema>::new(), }; Schema::Object(inner) }}; ($($name:ident => $e:expr),*) => {{ let inner = ObjectSchema { description: "", optional: false, additional_properties: false, properties: { let mut map = HashMap::<&'static str, Schema>::new(); $( map.insert(stringify!($name), $e); )* map } }; Schema::Object(inner) }}; } fn parse_simple_value(value_str: &str, schema: &Schema) -> Result { let value = match schema { Schema::Null => { bail!("internal error - found Null schema."); } Schema::Boolean(_jss_boolean) => { let res = match value_str.to_lowercase().as_str() { "1" | "on" | "yes" | "true" => true, "0" | "off" | "no" | "false" => false, _ => bail!("Unable to parse boolean option."), }; Value::Bool(res) } Schema::Integer(jss_integer) => { let res: isize = value_str.parse()?; if let Some(minimum) = jss_integer.minimum { if res < minimum { bail!("value must have a minimum value of {}", minimum); } } if let Some(maximum) = jss_integer.maximum { if res > maximum { bail!("value must have a maximum value of {}", maximum); } } Value::Number(res.into()) } Schema::String(jss_string) => { let res: String = value_str.into(); let char_count = res.chars().count(); if let Some(min_length) = jss_string.min_length { if char_count < min_length { bail!("value must be at least {} characters long", min_length); } } if let Some(max_length) = jss_string.max_length { if char_count > max_length { bail!("value may only be {} characters long", max_length); } } match jss_string.format { ApiStringFormat::None => { /* do nothing */ } ApiStringFormat::Pattern(ref regex) => { if !regex.is_match(&res) { bail!("value does not match the regex pattern"); } } ApiStringFormat::Enum(ref stringvec) => { if stringvec.iter().find(|&e| *e == res) == None { bail!("value is not defined in the enumeration."); } } ApiStringFormat::Complex(ref _subschema) => { bail!("implement me!"); } } Value::String(res) } _ => bail!("unable to parse complex (sub) objects."), }; Ok(value) } pub fn parse_parameter_strings(data: &Vec<(String, String)>, schema: &Schema, test_required: bool) -> Result { println!("QUERY Strings {:?}", data); let mut params = json!({}); let mut errors = ParameterError::new(); match schema { Schema::Object(ObjectSchema { properties, additional_properties, .. }) => { for (key, value) in data { if let Some(prop_schema) = properties.get::(key) { match prop_schema { Schema::Array(jss_array) => { if params[key] == Value::Null { params[key] = json!([]); } match params[key] { Value::Array(ref mut array) => { match parse_simple_value(value, &jss_array.items) { Ok(res) => array.push(res), Err(err) => errors.push(format_err!("parameter '{}': {}", key, err)), } } _ => errors.push(format_err!("parameter '{}': expected array - type missmatch", key)), } } _ => { match parse_simple_value(value, prop_schema) { Ok(res) => { if params[key] == Value::Null { params[key] = res; } else { errors.push(format_err!("parameter '{}': duplicate parameter.", key)); } }, Err(err) => errors.push(format_err!("parameter '{}': {}", key, err)), } } } } else { if *additional_properties { match params[key] { Value::Null => { params[key] = Value::String(value.to_owned()); }, Value::String(ref old) => { params[key] = Value::Array( vec![Value::String(old.to_owned()), Value::String(value.to_owned())]); } Value::Array(ref mut array) => { array.push(Value::String(value.to_string())); } _ => errors.push(format_err!("parameter '{}': expected array - type missmatch", key)), } } else { errors.push(format_err!("parameter '{}': schema does not allow additional properties.", key)); } } } if test_required && errors.len() == 0 { for (name, prop_schema) in properties { let optional = match prop_schema { Schema::Boolean(jss_boolean) => jss_boolean.optional, Schema::Integer(jss_integer) => jss_integer.optional, Schema::String(jss_string) => jss_string.optional, Schema::Array(jss_array) => jss_array.optional, Schema::Object(jss_object) => jss_object.optional, Schema::Null => true, }; if optional == false && params[name] == Value::Null { errors.push(format_err!("parameter '{}': parameter is missing and it is not optional.", name)); } } } } _ => errors.push(format_err!("Got unexpected schema type in parse_parameter_strings.")), } if errors.len() > 0 { Err(errors) } else { Ok(params) } } pub fn parse_query_string(query: &str, schema: &Schema, test_required: bool) -> Result { let param_list: Vec<(String, String)> = form_urlencoded::parse(query.as_bytes()).into_owned().collect(); parse_parameter_strings(¶m_list, schema, test_required) } #[test] fn test_shema1() { let schema = Schema::Object(ObjectSchema { description: "TEST", optional: false, additional_properties: false, properties: { let map = HashMap::new(); map } }); println!("TEST Schema: {:?}", schema); } #[test] fn test_query_string() { let schema = parameter!{name => ApiString!{ optional => false }}; let res = parse_query_string("", &schema, true); assert!(res.is_err()); let schema = parameter!{name => ApiString!{ optional => true }}; let res = parse_query_string("", &schema, true); assert!(res.is_ok()); // TEST min_length and max_length let schema = parameter!{name => ApiString!{ optional => false, min_length => Some(5), max_length => Some(10) }}; let res = parse_query_string("name=abcd", &schema, true); assert!(res.is_err()); let res = parse_query_string("name=abcde", &schema, true); assert!(res.is_ok()); let res = parse_query_string("name=abcdefghijk", &schema, true); assert!(res.is_err()); let res = parse_query_string("name=abcdefghij", &schema, true); assert!(res.is_ok()); // TEST regex pattern let schema = parameter!{name => ApiString!{ optional => false, format => ApiStringFormat::Pattern(Box::new(Regex::new("test").unwrap())) }}; let res = parse_query_string("name=abcd", &schema, true); assert!(res.is_err()); let res = parse_query_string("name=ateststring", &schema, true); assert!(res.is_ok()); let schema = parameter!{name => ApiString!{ optional => false, format => ApiStringFormat::Pattern(Box::new(Regex::new("^test$").unwrap())) }}; let res = parse_query_string("name=ateststring", &schema, true); assert!(res.is_err()); let res = parse_query_string("name=test", &schema, true); assert!(res.is_ok()); // TEST string enums let schema = parameter!{name => ApiString!{ optional => false, format => ApiStringFormat::Enum(vec!["ev1".into(), "ev2".into()]) }}; let res = parse_query_string("name=noenum", &schema, true); assert!(res.is_err()); let res = parse_query_string("name=ev1", &schema, true); assert!(res.is_ok()); let res = parse_query_string("name=ev2", &schema, true); assert!(res.is_ok()); let res = parse_query_string("name=ev3", &schema, true); assert!(res.is_err()); } #[test] fn test_query_integer() { let schema = parameter!{count => Integer!{ optional => false }}; let res = parse_query_string("", &schema, true); assert!(res.is_err()); let schema = parameter!{count => Integer!{ optional => true, minimum => Some(-3), maximum => Some(50) }}; let res = parse_query_string("", &schema, true); assert!(res.is_ok()); let res = parse_query_string("count=abc", &schema, false); assert!(res.is_err()); let res = parse_query_string("count=30", &schema, false); assert!(res.is_ok()); let res = parse_query_string("count=-1", &schema, false); assert!(res.is_ok()); let res = parse_query_string("count=300", &schema, false); assert!(res.is_err()); let res = parse_query_string("count=-30", &schema, false); assert!(res.is_err()); let res = parse_query_string("count=50", &schema, false); assert!(res.is_ok()); let res = parse_query_string("count=-3", &schema, false); assert!(res.is_ok()); } #[test] fn test_query_boolean() { let schema = parameter!{force => Boolean!{ optional => false }}; let res = parse_query_string("", &schema, true); assert!(res.is_err()); let schema = parameter!{force => Boolean!{ optional => true }}; let res = parse_query_string("", &schema, true); assert!(res.is_ok()); let res = parse_query_string("a=b", &schema, true); assert!(res.is_err()); let res = parse_query_string("force", &schema, true); assert!(res.is_err()); let res = parse_query_string("force=yes", &schema, true); assert!(res.is_ok()); let res = parse_query_string("force=1", &schema, true); assert!(res.is_ok()); let res = parse_query_string("force=On", &schema, true); assert!(res.is_ok()); let res = parse_query_string("force=TRUE", &schema, true); assert!(res.is_ok()); let res = parse_query_string("force=TREU", &schema, true); assert!(res.is_err()); let res = parse_query_string("force=NO", &schema, true); assert!(res.is_ok()); let res = parse_query_string("force=0", &schema, true); assert!(res.is_ok()); let res = parse_query_string("force=off", &schema, true); assert!(res.is_ok()); let res = parse_query_string("force=False", &schema, true); assert!(res.is_ok()); } /* #[test] fn test_shema1() { static PARAMETERS1: PropertyMap = propertymap!{ force => &Boolean!{ description => "Test for boolean options." }, text1 => &ApiString!{ description => "A simple text string.", min_length => Some(10), max_length => Some(30) }, count => &Integer!{ description => "A counter for everything.", minimum => Some(0), maximum => Some(10) }, myarray1 => &Array!{ description => "Test Array of simple integers.", items => &PVE_VMID }, myarray2 => &Schema::Array(ArraySchema { description: "Test Array of simple integers.", optional: Some(false), items: &Object!{description => "Empty Object."}, }), myobject => &Object!{ description => "TEST Object.", properties => &propertymap!{ vmid => &PVE_VMID, loop => &Integer!{ description => "Totally useless thing.", optional => Some(false) } } }, emptyobject => &Object!{description => "Empty Object."} }; for (k, v) in PARAMETERS1.entries { println!("Parameter: {} Value: {:?}", k, v); } } */