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
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
...

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

How to contribute

If you would like to help contribute to this Github Action, please see CONTRIBUTING

License

License

2.6 KiB Raw Blame History