SUC offers one thing: A quick way to save and hash user credentials.

If your project..

• Has few users
• Can afford loss of data (file corruption)
• Is a hobby project

..then SUC is the right thing for you!

• Easily open/create a new SucFile
• Save and hash a username and password with one method
• Automatically generate salt
• Check if user exists and check if password is correct with one method

• Simple
• Quick to implement
• No database etc. needed
• Comparatively small file size
• No need to think about hashing and salting

• Developer is a hobbyist
• No guarantee on actual security
• One wrong bit in the file has the potential to destroy all of the data and probably panics your program
• File gets loaded into memory completely, therefore no large amounts of users recommended

Hashing is done using the argon2 Rust crate with the default options. The hash is saved to the file in the PHC format. Salt is generated using OsRng.

use suc::sucfile::SucFile;

fn main() {
    let mut sf = SucFile::open("test.suc").unwrap();
    sf.add("Alexander", "4312541").unwrap();
    println!("{}", sf.check("Alexander", "4312541").unwrap());
    sf.remove("Alexander").unwrap();
}