# many-birds

> Kill many (figurative) birds with one (literal) return value

Latest version **0.8.0** (published 2018-04-06) · MIT license · 0 weekly downloads

## Install

```sh
npm install many-birds
pnpm add many-birds
yarn add many-birds
bun add many-birds
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support; pre 1.0.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 0.8.0 |
| Published | 2018-04-06 |
| First published | 2018-04-06 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Unpacked size | 5.3 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 0 |
| Author | Brian Lauber |
| Maintainers | briandamaged |
| Keywords | promise, birds |

## Links

- npm: https://www.npmjs.com/package/many-birds
- Repository: https://github.com/briandamaged/js-many-birds
- Homepage: https://github.com/briandamaged/js-many-birds#readme
- Issues: https://github.com/briandamaged/js-many-birds/issues
- npm.io page: https://npm.io/package/many-birds

## Alternatives

- [promise-throttle](https://npm.io/package/promise-throttle.md) — 44.2K weekly downloads
- [@commercetools/sync-actions](https://npm.io/package/@commercetools/sync-actions.md) — 25.1K weekly downloads
- [cwait](https://npm.io/package/cwait.md) — 21.4K weekly downloads
- [@ledgerhq/hw-app-cosmos](https://npm.io/package/@ledgerhq/hw-app-cosmos.md) — 4.2K weekly downloads
- [@financial-times/o-loading](https://npm.io/package/@financial-times/o-loading.md) — 2.8K weekly downloads

## Recent versions

- 0.8.0 (latest) — 2018-04-06

## README

# many-birds #

Kill many (figurative) birds with one (literal) return value.


## Purpose ##

Let's imagine that we've written an application that needs to serve thousands of requests per second.  Additionally, this application needs to retrieve mostly-static data from an external service.  At any given moment, it is probably making 50 calls to this external service using exactly the same input arguments.  For ex:

```javascript
// The application is currently waiting for 50 occurrences of this Promise to resolve.
const data = await externalService.getData("foo", "bar");
```

Since the data returned by this external service is mostly-static, it means that all 50 Promises will most likely resolve to exactly the same value.  Therefore, we really don't need to make 50 separate calls to the service.  Instead, we really only need to make 1 call to the service; afterwards, this one response can be used to resolve all 50 Promises.

In short: we can kill many (figurative) birds with one (literal) return value.

## Installation ##

```shell
npm install many-birds
```

## Usage ##

```javascript
const { Fulfiller } = require('many-birds');

let x = 0;
const getToken = Fulfiller(async function() {
  return x++;
});



async function run() {
  const tokens1 = await Promise.all([
    getToken(), getToken(), getToken("foo"), getToken("bar"), getToken("foo"),
  ]);

  console.log(tokens1); // Prints: [0, 0, 1, 2, 1]

  const tokens2 = await Promise.all([
    getToken(), getToken("foo"), getToken("foo", "bar"), getToken("foo"),
  ]);

  console.log(tokens2); // Prints: [3, 4, 5, 4]
}


run();

```

Or, if you're using decorators:

```
const { ManyBirds } = require('many-birds');

let x = 0;

const foo = {
  @ManyBirds()
  getToken() {
    return x++;
  }
}
```

---
_Source: https://npm.io/package/many-birds · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._