Randomness testing for humans
coinflip aims to implement the tests recommended by NIST SP800-22 to check random number generators for randomness. A user-friendly command-line interface provided allows you to run the tests on your data, and subsequently report on the results by generating informational HTML documents.
coinflip.randtests acts as the public API for notebook users and developers to use the randomness tests directly. The tests are implemented as general solutions, meaning they accept basically any sequence with two distinct elements!
Setup
You can get the latest release of coinflip from PyPI.
$ pip install coinflipAlternatively you can get the (unstable) development version straight from GitHub.
$ pip install git+https://github.com/Honno/coinflipIf that means nothing to you, no fret! Please continue reading the instructions below.
Install Python 3.7+
Cross-platform installation instructions for Python are available at realpython.com/installing-python/.
Note coinflip only works on Python 3.7 or above. Make sure you have Python 3.7 (or higher) by checking the version of your installation:
$ python --version
Python 3.7.XClone repository
You can clone the source code via Git:
$ git clone https://github.com/Honno/coinflipInstall coinflip
Enter the directory coinflip is downloaded to:
$ cd coinflipYou can install coinflip via the pip module:
$ pip install -e .pip is the standard package manager for Python, which should of installed automatically when installing Python 3.7+.
Trial run
Try running the randomness tests on an automatically generated binary sequence:
$ coinflip example-runIf the command coinflip is “not found”, you may need to add your local binaries folder to your shell’s path. For example, in bash you would do the following:
$ echo "export PATH=~/.local/bin:$PATH" >> ~/.bash_profile
$ source ~/.bash_profileIn the worst case, you can execute commands via python -m:
$ python -m coinflip example-runQuick start
Randomness tests can be ran over your RNG output via the run command.
$ coinflip run DATA OUT
...DATA is the path to newline-delimited text file that contains a binary sequence. An example file to use is available on my gist. Alternatively, raw binary files can be read as bitstreams via the --binary flag
OUT is the path where you want the results to be saved. The results will be saved as a pickle-serialised file, which can be viewed again via the read command. Additionally you can generate informational HTML reports from the results via the report command, but note that the reports are currently very lacking.
Output should comprise of the sequence parsed from DATA, test-specific result summaries, and a final overall summary table.
1 maintainer
Metadata
1 maintainer
Release files for coinflip 0.1.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| coinflip-0.1.5.tar.gz | 243.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| coinflip-0.1.5-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 298.9 kB
Release files / coinflip-0.1.5.tar.gz
| Download URL | coinflip-0.1.5.tar.gz |
|---|---|
| Size | 243.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5dc37859e4f11fdfbbd67767565db05ff813063b03dbd8105c64737b16816482
|
|
BLAKE2b-256 checksum How to use checksums |
4f07c92e7eaff6587c6d8f90e881cfd23a878fb9574e16f0066d93750485c617
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.1.4 CPython/3.8.5 Linux/5.4.0-56-generic
|
Release files / coinflip-0.1.5-py3-none-any.whl
| Download URL | coinflip-0.1.5-py3-none-any.whl |
|---|---|
| Size | 55.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c7f50e2944c8137d24723b5092f07ed65042b639178d0d30e0f84c5e4f62a795
|
|
BLAKE2b-256 checksum How to use checksums |
ab5cb06ed6ab43e15d986d15f902a29e77af6f0b95ec0ab6aa2849dba4e85975
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
poetry/1.1.4 CPython/3.8.5 Linux/5.4.0-56-generic
|
