Erl is a plugin for the text editor Sublime Text 3. It allows you to:
- Benefit from Code Completion (all Erlang libs + your current project)
- Allows you to Auto-Indent your Erlang code
- Run Eunit tests (all tests for module/single test)
- Run Common Tests (all tests for module)
- Run Dialyzer tests (single module)
- Goto any exported function of your project easily
- Access man pages from the text editor
All within your test editor. A brief feature introduction video can be seen here.
- Code Completion: Just type and select available options
- Auto-Indenting: hit
Command-Option-L
to auto-intent an entire file - Run single Eunit: position your cursor anywhere within your test function and hit
Command-Shift-F8
- Run all Eunit tests in file: position your cursor outside any test function and hit
Command-Shift-F8
- Run all CT tests in file: view the file and hit
Command-Shift-F8
- Run Dialyzer on file: view the file and hit
Command-Shift-F9
- Re-Run the previous test: hit
Command-F8
( you do not need to be viewing the test to launch it ) - View Common Tests results in browser: hit
Command-Option-F8
(OSX) |Command-Alt-F8
(Linux/Win) - Goto any exported function of your project easily: hit
Command-Option-p
(OSX) |Command-Alt-p
(Linux/Win) and select a function - To access man pages: hit
Command-Option-i
(OSX) |Command-Alt-i
(Linux/Win) and select a module
Erl currently supports only on OSX and Linux (may work in Windows, but not tested). There are 3 ways to install it:
Erl's latest stable versions are pushed automatically to the package control.
Go to your Sublime Text 3 Packages
directory:
- OS X:
~/Library/Application Support/Sublime Text 3/Packages
- Linux:
~/.Sublime Text 3/Packages/
and clone the repository using the command below:
$ git clone https://github.com/23ua/Erl.git
Erl needs and will try to detect the paths of the following executables: rebar, erl, escript and dialyzer. If it doesn't succeed to find those, or if you prefer to manually configure these path, you can set them in the Erl.sublime-settings
file, located in the Erl
plugin directory.
To use Erl, you need to have:
- Sublime Text 3
- Erlang
- Rebar
- Erlang man pages (optional)
To unleash the full power of the plugin, you will also need to comply to:
- OTP standards (i.e. have your project defined according to OTP Directory Structure).
- Rebar's conventions.
TL;DR: it basically means to organize your project structure using:
-- myproject
|-- ebin
|-- src
|-- myproject.app.src
|-- test
|-- ...
or, for example, a more complex project structure defined in rebar.conf:
-- myproject
rebar.config
|-- apps
|-- app1
|-- app2
|-- deps
|-- dep1
|-- dep2
|-- ...
- Add snippets
- Add REPL
- Highlight erlang configurations
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request