refactor(materialized_artifact): rename ensure_in -> materialize_in

The verb mirrors the crate name and makes the value-add over
`include_bytes!` obvious at the call site.

Author: claude

crates/fspy/src/unix/macos_artifacts.rs

@@ -14,7 +14,7 @@ mod tests {
     #[test]
     fn coreutils_functions() {
         let tmpdir = tempfile::tempdir().unwrap();
-        let coreutils_path = COREUTILS_BINARY.ensure_in(&tmpdir, "", true).unwrap();
+        let coreutils_path = COREUTILS_BINARY.materialize_in(&tmpdir, "", true).unwrap();
         let output = Command::new(coreutils_path).arg("--list").output().unwrap();
         let mut expected_functions: Vec<&str> = output
             .stdout

crates/fspy/src/unix/mod.rs

@@ -49,7 +49,7 @@ impl SpyImpl {
 
             const PRELOAD_CDYLIB: Artifact = artifact!("fspy_preload");
 
-            let preload_cdylib_path = PRELOAD_CDYLIB.ensure_in(dir, ".dylib", false)?;
+            let preload_cdylib_path = PRELOAD_CDYLIB.materialize_in(dir, ".dylib", false)?;
             preload_cdylib_path.as_path().into()
         };
 
@@ -58,8 +58,8 @@ impl SpyImpl {
             preload_path,
             #[cfg(target_os = "macos")]
             artifacts: {
-                let coreutils_path = macos_artifacts::COREUTILS_BINARY.ensure_in(dir, "", true)?;
-                let bash_path = macos_artifacts::OILS_BINARY.ensure_in(dir, "", true)?;
+                let coreutils_path = macos_artifacts::COREUTILS_BINARY.materialize_in(dir, "", true)?;
+                let bash_path = macos_artifacts::OILS_BINARY.materialize_in(dir, "", true)?;
                 Artifacts {
                     bash_path: bash_path.as_path().into(),
                     coreutils_path: coreutils_path.as_path().into(),

crates/fspy/src/windows/mod.rs

@@ -51,7 +51,7 @@ pub struct SpyImpl {
 
 impl SpyImpl {
     pub fn init_in(path: &Path) -> io::Result<Self> {
-        let dll_path = INTERPOSE_CDYLIB.ensure_in(path, ".dll", false)?;
+        let dll_path = INTERPOSE_CDYLIB.materialize_in(path, ".dll", false)?;
 
         let wide_dll_path = dll_path.as_os_str().encode_wide().collect::<Vec<u16>>();
         let mut ansi_dll_path =

crates/materialized_artifact/src/lib.rs

@@ -5,15 +5,15 @@
 //! but we want to ship a single executable. `materialized_artifact` embeds
 //! the file content as a `&'static [u8]` at compile time via the
 //! [`artifact!`] macro (same as `include_bytes!`), and
-//! [`Artifact::ensure_in`] writes it out to disk when first needed — that
+//! [`Artifact::materialize_in`] writes it out to disk when first needed — that
 //! materialization step is the value-add over a bare `include_bytes!`.
 //!
 //! Materialized files are named `{name}_{hash}{suffix}` in the caller-chosen
 //! directory. The hash (computed at build time by
 //! `materialized_artifact_build::register`) gives three properties without
 //! any coordination between processes:
 //!
-//! - **No repeated writes.** [`Artifact::ensure_in`] returns the existing
+//! - **No repeated writes.** [`Artifact::materialize_in`] returns the existing
 //!   path if the file is already there; repeated calls and re-runs skip I/O.
 //! - **Correctness.** Two binaries with different embedded content produce
 //!   different filenames, so a stale file from an older build is never
@@ -29,7 +29,7 @@ use std::{
 };
 
 /// A file embedded into the executable at compile time. Construct with
-/// [`artifact!`]; materialize to disk with [`Artifact::ensure_in`]. See the
+/// [`artifact!`]; materialize to disk with [`Artifact::materialize_in`]. See the
 /// [crate docs] for the design rationale.
 ///
 /// [crate docs]: crate
@@ -82,7 +82,7 @@ impl Artifact {
     /// Returns an error if the directory can't be read/written, the stat
     /// fails for any reason other than not-found, or the temp-file rename
     /// fails and the destination still doesn't exist.
-    pub fn ensure_in(
+    pub fn materialize_in(
         &self,
         dir: impl AsRef<Path>,
         suffix: &str,

crates/materialized_artifact_build/src/lib.rs

@@ -15,7 +15,7 @@ pub const ENV_PREFIX: &str = "MATERIALIZED_ARTIFACT_";
 /// these at compile time via `include_bytes!(env!(…))` and `env!(…)`.
 ///
 /// `name` is used both as the env-var key and as the on-disk filename prefix
-/// (in `Artifact::ensure_in`), so it must be a valid identifier-like string
+/// (in `Artifact::materialize_in`), so it must be a valid identifier-like string
 /// that matches the one passed to `artifact!`.
 ///
 /// # Panics