|
| 1 | +# Changelog |
| 2 | + |
| 3 | +All notable changes to TrueEntropy will be documented in this file. |
| 4 | + |
| 5 | +The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), |
| 6 | +and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). |
| 7 | + |
| 8 | +## [0.1.0] - 2025-12-27 |
| 9 | + |
| 10 | +### Added |
| 11 | + |
| 12 | +#### Core Features |
| 13 | +- `EntropyPool` - Thread-safe entropy accumulator with SHA-256 mixing |
| 14 | +- `EntropyTap` - Extractor for converting entropy to random values |
| 15 | +- `entropy_health()` - Pool health monitoring with score and recommendations |
| 16 | + |
| 17 | +#### Random Generation |
| 18 | +- `random()` - Float in [0.0, 1.0) |
| 19 | +- `randint(a, b)` - Integer in [a, b] with rejection sampling |
| 20 | +- `randbool()` - Random boolean |
| 21 | +- `choice(seq)` - Random element from sequence |
| 22 | +- `randbytes(n)` - Random bytes |
| 23 | +- `shuffle(seq)` - Fisher-Yates shuffle |
| 24 | +- `sample(seq, k)` - Random sampling without replacement |
| 25 | + |
| 26 | +#### Distributions |
| 27 | +- `uniform(a, b)` - Uniform distribution |
| 28 | +- `gauss(mu, sigma)` - Normal distribution (Box-Muller) |
| 29 | +- `triangular(low, high, mode)` - Triangular distribution |
| 30 | +- `exponential(lambd)` - Exponential distribution |
| 31 | +- `weighted_choice(seq, weights)` - Weighted random selection |
| 32 | + |
| 33 | +#### Generators |
| 34 | +- `random_uuid()` - UUID v4 generation |
| 35 | +- `random_token(length, encoding)` - Hex/base64 tokens |
| 36 | +- `random_password(length, ...)` - Secure password generation |
| 37 | + |
| 38 | +#### Entropy Harvesters |
| 39 | +- `TimingHarvester` - CPU timing jitter |
| 40 | +- `NetworkHarvester` - Network latency measurements |
| 41 | +- `SystemHarvester` - System state (RAM, CPU, processes) |
| 42 | +- `ExternalHarvester` - USGS earthquakes, crypto prices |
| 43 | +- `WeatherHarvester` - OpenWeatherMap/wttr.in weather data |
| 44 | +- `RadioactiveHarvester` - random.org and ANU QRNG |
| 45 | + |
| 46 | +#### Advanced Features |
| 47 | +- `trueentropy.aio` - Async/await support |
| 48 | +- `trueentropy.persistence` - Save/load pool state |
| 49 | +- `trueentropy.pools` - Multiple isolated pools |
| 50 | +- `trueentropy.lazy` - Lazy harvester loading |
| 51 | +- `trueentropy.accel` - Optional Cython acceleration |
| 52 | + |
| 53 | +#### Infrastructure |
| 54 | +- GitHub Actions CI (tests on Python 3.9-3.12, Linux/Windows/macOS) |
| 55 | +- Comprehensive test suite (100+ tests) |
| 56 | +- Type hints (PEP 561 compliant) |
| 57 | +- Documentation (README, REFERENCES) |
| 58 | + |
| 59 | +### Dependencies |
| 60 | +- `requests>=2.25.0` |
| 61 | +- `psutil>=5.8.0` |
| 62 | + |
| 63 | +[0.1.0]: https://github.com/medeirosdev/TrueEntropy-PyLib/releases/tag/v0.1.0 |
0 commit comments