Groovylint

This repository provides a way to run CodeNarc checks from a docker image. CodeNarc analyzes Groovy code for defects, bad practices, inconsistencies, style issues and more.

Usage

Running with Python

To use groovylint as a standalone Python script, simply, run the run_codenarc.py script like so:

$ /path/to/run_codenarc.py --codenarc 1.2.1 --gmetrics 1.0 --slf4j 1.7.25 --resources \
    /path/to/groovylint/resources -- -includes="./Jenkinsfile,**/*.groovy,**/*.gradle"

The --resources argument should point to the resources directory underneath where you've cloned the groovylint sources. The version numbers used by groovylint's Docker container can be found in the Dockerfile. groovylint will download any JAR dependencies it needs to this location.

Note that the run_codenarc.py script requires Python 3.6 or greater to be installed on the local system.

Running as a Docker application

groovylint is also published as a Docker container on Docker Hub. To run groovylint from the container, that would look something like this:

$ docker run --rm -v `pwd`:/ws -u `id -u`:`id -g` abletonag/groovylint \
    /opt/run_codenarc.py -- -includes='foo/bar.groovy,src/**/*.groovy'

By default, the Docker image will run CodeNarc checks on the /ws directory, so this command uses a volume mapping from the current working directory to that location. The above example would check the file foo/bar.groovy, and all Groovy files in the src directory tree.

Running in a Docker container

$ docker run --rm -v `pwd`:/ws -u `id -u`:`id -g` --entrypoint=/bin/sh -i -t \
    abletonag/groovylint

This command will run the CodeNarc image and override the entry point. You can then run run_codenarc.py inside the container as a regular program.

Specifying the ruleset

As described in the CodeNarc documentation, you can specify your own ruleset file. The file's location must be relative to your workspace, and can be given in the command line arguments with the -rulesetfile flag:

$ docker run --rm -v `pwd`:/ws -u `id -u`:`id -g` abletonag/groovylint \
    /opt/run_codenarc.py -- -includes='*.groovy' -rulesetfiles=file:myrules.groovy

Using a codenarc.properties file

As described in the CodeNarc documentation, you can configure a ruleset with *.properties files. Property files must be available on the Groovy classpath. The Groovy classpath of the docker image is set to /opt in the docker image, so you must mount the properties file there:

$ docker run --rm -v `pwd`:/ws -v `pwd`/codnearc.properties:/opt/codenarc.properties \
    -u `id -u`:`id -g` abletonag/groovylint /opt/run_codenarc.py -- -includes='*.groovy' \
    -rulesetfiles=file:myrules.groovy

Usage in a Jenkinsfile

To assist in linting on Jenkins, groovylint provides a pipeline library and global singleton. To use groovylint in this manner, you'll need to add it to your Jenkins master configuration. Any Jenkinsfile which is using this library should also use the version tag, like so:

// Example Jenkinsfile using a scripted pipeline
@Library('groovylint@x.y.z') _

node('linux') {
  stage('Lint') {
    groovylint.check('./Jenkinsfile,**/*.groovy')
  }
}

Tags are available for all major.minor.patch versions, and branches with major.minor versions are updated whenever a new patch version is released. Jenkins exposes the library version in the environment variables, and the library will use that version to find the corresponding Docker image for that release.

Making releases

In order to ensure that the library is using a compatible version of the Docker image, a file named VERSION exists in the top-level directory of this project. To make a release, this file should be updated accordingly and the commit merged to the master branch. Please also update the groovylint version in pom.xml.

Once on master, a new Docker image will be published by Ableton's CI service, which will also push a corresponding git tag to the origin and update the respective major.minor branch.

Maintainers

This project is maintained by the following GitHub users:

nikreiman / groovylint