shelljs-transpiler

shelljs-transpiler

"Say goodbye to those gnarly Bash scripts!" -- @arturadib, ShellJS README

Want to try out ShellJS but don't want to go through the effort of porting all your scripts? Look no further.

Automagically transpile your Bash scripts to ShellJS. Try it out here on the web, no downloads necessary. Just type, copy-paste, or drag-and-drop your favorite shell script and copy out the generated results.

Have a lot of scripts to transpile? Clone this repository to make use of the transpile.js executable to programmatically transpile your scripts. Check out the Building the project section below for installation steps.

Think this is cool?

Let me know by giving it a star on Github.

Think this is really cool? :sunglasses:

Contributions would be awesome! I'd really like to propel this project forward, but don't have much time. You can help me out by:

• sending me scripts you'd like to be able to translate, but haven't been able to
• finding bugs
• helping refactor the grammar
• taking up one of the help-wanted issues
• spreading the word (more awareness = more contributors)

ShellJS compatibility

What version of ShellJS is this compatible with? Can I run this code? Will this translate anything correctly?

These are good questions... to which I have no good answer.

I'm currently helping maintain ShellJS. Whenever I see something that's easier to do in Bash than in ShellJS, I usually brainstorm a new syntax for how to put it in the package. Eventually, I even get around to implementing it upstream.

This means I usually write this translator for "what I see ShellJS becoming" instead of what ShellJS currently is. This is mostly compatible with ShellJS v0.7+. If you'd like to try running a translation, the latest version of ShellJS is your best bet.

Getting Ohm to work in Node and the browser

Check out nfischer/ohm-builder to see how I did it.

Contributing

As stated above, contributions are welcome! If you're interested in helping out, let me know by posting an issue or shooting me an email.

Building the project

This project uses gulp as its task-runner. It also depends on a git submodule and some npm packages. Install it all via:

$ git clone --recursive https://github.com/nfischer/shelljs-transpiler.git
$ cd shelljs-transpiler/
$ npm install -g gulp-cli
$ npm install
$ gulp # Compiles src/index.generator.html -> ./index.html