npm package: @mobilabs/es6libplus
Description: A template for writing pure ES6 Javascript libraries
Author: Mobilabs
Latest version: 0.0.10

# ES6libplus

[![NPM version][npm-image]][npm-url]
[![Travis CI][travis-image]][travis-url]
[![Test coverage][coveralls-image]][coveralls-url]
[![Dependencies status][dependencies-image]][dependencies-url]
[![Dev Dependencies status][devdependencies-image]][devdependencies-url]
[![License][license-image]](LICENSE.md)
<!--- [![node version][node-image]][node-url] -->

| `ES6libplus` has been deprecated. Please, use [ES6Kadoo](https://www.npmjs.com/package/@mobilabs/es6kadoo) with [kadoo](https://www.npmjs.com/package/kadoo) or [es6Pakket](https://www.npmjs.com/package/@mobilabs/es6pakket) with [pakket](https://www.npmjs.com/package/pakket) now. |
| --- |

ES6libplus is a boilerplate for writing ES6 Javascript libraries that run on both Node.js and ECMAScript 2015 (ES6) compliant browsers.

The build doesn't require a transpiler (like babel) or a builder (like browserify, webpack or rollup) to produce a module that runs in the browser from source files that use `import` and `export` statements. It is useful if you want to keep your source code quite pure.

ES6libplus relies on `gulp-modulify` to drastically reduces the amount of extra code added to your library (go to [gulp-modulify](https://www.npmjs.com/package/gulp-modulify) for details).

ES6libplus relies on [Mocha](https://mochajs.org) and [Chai](http://chaijs.com) for unitary testing. It relies on [Istanbul](https://gotwarlost.github.io/istanbul/) for code coverage.

ES6libplus uses [Travis CI](https://travis-ci.org) for continuous integration and [Coveralls.io](https://coveralls.io) to display test coverage.


## Quick Startup

You can easily get your first ES6Libplus library running in a couple of minutes by just typing a few command lines. But first, you need to create an empty folder. It will contain your library.

Then, you have to install the `es6libplus` package globally. Open a terminal session and type the command line:

```bash
npm install es6libplus -g
```

Or, if you don't have the rights to install es6lib globally, you can install it locally in your project. Open a terminal session, move to your working directory - the empty folder you created - and type the following command line:

```bash
npm install es6libplus
```

Now populate your empty folder and create your first UMD library:

```bash
// populate
es6libplus populate -n myapp
// Or, if you installed the package locally:
./node_modules/.bin/es6libplus populate -n myapp
// Install Node.js packages
npm install
```

Now your folder contains the following files:

```bash
Your project Folder
      |_ lib
      |   |_ lib.js           // Your built ES6 module,
      |_ src
      |   |_ _footer           // The UMD footer,
      |   |_ _header           // The UMD header,
      |   |_ ...               // The source files of your library,
      |   |_ ...
      |   |_ ...
      |_ tasks
      |   |_ ...              // The Gulp tasks to build your project,
      |_  test
      |     |_ main.js        // Your Mocha, Chai test file,
      |_ .eslintignore        // Files to be ignored by ESLint,
      |_ .eslintrc            // A Configuration file for the ESLint linter tool (if you use it),
      |_ .gitignore           // Files that Git must ignore (if you use git),
      |_ .travis.yml          // A configuration file for Travis CI (if you use it),
      |_ .CHANGELOG.md        // The changes between your different versions,
      |_ .gulpfile.js         // The main Gulp task,
      |_ index.js             // The link to your ES5 library,
      |_ LICENSE.md           // The license that applies to your library (here MIT),
      |_ package-lock.json    // The NPM dependency tree,
      |_ package.json         // The NPM package file,
      |_ README.md            // Your README file,
```

This folder is now a NPM package.


## How to build it

The file `gulpfile.js` contains the build instructions. These instructions populate the folder `lib` from the sources files included in the folder `src`.

`gulpfile.js` implements two operations for the build:
  * the command `npm run build` creates the library at the execution,
  * and the command `npm run watch` updates the library when one of the source files is modified.


## How to test it

Your `package.json` file contains three scripts to test your UMD library:

  * `npm run test`,
  * `npm run check-coverage`,
  * `npm run display-coverage`.

`npm run test` executes the tests and computes the test coverage.

`npm run check-coverage` checks if the test coverage matches the requirements. Here 100%.

`npm run display-coverage` opens your browser and reports the test coverage.


## How to create a distribution version

Your `package.json` file contains a script to build a distribution library:

  * `npm run makedist`

The script `makedist` adds a license header to the library and creates a minified version.


## How to use it

On Node.js, your project folder is viewed as a NPM package. Choose a working directory outside your project folder, create a folder `node_modules` and copy your project folder into `node_modules`. Then, on your terminal, type (at your working directory level):

```js
node
> var mylib = require('mylib');
undefined
> mylib.getString();
'I am a string!'
> mylib.getArray();
[ '1', '2', '3' ]
>
```

On the browser, pick-up the JS file `lib/mylib.js` and add it as a script in your HTML file. `mylib` is an immediately-invoked function expression. It attaches the `mylib` variable to the current context.

```html
<!DOCTYPE html>
<html>
  <body>
    <script src="mylib.js"></script>
    <script>
    	console.log(mylib.VERSION);
    </script>
  </body>
</html>
```

Enjoy!

## License

[MIT](LICENSE.md).

<!--- URls -->

[npm-image]: https://img.shields.io/npm/v/@mobilabs/es6libplus.svg?style=flat-square
[npm-install-image]: https://nodei.co/npm/@mobilabs/es6libplus.png?compact=true
[node-image]: https://img.shields.io/badge/node.js-%3E=_0.10-green.svg?style=flat-square
[download-image]: https://img.shields.io/npm/dm/@mobilabs/es6libplus.svg?style=flat-square
[travis-image]: https://img.shields.io/travis/jclo/es6libplus.svg?style=flat-square
[coveralls-image]: https://img.shields.io/coveralls/jclo/es6libplus/master.svg?style=flat-square
[dependencies-image]: https://david-dm.org/jclo/es6libplus/status.svg?theme=shields.io
[devdependencies-image]: https://david-dm.org/jclo/es6libplus/dev-status.svg?theme=shields.io
[license-image]: https://img.shields.io/npm/l/@mobilabs/es6libplus.svg?style=flat-square

[npm-url]: https://www.npmjs.com/package/@mobilabs/es6libplus
[npm-install-url]: https://nodei.co/npm/@mobilabs/es6libplus
[node-url]: http://nodejs.org/download
[download-url]: https://www.npmjs.com/package/@mobilabs/es6libplus
[travis-url]: https://travis-ci.org/jclo/es6libplus
[coveralls-url]: https://coveralls.io/github/jclo/es6libplus?branch=master
[dependencies-url]: https://david-dm.org/jclo/es6libplus
[devdependencies-url]: https://david-dm.org/jclo/es6libplus?type=dev
[license-url]: http://opensource.org/licenses/MIT