Skip to content
This repository

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

Merge pull request #323 from MattDMo/master

Increased timeout to fix autocomplete bug w/ SublimeCodeIntel
latest commit f2b2a79140
Wojciech Bederski authored
Octocat-spinner-32 config Increased timeout to fix autocomplete bug w/ SublimeCodeIntel January 25, 2014
Octocat-spinner-32 doc Add OCaml support. October 29, 2013
Octocat-spinner-32 messages message to the people ;) July 07, 2013
Octocat-spinner-32 repllibs recover commit: move PyDbLite March 30, 2013
Octocat-spinner-32 repls getenv() workaround for bad SublimeText default environment January 19, 2014
Octocat-spinner-32 .gitignore Merge branch '496f9a1e31bbdd54a4a7' April 01, 2013
Octocat-spinner-32 .hgignore check if readthedocs will notice this change February 26, 2012
Octocat-spinner-32 .no-sublime-package PC should leave SublimeREPL unzipped. April 13, 2013
Octocat-spinner-32 Context.sublime-menu repl_restart - initial implementation July 01, 2013
Octocat-spinner-32 Default (Linux).sublime-keymap respect user's global auto_complete_commit_on_tab August 17, 2013
Octocat-spinner-32 Default (OSX).sublime-keymap respect user's global auto_complete_commit_on_tab August 17, 2013
Octocat-spinner-32 Default (Windows).sublime-keymap respect user's global auto_complete_commit_on_tab August 17, 2013
Octocat-spinner-32 Default.sublime-commands Remove trailing comma before closing bracket July 09, 2013
Octocat-spinner-32 GPL-LICENSE.TXT LICENSE ADJUSTMENT: BSD/MIT -> GPL!!!! September 16, 2012
Octocat-spinner-32 LICENSE-LIB.txt LICENSE ADJUSTMENT: BSD/MIT -> GPL!!!! September 16, 2012
Octocat-spinner-32 LICENSE.TXT LICENSE ADJUSTMENT: BSD/MIT -> GPL!!!! September 16, 2012
Octocat-spinner-32 Main.sublime-menu another attempt at enabling text transfers by default August 18, 2012
Octocat-spinner-32 README.md Update README.md December 29, 2013
Octocat-spinner-32 SublimeREPL (OSX).sublime-settings Comment default settings and add Package Settings menu March 10, 2012
Octocat-spinner-32 SublimeREPL.sublime-settings getenv() workaround for bad SublimeText default environment January 19, 2014
Octocat-spinner-32 __init__.py recover commit: make st3 branch st2 compatible March 30, 2013
Octocat-spinner-32 completions.py fix completions March 30, 2013
Octocat-spinner-32 foo.html Implement advanced OCaml utop REPL (autocompletion, etc). October 30, 2013
Octocat-spinner-32 lang_integration.py fix path in virtualenv/ipython January 19, 2014
Octocat-spinner-32 messages.json message to the people ;) July 07, 2013
Octocat-spinner-32 run_existing_command.py fix run_existing_window_command on ST3 July 23, 2013
Octocat-spinner-32 sublimerepl.py OCaml utop: implement highlighting of errors, fix handling of multili… October 30, 2013
Octocat-spinner-32 sublimerepl_build_system_hack.py recover commit: make st3 branch st2 compatible March 30, 2013
Octocat-spinner-32 sublimerepl_build_system_hack.sublime-build expose $project_* variables in REPL configs October 28, 2012
Octocat-spinner-32 text_transfer.py Merge pull request #294 from whitequark/master November 19, 2013
README.md

SublimeREPL for SublimeText (2 and 3)

Stories in Ready

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

Running python code in SublimeREPL

R on Windows

R on Windows

Videos

Installation

  1. Install Package Control. http://wbond.net/sublime_packages/package_control
  2. Install SublimeREPL
    1. Preferences | Package Control | Package Control: Install Package
    2. Choose SublimeREPL
  3. Restart SublimeText2
  4. 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:
    • ctrl+,, s Selection
    • ctrl+,, f File
    • ctrl+,, l Lines
    • ctrl+,, b Block
  • Transfer in REPL (just copy, without evaluating it):
    • ctrl+shift+,, s Selection
    • ctrl+shift+,, f File
    • ctrl+shift+,, l Lines
    • ctrl+shift+,, b Block

Note: ctrl+,, 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 SublimeText3. Ubuntu 13.04 is main target platform with OSX closely after. Windows is tested from time to time.

Sublime Text 2 compatibility is maintained where possible, but it's not a priority.

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, vim) will not work! SublimeREPL has a sister project: SublimePTY that aims to bring real terminal emulator to SublimeText2.

2. Is IPython supported?

Yes, with autocompletion and some windowed %pylab. Inline %pylab is unfortunately not possible right now.

Something went wrong with that request. Please try again.