Code Climate Sass-Lint Engine

Have you ever wanted to know exactly how good you are at writing consistent Sass? Well, look no more! By using this Code Climate engine, you can harness the power of sass-lint to score your code.

Notice: Sunset on 2021-11-19

No one maintains sass-lint anymore. It's been this way since October 2017. As such, I am sunsetting this project and archiving it on GitHub. In the future, if someone revives the library, this can come out of sunset. But for now it's not worth the maintenance burden to maintain an unchanging piece of software.

Want to Help?

Awesome! We strive to be welcoming to everyone. Check out the contributing guide and make sure to read our code of conduct.

Need Some Help?

For help with Sass-lint, check out their documentation.

If you're running into a Code Climate issue, first check out our engine documentation and look over any existing issues, as your question may have already been covered. If not, please open an issue and we'll see what we can do to help.

Installation

Since this isn't a publicly released engine yet, you will have to build the engine from this repository. You will need the Code Climate CLI installed, as well as the git and make commands.

If you haven't already, install the Code Climate CLI.
If you do not have Git, install it.
If you do not have make, install it. On a Mac, you can get it with XCode. On Linux, you can get it in your package manager (the build-essential package in Ubuntu or base-devel package on Arch linux). On Windows, you probably need Cygwin or the Linux Subsystem for Windows.
Make the engine's Docker container with make.

If the container fails to build, file an issue.

You should now be able to use the engine through the Code Climate CLI as a development-level engine. To use it on your project, first navigate to your project's directory. Then use the following command:

$ codeclimate analyze -e sass-lint --dev

Usage

Like other Code Climate engines, you configure this one through the use of a .codeclimate.yml file in your project's root directory. If you don't already have one, you can use the codeclimate engines:enable sass_lint command to generate a basic .codeclimate.yml file with the engine enabled.

If you don't care to tweak your configuration, you should now be able to run the engine with the analyze command:

$ codeclimate analyze

To tweak the rules that Sass-Lint will run, follow this pattern in the configuration file:

engines:
  sass-lint:
    enabled: true
    config:
      file: my_custom_sass_lint.yml
    debug: true
    rules:
      indentation:
        - 2
        - size: 2
exclude_paths:
  - ignored_directory/

Most of the configuration lives under the engines.sass-lint key. The options are as follows:

config.file - The Sass-Lint configuration file you want to use as a base.
debug - Set this to true to output timing and debug information from the engine.
rules - Configure this in the same way you configure rules in .sass-lint.yml. These will override any settings you have in your configuration file.
Global configuration like exclude_paths is also included in the engine's configuration. See the Code Climate documentation for more information.

Versioning

This engine is versioned based on the versioning scheme of Sass-Lint. It uses the version of the Sass-Lint library that is installed as the base version and then adds a build number. For example, the first time the engine is built and released for the 0.23.1 version of Sass-Lint, the engine's version is 0.23.1-1. If there are any bugs that are fixed in the engine without updating the Sass-Lint version, the build number will be incremented (e.g. to 0.23.1-2).

License

The engine is available as open source under the terms of the MIT License.

michaelherold/codeclimate-sass-lint