filesize

Cross-platform physical disk space use retrieval for Rust.

Synopsis

```rust pub trait PathExt { fn sizeondisk(&self) -> std::io::Result; fn sizeondisk_fast(&self, metadata: &Metadata) -> std::io::Result; } impl PathExt for std::path::Path;

pub fn filerealsize>(path: P) -> std::io::Result; pub fn filerealsize_fast>( path: P, metadata: &Metadata ) -> std::io::Result; ```

Description

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

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

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

let realsize = path.sizeondisk()?; let realsize = path.sizeondisk_fast(&metadata)?;

// Older interface use filesize::{filerealsize, filerealsize_fast};

let realsize = filerealsize(path)?; let realsize = filerealsize_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.