Skip to main content

True random numbers (provided by random.org) in Python

Project description

verarandom

Build Status codecov

True random numbers (provided by random.org) in Python

Usage

This module provides a random.Random subclass, so it implements all random functions (excluding Bookkeeping functions) with true randomness. It requires an internet connection to work and will raise a ConnectionError if the server doesn't respond, a requests.HTTPError or a subclass of verarandom.VeraRandomError if there is a problem with the request's parameters.

NOTE: this class assumes it's the only one talking to random.org when calculating its quota.

>>> from verarandom import VeraRandom
>>> r = VeraRandom()

>>> r.remaining_quota
1000000
>>> r.randint(1, 10, n=5)
[3, 4, 10, 3, 7]
>>> r.remaining_quota  # bits were deducted from quota
999986

>>> r.randint(3, 5, n=1)
[5]
>>> r.randint(-10, 3)  # If no n is passed it returns a number, not a list (like the parent method)
-2

>>> r.random()
0.040120765652295
>>> r.choice(['rock', 'paper', 'scissors'])
'scissors'

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for verarandom, version 1.1.0
Filename, size File type Python version Upload date Hashes
Filename, size verarandom-1.1.0-py3-none-any.whl (4.1 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size verarandom-1.1.0.tar.gz (3.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page