fix(crate): crate locations for readmev0.3.3

1 files changed, 80 insertions, 0 deletions

diff --git a/germ/src/convert/macros.rs b/germ/src/convert/macros.rs
new file mode 100644
index 0000000..ca29050
--- /dev/null
+++ b/germ/src/convert/macros.rs
@@ -0,0 +1,80 @@
+// This file is part of Germ <https://github.com/gemrest/germ>.
+// Copyright (C) 2022-2022 Fuwn <[email protected]>
+//
+// This program is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, version 3.
+//
+// This program is distributed in the hope that it will be useful, but
+// WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+// General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <http://www.gnu.org/licenses/>.
+//
+// Copyright (C) 2022-2022 Fuwn <[email protected]>
+// SPDX-License-Identifier: GPL-3.0-only
+
+/// Convert Gemtext into HTML
+///
+/// # Examples
+///
+/// ```rust
+/// // Using a value
+/// assert_eq!(
+///   germ::gemini_to_html!("=> /to hello !"),
+///   "<a href=\"/to\">hello !</a><br>",
+/// );
+///
+/// // Using raw Gemtext
+/// assert_eq!(
+///   germ::gemini_to_html! { => /to hello ! },
+///   "<a href=\"/to\">hello !</a><br>",
+/// );
+/// ```
+#[macro_export]
+macro_rules! gemini_to_html {
+  ($gemini:expr) => {
+    germ::convert::from_ast(
+      &germ::gemini_to_ast!($gemini),
+      &germ::convert::Target::HTML,
+    )
+  };
+  ($($gemini:tt)*) => {
+    germ::convert::from_ast(
+      &germ::gemini_to_ast!{ $($gemini)* },
+      &germ::convert::Target::HTML,
+    )
+  };
+}
+
+/// Convert Gemtext into Markdown
+///
+/// # Examples
+///
+/// ```rust
+/// assert_eq!(
+///   // Using a value
+///   germ::gemini_to_md!("=> /to hello !"),
+///   "[hello !](/to)\n",
+/// );
+///
+/// // Using raw Gemtext
+/// assert_eq!(germ::gemini_to_md! { => /to hello ! }, "[hello !](/to)\n",);
+/// ```
+#[macro_export]
+macro_rules! gemini_to_md {
+  ($gemini:expr) => {
+    germ::convert::from_ast(
+      &germ::gemini_to_ast!($gemini),
+      &germ::convert::Target::Markdown,
+    )
+  };
+  ($($gemini:tt)*) => {
+    germ::convert::from_ast(
+      &germ::gemini_to_ast!{ $($gemini)* },
+      &germ::convert::Target::Markdown,
+    )
+  };
+}