Audit public API and SemVer surface (#103)

tools/ci-matrix/src/lib.rs

@@ -11,9 +11,11 @@ use std::path::{Path, PathBuf};
 use std::process::{Command, ExitStatus, Stdio};
 use std::time::{SystemTime, UNIX_EPOCH};
 
+mod api_surface;
 mod dependency;
 mod documentation;
 
+pub use api_surface::{audit_api_surface, write_api_baseline};
 pub use dependency::audit_dependencies;
 pub use documentation::{audit_documentation, write_documentation_report};
 

tools/ci-matrix/src/main.rs

@@ -1,6 +1,6 @@
 use metacrate_ci_matrix::{
-    audit, audit_dependencies, audit_documentation, load, run, workspace_root,
-    write_documentation_report,
+    audit, audit_api_surface, audit_dependencies, audit_documentation, load, run, workspace_root,
+    write_api_baseline, write_documentation_report,
 };
 use std::path::{Path, PathBuf};
 
@@ -67,9 +67,27 @@ fn execute() -> Result<(), Box<dyn std::error::Error>> {
             audit_documentation(&root, &evidence)?;
             println!("documentation coverage: ok ({})", evidence.display());
         }
+        Some("api-baseline-write") if arguments.next().is_none() => {
+            write_api_baseline(&root)?;
+            println!("API/SemVer baseline and report: updated");
+        }
+        Some("api-audit") => {
+            let flag = arguments
+                .next()
+                .ok_or("api-audit requires --evidence FILE")?;
+            let evidence = arguments
+                .next()
+                .ok_or("api-audit requires --evidence FILE")?;
+            if flag != "--evidence" || arguments.next().is_some() {
+                return Err("usage: ci-matrix api-audit --evidence FILE".into());
+            }
+            let evidence = absolute_or_rooted(&root, &evidence);
+            audit_api_surface(&root, &evidence)?;
+            println!("API/SemVer surface: ok ({})", evidence.display());
+        }
         _ => {
             return Err(
-                "usage: ci-matrix audit | run PROFILE --evidence FILE | dependency-audit --evidence FILE | documentation-report | documentation-audit --evidence FILE"
+                "usage: ci-matrix audit | run PROFILE --evidence FILE | dependency-audit --evidence FILE | documentation-report | documentation-audit --evidence FILE | api-baseline-write | api-audit --evidence FILE"
                     .into(),
             );
         }