PyLint with dynamic badge

PyLint with badge - GitHub Action

GitHub action that lets you easily lint one or multiple packages (or python files) of your project and adds a dynamic badge to your README.md that lets you display the obtained score!

Each time the action is run, packages (or python files) specified will be linted and a badge in the README.md is updated dynamically following one of the below rules:

Range PyLint score	Badge
Bad score: PyLint score $< 5$
Ok score: $5 \le$ PyLint score $< 8$
Good score: $8 \le$ PyLint score $< 10$
Perfect score: PyLint score $= 10$

NEW: You can now fully customize the badge color of each of the above ranges! Check usage and scenario sections for more!

The action can be triggered by a Pull request, a Push or manually with workflow_dispatch. If the score is changed, the github_action bot will change your badge with an automatic commit

IMPORTANT! Follow the 'Preliminary steps' section in order to allow the bot to update your README.md with the pylint badge!

A quick example on how you would typically use this action (more examples in scenario section)

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: src  # lint src package
    python-version: 3.9  # python version which will lint the package

And after running the action, the GitHub action bot will update your PyLint badge with a commit:

Preliminary steps

To use this action you should perform two simple first-time-only operations:

In order to have a dynamic updated badge, before using for the first time this action, you should put a placeholder badge in your README.md which will be substituted by the actual one as soon as you run this action.
The placeholder badge should be in one of the following formats:

![pylint]() or [![pylint]()](https://redirect/link)

Be sure to set write permissions to GitHub actions in your repo settings! You can change it in Settings > Actions > General, then go to subsection Workflow Permissions and thick the Read and write permission option

Usage

- uses: Silleellie/pylint-github-action@v2
  with:
    
    # Path of the package(s) or python file(s) to lint, relative to the repository root. 
    # If more than one package (or python file) should be linted, simply specify all of them 
    # with the multi-line notation like so:
    # lint-path: |
    #   src
    #   other_src
    #   main.py
    #   ...
    # 
    # Required
    lint-path: src
    
    # Version of the Python interpreter which will install all requirements of your project 
    # and lint the package(s) or python file(s) specified with the `lint-path` argument
    #
    # Required
    python-version: 3.9

    # Path of the requirements of your project, relative to the repository root. 
    # This can be easily changed in case you have `requirements-dev.txt`
    #
    # Optional, Default: requirements.txt
    requirements-path: requirements.txt
    
    # Path of the README.md to update with the pylint badge, relative to the repository root.
    #
    # Optional, Default: README.md
    readme-path: README.md

    # Text to display in the badge
    #
    # Optional, Default: PyLint
    badge-text: PyLint

    # Color of the badge for pylint scores < 5.
    # Hex, rgb, rgba, hsl, hsla and css named colors can all be used
    #
    # Optional, Default: red
    color-bad-score: red

    # Color of the badge for pylint scores in range [5,8).
    # Hex, rgb, rgba, hsl, hsla and css named colors can all be used
    #
    # Optional, Default: orange
    color-ok-score: orange

    # Color of the badge for pylint scores in range [8,10).
    # Hex, rgb, rgba, hsl, hsla and css named colors can all be used
    #
    # Optional, Default: yellow
    color-good-score: yellow

    # Color of the badge for pylint scores == 10.
    # Hex, rgb, rgba, hsl, hsla and css named colors can all be used
    #
    # Optional, Default: brightgreen
    color-perfect-score: brightgreen

Single package to lint

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: src
    python-version: 3.11

Single python file to lint

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: main.py
    python-version: 3.11

Multiple packages to lint

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: |
      src
      app
      other_src/inner_src
    python-version: 3.11

Multiple python files to lint

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: |
      file1.py
      file2.py
      other_src/file3.py
    python-version: 3.11

Mix packages and python files to lint

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: |
      src
      app
      main.py
    python-version: 3.11

Different path for requirements file

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: src
    python-version: 3.11
    requirements-path: requirements/requirements-dev.txt

Different path for README.md file

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: src
    python-version: 3.11
    readme-path: models/README.md

Change badge text

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: src
    python-version: 3.11
    badge-text: alternative text

Change badge color with css named color

In this case we are extending what we consider a perfect score: all scores in range $[8, 10]$ are considered good enough and will have same color (brightgreen)

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: src
    python-version: 3.11
    color-good-score: brightgreen
    color-perfect-score: brightgreen

Change badge color with hex code

In this example we are changing the color for the bad score range ($[0,5)$) to purple (hex code: 800080)

- uses: Silleellie/pylint-github-action@v2
  with:
    lint-path: src
    python-version: 3.11
    color-bad-score: 800080

Credits

This is a composite GitHub action which uses the following godly working actions:

Massive thanks to shields.io, which is used to create the badge!

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

GitHub Action

PyLint with dynamic badge