Home

Awesome

Build Status

                                    ,--.           ,--.
 ,---.  ,--,--. ,---.,--. ,--.,-----.|  |-.  ,--,--.|  |,-. ,---.
| .-. :' ,-.  |(  .-' \  '  / '-----'| .-. '' ,-.  ||     /| .-. :
\   --.\ '-'  |.-'  `) \   '         | `-' |\ '-'  ||  \  \\   --.
 `----' `--`--'`----'.-'  /           `---'  `--`--'`--'`--'`----'
                     `---'

EasyBake provides Coffeescript config file-based Cakefile helpers for common CoffeeScript library packaging functionality (build & joining, headless testing, etc).

Commands Supplied by EasyBake

Command Options:

For example: 'bake test -c -w' will first clean your project, build it, run your tests, and re-build and re-run your tests when source files change

Some common options:

To see all of the options for each command, just run 'bake command_name --help'.

Sample Config File

Here is an example of a CoffeeScript config file (JavaScript is also supported):

module.exports =
  library:
    files: 'src/easy-bake.coffee'

  lib_test_runners:
    output: '../../lib/test_runners'
    directories: 'src/test_runners'

  tests:
    _build
      output: 'build'
      bare: true
      directories: 'test/easy-bake_core'
    _test:
      command: 'nodeunit'
      files: '**/*.js'

###Directories vs Files

Because CoffeeScript will retain the file hierarchy if an output directory is given, easy-bake allows you to flatten the hierarchy or to preserve it using directories + files vs directories-only.

For example, because directories are only specified in this case, the full directory structure will be preserved when the CoffeeScripts are compiled:

my_set_hierarchical:
  output: '../js'
  directories: 'my_directory'

Whereas, by specifying the files, you can compile them all into the output directory:

my_set_flat:
  output: '../js'
  directories: 'my_directory'
  files: '**/*.coffee'

So if the hierarchy is like:

- my_directory
  - sub_directory
    - file1.coffee
  - app.coffee

The results would be as follows for my_set_hierarchical:

- js
  - sub_directory
    - file1.js
  - app.js
- my_directory
  - sub_directory
    - file1.coffee
  - app.coffee

and for my_set_flat:

- js
  - app.js
  - file1.js
- my_directory
  - sub_directory
    - file1.coffee
  - app.coffee

###Relative Directories

All output directories are relative to a set's directory.

For example, the output directory in this example is resolved to be the same directory as the CoffeeScript config file root because 'src/test_runners' is two directories down the hierarchy:

lib_test_runners:
  output: '../../lib/test_runners'
  directories: 'src/test_runners'

Whereas, the output in this case will be in a new folder under 'test/easy-bake_core' (output to 'test/easy-bake_core/build'):

tests:
  _build
    output: 'build'
    bare: true
    directories: 'test/easy-bake_core'

Project Configuration

It is best to preinstall a specific version of easy-bake in your package.json (to lock a specific version until the configuration format is locked at a major release):

"scripts": {
  "postinstall": "bake postinstall"
},
"devDependencies": {
  "coffee-script": ">=1.3.3",
  "easy-bake": "0.1.7"
},

Install it:

npm install

Add a Bakefile.coffee or Bakefile.js to your root directory like:

module.exports =
  library:
    files: 'src/easy-bake.coffee'

And run it:

bake build

###Known Issues

  1. if commands like bake, mbundle, or uglify give you errors, make sure 'node_modules/.bin' and 'node_modules/easy-bake/node_modules/.bin' are added to your PATH. For example in zsh, just add the following to ~/.zshrc:
export PATH=node_modules/.bin:node_modules/easy-bake/node_modules/.bin:$PATH

And that's it! You will have access to the following bake commands and options in your projects...

Testing

If you are using TravisCI, you should add something like this to your project.json file:

"scripts": {
  "postinstall": "bake postinstall",
  "clean": "bake clean",
  "build": "bake build",
  "watch": "bake watch",
  "test": "bake test -c"
},

and a .travis.yaml to your project root file like:

language: node_js
node_js:
  - 0.8

before_script:
  - "export PATH=node_modules/.bin:node_modules/easy-bake/node_modules/.bin:$PATH"
  - "export DISPLAY=:99.0"
  - "sh -e /etc/init.d/xvfb start"

and add test options to the set you want to test:

some_testing_group:
  output: 'build'
  directories: [
    'test/some_tests'
    'test/some_more_tests'
  ]
  _test:
    command: 'phantomjs'
    runner: 'phantomjs-qunit-runner.js'
    args: [60000]
    files: '**/*.html'

###Testing With PhantomJS

You will need to install phantom yourself since there is no npm package for it. Look here for the instructions: http://phantomjs.org/ or if you use homebrew: 'brew install phantomjs'

some_testing_group:
  ...
  _test:
    command: 'phantomjs'
    runner: 'phantomjs-qunit-runner.js'
    files: '**/*.html'

Note: currently the library only has a test-runner for phantomjs-qunit-runner.js and phantomjs-jasmine-runner.js. Feel free to add more and to submit a pull request.

###Testing With NodeUnit

Just include it as a development dependency to your package.json:

"devDependencies": {
  "coffee-script": ">=1.3.3",
  "nodeunit": "latest"
},

some_testing_group:
  ...
  _test:
    command: 'nodeunit'
    files: '**/*.js'

###Post Install

You can add commands to run after npm install. For example, you can copy and rename a file from a node module into a vendor directory:

  _postinstall:
    commands: [
      'cp underscore vendor/underscore-latest.js'
    ]

###Publishing

Publishing to npm registry and NuGet Gallery are currently supported.

Using a post _build command, you should copy your files into the directories as follows:

- project_root
  - package.json (for building)
  - packages
    - npm
      - package.json (for distribution)
      - your files
    - nuget
      - package.nuspec
      - Content
        - Scripts
          - your files

The reason for this multiple layered structure is so you can separate your building environment (as project_root) from your distribution packages, which for example, may not require all of postinstall and build steps.

#NPM

Set up an account on npm registry: http://search.npmjs.org/

#NuGet

Currently, NuGet has only been tested on Mac using Mono. If anyone would like to test and update on Windows or Linux, please submit a pull request.

Also, NuGet doesn't seem to handle removing and reinstalling packages from the command line so you might need to still perform some manual steps.

Installation

Known Issues

Release Notes

0.1.6

0.1.5

0.1.4

0.1.3

Building the library

###Installing:

  1. install node.js: http://nodejs.org
  2. install node packages: 'npm install'

###Commands:

Easy-bake uses easy-bake! Just use the above commands...