Gpp

What is it?

• Gpp supports general file preprocessing based on the Groovy Template Engine and Ant by providing alternatives to the <copy> and <javac>. See the manual for a complete description.

A Quick Example

• Use <gppcopy> anywhere you would use Ant's regular <copy> task to preprocess your files using the Groovy Template Engine.
• <gppcopy> supports all of <copy>'s parameters and nested parameters.
  
• Access Ant's project properties within your templates by invoking $ant.propname.

<target name="gpp">
  <typedef resource="groovtytools/ant/gpp/typedef.properties" />
  <taskdef resource="groovtytools/ant/gpp/taskdef.properties" />
  
  <gppcopy todir="output" overwrite="true">
    <fileset dir="src" includes="*.html.gpp" />
    <mapper type="glob" from="*.html.gpp" to="*.html" />
  </gppcopy>
</target>

History

• Gpp is essentially a Groovy port of VPP, which was originally based on the Velocity template engine.

Download and Installation

• Get the latest and greatest release of Gpp from http://sourceforge.net/projects/groovytools .
• Assuming that you have already installed and configured Ant correctly, you may deploy Gpp by simply executing ant from the location where you installed Gpp.
• Alternatively, you may also copy the jar files located in the lib subdirectory to your Ant installation ($ANT_HOME/lib).

Documentation and Examples

• See the manual for installation, examples, and deatiled explanations.
• See build.xml for an quick example of Gpp usage in an ant build file.
• See HelloWorld.html.gpp for an example template.
  

Getting Help

• Please use the forums for assistance.

Licensing

• This software is licensed under LGPL, the terms of which you may find here.

References

• http://groovy.codehaus.org
• http://ant.apache.org
• http://vpp.sourceforge.net