Crate filesize

filesize abstracts platform-specific methods of determining the real space used by files, taking into account filesystem compression and sparse files.

It provides two standalone functions, file_real_size, and file_real_size_fast, and as of version 0.2, a std::path::Path extension trait offering identical functions named size_on_disk and size_on_disk_fast.

The _fast variants accept a std::fs::Metadata reference which will be used to cheaply calculate the size on disk if the platform supports that. This is intended for cases such as directory traversal, where metadata is available anyway, and where metadata is needed for other purposes.

Example

use std::path::Path;
use filesize::PathExt;

let path = Path::new("Cargo.toml");
let metadata = path.symlink_metadata()?;

let realsize = path.size_on_disk()?;
let realsize = path.size_on_disk_fast(&metadata)?;

// Older interface
use filesize::{file_real_size, file_real_size_fast};

let realsize = file_real_size(path)?;
let realsize = file_real_size_fast(path, &metadata)?;

Platform-specific Behaviour

On Unix platforms this is a thin wrapper around std::fs::symlink_metadata() and std::os::unix::fs::MetadataExt, simply returning blocks() * 512. The _fast functions disregard the file path entirely and use the passed metadata directly.

On Windows, it wraps GetCompressedFileSizeW(), and the _fast functions disregard the passed metadata entirely.

On any other platforms, it wraps std::fs::symlink_metadata() and only returns len(), while the _fast variants also disregard the path and use the passed metadata directly.

Traits

PathExt

An extension trait for std::path::Path to retrieve the on-disk size of a given file.

Functions

file_real_size	Get the on-disk size of the file at the given path.
file_real_size_fast	Get the on-disk size of the file at the given path, using the provided std::fs::Metadata instance if possible.