Fugu
Fugu::Random(3p) Perl Library Manual Fugu::Random(3p)

Fugu::Random - random bytes and random passwords

    use Fugu::Random;
    my $nonce = Fugu::Random->random_bytes(12);
    my $password = Fugu::Random->random_password(32);

Fugu::Random gives random bytes from /dev/urandom and random passwords built from them.

Every method is a class method. The module keeps no state, never logs, and uses core Perl only. A programming error dies. There is no partial result and no quiet fallback, because a caller cannot recover from a secret with a known prefix.

random_bytes($length) returns $length bytes from /dev/urandom.

The method dies when the device does not open, and dies on a short read. Neither one has a recovery: a caller that continues with fewer bytes than it asked for builds a secret with a known prefix.

random_password($length) returns a random password of exactly $length characters. The default length is 32.

The alphabet is URL-safe base64, so the password survives a shell, a URL and a configuration file with no quoting.

random_bytes() and random_password() return a string of the asked-for length.

random_bytes() dies when /dev/urandom does not open, on a short read, and on a length that is not positive. random_password() dies on a length that is not positive.

arc4random(3), random(4)

Dick Olsson <hi@senzilla.io>

random_password() trims a base64 string to the asked-for length. A password of "n" characters therefore carries about six bits of entropy for each character, and not eight.

The HAP protocol library has its own randomness in "Protocol::HAP::Crypto". The duplication is deliberate: the protocol library stays self-contained across a distribution boundary.

2026-10-16 OpenBSD