Image output path '{:?}' should contain a parent directory,

Error message

Image output path '{:?}' should contain a parent directory, but doesn't

What it means

`ImageProcessor::perform` writes the processed image to a NamedTempFile created in the output path's parent directory before moving it into place. If `output_path` has no parent (e.g. a bare filename like "out.png" resolved to an empty parent), the atomic temp-file strategy cannot work and this error is returned.

Source

Thrown at components/imageproc/src/processor.rs:94

            log::debug!(
                "No exif orientation data for {}, using default orientation",
                self.input_path.display(),
            );
            img
        };

        let img = match self.instr.crop_instruction {
            Some((x, y, w, h)) => img.crop(x, y, w, h),
            None => img,
        };
        let img = match self.instr.resize_instruction {
            Some((w, h)) => img.resize_exact(w, h, self.filter),
            None => img,
        };

        let tmp_output_file = match self.output_path.parent() {
            Some(parent) => Ok(NamedTempFile::new_in(parent)?),
            None => Err(anyhow!(
                "Image output path '{:?}' should contain a parent directory, but doesn't",
                self.output_path
            )),
        }?;
        let mut tmp_output_writer = BufWriter::new(&tmp_output_file);

        let has_color_profile = color_profile.is_some();
        let add_color_profile = |encoder: &mut dyn ImageEncoder| {
            if let Some(color_profile) = color_profile {
                let _ = encoder.set_icc_profile(color_profile).inspect_err(|_| log::warn!("processing {}: Image encoder for {} does not support color profiles, colors may be incorrect.", self.input_path.display(), self.format.extension()));
            }
        };

        match self.format {
            Format::Png => {
                let mut encoder = PngEncoder::new(&mut tmp_output_writer);
                add_color_profile(&mut encoder);
                img.write_with_encoder(encoder)?;

View on GitHub (pinned to 61d3082821)

Solutions

Provide a full path including a parent directory for the output file
Ensure the parent directory exists and is writable
If input is user-controlled, canonicalize/normalize the path and reject bare filenames

Example fix

// before
output_path = "processed.png"
// after
output_path = "static/processed/processed.png"

Defensive patterns

Strategy: validation

Validate before calling

use std::path::{Path, PathBuf};
fn ensure_parent(output: &Path) -> std::io::Result<PathBuf> {
    let parent = output.parent().filter(|p| !p.as_os_str().is_empty())
        .ok_or_else(|| std::io::Error::new(std::io::ErrorKind::InvalidInput, "output path has no parent directory"))?.to_path_buf();
    std::fs::create_dir_all(&parent)?;
    Ok(parent)
}

Type guard

fn has_parent_dir(p: &Path) -> bool {
    p.parent().map_or(false, |p| !p.as_os_str().is_empty())
}

Try / catch

match processor.perform() {
    Ok(_) => {},
    Err(e) if e.to_string().contains("should contain a parent directory") => {
        log::error!("output_path {:?} is a bare filename; add a directory component", output_path);
    }
    Err(e) => return Err(e),
}

Prevention

Always configure output paths with an explicit directory (e.g. static/processed/out.png), never a bare filename
Canonicalize the configured path at startup and assert it has a parent
Create parent directories (create_dir_all) as part of setup before processing

When it happens

Trigger: Calling the image processor with an `output_path` whose `.parent()` is `None` or points to nothing usable — typically a root-relative bare filename without a directory component.

Common situations: Config value like `output = "image.png"` instead of `output = "static/processed/image.png"`; path constructed with Path::new("file.png") lacking a directory; working-directory assumptions differing between dev and prod.

Related errors

AI-assisted analysis of getzola/zola@61d3082821 (2026-09-03). Data as JSON: /api/errors/b3fdb4f66aa0c6ea. Report an issue: GitHub.