use thiserror::Error;
#[derive(Debug, Error)]
pub enum MarkdownError {
#[error("Markdown conversion failed: {0}")]
ConversionFailed(String),
}
pub trait MarkdownConverter: Send + Sync {
fn name(&self) -> &'static str;
fn convert(&self, html: &str) -> Result<String, MarkdownError>;
}
#[derive(Debug, Clone, Default)]
pub struct HtmdMarkdownService;
impl HtmdMarkdownService {
pub fn new() -> Self {
Self
}
}
impl MarkdownConverter for HtmdMarkdownService {
fn name(&self) -> &'static str {
"htmd"
}
fn convert(&self, html: &str) -> Result<String, MarkdownError> {
let trimmed = html.trim();
if trimmed.is_empty() {
return Ok(String::new());
}
htmd::convert(trimmed).map_err(|e| MarkdownError::ConversionFailed(e.to_string()))
}
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn converts_h1_to_markdown_heading() {
let svc = HtmdMarkdownService::new();
let html = "<html><body><h1>Title</h1></body></html>";
let md = svc.convert(html).expect("convert ok");
assert!(
md.contains("# Title") || md.contains("Title"),
"expected Title in markdown, got: {md}"
);
}
#[test]
fn converts_unordered_list_to_markdown() {
let svc = HtmdMarkdownService::new();
let html = "<html><body><ul><li>First</li><li>Second</li></ul></body></html>";
let md = svc.convert(html).expect("convert ok");
assert!(
md.contains("First") && md.contains("Second"),
"expected list items, got: {md}"
);
}
#[test]
fn converts_anchor_to_markdown_link() {
let svc = HtmdMarkdownService::new();
let html = r#"<html><body><a href="https://example.com">Example</a></body></html>"#;
let md = svc.convert(html).expect("convert ok");
assert!(md.contains("Example"), "expected link text, got: {md}");
assert!(
md.contains("https://example.com"),
"expected link URL, got: {md}"
);
}
#[test]
fn converts_pre_code_to_fenced_block() {
let svc = HtmdMarkdownService::new();
let html = "<html><body><pre><code>let x = 1;</code></pre></body></html>";
let md = svc.convert(html).expect("convert ok");
assert!(
md.contains("let x = 1;"),
"expected code content, got: {md}"
);
}
#[test]
fn returns_empty_string_for_empty_html() {
let svc = HtmdMarkdownService::new();
let md = svc.convert("").expect("empty html should not error");
assert!(md.is_empty(), "expected empty markdown, got: {md}");
}
#[test]
fn returns_empty_string_for_whitespace_html() {
let svc = HtmdMarkdownService::new();
let md = svc
.convert(" \n\t ")
.expect("whitespace html should not error");
assert!(md.is_empty(), "expected empty markdown, got: {md}");
}
#[test]
fn extracted_html_still_converts() {
let svc = HtmdMarkdownService::new();
let html = "<html><body><p>Hello world</p></body></html>";
let md = svc
.convert(html)
.expect("only_main_content=true should still convert");
assert!(
md.contains("Hello world"),
"expected text in markdown, got: {md}"
);
}
#[test]
fn default_equals_new() {
let a = HtmdMarkdownService::new();
let b = HtmdMarkdownService;
let html = "<p>test</p>";
let ra = a.convert(html).expect("a convert ok");
let rb = b.convert(html).expect("b convert ok");
assert_eq!(ra, rb, "default and new should produce same output");
}
#[test]
fn trait_object_dispatch_works() {
let svc: Box<dyn MarkdownConverter> = Box::new(HtmdMarkdownService::new());
let html = "<html><body><h2>Sub</h2></body></html>";
let md = svc.convert(html).expect("trait object convert ok");
assert!(
md.contains("Sub"),
"expected text via trait object, got: {md}"
);
}
}