GOV.UK Lint

This repo configures various linters to comply with our style guides.

Supported languages

We maintain a set of tasks for linting and sanity checks in the gds-operations/puppet-syntax repository.

To use, include govuk-lint in your Gemfile and run:

bundle exec govuk-lint-ruby <files and directories>

It's best to lint just your app directories and not those belonging to the framework, e.g.

bundle exec govuk-lint-ruby app lib spec

Useful options:

-a: Auto-correct violations if possible
-R: Also run Rails-specific cops
--diff: Only lint lines that have been changed in the current diff
--cached: Used with --diff to lint only lines changed between origin/master and HEAD.

See more options in the rubocop README.

You can enable RSpec cops by adding the following line to the .rubocop.yml file in your project:

require: rubocop-rspec

To use, include govuk-lint in your Gemfile and run:

bundle exec govuk-lint-sass <directory or file>
bundle exec govuk-lint-sass app/assets/stylesheets

When linting your app any assets within vendor will be ignored by default.

Auto-correction and --diff mode are unavailable.