mdBook/src/main.rs

152 lines
4.6 KiB
Rust
Raw Normal View History

2015-08-01 12:59:05 +08:00
#[macro_use]
extern crate clap;
#[macro_use]
extern crate log;
use anyhow::anyhow;
use chrono::Local;
2022-01-19 05:56:45 +08:00
use clap::{App, AppSettings, Arg, ArgMatches, SubCommand};
use clap_complete::Shell;
use env_logger::Builder;
2018-07-24 01:45:01 +08:00
use log::LevelFilter;
use mdbook::utils;
2018-07-24 01:45:01 +08:00
use std::env;
use std::ffi::OsStr;
use std::io::Write;
use std::path::{Path, PathBuf};
2015-07-07 03:12:24 +08:00
mod cmd;
const VERSION: &str = concat!("v", crate_version!());
2015-07-07 03:12:24 +08:00
fn main() {
init_logger();
2016-08-14 21:55:10 +08:00
let app = create_clap_app();
// Check which subcomamnd the user ran...
let res = match app.get_matches().subcommand() {
2022-01-19 05:56:45 +08:00
Some(("init", sub_matches)) => cmd::init::execute(sub_matches),
Some(("build", sub_matches)) => cmd::build::execute(sub_matches),
Some(("clean", sub_matches)) => cmd::clean::execute(sub_matches),
#[cfg(feature = "watch")]
2022-01-19 05:56:45 +08:00
Some(("watch", sub_matches)) => cmd::watch::execute(sub_matches),
#[cfg(feature = "serve")]
2022-01-19 05:56:45 +08:00
Some(("serve", sub_matches)) => cmd::serve::execute(sub_matches),
Some(("test", sub_matches)) => cmd::test::execute(sub_matches),
Some(("completions", sub_matches)) => (|| {
let shell: Shell = sub_matches
.value_of("shell")
.ok_or_else(|| anyhow!("Shell name missing."))?
.parse()
.map_err(|s| anyhow!("Invalid shell: {}", s))?;
2022-01-19 05:56:45 +08:00
let mut complete_app = create_clap_app();
clap_complete::generate(
shell,
&mut complete_app,
"mdbook",
&mut std::io::stdout().lock(),
);
Ok(())
})(),
2022-01-19 05:56:45 +08:00
_ => unreachable!(),
};
if let Err(e) = res {
utils::log_backtrace(&e);
std::process::exit(101);
}
}
/// Create a list of valid arguments and sub-commands
2022-01-19 05:56:45 +08:00
fn create_clap_app() -> App<'static> {
2018-12-25 20:10:07 +08:00
let app = App::new(crate_name!())
.about(crate_description!())
2018-08-03 04:48:22 +08:00
.author("Mathieu David <mathieudavid@mathieudavid.org>")
.version(VERSION)
.setting(AppSettings::GlobalVersion)
.setting(AppSettings::ArgRequiredElseHelp)
2018-12-25 20:35:37 +08:00
.setting(AppSettings::ColoredHelp)
2018-08-03 04:48:22 +08:00
.after_help(
"For more information about a specific command, try `mdbook <command> --help`\n\
The source code for mdBook is available at: https://github.com/rust-lang/mdBook",
2018-08-03 04:48:22 +08:00
)
.subcommand(cmd::init::make_subcommand())
.subcommand(cmd::build::make_subcommand())
.subcommand(cmd::test::make_subcommand())
.subcommand(cmd::clean::make_subcommand())
.subcommand(
SubCommand::with_name("completions")
.about("Generate shell completions for your shell to stdout")
.arg(
Arg::with_name("shell")
.takes_value(true)
2022-01-19 05:56:45 +08:00
.possible_values(Shell::possible_values())
.help("the shell to generate completions for")
.value_name("SHELL")
.required(true),
),
);
#[cfg(feature = "watch")]
let app = app.subcommand(cmd::watch::make_subcommand());
#[cfg(feature = "serve")]
let app = app.subcommand(cmd::serve::make_subcommand());
2015-08-01 12:59:05 +08:00
app
2015-07-07 03:12:24 +08:00
}
fn init_logger() {
let mut builder = Builder::new();
builder.format(|formatter, record| {
2018-02-18 15:10:47 +08:00
writeln!(
formatter,
"{} [{}] ({}): {}",
Local::now().format("%Y-%m-%d %H:%M:%S"),
record.level(),
record.target(),
record.args()
)
});
if let Ok(var) = env::var("RUST_LOG") {
builder.parse_filters(&var);
} else {
// if no RUST_LOG provided, default to logging at the Info level
builder.filter(None, LevelFilter::Info);
// Filter extraneous html5ever not-implemented messages
builder.filter(Some("html5ever"), LevelFilter::Error);
}
builder.init();
}
2015-08-01 12:59:05 +08:00
fn get_book_dir(args: &ArgMatches) -> PathBuf {
if let Some(dir) = args.value_of("dir") {
// Check if path is relative from current dir, or absolute...
let p = Path::new(dir);
if p.is_relative() {
env::current_dir().unwrap().join(dir)
2015-08-01 12:59:05 +08:00
} else {
p.to_path_buf()
2015-08-01 12:59:05 +08:00
}
} else {
env::current_dir().expect("Unable to determine the current directory")
2015-07-07 03:12:24 +08:00
}
}
2016-04-02 10:46:05 +08:00
2017-01-02 01:42:47 +08:00
fn open<P: AsRef<OsStr>>(path: P) {
2021-09-07 03:52:43 +08:00
info!("Opening web browser");
if let Err(e) = opener::open(path) {
error!("Error opening web browser: {}", e);
2017-01-02 01:42:47 +08:00
}
}
2022-01-19 05:56:45 +08:00
#[test]
fn verify_app() {
create_clap_app().debug_assert();
}