Ant Conditions & Control Flow

<?xml version="1.0" encoding="UTF-8"?>
<project name="tidepool-conditions" default="logic" basedir=".">

  <!-- evaluate any nested condition and print the result -->
  <macrodef name="check">
    <attribute name="name"/>
    <element name="test" implicit="true"/>
    <sequential>
      <condition property="r.@{name}" value="true" else="false">
        <test/>
      </condition>
      <echo message="@{name}: ${r.@{name}}"/>
    </sequential>
  </macrodef>

  <property name="stations" value="data/stations.csv"/>
  <property name="empty.prop" value=""/>
  <property name="flag" value="yes"/>

<target name="logic">
  <check name="and"><and><isset property="flag"/><equals arg1="${flag}" arg2="yes"/></and></check>
  <check name="or"><or><isset property="nope"/><isset property="flag"/></or></check>
  <check name="not"><not><isset property="nope"/></not></check>
  <check name="xor-two-true"><xor><isset property="flag"/><isset property="stations"/></xor></check>
  <check name="xor-one-true"><xor><isset property="flag"/><isset property="nope"/></xor></check>
  <check name="equals-case"><equals arg1="M2" arg2="m2"/></check>
  <check name="equals-ignore-case"><equals arg1="M2" arg2="m2" casesensitive="false"/></check>
  <check name="equals-trim"><equals arg1="  M2 " arg2="M2" trim="true"/></check>
  <check name="contains"><contains string="SF,San Francisco" substring="francisco" casesensitive="false"/></check>
  <check name="istrue-yes"><istrue value="${flag}"/></check>
  <check name="istrue-unset"><istrue value="${nope}"/></check>
  <check name="isfalse-unset"><isfalse value="${nope}"/></check>
  <check name="isfalse-off"><isfalse value="off"/></check>
  <check name="matches"><matches string="M2:0.55:120" pattern="^[A-Z][A-Z0-9]*:\d+\.\d+:\d+$$"/></check>
  <check name="matches-multiline"><matches string="a${line.separator}b" pattern="^b$$" multiline="true"/></check>
  <check name="length-string"><length string=" M2 " trim="true" length="2"/></check>
  <check name="length-file"><length file="${stations}" when="greater" length="0"/></check>
</target>

$ ant -q logic
     [echo] and: true
     [echo] or: true
     [echo] not: true
     [echo] xor-two-true: false
     [echo] xor-one-true: true
     [echo] equals-case: false
     [echo] equals-ignore-case: true
     [echo] equals-trim: true
     [echo] contains: true
     [echo] istrue-yes: true
     [echo] istrue-unset: false
     [echo] isfalse-unset: true
     [echo] isfalse-off: true
     [echo] matches: true
     [echo] matches-multiline: true
     [echo] length-string: true
     [echo] length-file: true
BUILD SUCCESSFUL
Total time: 0 seconds

<target name="files">
  <check name="resourceexists"><resourceexists><file file="${stations}"/></resourceexists></check>
  <check name="filesmatch-same"><filesmatch file1="${stations}" file2="data/stations-copy.csv"/></check>
  <check name="filesmatch-different"><filesmatch file1="${stations}" file2="data/copy.csv"/></check>
  <check name="filesmatch-line-endings"><filesmatch file1="data/crlf.csv" file2="data/lf.csv"/></check>
  <check name="filesmatch-textfile"><filesmatch file1="data/crlf.csv" file2="data/lf.csv" textfile="true"/></check>
  <check name="resourcecontains"><resourcecontains resource="${stations}" substring="Honolulu"/></check>
  <check name="resourcecount"><resourcecount count="3"><dirset dir="stations" includes="*"/></resourcecount></check>
  <check name="isfileselected"><isfileselected file="${stations}"><size value="100" when="more"/></isfileselected></check>
  <check name="islastmodified"><islastmodified datetime="01/01/2020 12:00 AM" mode="after"><file file="${stations}"/></islastmodified></check>
  <checksum file="${stations}" algorithm="SHA-256" property="stations.sha256"/>
  <check name="checksum"><checksum file="${stations}" algorithm="SHA-256" property="${stations.sha256}"/></check>
  <check name="checksum-wrong"><checksum file="${stations}" algorithm="SHA-256" property="0000"/></check>
  <check name="canCreateSymlink"><canCreateSymlink/></check>
  <check name="hasfreespace"><hasfreespace partition="/" needed="1M"/></check>
  <check name="isreference-no"><isreference refid="no.such.ref"/></check>
  <path id="cp"><pathelement location="data"/></path>
  <check name="isreference-path"><isreference refid="cp" type="path"/></check>
  <check name="isreference-wrong-type"><isreference refid="cp" type="fileset"/></check>
  <check name="issigned"><issigned file="${ant.library.dir}/ant.jar"/></check>
</target>

$ ant -q files
     [echo] resourceexists: true
     [echo] filesmatch-same: true
     [echo] filesmatch-different: false
     [echo] filesmatch-line-endings: false
     [echo] filesmatch-textfile: true
     [echo] resourcecontains: true
     [echo] resourcecount: true
     [echo] isfileselected: true
     [echo] islastmodified: true
     [echo] checksum: true
     [echo] checksum-wrong: false
     [echo] canCreateSymlink: true
     [echo] hasfreespace: true
     [echo] isreference-no: false
     [echo] isreference-path: true
     [echo] isreference-wrong-type: false
     [echo] issigned: false
BUILD SUCCESSFUL
Total time: 0 seconds

<target name="environment">
  <check name="os-family-unix"><os family="unix"/></check>
  <check name="os-family-mac"><os family="mac"/></check>
  <check name="os-family-windows"><os family="windows"/></check>
  <check name="os-family-mac-and-not-unix"><and><os family="mac"/><not><os family="unix"/></not></and></check>
  <check name="javaversion-atleast-21"><javaversion atleast="21"/></check>
  <check name="javaversion-exactly-26"><javaversion exactly="26"/></check>
  <check name="javaversion-atmost-17"><javaversion atmost="17"/></check>
  <check name="antversion-atleast-1.10.2"><antversion atleast="1.10.2"/></check>
  <check name="antversion-exactly-1.10.18"><antversion exactly="1.10.18"/></check>
  <check name="typefound-junitlauncher"><typefound name="junitlauncher"/></check>
  <check name="typefound-checkstations"><typefound name="checkstations"/></check>
  <check name="hasmethod"><hasmethod classname="java.util.ArrayList" method="trimToSize"/></check>
  <check name="hasmethod-missing"><hasmethod classname="java.util.ArrayList" method="shrinkToFit"/></check>
  <check name="parsersupports"><parsersupports feature="http://xml.org/sax/features/namespaces"/></check>
  <check name="available-class"><available classname="java.util.HexFormat"/></check>
  <check name="available-file"><available file="${stations}" type="file"/></check>
  <check name="available-dir"><available file="data" type="dir"/></check>
  <check name="available-resource"><available resource="org/apache/tools/ant/taskdefs/defaults.properties"/></check>
  <exec executable="false" resultproperty="rc" failonerror="false"/>
  <check name="isfailure"><isfailure code="${rc}"/></check>
</target>

$ ant -q environment
     [echo] os-family-unix: true
     [echo] os-family-mac: true
     [echo] os-family-windows: false
     [echo] os-family-mac-and-not-unix: false
     [echo] javaversion-atleast-21: true
     [echo] javaversion-exactly-26: true
     [echo] javaversion-atmost-17: false
     [echo] antversion-atleast-1.10.2: true
     [echo] antversion-exactly-1.10.18: true
     [echo] typefound-junitlauncher: true
     [echo] typefound-checkstations: false
     [echo] hasmethod: true
     [echo] hasmethod-missing: false
     [echo] parsersupports: true
     [echo] available-class: true
     [echo] available-file: true
     [echo] available-dir: true
     [echo] available-resource: true
     [echo] isfailure: true
BUILD SUCCESSFUL
Total time: 0 seconds

<target name="network">
  <check name="http-ok"><http url="http://localhost:${port}/data/stations.csv"/></check>
  <check name="http-404"><http url="http://localhost:${port}/missing.csv"/></check>
  <check name="http-404-errorsBeginAt"><http url="http://localhost:${port}/missing.csv" errorsBeginAt="500"/></check>
  <check name="http-head"><http url="http://localhost:${port}/data/stations.csv" requestMethod="HEAD"/></check>
  <check name="socket-open"><socket server="localhost" port="${port}"/></check>
  <check name="socket-closed"><socket server="localhost" port="9"/></check>
  <check name="isreachable-localhost"><isreachable host="localhost" timeout="2"/></check>
</target>

$ ant -q -Dport=8765 network
     [echo] http-ok: true
     [echo] http-404: false
     [echo] http-404-errorsBeginAt: true
     [echo] http-head: true
     [echo] socket-open: true
     [echo] socket-closed: false
     [echo] isreachable-localhost: true
BUILD SUCCESSFUL
Total time: 0 seconds

<target name="scriptcondition">
  <condition property="r">
    <scriptcondition language="javascript" value="true">self.setValue(false);</scriptcondition>
  </condition>
</target>

$ ant -q scriptcondition
Java 15 has removed Nashorn, you must provide an engine for running JavaScript yourself. GraalVM JavaScript currently is the preferred option.
BUILD FAILED
/work/tidepool/build.xml:96: Unable to create javax script engine for javascript
Total time: 0 seconds
$ echo $?
1

<target name="guarded" depends="probe" unless="skip.import">
  <echo message="importing"/>
</target>

$ ant -q -f flow.xml -Dskip.import=true guarded
     [echo] have.stations=true have.tides=${have.tides} have.model=${have.model}
BUILD SUCCESSFUL
Total time: 0 seconds

<target name="uptodate" depends="clean">
  <echo file="${out}/report.txt" message="report${line.separator}"/>
  <sleep milliseconds="1100"/>
  <touch file="data/stations.csv"/>
  <uptodate property="report.current" targetfile="${out}/report.txt">
    <srcfiles dir="data" includes="*.csv"/>
  </uptodate>
  <echo message="after touching the sources: report.current=${report.current}"/>
  <sleep milliseconds="1100"/>
  <touch file="${out}/report.txt"/>
  <uptodate property="report.current" targetfile="${out}/report.txt">
    <srcfiles dir="data" includes="*.csv"/>
  </uptodate>
  <echo message="after touching the report: report.current=${report.current}"/>
</target>

$ ant -q -f flow.xml uptodate
     [echo] after touching the sources: report.current=${report.current}
     [echo] after touching the report: report.current=true
BUILD SUCCESSFUL
Total time: 2 seconds

<target name="task-level">
  <echo if:true="${strict}">strict build</echo>
  <echo unless:true="${strict}">relaxed build</echo>
  <echo if:set="release.version">releasing ${release.version}</echo>
  <echo unless:blank="${release.version}">version is not blank</echo>
</target>

$ ant -q -f flow.xml task-level
     [echo] relaxed build
     [echo] version is not blank
BUILD SUCCESSFUL
Total time: 0 seconds

$ ant -q -f flow.xml -Dstrict=true -Drelease.version=2.0 task-level
     [echo] strict build
     [echo] releasing 2.0
     [echo] version is not blank
BUILD SUCCESSFUL
Total time: 0 seconds