Skip to content

Commit 0c580f6

Browse files
tonygermanotonygermano
committed
build: Standardize test output and decouple JaCoCo coverage
Refactors the Ant build scripts across client, command, donkey, and server projects to improve CI integration and local developer experience. Changes: * Decoupled Coverage: Separated unit test execution (`test-run`) from code coverage instrumentation (`test-coverage`). Developers can now run tests locally without the performance penalty of the JaCoCo agent unless explicitly requested. * Standardized Output: Consolidated all test artifacts into a unified, Gradle-compliant directory structure: - Raw results: `build/test-results/test` - HTML/XML Reports: `build/reports/tests` and `build/reports/jacoco` Single project Usage: - Run standard unit tests: `ant test-run` - Run tests with coverage: `ant test-coverage` Full Build Usage: - Run standard unit tests: `ant -f mirth-build.xml build` - Run tests with coverage: `ant -f mirth-build.xml build -Dcoverage=true` Signed-off-by: Tony Germano <tony@germano.name>
1 parent 41858d4 commit 0c580f6

9 files changed

Lines changed: 404 additions & 144 deletions

File tree

‎client/ant-build.xml‎

Lines changed: 74 additions & 26 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
<projectname="mirth-client"basedir="."default="help"xmlns:unless="ant:unless">
1+
<projectname="mirth-client"basedir="."default="help"
2+
xmlns:jacoco="antlib:org.jacoco.ant"xmlns:unless="ant:unless"xmlns:if="ant:if">
3+
24
<targetname="help">
35
<echo>OIE Client Build Help</echo>
46
<echo>-----------------------</echo>
@@ -352,32 +354,78 @@
352354
resource="org/jacoco/ant/antlib.xml"
353355
classpathref="jacoco.classpath"/>
354356

357+
<targetname="test-coverage"depends="test-compile">
358+
<description>Run unit tests WITH JaCoCo coverage.</description>
359+
360+
<deletedir="${jacoco.data.dir}" />
361+
<deletedir="${reports.jacoco.dir}" />
362+
363+
<jacoco:agentproperty="jacoco.agent.arg"
364+
destfile="${jacoco.exec.file}"
365+
exclclassloader="sun.reflect.DelegatingClassLoader:javassist.Loader" />
366+
367+
<antcalltarget="test-run" />
368+
369+
<jacoco:report>
370+
<executiondata>
371+
<filefile="${jacoco.exec.file}" />
372+
</executiondata>
373+
<structurename="${ant.project.name}">
374+
<classfiles>
375+
<filesetdir="${classes}" />
376+
</classfiles>
377+
<sourcefilesencoding="UTF-8">
378+
<filesetdir="${src}" />
379+
</sourcefiles>
380+
</structure>
381+
<htmldestdir="${reports.jacoco.html}" />
382+
<xmldestfile="${reports.jacoco.xml}"/>
383+
</jacoco:report>
384+
</target>
385+
355386
<targetname="test-run"depends="test-compile">
356-
<propertyname="junit-reports"value="junit-reports" />
357-
<propertyname="code-coverage-reports"value="code-coverage-reports" />
358-
<mkdirdir="${junit-reports}" />
359-
<mkdirdir="${code-coverage-reports}" />
360-
361-
<jacoco:coveragedestfile="${code-coverage-reports}/jacoco.exec"xmlns:jacoco="antlib:org.jacoco.ant"exclclassloader="sun.reflect.DelegatingClassLoader:javassist.Loader" >
362-
<junithaltonfailure="false"failureproperty="test.failed"errorproperty="test.failed"fork="true"forkmode="once">
363-
<jvmargvalue="-Xms128m" />
364-
<jvmargvalue="-Xmx2048m" />
365-
<!-- https://stackoverflow.com/questions/54205486 -->
366-
<jvmargvalue="-Xshare:off" />
367-
<classpath>
368-
<pathrefid="testclasspath" />
369-
<dirsetdir="${test_classes}"/>
370-
</classpath>
371-
<formattertype="xml" />
372-
<batchtesttodir="${junit-reports}">
373-
<filesetdir="${test_classes}">
374-
<includename="**/*Test.class" />
375-
</fileset>
376-
</batchtest>
377-
</junit>
378-
</jacoco:coverage>
379-
380-
<failif="test.failed"message="Unit tests failed. Check reports for details."/>
387+
<description>Run unit tests. Coverage is only enabled if 'jacoco.agent.arg' is set.</description>
388+
389+
<deletedir="${test.results.dir}" />
390+
<deletedir="${reports.tests.dir}" />
391+
<mkdirdir="${test.results.dir}" />
392+
<mkdirdir="${reports.tests.dir}" />
393+
394+
<junithaltonfailure="false"
395+
failureproperty="test.failed"
396+
errorproperty="test.failed"
397+
fork="true"
398+
forkmode="once">
399+
400+
<jvmargvalue="-Xms128m" />
401+
<jvmargvalue="-Xmx2048m" />
402+
<!-- https://stackoverflow.com/questions/54205486 -->
403+
<jvmargvalue="-Xshare:off" />
404+
<jvmargline="${jacoco.agent.arg}"if:set="jacoco.agent.arg" />
405+
406+
<classpath>
407+
<pathrefid="testclasspath" />
408+
<dirsetdir="${test_classes}"/>
409+
</classpath>
410+
411+
<formattertype="xml" />
412+
413+
<batchtesttodir="${test.results.dir}">
414+
<filesetdir="${test_classes}">
415+
<includename="**/*Test.class" />
416+
</fileset>
417+
</batchtest>
418+
</junit>
419+
420+
<!-- Generate HTML report from JUnit XML output -->
421+
<junitreporttodir="${test.results.dir}">
422+
<filesetdir="${test.results.dir}">
423+
<includename="TEST-*.xml"/>
424+
</fileset>
425+
<reportformat="frames"todir="${reports.tests.dir}" />
426+
</junitreport>
427+
428+
<failif="test.failed"message="Unit tests failed. For details, check reports in ${reports.tests.dir}."/>
381429
</target>
382430

383431
<targetname="remove-classes"depends="init">

‎client/build.properties‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# top level directories
22
src=${basedir}/src
33
test=${basedir}/test
4+
build.dir=${basedir}/build
45
server=${basedir}/../server
56
donkey_src=${basedir}/../donkey/src/main/java
67
donkey_lib=${basedir}/../donkey/lib
@@ -13,5 +14,23 @@ dist=${basedir}/dist
1314
# jars
1415
client.jar=mirth-client.jar
1516

17+
# Reports
18+
reports.dir=${build.dir}/reports
19+
20+
# JUnit Raw Results (XML)
21+
test.results.dir=${build.dir}/test-results/test
22+
23+
# JUnit Human-Readable Reports (HTML)
24+
reports.tests.dir=${reports.dir}/tests/test
25+
26+
# JaCoCo Execution Data (.exec)
27+
jacoco.data.dir=${build.dir}/jacoco
28+
jacoco.exec.file=${jacoco.data.dir}/test.exec
29+
30+
# JaCoCo Reports (HTML and XML)
31+
reports.jacoco.dir=${reports.dir}/jacoco/test
32+
reports.jacoco.html=${reports.jacoco.dir}/html
33+
reports.jacoco.xml=${reports.jacoco.dir}/jacocoTestReport.xml
34+
1635
# This value is used as the modified time for the files inside of jar, zip, and war files
1736
archive.entry.date=1999-01-01T00:00:00.000Z

‎command/build.properties‎

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ src=${basedir}/src
33
classes=${basedir}/classes
44
lib=${basedir}/lib
55
conf=${basedir}/conf
6-
build=${basedir}/build
6+
build.dir=${basedir}/build
77
dist=${basedir}/dist
88
test=${basedir}/test
99
testlib=${basedir}/testlib
@@ -14,5 +14,23 @@ server=${basedir}/../server
1414
cli.jar=mirth-cli.jar
1515
cli-launcher.jar=mirth-cli-launcher.jar
1616

17+
# Reports
18+
reports.dir=${build.dir}/reports
19+
20+
# JUnit Raw Results (XML)
21+
test.results.dir=${build.dir}/test-results/test
22+
23+
# JUnit Human-Readable Reports (HTML)
24+
reports.tests.dir=${reports.dir}/tests/test
25+
26+
# JaCoCo Execution Data (.exec)
27+
jacoco.data.dir=${build.dir}/jacoco
28+
jacoco.exec.file=${jacoco.data.dir}/test.exec
29+
30+
# JaCoCo Reports (HTML and XML)
31+
reports.jacoco.dir=${reports.dir}/jacoco/test
32+
reports.jacoco.html=${reports.jacoco.dir}/html
33+
reports.jacoco.xml=${reports.jacoco.dir}/jacocoTestReport.xml
34+
1735
# This value is used as the modified time for the files inside of jar, zip, and war files
1836
archive.entry.date=1999-01-01T00:00:00.000Z

‎command/build.xml‎

Lines changed: 82 additions & 34 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,6 @@
1-
<projectname="mirth-cli"basedir="."default="build"xmlns:unless="ant:unless">
1+
<projectname="mirth-cli"basedir="."default="build"
2+
xmlns:jacoco="antlib:org.jacoco.ant"xmlns:unless="ant:unless"xmlns:if="ant:if">
3+
24
<targetname="init">
35
<propertyfile="build.properties" />
46

@@ -12,7 +14,7 @@
1214

1315
<targetname="clean"depends="init">
1416
<deletedir="${classes}" />
15-
<deletedir="${build}" />
17+
<deletedir="${build.dir}" />
1618
<deletedir="${dist}" />
1719
<deletedir="${test_classes}" />
1820
</target>
@@ -25,28 +27,28 @@
2527
</target>
2628

2729
<targetname="build"depends="compile">
28-
<mkdirdir="${build}" />
30+
<mkdirdir="${build.dir}" />
2931

3032
<!-- log4j2.properties file -->
31-
<mkdirdir="${build}/conf" />
33+
<mkdirdir="${build.dir}/conf" />
3234

33-
<copytodir="${build}/conf">
35+
<copytodir="${build.dir}/conf">
3436
<filesetdir="${conf}" />
3537
</copy>
3638

3739
<!-- cli-lib -->
38-
<mkdirdir="${build}/cli-lib" />
40+
<mkdirdir="${build.dir}/cli-lib" />
3941

40-
<copytodir="${build}/cli-lib">
42+
<copytodir="${build.dir}/cli-lib">
4143
<filesetdir="${lib}" />
4244
</copy>
4345

44-
<jardestfile="${build}/${cli.jar}"basedir="${classes}"modificationTime="${archive.entry.date}">
46+
<jardestfile="${build.dir}/${cli.jar}"basedir="${classes}"modificationTime="${archive.entry.date}">
4547
<includename="com/mirth/connect/cli/**" />
4648
<excludename="com/mirth/connect/cli/launcher/**" />
4749
</jar>
4850

49-
<jardestfile="${build}/${cli-launcher.jar}"basedir="${classes}"modificationTime="${archive.entry.date}">
51+
<jardestfile="${build.dir}/${cli-launcher.jar}"basedir="${classes}"modificationTime="${archive.entry.date}">
5052
<includename="com/mirth/connect/cli/launcher/**" />
5153

5254
<manifest>
@@ -91,31 +93,77 @@
9193
resource="org/jacoco/ant/antlib.xml"
9294
classpathref="jacoco.classpath"/>
9395

96+
<targetname="test-coverage"depends="test-compile">
97+
<description>Run unit tests WITH JaCoCo coverage.</description>
98+
99+
<deletedir="${jacoco.data.dir}" />
100+
<deletedir="${reports.jacoco.dir}" />
101+
102+
<jacoco:agentproperty="jacoco.agent.arg"
103+
destfile="${jacoco.exec.file}"
104+
exclclassloader="sun.reflect.DelegatingClassLoader:javassist.Loader" />
105+
106+
<antcalltarget="test-run" />
107+
108+
<jacoco:report>
109+
<executiondata>
110+
<filefile="${jacoco.exec.file}" />
111+
</executiondata>
112+
<structurename="${ant.project.name}">
113+
<classfiles>
114+
<filesetdir="${classes}" />
115+
</classfiles>
116+
<sourcefilesencoding="UTF-8">
117+
<filesetdir="${src}" />
118+
</sourcefiles>
119+
</structure>
120+
<htmldestdir="${reports.jacoco.html}" />
121+
<xmldestfile="${reports.jacoco.xml}"/>
122+
</jacoco:report>
123+
</target>
124+
94125
<targetname="test-run"depends="test-compile">
95-
<propertyname="junit-reports"value="junit-reports" />
96-
<propertyname="code-coverage-reports"value="code-coverage-reports" />
97-
<mkdirdir="${junit-reports}" />
98-
<mkdirdir="${code-coverage-reports}" />
99-
100-
<jacoco:coveragedestfile="${code-coverage-reports}/jacoco.exec"xmlns:jacoco="antlib:org.jacoco.ant"exclclassloader="sun.reflect.DelegatingClassLoader:javassist.Loader" >
101-
<junithaltonfailure="false"failureproperty="test.failed"errorproperty="test.failed"fork="true"forkmode="once">
102-
<jvmargvalue="-Xms128m" />
103-
<jvmargvalue="-Xmx2048m" />
104-
<!-- https://stackoverflow.com/questions/54205486 -->
105-
<jvmargvalue="-Xshare:off" />
106-
<classpath>
107-
<pathrefid="testclasspath" />
108-
<dirsetdir="${test_classes}"/>
109-
</classpath>
110-
<formattertype="xml" />
111-
<batchtesttodir="${junit-reports}">
112-
<filesetdir="${test_classes}">
113-
<includename="**/*Test.class" />
114-
</fileset>
115-
</batchtest>
116-
</junit>
117-
</jacoco:coverage>
118-
119-
<failif="test.failed"message="Unit tests failed. Check reports for details."/>
126+
<description>Run unit tests. Coverage is only enabled if 'jacoco.agent.arg' is set.</description>
127+
128+
<deletedir="${test.results.dir}" />
129+
<deletedir="${reports.tests.dir}" />
130+
<mkdirdir="${test.results.dir}" />
131+
<mkdirdir="${reports.tests.dir}" />
132+
133+
<junithaltonfailure="false"
134+
failureproperty="test.failed"
135+
errorproperty="test.failed"
136+
fork="true"
137+
forkmode="once">
138+
139+
<jvmargvalue="-Xms128m" />
140+
<jvmargvalue="-Xmx2048m" />
141+
<!-- https://stackoverflow.com/questions/54205486 -->
142+
<jvmargvalue="-Xshare:off" />
143+
<jvmargline="${jacoco.agent.arg}"if:set="jacoco.agent.arg" />
144+
145+
<classpath>
146+
<pathrefid="testclasspath" />
147+
<dirsetdir="${test_classes}"/>
148+
</classpath>
149+
150+
<formattertype="xml" />
151+
152+
<batchtesttodir="${test.results.dir}">
153+
<filesetdir="${test_classes}">
154+
<includename="**/*Test.class" />
155+
</fileset>
156+
</batchtest>
157+
</junit>
158+
159+
<!-- Generate HTML report from JUnit XML output -->
160+
<junitreporttodir="${test.results.dir}">
161+
<filesetdir="${test.results.dir}">
162+
<includename="TEST-*.xml"/>
163+
</fileset>
164+
<reportformat="frames"todir="${reports.tests.dir}" />
165+
</junitreport>
166+
167+
<failif="test.failed"message="Unit tests failed. For details, check reports in ${reports.tests.dir}."/>
120168
</target>
121169
</project>

‎donkey/build.properties‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3,6 +3,7 @@ src=${basedir}/src/main/java
33
classes=${basedir}/classes
44
test=${basedir}/src/test/java
55
test_classes=${basedir}/test_classes
6+
build.dir=${basedir}/build
67
lib=${basedir}/lib
78
testlib=${basedir}/testlib
89
setup=${basedir}/setup
@@ -19,5 +20,23 @@ setup=${basedir}/setup
1920
setup.lib=${setup}/lib
2021
setup.docs=${setup}/docs
2122

23+
# Reports
24+
reports.dir=${build.dir}/reports
25+
26+
# JUnit Raw Results (XML)
27+
test.results.dir=${build.dir}/test-results/test
28+
29+
# JUnit Human-Readable Reports (HTML)
30+
reports.tests.dir=${reports.dir}/tests/test
31+
32+
# JaCoCo Execution Data (.exec)
33+
jacoco.data.dir=${build.dir}/jacoco
34+
jacoco.exec.file=${jacoco.data.dir}/test.exec
35+
36+
# JaCoCo Reports (HTML and XML)
37+
reports.jacoco.dir=${reports.dir}/jacoco/test
38+
reports.jacoco.html=${reports.jacoco.dir}/html
39+
reports.jacoco.xml=${reports.jacoco.dir}/jacocoTestReport.xml
40+
2241
# This value is used as the modified time for the files inside of jar, zip, and war files
2342
archive.entry.date=1999-01-01T00:00:00.000Z

0 commit comments

Comments
 (0)