https://github.com/j50n/deno-asynciter
Map, filter, reduce for AsyncIterables in Deno.
https://github.com/j50n/deno-asynciter
asynciterable asynciterableiterator collect concurrent concurrent-map deno filter fluent foreach map reduce typescript
Last synced: 3 months ago
JSON representation
Map, filter, reduce for AsyncIterables in Deno.
- Host: GitHub
- URL: https://github.com/j50n/deno-asynciter
- Owner: j50n
- License: mit
- Created: 2021-10-23T00:44:46.000Z (about 4 years ago)
- Default Branch: main
- Last Pushed: 2023-06-03T19:37:07.000Z (over 2 years ago)
- Last Synced: 2025-09-30T20:58:01.219Z (3 months ago)
- Topics: asynciterable, asynciterableiterator, collect, concurrent, concurrent-map, deno, filter, fluent, foreach, map, reduce, typescript
- Language: TypeScript
- Homepage:
- Size: 30.3 KB
- Stars: 2
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# AsyncIter: Better AsyncIterables for Deno
I just want to work with `AsyncIterable` collections without using `for` loops.
Is that so wrong?
This little library exposes both functions and a fluent-style wrapper so I can
write my lazy code the way I want to: lazily.
It also supports easy in-order and out-of-order concurrent execution - with
limits.
## Quickstart
Here are some simple examples to get you started.
### Convert an `Array` to `AsyncIterable`
```typescript
const iter = asynciter([1, 2, 3]);
for await (const it of iter) {
console.log(it);
}
```
### map
```typescript
console.dir(await asynciter([1, 2, 3]).map((it) => it * 2).collect());
// [ 2, 4, 6 ]
```
### [concurrent-map.ts](./concurrent-map.ts)
There are four items in the array, but the operation will run in about two
seconds because the operation is concurrent.
```ts
function delayedDouble(delay: number): (n: number) => Promise {
return (n: number) =>
new Promise((resolve, _reject) => {
setTimeout(() => {
resolve(2 * n);
}, delay);
});
}
await asynciter([1, 2, 3, 4]).concurrentMap(
delayedDouble(1000),
2,
).collect();
// [2, 4, 6, 8]
```
### filter
```typescript
console.dir(await asynciter([1, 2, 3]).filter((it) => it > 1).collect());
// [ 2, 3 ]
```
### reduce
```typescript
console.dir(await asynciter([1, 2, 3]).reduce(0, (a, b) => a + b));
// 6
```
### forEach
```typescript
await asynciter([1, 2, 3]).forEach((it) => console.log(it));
// 1
// 2
// 3
```
### first
```typescript
const iter = asynciter([1, 2, 3]);
console.dir(await iter.first());
console.dir(await iter.first());
// 1
// null
```
### collect
```typescript
console.dir(await asynciter([1, 2, 3]).collect());
// [ 1, 2, 3 ]
```