itsdangerous

Crates.ioitsdangerous
lib.rsitsdangerous
version0.4.1
sourcesrc
created_at2019-06-12 05:13:51.040672
updated_at2022-03-11 23:25:17.791712
descriptionRust port of the popular itsdangerous python library for signing strings and sending them over untrusted channels.
homepagehttps://github.com/discordapp/itsdangerous-rs
repositoryhttps://github.com/discordapp/itsdangerous-rs
max_upload_size
id140535
size78,396
Jake (jhgg)

documentation

https://docs.rs/itsdangerous

README

itsdangerous-rs

Build Status License Documentation Cargo

A rust re-implementation of the Python library itsdangerous.

Essentially, this crate provides various helpers to pass data to untrusted environments and get it back safe and sound. Data is cryptographically signed to ensure that it has not been tampered with.

Basic Usage

Add this to your Cargo.toml:

[dependencies]
itsdangerous = "0.3"

Next, get to signing some dangerous strings:

use itsdangerous::{default_builder, Signer};

fn main() {
    // Create a signer using the default builder, and an arbitrary secret key.
    let signer = default_builder("secret key").build();

    // Sign an arbitrary string, and send it somewhere dangerous.
    let signed = signer.sign("hello world!");

    // Unsign the string and validate that it hasn't been tampered with.
    let unsigned = signer.unsign(&signed).expect("Signature was not valid");
    assert_eq!(unsigned, "hello world!");
}

For more in-depth examples, check out the documentation!

License

Licensed under the MIT license.

Commit count: 32

cargo fmt