extern crate iron; extern crate staticfile; extern crate ws; use std; use self::iron::{status, AfterMiddleware, Chain, Iron, IronError, IronResult, Request, Response, Set}; use clap::{App, ArgMatches, SubCommand}; use mdbook::MDBook; use mdbook::errors::*; use {get_book_dir, open}; #[cfg(feature = "watch")] use watch; struct ErrorRecover; // Create clap subcommand arguments pub fn make_subcommand<'a, 'b>() -> App<'a, 'b> { SubCommand::with_name("serve") .about("Serve the book at http://localhost:3000. Rebuild and reload on change.") .arg_from_usage( "[dir] 'A directory for your book{n}(Defaults to Current Directory when omitted)'", ) .arg_from_usage("-p, --port=[port] 'Use another port{n}(Defaults to 3000)'") .arg_from_usage( "-w, --websocket-port=[ws-port] 'Use another port for the websocket connection \ (livereload){n}(Defaults to 3001)'", ) .arg_from_usage( "-i, --interface=[interface] 'Interface to listen on{n}(Defaults to localhost)'", ) .arg_from_usage( "-a, --address=[address] 'Address that the browser can reach the websocket server \ from{n}(Defaults to the interface address)'", ) .arg_from_usage("-o, --open 'Open the book server in a web browser'") } // Watch command implementation pub fn execute(args: &ArgMatches) -> Result<()> { const RELOAD_COMMAND: &'static str = "reload"; let book_dir = get_book_dir(args); let mut book = MDBook::load(&book_dir)?; let port = args.value_of("port").unwrap_or("3000"); let ws_port = args.value_of("websocket-port").unwrap_or("3001"); let interface = args.value_of("interface").unwrap_or("localhost"); let public_address = args.value_of("address").unwrap_or(interface); let open_browser = args.is_present("open"); let address = format!("{}:{}", interface, port); let ws_address = format!("{}:{}", interface, ws_port); let livereload = Some(format!( r#" "#, public_address, ws_port, RELOAD_COMMAND )); book.livereload = livereload.clone(); book.build()?; let mut chain = Chain::new(staticfile::Static::new(book.get_destination())); chain.link_after(ErrorRecover); let _iron = Iron::new(chain) .http(&*address) .chain_err(|| "Unable to launch the server")?; let ws_server = ws::WebSocket::new(|_| |_| Ok(())).chain_err(|| "Unable to start the websocket")?; let broadcaster = ws_server.broadcaster(); std::thread::spawn(move || { ws_server.listen(&*ws_address).unwrap(); }); let serving_url = format!("http://{}", address); println!("\nServing on: {}", serving_url); if open_browser { open(serving_url); } #[cfg(feature = "watch")] watch::trigger_on_change(&mut book, move |path, book_dir| { println!("File changed: {:?}\nBuilding book...\n", path); // FIXME: This area is really ugly because we need to re-set livereload :( let livereload = livereload.clone(); let result = MDBook::load(&book_dir) .map(move |mut b| { b.livereload = livereload; b }) .and_then(|mut b| b.build()); if let Err(e) = result { error!("Unable to load the book"); error!("Error: {}", e); for cause in e.iter().skip(1) { error!("\tCaused By: {}", cause); } } else { let _ = broadcaster.send(RELOAD_COMMAND); } }); Ok(()) } impl AfterMiddleware for ErrorRecover { fn catch(&self, _: &mut Request, err: IronError) -> IronResult { match err.response.status { // each error will result in 404 response Some(_) => Ok(err.response.set(status::NotFound)), _ => Err(err), } } }