From bc5d2312763b4399b246f1e6b9dbfbfa5cd76686 Mon Sep 17 00:00:00 2001 From: Fuwn Date: Thu, 12 May 2022 07:42:03 +0000 Subject: feat(0.1.0): initial release --- src/convert.rs | 68 ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 src/convert.rs (limited to 'src/convert.rs') diff --git a/src/convert.rs b/src/convert.rs new file mode 100644 index 0000000..6661d4f --- /dev/null +++ b/src/convert.rs @@ -0,0 +1,68 @@ +// This file is part of Germ . +// Copyright (C) 2022-2022 Fuwn +// +// 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 . +// +// Copyright (C) 2022-2022 Fuwn +// SPDX-License-Identifier: GPL-3.0-only + +//! Convert Gemtext into many types of markup. + +mod html; +mod markdown; + +/// Different targets to convert Gemtext to +pub enum Target { + /// Convert Gemtext to HTML + HTML, + /// Convert Gemtext to Markdown + Markdown, +} + +/// Convert AST'd Gemtext into an alternative markup format. +/// +/// # Example +/// +/// ```rust +/// use germ::convert; +/// +/// convert::convert_from_ast( +/// germ::ast::build(r#"=> gemini://gem.rest/ GemRest"#), +/// convert::Target::HTML, +/// ); +/// ``` +pub fn convert_from_ast( + source: Vec, + target: Target, +) -> String { + match target { + Target::Markdown => markdown::convert(source), + Target::HTML => html::convert(source), + } +} + +/// Convert raw Gemtext into an alternative markup format. +/// +/// # Example +/// +/// ```rust +/// use germ::convert; +/// +/// convert::convert_from_string( +/// r#"=> gemini://gem.rest/ GemRest"#, +/// convert::Target::HTML, +/// ); +/// ``` +pub fn convert_from_string(source: &str, target: Target) -> String { + convert_from_ast(crate::ast::build(source), target) +} -- cgit v1.2.3