The CodeNarc plugin performs quality checks on your project’s Groovy source files using CodeNarc and generates reports from these checks.


To use the CodeNarc plugin, include the following in your build script:

Example: Using the CodeNarc plugin

apply plugin: 'codenarc'

The plugin adds a number of tasks to the project that perform the quality checks when used with the Groovy Plugin. You can execute the checks by running gradle check.


The CodeNarc plugin adds the following tasks to the project:


Runs CodeNarc against the production Java source files.


Runs CodeNarc against the test Java source files.


Runs CodeNarc against the given source set’s Java source files.

Dependencies added to other tasks

The CodeNarc plugin adds the following dependencies to tasks defined by the Groovy plugin.


Depends on: All CodeNarc tasks, including codenarcMain and codenarcTest.

Project layout

The CodeNarc plugin expects the following project layout:

└── config
    └── codenarc           (1)
        └── codenarc.xml   (2)
  1. CodeNarc configuration files go here

  2. Primary CodeNarc configuration file

Dependency management

The CodeNarc plugin adds the following dependency configurations:

Table 1. CodeNarc plugin - dependency configurations
Name Meaning


The CodeNarc libraries to use


See the CodeNarcExtension class in the API documentation.