FsMeta

This crate adds the ability to recursively walk through a directory in an async fashion. The result is metadata about the directory which currently includes:

• Get the total size of the directory in bytes
• Get the size of files
• Formatting of the file and directory sizes in human readable format (B, KiB, MiB, ...)
• Fetch all the directories
• Fetch all the files
• Fetch the created, assessed and modified timestamps in Tai64N (monotonic, no leap seconds) timestamps
• Fetch the created, assessed and modified timestamps in Local time (24 hour / 12 hour format)
• format timestamps according to duration
• Get the file format eg PDF or plain text
• Returns all the files and directories in current directory with any errors that occur instead of just returning the error when error is encountered (like fs::read_dir())
• Use parallelism where applicable (TODO)

Examples

[dependencies]
dir-meta = {version = "*", default-features = false} #deactivate methods for converting timestamps to human readable formats in local time setting `default-features` to `false`

• Compiling with async feature to enable asynchronously reading a directory

#[cfg(feature="async")]
smol::block_on(async{// Read a directory// With feature `async` enabled using `cargo add dir-meta --features async`let outcome = dir_meta::DirMetadata::new("src").async_dir_metadata().await.unwrap();dbg!(&outcome);// Get size of directory formatted as human readabledbg!(outcome.size_formatted());// Iterate over the filesfor file in outcome.files(){dbg!(&file.name());//Get file namedbg!(&file.accessed_24hr());// Get last accessed time in 24 hour formatdbg!(file.accessed_am_pm());//Get last accessed time in 12 hour formatdbg!(&file.accessed_humatime());//Get last accessed time based on duration since current timedbg!(&file.created_24hr());//Get last created time in 24 hour formatdbg!(&file.created_am_pm());//Get last created time in 24 hour formatdbg!(&file.created_humatime());//Get last created time based on duration since current timedbg!(&file.modified_24hr());//Get last modified time in 24 hour formatdbg!(&file.modified_am_pm());//Get last modified time in 24 hour formatdbg!(&file.modified_humatime());//Get last modified time based on duration since current timedbg!(file.formatted_size());// Get the size of the file in human formatted sizedbg!(file.file_format());// Get the format of the file eg (PDF)}})

• Compiling with sync feature to enable synchronously reading a directory

#[cfg(feature="sync")]{// Read a directory// With feature `sync` enabled using `cargo add dir-meta --features sync`let outcome = dir_meta::DirMetadata::new("src").sync_dir_metadata().unwrap();dbg!(&outcome);// Get size of directory formatted as human readabledbg!(outcome.size_formatted());// Iterate over the filesfor file in outcome.files(){dbg!(&file.name());//Get file namedbg!(&file.accessed_24hr());// Get last accessed time in 24 hour formatdbg!(file.accessed_am_pm());//Get last accessed time in 12 hour formatdbg!(&file.accessed_humatime());//Get last accessed time based on duration since current timedbg!(&file.created_24hr());//Get last created time in 24 hour formatdbg!(&file.created_am_pm());//Get last created time in 24 hour formatdbg!(&file.created_humatime());//Get last created time based on duration since current timedbg!(&file.modified_24hr());//Get last modified time in 24 hour formatdbg!(&file.modified_am_pm());//Get last modified time in 24 hour formatdbg!(&file.modified_humatime());//Get last modified time based on duration since current timedbg!(file.formatted_size());// Get the size of the file in human formatted sizedbg!(file.file_format());// Get the format of the file eg (PDF)}}

LICENSE

The code is licensed under APACHE-2.0

Code of Conduct

All contributions must obey the rules in the Rust Code of Conduct by the Rust Foundation