mirror of
https://github.com/super-linter/super-linter.git
synced 2024-12-22 12:42:09 -05:00
Combination of multiple linters to run as a GitHub Action or standalone
.github | ||
lib | ||
TEMPLATES | ||
.gitignore | ||
Dockerfile | ||
LICENSE | ||
README.md |
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)
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
- If your repository does not have rules files, they will fall back to defaults in this repositories
- 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:
---
###########################
###########################
## 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
...
How to contribute
If you would like to help contribute to this Github Action, please see CONTRIBUTING