# @sourcevault/bindall

> reassign .this to a fixed object for methods

Latest version **0.3.1** (published 2017-09-11) · MIT license · 0 weekly downloads

## Install

```sh
npm install @sourcevault/bindall
pnpm add @sourcevault/bindall
yarn add @sourcevault/bindall
bun add @sourcevault/bindall
```

## 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.3.1 |
| Published | 2017-09-11 |
| First published | 2017-08-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 0 |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 2 |
| Author | joykrishnamondal |
| Maintainers | sourcevault |
| Keywords | livescript, utility, bindall |

## Links

- npm: https://www.npmjs.com/package/@sourcevault/bindall
- Repository: https://github.com/sourcevault/bindall
- Issues: https://github.com/sourcevault/bindall/issues
- npm.io page: https://npm.io/package/@sourcevault/bindall

## Alternatives

- [lodash.assign](https://npm.io/package/lodash.assign.md) — 2.3M weekly downloads
- [lodash.chunk](https://npm.io/package/lodash.chunk.md) — 1.8M weekly downloads
- [react-native-ios-utilities](https://npm.io/package/react-native-ios-utilities.md) — 138.5K weekly downloads
- [@technically/lodash](https://npm.io/package/@technically/lodash.md) — 50.9K weekly downloads
- [@fluid-topics/ft-icon](https://npm.io/package/@fluid-topics/ft-icon.md) — 20.6K weekly downloads

## Recent versions

- 0.3.1 (latest) — 2017-09-11
- 0.3.0 — 2017-09-11
- 0.2.11 — 2017-08-22
- 0.2.1 — 2017-08-21
- 0.2.0 — 2017-08-21
- 0.1.0 — 2017-08-19

## README

[![Build Status](https://travis-ci.org/sourcevault/bindall.svg?branch=master)](https://travis-ci.org/sourcevault/bindall)

# bindall ( ob , fns  , options )

#### API
- `ob` - Object to bind methods to.
- `fns` - is an object whose values get fixed bound to `ob`

*optional*

- `options`

	- `select` - Array of string providing names of functions attached to *fns* to bind - in case when binding needs to be done selectively.

	- `addto` - object to bind the newly created bound methods to. Using this option means `fns` object is **not** mutated and the original methods attached to `fns` is kept in place. 

	- `s` - same as `select`

	- `a` - same as `addto`




#### Install

```
npm install @sourcevault/bindall
```

#### Internals

- [reassign](https://github.com/sourcevault/bindall/blob/7e6208f6157b19a43133822233ff65aee130e274/main.ls#L1) ```.this``` to fixed object for selected functions

- [mutates](https://github.com/sourcevault/bindall/blob/7e6208f6157b19a43133822233ff65aee130e274/main.ls#L11) `fns` that holds the functions (**default** behavior) . To prevent mutation use the `addto` option.

- Other implementation ( [lodash](http://devdocs.io/lodash~4/index#bindall), [underscore](http://underscorejs.org/#bindall) ) of `bindall` lack options to control **what** `fns` is bound *to*. Also cannot prevent mutation when needed.



#### Examples

|[view in beautiful livescript](https://github.com/sourcevault/bindall/tree/livescript) |
| --- |

- . . binding all functions that exists in `fns` object


```javascript

bindall = require ("@sourcevault/bindall")

log = function()
{
	console.log (this);
}

// purpose of this excercise is we want access to ob.fuel

ob =
{
	fuel:"coffee",
	fns:
	{
		foo:log
	}
}

ob.fns.foo() // { foo: [Function: log] } // cannot access ob.fuel  :(

bindall(ob,ob.fns) // [WARNING] → will mutate ob.fns

ob.fns.foo() 

// { fuel: 'coffee', fns: { foo: [Function] } } // can access .fuel now :)

```
- . . for applying to a subset number of functions in `fns` object

```javascript
ob = 
{
	fuel:"coffee",
	fns:
	{
		foo:log,
		bar:log
	}
}

// ↓ only ob.fns.bar is bound due to using select option ↓

bindall(ob,ob.fns,(select:["bar"]))

ob.fns.bar()

// { fuel: 'coffee', fns: { foo: [Function: log] , bar: [Function] } }

// ↓ foo is not bound as expected ↓

ob.fns.foo() // {fns: { foo: [Function: log] , bar: [Function] }}


```

* .. to prevent **mutating** original object `fns`

```javascript
ob = 
{
	fuel:"coffee",
	fns:{
		foo:log,
		bar:log
	}
}

boundfns = bindall(ob , ob.fns , ( select:["bar"], addto:{} ))

// ↓ boundfns contains the newly minted bound fns ↓

boundfns.bar() // { fuel: 'coffee', fns: { log: [Function] , bar: [Function] }}

// ↓ original object unchanged ↓

ob.fns.bar()

// {fns: { foo: [Function: log], bar: [Function: log] } }

```

**Notes on Immutability**

*If a tree falls in a forest and no one is around to hear it, does it make a sound ?*

Passing an `{}` (empty) object to the `addto` option makes bindall immutable - in the sense that `{}` (empty) object is mutated and the original object from which the methods were extracted is untouched. 

This is useful . .
- . . if the object providing the methods is external.

- . . when we need to add our bound functions to an independent object of our choosing.

bindall that mutate `fns` is dangerous and should be used with caution. The main usecase for mutating `fns` is within the enclave of where it was created.



### Updates and API change

- `0.3.0` added `s` and `a` for `select` and `addto` respectively for power users

- `0.2.0` changed `selected` to `option` to expand functionality. Third argument is an object instead of an array and the previous functionality of `selected` is now passed as value to `select` key in `option`. `addto` allows control of what object to attach thee newly created fuctions to.

- `0.1.0` [readme](https://github.com/sourcevault/bindall/tree/0.1.0)

## License
 
Code and document released under MIT Licence, see [LICENSE](https://github.com/sourcevault/bindall/blob/master/LICENCE) for details.

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