mirror of
https://github.com/rust-lang/mdBook
synced 2024-12-15 07:12:35 +00:00
09667c9956
* The preprocessor trait now returns a modified book instead of editing in place * A preprocessor is told which render it's running for * Made sure preprocessors get their renderer's name * Users can now manually specify whether a preprocessor should run for a renderer * You can normally use default preprocessors by default * Got my logic around the wrong way * Fixed the `build.use-default-preprocessors` flag
80 lines
1.9 KiB
Rust
80 lines
1.9 KiB
Rust
extern crate mdbook;
|
|
|
|
mod dummy_book;
|
|
|
|
use dummy_book::DummyBook;
|
|
use mdbook::book::Book;
|
|
use mdbook::config::Config;
|
|
use mdbook::errors::*;
|
|
use mdbook::preprocess::{Preprocessor, PreprocessorContext};
|
|
use mdbook::renderer::{RenderContext, Renderer};
|
|
use mdbook::MDBook;
|
|
use std::sync::{Arc, Mutex};
|
|
|
|
struct Spy(Arc<Mutex<Inner>>);
|
|
|
|
#[derive(Debug, Default)]
|
|
struct Inner {
|
|
run_count: usize,
|
|
rendered_with: Vec<String>,
|
|
}
|
|
|
|
impl Preprocessor for Spy {
|
|
fn name(&self) -> &str {
|
|
"dummy"
|
|
}
|
|
|
|
fn run(&self, ctx: &PreprocessorContext, book: Book) -> Result<Book> {
|
|
let mut inner = self.0.lock().unwrap();
|
|
inner.run_count += 1;
|
|
inner.rendered_with.push(ctx.renderer.clone());
|
|
Ok(book)
|
|
}
|
|
}
|
|
|
|
impl Renderer for Spy {
|
|
fn name(&self) -> &str {
|
|
"dummy"
|
|
}
|
|
|
|
fn render(&self, _ctx: &RenderContext) -> Result<()> {
|
|
let mut inner = self.0.lock().unwrap();
|
|
inner.run_count += 1;
|
|
Ok(())
|
|
}
|
|
}
|
|
|
|
#[test]
|
|
fn mdbook_runs_preprocessors() {
|
|
let spy: Arc<Mutex<Inner>> = Default::default();
|
|
|
|
let temp = DummyBook::new().build().unwrap();
|
|
let cfg = Config::default();
|
|
|
|
let mut book = MDBook::load_with_config(temp.path(), cfg).unwrap();
|
|
book.with_preprecessor(Spy(Arc::clone(&spy)));
|
|
book.build().unwrap();
|
|
|
|
let inner = spy.lock().unwrap();
|
|
assert_eq!(inner.run_count, 1);
|
|
assert_eq!(inner.rendered_with.len(), 1);
|
|
assert_eq!(
|
|
"html", inner.rendered_with[0],
|
|
"We should have been run with the default HTML renderer"
|
|
);
|
|
}
|
|
|
|
#[test]
|
|
fn mdbook_runs_renderers() {
|
|
let spy: Arc<Mutex<Inner>> = Default::default();
|
|
|
|
let temp = DummyBook::new().build().unwrap();
|
|
let cfg = Config::default();
|
|
|
|
let mut book = MDBook::load_with_config(temp.path(), cfg).unwrap();
|
|
book.with_renderer(Spy(Arc::clone(&spy)));
|
|
book.build().unwrap();
|
|
|
|
let inner = spy.lock().unwrap();
|
|
assert_eq!(inner.run_count, 1);
|
|
}
|