Custom Ant Tasks, Types, Selectors, Filters and Mappers

Collection of Custom Ant Tasks, Types, Selectors, Filters, Mappers to be used in build.xml ant build files

Showcase for

• implementaton of custom ant tasks, types, filters, selectors, mappers
• registration of custom tasks, types, selectors, filters, mappers via typedef.properties
• registration of additional tasks via antlib.xml

Files and Directories

• data – input files
• build – output files
• diff – diff files, showing the effect of certain tasks applied to input files

Install .jar + Register ant tasks

1. Download .jar file

2. You now have the choice:

   • Copy the .jar file to the lib directory of your Ant installation (e.g. /usr/share/ant/lib/), or on your CLASSPATH environment variable. If you want to use one of the tasks in your project, add the line

     <taskdef resource="anblt/ant/contrib/typedef.properties">
       <classpath>
         <fileset dir="${lib.dir}" includes="*.jar" />
       </classpath>
     </typedef>
     <typedef resource="anblt/ant/contrib/antlib.xml">
       <classpath>
         <fileset dir="${lib.dir}" includes="*.jar" />
       </classpath>
     </typedef>
     

     to your build file. This will register the new tasks.

   • Keep the .jar in a separate location. You now have to tell Ant explicitly where to find it.

     <typedef resource="anblt/ant/contrib/typedef.properties">
       <classpath>
         <fileset dir="${lib.dir}" includes="*.jar" />
         <pathelement location="/path/to/anblt-ant-contrib.jar"/>
       </classpath>
     </typedef>
     <typedef resource="anblt/ant/contrib/antlib.xml">
       <classpath>
     	 <fileset dir="${lib.dir}" includes="*.jar" />
     	 <path path="${ant.project.name}.jar" />
       </classpath>
     </typedef>
     

Usage Example for Debian Linux

# if you don't want to rely on libs provided by this project, you can install them on your own
root#> apt-get install openjdk-8-jre ant ant-contrib libcommons-lang3-java libcommons-io-java libcsvjdbc-java
user$> mkdir lib && ln -t lib -s /usr/share/java/{commons-io,commons-lang3,csvjdbc}.jar

# download .jar
user$> wget https://github.com/anblt/anblt-ant-contrib/blob/master/{anblt-ant-contrib.jar,SHA1SUMS,SHA512SUMS}

# verify downloaded .jar file using SHA1SUMS and/or SHA512SUMS
user$> fgrep "anblt-ant-contrib.jar" SHA1SUMS | sha1sum -c
user$> fgrep "anblt-ant-contrib.jar" SHA512SUMS | sha512sum -c

# run
user$> ant -f build.xml

Documentation

• Filter <striphtmlcomments>/<stripxmlcomments>

  strips <!-- ... --> comments from .xml, .html, .svg, etc. files

• FileNameMapper <checksummapper>

  renames arbitrary files to <CHECKSUM>.<fileextension>

• FileSelector <checksumselector>

  select files if their name <CHECKSUM>.<fileextension> matches their actual checksum

• Task <randomchoice>

  select randomly <count> items and execute specified tasks (may have duplicates in its selection)

• Task <randomsample>

  select randomly <count> items and execute specified tasks (does not have duplicates in its selection)

• Task <csvjdbc>

  run SQL queries against .csv files

• Task <xmlrefactor>

  refactor .xml, .html, .svg, etc. files in different ways

  • rename.element – rename element (composite or leaf) leaving it's attributes/subelements untouched
  • rename.attribute – rename element attribute