futhorc 0.1.13

A static site generator to learn Rust and to build my personal blog
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use clap::{App, Arg, SubCommand};
use futhorc::build::{self, build_site};
use futhorc::config::{self, Config};
use std::fmt;
use std::path::{Path, PathBuf};

fn main() -> Result<(), Error> {
    const DEFAULT_PROJECT_DIRECTORY: &str = "$PWD";
    const DEFAULT_OUTPUT_DIRECTORY: &str = "$PWD/_output";

    let matches = App::new("futhorc")
        .version("0.1")
        .author("Craig Weber <weberc2@gmail.com>")
        .about("A rustic static site generator")
        .subcommand(
            SubCommand::with_name("build")
                .about("Builds the static site")
                .arg(
                    Arg::with_name("PROJECT_DIRECTORY")
                        .short("p")
                        .long("project")
                        .required(true)
                        .takes_value(true)
                        .value_name("PROJECT_DIRECTORY")
                        .help("Any directory inside of the project to build")
                        .default_value(DEFAULT_PROJECT_DIRECTORY),
                )
                .arg(
                    Arg::with_name("OUTPUT_DIRECTORY")
                        .short("o")
                        .long("output")
                        .takes_value(true)
                        .required(true)
                        .value_name("OUTPUT_DIRECTORY")
                        .help("The target directory for the output HTML files")
                        .default_value(DEFAULT_OUTPUT_DIRECTORY),
                )
                .arg(
                    Arg::with_name("PROFILE")
                        .long("profile")
                        .takes_value(true)
                        .required(false)
                        .value_name("PROFILE")
                        .help("The project profile to use for the build"),
                ),
        )
        .get_matches();

    if let Some(matches) = matches.subcommand_matches("build") {
        let cwd = std::env::current_dir().map_err(Error::Env)?;
        let project = matches
            .value_of("PROJECT_DIRECTORY")
            .expect("Argument PROJECT_DIRECTORY is required.");
        let project: &Path = match project {
            DEFAULT_PROJECT_DIRECTORY => &cwd,
            _ => Path::new(project),
        };

        let output = matches
            .value_of("OUTPUT_DIRECTORY")
            .expect("Argument OUTPUT_DIRECTORY is required");
        let output: PathBuf = match output {
            DEFAULT_OUTPUT_DIRECTORY => cwd.join("_output"),
            _ => PathBuf::from(output),
        };

        return build_site(
            Config::from_directory(
                project,
                &output,
                matches.value_of("PROFILE"),
            )
            .map_err(Error::Config)?,
        )
        .map_err(Error::Build);
    }
    Err(Error::MissingSubcommand)
}

/// Error is the toplevel error type, with variants for issues loading the
/// config, building the site, and general argument parsing.
enum Error {
    /// `MissingSubcommand` is represents a missing or incorrect subcommand.
    MissingSubcommand,

    /// `Config` represents errors loading the configuration.
    Config(config::Error),

    /// `Build` represents errors building the static site.
    Build(build::Error),

    /// `Env` represents errors parsing arguments from the process's
    /// environment.
    Env(std::io::Error),
}

impl fmt::Display for Error {
    /// `fmt` renders the error in text form.
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        match self {
            Error::MissingSubcommand => {
                write!(f, "Missing subcommand. Try rerunning with --help")
            }
            Error::Config(err) => err.fmt(f),
            Error::Build(err) => err.fmt(f),
            Error::Env(err) => err.fmt(f),
        }
    }
}

// Implement Debug by invoking Display::fmt for the error so the toplevel error
// messages are prettier.
impl fmt::Debug for Error {
    /// `fmt` renders the error in text form. This just calls
    /// [`fmt::Display::fmt`] so the toplevel errors are prettier.
    fn fmt(&self, f: &mut fmt::Formatter) -> fmt::Result {
        fmt::Display::fmt(self, f)
    }
}