mirror of
https://github.com/super-linter/super-linter.git
synced 2024-11-26 16:10:58 -05:00
286 lines
7.9 KiB
Markdown
286 lines
7.9 KiB
Markdown
# Disabling linters and rules
|
|
If you find you need to ignore certain errors and warnings, you will need to know the format to disable the linter rules.
|
|
Below is examples and documentation for each language and the various methods to disable.
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Ruby
|
|
- [Rubocop](https://github.com/rubocop-hq/rubocop)
|
|
|
|
### Rubocop Config file
|
|
- `.github/linters/.ruby-lint.yml`
|
|
- You can pass multiple rules and overwrite default rules
|
|
- File should be located at: `.github/linters/.ruby-lint.yml`
|
|
- **Note:** We use the Default **GitHub** Rule set from [Rubocop-GitHub](https://github.com/github/rubocop-github)
|
|
|
|
### Rubocop disable single line
|
|
```ruby
|
|
method(argument) # rubocop:disable SomeRule, SomeOtherRule
|
|
```
|
|
|
|
### Rubocop disable code block
|
|
```ruby
|
|
# rubocop:disable
|
|
This is a long line
|
|
var="this is some other stuff"
|
|
# rubocop:enable
|
|
```
|
|
|
|
### Rubocop disable entire file
|
|
If you need to ignore an entire file, you can update the `.github/linters/.ruby-lint.yml` to ignore certain files and locations
|
|
|
|
```yml
|
|
inherit_from:
|
|
- .rubocop_todo.yml
|
|
- .rubocop_app_overrides.yml
|
|
|
|
inherit_mode:
|
|
merge:
|
|
- Exclude
|
|
|
|
Rails:
|
|
Enabled: true
|
|
|
|
AllCops:
|
|
TargetRubyVersion: 2.5.1
|
|
EnabledByDefault: true
|
|
Exclude:
|
|
- 'db/**/*'
|
|
- 'config/**/*'
|
|
- 'script/**/*'
|
|
- 'bin/{rails,rake}'
|
|
- !ruby/regexp /old_and_unused\.rb$/
|
|
```
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Shell
|
|
**Shellcheck** is an opensource tool we use for linting and validation of the shell scripting language.
|
|
- [Shellcheck](https://github.com/koalaman/shellcheck)
|
|
|
|
### Shellcheck Config file
|
|
- There is no top level *configuration file* available at this time
|
|
|
|
### Shellcheck disable single line
|
|
```bash
|
|
echo "Terrible stuff" # shellcheck disable=SC2059,SC2086
|
|
```
|
|
|
|
### Shellcheck disable code block
|
|
```bash
|
|
# shellcheck disable=SC2059,SC2086
|
|
echo "some hot garbage"
|
|
echo "More garbage code"
|
|
```
|
|
|
|
### Shellcheck disable entire file
|
|
- **Note:** The disable must be on the second line of the code right after the shebang
|
|
```bash
|
|
#!/bin/sh
|
|
# shellcheck disable=SC2059,SC1084
|
|
|
|
echo "stuff"
|
|
moreThings()
|
|
```
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Ansible
|
|
### Ansible-lint Config file
|
|
### Ansible-lint disable single line
|
|
### Ansible-lint disable code block
|
|
### Ansible-lint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## YAML
|
|
- [YamlLint](https://github.com/adrienverge/yamllint)
|
|
|
|
### Yamllint Config file
|
|
- `.github/linters/.yaml-lint.yml`
|
|
- You can pass multiple rules and overwrite default rules
|
|
- File should be located at: `.github/linters/.yaml-lint.yml`
|
|
|
|
### Yamllint disable single line
|
|
```yml
|
|
This line is waaaaaaaaaay too long # yamllint disable-line
|
|
```
|
|
|
|
### Yamllint disable code block
|
|
```yml
|
|
# yamllint disable rule:colons
|
|
- Lorem : ipsum
|
|
dolor : sit amet,
|
|
consectetur : adipiscing elit
|
|
# yamllint enable
|
|
```
|
|
|
|
### Yamllint disable entire file
|
|
If you need to ignore an entire file, you can update the `.github/linters/.yaml-lint.yml` to ignore certain files and locations
|
|
```yml
|
|
# For all rules
|
|
ignore: |
|
|
*.dont-lint-me.yaml
|
|
/bin/
|
|
!/bin/*.lint-me-anyway.yaml
|
|
|
|
rules:
|
|
key-duplicates:
|
|
ignore: |
|
|
generated
|
|
*.template.yaml
|
|
trailing-spaces:
|
|
ignore: |
|
|
*.ignore-trailing-spaces.yaml
|
|
/ascii-art/*
|
|
```
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Python3
|
|
### Pylint Config file
|
|
### Pylint disable single line
|
|
### Pylint disable code block
|
|
### Pylint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## JSON
|
|
### JsonLint Config file
|
|
### JsonLint disable single line
|
|
### JsonLint disable code block
|
|
### JsonLint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Markdown
|
|
- [Markdownlint-cli](https://github.com/igorshubovych/markdownlint-cli#readme)
|
|
- [Markdownlint rules](https://awesomeopensource.com/project/DavidAnson/markdownlint)
|
|
|
|
### Markdownlint Config file
|
|
- `.markdown-lint.yml`
|
|
- You can pass multiple rules and overwrite default rules
|
|
- File should be located at: `.github/linters/.markdownlint.yml`
|
|
|
|
### Markdownlint disable single line
|
|
```markdown
|
|
## Here is some document
|
|
Here is some random data
|
|
<!-- markdownlint-disable -->
|
|
any violation you want
|
|
<!-- markdownlint-restore -->
|
|
Here is more data
|
|
```
|
|
### Markdownlint disable code block
|
|
```markdown
|
|
## Here is some document
|
|
Here is some random data
|
|
<!-- markdownlint-disable -->
|
|
any violations you want
|
|
<!-- markdownlint-restore -->
|
|
Here is more data
|
|
```
|
|
|
|
### Markdownlint disable entire file
|
|
- You can encapsulate the entire file with the *code block format* to disable an entire file from being parsed
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Perl
|
|
### Perl Config file
|
|
### Perl disable single line
|
|
### Perl disable code block
|
|
### Perl disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## XML
|
|
- [XML](http://xmlsoft.org/)
|
|
|
|
### LibXML Config file
|
|
- There is no top level *configuration file* available at this time
|
|
|
|
### LibXML disable single line
|
|
- There is currently **No** way to disable rules inline of the file(s)
|
|
|
|
### LibXML disable code block
|
|
- There is currently **No** way to disable rules inline of the file(s)
|
|
|
|
### LibXML disable entire file
|
|
- There is currently **No** way to disable rules inline of the file(s)
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Coffeescript
|
|
### coffeelint Config file
|
|
### coffeelint disable single line
|
|
### coffeelint disable code block
|
|
### coffeelint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Javascript (eslint)
|
|
### Javascript eslint Config file
|
|
### Javascript eslint disable single line
|
|
### Javascript eslint disable code block
|
|
### Javascript eslint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Javascript (standard)
|
|
### Javascript standard Config file
|
|
### Javascript standard disable single line
|
|
### Javascript standard disable code block
|
|
### Javascript standard disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Typescript (eslint)
|
|
|
|
### Typescript eslint disable single line
|
|
### Typescript eslint disable code block
|
|
### Typescript eslint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Typescript (standard)
|
|
### Typescript standard Config file
|
|
### Typescript standard disable single line
|
|
### Typescript standard disable code block
|
|
### Typescript standard disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Golang
|
|
### golangci-lint standard Config file
|
|
### golangci-lint disable single line
|
|
### golangci-lint disable code block
|
|
### golangci-lint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|
|
## Dockerfile
|
|
-[dockerfilelint](https://github.com/replicatedhq/dockerfilelint.git)
|
|
|
|
### Dockerfilelint standard Config file
|
|
- `.github/linters/.dockerfilelintrc`
|
|
- You can pass multiple rules and overwrite default rules
|
|
- File should be located at: `.github/linters/.dockerfilelintrc`
|
|
|
|
### Dockerfilelint disable single line
|
|
- There is currently **No** way to disable rules inline of the file(s)
|
|
|
|
### Dockerfilelint disable code block
|
|
- There is currently **No** way to disable rules inline of the file(s)
|
|
|
|
### Dockerfilelint disable entire file
|
|
- There is currently **No** way to disable rules inline of the file(s)
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
## Terraform
|
|
### tflint standard Config file
|
|
### tflint disable single line
|
|
### tflint disable code block
|
|
### tflint disable entire file
|
|
|
|
--------------------------------------------------------------------------------
|