REPL

REPL is a simple bash script for creating and running self-deleting programs locally, offline, and out of the browser.

Why REPL? Take a look at our vision for this project.

REPL is now in Beta.

Repls are saved to the OS's /tmp folder. This means that you don't have to worry about managing the files. The OS will delete them automatically when you shut down your computer!

Getting Started

Install Script ( Linux/macOS )

REPL is installed through the terminal with the following command:

curl -o- https://raw.githubusercontent.com/repl-cli/REPL/v0.12.0/install.sh | bash

That's it!

_{The script clones to ~/.repl and adds it to your PATH. You may have to restart your shell.}

During installation REPL will attempt to configure the PATH. Because of differences between platforms, command shells, and bugs in REPL, the modifications to PATH may not take effect until the console is restarted, or the user is logged out, or it may not succeed at all.

If, after installation, running repl status in the console fails, this is the most likely reason.

Manual Install

Run cd ~
Run git clone https://github.com/repl-cli/REPL.git .repl
Add the installation directory to your PATH

To add REPL to your PATH, add the following to your .bashrc, .zshrc, or .profile:

export PATH="$HOME/.repl/bin:$PATH"

_{Advanced Windows Users: I've received news that REPL works with Git Bash on Windows. The /tmp directory in git bash redirects to C:\Users\<user>\AppData\Local\Temp.}

Using REPL

REPL is fairly simple to use, but if you want more details check out the docs.

NOTICE: REPL uses nano by default. I highly suggest changing this to your favorite editor before your first use:

For example, changing the editor to VS Code:

repl config editor code

To start a new repl, run repl <lang>, where <lang> is the file extension for the programming language you'd like to use.

Example:

repl js

REPL will open your editor set in the config file. You can configure this to your liking. To run your repl, go back to the terminal and run:

repl run

REPL already knows which repl you last opened and it will run the repl for you. No need to worry about compilation or using the correct runtime for each language!

If time passes and you forget which repl you are on, simply run:

repl status

To list the currently supported languages, run:

repl languages

Check out our list of supported languages, and their file extensions, below.

Configuring REPL

You can configure REPL by editing the config file in the source folder.

To change the editor that REPL uses, edit the EDITOR= field:

EDITOR="code"

You can also change which compilers are used by REPL:

C_COMPILER="clang"

NOTICE: The config file is a bash script. Make sure there are no spaces before, and after, the equals sign, =.

If you break the config file and you're not sure how to fix it, you can copy the contents of config.default over to config to reset it.

Supported Languages

C (c)
C++ (cpp)
C# (cs)
Go (go)
Java (java)
JavaScript (js)
Python (py)
Ruby (rb)
Rust (rs)
Swift (swift)
Typescript (ts)

_{You must have the necessary compilers/runtimes installed (e.g., node.js for JavaScript or rustc for Rust). Edit the config file to configure the compilers/runtimes that REPL uses.}

Can't find your programming language? Let us know in a new issue, or better yet, submit it in a pull request! :)

Contributing

Was REPL useful to you? Maybe you just like the project? Donate a star :)

Check out our Contributing Guidelines if you'd like to help out with the project (including adding new language support!).

I'm far from a bash expert, so any and all help is much appreciated! That includes anyone who can test REPL in a variety of configurations and environments (i.e., lesser used compilers and/or Linux distros).

Below are some ideas for the project. If you'd like to start a conversation regarding anything below, or anything in general, feel free to open a new issue!

To-Do / Ideas

Copyright

REPL is released under an MIT license; see LICENSE for details.

I want to dedicate this section to acknowledge the help and inspiration this project received from other FOSS projects. REPL wouldn't be what it is without them!