Convert your Reason project from Reason 2 to 3
What is Reason 2/3?
How do I upgrade my project?
Before you start
Converting your code to to the new syntax is done by running the
upgradeSyntaxFrom2To3 converter on your project's Reason code.
Make sure that your project is syntactically valid in Reason 2.
Invalid code will fail to convert.
Convert your code
Do this at the root of your project:
npm install -g upgrade-reason-syntax npm install --save-dev firstname.lastname@example.org upgradeSyntaxFrom2To3 mySource/*
Make sure you did install bs-platform 2.2.2. Sometimes your lockfile might have locked it to
1.x.x. 2.2.2 is also the last version to support Reason syntax 2.
The script accepts a list of files/globs to convert. Pass as many as you want. It'll intelligently skip over any file that's not Reason.
After you're done converting your projects:
- Remove the backup files at
"refmt": 3to your bsconfig.json to make BuckleScript use the new syntax.
- Feel free to uninstall this library!
If you're on native, this is also your workflow. (So you'll need node.js).
How does it work?
It's a simple node.js script that takes the old
refmt and the new
refmt3 from your project's BuckleScript 2.0.0's source at
node_modules/bs-platform, and then:
- Iterates over all your relevant files, making a backup copy
- Turns your Reason files into an AST (abstract syntax tree) using
- Turns the ASTs into the new syntax using
refmt3and writes them back
That's it! Enjoy =)