merged temporal functionality
This commit is contained in:
parent
e7265937e3
commit
f846c0e8ae
7 changed files with 84 additions and 99 deletions
6
.vscode/settings.json
vendored
Normal file
6
.vscode/settings.json
vendored
Normal file
|
|
@ -0,0 +1,6 @@
|
||||||
|
{
|
||||||
|
"files.associations": {
|
||||||
|
"entropy.h": "c",
|
||||||
|
"err.h": "c"
|
||||||
|
}
|
||||||
|
}
|
||||||
36
README.md
36
README.md
|
|
@ -2,7 +2,7 @@
|
||||||
|
|
||||||
[](https://pypi.org/project/randonautentropy/) [](https://pypi.org/project/randonautentropy/)
|
[](https://pypi.org/project/randonautentropy/) [](https://pypi.org/project/randonautentropy/)
|
||||||
|
|
||||||
This project provides tools for interacting with The Randonautica Quantum Random Number Generator. It communicates with the JSON API and provides a Python API, and a `rndo` command-line tool.
|
This project provides tools for interacting with the Randonautica Quantum and Temporal entropy generators. It provides a Python API, and a `rndo` command-line tool.
|
||||||
|
|
||||||
## Installation
|
## Installation
|
||||||
|
|
||||||
|
|
@ -11,14 +11,15 @@ $ pip install randonautentropy
|
||||||
```
|
```
|
||||||
## Python API
|
## Python API
|
||||||
|
|
||||||
The randonautentropy Python module contains a low-level `get` function.
|
The randonautentropy Python module contains low-level `get` functions.
|
||||||
|
|
||||||
```Python
|
```Python
|
||||||
>>> import randonautentropy as rndo
|
>>> from randonautentropy import rndo
|
||||||
|
>>> from randonautentropy import temporal
|
||||||
|
|
||||||
>>> rndo.get(type='hex16', length=10)
|
>>> rndo.get(length=10, type='hex16')
|
||||||
|
|
||||||
5b779d67eda68636cb90
|
e5b779d67eda68636cb9
|
||||||
|
|
||||||
>>> rndo.get(type='int32')
|
>>> rndo.get(type='int32')
|
||||||
|
|
||||||
|
|
@ -35,6 +36,15 @@ The randonautentropy Python module contains a low-level `get` function.
|
||||||
>>> rndo.get(type='base64')
|
>>> rndo.get(type='base64')
|
||||||
|
|
||||||
JA==
|
JA==
|
||||||
|
|
||||||
|
>>> temporal.get(length=10, channel=0)
|
||||||
|
|
||||||
|
d0c7ca53cb57ede1be14
|
||||||
|
|
||||||
|
>>> temporal.get(channel=1)
|
||||||
|
|
||||||
|
b83a7fd79bee5b3b1ad7
|
||||||
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Command Line Interface
|
## Command Line Interface
|
||||||
|
|
@ -42,7 +52,7 @@ JA==
|
||||||
The package also comes with a `rndo` CLI:
|
The package also comes with a `rndo` CLI:
|
||||||
|
|
||||||
```
|
```
|
||||||
usage: rndo [-h] [--hex] [--int] [--uniform] [--gauss] [--base64] [bytes]
|
usage: rndo [-h] [--rndo] [--temporal] [bytes]
|
||||||
|
|
||||||
A tool for printing random data from the Randonautica Quantum Random Number Generators
|
A tool for printing random data from the Randonautica Quantum Random Number Generators
|
||||||
|
|
||||||
|
|
@ -51,20 +61,16 @@ positional arguments:
|
||||||
|
|
||||||
options:
|
options:
|
||||||
-h, --help show this help message and exit
|
-h, --help show this help message and exit
|
||||||
--hex Hexadecimal entropy
|
--rndo, -r Hexadecimal QRNG entropy
|
||||||
--int, -i Random 32 bit integer
|
--temporal, -t Hexadecimal Temporal entropy
|
||||||
--uniform, -u Random uniform float
|
|
||||||
--gauss, --normal, -g, -n
|
|
||||||
Random normal distributed float
|
|
||||||
--base64, -b64, -b Random uniform float
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Example:
|
### Example:
|
||||||
|
|
||||||
```
|
```
|
||||||
$ rndo 100
|
$ rndo -r 100
|
||||||
d204ab96505929325292d84a1217ded8de5781a449be0371cdcc97e6f6b1fe69a6b530cdf7112250172e573fe7b42b9e89fe42eef198cce0ec7a427b74f59b7b7a3d8ecabfc0f0051fe06104b1dd7f2a7d1626d7f66aac5afe002bdb255ec136d52405c2
|
d204ab96505929325292d84a1217ded8de5781a449be0371cdcc97e6f6b1fe69a6b530cdf7112250172e573fe7b42b9e89fe42eef198cce0ec7a427b74f59b7b7a3d8ecabfc0f0051fe06104b1dd7f2a7d1626d7f66aac5afe002bdb255ec136d52405c2
|
||||||
|
|
||||||
$ rndo -u
|
$ rndo -t 100
|
||||||
0.12742354174572768
|
93378573b635dc2b01ffd426068e6ccecbc2046fbc9598c1c41a4cbe0dcc8f62071202ea72d05b83581e8cd968cbd099ee0ccf37e9fbcd7d476bd4da6b1965434fc1a65302c732a06b6e5cebff37101a21926a34f1b236a4660a599c6ec93ae7296176fc
|
||||||
```
|
```
|
||||||
|
|
@ -1,8 +1,3 @@
|
||||||
import os
|
from .rndo import get
|
||||||
import glob
|
from .cmd import main
|
||||||
|
from .temporal import get
|
||||||
from .rndo import *
|
|
||||||
from .cmd import *
|
|
||||||
|
|
||||||
modules = glob.glob(os.path.dirname(__file__)+"/*.py")
|
|
||||||
__all__ = [ os.path.basename(f)[:-3] for f in modules if not f.endswith('__init__.py')]
|
|
||||||
|
|
@ -1,67 +1,31 @@
|
||||||
# Copyright 2023 randogoth <tobias@randonauts.com>
|
|
||||||
#
|
|
||||||
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
||||||
# of this software and associated documentation files (the "Software"), to deal
|
|
||||||
# in the Software without restriction, including without limitation the rights
|
|
||||||
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
||||||
# copies of the Software, and to permit persons to whom the Software is
|
|
||||||
# furnished to do so, subject to the following conditions:
|
|
||||||
#
|
|
||||||
# The above copyright notice and this permission notice shall be included in
|
|
||||||
# all copies or substantial portions of the Software.
|
|
||||||
#
|
|
||||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
# SOFTWARE.
|
|
||||||
"""
|
|
||||||
A tool for printing random data from the Randonautica Quantum Random Number Generators
|
|
||||||
"""
|
|
||||||
from __future__ import print_function
|
|
||||||
|
|
||||||
import sys
|
import sys
|
||||||
from . import rndo
|
|
||||||
import argparse
|
import argparse
|
||||||
|
from . import rndo
|
||||||
|
from . import temporal
|
||||||
|
|
||||||
def main():
|
def main():
|
||||||
|
|
||||||
parser = argparse.ArgumentParser(description="A tool for printing random data from the Randonautica Quantum Random Number Generators")
|
parser = argparse.ArgumentParser(description="A tool for printing random data from the Randonautica Quantum Random Number Generators")
|
||||||
parser.add_argument("--hex", action="store_false", help="Hexadecimal entropy")
|
parser.add_argument("--rndo", "-r", action="store_false", help="Hexadecimal QRNG entropy")
|
||||||
parser.add_argument("--int", "-i", action="store_true", help="Random 32 bit integer")
|
parser.add_argument("--temporal", "-t", action="store_true", help="Hexadecimal Temporal entropy")
|
||||||
parser.add_argument("--uniform", "-u", action="store_true", help="Random uniform float")
|
|
||||||
parser.add_argument("--gauss", "--normal", "-g", "-n", action="store_true", help="Random normal distributed float")
|
|
||||||
parser.add_argument("--base64", "-b64", "-b", action="store_true", help="Random uniform float")
|
|
||||||
parser.add_argument("bytes", nargs="?", type=int, default=10, help="amount of hexadecimal bytes")
|
parser.add_argument("bytes", nargs="?", type=int, default=10, help="amount of hexadecimal bytes")
|
||||||
parser.print_usage = parser.print_help
|
parser.print_usage = parser.print_help
|
||||||
args = parser.parse_args()
|
args = parser.parse_args()
|
||||||
|
|
||||||
generator = None
|
generator = None
|
||||||
|
|
||||||
if args.hex:
|
if args.temporal:
|
||||||
try:
|
try:
|
||||||
bytes = int(args.bytes)
|
bytes = int(args.bytes)
|
||||||
except ValueError:
|
except ValueError:
|
||||||
sys.exit(1)
|
sys.exit(1)
|
||||||
generator = rndo.get('hex16', bytes)
|
generator = temporal.get(bytes)
|
||||||
|
elif args.rndo:
|
||||||
if args.int:
|
try:
|
||||||
print(rndo.get('int32'))
|
bytes = int(args.bytes)
|
||||||
sys.exit(0)
|
except ValueError:
|
||||||
|
sys.exit(1)
|
||||||
if args.uniform:
|
generator = rndo.get(bytes)
|
||||||
print(rndo.get('uniform'))
|
|
||||||
sys.exit(0)
|
|
||||||
|
|
||||||
if args.gauss:
|
|
||||||
print(rndo.get('normal'))
|
|
||||||
sys.exit(0)
|
|
||||||
|
|
||||||
if args.base64:
|
|
||||||
print(rndo.get('base64'))
|
|
||||||
sys.exit(0)
|
|
||||||
|
|
||||||
if not generator:
|
if not generator:
|
||||||
sys.exit(1)
|
sys.exit(1)
|
||||||
|
|
|
||||||
24
randonautentropy/install.py
Normal file
24
randonautentropy/install.py
Normal file
|
|
@ -0,0 +1,24 @@
|
||||||
|
import os
|
||||||
|
import shutil
|
||||||
|
|
||||||
|
def install():
|
||||||
|
print("TemporalLib not found. Attempting to install it...")
|
||||||
|
print("==================================================")
|
||||||
|
module_path = os.path.abspath(os.path.dirname(__file__))
|
||||||
|
temporal_path = os.path.abspath(f"{module_path}/temporal")
|
||||||
|
os.chdir(module_path)
|
||||||
|
try:
|
||||||
|
os.system('git clone --depth 1 git@github.com:TheRandonauts/temporal.git')
|
||||||
|
except:
|
||||||
|
print("Cloning Temporal from GitHub failed. Please install it manually:")
|
||||||
|
return
|
||||||
|
try:
|
||||||
|
os.chdir(temporal_path)
|
||||||
|
os.system('./make.sh')
|
||||||
|
print("Installed. Deleting build directory.")
|
||||||
|
shutil.rmtree(temporal_path, ignore_errors=True)
|
||||||
|
except:
|
||||||
|
print("Compiling Temporal failed. Please install it manually:")
|
||||||
|
return
|
||||||
|
print("==================================================")
|
||||||
|
print("TemporalLib successfully installed")
|
||||||
|
|
@ -1,27 +1,3 @@
|
||||||
# Copyright 2023 randogoth <tobias@randonauts.com>
|
|
||||||
#
|
|
||||||
# Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
||||||
# of this software and associated documentation files (the "Software"), to deal
|
|
||||||
# in the Software without restriction, including without limitation the rights
|
|
||||||
# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
||||||
# copies of the Software, and to permit persons to whom the Software is
|
|
||||||
# furnished to do so, subject to the following conditions:
|
|
||||||
#
|
|
||||||
# The above copyright notice and this permission notice shall be included in
|
|
||||||
# all copies or substantial portions of the Software.
|
|
||||||
#
|
|
||||||
# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
||||||
# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
||||||
# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
||||||
# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
||||||
# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
||||||
# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
||||||
# SOFTWARE.
|
|
||||||
"""
|
|
||||||
A Python interface to the Randonautica Quantum Random Numbers Server.
|
|
||||||
|
|
||||||
"""
|
|
||||||
|
|
||||||
import requests
|
import requests
|
||||||
|
|
||||||
try:
|
try:
|
||||||
|
|
@ -34,7 +10,7 @@ from urllib3.exceptions import InsecureRequestWarning
|
||||||
requests.packages.urllib3.disable_warnings(InsecureRequestWarning)
|
requests.packages.urllib3.disable_warnings(InsecureRequestWarning)
|
||||||
|
|
||||||
VERSION = '1.0.0'
|
VERSION = '1.0.0'
|
||||||
URL = 'https://api.qrng.rndo.it/api/json/'
|
URL = 'https://qrng.randonautica.com/api/json/'
|
||||||
typeS = {
|
typeS = {
|
||||||
'int32' : 'randint32',
|
'int32' : 'randint32',
|
||||||
'hex16' : 'randhex',
|
'hex16' : 'randhex',
|
||||||
|
|
@ -45,7 +21,7 @@ typeS = {
|
||||||
|
|
||||||
DEVICE_ID = 'QWR70154'
|
DEVICE_ID = 'QWR70154'
|
||||||
|
|
||||||
def get(type='hex', length=1):
|
def get(length=10, type='hex16'):
|
||||||
"""Fetch data from the Randonautica Quantum Random Numbers JSON API"""
|
"""Fetch data from the Randonautica Quantum Random Numbers JSON API"""
|
||||||
if type not in typeS.keys():
|
if type not in typeS.keys():
|
||||||
raise Exception("type must be one of %s" % typeS.keys())
|
raise Exception("type must be one of %s" % typeS.keys())
|
||||||
|
|
|
||||||
14
randonautentropy/temporal.py
Normal file
14
randonautentropy/temporal.py
Normal file
|
|
@ -0,0 +1,14 @@
|
||||||
|
import os
|
||||||
|
import shutil
|
||||||
|
from subprocess import check_output as exec
|
||||||
|
from .install import install
|
||||||
|
|
||||||
|
def get(length=10, channel=0):
|
||||||
|
length *= 2
|
||||||
|
module_path = os.path.abspath(os.path.dirname(__file__))
|
||||||
|
temporal_path = os.path.abspath(f"{module_path}/temporal")
|
||||||
|
exe_path = f'{temporal_path}/result/{os.uname().sysname}/temporal'
|
||||||
|
if shutil.which('temporal') is None:
|
||||||
|
install()
|
||||||
|
temporal = exec(f'temporal hexdump {channel} {length}', shell=True)
|
||||||
|
return temporal[:-1].decode('UTF-8')
|
||||||
Loading…
Add table
Add a link
Reference in a new issue