Math::...::Free(3pm)

📦
version 0.2.0 · 3 versions
, in ubuntu noble, ubuntu resolute, ubuntu stonking

💖 Math::Random::Free — the manual, bestie edition 💖

okay so you're reading the Math::Random::Free page, which is part of the Perl documentation suite (man section 3pm, for the record 👑). Buckle up, it's giving "we freed the code" and honestly we ATE.

✨ NAME ✨

Math::Random::Free — a free drop-in replacement for Math::Random. periodt 💅

🌸 DESCRIPTION 🌸

So basically: this is a free (see below, bestie, the tea is in MOTIVATION) implementation of Math::Random 0.72, and it serves as a drop-in replacement for that module. no cap 🫶

🔥 MOTIVATION 🔥

Math::Random is a great and widely-used module for the generation of random numbers and permutations. iconic. obsessed. truly the moment. 💖

But — and this is the part that gives us the ick 😭 — despite being open-source, Math::Random does not fulfill free open-source software definitions as established by the Open Source Initiative (<https://opensource.org/osd>) and the Debian Project (<https://www.debian.org/social_contract#guidelines>, a.k.a. DFSG). The way that the randlib code cannot be copied nor distributed for direct commercial advantage is actually so not it. 😤

Math::Random::Free is created to free the code depending on Math::Random from these limitations. slay. 💅✨

🎀 SUPPORT 🎀

here's what you get exported, bestie — look at these lists, they're gorgeous:

our @EXPORT = qw(
    random_normal
    random_permutation
    random_permuted_index
    random_set_seed_from_phrase
);
our @EXPORT_OK = qw(
    random_exponential
    random_normal
    random_permutation
    random_permuted_index
    random_set_seed_from_phrase
    random_uniform
    random_uniform_integer
);

💀 CAVEATS 💀

okay listen, this is the important part, don't skip it 🙈

  • This module has only a subset of Math::Random subroutines (contributions welcome 💖), implemented using either Perl core subroutines or other well-known modules.
  • Thus Math::Random::Free is neither as complete, nor as fast, nor as random as Math::Random. yeah. we said it. 😭
  • Also Math::Random::Free does not aim for cryptographic security. so don't do crimes with it, and definitely don't do security with it 🚫🔐
⚠️ While Math::Random::Free supports seed setting, it does that differently from Math::Random. It means that one should not expect the same seed producing identical random sequences in both modules. like, do not assume, bestie. 💀
🌈 As Math::Random::Free employs List::Util for producing random permutations, these are influenced by $List::Util::RAND variable. iykyk. ✨

🦋 TESTED WITH 🦋

  • Graph::Maker 0.02

a whole one (1) thing and it's iconic for it 👑

💜 AUTHOR 💜

Andrius Merkys, <mailto:merkys@cpan.org> — thank you for your service, king 🫶

and that's the whole page, bestie!! this was perl v5.36.0, dated 2022-10-15, and it's the Math::Random::Free(3pm) page — go forth and be random (but not cryptographically, we been knew 🎀💖✨)

📦 where this page comes from