# Simple AES256-GCM

[![Build Status](https://travis-ci.com/prospect-guru/simple-aes256-gcm.svg?branch=master)](https://travis-ci.com/prospect-guru/simple-aes256-gcm)
[![codecov](https://codecov.io/gh/prospect-guru/simple-aes256-gcm/branch/master/graph/badge.svg)](https://codecov.io/gh/prospect-guru/simple-aes256-gcm)

**Warning!** This is a v0.* version! Expect bugs and issues all around. Submitting pull requests and issues is highly encouraged!

This library is built on top of `aes-gcm` crate exposing a easy-to-use aes256-gcm encryption API, (handling base64 encoding / decoding, iv generation...).

## Examples
Please find examples in the /examples folder.

```rust
use simple_aes256_gcm;
use std::convert::TryFrom;

fn main() {
    let lorem_ipsum = simple_aes256_gcm::Decrypted::from(
        "Lorem ipsum dolor sit amet, consectetur adipiscing elit. Curabitur sodales diam sagittis, dignissim est at, vehicula mi. Sed placerat sollicitudin sollicitudin. Donec et cursus sapien. Morbi bibendum, dui non fringilla mattis, nisi libero iaculis lectus, eget tincidunt est dui eu lorem. Praesent vitae enim nec sapien maximus porttitor non in risus. Maecenas nec accumsan sapien. Quisque placerat tempus mauris, nec vulputate mauris porttitor sed. Vivamus eu finibus elit. Suspendisse potenti. Quisque sagittis nibh non eros facilisis semper. Sed sit amet dictum orci. Vestibulum eget mi quis magna euismod dignissim. Aliquam erat volutpat. Quisque id magna non neque mattis mattis sit amet in arcu. Duis sagittis, tortor non imperdiet interdum, arcu tellus imperdiet elit, ac porttitor libero ipsum ac arcu. Sed convallis massa vel hendrerit vulputate."
    );
    let key = simple_aes256_gcm::Key::try_from(
        "MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDE="
    ).unwrap();

    let encrypted_value_and_iv = simple_aes256_gcm::encrypt(&key, &lorem_ipsum).unwrap();

    println!("PLAIN TEXT: {}\n", lorem_ipsum);
    println!("IV: {}\n", encrypted_value_and_iv.iv);
    println!("ENCRYPTED: {}\n", encrypted_value_and_iv.encrypted);
    let plaintext = simple_aes256_gcm::decrypt(&key, encrypted_value_and_iv).unwrap();
    println!("DECRYPTED: {}\n", plaintext);
}
```

## License

This crate is under the MIT license.