Opinionated custom script to convert Coffee codebase to JS. Inspired by bugsnag/depercolator

Make sure you change the following before converting your codebase.

class B extends A
  constructor: (@options) ->
    super options

# this would compile in coffee to using this before super which is not allowed in JS

Instead rewrite it as

class A extends B
  constructor: (options) ->
    super options
    @options = options

class B extends A
  constructor: (@options) ->
    super options

  doStuff: () =>
    ...

# this would compile in coffee to using this before super which is not allowed in JS

Instead rewrite it as

class A extends B
  constructor: (options) ->
    super options
    @options = options
    @doStuff = @doStuff.bind @

  doStuff: () ->
    ...

# Also consider whether you actually need to bind, in most cases just switching to -> is enough

doStuff = () ->
  return {} =
    a: 5
    b: 8

Instead write as

doStuff = () ->
  return
    a: 5
    b: 8

Shadowing variables are incorectly converted and the inner varibale tries to override the outer scope even though they are in different scopes in coffeescript.

out = _.map [1, 2, 3], (item) ->
  out = item * 2
  out

Instead write as

out = _.map [1, 2, 3], (item) ->
  result = item * 2
  result

If you use same variable names in inner scope of a function as in the outer scope, decaffenaite will incorectly convert this case, see the sample:

out = _.map [1, 2, 3], (item) ->
    out = item * 2
    out

Will get converted incorrectly to

// Broken code!
var out = _.map([1, 2, 3], function(item) {
  out = item * 2;
  return out;
});

// Fixed code
var out = _.map([1, 2, 3], function(item) {
  var out = item * 2;
  return out;
});

Clone the repository

git clone https://github.com/AlesMenzel/depercolator.git

Install dependencies

cd depercolator && npm install

Run against a directory

node index.js /path/to/project

• cjsx-codemod
• decoffenaite
• jscodeshift
• react-codemods
• babel and presets/plugins
• eslint and presets/plugins
• prettier
• rimraf

1. Converts all cJSX files to use React.createElement
2. Converts all Coffee files to JS files
3. Remove .coffee extension from require()
4. Converts React.createClass to ES6 classes
5. Converts React.createElement back to JSX
6. Converts to more modern JS syntax (no var, template literals, object assign to spread, arrow functions instead of bind)
7. Runs prettier (ESLint unfortunatelly breaks the code with babel 7)
8. Runs rimraf and removes all Coffee files