mirror of
https://github.com/super-linter/super-linter.git
synced 2024-11-25 02:01:02 -05:00
89 lines
2.4 KiB
Markdown
89 lines
2.4 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)
|
|
|
|
## How to use
|
|
|
|
To use this **GitHub** Action you will need to complete the following:
|
|
- Copy **any** or **all** template rules files `TEMPLATES/` to your repository in the location: `.github/`
|
|
- If your repository does not have rules files, they will fall back to defaults
|
|
- Validate all variables are correct and allow for proper permissions on **AWS**
|
|
- Add the **Github** Action: **Super-Linter** to your current **Github** Actions workflow
|
|
- Enjoy your more stable, and cleaner code base
|
|
|
|
### Example GitHub Action Workflow
|
|
|
|
In your repository you should have a `workflows` folder 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
|
|
...
|
|
```
|
|
|
|
## 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)
|