Skip to content

Latest commit

 

History

History
105 lines (72 loc) · 4.08 KB

README.md

File metadata and controls

105 lines (72 loc) · 4.08 KB
Raw

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
  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:
  • 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 unfortuneatly not possible right now.