Skip to content

Commit 793e472

Browse files
committed
docs: add CHANGELOG.md for version tracking
1 parent 7c0bdb2 commit 793e472

1 file changed

Lines changed: 63 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 63 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,63 @@
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

Comments
 (0)