Merge pull request #96 from Smoren/dev

Ready for release v2.4.0

Author: Smoren

.github/workflows/test_master.yml .github/workflows/test.yml.github/workflows/test_master.yml renamed to .github/workflows/test.yml

@@ -1,5 +1,23 @@
 # IterTools Typescript Change Log
 
+## v2.4.0 - 2025-12-29
+
+### New features
+* random
+  * `percentage()`
+  * `percentageAsync()`
+  * `booleans()`
+  * `booleansAsync()`
+* Stream
+  * `ofPercentage()`
+* AsyncStream
+  * `ofPercentage()`
+
+### Deprecations
+* infinite
+  * `booleans()` (use `random.booleans()` instead).
+  * `booleansAsync()` (use `random.booleansAsync()` instead).
+
 ## v2.3.1 - 2025-09-06
 
 ### Improvements

CHANGELOG.md

@@ -175,11 +175,16 @@ Quick Reference
 #### Infinite Iteration
 | Iterator                | Description                | Code Snippet                       |
 |-------------------------|----------------------------|------------------------------------|
-| [`booleans`](#Booleans) | Generate random booleans   | `infinite.booleans([repetitions])` |
 | [`count`](#Count)       | Count sequentially forever | `infinite.count([start], [step])`  |
 | [`cycle`](#Cycle)       | Cycle through a collection | `infinite.cycle(iterable)`         |
 | [`repeat`](#Repeat-1)   | Repeat an item forever     | `infinite.repeat(item)`            |
 
+#### Random Iteration
+| Iterator                    | Description                | Code Snippet                       |
+|-----------------------------|----------------------------|------------------------------------|
+| [`booleans`](#Booleans)     | Generate random booleans   | `random.booleans([repetitions])`   |
+| [`percentage`](#Percentage) | Generate random percentage | `random.percentage([repetitions])` |
+
 #### Math Iteration
 | Iterator                                   | Description                     | Sync Code Snippet                                 | Async Code Snippet                                     |
 |--------------------------------------------|---------------------------------|---------------------------------------------------|--------------------------------------------------------|
@@ -253,14 +258,15 @@ Quick Reference
 
 ### Stream and AsyncStream Iteration Tools
 #### Stream Sources
-| Source                       | Description                         | Sync Code Snippet                  | Async Code Snippet                      |
-|------------------------------|-------------------------------------|------------------------------------|-----------------------------------------|
-| [`of`](#of)                  | Create a stream from an iterable    | `Stream.of(iterable)`              | `AsyncStream.of(iterable)`              |
-| [`ofCount`](#of-count)       | Create an infinite count stream     | `Stream.ofCount([start], [step])`  | `AsyncStream.ofCount([start], [step])`  |
-| [`ofBooleans`](#of-booleans) | Create an infinite booleans stream  | `Stream.ofBooleans([repetitions])` | `AsyncStream.ofBooleans([repetitions])` |
-| [`ofCycle`](#of-cycle)       | Create an infinite cycle stream     | `Stream.ofCycle(iterable)`         | `AsyncStream.ofCycle(iterable)`         |
-| [`ofEmpty`](#of-empty)       | Create an empty stream              | `Stream.ofEmpty()`                 | `AsyncStream.ofEmpty()`                 |
-| [`ofRepeat`](#of-repeat)     | Create an infinite repeating stream | `Stream.ofRepeat(item)`            | `AsyncStream.ofRepeat(item)`            |
+| Source                           | Description                         | Sync Code Snippet                  | Async Code Snippet                      |
+|----------------------------------|-------------------------------------|------------------------------------|-----------------------------------------|
+| [`of`](#of)                      | Create a stream from an iterable    | `Stream.of(iterable)`              | `AsyncStream.of(iterable)`              |
+| [`ofCount`](#of-count)           | Create an infinite count stream     | `Stream.ofCount([start], [step])`  | `AsyncStream.ofCount([start], [step])`  |
+| [`ofBooleans`](#of-booleans)     | Create booleans stream              | `Stream.ofBooleans([repetitions])` | `AsyncStream.ofBooleans([repetitions])` |
+| [`ofCycle`](#of-cycle)           | Create an infinite cycle stream     | `Stream.ofCycle(iterable)`         | `AsyncStream.ofCycle(iterable)`         |
+| [`ofEmpty`](#of-empty)           | Create an empty stream              | `Stream.ofEmpty()`                 | `AsyncStream.ofEmpty()`                 |
+| [`ofPercentage`](#of-percentage) | Create percentage stream            | `Stream.ofPercentage(item)`        | `AsyncStream.ofPercentage(item)`        |
+| [`ofRepeat`](#of-repeat)         | Create an infinite repeating stream | `Stream.ofRepeat(item)`            | `AsyncStream.ofRepeat(item)`            |
 
 #### Stream Operations
 | Operation                                               | Description                                                                               | Code Snippet                                                         |
@@ -1030,6 +1036,37 @@ for (const item of infinite.repeat('bla')) {
 // bla, bla, bla, bla, bla, ...
 ```
 
+## Random Iteration
+
+### Percentage
+Generate random percentage values.
+
+```
+function* percentage(repetitions?: number): Iterable<number>
+```
+
+If `repetitions` is provided, generates exactly that many numbers. If not provided, generates numbers infinitely.
+
+```typescript
+import { random } from 'itertools-ts';
+
+for (const num of infinite.percentage(5)) {
+  console.log(num);
+}
+// 0.7745835631877125, 0.6368758907434469, 0.6465445462428422, 0.49809604559145615, 0.7009703411939564 (random values)
+
+for (const num of infinite.percentage()) {
+  console.log(num);
+}
+// 0.7745835631877125, 0.6368758907434469, 0.6465445462428422... (random values)
+
+// Async version
+for await (const num of infinite.percentageAsync(5)) {
+  console.log(num);
+}
+// 0.7745835631877125, 0.6368758907434469, 0.6465445462428422... (random values)
+```
+
 ## Math Iteration
 
 ### Running Average

README.md

@@ -1,6 +1,6 @@
 {
   "name": "itertools-ts",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "Extended itertools port for TypeScript and JavaScript. Provides a huge set of functions for working with iterable collections (including async ones)",
   "license": "MIT",
   "repository": {