connect-compiler

connect middleware for dynamically recompiling derived files at serve-time. This module is designed for speeding up development; best-practices would have you compile all necessary files as part of your production deploy process. But you knew that, of course.

Usage is the same as all other connect middleware:

var connect =require('connect')

, compiler =require('connect-compiler')

, server =connect.createServer(

connect.logger(),

compiler({

enabled :['coffee','uglify'],

src :'src',

dest :'var'

}),

connect.static(__dirname+'/public'),

connect.static(__dirname+'/var')

)

;

server.listen(6969);

Of note, earlier versions of connect actually came with a module like this, but not any longer.

Delta mtime (in seconds) required for a derived file to be considered stale, and therefore recompiled. By default, any change will cause a file to be recompiled on next request.

expires

Boolean

false

Automatically treat files as stale if this old in secs.

external_timeout

Number

3000

Milliseconds after which to kill subprocess commands.

cascade

Boolean

false

Invoke all compilers that match? otherwise, only first.

resolve_index

Boolean , String

false

If true-y, directories are resolved with the supplied filename, where true maps to 'index.html'.

ignore

RegExp

/\.(jpe?g|gif|png)$/i

Requests matching this pattern are short-circuit ignored, and no compiler matching occurs.

allowed_methods

String[]

['GET']

HTTP methods compiler should process. This setting is global-only -- per-compiler overrides specified via options will have no effect.

options

{compilerId:settings, ...}

Hash of additional per-compiler options, mapped by compiler id. Each compiler is supplied a copy of the settings object; if additional options are supplied in this way for a given compiler, they will be merged into the settings (and override any colliding top-level keys).

Compilers

To enable a compiler, you specify its id, which you can get from the handy list that follows. Some
compilers take options, which you pass using the options setting using the compiler id as the
key.

For example, to disable the bare option for the CoffeeScript compiler, you'd do something like: