multirandom 0.0.1__py3-none-any.whl

multirandom-0.0.1.dist-info/METADATA

@@ -0,0 +1,101 @@
+Metadata-Version: 2.4
+Name: multirandom
+Version: 0.0.1
+Summary: 🎲 The truth external PyPI random package, have true_rand, virt_rand, hash_rand, ...
+Author-email: BlackCatOfficialytb <quanvm0501@gmail.com>
+Project-URL: Homepage, https://github.com/BlackCatOfficialytb/multirandom
+Classifier: Programming Language :: Python :: 3.9
+Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Dynamic: license-file
+
+# MultiRandom 🎲
+
+A comprehensive library for exploring and generating randomness across the spectrum—from true physical entropy to mathematical pseudo-randomness and everything in between.
+
+## 🌟 Overview
+
+MultiRandom is designed for developers, researchers, and hobbyists who want to understand high-quality randomness. It provides tools to fetch random data from quantum sources, physical human interaction, and modern mathematical algorithms.
+
+> [!WARNING]
+> **Security Note**: This library contains both "True" and "Pseudo" random sources. While some sources (like QRNG) are highly secure, others (like LCGs) are provided for educational purposes and include **reverse logic** to demonstrate their insecurity. Always use the appropriate generator for your use case.
+
+---
+
+## 🏗 Project Structure
+
+```text
+MultiRandom/
+├── true_rand/          # Physical & Hardware Entropy
+│   ├── rand_via_clicks.py       # Human-in-the-loop entropy (Left/Right/Middle/Mixed)
+│   └── rand_using_online_api.py # Quantum & Hardware APIs (random.org, ANU QRNG, Roll-API)
+├── virt_rand/          # Mathematical Randomness (PRNGs)
+│   ├── xor_shift.py             # XorShift & Xoshiro Family (Original, Scrambled, modern)
+│   └── rand_using_virt_lng.py   # Linear Congruential Generators (LCGs)
+├── hash_rand/          # Hash-based Generators
+│   └── sha_rand.py              # SHA-1, SHA-256, SHA-512 based PRNGs
+└── requirements.txt    # Project dependencies
+```
+
+---
+
+## 🛠 Features & Usage
+
+### 1. Human-in-the-loop Entropy (`true_rand`)
+Uses `pyautogui` and Windows API to capture sub-microsecond timing jitter and spatial coordinates from physical mouse clicks.
+
+```python
+from true_rand.rand_via_clicks import MultiRandomUsingBetweenMixedClicks
+
+# Requires a sequence of Left -> Right -> Middle clicks to seed
+gen = MultiRandomUsingBetweenMixedClicks()
+print(gen.random())
+```
+
+### 2. Quantum & Hardware APIs (`true_rand`)
+Fetch "True" randomness from remote physical processes.
+
+- **Australian National University (ANU)**: Quantum vacuum noise.
+- **Random.org**: Atmospheric noise.
+- **Roll-API**: Physical dice rolling hardware.
+
+### 3. Bit-Shift Generators (`virt_rand`)
+Implementations of the most popular mathematical generators used in modern systems.
+
+- **Original XorShift**: Includes `reverse_roll()` to demonstrate mathematical reversibility.
+- **Scrambled Variants**: Xorwow (CUDA), Xorshift+ (V8/Webkit).
+- **Modern Xoshiro**: Xoshiro256**, Xoroshiro128++ (Minecraft Java 1.18+).
+
+### 4. Mathematical LCGs (`virt_rand`)
+Classic Linear Congruential Generators with customizable shift parameters. Ideal for understanding how modular arithmetic creates pseudo-random patterns.
+
+---
+
+## 🚀 Getting Started
+
+### Installation
+1. Clone the repository.
+2. Install dependencies:
+   ```bash
+   pip install -r requirements.txt
+   ```
+
+### Running Tests
+Most modules include a built-in test suite in their `if __name__ == "__main__":` block.
+```bash
+python virt_rand/xor_shift.py
+```
+
+---
+
+## 📺 Educational Resources
+This project was built with a focus on understanding the limits of computer-generated randomness. For more context, check out:
+- [Why computers can't generate truly random numbers](https://youtu.be/XDsYPXRCXAs?si=oDaFsqZyNJWVXwEi)
+
+---
+
+## 📜 License
+Provided for educational and research purposes.

multirandom-0.0.1.dist-info/RECORD

@@ -0,0 +1,17 @@
+multirandom-0.0.1.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+realrandom/__init__.py,sha256=zMRlt7i2jWU3ZY_oMFEpFmSq2LiOPdydr8mvqA0pMWs,52
+realrandom/hash_rand/__init__.py,sha256=ftZbK_IB6wZZXgCPsDb3a3L1mwTdD9_Q9KeKPn7rpho,53
+realrandom/hash_rand/original_random.py,sha256=oEL4XGFi-885pEIfizV5WNjzvJ0MHBVB5K7-d4y2sMU,20
+realrandom/hash_rand/sha_rand.py,sha256=iWa-qZ5LT7BApEwqbHqCe3jIEB8nKh8GJjTesAheFVE,2205
+realrandom/true_rand/__init__.py,sha256=ba-MzzR-ENU0ALWFcqXOLO80Wal7md_E-u5BmIhgYjs,75
+realrandom/true_rand/rand_using_online_api.py,sha256=WQxD8SpW0ziHPdRgaNa-pLIO8k96ccCLNkSXEkkVh6M,2479
+realrandom/true_rand/rand_via_clicks.py,sha256=UUn2jYo9PtSvIQ84NlzVqmG33xj0i1pyX8TUVsRfwrg,3290
+realrandom/true_rand/weather_rand.py,sha256=0CwajSD7UmkcB0yrHy4WZyqlzorTn5gHcGcg6KifDbY,66
+realrandom/virt_rand/__init__.py,sha256=QlscRaTvEXTB3UqBDuZwU6MsdYRTZbh_Iw8ltECgJek,51
+realrandom/virt_rand/flash_rand_and_reverse.py,sha256=QPUTFJKUsQscE-4Rm_BIMCGrbp2-L0C1blaJzPLocEE,23
+realrandom/virt_rand/rand_using_virt_lcg.py,sha256=oV_AgJaaBRTsDkHHvNdpBRhvkC9t9cIJhWHQOw9hjd4,2864
+realrandom/virt_rand/xor_shift.py,sha256=meKm3N8PlfNneTCSV99OUve4WmGJZZHo-yALsi3cTy8,7875
+multirandom-0.0.1.dist-info/METADATA,sha256=OjsYOCO2ZcZhvJ6yOfd1myUSm894knpJIxWG9d-i7Vc,4052
+multirandom-0.0.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+multirandom-0.0.1.dist-info/top_level.txt,sha256=M9zA-Ippn5IyegDPK58v4bXlmZt82K96DsvCL-qX7eE,11
+multirandom-0.0.1.dist-info/RECORD,,

multirandom-0.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+