fix(crate): crate locations for readmev0.3.3

3 files changed, 232 insertions, 0 deletions

diff --git a/germ/src/convert/html.rs b/germ/src/convert/html.rs
new file mode 100644
index 0000000..7b1cafe
--- /dev/null
+++ b/germ/src/convert/html.rs
@@ -0,0 +1,75 @@
+// 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
+
+use crate::ast::Node;
+
+pub fn convert(source: &[Node]) -> String {
+  let mut html = String::new();
+
+  // Since we have an AST tree of the Gemtext, it is very easy to convert from
+  // this AST tree to an alternative markup format.
+  for node in source {
+    match node {
+      Node::Text(text) => html.push_str(&format!("<p>{}</p>", text)),
+      Node::Link {
+        to,
+        text,
+      } => {
+        html.push_str(&format!(
+          "<a href=\"{}\">{}</a><br>",
+          to,
+          text.clone().unwrap_or_else(|| to.clone())
+        ));
+      }
+      Node::Heading {
+        level,
+        text,
+      } => {
+        html.push_str(&format!(
+          "<{}>{}</{0}>",
+          match level {
+            1 => "h1",
+            2 => "h2",
+            3 => "h3",
+            _ => "p",
+          },
+          text
+        ));
+      }
+      Node::List(items) =>
+        html.push_str(&format!(
+          "<ul>{}</ul>",
+          items
+            .iter()
+            .map(|i| format!("<li>{}</li>", i))
+            .collect::<Vec<String>>()
+            .join("\n")
+        )),
+      Node::Blockquote(text) =>
+        html.push_str(&format!("<blockquote>{}</blockquote>", text)),
+      Node::PreformattedText {
+        text, ..
+      } => {
+        html.push_str(&format!("<pre>{}</pre>", text));
+      }
+      Node::Whitespace => {}
+    }
+  }
+
+  html
+}
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,
+    )
+  };
+}
diff --git a/germ/src/convert/markdown.rs b/germ/src/convert/markdown.rs
new file mode 100644
index 0000000..a38da9f
--- /dev/null
+++ b/germ/src/convert/markdown.rs
@@ -0,0 +1,77 @@
+// 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
+
+use crate::ast::Node;
+
+pub fn convert(source: &[Node]) -> String {
+  let mut markdown = String::new();
+
+  // Since we have an AST tree of the Gemtext, it is very easy to convert from
+  // this AST tree to an alternative markup format.
+  for node in source {
+    match node {
+      Node::Text(text) => markdown.push_str(&format!("{}\n", text)),
+      Node::Link {
+        to,
+        text,
+      } =>
+        markdown.push_str(&*text.clone().map_or_else(
+          || format!("<{}>\n", to),
+          |text| format!("[{}]({})\n", text, to),
+        )),
+      Node::Heading {
+        level,
+        text,
+      } => {
+        markdown.push_str(&format!(
+          "{} {}\n",
+          match level {
+            1 => "#",
+            2 => "##",
+            3 => "###",
+            _ => "",
+          },
+          text
+        ));
+      }
+      Node::List(items) =>
+        markdown.push_str(&format!(
+          "{}\n",
+          items
+            .iter()
+            .map(|i| format!("- {}", i))
+            .collect::<Vec<String>>()
+            .join("\n"),
+        )),
+      Node::Blockquote(text) => markdown.push_str(&format!("> {}\n", text)),
+      Node::PreformattedText {
+        alt_text,
+        text,
+      } => {
+        markdown.push_str(&format!(
+          "```{}\n{}```\n",
+          alt_text.clone().unwrap_or_else(|| "".to_string()),
+          text
+        ));
+      }
+      Node::Whitespace => markdown.push('\n'),
+    }
+  }
+
+  markdown
+}