Xtask

.cargo/config.toml

@@ -0,0 +1,2 @@
+[alias]
+xtask = "run --package xtask --"

.github/workflows/install-mdbook/action.yml

@@ -6,7 +6,7 @@ runs:
   using: composite
   steps:
     - name: Install mdbook
-      run: ./install-mdbook.sh
+      run: cargo xtask install-tools
       shell: bash
 
     - name: Install dependencies for mdbook-pandoc

Cargo.toml

@@ -29,5 +29,6 @@ members = [
   "src/unsafe-rust",
   "src/user-defined-types",
   "third_party/cxx/blobstore",
+  "xtask",
 ]
 resolver = "2"

README.md

@@ -71,7 +71,7 @@ cd comprehensive-rust
 Then install these tools with:
 
 ```shell
-bash install-mdbook.sh
+cargo xtask install-tools
 ```
 
 Run

xtask/Cargo.toml

@@ -0,0 +1,6 @@
+[package]
+name = "xtask"
+version = "0.1.0"
+edition = "2021"
+
+[dependencies]

xtask/src/main.rs

@@ -0,0 +1,70 @@
+use std::{env, process::Command};
+
+type DynError = Box<dyn std::error::Error>;
+
+fn main() {
+    if let Err(e) = execute_task() {
+        eprintln!("{e}");
+        std::process::exit(-1);
+    }
+}
+
+fn execute_task() -> Result<(), DynError> {
+    let task = env::args().nth(1);
+    match task.as_deref() {
+        Some("install-tools") => install_tools()?,
+        _ => print_help(task.as_deref()),
+    }
+    Ok(())
+}
+
+fn install_tools() -> Result<(), DynError> {
+    println!("Installing project tools...");
+    // The --locked flag is important for reproducible builds. It also
+    // avoids breakage due to skews between mdbook and mdbook-svgbob.
+    Command::new(env!("CARGO"))
+        .arg("install")
+        .args(["mdbook", "--locked", "--version", "0.4.44"])
+        .status()?;
+    Command::new(env!("CARGO"))
+        .arg("install")
+        .args(["mdbook-svgbob", "--locked", "--version", "0.2.1"])
+        .status()?;
+    Command::new(env!("CARGO"))
+        .arg("install")
+        .args(["mdbook-pandoc", "--locked", "--version", "0.9.3"])
+        .status()?;
+    Command::new(env!("CARGO"))
+        .arg("install")
+        .args(["mdbook-i18n-helpers", "--locked", "--version", "0.3.5"])
+        .status()?;
+    Command::new(env!("CARGO"))
+        .arg("install")
+        .args(["i18n-report", "--locked", "--version", "0.2.0"])
+        .status()?;
+    // These packages are located in this repository
+    Command::new(env!("CARGO"))
+        .arg("install")
+        .args(["--path", "mdbook-exerciser", "--locked"])
+        .status()?;
+    Command::new(env!("CARGO"))
+        .arg("install")
+        .args(["--path", "mdbook-course", "--locked"])
+        .status()?;
+    Ok(())
+}
+
+fn print_help(task: Option<&str>) {
+    if let Some(t) = task {
+        eprintln!(
+            "Unrecognized task '{t}'. Available tasks:
+
+install-tools            Installs the tools the project dependends on.
+
+Run with `cargo xtask [task]`.
+"
+        );
+    } else {
+        eprintln!("Missing task. To execute a task run `cargo xtask [task]`.");
+    }
+}