mirror of
https://github.com/super-linter/super-linter.git
synced 2024-11-25 10:10:56 -05:00
140 lines
4.7 KiB
Markdown
140 lines
4.7 KiB
Markdown
# Super-Linter
|
|
This repository is for the **GitHub** Action to run a **Super-Linter**.
|
|
Developers on **GitHub** can call this Action to lint their code base with the following list of linters:
|
|
|
|
- **Ruby** (Rubocop)
|
|
- **Shell** (Shellcheck)
|
|
- **Ansible** (Ansible-lint)
|
|
- **YAML** (Yamllint)
|
|
- **Python3** (Pylint)
|
|
- **JSON** (JsonLint)
|
|
- **MarkDown** (Markdownlint)
|
|
- **Perl** (Perl)
|
|
- **XML** (LibXML)
|
|
- **Coffeescript** (coffeelint)
|
|
- **Javascript** (eslint)(standard)
|
|
- **Dockerfile** (dockerfilelint)
|
|
|
|
## How to use
|
|
To use this **GitHub** Action you will need to complete the following:
|
|
- Copy **any** or **all** template rules files from `TEMPLATES/` into your repository in the location: `.github/linters/`
|
|
- If your repository does not have rules files, they will fall back to defaults in this repositories `TEMPLATE` folder
|
|
- Add the **Github** Action: **Super-Linter** to your current **GitHub** Actions workflow
|
|
- Enjoy your more stable, and cleaner code base
|
|
|
|
### Example connecting GitHub Action Workflow
|
|
In your repository you should have a `workflows` folder with **GitHub** Action similar to below:
|
|
|
|
- `.github/workflows/linter.yml`
|
|
|
|
This file should have the following code:
|
|
|
|
```yml
|
|
---
|
|
###########################
|
|
###########################
|
|
## Linter GitHub Actions ##
|
|
###########################
|
|
###########################
|
|
name: Lint Code Base
|
|
|
|
#
|
|
# Documentation:
|
|
# https://help.github.com/en/articles/workflow-syntax-for-github-actions
|
|
#
|
|
|
|
#############################
|
|
# Start the job on all push #
|
|
#############################
|
|
on: ['push']
|
|
|
|
###############
|
|
# Set the Job #
|
|
###############
|
|
jobs:
|
|
build:
|
|
# Name the Job
|
|
name: Lint Code Base
|
|
# Set the agent to run on
|
|
runs-on: ubuntu-latest
|
|
|
|
##################
|
|
# Load all steps #
|
|
##################
|
|
steps:
|
|
##########################
|
|
# Checkout the code base #
|
|
##########################
|
|
- name: Checkout Code
|
|
uses: actions/checkout@master
|
|
|
|
################################
|
|
# Run Linter against code base #
|
|
################################
|
|
- name: Lint Code Base
|
|
uses: docker://admiralawkbar/super-linter:latest
|
|
env:
|
|
VALIDATE_ALL_CODEBASE: false
|
|
VALIDATE_ANSIBLE: false
|
|
...
|
|
```
|
|
|
|
## Env Vars
|
|
The super-linter allows you to pass the following `ENV` variables to be able to trigger different functionality:
|
|
- **VALIDATE_ALL_CODEBASE**
|
|
- Default: `true`
|
|
- Will parse the entire repository and find all files to validate across all types
|
|
- **NOTE:** When set to `false`, only **new** or **edited** files will be parsed for validation
|
|
- **VALIDATE_YAML**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_JSON**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_XML**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_MD**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_BASH**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_PERL**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_PYTHON**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_RUBY**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_COFFEE**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_ANSIBLE**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **VALIDATE_JAVASCRIPT**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
- **ANSIBLE_DIRECTORY**
|
|
- Default: `/ansible`
|
|
- Flag to set the root directory for Ansible file location(s)
|
|
- **VALIDATE_DOCKER**
|
|
- Default: `true`
|
|
- Flag to enable or disable the linting process of the language
|
|
|
|
## Docker Hub
|
|
The **Docker** container that is built from this repository is located at `https://cloud.docker.com/u/admiralawkbar/repository/docker/admiralawkbar/super-linter`
|
|
|
|
## Running Super-Linter locally (troubleshooting/debugging/enhancements)
|
|
If you find that you need to run super-linter locally, you can follow the documentation at [Running super-linter locally](https://github.com/github/super-linter/blob/master/.github/run-linter-locally.md)
|
|
|
|
## How to contribute
|
|
If you would like to help contribute to this **GitHub** Action, please see [CONTRIBUTING](https://github.com/github/super-linter/blob/master/.github/CONTRIBUTING.md)
|
|
|
|
--------------------------------------------------------------------------------
|
|
|
|
### License
|
|
- [License](https://github.com/github/super-linter/blob/master/LICENSE)
|