5 releases

0.2.0 Jan 30, 2019
0.1.3 Jan 18, 2019
0.1.2 Jan 17, 2019
0.1.1 Jan 11, 2019
0.1.0 Jan 10, 2019

#9 in #generates-random

MIT license

18KB
252 lines

rsgen

rsgen is a tiny library and command line tool that generates random characters string(s).

Use as library

documentation in docs.rs LICENSE

Add the following to your Cargo.toml:

[dependencies]
rsgen = "0.2"

Examaple

use rsgen::{gen_random_string, OutputCharsType};

let output_chars_type = OutputCharsType::LatinAlphabetAndNumeric {
    use_upper_case: true,
    use_lower_case: true,
};
let _random_string = gen_random_string(32, output_chars_type);

Install CLI tool

rsgen is written in Rust. Thus you should install the latest Rust ecosystem in advance.
refs. rustup

With cargo install

$ cargo install -f rsgen

Build from source code

$ git clone https://github.com/sadaie/rsgen.git
$ cd rsgen
$ cargo build --release
$ ls target/release/
build       deps        examples    incremental native      rsgen      rsgen.d

Usage

Generating a random characters string.

$ rsgen
V05ZHhKa

Generating a specified-length rondom characters string.

$ rsgen -c 12
TpzjXxem3U5x

Generating a specified-length rondom characters string for ten times.

$ rsgen -c 12 -l 10
2S18UasnECKx
xCLlTp4tZmn3
f9jsbGnSWZtB
jFrPnstxHsr8
K9xZAK0R8KHH
85EXezRgeceo
QOtY5BFwEZBl
HBaFlCFN7t9W
blOM7ZsviUBw
XBDSOETSLzUR

Additional options

  • -f, --fast option sets to use the fast but NOT secure RNG, Xorshift.
  • -n, --numeric option sets to restrict the output to be numeric.
  • -p, --printable-ascii option sets to use the printable ASCII without SPACE.
  • -P, --printable-ascii-with-space option sets to use the printable ASCII with SPACE.
  • --only-upper-case option sets to use upper case letters only.
  • --only-lower-case option sets to use lower case letters only.
  • --only-latin-alphabet option sets to use the Latin alphabet only, not includes numeric characters.

License

MIT lincense.

Dependencies

~1.5MB
~17K SLoC