browserify transform to compile coffee-script automatically (evacuated from NSA/Microsoft Github)

Johan Nordberg 844b1af891 Version 3.0.1 6 years ago
example 55e8864b8a Report multiline syntax errors without throwing 10 years ago
test ea9e57fd05 test for passing unknown options to coffee compiler 6 years ago
.gitignore df91c4e54f Add a .gitignore 10 years ago
.travis.yml dd285fb205 CoffeeScript 2 is Node 6+ 6 years ago
LICENSE 98110a67e7 package.json etc 11 years ago
README.md 51826d7c59 Wording 6 years ago
index.js 2a07f6b074 pass unknown options along 6 years ago
package-lock.json ea9e57fd05 test for passing unknown options to coffee compiler 6 years ago
package.json 844b1af891 Version 3.0.1 6 years ago

README.md

coffeeify Build Status

CoffeeScript browserify transform. Mix and match .coffee and .js files in the same project.

NOTE: As of version 3.0.0 coffeeify requires CoffeeScript to be installed manually as a peerDependency, also note that the CoffeeScript package has changed name from coffee-script to coffeescript.

Example

Given some files written in a mix of js and coffee:

foo.coffee:

console.log require './bar.js'

bar.js:

module.exports = require('./baz.coffee')(5)

baz.coffee:

module.exports = (n) -> n ** n

Install coffeeify into your app, and CoffeeScript if you don't have it already:

$ npm install --save-dev coffeeify coffeescript

When you compile your app, just pass -t coffeeify to browserify:

$ browserify -t coffeeify foo.coffee > bundle.js
$ node bundle.js
3125

You can omit the .coffee extension from your requires if you add the extension to browserify's module extensions:

module.exports = require('./baz')(5)
$ browserify -t coffeeify --extension=".coffee" foo.coffee > bundle.js
$ node bundle.js
3125

You can also pass options to the CoffeeScript compiler:

$ browserify -t [ coffeeify --bare false --header true ] --extension=".coffee" foo.coffee
..
// Generated by CoffeeScript 1.10.0
(function() {
  console.log(require('./bar.js'));

}).call(this);
..

Options

Name Default Description
sourceMap null Generate source maps, deteremined from browserify's --debug option if not set.
bare true Omit the (function(){ .. }).call(this); wrapper.
header false Include the // Generated by CoffeeScript <version> header in every file processed.

When using browserify programatically options can be passed as an object, example:

browserify = require 'browserify'
coffeeify = require 'coffeeify'

bundle = browserify
  extensions: ['.coffee']

bundle.transform coffeeify,
  bare: false
  header: true

bundle.add 'foo.coffee'

bundle.bundle (error, result) ->
  throw error if error?
  process.stdout.write result

Install

With npm do:

npm install --save-dev coffeeify

CoffeeScript is not installed automatically, so that you can choose what version of CoffeeScript you'd like:

npm install --save-dev coffeescript  # Or coffeescript@1 to use CoffeeScript 1.x

License

MIT