Switched rules to Regexes, added Regex wrapper for serde

This should be left to the client crate, `settings::utils::read_file`
is already here for that

Cargo.toml

@@ -7,8 +7,12 @@ edition = "2018"
 # See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html
 
 [dependencies]
+# Logger
+log = "0.4"
+simplelog = "0.7"
+# Struct serializing and deserializing
 serde = {version = "1.0", features = ["derive"]}
 serde_yaml = "0.7"
 serde_json = "1.0"
-log = "0.4"
-simplelog = "0.7"
+# Regex support
+regex = "1.3"

src/lib.rs

@@ -13,16 +13,13 @@
 //! user-defined sound changes to words and texts based on regex expressions.
 
 use std::fs::File;
-use std::io::Result;
-use std::path::PathBuf;
-
 extern crate log;
 extern crate simplelog;
 use log::{info, warn};
 use simplelog::*;
 
+
 pub mod settings;
-use settings::utils;
 
 /// Initializes the crate
 ///
@@ -67,8 +64,3 @@ pub fn init() -> std::result::Result<(), log::SetLoggerError> {
         }
     }
 }
-
-/// Import user input from a text file and return them as a String
-pub fn import_input(path: PathBuf) -> Result<String> {
-    utils::read_file(&path)
-}

src/settings/mod.rs

@@ -4,28 +4,132 @@ extern crate serde_yaml;
 use serde::{Deserialize, Serialize};
 
 extern crate log;
-use log::warn;
+use log::{error, info};
 
-// mod utils;
 pub mod utils;
 use utils::SettingsType;
 
-#[allow(dead_code)]
-const RULESET_CURRENT_VERSION: &'static str = "1";
+pub mod regex_wrapper;
+use regex_wrapper::Regex;
 
-#[derive(Debug, Deserialize, Serialize)]
+/// Current version of the ruleset. It will help determine if the ruleset is
+/// outdated or from a more recent version of the software than the one being in
+/// use.
+pub const RULESET_CURRENT_VERSION: i32 = 1;
+
+/// Encode a [`Settings`] struct to a filetype, returns a
+/// `std::result::Result<std::string::String, std::io::Error>`
+///
+/// # Arguments
+///
+/// * `funcrate` - `serde`-compatible crate to use, must implement `to_string`
+/// * `content` - content to encode, must be `Settings` struct
+///
+/// # Example
+///
+/// ```ignore
+/// # use lang_evolve_core::settings::*;
+/// # use lang_evolve_core::encode_settings;
+/// use std::io::{Error, ErrorKind};
+/// use std::path::Path;
+/// let filetype = utils::get_file_type(Path::new("./path/to/file.json"));
+/// let s = Settings::new();
+/// let content = match filetype {
+///     utils::SettingsType::Yaml => encode_settings!(serde_yaml, &s).unwrap(),
+///     utils::SettingsType::Json => encode_settings!(serde_json, &s).unwrap(),
+///     _ => panic!("Could not encode settings"),
+/// };
+/// ```
+///
+/// [`Settings`]: ./settings/struct.Settings.html
+#[macro_export(local_inner_macros)]
+macro_rules! encode_settings {
+    ($funcrate:ident, $content:expr) => {
+        match $funcrate::to_string($content) {
+            Err(e) => {
+                log::error!("Could not serialize settings: {}", e.to_string());
+                return Err(std::io::Error::new(
+                    std::io::ErrorKind::InvalidData,
+                    e,
+                ));
+            }
+            Ok(val) => val,
+        }
+    };
+}
+
+/// Decode a [`Settings`] struct from a `std::std::String`, returns a
+/// std::result::Result<lang_evolve_core::settings::Settings, std::io::Error>
+///
+/// # Arguments
+///
+/// * `funcrate` - `serde`-compatible crate to use, mus implement `from_string`
+/// * `content` - `&str` to decode into a [`Settings`]
+///
+/// # Example
+///
+/// ```ignore
+/// # use lang_evolve_core::decode_settings;
+/// let str = r#"{"version":"1","categories":[],"rules":[]}"#;
+/// let settings = decode_settings!(serde_json, str);
+/// ```
+///
+/// [`Settings`]: ./settings/struct.Settings.html
+#[macro_export(local_inner_macros)]
+macro_rules! decode_settings {
+    ($funcrate:ident, $content:expr) => {
+        match $funcrate::from_str($content) {
+            Err(e) => {
+                log::error!("Could not import settings: {}", e.to_string());
+                return Err(std::io::Error::new(
+                    std::io::ErrorKind::InvalidInput,
+                    e,
+                ));
+            }
+            Ok(val) => val,
+        }
+    };
+}
+
+/// Representation of the software’s settings
+///
+/// This struct represents all the settings the software has to follow
+/// while running, which includes the phoneme categories as well as
+/// the soundchange rules to apply to the input text.
+#[derive(Clone, Debug, Deserialize, Serialize)]
 pub struct Settings {
+    /// Represents the version of the loaded ruleset.
+    ///
+    /// It is used to detect obsolete ruleset representations or if a
+    /// loaded ruleset comes from a newer version of lang_evolve_core
+    /// than the one used by the user.
     #[serde(default = "Settings::get_ruleset_version")]
-    version: String,
+    pub version: String,
+
+    /// Categories of phonemes
+    ///
+    /// This is a vector of categories of phonemes, represented
+    /// themselves as pairs of strings. Each pair of strings has its
+    /// first element represent the name of the category, which is
+    /// generally represented by a single capital letter. The second
+    /// element is a string where all its characters represent
+    /// phonemes. It is currently not possible to have more than one
+    /// character to be considered as one sound.
     #[serde(default)]
-    categories: Vec<(String, String)>,
+    pub categories: Vec<(String, String)>,
+
+    /// Soundchange rules
+    ///
+    /// This is a vector of pairs of strings, the first one represents
+    /// a regex to be matched while the second represents the change
+    /// to be made to the input data.
     #[serde(default)]
-    rules: Vec<(String, String)>,
+    pub rules: Vec<(Regex, Regex)>,
 }
 
 /// Representation inside the crate of LangEvolve’s settings.
 impl Settings {
-    /// Creates a new empty instance of `Settings`
+    /// Creates a new empty instance of [`Settings`]
     ///
     /// # Example
     ///
@@ -39,6 +143,8 @@ impl Settings {
     /// assert_eq!(content_yaml, serde_yaml::to_string(&s).unwrap());
     /// assert_eq!(content_json, serde_json::to_string(&s).unwrap());
     /// ```
+    ///
+    /// [`Settings`]: ./settings/struct.Settings.html
     pub fn new() -> Self {
         Self {
             version: Self::get_ruleset_version(),
@@ -47,12 +153,11 @@ impl Settings {
         }
     }
 
-    /// Import settings from an imput file. The currently allowed file formats
-    /// are:
-    /// - JSON - with the `.json` extension
-    /// - Yaml - with the `.yaml` or `.yml` extension
-    /// The format will be automatically detected based on the filename
-    /// extension.
+    /// Import settings from an imput file.
+    ///
+    /// The currently allowed file formats are described in the
+    /// [`utils::SettingsType`] enum. If the ruleset version is higher than the
+    /// current version (see [`Settings.version`]), then an error is returned.
     ///
     /// # Arguments
     ///
@@ -72,50 +177,67 @@ impl Settings {
     /// let path_yml = Path::new("settings.yml");
     /// let _s_yml = Settings::import(&path_yml).unwrap();
     /// ```
+    ///
+    /// [`utils::SettingsTYpe`]: ./utils/enum.SettingsType.html
+    /// [`Settings.version`]: ./struct.Settings.html#structfield.version
     pub fn import(path: &std::path::Path) -> std::io::Result<Self> {
-        use SettingsType::*;
-        let display = path.display();
-        let file_type = utils::get_file_type(&path).unwrap();
-        let content = match utils::read_file(&path) {
-            Err(e) => {
-                warn!("Could not read file {}: {}", display, e.to_string());
-                return Err(e);
-            }
-            Ok(content) => content,
-        };
+        use utils::SettingsType::{Json, Yaml};
+        let file_type = utils::get_file_type(&path);
+        let content = utils::read_file(&path)?;
 
         let settings: Settings = match file_type {
-            Yaml => match serde_yaml::from_str(&content) {
+            Yaml => decode_settings!(serde_yaml, &content),
+            Json => decode_settings!(serde_json, &content),
+            // Attempt to decode anyway
+            _ => match Settings::from_str(&content.as_str()) {
+                Ok(val) => val,
                 Err(e) => {
-                    warn!("Could not import settings: {}", e.to_string());
+                    error!(
+                        "Could not decode input {}: {}",
+                        content,
+                        e.to_string()
+                    );
                     return Err(std::io::Error::new(
-                        std::io::ErrorKind::InvalidInput,
+                        std::io::ErrorKind::InvalidData,
                         e,
                     ));
                 }
-                Ok(val) => val,
-            },
-            Json => match serde_json::from_str(&content) {
-                Err(e) => {
-                    warn!("Could not import settings: {}", e.to_string());
-                    return Err(std::io::Error::new(
-                        std::io::ErrorKind::InvalidInput,
-                        e,
-                    ));
-                }
-                Ok(val) => val,
             },
         };
-
+        if settings.version > Self::get_ruleset_version() {
+            error!("Ruleset version too high!");
+            return Err(std::io::Error::new(
+                std::io::ErrorKind::InvalidData,
+                "Ruleset version too high!",
+            ));
+        }
+        info!("Successfuly imported {}", path.display());
         Ok(settings)
     }
 
-    /// Export the current rules to a file. The allowed file formats are either
-    /// a YAML file or a Json file, hence the allowed filename extension are:
-    /// * "yml" or "yaml" for Yaml files
-    /// * "json" for Json files
-    /// The format is detected automatically depending on the extension of the
-    /// filename.
+    /// Import settings from file path described by the argument `path`
+    ///
+    /// # Arguments
+    ///
+    /// * `path` - path to the file from which settings should be imported
+    ///
+    /// # Example
+    ///
+    /// ```no_run
+    /// let s = lang_evolve_core::settings::Settings::from("settings.yml");
+    /// ```
+    pub fn from<S>(s: S) -> Self
+    where
+        S: ToString,
+    {
+        let s = s.to_string();
+        let path = std::path::Path::new(&s);
+        Self::import(&path).unwrap()
+    }
+
+    /// Export current settings to a file.
+    ///
+    /// The allowed file formats are described in the [`SettingsType`] enum.
     ///
     /// # Arguments
     ///
@@ -137,36 +259,69 @@ impl Settings {
     /// let path_yml = Path::new("./output.yml");
     /// s.export(&path_yml).unwrap();
     /// ```
+    ///
+    /// [`SettingsType`]: ./utils/enum.SettingsType.html
     pub fn export(&self, path: &std::path::Path) -> std::io::Result<()> {
-        let filetype = utils::get_file_type(&path).unwrap();
+        let filetype = utils::get_file_type(&path);
         let content = match filetype {
-            SettingsType::Yaml => match serde_yaml::to_string(&self) {
-                Err(e) => {
-                    warn!("Could not serialize settings: {}", e.to_string());
-                    return Err(std::io::Error::new(
-                        std::io::ErrorKind::InvalidData,
-                        e,
-                    ));
-                }
-                Ok(val) => val,
-            },
-            SettingsType::Json => match serde_json::to_string(&self) {
-                Err(e) => {
-                    warn!("Could not serialize settings: {}", e.to_string());
-                    return Err(std::io::Error::new(
-                        std::io::ErrorKind::InvalidData,
-                        e,
-                    ));
-                }
-                Ok(val) => val,
-            },
+            SettingsType::Yaml => encode_settings!(serde_yaml, &self),
+            SettingsType::Json => encode_settings!(serde_json, &self),
+            _ => {
+                error!("Unknown filetype {}", path.to_str().unwrap());
+                return Err(std::io::Error::new(
+                    std::io::ErrorKind::InvalidData,
+                    "Unknown file type",
+                ));
+            }
         };
+        info!("Successfuly exported settings to {}", path.display());
         utils::write_file(&path, &content)
     }
 
     /// Get the current ruleset version of LangEvolve.
     fn get_ruleset_version() -> String {
-        String::from(RULESET_CURRENT_VERSION)
+        RULESET_CURRENT_VERSION.to_string()
+    }
+}
+
+use std::str::FromStr;
+impl FromStr for Settings {
+    type Err = serde_yaml::Error;
+
+    /// Decode a litteral string into a `Settings` struct. Works only for
+    /// supported file types described in `SettingsType`. It will try to decode
+    /// the input `s` by any mean known by `SettingsType`.
+    ///
+    /// # Arguments
+    ///
+    /// * `s` - litteral string to decode into a `Settings` struct
+    ///
+    /// # Example
+    ///
+    /// ```
+    /// # use std::str::FromStr;
+    /// let s = r#"{"version":"1","categories":[],"rules":[]}"#;
+    /// let settings = lang_evolve_core::settings::Settings::from_str(s).unwrap();
+    /// ```
+    fn from_str(s: &str) -> Result<Self, Self::Err> {
+        match serde_json::from_str::<Settings>(s) {
+            Ok(val) => Ok(val),
+            Err(_) => match serde_yaml::from_str::<Settings>(s) {
+                Ok(val) => Ok(val),
+                Err(e) => {
+                    error!("Could not decode input {}: {}", s, e.to_string());
+                    return Err(e);
+                }
+            },
+        }
+    }
+}
+
+use std::fmt;
+use std::fmt::Display;
+impl Display for Settings {
+    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
+        write!(f, "{}", serde_json::to_string(&self).unwrap())
     }
 }
 

src/settings/regex_wrapper.rs

@@ -0,0 +1,84 @@
+// extern crate serde;
+// extern crate regex;
+// use serde::{Deserialize, Serialize};
+
+// #[derive(Clone, Debug, Deserialize, Serialize)]
+// #[serde(transparent)]
+// pub struct Regex(regex::Regex);
+
+// #[derive(Clone, Debug, Deserialize, Serialize)]
+// #[serde(remote = "regex::Regex")]
+// pub struct RegexDef{
+//     #[serde(getter = "regex::Regex::to_string")]
+//     r: String
+// }
+use std::{fmt, ops};
+
+#[derive(Clone, Debug)]
+pub struct Regex(regex::Regex);
+
+impl Regex {
+    pub fn new(s: &str) -> Self {
+        Self(regex::Regex::new(s).unwrap())
+    }
+
+    pub fn as_str(&self) -> &str {
+        self.0.as_str()
+    }
+
+    pub fn to_string(&self) -> String {
+        self.0.to_string()
+    }
+}
+
+impl ops::Deref for Regex {
+    type Target = regex::Regex;
+    fn deref(&self) -> &regex::Regex {
+        &self.0
+    }
+}
+
+impl<'de> serde::Deserialize<'de> for Regex {
+    fn deserialize<D>(de: D) -> Result<Regex, D::Error>
+    where
+        D: serde::Deserializer<'de>,
+    {
+        use serde::de::{Error, Visitor};
+
+        struct RegexVisitor;
+
+        impl<'de> Visitor<'de> for RegexVisitor {
+            type Value = Regex;
+
+            fn expecting(&self, f: &mut fmt::Formatter) -> fmt::Result {
+                f.write_str("a regular expression pattern")
+            }
+
+            fn visit_str<E: Error>(self, v: &str) -> Result<Regex, E> {
+                regex::Regex::new(v)
+                    .map(Regex)
+                    .map_err(|err| E::custom(err.to_string()))
+            }
+        }
+
+        de.deserialize_str(RegexVisitor)
+    }
+}
+
+use serde::{Serialize, Serializer};
+impl Serialize for Regex {
+    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
+    where
+        S: Serializer,
+    {
+        serializer.serialize_str(self.0.as_str())
+    }
+}
+
+impl PartialEq for Regex {
+    fn eq(&self, other: &Self) -> bool {
+        self.0.to_string() == other.0.to_string()
+    }
+}
+
+impl Eq for Regex {}

src/settings/utils.rs

@@ -1,17 +1,22 @@
 extern crate log;
-use log::{info, warn};
+use log::{info, error};
 
 use std::fs::File;
 use std::io::{Read, Result};
 use std::path::Path;
 
 /// Type of supported settings format: yaml or json
+#[derive(Debug, PartialEq)]
 pub enum SettingsType {
     /// Files ending with the `yml` or `yaml` extension
     Yaml,
 
     /// Files ending with the `json` extension
     Json,
+
+    /// Other file type, used to describe files without an extension or with an
+    /// unsupported extension
+    Other,
 }
 
 /// Read a file’s content into a `String`
@@ -26,7 +31,7 @@ pub fn read_file(path: &Path) -> Result<String> {
     let display = path.display();
     let mut file = match File::open(&path) {
         Err(why) => {
-            warn!("Could not read {}: {}", display, why.to_string());
+            error!("Could not read {}: {}", display, why.to_string());
             return Err(why);
         }
         Ok(file) => file,
@@ -34,7 +39,7 @@ pub fn read_file(path: &Path) -> Result<String> {
     let mut content = String::new();
     match file.read_to_string(&mut content) {
         Err(why) => {
-            warn!("Could not read {}: {}", display, why.to_string());
+            error!("Could not read {}: {}", display, why.to_string());
             return Err(why);
         }
         Ok(_) => {
@@ -60,14 +65,14 @@ where
     use std::io::prelude::*;
     let mut file = match File::create(&path) {
         Err(e) => {
-            warn!("Could not open file {}: {}", path.display(), e.to_string());
+            error!("Could not open file {}: {}", path.display(), e.to_string());
             return Err(e);
         }
         Ok(file) => file,
     };
     match file.write_all(content.to_string().as_bytes()) {
         Err(e) => {
-            warn!(
+            error!(
                 "Could not write settings to file {}: {}",
                 path.display(),
                 e.to_string()
@@ -78,17 +83,37 @@ where
             info!("Wrote settings to file {}", path.display());
         }
     };
+    info!("Successfuly written {}", path.display());
     Ok(())
 }
 
-pub fn get_file_type(path: &Path) -> Result<SettingsType> {
+/// Get the type of file to be opened based on its extension. Currently
+/// supported file types are:
+/// * JSON - `.json` extension
+/// * Yaml - `.yml` or `.yaml` extensions
+///
+/// # Arguments
+///
+/// - `path` - Path of the file to be determined
+///
+/// # Example
+///
+/// ```
+/// let file_json = std::path::Path::new("file.json");
+/// assert_eq!(lang_evolve_core::settings::utils::SettingsType::Json,
+///            lang_evolve_core::settings::utils::get_file_type(&file_json));
+///
+/// let file_yaml = std::path::Path::new("file.yaml");
+/// assert_eq!(lang_evolve_core::settings::utils::SettingsType::Yaml,
+///            lang_evolve_core::settings::utils::get_file_type(&file_yaml));
+///
+/// let file_yml = std::path::Path::new("file.yml");
+/// assert_eq!(lang_evolve_core::settings::utils::SettingsType::Yaml,
+///            lang_evolve_core::settings::utils::get_file_type(&file_yml));
+/// ```
+pub fn get_file_type(path: &Path) -> SettingsType {
     let extension = match path.extension() {
-        None => {
-            return Err(std::io::Error::new(
-                std::io::ErrorKind::InvalidInput,
-                "File has no extension",
-            ));
-        }
+        None => { return  SettingsType::Other; }
         Some(val) => val,
     };
     let extension = extension
@@ -96,11 +121,8 @@ pub fn get_file_type(path: &Path) -> Result<SettingsType> {
         .expect("Could not get String out of extension")
         .to_lowercase();
     match extension.as_str() {
-        "yml" | "yaml" => Ok(SettingsType::Yaml),
-        "json" => Ok(SettingsType::Json),
-        _ => Err(std::io::Error::new(
-            std::io::ErrorKind::InvalidInput,
-            "Invalid extension",
-        )),
+        "yml" | "yaml" => SettingsType::Yaml,
+        "json" => SettingsType::Json,
+        _ => SettingsType::Other,
     }
 }