nonpseudorandom 0.3.0

A true random number generator using system sensor noise

NonPseudoRandom

NonPseudoRandom is a Python package that generates true random numbers using sensor noise from your local system. It serves as a drop-in replacement for Python's native random module.

Supported Sensors

NonPseudoRandom utilizes various types of system sensors to generate randomness. The supported sensor types are as follows:

Sensor Type	Description
CPU Temperature	Measures the temperature of the CPU using psutil.
Microphone Noise	Captures ambient noise from the microphone using sounddevice.
Webcam Noise	Captures visual noise from the webcam using opencv-python.

Installation

You can install NonPseudoRandom via pip:

pip install nonpseudorandom

Usage

NonPseudoRandom can be used as a drop-in replacement for Python's built-in random module.
It inherites all methods of the native random class and therefore supports all of the expected functionalities.

Examples from native random methods:

import nonpseudorandom as random

print(random.random())  # Generate a random float in [0.0, 1.0)
print(random.randint(1, 10))  # Generate a random integer between 1 and 10
print(random.choice(['a', 'b', 'c']))  # Randomly select an element from a list
print(random.uniform(1.0, 10.0))  # Generate a random float between 1.0 and 10.0

my_list = [1, 2, 3, 4, 5]
random.shuffle(my_list)
print(my_list)  # The list will be shuffled

population = [1, 2, 3, 4, 5]
sample = random.sample(population, 3)
print(sample)  # Randomly sample 3 unique elements from the population

License

This project is licensed under the MIT License.