#unix #filesystem #encryption #extension

fsextra

fsextra is a collection of extensions to simplify working with Unix-based filesystems. With support for cryptographic operations (encryption, hashing)

5 unstable releases

0.3.0-alpha.1 Sep 27, 2021
0.2.1 Sep 25, 2021
0.1.0 Sep 25, 2021
0.0.1 Sep 25, 2021

#420 in Operating systems

MIT license

20KB
213 lines

fsextra

Note: this library has not been externally tested for security and usage is at your own risk.

Build Status

fsextra is a collection of extensions to simplify working with Unix-based filesystems. This library will also support cryptographic operations on files and directories by enabling the crypto feature (> v0.2.0).

  • Current Version: v0.3.0-alpha.1 (Changelog)

Installation

Install default features by updating your Cargo.toml file to include fsextra = "*".

# your Cargo.toml
[package]
name = "your-package"
version = "0.1.0"
edition = "2018"

# See more keys and their definitions at https://doc.rust-lang.org/cargo/reference/manifest.html

[dependencies]
fsextra = "*"

# optionally enable `crypto` feature
fsextra = { version = "*", features = ["crypto"] }

Known Limitations

  • MetadataExtended and FileExtended (and implementations) are only tested/supported on Unix-based filesystems (although may work).

Dependencies

  • This library requires ring@0.16.20 if crypto feature is enabled.

Compatibility

This library supports Unix-based operating systems and is not tested for other operating systems at this time (v0.3.0). Since v0.3.0, any OS-specific functionality is hidden behind cfg attributes. Since v0.3.0-alpha.1, updates are tested against Unix (linux) and Windows operating systems.

  • v0.3.0-alpha.1 (and later) tests against Windows operating systems.
  • v0.3.0 (and later) introduces a new interface: Digest, requiring DigestExt, Sha2 and Sha5 to be moved to legacy. Code changes may be required when updating to v0.3.0.
  • v0.2.0 (and earlier) may compile for other operating systems, however, this may lead to undefined results and/or failures.

Basic Usage

For complete examples, please see our Documentation.

use fsextra::extensions::{MetadataExtended, FileExtended};
use fsextra::crypto::digest::{Digest, DigestAlgorithm};
use std::fs::File;
use std::io::{Write, Result};

fn main() -> Result<()> {
    let file = File::open("path/to/executable")?;
    let metadata = file.metadata()?;
    
    if !metadata.is_executable() {
        let digest = file.digest(DigestAlgorithm::Sha2);
        assert_eq!(hex::encode(digest), "7509e5bda0c762d2bac7f90d758b5b2263fa01ccbc542ab5e3df163be08e6ca9");
    }

    Ok(())
}

Testing

Cross targets:

  • x86_64-pc-windows-gnu
  • x86_64-unknown-linux-gnu
  • arm-unknown-linux-gnueabi

This library can be tested using Cargo (as usual) with cargo test. It's recommended to test with and without --all-features. When local testing, it's recommended to use Cross to achieve testing for the targets listed above.

To use Cross to test: cross test --target {target} --all-features.

Learn More

Dependencies

~0–3MB
~74K SLoC