azul-build-macros.xml

<project name="azul-build-macros" basedir="." default="zz-unrunnable">
    <target name="zz-unrunnable">
        <fail message="zz-unrunnable"/>
    </target>

	<property name="defaults.verbose" value="false" />
	
	<property name="projects.dir" location=".." />
    <property name="project.dir" location="${basedir}" />
    <property name="project.name" value="${ant.project.name}" />
    
    <property name="repository.dir" location="${projects.dir}/.repo" />
    
	<property name="project.lib.dir" location="${project.dir}/lib" />
	<property name="project.extlib.dir" location="${project.dir}/ext-lib" />
	
	<property name="install.dir" location="${repository.dir}" />
    
    <property name="src.dir" location="${project.dir}/src" />
    <property name="project.build.dir" location="${project.dir}/build" />
    <property name="class.dir" location="${project.build.dir}/classes" />
    	
    <!-- http://central.maven.org/maven2/org/apache/poi/poi-scratchpad/3.15/poi-scratchpad-3.15.jar -->    
    <property name="defaults.maven.url.base" value="http://central.maven.org/maven2" />

    <property name="defaults.get-extlib.usecaches" value="true" />
	<property name="defaults.get-extlib.retries" value="3" />
	<property name="defaults.get-extlib.maxtimesecs" value="0" /> 
    <property name="defaults.get-extlib.skipexisting" value="true" />
    <property name="defaults.get-extlib.trygzip" value="false" />
	<property name="defaults.get-extlib.usetimetamp" value="true" />
	<property name="defaults.get-extlib.verbose" value="false" />
	
	<echo message="project: ${project.name} - project.dir: ${project.dir} projects.dir: ${projects.dir}" />
    
    <property name="defaults.jdkrefid" value="defaultjdk" />

    <property name="defaults.javac.debug" value="true" />
    <property name="defaults.javac.deprecation" value="false" />

    <property name="defaults.jar.index" value="true" />

    <!-- definition of defaultjdk -->
    <property name="defaultjdk.jvm" value="${java.home}/bin/java" />
    <property name="defaultjdk.compiler" value="${java.home}/../bin/javac" />
    <property name="defaultjdk.version" value="${java.specification.version}" />
    <property name="defaultjdk.source" value="${java.specification.version}" />
    <property name="defaultjdk.target" value="${java.specification.version}" />
    <path id="defaultjdk.bootclasspathref">
      <filelist files="${sun.boot.class.path}" />
    </path>

    <!-- 
     Defines a JDK build configuration
     This includes the...
     - location of the JDK which is used to determine...
       - jvm (java executable)
       - compiler (javac executable)
       - bootclasspath - (basically the rt.jar against which to compile)
     - version which is used to set the default source input and target output
       for the compiler
     -->
    <macrodef name="azul.jdkdef">
        <attribute name="id" />
        <attribute name="location" />
        <attribute name="version" />
        <attribute name="source" default="@{version}" />
        <attribute name="target" default="@{version}" />
    
        <sequential>
            <property name="@{id}.jvm" location="@{location}/bin/java" />
            <property name="@{id}.compiler" location="@{location}/bin/javac" />
            <property name="@{id}.version" value="@{version}" />
            <property name="@{id}.source" value="@{source}" />
            <property name="@{id}.target" value="@{target}" />

            <path id="@{id}.bootclasspathref">
               <fileset dir="@{location}/lib/" includes="*.jar" />
               <fileset dir="@{location}/jre/lib/" includes="*.jar" />
            </path>
        </sequential>
    </macrodef>

    <!-- 
     Aliases a JDK - to another ID

     This can be used to alias a higher version JDK to target a lower version JDK,
     but must be used with care because the rt.jar may contain additional classes
     not present in the older JDK.

     This is similar to Ant's standard warning about setting target without setting
     bootclasspath.
     -->
    <macrodef name="azul.jdkalias">
        <attribute name="id" />
        <attribute name="refid" />
        <attribute name="target" default="${@{refid}.target}" />
        <attribute name="source" default="@{target}" />

        <sequential>
            <property name="@{id}.jvm" value="${@{refid}.jvm}" />
            <property name="@{id}.compiler" value="${@{refid}.compiler}" />
            <property name="@{id}.version" value="${@{refid}.version}" />
            <property name="@{id}.source" value="@{source}" />
            <property name="@{id}.target" value="@{target}" />
    
            <path id="@{id}.bootclasspathref">
                <path refid="@{refid}.bootclasspathref" />
            </path>
        </sequential>
    </macrodef>
    
    <macrodef name="azul.clean-all">
      <sequential>
        <delete dir="${project.build.dir}" includes="**/*" includeemptydirs="true" />
      </sequential>
    </macrodef>
	
    <!--
  	<delete dir="${lib.dir}" includes="**/*" includeemptydirs="true" />
    <delete dir="${extlib.dir}" includes="**/*" includeemptydirs="true" />
	-->
    
    <!-- project-clean -->
    <macrodef name="azul.clean">
      <sequential>
        <delete dir="${project.build.dir}" includes="**/*"
          includeemptydirs="true"
          failonerror="false" />
      	
      	<delete file="${project.build.dir}" />
      </sequential>
    </macrodef>

    <!--
     Convenience for the common of compiling a single directory.
     Handles dependency checking, javac, resource copying, and source copying.
     
     Projects with multiple source directories - need to use the lower-level macros...
     - azul.depend
     - azul.javac
     - azul.copyresources
     - azul.copyjavasources
    -->
    <macrodef name="azul.compile">
      <attribute name="srcdir" default="${src.dir}" />
      <attribute name="destdir" default="${class.dir}" />

      <attribute name="jdkrefid" default="defaultjdk" />
      <attribute name="target" default="${@{jdkrefid}.target}" />
      <attribute name="source" default="@{target}" />

      <attribute name="deprecation" default="${defaults.javac.deprecation}" />
      <attribute name="debug" default="${defaults.javac.debug}" />

      <element name="classpath-contents" implicit="true" optional="true" />

      <sequential>
      	<!-- <echo message="srcdir: @{srcdir} destdir: @{destdir}" /> -->
      	<mkdir dir="@{destdir}" />
      	
        <azul.depend srcdir="@{srcdir}" destdir="@{destdir}">
          <classpath-contents />
        </azul.depend>

        <azul.javac destdir="@{destdir}"
          source="@{source}" target="@{target}" 
          jdkrefid="@{jdkrefid}"
          debug="@{debug}" deprecation="@{deprecation}">

          <src location="@{srcdir}" />
          <classpath-contents />
        </azul.javac>

        <azul.copy-resources srcdir="@{srcdir}" destdir="@{destdir}" />
        <azul.copy-javasources srcdir="@{srcdir}" destdir="@{destdir}" />
      </sequential>
    </macrodef>

    <macrodef name="azul.depend">
      <attribute name="srcdir" default="${src.dir}" />
      <attribute name="destdir" default="${class.dir}" />

      <element name="classpath-contents" optional="true" implicit="true" />
    
      <sequential>
        <depend srcdir="@{srcdir}" destdir="@{destdir}">
          <classpath-contents />
        </depend>
      </sequential>
    </macrodef>

    <macrodef name="azul.javac">
      <attribute name="destdir" default="${class.dir}" />
    
      <attribute name="jdkrefid" default="defaultjdk" />
      <attribute name="target" default="${@{jdkrefid}.target}" />
      <attribute name="source" default="@{target}" />
    
      <attribute name="deprecation" default="${defaults.javac.deprecation}" />
      <attribute name="debug" default="${defaults.javac.debug}" />
      
      <element name="javac-contents" implicit="true" optional="true" />
      <sequential>
        <mkdir dir="@{destdir}" />
        
        <javac destdir="@{destdir}"
          source="@{source}" target="@{target}" 
          debug="@{debug}" deprecation="@{deprecation}"
          bootclasspathref="@{jdkrefid}.bootclasspathref"
          fork="true" executable="${@{jdkrefid}.compiler}"
          includeantruntime="false">
          
          <javac-contents />
        </javac>
      </sequential>
    </macrodef>
    
    <macrodef name="azul.copy-resources">
      <attribute name="srcdir" default="${src.dir}" />
      <attribute name="destdir" default="${class.dir}" />
      <attribute name="includes" default="**/*" />
      <sequential>
        <mkdir dir="@{destdir}" />
        
        <copy todir="@{destdir}">
          <fileset dir="@{srcdir}" includes="@{includes}" excludes="**/*.java" />
        </copy>
      </sequential>
    </macrodef>
    
    <macrodef name="azul.copy-javasources">
      <attribute name="srcdir" default="${src.dir}" />
      <attribute name="destdir" default="${class.dir}" />
      <attribute name="includes" default="**/*" />
      <sequential>
        <mkdir dir="@{destdir}" />
        
        <copy todir="@{destdir}">
          <fileset dir="@{srcdir}" includes="**/*.java" />
        </copy>
      </sequential>
    </macrodef>

    <!-- Clean for azul.compile -->
    <macrodef name="azul.deleteclasses">
      <attribute name="module" default="dne" />

      <attribute name="class.dir" default="${class.dir}/@{module}" />

      <sequential>
        <delete dir="@{class.dir}" includeemptydirs="true" failonerror="false" />
      </sequential>
    </macrodef>

    <!--
     JARs up output of a previous call to azul.compile - in a way that is compatible
     with azul.compile's dependency analysis
     -->
    <macrodef name="azul.jar">
      <attribute name="basedir" default="${class.dir}" />
      <attribute name="jar" default="${project.name}.jar" />
      <attribute name="destfile" default="${project.build.dir}/@{jar}" />
         
      <attribute name="index" default="${defaults.jar.index}" />
    
      <element name="jar-contents" implicit="true" optional="true" />

      <sequential>
        <!--  really should be the parent of destfile -->
        <mkdir dir="${project.build.dir}" />

        <jar basedir="@{basedir}" destfile="@{destfile}" index="@{index}" update="true" roundup="true">
          <jar-contents />
        </jar>
      </sequential>
    </macrodef>
  
    <macrodef name="azul.megajar">
      <attribute name="jar" default="${project.name}.jar" />
      <attribute name="destfile" default="${project.build.dir}/@{jar}" />
     
      <attribute name="index" default="${defaults.jar.index}" />
    
      <element name="jar-contents" implicit="true" optional="true" />

      <sequential>
        <!--  really should be the parent of destfile -->
        <mkdir dir="${project.build.dir}" />

        <echo message="megajar: @{destfile}" />

        <jar destfile="@{destfile}" index="@{index}" update="true" roundup="true" filesetmanifest="skip">
          <jar-contents />
        </jar>
      </sequential>
    </macrodef>

	
	<macrodef name="azul.def-extlib">
	  <attribute name="id" />
	  <attribute name="groupId" />
	  <attribute name="artifactId" />
	  <attribute name="version" />
	  	
	  <sequential>
	  	<property name="@{id}-groupId" value="@{groupId}" />
	  	<property name="@{id}-artifactId" value="@{artifactId}" />
	  	<property name="@{id}-version" value="@{version}" />
	  	
	  	<property name="@{id}-jar" value="@{artifactId}-@{version}.jar" />
	  </sequential>
	</macrodef>
	
    <!-- https://search.maven.org/remotecontent?filepath=org/apache/poi/poi-scratchpad/4.0.0/poi-scratchpad-4.0.0.jar -->
    <macrodef name="azul.get-extlib">
      <attribute name="refid" />
      <attribute name="groupId" default="${@{refid}-groupId}"/>
      <attribute name="artifactId" default="${@{refid}-artifactId}" />
      <attribute name="version" default="${@{refid}-version}" />
      
      <attribute name="repourl" default="${defaults.maven.url.base}" />
      <attribute name="path" default="@{groupId}/@{artifactId}/@{version}/@{artifactId}-@{version}.jar" />
	  <attribute name="url" default="@{repourl}/@{path}" />
    	
      <attribute name="destdir" default="${project.extlib.dir}" />
      <attribute name="destfile" default="@{destdir}/${@{refid}-jar}" />

      <attribute name="retries" default="${defaults.get-extlib.retries}" />
      <attribute name="maxtime" default="${defaults.get-extlib.maxtimesecs}" />
      <attribute name="maxtimesecs" default="@{maxtime}" />
    	
      <attribute name="usecaches" default="${defaults.get-extlib.usecaches}" />
      <attribute name="skipexisting" default="${defaults.get-extlib.skipexisting}" />
      <attribute name="usetimestamp" default="${defaults.get-extlib.usetimestamp}" />
      <attribute name="trygzip" default="${defaults.get-extlib.tryzip}" />
    	
      <attribute name="verbose" default="${defaults.get-extlib.verbose}" />
    	
      <sequential>
        <mkdir dir="@{destdir}" />
      	
      	<get src="@{url}" dest="@{destfile}"
      	  usetimestamp="@{usetimestamp}"
      	  maxtime="@{maxtimesecs}"
      	  retries="@{retries}"
      	  skipexisting="@{skipexisting}"
      	  httpusecaches="@{usecaches}"
      	  trygzipencoding="@{trygzip}"
      	  verbose="@{verbose}" />
      </sequential>
    </macrodef>
    
    <macrodef name="azul.install">
      <attribute name="jar" default="${project.name}.jar" />
      <attribute name="file" default="${project.build.dir}/@{jar}" />
        
      <attribute name="todir" default="${install.dir}" />
        
      <sequential>
          <!-- really should be parent of file -->
          <mkdir dir="${repository.dir}" />
            
          <copy file="@{file}" todir="@{todir}" />
      </sequential>
    </macrodef>

    <macrodef name="azul.copy-libs">
      <attribute name="libdir" default="${project.lib.dir}" />
      <attribute name="includes" default="*.jar" />
      <attribute name="todir" />
      
      <sequential>
        <copy todir="@{todir}">
          <fileset dir="@{libdir}" includes="@{includes}" />
        </copy>
      </sequential>
    </macrodef>
	
    <macrodef name="azul.install-libs">
      <attribute name="libdir" default="${project.lib.dir}" />
      <attribute name="includes" default="*.jar" />
      <attribute name="todir" default="${install.dir}" />
      
      <sequential>
        <azul.copy-libs libdir="@{libdir}" includes="@{includes}" todir="@{todir}" />
      </sequential>
    </macrodef>

    <macrodef name="azul.package-libs">
      <attribute name="libdir" default="${project.lib.dir}" />
      <attribute name="includes" default="*.jar" />
      <attribute name="todir" default="${project.build.dir}" />
      
      <sequential>
        <azul.copy-libs libdir="@{libdir}" includes="@{includes}" todir="@{todir}" />
      </sequential>
    </macrodef>
    
    <macrodef name="azul.copy-extlibs">
      <attribute name="libdir" default="${project.extlib.dir}" />
      <attribute name="includes" default="*.jar" />
      <attribute name="todir" />
      
      <sequential>
        <copy todir="@{todir}">
          <fileset dir="@{libdir}" includes="@{includes}" />
        </copy>
      </sequential>
    </macrodef>
	
    <macrodef name="azul.install-extlibs">
      <attribute name="libdir" default="${project.extlib.dir}" />
      <attribute name="includes" default="*.jar" />
      <attribute name="todir" default="${install.dir}" />
      
      <sequential>
        <copy todir="@{todir}">
          <fileset dir="@{libdir}" includes="@{includes}" />
        </copy>
      </sequential>
    </macrodef>
	
    <macrodef name="azul.package-extlibs">
      <attribute name="libdir" default="${project.extlib.dir}" />
      <attribute name="includes" default="*.jar" />
      <attribute name="todir" default="${project.build.dir}" />
      
      <sequential>
        <copy todir="@{todir}">
          <fileset dir="@{libdir}" includes="@{includes}" />
        </copy>
      </sequential>
    </macrodef>
	
    <macrodef name="azul.ant">
      <attribute name="project" default="dne" />
      <attribute name="project.dir" default="${projects.dir}/@{project}" />
      <attribute name="target" />
    	
      <element name="properties" implicit="true" />
    	
      <sequential>
        <echo message="[azul.ant] project=@{project} target=@{target}" />
      	<!-- <echo message=" - project.dir=@{project.dir}" /> -->
            
        <ant dir="@{project.dir}" antfile="@{project.dir}/build.xml"
          target="@{target}"
      	  inheritall="false">
        	
          <properties />
        </ant>
      </sequential>
    </macrodef>
	
	<macrodef name="azul.project-clean">
	  <attribute name="project" default="dne" />
	  <attribute name="project.dir" default="${projects.dir}/@{project}" />
	  
	  <sequential>
	     <azul.ant project="@{project}" target="clean">
	       <property name="project.dir" value="@{project.dir}" />
	       <property name="repository.dir" value="${repository.dir}" />
	  	 </azul.ant>
	  </sequential>
    </macrodef>
	
	<macrodef name="azul.project-prepare">
	  <attribute name="project" default="dne" />
	  <attribute name="project.dir" default="${projects.dir}/@{project}" />
	  
	  <sequential>
	     <azul.ant project="@{project}" target="prepare">
	       <property name="project.dir" value="@{project.dir}" />
	       <property name="repository.dir" value="${repository.dir}" />
	  	 </azul.ant>
	  </sequential>
    </macrodef>
	
	<macrodef name="azul.project-compile">
	  <attribute name="project" default="dne" />
	  <attribute name="project.dir" default="${projects.dir}/@{project}" />
	  
	  <sequential>
	     <azul.ant project="@{project}" target="compile">
	       <property name="project.dir" value="@{project.dir}" />
	       <property name="repository.dir" value="${repository.dir}" />
	  	 </azul.ant>
	  </sequential>
    </macrodef>
	
	<macrodef name="azul.project-package">
	  <attribute name="project" default="dne" />
	  <attribute name="projectdir" default="${projects.dir}/@{project}" />
	  
	  <sequential>
	     <azul.ant project="@{project}" target="package">
	       <property name="project.dir" value="@{projectdir}" />
	       <property name="repository.dir" value="${repository.dir}" />
	  	 </azul.ant>
	  </sequential>
    </macrodef>
	
	<macrodef name="azul.project-install">
	  <attribute name="project" default="dne" />
	  <attribute name="projectdir" default="${projects.dir}/@{project}" />
	  <attribute name="todir" default="${repository.dir}" />
	  
	  <sequential>
	     <azul.ant project="@{project}" target="install">
	       <property name="project.dir" value="@{projectdir}" />
	       <property name="repository.dir" value="${repository.dir}" />
	     	
	       <property name="install.dir" value="@{todir}" />
	  	 </azul.ant>
	  </sequential>
    </macrodef>
	
	<macrodef name="azul.project-install-lib">
	  <attribute name="project" default="dne" />
	  <attribute name="projectdir" default="${projects.dir}/@{project}" />
	  <attribute name="libdir" default="${project.lib.dir}" />
	  
	  <sequential>
	  	<azul.project-install
	  	  project="@{project}"
	  	  projectdir="@{projectdir}"
	  	  todir="@{libdir}" />
	  </sequential>
	</macrodef>
</project>