A library of extensions for lodash.js.
This package can be installed via bower:
bower install lodash-extensions
From Debian and Ubuntu based distributions, use the following commands:
sudo apt-get install nodejs
sudo apt-get install nodejs-legacy
sudo apt-get install npm
For other distributions, you will not need the nodejs-legacy package. For information about other distributions, see: Installing node.js via package manager
To use the grunt-cli, it is easiest if it is installed globally.
sudo npm install -g grunt-cli
If you do not wish to install the grunt-cli, a script (see grunt file in project root) has been included. This allows you to use the local grunt-cli installation to run grunt commands. To do so, replace grunt in all grunt commands with ./grunt.
e.g. grunt becomes ./grunt, grunt build becomes ./grunt build
This project has two kinds of dependencies: tools and libraries.
Tools:
- are for managing and testing the application
- are specified in
package.json. - are installed via
npm, the node package manager.
Libraries:
- are the client-side dependencies which actually get shipped with the app.
- are specified in
bower.json. - are installed via
bower, a client-side code package manager.
In this project, npm install has been configured to automatically run bower install, so we can simply run:
npm install
This will create the following folders:
-
node_modules- contains the npm packages for tools needed. -
app/bower_components- contains bower packages for libraries needed.
Unit tests are written in Jasmine 2.0, and run with the Karma Test Runner. We provide a Karma configuration file to run them.
- Configuration for karma is found in
karma.conf.js - Unit tests are to be named as follows:
*.spec.coffee
Note: if using local grunt (described above), replace grunt in all commands listed below with ./grunt.
e.g. grunt build becomes ./grunt build
This tasks compiles Coffeescript source files to Javascript in the build directory. It watches those files for changes, and re-compiles them on change.
This is the default grunt task.
Command: grunt or grunt build.
This task also gives you the option of running unit tests and compiling Coffeescript source files simultaneously. Tests will automatically re-run in response to changes in the source code / specs.
Command: grunt --test or grunt build --test
This tasks compiles Coffeescript source files to Javascript in the build directory, and runs a single run of unit tests, outputing the test results to the console. Changes to files are not watched and the task terminates as soon as the unit tests complete.
Command: grunt test