1 // Copyright 2015 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.
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.
11 #![feature(rustc_private, rustdoc)]
15 extern crate serialize as rustc_serialize;
17 use std::collections::BTreeMap;
18 use std::fs::{read_dir, File};
19 use std::io::{Read, Write};
22 use std::error::Error;
24 use syntax::diagnostics::metadata::{get_metadata_dir, ErrorMetadataMap};
26 use rustdoc::html::markdown::Markdown;
27 use rustc_serialize::json;
29 /// Load all the metadata files from `metadata_dir` into an in-memory map.
30 fn load_all_errors(metadata_dir: &Path) -> Result<ErrorMetadataMap, Box<Error>> {
31 let mut all_errors = BTreeMap::new();
33 for entry in try!(read_dir(metadata_dir)) {
34 let path = try!(entry).path();
36 let mut metadata_str = String::new();
38 File::open(&path).and_then(|mut f|
39 f.read_to_string(&mut metadata_str))
42 let some_errors: ErrorMetadataMap = try!(json::decode(&metadata_str));
44 for (err_code, info) in some_errors {
45 all_errors.insert(err_code, info);
52 /// Output an HTML page for the errors in `err_map` to `output_path`.
53 fn render_error_page(err_map: &ErrorMetadataMap, output_path: &Path) -> Result<(), Box<Error>> {
54 let mut output_file = try!(File::create(output_path));
56 try!(write!(&mut output_file,
60 <title>Rust Compiler Error Index</title>
61 <meta charset="utf-8">
62 <!-- Include rust.css after main.css so its rules take priority. -->
63 <link rel="stylesheet" type="text/css" href="main.css"/>
64 <link rel="stylesheet" type="text/css" href="rust.css"/>
75 try!(write!(&mut output_file, "<h1>Rust Compiler Error Index</h1>\n"));
77 for (err_code, info) in err_map {
78 // Enclose each error in a div so they can be shown/hidden en masse.
79 let desc_desc = match info.description {
80 Some(_) => "error-described",
81 None => "error-undescribed"
83 let use_desc = match info.use_site {
84 Some(_) => "error-used",
85 None => "error-unused"
87 try!(write!(&mut output_file, "<div class=\"{} {}\">", desc_desc, use_desc));
89 // Error title (with self-link).
90 try!(write!(&mut output_file,
91 "<h2 id=\"{0}\" class=\"section-header\"><a href=\"#{0}\">{0}</a></h2>\n",
95 // Description rendered as markdown.
96 match info.description {
97 Some(ref desc) => try!(write!(&mut output_file, "{}", Markdown(desc))),
98 None => try!(write!(&mut output_file, "<p>No description.</p>\n"))
101 try!(write!(&mut output_file, "</div>\n"));
104 try!(write!(&mut output_file, "</body>\n</html>"));
109 fn main_with_result() -> Result<(), Box<Error>> {
110 let build_arch = try!(env::var("CFG_BUILD"));
111 let metadata_dir = get_metadata_dir(&build_arch);
112 let err_map = try!(load_all_errors(&metadata_dir));
113 try!(render_error_page(&err_map, Path::new("doc/error-index.html")));
118 if let Err(e) = main_with_result() {
119 panic!("{}", e.description());