UPDATE: Adds 'user model' API (#27)

* bump version for documentation
* Fixes wrong doc comment
* renames old APIs to be consistent

xlsx/src/bin/documentation.rs

@@ -5,7 +5,7 @@
 
 use std::fs;
 
-use ironcalc_base::model::Model;
+use ironcalc_base::Model;
 
 fn main() {
     let args: Vec<_> = std::env::args().collect();

xlsx/src/compare.rs

@@ -2,7 +2,7 @@ use std::path::Path;
 
 use ironcalc_base::cell::CellValue;
 use ironcalc_base::types::*;
-use ironcalc_base::{expressions::utils::number_to_column, model::Model};
+use ironcalc_base::{expressions::utils::number_to_column, Model};
 
 use crate::export::save_to_xlsx;
 use crate::import::load_model_from_xlsx;
@@ -208,7 +208,7 @@ pub fn test_load_and_saving(file_path: &str, temp_dir_name: &Path) -> Result<(),
 #[cfg(test)]
 mod tests {
     use crate::compare::compare;
-    use ironcalc_base::model::Model;
+    use ironcalc_base::Model;
 
     #[test]
     fn compare_different_sheets() {

xlsx/src/export/mod.rs

@@ -15,8 +15,8 @@ use std::{
 };
 
 use ironcalc_base::expressions::utils::number_to_column;
-use ironcalc_base::model::{get_milliseconds_since_epoch, Model};
 use ironcalc_base::types::Workbook;
+use ironcalc_base::{get_milliseconds_since_epoch, Model};
 
 use self::xml_constants::XML_DECLARATION;
 

xlsx/src/export/test/test_export.rs

@@ -1,6 +1,6 @@
 use std::fs;
 
-use ironcalc_base::model::Model;
+use ironcalc_base::Model;
 
 use crate::error::XlsxError;
 use crate::{export::save_to_xlsx, import::load_model_from_xlsx};
@@ -31,13 +31,22 @@ fn test_values() {
     save_to_xlsx(&model, temp_file_name).unwrap();
 
     let model = load_model_from_xlsx(temp_file_name, "en", "UTC").unwrap();
-    assert_eq!(model.formatted_cell_value(0, 1, 1).unwrap(), "123.456");
-    assert_eq!(model.formatted_cell_value(0, 2, 1).unwrap(), "Hello world!");
-    assert_eq!(model.formatted_cell_value(0, 3, 1).unwrap(), "Hello world!");
-    assert_eq!(model.formatted_cell_value(0, 4, 1).unwrap(), "你好世界！");
-    assert_eq!(model.formatted_cell_value(0, 5, 1).unwrap(), "TRUE");
-    assert_eq!(model.formatted_cell_value(0, 6, 1).unwrap(), "FALSE");
-    assert_eq!(model.formatted_cell_value(0, 7, 1).unwrap(), "#VALUE!");
+    assert_eq!(model.get_formatted_cell_value(0, 1, 1).unwrap(), "123.456");
+    assert_eq!(
+        model.get_formatted_cell_value(0, 2, 1).unwrap(),
+        "Hello world!"
+    );
+    assert_eq!(
+        model.get_formatted_cell_value(0, 3, 1).unwrap(),
+        "Hello world!"
+    );
+    assert_eq!(
+        model.get_formatted_cell_value(0, 4, 1).unwrap(),
+        "你好世界！"
+    );
+    assert_eq!(model.get_formatted_cell_value(0, 5, 1).unwrap(), "TRUE");
+    assert_eq!(model.get_formatted_cell_value(0, 6, 1).unwrap(), "FALSE");
+    assert_eq!(model.get_formatted_cell_value(0, 7, 1).unwrap(), "#VALUE!");
 
     fs::remove_file(temp_file_name).unwrap();
 }
@@ -59,10 +68,10 @@ fn test_formulas() {
     save_to_xlsx(&model, temp_file_name).unwrap();
 
     let model = load_model_from_xlsx(temp_file_name, "en", "UTC").unwrap();
-    assert_eq!(model.formatted_cell_value(0, 1, 2).unwrap(), "11");
-    assert_eq!(model.formatted_cell_value(0, 2, 2).unwrap(), "13");
-    assert_eq!(model.formatted_cell_value(0, 3, 2).unwrap(), "15");
-    assert_eq!(model.formatted_cell_value(0, 4, 2).unwrap(), "58.5");
+    assert_eq!(model.get_formatted_cell_value(0, 1, 2).unwrap(), "11");
+    assert_eq!(model.get_formatted_cell_value(0, 2, 2).unwrap(), "13");
+    assert_eq!(model.get_formatted_cell_value(0, 3, 2).unwrap(), "15");
+    assert_eq!(model.get_formatted_cell_value(0, 4, 2).unwrap(), "58.5");
     fs::remove_file(temp_file_name).unwrap();
 }
 

xlsx/src/import/mod.rs

@@ -16,8 +16,8 @@ use std::{
 use roxmltree::Node;
 
 use ironcalc_base::{
-    model::Model,
     types::{Metadata, Workbook, WorkbookSettings},
+    Model,
 };
 
 use crate::error::XlsxError;

xlsx/src/lib.rs

@@ -1,7 +1,7 @@
 //! # IronCalc - Core API documentation
 //!
 //! This technical API documentation is aimed at developers.
-//! It is used to build language bindings (like python, javascript or nodejs) or to build full fledged applications like ironCalc in the terminal or IronCalc, the Web application.
+//! It is used to build language bindings (like python, javascript or nodejs) or to build full fledged applications like TironCalc in the terminal or IronCalc, the Web application.
 //!
 //! ## Basic usage
 //!
@@ -9,7 +9,7 @@
 //!
 //! ```toml
 //! [dependencies]
-//! ironcalc = { git = "https://github.com/ironcalc/IronCalc", version = "0.1"}
+//! ironcalc = { git = "https://github.com/ironcalc/IronCalc" }
 //! ```
 //!
 //! <small> until version 0.5.0 you should use the git dependencies as stated </small>