CoffeeScript is a little language that compiles into JavaScript. Underneath that awkward Java-esque patina, JavaScript has always had a gorgeous heart. CoffeeScript is an attempt to expose the good parts of JavaScript in a simple way.
The golden rule of CoffeeScript is: "It's just JavaScript". The code compiles one-to-one into the equivalent JS, and there is no interpretation at runtime. You can use any existing JavaScript library seamlessly from CoffeeScript (and vice-versa). The compiled output is readable and pretty-printed, will work in every JavaScript runtime, and tends to run as fast or faster than the equivalent handwritten JavaScript.
lein-coffeescript is a Leiningen plugin that allows to use CoffeeScript compiler.
Install NodeJS and NPM (package manager for Node) to install CoffeeScript:
- On Ubuntu:
sudo apt-get install nodejs
- On Mac OS X:
brew install node
Install CoffeeScript to use lein-coffeescript plugin. It could be done in few ways:
- Use NPM to install CoffeeScript globally:
npm install lein-coffeescript -g
- You can also install CoffeeScript in the current directory:
npm install lein-coffeescript
- Use lein-npm plugin:
lein npm install
- Use just Leiningen:
lein deps
To enable lein-coffeescript for your project, put the following in the :plugins vector of your project.clj file:
To configure lein-coffeescript, put the :coffeescript parameter in the file project.clj. It could be a single configuration (simple map) or a collection of configurations (for multiple configuration).
; single configuration
:coffeescript {:sources "src/*.cs"}
; multiple configurations
:coffeescript [{:sources "src/*.cs"
:bare false
:map true}
{:sources ["src/*.coffee" "resources/*.cs"]
:bare true}]
- :sources
- List of input CoffeeScript sources. It is possible to use a single source or a vector of sources. To configure this parameter, you could also use a Glob Patterns.
- :excludes
- List of glob patterns to prevent processing of some files. It is also possible to use both variants: single pattern and collection of patterns.
- :map
- Generate source maps alongside the compiled JavaScript files. Adds
sourceMappingURL
directives to the JavaScript as well. Default value: false. - :bare
- Compile the JavaScript without the top-level function safety wrapper. Default value: false
- :join
- Before compiling, concatenate all scripts together in the order they were passed, and write them into the specified file. Useful for building large projects. It is not defined by default.
- :output
- Write out all compiled JavaScript files into the specified directory. It is not defined by default. Source directory will be used of generated JS files.
To enable this plugin in the compile stage, use the following hook:
:hooks [lein-coffeescript.plugin]
:coffeescript {:sources "resources/*.coffee"
:excludes ["resources/tests.coffee" "resources/bad.coffee"]
:map true
:join "app.js"
:output "target/js"
:bare false
:debug true}
Just clone the current repository and try to play with example project for better understanding how to use lein-coffeescript.
CoffeeScript author Jeremy Ashkenas and other developers who worked on this great project.
- lein-jslint - a Leiningen plugin for running javascript code through JSLint.
- lein-jshint - a Leiningen plugin for running javascript code through JSHint.
- lein-plantuml - a Leiningen plugin for generating UML diagrams using PlantUML.
- lein-asciidoctor - A Leiningen plugin for generating documentation using Asciidoctor.
Copyright © 2014 Vladislav Bauer
Distributed under the Eclipse Public License, the same as Clojure.