Checkstyle - Exclude folder

Question

I want to ignore a specific folder (named generated-sources) from my checkstyle reports, because they are generated.

I'm using eclipse-cs for displaying my violations.

i added a suppressionfilter to my xml:

<module name="SuppressionFilter">
    <property name="file" value=".\suppressions.xml"/>
</module>

my suppressions.xml looks like this:

<?xml version="1.0"?>

<!DOCTYPE suppressions PUBLIC
"-//Puppy Crawl//DTD Suppressions 1.1//EN"
"http://www.puppycrawl.com/dtds/suppressions_1_1.dtd">

<suppressions>
    <suppress files="\*generated-sources\*\*\.\*" checks="[a-zA-Z0-9]*"/>
</suppressions>

but it is not working. any ideas?

Philipp Sander · Accepted Answer · 2013-08-02 09:28:20Z

40

<suppress files="[\\/]generated-sources[\\/]" checks="[a-zA-Z0-9]*"/>

this works :)

answered Aug 2, 2013 at 9:28

Philipp Sander

10.3k7 gold badges49 silver badges80 bronze badges

Sign up to request clarification or add additional context in comments.

4 Comments

barfuin Over a year ago

The trick is that Checkstyle applies the regex to the file path, not the binary class name or something. You could shorten the checks attribute to checks=".".

JJJ Over a year ago

Yeah way more detail needed. IE what file. Where

Philipp Sander Over a year ago

@StarWind as stated in my question, the file is the suppressions.xml. the path to that file is defined in the checkstyles.xml.

Lii Over a year ago

This answer would be better if you explained how it works and why it solves the problem!

Thomas Welsch · Accepted Answer · 2014-07-16 12:36:32Z

3

Additionally to the answer from Philipp, I had to use an absolute pathname ( :-( ) for the suppression file:

<module name="SuppressionFilter">
    <property name="file" value="/Users/xxx/workspace/suppressions.xml"/>
</module>

Looks like the Checkstyle plugin is not using the project home directory.

(at least under eclipse luna / Mac OS X)

answered Jul 16, 2014 at 12:36

Thomas Welsch

712 bronze badges

Comments

Gilad Bar Orion · Accepted Answer · 2019-11-14 03:47:41Z

2

As pointed by Thomas Welsch in his answer, there appears to be a problem with using relative pathname for the suppression xml file.

For gradle builds, This gist suggests a workaround:

in build.gradle:

checkstyle {
    // use one common config file for all subprojects
    configFile = project(':').file('config/checkstyle/checkstyle.xml')
    configProperties = [ "suppressionFile" : project(':').file('config/checkstyle/suppressions.xml')]
 }

in checkstyle.xml:

<module name="SuppressionFilter">
    <property name="file" value="${suppressionFile}" default="suppressions.xml"/>
</module>

(the default value allows IDE plugins, that do not have the gradle variable sorted out, to work correctly)

edited Nov 14, 2019 at 3:47

answered Aug 21, 2019 at 6:56

Gilad Bar Orion

5846 silver badges14 bronze badges

Comments

Vuk Djapic · Accepted Answer · 2022-09-10 10:44:53Z

2

For me using SuppressionFilter didn't worked at all. But this works, exactly for the purpose of excluding folder from scanning

<module name="BeforeExecutionExclusionFileFilter">
  <property name="fileNamePattern"  value=".*[\\/]folder-name-here[\\/].*$"/>
</module>

Needs to be inserted inside <module name="Checker"> section.

Docs https://checkstyle.sourceforge.io/config_filefilters.html

answered Sep 10, 2022 at 10:44

Vuk Djapic

91613 silver badges35 bronze badges

Comments

xxks-kkk · Accepted Answer · 2021-07-26 00:17:42Z

This answer tries to fill in missing details in the previous answers.

Suppose I have the following maven project, which only lists the directories inside the project.

.
├── pom.xml
└── src
    ├── main
    │   ├── java
    │   │   └── edu
    │   │       └── utexas
    │   │           └── cs
    │   │               ├── liveoak
    │   │               │   ├── common
    │   │               │   ├── tree
    │   │               │   └── zero
    │   │               ├── logging
    │   │               └── sam
    │   │                   ├── core
    │   │                   │   └── instructions
    │   │                   ├── io
    │   │                   ├── ui
    │   │                   │   └── components
    │   │                   └── utils
    │   └── resources
    │       ├── sam-checks.xml
    │       └── sam-suppressions.xml
    └── test

sam-checks.xml is the checkstyle configuration file and sam-suppressions.xml is the suppression xml document. Inside sam-checks.xml, I have

<module name="SuppressionFilter">
    <property name="file" value="src/main/resources/sam-suppressions.xml"/>
    <property name="optional" value="false"/>
</module>

Note the location of sam-suppressions.xml is relative to the pom.xml of the project.

I want to suppress the checks for all the java files under sam directory (main/java/edu/utexas/cs/sam). To do so, my sam-suppressions.xml looks like below

<!DOCTYPE suppressions PUBLIC
        "-//Checkstyle//DTD SuppressionFilter Configuration 1.2//EN"
        "https://checkstyle.org/dtds/suppressions_1_2.dtd">

<suppressions>
    <suppress checks="[a-zA-Z0-9]*"
              files="[\\/]sam[\\/]"/>
</suppressions>

I verify my setup with mvn checkstyle:check. Everything should work.

Collectives™ on Stack Overflow

Checkstyle - Exclude folder

5 Answers 5

4 Comments

Comments

Comments

Comments

Comments

Your Answer

Linked

Hot Network Questions

Collectives™ on Stack Overflow

5 Answers 5

4 Comments

Comments

Comments

Comments

Comments

Your Answer

Sign up or log in

Post as a guest

Linked

Related