Lust

A Rust library designed to provide simple data for a given file path!

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Usage

1. get_file_name(file_path: &str) - returns the file name (as an OsString), given an absolute or relative path

let file_name = get_file_name("C:/Users/JohnDoe/Desktop/repos/Lust/README.md");
println!("{:?}", file_name);  //prints "README.md"

2. get_file_size(file_path: &str) - returns the file size (as a u64), given an absolute or relative path

let file_size = get_file_size("C:/Users/JohnDoe/Desktop/repos/Lust/README.md");
println!("{:?}", file_size);  //prints "82"

3. generate_sha1(file_path: &str) - returns the sha1 hash (as a String), given an absolute or relative path

let sha1_hash = generate_sha1("C:/Users/JohnDoe/Desktop/repos/Lust/README.md");
println!("{:?}", sha1_hash);  //prints "e2ae20d9ae7fcacb605c03c198e0a1c51d446f50"

4. generate_md5(file_path: &str) - returns the md5 hash (as a String), given an absolute or relative path

let md5_hash = generate_md5("C:/Users/JohnDoe/Desktop/repos/Lust/README.md");
println!("{:?}", md5_hash);  //prints "b958ee170050ed7a2f93509f13bf16c3"

Installing Prerequisites

Below you'll find what's required to build and compile Lust:

Rust and Cargo

OSX/Unix installation (via Terminal):

curl -sSf https://static.rust-lang.org/rustup.sh | sh

Instructions for Microsoft Windows may be found here.

Further installation instructions can be found here.

Building Lust

After installing the prerequisites listed above, you're ready to build!

1. First, clone the repository to your local machine via git:

git clone https://github.com/SeanPrashad/Lust.git

Or by downloading the .zip equivalent, found here.

Note: Remember to extract the .zip file to a location where you conduct your work!

2. Next, cd into the downloaded repository using your Terminal (or Git Bash if on Windows):

cd whereMyReposAreStored/Lust/

3. To build the source code, use:

cargo build

Note: Supply the --verbose argument to get a more detailed output (ie. cargo build --verbose)

Running the Test Suite

The test suite can be found within src/lib.rs in the module tests. To build and run all test suites, simply use:

cargo test

Note: Supply the --verbose argument to get a more detailed output (ie. cargo test --verbose)

Linting

Rust comes with a built-in linter, Clippy, that's automatically configured to run when you build Lust.

To invoke Clippy on-demand, simply run:

cargo clippy

Note: Supply the --verbose argument to get a more detailed output (ie. cargo clippy --verbose). More information can be found here.

Technologies & Tools

• Rust - A systems programming language
• Crates.io - Rust's Package Manager
• Clippy - Linting for Rust
• Rust-Crypto - A library of common cryptographic algorithms

Contributing

Any and all contributions are welcome, regardless of your programming expertise. Please refer to CONTRIBUTING.md for details on how to get started.

Authors

• Sean Prashad - Initial and on-going maintenance - @SeanPrashad
• David Humphrey - Documentation improvements/development suggestions - @humphd
• Marco Beltempo - Source code refinement - @marcobeltempo

See also the list of contributors who participated in this project.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments

• #rust-beginners on Mozilla's IRC server for all of the help
• Professor David Humphrey for guiding, challenging and rewarding us with the world of Open Source