From 03544cafaa82ba4bd7e0bc3372fc59549a8dc0cc Mon Sep 17 00:00:00 2001 From: Titus Wormer Date: Mon, 18 Jul 2022 14:13:43 +0200 Subject: Refactor to move options to `lib/` --- src/compiler.rs | 161 +------------------------------------------------------- 1 file changed, 1 insertion(+), 160 deletions(-) (limited to 'src/compiler.rs') diff --git a/src/compiler.rs b/src/compiler.rs index 67717e5..db52837 100644 --- a/src/compiler.rs +++ b/src/compiler.rs @@ -11,64 +11,9 @@ use crate::util::{ skip, span::{codes as codes_from_span, from_exit_event, serialize}, }; +use crate::{LineEnding, Options}; use std::collections::HashMap; -/// Type of line endings in markdown. -#[derive(Debug, Clone, PartialEq)] -pub enum LineEnding { - /// Both a carriage return (`\r`) and a line feed (`\n`). - /// - /// ## Example - /// - /// ```markdown - /// a␍␊ - /// b - /// ``` - CarriageReturnLineFeed, - /// Sole carriage return (`\r`). - /// - /// ## Example - /// - /// ```markdown - /// a␍ - /// b - /// ``` - CarriageReturn, - /// Sole line feed (`\n`). - /// - /// ## Example - /// - /// ```markdown - /// a␊ - /// b - /// ``` - LineFeed, -} - -impl LineEnding { - /// Turn the line ending into a [str]. - fn as_str(&self) -> &str { - match self { - LineEnding::CarriageReturnLineFeed => "\r\n", - LineEnding::CarriageReturn => "\r", - LineEnding::LineFeed => "\n", - } - } - /// Turn a [Code] into a line ending. - /// - /// ## Panics - /// - /// Panics if `code` is not `\r\n`, `\r`, or `\n`. - fn from_code(code: Code) -> LineEnding { - match code { - Code::CarriageReturnLineFeed => LineEnding::CarriageReturnLineFeed, - Code::Char('\r') => LineEnding::CarriageReturn, - Code::Char('\n') => LineEnding::LineFeed, - _ => unreachable!("invalid code"), - } - } -} - /// Representation of a link or image, resource or reference. /// Reused for temporary definitions as well, in the first pass. #[derive(Debug)] @@ -111,110 +56,6 @@ struct Definition { title: Option, } -/// Configuration (optional). -#[derive(Default, Debug)] -pub struct Options { - /// Whether to allow (dangerous) HTML. - /// The default is `false`, you can turn it on to `true` for trusted - /// content. - /// - /// ## Examples - /// - /// ```rust - /// use micromark::{micromark, micromark_with_options, Options}; - /// - /// // micromark is safe by default: - /// assert_eq!( - /// micromark("Hi, venus!"), - /// "

Hi, <i>venus</i>!

" - /// ); - /// - /// // Turn `allow_dangerous_html` on to allow potentially dangerous HTML: - /// assert_eq!( - /// micromark_with_options( - /// "Hi, venus!", - /// &Options { - /// allow_dangerous_html: true, - /// allow_dangerous_protocol: false, - /// default_line_ending: None, - /// - /// } - /// ), - /// "

Hi, venus!

" - /// ); - /// ``` - pub allow_dangerous_html: bool, - - /// Whether to allow (dangerous) protocols in links and images. - /// The default is `false`, you can turn it on to `true` for trusted - /// content. - /// - /// ## Examples - /// - /// ```rust - /// use micromark::{micromark, micromark_with_options, Options}; - /// - /// // micromark is safe by default: - /// assert_eq!( - /// micromark(""), - /// "

javascript:alert(1)

" - /// ); - /// - /// // Turn `allow_dangerous_protocol` on to allow potentially dangerous protocols: - /// assert_eq!( - /// micromark_with_options( - /// "", - /// &Options { - /// allow_dangerous_html: false, - /// allow_dangerous_protocol: true, - /// default_line_ending: None, - /// } - /// ), - /// "

javascript:alert(1)

" - /// ); - /// ``` - pub allow_dangerous_protocol: bool, - - /// Default line ending to use, for line endings not in `value`. - /// - /// Generally, micromark copies line endings (`\r`, `\n`, `\r\n`) in the - /// markdown document over to the compiled HTML. - /// In some cases, such as `> a`, CommonMark requires that extra line - /// endings are added: `
\n

a

\n
`. - /// - /// To create that line ending, the document is checked for the first line - /// ending that is used. - /// If there is no line ending, `default_line_ending` is used. - /// If that isn’t configured, `\n` is used. - /// - /// ## Examples - /// - /// ```rust - /// use micromark::{micromark, micromark_with_options, Options, LineEnding}; - /// - /// // micromark is safe by default: - /// assert_eq!( - /// micromark("> a"), - /// "
\n

a

\n
" - /// ); - /// - /// // Define `default_line_ending` to configure the default: - /// assert_eq!( - /// micromark_with_options( - /// "> a", - /// &Options { - /// allow_dangerous_html: false, - /// allow_dangerous_protocol: false, - /// default_line_ending: Some(LineEnding::CarriageReturnLineFeed), - /// - /// } - /// ), - /// "
\r\n

a

\r\n
" - /// ); - /// ``` - pub default_line_ending: Option, -} - /// Handle an event. /// /// The current event is available at `context.events[context.index]`. -- cgit