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.