multirandom 0.0.1__tar.gz → 0.0.2__tar.gz

multirandom-0.0.2/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: multirandom
+Version: 0.0.2
+Summary: 🎲 The truth external PyPI random package, have true_rand, virt_rand, hash_rand, ...
+Author-email: BlackCatOfficialytb <quanvm0501@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/BlackCatOfficialytb/multirandom
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: pyautogui
+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/
+└── src/
+    └── multirandom/
+        ├── true_rand/          # Physical & Hardware Entropy
+        │   ├── rand_via_clicks.py       # Human-in-the-loop entropy
+        │   ├── rand_using_online_api.py # Quantum & Hardware APIs (ANU QRNG, Roll-API)
+        │   └── weather_rand.py          # [Coming Soon] Weather-based entropy
+        ├── virt_rand/          # Mathematical Randomness (PRNGs)
+        │   ├── xor_shift.py             # XorShift & Xoshiro Family
+        │   ├── rand_using_virt_lcg.py   # Linear Congruential Generators (LCGs)
+        │   └── flash_rand_and_reverse.py # [Coming Soon] Specialized PRNGs
+        └── hash_rand/          # Hash-based Generators
+            ├── sha_rand.py              # SHA-1, SHA-256, SHA-512 based PRNGs
+            └── original_random.py       # Wrapper for Python's built-in random
+```
+
+---
+
+## 🛠 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 multirandom.true_rand.rand_via_clicks import RealRandomUsingBetweenMixedClicks
+
+# Requires a sequence of Left -> Right -> Middle clicks to seed
+gen = RealRandomUsingBetweenMixedClicks()
+print(gen.random())
+```
+
+### 2. Physical & Hardware APIs (`true_rand`)
+Fetch "True" randomness from remote physical processes.
+
+- **Australian National University (ANU)**: Quantum vacuum noise via QRNG.
+- **Random.org**: Atmospheric noise.
+- **Roll-API**: Physical dice rolling hardware.
+- **Weather Entropy**: (In development) Fetching randomness from real-time weather stations.
+
+### 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. Includes `reverse_roll()` methods to demonstrate the insecurity of simple modular arithmetic.
+
+---
+
+## 🚀 Installation & Setup
+
+### Requirements
+- Python 3.9+
+- Dependencies listed in `requirements.txt` (e.g., `pyautogui`, `aiohttp`)
+
+### Installation
+```bash
+pip install -r requirements.txt
+```
+
+### Usage
+```python
+from multirandom.virt_rand.xor_shift import Xorshift32
+
+# Create a 32-bit XorShift generator
+gen = Xorshift32(seed=12345)
+print(gen.roll())
+```
+
+---
+
+## 📺 Educational Resources
+This project focuses on 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 under the GNU General Public License v3 (G GPLv3).

multirandom-0.0.2/README.md

@@ -0,0 +1,97 @@
+# 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/
+└── src/
+    └── multirandom/
+        ├── true_rand/          # Physical & Hardware Entropy
+        │   ├── rand_via_clicks.py       # Human-in-the-loop entropy
+        │   ├── rand_using_online_api.py # Quantum & Hardware APIs (ANU QRNG, Roll-API)
+        │   └── weather_rand.py          # [Coming Soon] Weather-based entropy
+        ├── virt_rand/          # Mathematical Randomness (PRNGs)
+        │   ├── xor_shift.py             # XorShift & Xoshiro Family
+        │   ├── rand_using_virt_lcg.py   # Linear Congruential Generators (LCGs)
+        │   └── flash_rand_and_reverse.py # [Coming Soon] Specialized PRNGs
+        └── hash_rand/          # Hash-based Generators
+            ├── sha_rand.py              # SHA-1, SHA-256, SHA-512 based PRNGs
+            └── original_random.py       # Wrapper for Python's built-in random
+```
+
+---
+
+## 🛠 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 multirandom.true_rand.rand_via_clicks import RealRandomUsingBetweenMixedClicks
+
+# Requires a sequence of Left -> Right -> Middle clicks to seed
+gen = RealRandomUsingBetweenMixedClicks()
+print(gen.random())
+```
+
+### 2. Physical & Hardware APIs (`true_rand`)
+Fetch "True" randomness from remote physical processes.
+
+- **Australian National University (ANU)**: Quantum vacuum noise via QRNG.
+- **Random.org**: Atmospheric noise.
+- **Roll-API**: Physical dice rolling hardware.
+- **Weather Entropy**: (In development) Fetching randomness from real-time weather stations.
+
+### 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. Includes `reverse_roll()` methods to demonstrate the insecurity of simple modular arithmetic.
+
+---
+
+## 🚀 Installation & Setup
+
+### Requirements
+- Python 3.9+
+- Dependencies listed in `requirements.txt` (e.g., `pyautogui`, `aiohttp`)
+
+### Installation
+```bash
+pip install -r requirements.txt
+```
+
+### Usage
+```python
+from multirandom.virt_rand.xor_shift import Xorshift32
+
+# Create a 32-bit XorShift generator
+gen = Xorshift32(seed=12345)
+print(gen.roll())
+```
+
+---
+
+## 📺 Educational Resources
+This project focuses on 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 under the GNU General Public License v3 (G GPLv3).

{multirandom-0.0.1 → multirandom-0.0.2}/pyproject.toml

@@ -4,18 +4,22 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "multirandom"
-version = "0.0.1"
+version = "0.0.2"
 authors = [
   { name="BlackCatOfficialytb", email="quanvm0501@gmail.com" },
 ]
 description = "🎲 The truth external PyPI random package, have true_rand, virt_rand, hash_rand, ..."
 readme = "README.md"
 requires-python = ">=3.9"
+license = "GPL-3.0-or-later"
 classifiers = [
     "Programming Language :: Python :: 3.9",
-    "License :: OSI Approved :: GNU General Public License v3 (GPLv3)",
     "Operating System :: OS Independent",
 ]
+dependencies = [
+    "aiohttp",
+	"pyautogui"
+]
 
 [project.urls]
 "Homepage" = "https://github.com/BlackCatOfficialytb/multirandom"

multirandom-0.0.2/src/multirandom/__init__.py

@@ -0,0 +1,3 @@
+from . import true_rand
+from . import virt_rand
+from . import hash_rand

multirandom-0.0.2/src/multirandom/hash_rand/__init__.py

@@ -0,0 +1,2 @@
+from . import original_random
+from . sha_rand as sha_random

multirandom-0.0.2/src/multirandom/true_rand/__init__.py

@@ -0,0 +1,3 @@
+from . import rand_via_clicks
+from . import rand_using_online_api
+# from . import weather_rand

multirandom-0.0.2/src/multirandom/virt_rand/__init__.py

@@ -0,0 +1,2 @@
+from . import rand_using_virt_lcg as LCG
+from . import xor_shift

multirandom-0.0.2/src/multirandom.egg-info/PKG-INFO

@@ -0,0 +1,113 @@
+Metadata-Version: 2.4
+Name: multirandom
+Version: 0.0.2
+Summary: 🎲 The truth external PyPI random package, have true_rand, virt_rand, hash_rand, ...
+Author-email: BlackCatOfficialytb <quanvm0501@gmail.com>
+License-Expression: GPL-3.0-or-later
+Project-URL: Homepage, https://github.com/BlackCatOfficialytb/multirandom
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp
+Requires-Dist: pyautogui
+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/
+└── src/
+    └── multirandom/
+        ├── true_rand/          # Physical & Hardware Entropy
+        │   ├── rand_via_clicks.py       # Human-in-the-loop entropy
+        │   ├── rand_using_online_api.py # Quantum & Hardware APIs (ANU QRNG, Roll-API)
+        │   └── weather_rand.py          # [Coming Soon] Weather-based entropy
+        ├── virt_rand/          # Mathematical Randomness (PRNGs)
+        │   ├── xor_shift.py             # XorShift & Xoshiro Family
+        │   ├── rand_using_virt_lcg.py   # Linear Congruential Generators (LCGs)
+        │   └── flash_rand_and_reverse.py # [Coming Soon] Specialized PRNGs
+        └── hash_rand/          # Hash-based Generators
+            ├── sha_rand.py              # SHA-1, SHA-256, SHA-512 based PRNGs
+            └── original_random.py       # Wrapper for Python's built-in random
+```
+
+---
+
+## 🛠 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 multirandom.true_rand.rand_via_clicks import RealRandomUsingBetweenMixedClicks
+
+# Requires a sequence of Left -> Right -> Middle clicks to seed
+gen = RealRandomUsingBetweenMixedClicks()
+print(gen.random())
+```
+
+### 2. Physical & Hardware APIs (`true_rand`)
+Fetch "True" randomness from remote physical processes.
+
+- **Australian National University (ANU)**: Quantum vacuum noise via QRNG.
+- **Random.org**: Atmospheric noise.
+- **Roll-API**: Physical dice rolling hardware.
+- **Weather Entropy**: (In development) Fetching randomness from real-time weather stations.
+
+### 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. Includes `reverse_roll()` methods to demonstrate the insecurity of simple modular arithmetic.
+
+---
+
+## 🚀 Installation & Setup
+
+### Requirements
+- Python 3.9+
+- Dependencies listed in `requirements.txt` (e.g., `pyautogui`, `aiohttp`)
+
+### Installation
+```bash
+pip install -r requirements.txt
+```
+
+### Usage
+```python
+from multirandom.virt_rand.xor_shift import Xorshift32
+
+# Create a 32-bit XorShift generator
+gen = Xorshift32(seed=12345)
+print(gen.roll())
+```
+
+---
+
+## 📺 Educational Resources
+This project focuses on 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 under the GNU General Public License v3 (G GPLv3).

multirandom-0.0.2/src/multirandom.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+src/multirandom/__init__.py
+src/multirandom.egg-info/PKG-INFO
+src/multirandom.egg-info/SOURCES.txt
+src/multirandom.egg-info/dependency_links.txt
+src/multirandom.egg-info/requires.txt
+src/multirandom.egg-info/top_level.txt
+src/multirandom/hash_rand/__init__.py
+src/multirandom/hash_rand/original_random.py
+src/multirandom/hash_rand/sha_rand.py
+src/multirandom/true_rand/__init__.py
+src/multirandom/true_rand/rand_using_online_api.py
+src/multirandom/true_rand/rand_via_clicks.py
+src/multirandom/true_rand/weather_rand.py
+src/multirandom/virt_rand/__init__.py
+src/multirandom/virt_rand/flash_rand_and_reverse.py
+src/multirandom/virt_rand/rand_using_virt_lcg.py
+src/multirandom/virt_rand/xor_shift.py

multirandom-0.0.2/src/multirandom.egg-info/requires.txt

@@ -0,0 +1,2 @@
+aiohttp
+pyautogui

multirandom-0.0.2/src/multirandom.egg-info/top_level.txt

@@ -0,0 +1 @@
+multirandom

multirandom-0.0.1/PKG-INFO

@@ -1,101 +0,0 @@
-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/README.md

@@ -1,87 +0,0 @@
-# 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/src/multirandom.egg-info/PKG-INFO

@@ -1,101 +0,0 @@
-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/src/multirandom.egg-info/SOURCES.txt

@@ -1,19 +0,0 @@
-LICENSE
-README.md
-pyproject.toml
-src/multirandom.egg-info/PKG-INFO
-src/multirandom.egg-info/SOURCES.txt
-src/multirandom.egg-info/dependency_links.txt
-src/multirandom.egg-info/top_level.txt
-src/realrandom/__init__.py
-src/realrandom/hash_rand/__init__.py
-src/realrandom/hash_rand/original_random.py
-src/realrandom/hash_rand/sha_rand.py
-src/realrandom/true_rand/__init__.py
-src/realrandom/true_rand/rand_using_online_api.py
-src/realrandom/true_rand/rand_via_clicks.py
-src/realrandom/true_rand/weather_rand.py
-src/realrandom/virt_rand/__init__.py
-src/realrandom/virt_rand/flash_rand_and_reverse.py
-src/realrandom/virt_rand/rand_using_virt_lcg.py
-src/realrandom/virt_rand/xor_shift.py

multirandom-0.0.1/src/multirandom.egg-info/top_level.txt

@@ -1 +0,0 @@
-realrandom

multirandom-0.0.1/src/realrandom/__init__.py

@@ -1,3 +0,0 @@
-import true_rand
-import virt_rand
-import hash_rand

multirandom-0.0.1/src/realrandom/hash_rand/__init__.py

@@ -1,2 +0,0 @@
-import original_random
-import sha_rand as sha_random

multirandom-0.0.1/src/realrandom/true_rand/__init__.py

@@ -1,3 +0,0 @@
-import rand_via_clicks
-import rand_using_online_api
-# import weather_rand

multirandom-0.0.1/src/realrandom/virt_rand/__init__.py

@@ -1,2 +0,0 @@
-import rand_using_virt_lcg as LCG
-import xor_shift