@kraftvaerk/lota-js/README.md

Useful modular JavaScript bits with zero dependencies

# lota-js

[![Build Status](https://img.shields.io/travis/kraftvaerk/lota-js/master.svg?style=flat-square)](https://travis-ci.org/kraftvaerk/lota-js) 
[![npm Version](https://img.shields.io/npm/v/@kraftvaerk/lota-js.svg?style=flat-square)](https://www.npmjs.com/package/@kraftvaerk/lota-js) 
[![npm Downloads](https://img.shields.io/npm/dm/@kraftvaerk/lota-js.svg?style=flat-square)](https://www.npmjs.com/package/@kraftvaerk/lota-js) 
[![Dependency Status](https://img.shields.io/david/kraftvaerk/lota-js.svg?style=flat-square)](https://david-dm.org/kraftvaerk/lota-js) 
[![devDependency Status](https://img.shields.io/david/dev/kraftvaerk/lota-js.svg?style=flat-square)](https://david-dm.org/kraftvaerk/lota-js/?type=dev)

> All code is vanilla JS, library agnostic and consist mostly of helper methods that aren't directly related with the DOM, the purpose of this library is to provide modular solutions for common JS problems in kraftvaerk.

## Main goals

 - increase code reuse;
 - be easy to debug;
 - be easy to maintain;
 - follow best practices;
 - be compatible with other frameworks;
 - be modular;
  
## Installation

```bash
npm i @kraftvaerk/lota-js --save
```

## Contents

* [`UUID`](#UUID)
* [`Stringify`](#call)
* [`parseJSON`](#collectinto)

## Another Lodash?

No. The goal is to provide frontend developers in Kraftvaerk with a number of useful and small JavaScript codes, not just functions, but also modules and classes. Think of it as a mini version of npm suitable for tiny packages.


## What shouldn't be here ##

 - UI components;
 - CSS selector engine;
 - Event system - pub/sub;
 - Template engine;
 - Anything that isn't generic enough;
 - Anything that could be a separate library and/or isn't a modular utility...

## Submitting New Modules

Unable to find one suitable? Fork it on GitHub, add the module and submit a pull
request.

#### 
<br>[⬆ Back to top](#contents)

### UUID

Generates a UUID in a browser. Use crypto API to generate a UUID, compliant with [RFC4122](https://www.ietf.org/rfc/rfc4122.txt) version 4.

```js
const UUID = () =>
  ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, c =>
    (c ^ (crypto.getRandomValues(new Uint8Array(1))[0] & (15 >> (c / 4)))).toString(16)
  );
```

<details>
<summary>Examples</summary>

```javascript
import UUID from '@kraftvaerk/lota-js/uuid';

UUID(); // -> 0e3b84af-f911-4a55-b78a-cedf6f0bd815
```
</details>

## License

MIT © [Kraftvaerk](http://kraftvaerk.com/)