SublimeLinter-contrib-scalac

This linter plugin for SublimeLinter provides an interface to scalac. It will be used with files that have the “scala” syntax.

IMPORTANT!

Please note that because scalac requires a complete directory context in order to work, this linter plugin currently will only lint a file when it has been saved. As soon as you modify the file, all linter marks will be cleared.

Installation

SublimeLinter 3 must be installed in order to use this plugin. If SublimeLinter 3 is not installed, please follow the instructions here.

Linter installation

Before using this plugin, you must ensure that scalac is installed on your system. scalac is part of the scala developer SDK, which can be downloaded here.

Note: This plugin requires Scala 2.9.1 or later.

Linter configuration

In order for scalac to be executed by SublimeLinter, you must ensure that its path is available to SublimeLinter. Before going any further, please read and follow the steps in “Finding a linter executable” through “Validating your PATH” in the documentation.

Once you have installed and configured scalac, you can proceed to install the SublimeLinter-contrib-scalac plugin if it is not yet installed.

Plugin installation

Please use Package Control to install the linter plugin. This will ensure that the plugin will be updated when new versions are available. If you want to install from source so you can modify the source code, you probably know what you are doing so we won’t cover that here.

To install via Package Control, do the following:

1. Within Sublime Text, bring up the Command Palette and type install. Among the commands you should see Package Control: Install Package. If that command is not highlighted, use the keyboard or mouse to select it. There will be a pause of a few seconds while Package Control fetches the list of available plugins.

2. When the plugin list appears, type scalac. Among the entries you should see SublimeLinter-contrib-scalac. If that entry is not highlighted, use the keyboard or mouse to select it.

Settings

For general information on how SublimeLinter works with settings, please see Settings. For information on generic linter settings, please see Linter Settings.

In addition to the standard SublimeLinter settings, SublimeLinter-contrib-scalac provides its own settings. Those marked as “Inline Setting” or “Inline Override” may also be used inline.

lint

Valid rules for the lint option depend on the version of Scala you have installed. Options with a check in the Default column are enabled by default:

For example, to enable numeric-widen and deprecation, you would add this to the linter settings:

"scalac": {
    "lint": "numeric-widen,deprecation"
}

Or as a list:

"scalac": {
    "lint": [
        "numeric-widen",
        "deprecation"
    ]
}

To enable feature and disable doc-detached but keep the rest of the settings, you would put this comment on the first or second line of the file:

// [SublimeLinter scalac-lint:+feature,+-doc-detached]

classpath

If you specify classpath, the linter plugin will use the given entries as input to scalac -classpath.

With an sbt project, you can get your full classpath by running

sbt 'export fullClasspath'

You may specify classpath as a string:

"scalac": {
    "classpath": "${project}/target/scala-2.11/classes:${project}/lib/lib.jar"
}

Or as a list:

"scalac": {
    "classpath": [
        "${project}/target/scala-2.11/classes",
        "${project}/lib/lib.jar"
    ]
}

classpath_filename

If you specify classpath_filename, the linter plugin will search for a file with that name in the project directory and its parents. If found, it will use the contents of that file with scalac -classpath for linting.

If both classpath and classpath_filename are specified, their values will be merged.

The contents of the file must be a colon-delimited list of paths for the JVM to search during compilation. For example:

/path/to/project/classes:/path/to/project/libs/lib.jar

You can also add whitespace between classpath entries for better readability:

:/path/to/project/classes
:/path/to/project/libs/lib.jar

target_directory

This setting tells scalac where to put generated class files. The plugin will create the directory if it does not already exist.

For example:

"scalac": {
    "target_directory": "${project}/target/scala-2.11/classes"
}

If target_directory is unset, class files will be put in the same directory as their source files.

Contributing

If you would like to contribute enhancements or fixes, please do the following:

1. Fork the plugin repository.
2. Hack on a separate topic branch created from the latest develop.
3. Commit and push the topic branch.
4. Make a pull request.
5. Be patient. ;-)

Please note that modifications should follow these coding guidelines:

• Indent is 4 spaces.
• Code should pass flake8 and pep257 linters.
• Vertical whitespace helps readability, don’t be afraid to use it.
• Please use descriptive variable names, no abbrevations unless they are very well known.

IMPORTANT!

Also note that this repository uses overcommit as a validation tool. Before making any changes, please install overcommit in your local repository.

Thank you for helping out!