src/tools/rustbook/src/main.rs

   1 // Copyright 2016 The Rust Project Developers. See the COPYRIGHT
   2 // file at the top-level directory of this distribution and at
   3 // http://rust-lang.org/COPYRIGHT.
   4 //
   5 // Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
   6 // http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
   7 // <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
   8 // option. This file may not be copied, modified, or distributed
   9 // except according to those terms.
  10 //
  11 extern crate mdbook;
  12 #[macro_use]
  13 extern crate clap;
  14
  15 use std::env;
  16 use std::error::Error;
  17 use std::io::{self, Write};
  18 use std::path::{Path, PathBuf};
  19
  20 use clap::{App, ArgMatches, SubCommand, AppSettings};
  21
  22 use mdbook::MDBook;
  23
  24 fn main() {
  25     let d_message = "-d, --dest-dir=[dest-dir]
  26 'The output directory for your book{n}(Defaults to ./book when omitted)'";
  27     let dir_message = "[dir]
  28 'A directory for your book{n}(Defaults to Current Directory when omitted)'";
  29
  30     let matches = App::new("rustbook")
  31                     .about("Build a book with mdBook")
  32                     .author("Steve Klabnik <steve@steveklabnik.com>")
  33                     .version(&*format!("v{}", crate_version!()))
  34                     .setting(AppSettings::SubcommandRequired)
  35                     .subcommand(SubCommand::with_name("build")
  36                         .about("Build the book from the markdown files")
  37                         .arg_from_usage(d_message)
  38                         .arg_from_usage(dir_message))
  39                     .get_matches();
  40
  41     // Check which subcomamnd the user ran...
  42     let res = match matches.subcommand() {
  43         ("build", Some(sub_matches)) => build(sub_matches),
  44         (_, _) => unreachable!(),
  45     };
  46
  47     if let Err(e) = res {
  48         writeln!(&mut io::stderr(), "An error occured:\n{}", e).ok();
  49         ::std::process::exit(101);
  50     }
  51 }
  52
  53 // Build command implementation
  54 fn build(args: &ArgMatches) -> Result<(), Box<Error>> {
  55     let book = build_mdbook_struct(args);
  56
  57     let mut book = match args.value_of("dest-dir") {
  58         Some(dest_dir) => book.set_dest(Path::new(dest_dir)),
  59         None => book
  60     };
  61
  62     try!(book.build());
  63
  64     Ok(())
  65 }
  66
  67 fn build_mdbook_struct(args: &ArgMatches) -> mdbook::MDBook {
  68     let book_dir = get_book_dir(args);
  69     let mut book = MDBook::new(&book_dir).read_config();
  70
  71     // By default mdbook will attempt to create non-existent files referenced
  72     // from SUMMARY.md files. This is problematic on CI where we mount the
  73     // source directory as readonly. To avoid any issues, we'll disabled
  74     // mdbook's implicit file creation feature.
  75     book.create_missing = false;
  76
  77     book
  78 }
  79
  80 fn get_book_dir(args: &ArgMatches) -> PathBuf {
  81     if let Some(dir) = args.value_of("dir") {
  82         // Check if path is relative from current dir, or absolute...
  83         let p = Path::new(dir);
  84         if p.is_relative() {
  85             env::current_dir().unwrap().join(dir)
  86         } else {
  87             p.to_path_buf()
  88         }
  89     } else {
  90         env::current_dir().unwrap()
  91     }
  92 }