implement proper linkchecker hardening

This commit is contained in:
mark 2020-02-02 23:41:33 -06:00 committed by Mark Mansi
parent bdd946df3a
commit 0c0c31b11c
3 changed files with 63 additions and 10 deletions

View file

@ -3067,6 +3067,7 @@ name = "rustbook"
version = "0.1.0" version = "0.1.0"
dependencies = [ dependencies = [
"clap", "clap",
"codespan",
"codespan-reporting", "codespan-reporting",
"failure", "failure",
"mdbook", "mdbook",

View file

@ -6,13 +6,14 @@ license = "MIT OR Apache-2.0"
edition = "2018" edition = "2018"
[features] [features]
linkcheck = ["mdbook-linkcheck", "codespan-reporting"] linkcheck = ["mdbook-linkcheck", "codespan-reporting", "codespan"]
[dependencies] [dependencies]
clap = "2.25.0" clap = "2.25.0"
failure = "0.1" failure = "0.1"
mdbook-linkcheck = { version = "0.5.0", optional = true } mdbook-linkcheck = { version = "0.5.0", optional = true }
# Keep in sync with mdbook-linkcheck. # Keep in sync with mdbook-linkcheck.
codespan = { version = "0.5", optional = true }
codespan-reporting = { version = "0.5", optional = true } codespan-reporting = { version = "0.5", optional = true }

View file

@ -8,8 +8,6 @@ use clap::{App, AppSettings, ArgMatches, SubCommand};
use mdbook::errors::Result as Result3; use mdbook::errors::Result as Result3;
use mdbook::MDBook; use mdbook::MDBook;
#[cfg(feature = "linkcheck")]
use failure::Error;
#[cfg(feature = "linkcheck")] #[cfg(feature = "linkcheck")]
use mdbook::renderer::RenderContext; use mdbook::renderer::RenderContext;
@ -53,8 +51,18 @@ fn main() {
("linkcheck", Some(sub_matches)) => { ("linkcheck", Some(sub_matches)) => {
#[cfg(feature = "linkcheck")] #[cfg(feature = "linkcheck")]
{ {
if let Err(err) = linkcheck(sub_matches) { let (diags, files) = linkcheck(sub_matches).expect("Error while linkchecking.");
eprintln!("Error: {}", err); if !diags.is_empty() {
let color = codespan_reporting::term::termcolor::ColorChoice::Auto;
let mut writer =
codespan_reporting::term::termcolor::StandardStream::stderr(color);
let cfg = codespan_reporting::term::Config::default();
for diag in diags {
codespan_reporting::term::emit(&mut writer, &cfg, &files, &diag)
.expect("Unable to emit linkcheck error.");
}
std::process::exit(101); std::process::exit(101);
} }
} }
@ -73,14 +81,57 @@ fn main() {
} }
#[cfg(feature = "linkcheck")] #[cfg(feature = "linkcheck")]
pub fn linkcheck(args: &ArgMatches<'_>) -> Result<(), Error> { pub fn linkcheck(
args: &ArgMatches<'_>,
) -> Result<(Vec<codespan_reporting::diagnostic::Diagnostic>, codespan::Files), failure::Error> {
use mdbook_linkcheck::Reason;
let book_dir = get_book_dir(args); let book_dir = get_book_dir(args);
let src_dir = get_book_dir(args).join("src");
let book = MDBook::load(&book_dir).unwrap(); let book = MDBook::load(&book_dir).unwrap();
let cfg = book.config; let linkck_cfg = mdbook_linkcheck::get_config(&book.config)?;
let render_ctx = RenderContext::new(&book_dir, book.book, cfg, &book_dir); let mut files = codespan::Files::new();
let target_files = mdbook_linkcheck::load_files_into_memory(&book.book, &mut files);
let render_ctx = RenderContext::new(&book_dir, book.book, book.config, &book_dir);
let cache_file = render_ctx.destination.join("cache.json"); let cache_file = render_ctx.destination.join("cache.json");
let color = codespan_reporting::term::termcolor::ColorChoice::Auto; let cache = mdbook_linkcheck::Cache::load(std::fs::File::open(cache_file)?)?;
mdbook_linkcheck::run(&cache_file, color, &render_ctx)
let (links, incomplete) = mdbook_linkcheck::extract_links(target_files, &files);
let outcome =
mdbook_linkcheck::validate(&links, &linkck_cfg, &src_dir, &cache, &files, incomplete)?;
let mut is_real_error = false;
for link in outcome.invalid_links.iter() {
match &link.reason {
Reason::FileNotFound | Reason::TraversesParentDirectories => {
is_real_error = true;
}
Reason::UnsuccessfulServerResponse(status) => {
if status.is_client_error() {
is_real_error = true;
} else {
eprintln!("Unsuccessful server response for link `{}`", link.link.uri);
}
}
Reason::Client(err) => {
if err.is_timeout() {
eprintln!("Timeout for link `{}`", link.link.uri);
} else if err.is_server_error() {
eprintln!("Server error for link `{}`", link.link.uri);
} else {
is_real_error = true;
}
}
}
}
if is_real_error {
Ok((outcome.generate_diagnostics(&files, linkck_cfg.warning_policy), files))
} else {
Ok((vec![], files))
}
} }
// Build command implementation // Build command implementation