feat(macro): add langtag! macro

increase version to 0.0.4

Author: pyfisch

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "language-tags"
-version = "0.0.3"
+version = "0.0.4"
 authors = ["Pyfisch <[email protected]>"]
 
 description = "Language tags for Rust"

README.md

@@ -47,3 +47,5 @@ let mut langtag2: LanguageTag = Default::default();
 langtag2.language = Some("de".to_owned());
 assert!(langtag2.matches(&langtag1));
 ```
+
+There is also the `langtag!` macro for creating language tags.

src/lib.rs

@@ -48,6 +48,8 @@
 //! langtag2.language = Some("de".to_owned());
 //! assert!(langtag2.matches(&langtag1));
 //! ```
+//!
+//! There is also the `langtag!` macro for creating language tags.
 
 use std::ascii::AsciiExt;
 use std::collections::BTreeMap;
@@ -387,3 +389,106 @@ impl fmt::Display for LanguageTag {
         Ok(())
     }
 }
+
+#[macro_export]
+/// Utility for creating simple language tags.
+///
+/// The macro supports the language, exlang, script and region parts of language tags,
+/// they are separated by semicolons, omitted parts are denoted with mulitple semicolons.
+///
+/// # Examples
+/// * `it`: `langtag!(it)`
+/// * `it-LY`: `langtag!(it;;;LY)`
+/// * `it-Arab-LY`: `langtag!(it;;Arab;LY)`
+/// * `ar-afb`: `langtag!(ar;afb)`
+/// * `i-enochian`: `langtag!(i-enochian)`
+macro_rules! langtag {
+    ( $language:expr ) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: None,
+            script: None,
+            region: None,
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+    ( $language:expr;;;$region:expr ) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: None,
+            script: None,
+            region: Some(stringify!($region).to_owned()),
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+    ( $language:expr;;$script:expr ) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: None,
+            script: Some(stringify!($script).to_owned()),
+            region: None,
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+    ( $language:expr;;$script:expr;$region:expr ) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: None,
+            script: Some(stringify!($script).to_owned()),
+            region: Some(stringify!($region).to_owned()),
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+    ( $language:expr;$extlang:expr) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: Some(stringify!($extlang).to_owned()),
+            script: None,
+            region: None,
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+    ( $language:expr;$extlang:expr;$script:expr) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: Some(stringify!($extlang).to_owned()),
+            script: Some(stringify!($script).to_owned()),
+            region: None,
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+    ( $language:expr;$extlang:expr;;$region:expr ) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: Some(stringify!($extlang).to_owned()),
+            script: None,
+            region: Some(stringify!($region).to_owned()),
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+    ( $language:expr;$extlang:expr;$script:expr;$region:expr ) => {
+        LanguageTag {
+            language: Some(stringify!($language).to_owned()),
+            extlang: Some(stringify!($extlang).to_owned()),
+            script: Some(stringify!($script).to_owned()),
+            region: Some(stringify!($region).to_owned()),
+            variants: Vec::new(),
+            extensions: BTreeMap::new(),
+            privateuse: Vec::new(),
+        }
+    };
+}

tests/tests.rs

@@ -1,3 +1,4 @@
+#[macro_use]
 extern crate language_tags;
 
 use std::default::Default;
@@ -131,6 +132,43 @@ fn test_format() {
     assert_eq!(format!("{}", y), "MgxQa-ywEp-8lcW-7bvT-h-dP1Md-0h7-0Z3ir");
 }
 
+#[test]
+fn test_macro() {
+    let a1 = langtag!(it);
+    let a2 = LanguageTag {
+        language: Some("it".to_owned()),
+        extlang: None,
+        script: None,
+        region: None,
+        variants: Vec::new(),
+        extensions: BTreeMap::new(),
+        privateuse: Vec::new(),
+    };
+    assert_eq!(a1, a2);
+    let b1 = langtag!(it;;;LY);
+    let b2 = LanguageTag {
+        language: Some("it".to_owned()),
+        extlang: None,
+        script: None,
+        region: Some("LY".to_owned()),
+        variants: Vec::new(),
+        extensions: BTreeMap::new(),
+        privateuse: Vec::new(),
+    };
+    assert_eq!(b1, b2);
+    let c1 = langtag!(it;;Arab;LY);
+    let c2 = LanguageTag {
+        language: Some("it".to_owned()),
+        extlang: None,
+        script: Some("Arab".to_owned()),
+        region: Some("LY".to_owned()),
+        variants: Vec::new(),
+        extensions: BTreeMap::new(),
+        privateuse: Vec::new(),
+    };
+    assert_eq!(c1, c2);
+}
+
 #[test]
 fn test_wellformed_tags() {
     // Source: http://www.langtag.net/test-suites/well-formed-tags.txt