Initial commit

2020-05-21 21:05:12 +07:00 · 2020-05-21 21:05:12 +07:00 · 21ccf06033
commit 21ccf06033
7 changed files with 282 additions and 0 deletions
--- a/README.md
+++ b/README.md
@ -0,0 +1,72 @@
+Quanttp
+=======
+
+An HTTP API that wraps [ComScire quantum random number generator API](https://comscire.com/downloads/qwqngdoc/).
+
+Running
+-------
+
+1. Install ComScire driver from https://comscire.com/downloads/
+2. Run the following commands
+   ```
+   pip install -r requirements.txt
+   python -m quanttp
+   ```
+
+Usage Example
+-------------
+
+### REST API
+
+	http://localhost:62456/api/randint32
+	< -1741405968
+
+	http://localhost:62456/api/randuniform
+	< 0.20340009994
+
+	http://localhost:62456/api/randnormal
+	< 1.02206840644
+
+	http://localhost:62456/api/randbytes?length=8
+	< <20><><EFBFBD>E<EFBFBD><45>s_<73>b<EFBFBD><62><EFBFBD><EFBFBD>G<EFBFBD>
+
+	http://localhost:62456/api/reset
+	< OK
+
+
+### WebSocket API
+	
+	ws://localhost:62456/ws
+	> RANDINT32
+	< 585865374
+	> RANDUNIFORM
+	< 0.70137183786
+	> RANDNORMAL
+	< -1.6120135370
+	> RANDBYTES 16
+	< <20><><EFBFBD><EFBFBD><EFBFBD>9L).<2E>!:<3A><><EFBFBD>@Nh<EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>d<EFBFBD><EFBFBD><EFBFBD><EFBFBD>_q<EFBFBD>
+	> RESET
+	< OK
+
+License
+-------
+
+    Copyright (c) 2020 Andika Wasisto
+
+    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.