coffee-inline-map

changequote([,])dnl # coffee-inline-map Compile CoffeeScript files with inline source maps. ## Features * Error reporting similar to the original CoffeeScript compiler. * `.litcoffee` support. ## Example ``` $ cat a.coffee include([a.coffee]) $ coffee-inline-map a.coffee | fold -w72 syscmd([../../../bin/coffee-inline-map a.coffee | fold -w72]) $ coffee-inline-map -h syscmd([../../../bin/coffee-inline-map -h]) ``` ## Installation # npm install -g coffee-inline-map ## Compilation $ make compile ## browserify & make-commonjs-depend To verify the text below you'll need to clone this repo, run 'make compile' & install [[make-commonjs-depend]](https://github.com/gromnitsky/make-commonjs-depend). Look into repo's `test/data` directory. Ignore `*.should` files. I'll wait. Then ``` $ cd src $ ls *coffee syscmd([ls *coffee]) ``` Here `main.coffee` depends on `a.coffee` & `b.litcoffee`. For out site we need just 1 `public/bundle.js` file which will include the result form the compilations of our all CoffeeScript files. We want to rebuild `public/bundle.js` only & only on .coffee files change. That's obviously a job for make. ``` $ cat Makefile include([Makefile]) ``` To create a dependency tree, we run ``` $ make depend syscmd([make depend | egrep -v '(Entering|Leaving) directory']) ``` ``` $ cat js.mk include([js.mk]) ``` It's unfortunate that make-commonjs-depend supports only javascript. That's why before running it, make needs to compile all coffescript files. Then compile the bundle ``` $ make compile syscmd([make compile | egrep -v '(Entering|Leaving) directory']) ``` As a little homework, try to guess why `main.js` was recompiled here, when at first glance it should rather not. Run again ``` $ make compile syscmd([make compile | egrep -v '(Entering|Leaving) directory']) ``` Notice that the nothing was recompiled for the 2nd time. That's our goal! ``` $ touch a.coffee $ make compile syscmd([touch a.coffee; make compile | egrep -v '(Entering|Leaving) directory']) ``` Yay! Then open `public/index.html` in Chrome and switch to the console view. (Make sure to turn on 'Enable source maps' in Developer Tool's settings.) ## Jeez mate, why are you doing this rigmarole? Every dependency & every file should be compiled/processed only once. This seems meaningless for a bunch of small .coffee files but becomes very useful for large projects with several complex browserify output targets. ## Why not just use coffeeify plugin for browserify? 1. browserify can't (& shouldn't) check changes in our source files to decide whether it's time to recompile. 2. Error reporting. ## Why are you using outdated make instead of cake, jake, grunt, gulp or broccoli? It's not 1977 anymore! facepalm.jpg Dude. <br/> Take a walk for 10 minutes & no one will get hurt. ## BUGS * Reading from stdin doesn't work in Windows. ## NEWS ### 0.9.0 * CoffeeScript 1.10.0. ### ... ### 0.5.0 * CoffeeScript 1.8.0. ### 0.4.0 * CoffeeScript 1.7.1 * 'New' source map syntax. ### 0.3.0 * `-b` CLO. * Include 'generated by ...' header. ### 0.2.0 * Update for CoffeeScript 1.6.3. * Recognize `.coffee.md` extension. * `-l` CLO. ### 0.1.0 * Add reading from stdin. * Fix an unheplful crash for EPIPE error. ## License MIT.