./invig

expand_more
Build Status

🌿 Invig

Breathes new life into legacy code bases by automatically:

Invig does this in a highly opinionated, non-configurable, and destructive way.

Let’s have some fun breathing new life into your legacy project 😚 💨 🌿

Why

I’m dealing with an ever-growing number of projects that each have a slightly different setup, and I got pretty tired of context switching between ES5, ES6, CoffeeScript, and different code conventions across those projects.

The tools are there now to automate all difference away - it’s just a matter of picking defaults and stringing those tools together. That’s what Invig does. After successfully running Invig on your codebase, you can put your brain at ease thanks to uniformity, focus more on the work at hand, have a better time doing so thanks to syntactical goodness, while producing less bugs thanks to ESlint.

Why ditch ES5?

ES6 let’s you express yourself in more powerful ways, typically meaning less boilerplate and more readable code.

Why ditch CoffeeScript?

While CoffeeScript lovers might agree already that uniform styling is pleasant and that ES6 is an upgrade over ES5, they might feel there are still a number of syntactical advantages CoffeeScript offers, missing from ES6. Our benchmark demo even results in lengthier ES6 code(!). While that may be true:

Demo

Let’s take a look at installing Invig at converting CoffeeScript to Standard compatible ES6 via STDIN

Install

Invig is meant to be run on a code base once (or a few times in one session). That’s why it should not be used as a dependency but be installed globally instead.

npm install invig --global 

Use

⚠️ WARNING Changes are made in-place, make sure your code is protected by version control before using Invig.

Recursively port CoffeeScript/ES5 files to ES6 in-place:

invig -s ./src

Command line arguments

Usage: invig [options]

Options:

  -h, --help       output usage information
  -V, --version    output the version number
  -s, --src <dir>  Directory, file or pattern to convert
  -b, --bail       Abort on the first error instead of continuing to port next file
  -c, --check      When done, hunt for unused and un-updated dependencies
  -q, --quiet      Hide any output

More Examples

Port one ES5 file to ES6:

invig --src old-file.js

Port one CoffeeScript file to ES6 (deleting the old .coffee file.):

invig --src old-file.coffee

Optionally check for outdated or unused dependencies after the conversion completes:

invig --src src/ --check

Bail out as soon as Invig hits an error. By default Invig will continue processing the next file

invig --src src/ --bail

Do a dry run without changing any files (don’t trust me, keep your stuff safe in Git):

invig --src src/ --dryrun

Apply Invig on a pattern (use quotes!)

invig --src 'src/**.js'

Transpile from STDIN

cat old-file.coffee | invig --src -

Workflow

The recommended way to use Invig is to:

  1. Be in master and have a clean Git working tree first
  2. git checkout -b es6
  3. Run Invig on your repo, point it to wherever your legacy sources live
  4. Apply manual fixes where the automation falls short (Invig and your build & test suite will tell you)
  5. Inspect the Git diff (I recommend the GitHub Desktop app for inspecting Invig’s changes, even if you are a cli-god. Can’t stress this enough) and repeat step 3 & 4
  6. Commit, push, send a PR for your es6 branch
  7. Have someone review the PR and merge it
  8. Let’s celebrate that your codebase is now very much 2017 🍸

State

Invig is young, but as long as your code is in Git, feel free to have some fun with it, Invig has already ported some very large codebases.

Pre-1.0.0, we’re allowing ourselves to make breaking changes at any release.

Gotchas

Thanks to

I deserve no credit, Invig is just a tiny wrapper around these mastodons:

Invig in the Wild

Projects where Invig is used to breathe new life into old codebases:

Todo & Changelog

Please see CHANGELOG.md.

Contributing

Please see CONTRIBUTING.md.

Social Media

Welcoming discussion on:

Authors & Contributors

License

Copyright (c) 2017 Kevin van Zonneveld. Licenses under MIT.

On GitHub

We'd love to hear what you think on GitHub. Here's what's been going on recently.

Loading...


Website design based on the wonderful apex.run with the author's consent.