Skip to content

Contributing

Seth Kinast edited this page Mar 24, 2015 · 1 revision

Building Dust locally

Grab a copy of the repo

cd some_project_directory
git clone https://github.com/linkedin/dustjs.git dustjs
cd dustjs

Install Grunt-cli

npm install -g grunt-cli

Fetch all node dependencies

npm install

Run tests

grunt test

Contributing to Dust

  • Setup a branch for what you are working on

      git checkout -b myBranchName
    
  • Test your changes (jshint, unit tests in node, rhino and phantom and make sure test coverage thresholds are met)

      grunt test
    
  • Use grunt dev while developing\debugging. This task will start a server and serve Jasmine spec runner on http://localhost:3000/_SpecRunner.html. This task uses unminified dust-full.js so it allows you to easily step through the code in a browser.

  • Use grunt testClient to test production version of code (dust-full.min.js) in a browser. Similarly to grunt dev it serves Jasmine spec runner on http://localhost:3000/_SpecRunner.html.

  • Add unit tests. Unit tests can be found in the test/jasmine-tests/spec directory. Help us keep up good test coverage! To view coverage report run grunt coverage and open tmp/coverage/index.html in a browser.

  • Add an issue and send a pull request. Pull requests are easier to track if you also include an issue. Sending a pull request from a branch makes it easier for you to resolve conflicts in master