armnod

Crates.ioarmnod
lib.rsarmnod
version0.9.0
sourcesrc
created_at2023-04-04 23:45:46.371
updated_at2024-12-04 14:18:50.161004
descriptionArmnod provides a random string generator.
homepage
repositoryhttps://github.com/rescrv/blue
max_upload_size
id830556
size27,749
Robert Escriva (rescrv)

documentation

README

armnod

Armnod is an anagram for "random"; Armnod is a library for working with random strings.

Each [Armnod] consists of a [SeedChooser], [LengthChooser], and [CharacterChooser] which compose a set of random strings. The SeedChooser picks the element of the set. It may say to stop iterating (enough items have been chosen), it may say to seek to a particular offset in another guacamole generator (there's a finite number of seeds), or it may say to not seek at all (an "infinite" number of strings are possible).

The [SeedChooser] and [LengthChooser] both pull from a [guacamole::Guacamole] stream to generate the seed and a u32 for the string's length. It's easy to see that when the guac is positioned at the same point in the stream, the seed and length will be the same.

[CharacterChooser] pulls bytes from the string and maps them to characters to create a string. Essentially mapping the binary data to ASCII data. UTF-8 marginally supported.

Status

Passive development. The warts pulled it from being maintenance track on 2023-09-19

Scope

This library provides the armnod type and an embeddable command-line interface.

Warts

  • The [ArmnodOptions] does not create the Armnod instance; it should.

Documentation

The latest documentation is always available at docs.rs.

Commit count: 1605

cargo fmt