This project provides integration with ENSIME and Sublime Text Editor. (Supports both Sublime Text 2 and 3) It has recently moved to the Ensime project and is in the process of being re-enlivened - so watch this space.
06.07.2015: Better completions and ST 3 Support
More work to make completions work better. We also support now support ST 3, see updated instructions.
Now to make it deployed with Package Control...
29.06.2015: It lives a little more
More stabilisation - slightly simpler startup instructions (it works out the .ensime port file for itself).
Lots more to do...
19.06.2015: It lives
We now have a version that starts and works (at least for some bits) - you need to follow the 'getting it going'
steps below carefully, all other startup options will fail right now.
Have fun, come and join the party and hack on Ensime-Sublime
11.06.2015: Project moved to Ensime organisation.
With the kind permission of the original authors this project has been moved under the Ensime umbrella.
It is currently in a non-working state. Please ignore the below instructions - we are working on bringing
it up to date and into a workable state as soon as possible - watch this space!
This is a beta version. It has been hacked to get it working against an up to date Ensime, but many things are likely to be broken. Jump to source and error hightlight have been seen to work at least once ;) Please submit issues to our tracker: https://github.com/ensime/ensime-sublime/issues/new
As mentioned above we are in the process of bringing this project back to life - it works (well we think it does) but you have to jump through a bunch of hoops to get it working.
- Install Sublime Text 2 (work need )
- Clone this project (lets return to this as $PLUGIN)- Use ST3 branch for Sublime Text 3
- ST2
- ST2 - Symlink
~/Library/Application Support/Sublime Text 2/Packages/Ensime
(Mac) or/.config/sublime-text-2/Packages/Ensime
(linux) to $PLUGIN - ST3 - Symlink
~/Library/Application Support/Sublime Text 3/Packages/Ensime
(Mac) or/.config/sublime-text-3/Packages/Ensime
(linux) to $PLUGIN
- ST2 - Symlink
- Restart Sublime
Later the plugin will be deployed using Package Control, but that is on the todo list.
- Checkout your project into $PROJECT
- Add the Ensime sbt plugin to the project or to your user sbt configuration (see https://github.com/ensime/ensime-server/wiki/Quick-Start-Guide) for details of installing the plugin - ignore the Emacs bits.
- run
sbt gen-ensime
to create a.ensime
file
- Open Ensime plugin's configuration at
Preference -> Package Settings -> Ensime -> Settings -> User
. - Add the below entires to the file (by replacing $PROJECT with the path)
{
"connect_to_external_server": true,
}
- Run the following command at the terminal (it works with both linux and mac). It starts an ensime instance for your project.
$ $PLUGIN/serverStart.sh $PROJECT/.ensime
Note that, before starting server, please install grealpath
utility (e.g., brew install coreutils
) if it does not exist in your meachine.
- In Sublime, create a new window and within it do
Project -> New Project
and select $PROJECT as the root. - Open the Sublime command palette (typically bound to
Ctrl+Shift+P
on Windows/Linux andCmd+Shift+P
on Mac) and typeEnsime: Startup
.
With luck - if you open a scala file in your project, you should hav error highlighting (on save) and jump to definition working!
-
Supports scala 2.9-2.11
-
Creates and understands
.ensime
projects (maximum one project per Sublime window, if you have a project with multiple subprojects only a single subproject will be available at a time). -
Integrates with SBT to generate Ensime projects from SBT projects and provides a command, which runs SBT compilation for the current Ensime project.
-
Once your Ensime project is configured (we have a helper for that) and Ensime is run, Scala files in that Ensime project benefit from a number of semantic services:
-
On-the-fly typechecking and error highlighting on save. Error messages are displayed in the status bar when you click highlighted regions (unfortunately, Sublime Text 2 doesn't support programmable tooltips). Moreover, errors can be viewed in a dynamically updated buffer displayed with
Tools > Ensime > Commands > Show notes
. -
Type-aware completions for identifiers (integrates into the built-in mechanism of completions in Sublime Text 2, depending on your configuration it might be bound to
Ctrl+Space
/Cmd+Space
orTab
). -
Type-aware go to definition (implemented by
ensime_go_to_definition
command: bind it yourself to your favorite hotkey or use the defaultCtrl+Click
binding on Windows/Linux orCmd+Click
on Mac).
-
-
Implements experimental support for debugging. At the moment you can set breakpoints, create launch configurations, step through programs in the debugger, inspect program output, navigate stack traces and watch values of local variables. Things are far from smooth, but it might be worth a try.
-
By default Ensime customizes mouse bindings. It makes
Ctrl+Click
/Cmd+Click
invokeGo to Definition
andAlt+Click
stand forInspect Type at Point
. If you want to disable these bindings or change them bindings to something else, adjust the config atPreferences > Package Settings > Mousemap - Default
. -
For Windows users, make sure the
Line Endings
setting is set toUnix
. You may do this by going toView > Line Endings
and selectingUnix
.
Open the Sublime command palette (typically bound to Ctrl+Shift+P
on Windows/Linux and Cmd+Shift+P
on Mac) and type Ensime: Startup
.
If you don't have an Ensime project, the plugin will guide you through creating it.
If you already have a project, an ENSIME server process will be started in the background,
and the server will initialize a resident instance of the Scala compiler.
After the server is ready, a message will appear in the left-hand corner of the status bar.
It will read either ENSIME
if the currently opened file belongs to the active Ensime project
or ensime
if it doesn't. Keep an eye on this message - it's an indicator of things going well.
If you find that some features of Ensime are not working properly (i.e. Go To Definition or Error Highlighting), then check the Line Endings
setting in Sublime Text. On Windows, the line endings is set to Windows
by default. Simply change this setting to Unix
by going to View > Line Endings
and selecting Unix
.
Submit issues on the tracker https://github.com/ensime/ensime-sublime/issues or come find us on the https://gitter.im/ensime/ensime-server Gitter channel