Merge pull request #349 from tgauth/add-div-function

add div function

Author: SteveL-MSFT

dsc_lib/src/functions/div.rs

@@ -0,0 +1,81 @@
+// Copyright (c) Microsoft Corporation.
+// Licensed under the MIT License.
+
+use crate::DscError;
+use crate::configure::context::Context;
+use crate::functions::{AcceptedArgKind, Function};
+use serde_json::Value;
+use tracing::debug;
+
+#[derive(Debug, Default)]
+pub struct Div {}
+
+impl Function for Div {
+    fn min_args(&self) -> usize {
+        2
+    }
+
+    fn max_args(&self) -> usize {
+        2
+    }
+
+    fn accepted_arg_types(&self) -> Vec<AcceptedArgKind> {
+        vec![AcceptedArgKind::Number]
+    }
+
+    fn invoke(&self, args: &[Value], _context: &Context) -> Result<Value, DscError> {
+        debug!("div function");
+        if let (Some(arg1), Some(arg2)) = (args[0].as_i64(), args[1].as_i64()) {
+            if let Some(value) = arg1.checked_div(arg2) {
+                Ok(Value::Number(value.into()))
+            } else {
+                Err(DscError::Parser("Cannot divide by zero".to_string()))
+            }
+        } else {
+            Err(DscError::Parser("Invalid argument(s)".to_string()))
+        }
+    }
+}
+
+#[cfg(test)]
+mod tests {
+    use crate::configure::context::Context;
+    use crate::parser::Statement;
+
+    #[test]
+    fn numbers() {
+        let mut parser = Statement::new().unwrap();
+        let result = parser.parse_and_execute("[div(8, 3)]", &Context::new()).unwrap();
+        assert_eq!(result, 2);
+    }
+
+    #[test]
+    fn nested() {
+        let mut parser = Statement::new().unwrap();
+        let result = parser.parse_and_execute("[div(18, div(9, 3))]", &Context::new()).unwrap();
+        assert_eq!(result, 6);
+    }
+
+    #[test]
+    fn invalid_one_parameter() {
+        let mut parser = Statement::new().unwrap();
+        let result = parser.parse_and_execute("[div(5)]", &Context::new());
+        assert!(result.is_err());
+    }
+
+    #[test]
+    fn invalid_div_by_zero() {
+        let mut parser = Statement::new().unwrap();
+        let result = parser.parse_and_execute("[div(5, 0)]", &Context::new());
+        assert!(result.is_err());
+    }
+
+    #[test]
+    fn overflow_input() {
+        let mut parser = Statement::new().unwrap();
+        // max value for i64 is 2^63 -1 (or 9,223,372,036,854,775,807)
+        let result = parser.parse_and_execute("[div(9223372036854775808, 2)]", &Context::new());
+        assert!(result.is_err());
+    }
+}
+

dsc_lib/src/functions/mod.rs

@@ -10,6 +10,7 @@ use serde_json::Value;
 pub mod base64;
 pub mod concat;
 pub mod create_array;
+pub mod div;
 pub mod envvar;
 pub mod parameters;
 pub mod resource_id;
@@ -57,6 +58,7 @@ impl FunctionDispatcher {
         functions.insert("base64".to_string(), Box::new(base64::Base64{}));
         functions.insert("concat".to_string(), Box::new(concat::Concat{}));
         functions.insert("createArray".to_string(), Box::new(create_array::CreateArray{}));
+        functions.insert("div".to_string(), Box::new(div::Div{}));
         functions.insert("envvar".to_string(), Box::new(envvar::Envvar{}));
         functions.insert("parameters".to_string(), Box::new(parameters::Parameters{}));
         functions.insert("resourceId".to_string(), Box::new(resource_id::ResourceId{}));