README.md 7.8 KB

js2coffee

Build Status NPM version Dependency Status Development Dependency Status

A JavaScript to CoffeeScript compiler

Install

NPM

  • Use: require('js2coffee')
  • Install: npm install --save js2coffee

Browserify

  • Use: require('js2coffee')
  • Install: npm install --save js2coffee
  • CDN URL: //wzrd.in/bundle/js2coffee@0.3.1

Ender

  • Use: require('js2coffee')
  • Install: ender add js2coffee

Command Line Interface

  • Install: npm install -g js2coffee

Usage

CLI

  • Use:

    js2coffee input_file.js
    js2coffee input_file.js > output.coffee
    cat input.js | js2coffee
    

    You can pass some options:

    --version           # Show js2coffee version
    --verbose           # Be verbose
    --no_comments       # Do not translate comments
    --show_src_lineno   # Show src lineno's as comments
    --single_quotes     # Use single quoted string literals - default double quoted
    --help              # If you need help
    --indent            # Specify the indent character(s) - default 2 spaces
    

API

js2coffee = require('js2coffee');
coffeeContent = js2coffee.build(jstContent, {show_src_lineno: true, indent: "    "});
  • require('js2coffee').build(content, options), arguments:
    • content String - javascript source code
    • options Object - options object, available options:
      • no_comments Boolean - ignore comments, if true
      • show_src_lineno Boolean - show source line numbers in each line as comment, if true
      • indent String - specify indent
      • single_quotes Boolean - use single quoted string literals instead of double quoted

Known issues

Js2coffee has some kown issues

  • switch statements have always implict returns at the end of a function - #250
  • some switch statements fail - switch
  • CoffeeScript keywords become converted with an trailing underscore - keywords
  • Narcissus fails to parse JavaScript keywords as object properties - narcissus
  • some IIFE syntaxes fail - #190
  • Empty function declrations within if statements fail - #162

Try out in the browser

js2coffee.org
You can swtich the mode (JS -> Coffee and Coffee -> JS) at the top in the center.

History

Discover the change history by heading on over to the HISTORY.md file.

Contribute

Discover how you can contribute by heading on over to the CONTRIBUTING.md file.

Backers

Maintainers

These amazing people are maintaining this project:

Sponsors

No sponsors yet! Will you be the first?

Contributors

These amazing people have contributed code to this project:

Become a contributor!

License

Licensed under the incredibly permissive MIT license

Copyright © 2011+ Rico Sta. Cruz hi@ricostacruz.com (http://ricostacruz.com)

Thanks

Made possible thanks to the hard work of Js2coffee's dependency projects:

And of course: