conch

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 9 Open GitHub ↗

micro library for async sequential batches (Node/Browser/Deno) , for low memory systems

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# conch

> micro library for async sequential batches (Node/Browser/Deno)

[The Why &rarr;](/docs/where-to-use.md)

## Install

#### Node

```sh
npm i @barelyreaper/conch
# or
yarn add @barelyreaper/conch
```

#### Deno

```js
import {conch} from 'https://cdn.skypack.dev/@barelyreaper/conch';
// or
import {conch} from "https://www.unpkg.com/@barelyreaper/conch/dist/index.mjs"
// or 
import {conch} from "https://esm.sh/@barelyreaper/conch"
```

## Usage

**Node**

```js
const { conch } = require('@barelyreaper/conch')

const data = [
  {
    item: 1,
  },
  {
    item: 2,
  },
  {
    item: 3,
  },
]

function getData(item) {
  return new Promise(resolve => {
    setTimeout(() => {
      resolve(item)
    }, 2500)
  })
}

// Will take 3 * 2500 , considering there's 3 items and only one can run at once (limit:1)
conch(data, getData, { limit: 1 }).then(data => {
  console.log({ data })
})
```

**Deno**

```js
import { conch } from "https://esm.sh/@barelyreaper/conch@1.2.0";

const mapper = (item) => {
  return new Promise((resolve) => {
    setTimeout(() => {
      resolve(item * 2);
    }, 3000);
  });
};

const items = [1, 2, 3];

const result = await conch(items, mapper, {
  limit: Math.ceil(items.length / 2),
});

console.log(result); //=>[2,4,6]
```

## Build

```sh
yarn # install devDeps
yarn test # check the if the limit is being taken in consideration
yarn build # build the package
```

## Benchmark

[BENCHMARKS](/BENCHMARKS)

conch

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README