build.rs

use std::env;
use std::ffi::OsStr;
use std::fs::{self, DirEntry, File};
use std::io::{BufReader, Result};
use std::path::{Path, PathBuf};
use std::process::Command;

#[cfg(feature = "generate-fresh")]
use bindgen::{builder, Builder};
use cc::Build;
use pretty_assertions::assert_eq as eq;
use serde_json::Value;

macro_rules! env {
    ($var:literal) => {
        std::env::var($var).unwrap()
    };
}

const BACKEND: &str = "lc3tools/backend";
const FRONTEND: &str = "lc3tools/frontend/common";
const GRADER: &str = "lc3tools/frontend/grader";

#[cfg(feature = "generate-fresh")]
const BINDINGS_PATH: &str = "generated/bindings.rs";

fn in_dir_with_ext<'s, D>(
    dir: &D,
    ext: &'s str,
) -> Result<impl Iterator<Item = DirEntry> + 's>
where
    D: AsRef<OsStr> + ?Sized,
{
    Ok(fs::read_dir(Path::new(&dir))?
        .filter_map(|d| d.ok())
        .filter(|d| d.file_type().unwrap().is_file())
        .filter(|d|
            // This file is not used and is broken.
            d.path().file_name().unwrap().to_str().unwrap() != "device.h")
        .filter(move |de| {
            de.path().extension().unwrap().to_str().unwrap() == ext
        }))
}

fn copy_headers<I>(inc_dir: &I, cpy_dir: &Path) -> Result<()>
where
    I: AsRef<OsStr> + ?Sized,
{
    fs::create_dir_all(&cpy_dir)?;

    let inc_dir_str = inc_dir.as_ref().to_str().unwrap();
    println!("cargo:rerun-if-changed={}", inc_dir_str);

    for header in in_dir_with_ext(inc_dir, "h").unwrap_or_else(|e| {
        panic!("{}: expected header files in `{}`", e, inc_dir_str)
    }) {
        let path = header.path();
        let to = cpy_dir.join(path.file_name().unwrap());
        fs::copy(&path, &to).expect("Header file copy to succeed");
    }

    Ok(())
}

// This is kind of a duplicate of `rustfmt` functions in the root of the
// `bindgen` crate except we just run `rustfmt` straight on the generated files
// rather than messing with pipes and threads. We can can do this since our use
// case is much narrower.
//
// We also pretty much just assume `rustfmt` is in the PATH or in an env var
// and don't try to search for it (`bindgen` uses `which::which` when the
// `which-rustfmt` feature is enabled).
#[cfg(feature = "generate-fresh")]
fn run_rustfmt<F>(files: impl IntoIterator<Item = F>) -> Result<()>
where
    F: AsRef<OsStr>,
{
    let rustfmt = if let Ok(rustfmt) = env::var("RUSTFMT") {
        rustfmt
    } else {
        String::from("rustfmt")
    };

    let success = Command::new(rustfmt).args(files).status()?.success();

    assert!(success, "`rustfmt` failed.");

    Ok(())
}

#[cfg(feature = "generate-fresh")]
fn make_bindings<I>(
    inc_dirs: &[&I],
) -> std::result::Result<syn::File, Box<dyn std::error::Error>>
where
    I: AsRef<OsStr> + std::fmt::Display + ?Sized,
{
    let mut builder: Builder = builder();

    for dir in inc_dirs {
        for header in in_dir_with_ext(dir, "h").unwrap_or_else(|e| {
            panic!("{}: expected header files in `{}`", e, dir)
        }) {
            builder = builder
                .header::<String>(header.path().to_str().unwrap().into())
                .parse_callbacks(Box::new(bindgen::CargoCallbacks));
        }
    }

    #[rustfmt::skip]
    let res = builder
        .enable_cxx_namespaces()
        .clang_arg("-xc++")
        .clang_arg("-std=c++14")
        .clang_arg("-Ilc3tools/backend")

        .derive_debug(true)
        .derive_default(true)
        .generate_comments(true)
        .rustfmt_bindings(false) // We'll run this ourselves after processing.

        .blacklist_item("std::value")
        .blacklist_item("__gnu_cxx::__max")
        .blacklist_item("__gnu_cxx::__min")

        .blacklist_item("std::collate_string_type")
        .blacklist_item("std::collate_byname_string_type")
        .blacklist_item("std::numpunct_string_type")
        .blacklist_item("std::numpunct_byname_string_type")
        .blacklist_item("size_type")
        .blacklist_item("std::size_type")
        .blacklist_item("int_type")
        .blacklist_item("char_type")
        .blacklist_item("__atomic_val_t")
        .blacklist_item("__atomic_diff_t")
        .blacklist_item("std::__atomic_val_t")
        .blacklist_item("std::__atomic_diff_t")
        .blacklist_item("std::basic_ostream_sentry")
        .blacklist_item("std::basic_istream_sentry___istream_type")
        .blacklist_item("std::basic_istream_sentry_traits_type")
        .blacklist_item("std::basic_istream_sentry___streambuf_type")

        .generate()
        .expect("Unable to generate bindings!")
        .to_string();

    // `bindgen` actually has a `proc_macro2::TokenStream` internally that it
    // then turns into a String but since we've got no way to actually access
    // that TokenStream we've gotta do this silly thing where we turn things
    // into a String and then back into a TokenStream and then do the parse.
    //
    // This isn't great but since we don't expect users to run this, it should
    // be okay.
    let parsed: syn::File = syn::parse_str(&res)?;

    Ok(parsed)
}

#[cfg(feature = "generate-fresh")]
pub mod binding_support {
    use std::collections::{HashMap, HashSet};

    use syn::{
        punctuated::Punctuated, token::Colon2, visit::Visit,
        visit_mut::VisitMut, Attribute, File, Ident, Item, PathSegment,
    };

    #[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
    pub enum Feature {
        Frontend,
        Grader,
    }

    impl Feature {
        pub fn attrs(&self) -> Vec<Attribute> {
            match self {
                Feature::Grader => {
                    let r#struct: Item = syn::parse_quote!(
                        #[cfg(feature = "grader")]
                        #[cfg_attr(
                            all(docs, not(doctest)),
                            doc(cfg(feature = "grader"))
                        )]
                        struct Null;
                    );

                    match r#struct {
                        Item::Struct(s) => s.attrs,
                        _ => unreachable!(),
                    }
                }
                Feature::Frontend => {
                    let r#struct: Item = syn::parse_quote!(
                        #[cfg(feature = "frontend")]
                        #[cfg_attr(
                            all(docs, not(doctest)),
                            doc(cfg(feature = "frontend"))
                        )]
                        struct Null;
                    );

                    match r#struct {
                        Item::Struct(s) => s.attrs,
                        _ => unreachable!(),
                    }
                }
            }
        }
    }

    pub type Path = Punctuated<PathSegment, Colon2>;

    #[derive(Debug, Eq, PartialEq, Hash)]
    pub enum Element<'ast> {
        PathBased(Path),
        ValueBased(Path, &'ast Item),
    }

    pub type Map<'ast> = HashMap<Element<'ast>, Option<Feature>>;

    // We make some assumptions including:
    //   - impls functions won't have other modules, types, impls, traits, etc.
    //     within them; just functions.

    #[derive(Debug, Default)]
    pub struct PathTrack {
        current_path: Path,
    }

    impl PathTrack {
        pub fn new() -> Self {
            Self {
                current_path: Punctuated::new(),
            }
        }

        pub fn module<'ast>(&mut self, ident: Ident) -> Element<'ast> {
            self.current_path.push(PathSegment::from(ident));
            Element::PathBased(self.current_path.clone())
        }

        pub fn item<'ast>(&self, item: &'ast Item) -> Element<'ast> {
            Element::ValueBased(self.current_path.clone(), item)
        }

        pub fn pop(
            &mut self,
        ) -> Option<syn::punctuated::Pair<PathSegment, Colon2>> {
            self.current_path.pop()
        }
    }

    pub struct ItemRecorder<'ast> {
        path: PathTrack,
        item_record: HashSet<Element<'ast>>,
    }

    impl<'ast> Default for ItemRecorder<'ast> {
        fn default() -> Self {
            Self::new()
        }
    }

    impl<'ast> ItemRecorder<'ast> {
        pub fn new() -> Self {
            Self {
                path: PathTrack::new(),
                item_record: HashSet::new(),
            }
        }
    }

    impl<'ast> Visit<'ast> for ItemRecorder<'ast> {
        fn visit_item(&mut self, i: &'ast Item) {
            use Item::*;
            match i {
                Const(_) | Enum(_) | ExternCrate(_) | Fn(_) | ForeignMod(_)
                | Macro(_) | Macro2(_) | Impl(_) | Static(_) | Struct(_)
                | Trait(_) | TraitAlias(_) | Type(_) | Union(_) | Use(_) => {
                    assert!(
                        self.item_record.insert(self.path.item(i)),
                        "{:?} already exists!",
                        i
                    )
                }

                Mod(syn::ItemMod { ident, .. }) => {
                    assert!(self
                        .item_record
                        .insert(self.path.module(ident.clone())));

                    // Recurse:
                    syn::visit::visit_item(self, i);

                    self.path.pop().unwrap();
                }

                Verbatim(_) => unreachable!(),
                _ => unreachable!(),
            }
        }
    }

    pub fn elements<'ast>(file: &'ast File) -> HashSet<Element<'ast>> {
        let mut visitor = ItemRecorder::new();
        syn::visit::visit_file(&mut visitor, file);

        visitor.item_record
    }

    pub struct FeatureTag<'ast> {
        path: PathTrack,
        map: Map<'ast>,
    }

    impl<'ast> FeatureTag<'ast> {
        pub fn new(map: Map<'ast>) -> Self {
            Self {
                path: PathTrack::new(),
                map,
            }
        }
    }

    impl<'ast> VisitMut for FeatureTag<'ast> {
        fn visit_item_mut(&mut self, i: &mut Item) {
            use Item::*;

            let item = i.clone(); // This is dumb but I can't seem to find a
                                  // way to shrink `i`'s lifetime..
            match i {
                Const(syn::ItemConst { attrs, .. })
                | Enum(syn::ItemEnum { attrs, .. })
                | ExternCrate(syn::ItemExternCrate { attrs, .. })
                | Fn(syn::ItemFn { attrs, .. })
                | ForeignMod(syn::ItemForeignMod { attrs, .. })
                | Macro(syn::ItemMacro { attrs, .. })
                | Macro2(syn::ItemMacro2 { attrs, .. })
                | Impl(syn::ItemImpl { attrs, .. })
                | Static(syn::ItemStatic { attrs, .. })
                | Struct(syn::ItemStruct { attrs, .. })
                | Trait(syn::ItemTrait { attrs, .. })
                | TraitAlias(syn::ItemTraitAlias { attrs, .. })
                | Type(syn::ItemType { attrs, .. })
                | Union(syn::ItemUnion { attrs, .. })
                | Use(syn::ItemUse { attrs, .. }) => {
                    // We want to panic if we manage to look up an item that
                    // isn't in the map.
                    if let Some(feature) = self.map[&self.path.item(&item)] {
                        attrs.extend(feature.attrs())
                    }
                }

                Mod(syn::ItemMod { attrs, ident, .. }) => {
                    // Same here; we want to panic if the lookup fails.
                    //
                    // Technically we needn't tack on the feature attrs for
                    // modules since we mark everything within but it shouldn't
                    // hurt (doc feature tags are inherited but _hopefully_ such
                    // attrs on an item override ones that are inherited from
                    // a parent module — if not we'll run into the issue where
                    // things within a module that are only active under a more
                    // specific feature than their parent module have
                    // incorrect doc feature tag).
                    if let Some(feature) =
                        self.map[&self.path.module(ident.clone())]
                    {
                        attrs.extend(feature.attrs());
                    }

                    // Recurse:
                    syn::visit_mut::visit_item_mut(self, i);

                    self.path.pop().unwrap();
                }

                Verbatim(_) => unreachable!(),
                _ => unreachable!(),
            }
        }
    }

    pub fn tag<'ast: 'f, 'f>(file: &'f mut File, map: Map<'ast>) {
        let mut visitor = FeatureTag::new(map);
        syn::visit_mut::visit_file_mut(&mut visitor, file);
    }
}

fn main() -> Result<()> {
    // For path/git deps (when grabbing from crates.io lc3tools will be rolled
    // into the package).
    if !Path::new("lc3tools/.git").exists() {
        let exit_code = Command::new("git")
            .args(&["submodule", "update", "--init"])
            .status()?;

        assert!(exit_code.success(), "Failed to clone `lc3tools`");
    }

    // Next we make sure that the lc3tools source we have matches this crates'
    // version.
    //
    // (This isn't perfect; ideally we'd actually check that we've got a
    // tag of the submodule whose name matches the version we're looking for but
    // we don't keep `.git` around when we publish to `crates.io` so this will
    // have to do.)
    let crate_version = env!("CARGO_PKG_VERSION");

    let lc3tools_package_json = Path::new("lc3tools/frontend/gui/package.json");
    let lc3tools_package_json = File::open(lc3tools_package_json)
        .expect("`package.json` in lc3tools/frontend/gui");
    let reader = BufReader::new(lc3tools_package_json);
    let package_json = serde_json::from_reader::<_, Value>(reader)
        .expect("A valid `package.json`");
    let lc3tools_version = &package_json["version"];

    eq!(crate_version, lc3tools_version.as_str().unwrap());

    // First, lets gather and copy over the header files.
    let out = PathBuf::from(env::var_os("OUT_DIR").unwrap());
    let include = out.join("include");

    // TODO: right now this does not check if there are two header files with
    // the same name. As of this writing, all the header files in lc3tools have
    // unique names but if this were to change, we'd lose header files in the
    // generated output without any warning.
    copy_headers(BACKEND, &include)?;
    if cfg!(feature = "grader") {
        copy_headers(GRADER, &include)?
    }
    if cfg!(feature = "frontend") {
        copy_headers(FRONTEND, &include)?
    }

    // TODO: is `canonicalize` actually broken? (rust#42869)
    println!("cargo:include={}", include.canonicalize()?.display());

    // Next, let's do bindgen, if we're asked to.
    #[cfg(feature = "generate-fresh")]
    {
        use std::io::Write;

        use binding_support::{elements, tag, Feature, Map};
        use quote::ToTokens;

        // First we want to get the baseline bindings — just the backend, no
        // other features — and record what items this has.
        let backend = make_bindings(&[BACKEND]).unwrap();

        // Next, the bindings for the frontend and then for the grader + the
        // frontend (the grader requires the frontend).
        let frontend = make_bindings(&[BACKEND, FRONTEND]).unwrap();
        let grader = make_bindings(&[BACKEND, FRONTEND, GRADER]).unwrap();

        // For each of the above configurations, get the set of elements:
        let mut backend_elements = elements(&backend);
        let mut frontend_elements = elements(&frontend);
        let mut grader_elements = elements(&grader);

        // And then assemble the attribute map.
        let mut map = Map::with_capacity(grader_elements.len());
        map.extend(backend_elements.drain().map(|k| (k, None)));

        assert!(frontend_elements.is_superset(&backend_elements));
        assert!(grader_elements.is_superset(&frontend_elements));

        for element in frontend_elements.drain() {
            map.entry(element).or_insert(Some(Feature::Frontend));
        }

        for element in grader_elements.drain() {
            map.entry(element).or_insert(Some(Feature::Grader));
        }

        // Finally, tag the full binding set with the appropriate attrs, fmt,
        // and emit.
        let mut full = grader.clone();
        tag(&mut full, map);

        let ts = full.into_token_stream();
        let mut f = File::create(&BINDINGS_PATH)?;

        write!(f, "{}", ts)?;
        drop(f);

        run_rustfmt(&[BINDINGS_PATH]).unwrap();
    }

    // Finally let's go gather the C++ files and do the build.
    let mut build = Build::new();
    // `cc` automatically handles `OPT_LEVEL` and `DEBUG`.
    // `cc` also handles `fPIC`

    if cfg!(windows) {
        build.flag("/EHsc");
    }

    if cfg!(feature = "lto") {
        build.flag_if_supported("-flto=thin");
    }

    build
        .flag_if_supported("-std=c++14")
        .flag_if_supported("-Wno-format-security")
        .cargo_metadata(true)
        .warnings(true)
        .extra_warnings(true)
        .cpp(true);

    // Debug settings:
    if env!("PROFILE") == "debug" {
        build.define("_ENABLE_DEBUG", None);
    }

    // Remove `main` from framework.cpp if it's there and we're building with
    // the grader feature.
    if cfg!(feature = "grader") {
        use std::io::{Read, Write};
        let path = PathBuf::from(&GRADER).join("framework.cpp");

        if let Ok(mut file) = File::open(&path) {
            let mut contents =
                String::with_capacity(file.metadata().unwrap().len() as usize);
            file.read_to_string(&mut contents).unwrap();

            if contents.contains("int main(") {
                drop(file);
                let mut file = File::create(path).unwrap();

                write!(
                    file,
                    "{}",
                    contents
                        .replace("int main(", "/* int framework_main(")
                        .replace("return 0;\n}", "return 0;\n} */")
                )
                .unwrap()
            }
        }
    }

    // Includes:
    build.include(BACKEND);
    if cfg!(feature = "grader") {
        build.include(GRADER);
    }
    if cfg!(feature = "frontend") {
        build.include(FRONTEND);
    }

    // Collecting files:
    let cpp_dir_iter = |dir| {
        in_dir_with_ext(dir, "cpp").unwrap_or_else(|e| {
            panic!("{}: expected source files in `{}`", e, dir)
        })
    };

    let files = cpp_dir_iter(BACKEND);
    #[cfg(feature = "grader")]
    let files = files.chain(cpp_dir_iter(GRADER));
    #[cfg(feature = "frontend")]
    let files = files.chain(cpp_dir_iter(FRONTEND));

    for source_file in files {
        println!("cargo:rerun-if-changed={}", source_file.path().display());
        build.file(source_file.path());
    }

    // And finally, the build:
    // `cc` automatically tells cargo to link to this statically.
    build.out_dir(out.join("build")).compile("lc3core");
    println!("cargo:root={}", out.display());

    Ok(())
}