Gradle Goodness: Copy Files with Filtering

Gradle's copy task is very powerful and includes filtering capabilities. This means we can change the contents of the files that are copied before they reach their new destination. We use the filter() method to define a filter. The good news is we can reuse the Ant filtering classes from the org.apache.tools.ant.filters package. We define the filtering class and can pass parameters for the filter. Or we can pass a closure which is passed each line as an argument. Within the closure we must return the filtered line.html

 
   00. 
   import org.apache.tools.ant.filters.* 
  
   01. 
     
   02. 
   task('filterCopy', type: Copy) { 
  
   03. 
   from 'src/templates' 
  
   04. 
   into buildDir 
  
   05. 
   include '**/*.txt' 
  
   06. 
   filter { line -> line.contains('Gradle') ? line : '' } 
  
   07. 
   filter(ReplaceTokens, tokens: [author: 'mrhaki', gradleVersion: gradle.gradleVersion]) 
  
   08. 
   filter(ConcatFilter, prepend: file('src/include/header.txt')) 
  
   09. 
   }

Now let's create a sample text file that will get filtered in src/templates/HelloGradle.txt:apache

 
   This is just a simple text file. This line will not make it. 
  
   We show filtering capabilities of Gradle copy. 
  
   This file is written by @author@ with Gradle version @gradleVersion@.

And we create the file src/include/header.txt:post

 
   Include this header file. 
  
   -------------------------

After we run $ gradle filterCopy we get the following contents for the file build/HelloGradle.txt:gradle

 
   Include this header file. 
  
   ------------------------- 
  
   We show filtering capabilities of Gradle copy in combination with the Ant filtering types. 
  
   This file is written by mrhaki with Gradle version 0.9-rc-1.