#random #gamedev

no-std perchance

Very simple random number generation optimized for ease of use

12 releases

0.5.3 Feb 22, 2024
0.5.1 Aug 18, 2023
0.5.0 Dec 16, 2022
0.4.0 Nov 23, 2022
0.2.2 Mar 18, 2022

#503 in Algorithms

Download history 906/week @ 2023-12-03 371/week @ 2023-12-10 612/week @ 2023-12-17 82/week @ 2023-12-24 321/week @ 2023-12-31 579/week @ 2024-01-07 778/week @ 2024-01-14 718/week @ 2024-01-21 539/week @ 2024-01-28 451/week @ 2024-02-04 687/week @ 2024-02-11 622/week @ 2024-02-18 292/week @ 2024-02-25 164/week @ 2024-03-03 168/week @ 2024-03-10 77/week @ 2024-03-17

719 downloads per month
Used in 7 crates (via cervo-core)

MIT/Apache

28KB
331 lines

🎲 perchance

A lightweight, quick, and easy-to-use library for generating and using randomness, designed for the most common use cases you find in games and geometry.

Note that perchance is not cryptographically secure and should not be used in contexts where security is a concern.

Usage

perchance is a simple random number generation library, tuned for ease of use: create an instance of PerchanceContext and go.

let mut rng = perchance::PerchanceContext::new(seed);

let between_0_and_1 = rng.uniform_f32();
let dice_roll = rng.uniform_range_i32(1..=6);
let random_direction = rng.uniform_sphere_surface_vec3();
let thing_should_happen = rng.get_bool();

enum Event {
    Thing1,
    Thing2,
    Thing3,
}
let which_should_happen = rng.choose(&[Event::Thing1, Event::Thing2, Event::Thing3]);

You can also use the global perchance::global() if you have the std feature enabled:

// Seed the global context first. You may do so manually, or, on platforms that support it,
// obtain a seed to pass into it by calling `perchance::gen_time_seed()`.
perchance::seed_global(0x5F3759DF); // ;)

let mut rng = perchance::global();
let between_0_and_1 = rng.uniform_f32();

Contributing

We welcome community contributions to this project.

Please read our Contributor Guide for more information on how to get started.

License

Licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~3MB
~94K SLoC