chore: prepare for v0.10.0-alpha.1

examples/custom.rs

@@ -1,81 +0,0 @@
-use std::convert::From;
-use std::env::args;
-use std::fs;
-use std::io::{Error as IOError, Write};
-use std::result::Result;
-use std::string::FromUtf8Error;
-
-use orgize::export::{DefaultHtmlHandler, HtmlHandler};
-use orgize::{Element, Org};
-use slugify::slugify;
-
-#[derive(Debug)]
-enum MyError {
-    IO(IOError),
-    Heading,
-    Utf8(FromUtf8Error),
-}
-
-// From<std::io::Error> trait is required for custom error type
-impl From<IOError> for MyError {
-    fn from(err: IOError) -> Self {
-        MyError::IO(err)
-    }
-}
-
-impl From<FromUtf8Error> for MyError {
-    fn from(err: FromUtf8Error) -> Self {
-        MyError::Utf8(err)
-    }
-}
-
-#[derive(Default)]
-struct MyHtmlHandler(DefaultHtmlHandler);
-
-impl HtmlHandler<MyError> for MyHtmlHandler {
-    fn start<W: Write>(&mut self, mut w: W, element: &Element) -> Result<(), MyError> {
-        if let Element::Title(title) = element {
-            if title.level > 6 {
-                return Err(MyError::Heading);
-            } else {
-                write!(
-                    w,
-                    "<h{0}><a id=\"{1}\" href=\"#{1}\">",
-                    title.level,
-                    slugify!(&title.raw),
-                )?;
-            }
-        } else {
-            // fallthrough to default handler
-            self.0.start(w, element)?;
-        }
-        Ok(())
-    }
-
-    fn end<W: Write>(&mut self, mut w: W, element: &Element) -> Result<(), MyError> {
-        if let Element::Title(title) = element {
-            write!(w, "</a></h{}>", title.level)?;
-        } else {
-            self.0.end(w, element)?;
-        }
-        Ok(())
-    }
-}
-
-fn main() -> Result<(), MyError> {
-    let args: Vec<_> = args().collect();
-
-    if args.len() < 2 {
-        eprintln!("Usage: {} <org-file>", args[0]);
-    } else {
-        let contents = String::from_utf8(fs::read(&args[1])?)?;
-
-        let mut writer = Vec::new();
-        let mut handler = MyHtmlHandler::default();
-        Org::parse(&contents).write_html_custom(&mut writer, &mut handler)?;
-
-        println!("{}", String::from_utf8(writer)?);
-    }
-
-    Ok(())
-}

examples/html-slugify.rs

@@ -0,0 +1,64 @@
+//! ```bash
+//! cargo run --example html-slugify '* hello world!'
+//! ```
+
+use orgize::{
+    ast::HeadlineTitle,
+    export::{HtmlExport, TraversalContext, Traverser},
+    forward_handler,
+    rowan::{ast::AstNode, WalkEvent},
+    Org,
+};
+use slugify::slugify;
+use std::cmp::min;
+use std::env::args;
+
+#[derive(Default)]
+struct MyHtmlHandler(pub HtmlExport);
+
+// AsMut trait is required for using forward_handler macros
+impl AsMut<HtmlExport> for MyHtmlHandler {
+    fn as_mut(&mut self) -> &mut HtmlExport {
+        &mut self.0
+    }
+}
+
+impl Traverser for MyHtmlHandler {
+    fn headline_title(&mut self, event: WalkEvent<&HeadlineTitle>, _ctx: &mut TraversalContext) {
+        match event {
+            WalkEvent::Enter(title) => {
+                let level = title.headline().and_then(|h| h.level()).unwrap_or(1);
+                let level = min(level, 6);
+                let raw = title.syntax().to_string();
+                self.0.output += &format!("<h{level}><a id=\"{0}\" href=\"#{0}\">", slugify!(&raw));
+            }
+            WalkEvent::Leave(title) => {
+                let level = title.headline().and_then(|h| h.level()).unwrap_or(1);
+                let level = min(level, 6);
+                self.0.output += &format!("</a></h{level}>");
+            }
+        }
+    }
+
+    forward_handler! {
+        HtmlExport,
+        link text document headline paragraph section rule comment
+        inline_src inline_call code bold verbatim italic strike underline list list_item list_item_tag
+        special_block quote_block center_block verse_block comment_block example_block export_block
+        source_block babel_call clock cookie radio_target drawer dyn_block fn_def fn_ref macros
+        snippet timestamp target fixed_width org_table org_table_row org_table_cell list_item_content
+    }
+}
+
+fn main() {
+    let args: Vec<_> = args().collect();
+
+    if args.len() < 2 {
+        eprintln!("Usage: {} <org-mode-string>", args[0]);
+    } else {
+        let mut handler = MyHtmlHandler::default();
+        Org::parse(&args[1]).traverse(&mut handler);
+
+        println!("{}", handler.0.finish());
+    }
+}

examples/iter.rs

@@ -1,19 +0,0 @@
-use orgize::Org;
-use std::env::args;
-use std::fs;
-use std::io::Result;
-
-fn main() -> Result<()> {
-    let args: Vec<_> = args().collect();
-
-    if args.len() < 2 {
-        eprintln!("Usage: {} <org-file>", args[0]);
-    } else {
-        let contents = String::from_utf8(fs::read(&args[1])?).unwrap();
-
-        for event in Org::parse(&contents).iter() {
-            println!("{:?}", event);
-        }
-    }
-    Ok(())
-}

examples/json.rs

@@ -1,17 +0,0 @@
-use orgize::Org;
-use serde_json::to_string;
-use std::env::args;
-use std::fs;
-use std::io::Result;
-
-fn main() -> Result<()> {
-    let args: Vec<_> = args().collect();
-
-    if args.len() < 2 {
-        eprintln!("Usage: {} <org-file>", args[0]);
-    } else {
-        let contents = String::from_utf8(fs::read(&args[1])?).unwrap();
-        println!("{}", to_string(&Org::parse(&contents)).unwrap());
-    }
-    Ok(())
-}