krasimir/hopa

Zero config CLI for running JavaScript/TypeScript files

Zero config JavaScript/TypeScript runner
right in your terminal

Features

• Zero configuration 🚀
• Transpiles and runs JavaScript and TypeScript ⚙️
• Single-folder file browser 📁

What and Why

Hopa is a command line tool that does the following:

1. Reads the current directory and lets you choose a file.
2. Transpiles the file and produces a valid JavaScript bundle. It uses Rollup so it does resolve your imports.
3. Runs the generated bundle via node and shows you the result.
4. It also runs a watcher so changing the files will trigger new compilation.

I did this little tool because I'm tired of creating dummy repos, copying webpack files, switching between terminal and browser just so I can run some "modern" JavaScript. I know about solution like CodeSandbox and CodePen but I want specifically to exercise my code in the terminal. And I want to do it quick, without configuring stuff like Babel and Webpack.

More about the story here https://krasimirtsonev.com/blog/article/hopa-javascript-typescript-runner.

Installation

npm i hopa -g

Usage

Go to the folder that contains your files and run hopa.

> hopa

This will display a menu and you have to pick a file. You'll get transpilation, bundling, running and watching.

> hopa -i script.js -o bundle.js -m

Gets script.js, transpiles it and bundle it to a new file called bundle.js which is also minified. No watching in this case. It's a single-shot operation. -m and -o are optional. If the output is not specified Hopa creates a file with name bundle.<your file>. Have in mind that this feature is experimental. I find that in some cases Hopa can't resolve properly modules and errors out.

Demo

hopa's Issues

Error quickly flashes before each run if no tsconfig found

I'm using hopa for js, not ts, so I don't have a tsconfig file. On each save, I see the following error for like half a second before it starts running my file:

Specify filename in cmd

I would love it if I could do something like hopa index.js to just go straight to running file.

Uncaught ReferenceError: exports is not defined

So I am using this to convert browser libraries, to a single bundle, but I have noticed that the following shows up:

Uncaught ReferenceError: exports is not defined

I have seen this on EVERY other program that compiles to browser, is there anything I can do to fix this? I am using TypeScript to write the modules, then creating a single bundle that I can then load into the browser?

Thanks,

CMD line dies on use

• Windows 10 command line
• in a folder containing "go.js"
• which contains console.log("hello");

I run

c:\myfolder>hopa

I select go.js

The command line window closes (I assume the process dies).

Terminal doesn't reset after exiting hopa

When you run hopa, and then exit hopa, either through the menu or via ctrl+c, the terminal does not reset properly.

I have tested this on both windows and macos and have experienced different effects, most notably duplicated keystrokes on windows and being unable to scroll through the terminal on macos.

Running reset on macos fixes the issue

Weird Indentation Issue

Can't scroll through log

If you print out a lot onto the log (in my case, I wanted to console.log a large object), you can't scroll up to see the entire contents of the log.

Missing line break after error

If a file I select throws an error, then you break (Ctrl+C), your terminal continues on the same line as the end of the error. There should be a line break after the error.