randomizer

Crates.iorandomizer
lib.rsrandomizer
version0.1.2
sourcesrc
created_at2022-08-18 15:45:50.85565
updated_at2022-08-19 00:09:05.134791
descriptionA random string/byte generator
homepage
repositoryhttps://github.com/nebula-technologies/randomizer
max_upload_size
id648199
size113,375
Anders Blenstrup-Pedersen (KatsuoRyuu)

documentation

README

Randomizer

pipeline status coverage report Latest Release

Randomizer provides a simple implementation of creating random information, eg random string, and bytes. Thre are many randomization libraries for rust. They are often either complex to use and safe or they are easy to use, but have some significant descrpincies with the code, like using unsafe functions or unwrapping potential Error data. Due to this, i created this library to eliviate those problems.

Generation.

There are 2 (actually 3) types of byte generation. The underneath concept is to generate random bytes for both UTF8 strings and bytes or byte sequences. This generator breaks up the sequence of characters or bytes and from the sequence of combinations it will generate a series of random bytes. if the sequence of bytes are generated from a valid UTF8 string, then each letter can be seperated and used for generating a random sequence of the valid sequences of bytes. This allows for the byte -> UTF8 convertion to be almost infallible.

This also means that if the system is supplied with a set of words the generator can randomly put those words together into a sequence.

Usage

Generate a string

use randomizer::Randomizer;

let string = Randomizer::ALPHANUMERIC(6).string().unwrap();
assert_eq!(string.chars().count(), 6);
let string = Randomizer::new(6, Some("u")).string().unwrap();

assert_eq!(string, "uuuuuu");

Generate a byte value

use randomizer::{Charset, Randomizer};

let bytes = Randomizer::new(6, Some(Charset::AnyByte)).bytes().unwrap();

assert_eq!(bytes.len(), 6);

Generate custom word string

use randomizer::{Charset, Randomizer};

let string = Randomizer::new(6, Some(vec!["foo","bar"])).string().unwrap();

assert_eq!(string.chars().count(), 18);

Simple String generation with constants

its possible to generate a string using the simplification functions for different types

use randomizer::{Randomizer};

let string = Randomizer::ALPHABETICAL(6).string().unwrap();

assert_eq!(string.chars().count(), 6);
Commit count: 5

cargo fmt