# @upradata/util
Set of Typescript Utilities

## A bunch of utilities in typescript

Look at [Node Utilities](https://www.npmjs.com/package/@upradata/node-util), for util sworking only on Node
Look at [Browser Utilities](https://www.npmjs.com/package/@upradata/browser-util), for util stuff working only on Browser 

- assignRecursive, assignDefaultOption
  
```
const a = {
     a: 1,
     b: 2,
     c: { c11: 11, c12: 12, c13: { c21: 21, c22: 22 } },
     d: 3
};
const b = { b: 3, c: { c11: 50, c13: { c22: 100 } } };
const a0 = { b: 2 };

const o1 = assignRecursive(a0, a, b);
console.assert(o1 === a0);

const o2 = assignDefaultOption({a:1, b:2}, b);
```

- chain (enabling kind of syntax a?b?c?d) ==> if a prop doesn't exist ==> return defaultValue
```
const defaultValue = 'whatever optional value';
chain(() => a.b.c.d, defaultValue);
```

- types: PartialRecursive, ObjectOf/PlainObj
- is utilities (isArray, isDefined, isInt, isAsyncFunction, ...)
- guid generator

- ExecuteOnTempState (change and object property temporarly)
 ```
 const o = {
    a: 1,
    b: 2,
    c: 3
};

const oTmpProps = { b: 22, c: 33 };

const p = temp.from(o).to(tmpState).execute(tmp => {
    console.assert(o === tmp);
    console.assert(tmp === this);

    // It is possible to return a value, Promise or Observable
    return Promise.resolve('test');
});

p.then(s => console.assert(s === 'test'));

// These constructions are all the same

const e1 = new ExecuteOnTempState({ obj: o, tmpState });
const e2 = new ExecuteOnTempState().state({ obj: o, tmpState });
const e3 = new ExecuteOnTempState().from(o).to(tmpState);
const e4 = temp(o).to(tmpState);
```

- BooleanAttribute.getBoolean (returns a boolean value for a html boolean attribute)

```
@Input() set right(right: string | boolean) {
        this.toRight = BooleanAttribute.getBoolean(right);
    }
```