marcopashkov / sublimerepl

SublimeREPL - run an interpreter inside ST2 (Clojure, CoffeeScript, F#, Groovy, Haskell, Lua, MozRepl, NodeJS, Python, R, Ruby, Scala, shell or configure one yourself)

SublimeREPL for SublimeText2

If you would like to donate to support SublimeREPL development, you can do so using GitTip or PayPal. Someone willing to take care of documentation would also be very welcome :-)

Features

Common

• Run an interpreter (REPL) inside SublimeText2 view/tab.
• Per-language persistent REPL history.
• Easily evaluate code in the running REPL
• Replace your current build system, and use stdin in your programs.
• Rich configuration with platform specific settings, project/file dependent environment variables and sane defaults.

Python

• Launch python in local or remote(1) virtualenv.
• Quickly run selected script or launch PDB.
• Use SublimeText2 Python console with history and multiline input.

(1) - (ssh, linux/osx only)

Screenshots

Running python code in SublimeREPL

R on Windows

Videos

• Python & virtualenv over SSH
• SBT integration demo

Installation

1. Install Package Control. http://wbond.net/sublime_packages/package_control
2. Install SublimeREPL
3. Preferences | Package Control | Package Control: Install Package
4. Choose SublimeREPL
5. Restart SublimeText2
6. Configure SublimeREPL (default settings in Preferences | Package Settings | SublimeREPL | Settings - Default should be modified in Preferences | Package Settings | SublimeREPL | Settings - User, this way they will survive package upgrades!

Documentation

Very basic documentation will soon be available on RTD: http://sublimerepl.readthedocs.org/

Getting started

• Create or open your file with code.
• Menu / Tools / Command Palette (OS X: ⇧⌘P) then type "SublimeREPL" and select the approperiate language.
• Menu / View / Layout / Rows: 2 (OS X: ⌥⇧⌘2).
• Menu / View / Move File to Group / Group 2 (⌃⇧2).

Keybindings

• Evaluate in REPL:
• ⌃+,, s Selection
• ⌃+,, f File
• ⌃+,, l Lines
• ⌃+,, b Block
• Transfer in REPL (just copy, without evaluating it):
• ⌃⇧+,, s Selection
• ⌃⇧+,, f File
• ⌃⇧+,, l Lines
• ⌃⇧+,, b Block

Note: ⌃+,, f means: press Ctrl and Comma, release all, press F.

License and Price

Since version 1.2.0 SublimeREPL is licensed under GPL. Previous versions were licensed under BSD. If you're using SublimeREPL in commercial environment a donation is strongly encouraged ;-)

Compatibility

SublimeREPL is developed against the latest dev build of SublimeText2, mostly on Windows7 x64 and Linux Mint 13. From time to time it's tested on Mac OSX as well.

I try to make it cross-platform, but from time to time some functions will be platform specific.

FAQ

1. Is this a terminal emulator?

No. Shell (cmd.exe/bash) REPL can be used for simple tasks (file creation, git init etc.) but anything terminal like (mc, ipython, vim) will not work! SublimeREPL has a sister project: SublimePTY that aims to bring real terminal emulator to SublimeText2.