feat(rspack): support xtask

.cargo/config.toml

@@ -7,6 +7,7 @@ lint = "clippy --workspace --all-targets -- --deny warnings"
 # AKA `test-update`, handy cargo rst update without install `cargo-rst` binary
 t  = "test --no-fail-fast"
 tu = "run -p cargo-rst -- update"
+xtask = "run --package xtask --"
 
 [target.'cfg(all())']
 rustflags = [

Cargo.toml

@@ -1,8 +1,8 @@
 cargo-features = ["trim-paths"]
 
 [workspace]
-members  = ["crates/*"]
-resolver = "2"          # See https://doc.rust-lang.org/cargo/reference/resolver.html#feature-resolver-version-2
+members  = ["crates/*", "xtask"]
+resolver = "2"                   # See https://doc.rust-lang.org/cargo/reference/resolver.html#feature-resolver-version-2
 
 [workspace.package]
 authors       = ["Rspack Teams"]

xtask/Cargo.toml

@@ -0,0 +1,18 @@
+[package]
+name = "xtask"
+version = "0.1.0"
+edition = "2021"
+publish = false
+authors.workspace = true
+categories.workspace = true
+documentation.workspace = true
+homepage.workspace = true
+license.workspace = true
+repository.workspace = true
+
+[dependencies]
+anyhow   = { workspace = true }
+clap     = { version = "4.4.6", features = ["derive"] }
+
+[lints]
+workspace = true

xtask/src/commands/api_extractor.rs

@@ -0,0 +1,36 @@
+use anyhow::{Context, Result};
+use clap::{Parser, Subcommand};
+
+use crate::utils::command::run_command;
+
+#[derive(Debug, Parser)]
+pub struct ApiExtractorCmd {
+  #[clap(subcommand)]
+  sub_cmd: ApiExtractorSubCmd,
+}
+
+#[derive(Debug, Subcommand)]
+pub enum ApiExtractorSubCmd {
+  Update,
+  Ci,
+}
+
+impl ApiExtractorCmd {
+  pub fn run(&self) -> Result<()> {
+    match &self.sub_cmd {
+      ApiExtractorSubCmd::Update => {
+        run_command("pnpm", &["-w", "build:js"])?;
+        run_command(
+          "pnpm",
+          &["--filter", "@rspack/*", "api-extractor", "--local"],
+        )?;
+      }
+      ApiExtractorSubCmd::Ci => {
+        run_command("pnpm", &["--filter", "@rspack/*", "api-extractor:ci"]).with_context(|| {
+          "Api-extractor testing failed. Did you forget to update the snapshots locally?\nRun the command below locally to fix this error (in the *ROOT* of rspack workspace).\n$ ./x api-extractor update"
+        })?;
+      }
+    }
+    Ok(())
+  }
+}

xtask/src/commands/mod.rs

@@ -0,0 +1 @@
+pub mod api_extractor;

xtask/src/main.rs

@@ -0,0 +1,31 @@
+use anyhow::Result;
+use clap::{Parser, Subcommand};
+use commands::*;
+
+mod commands;
+mod utils;
+
+#[derive(Debug, Parser)]
+#[clap(
+  name = "Rspack Development CLI",
+  version = "1.0",
+  about = "CLI for development of Rspack"
+)]
+struct CliArgs {
+  #[clap(subcommand)]
+  cmd: Cmd,
+}
+
+#[derive(Debug, Subcommand)]
+enum Cmd {
+  #[clap(name = "api-extractor")]
+  ApiExtractor(api_extractor::ApiExtractorCmd),
+}
+
+fn main() -> Result<()> {
+  let args = CliArgs::parse();
+
+  match args.cmd {
+    Cmd::ApiExtractor(cmd) => cmd.run(),
+  }
+}

xtask/src/utils/command.rs

@@ -0,0 +1,30 @@
+use std::process::Command;
+
+use anyhow::{Context, Result};
+
+#[cfg(windows)]
+const PNPM: &str = "pnpm.cmd";
+#[cfg(not(windows))]
+const PNPM: &str = "pnpm";
+
+pub fn run_command(command: &str, args: &[&str]) -> Result<()> {
+  let program = match command {
+    "pnpm" => PNPM,
+    other => other,
+  };
+
+  let status = Command::new(program)
+    .args(args)
+    .status()
+    .context("Failed to execute command")?;
+
+  if status.success() {
+    Ok(())
+  } else {
+    Err(anyhow::anyhow!(
+      "Command `{}` failed with status code: {}",
+      command,
+      status.code().unwrap_or(-1)
+    ))
+  }
+}

xtask/src/utils/mod.rs

@@ -0,0 +1 @@
+pub mod command;