README.md
# ember-lodash
[![Build Status](https://travis-ci.org/mike-north/ember-lodash.svg?branch=master)](https://travis-ci.org/mike-north/ember-lodash)
[![Ember Observer Score](http://emberobserver.com/badges/ember-lodash.svg)](http://emberobserver.com/addons/ember-lodash)
[![npm version](https://badge.fury.io/js/ember-lodash.svg)](http://badge.fury.io/js/ember-lodash)
[![Code Climate](https://codeclimate.com/github/mike-north/ember-lodash/badges/gpa.svg)](https://codeclimate.com/github/mike-north/ember-lodash)
This ember addon allows consumption of the [lodash](https://lodash.com/) library (its [ES6 module variant](https://github.com/lodash/lodash/tree/es)) in [ember-cli](http://ember-cli.com) apps.
## Use
First you install this addon
```sh
# ember-cli > 0.2.3
ember install ember-lodash
# ember-cli <= 0.2.3
ember install:addon ember-lodash
```
And then in your ember.js app, you can import individual lodash modules freely
```js
import _string from 'lodash/string';
let truncatedString = _string.trunc(rawString);
```
Additionally, if you wish to work with the entire lodash library on a single namespace, you have the option of importing that as well
```js
import _ from 'lodash';
let truncatedString = _.trunc(rawString);
```
It is also possible to import individual modules
```js
import { trunc } from 'lodash';
let truncatedString = trunc(rawString);
```
## Installation
* `git clone` this repository
* `npm install`
* `bower install`
## Running
* `ember server`
* Visit your app at http://localhost:4200.
## Running Tests
* `npm test` (Runs `ember try:testall` to test your addon against multiple Ember versions)
* `ember test`
* `ember test --server`
## Building
* `ember build`
For more information on using ember-cli, visit [http://www.ember-cli.com/](http://www.ember-cli.com/).
![Analytics](https://ga-beacon.appspot.com/UA-66610985-1/mike-north/ember-lodash/readme)