<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership.
The ASF licenses this file to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<project name="JMeter" default="install" basedir=".">
<description>
N.B. To build JMeter from a release you need both the binary and source archives,
and these must be unpacked into the same directory structure.
[The required external jars are only included in the binary release]
To build JMeter from source:
ant [install]
To rebuild:
ant clean install
To update documentation
ant docs-site
ant docs-printable
To build API documentation (Javadoc)
ant docs-api
To build all the docs
ant docs-all
To build all and package up the files for distribution
ant distribution -Djmeter.version=vvvv [-Dsvn.revision=nnnnn]
To create a nightly build (separate bin/src/lib jars):
ant nightly [-Dsvn.revision=nnnnn]
To create tar and tgz of the web-site documentation (docs and api)
ant site [ -Djmeter.version=vvvv ]
For more info:
ant -projecthelp
To diagnose usage of deprecated APIs:
ant -Ddeprecation=on clean compile
</description>
<!--
Note
---- As with most other Jakarta projects, Gump (http://jakarta.apache.org/gump/) is used to
perform automated builds and tests on JMeter.
Gump uses its project/jakarta-jmeter.xml file to determine which target to use.
The current setting is: <ant target="dist">
Any changes to the dependency list for dist may affect Gump.
Now the dist target depends on "assume-libs-present", so if additional libraries are added to that,
the Gump project file for JMeter must also be updated.
Jars that are not required by the dist target do not need to be added to the Gump project file.
-->
<!-- Are we running under Gump? -->
<property name="gump.run" value="false"/>
<!-- The version of this file -->
<property name="version.build" value="$Revision: 785577 $"/>
<!-- Findbugs task and target -->
<!--
Findbugs is licensed under the Lesser GNU Public License
HomePage: http://www.cs.umd.edu/~pugh/java/bugs/
To use the findbugs target, download and install the findbugs binary distribution
Set the value of findbugs.homedir according to where you installed findbugs, for example:
ant findbugs -Dfindbugs.homedir=/etc/findbugs -Dfindbugs.level=medium
[The defaults are /findbugs and medium]
-->
<property name="findbugs.homedir" value="/findbugs" />
<property name="findbugs.level" value="medium" />
<property name="findbugs.xsldir" value="${findbugs.homedir}/src/xsl" />
<property name="findbugs.xslname" value="fancy" />
<property name="findbugs.outName" value="reports/jmeter-fb" />
<target name="findbugs" description="Run the stand-alone Findbugs detector">
<echoproperties prefix="findbugs"/>
<mkdir dir="reports"/>
<taskdef name="findbugs"
classpath="${findbugs.homedir}/lib/findbugs-ant.jar"
classname="edu.umd.cs.findbugs.anttask.FindBugsTask"/>
<findbugs home="${findbugs.homedir}"
output="xml:withMessages"
reportlevel="${findbugs.level}"
excludeFilter="fb-excludes.xml"
jvmargs="-Xms512m -Xmx512m"
outputFile="${findbugs.outName}.xml" >
<class location="${dest.jar}/*.jar" />
<class location="${dest.jar.jmeter}/*.jar" />
<sourcePath path="${src.core}" />
<sourcePath path="${src.http}" />
<sourcePath path="${src.ftp}" />
<sourcePath path="${src.java}" />
<sourcePath path="${src.junit}" />
<sourcePath path="${src.jdbc}" />
<sourcePath path="${src.ldap}" />
<sourcePath path="${src.mail}" />
<sourcePath path="${src.components}" />
<sourcePath path="${src.functions}" />
<class location="${lib.dir}/jorphan.jar" />
<sourcePath path="${src.jorphan}" />
<sourcePath path="${src.tcp}" />
<sourcePath path="${src.jms}" />
<sourcePath path="${src.report}" />
<!-- Path prefix to allow Anakia to find stylesheets if running under Eclipse -->
<!--
Anakia looks for stylesheets relative to the java launch directory.
Use the External Tools properties page to define the variable
as the relative path to the directory where this build file is found.
For example:
eclipse.anakia=workspace/jmeter
An alternative is to define it as a command-line argument on the Main page; this allows one to use a macro name, so is more portable.
For example:
-Declipse.anakia=workspace/${project_name}
WARNING: you must ensure that you have selected a file or directory in
the Navigator pane before attempting to run the build, or Eclipse will
complain that it cannot resolve the variable name, and it can mark the
launch configuration as having failed.
-->
<property name="eclipse.anakia" value="."/>
<!-- Where the build result .jars will be placed -->
<property name="dest.jar" value="lib/ext"/>
<property name="dest.jar.jmeter" value="bin"/>
<!-- Where the API documentation lives -->
<property name="dest.docs.api" value="docs/api"/>
<!-- Where the doc results live -->
<property name="dest.docs" value="docs"/>
<property name="dest.printable_docs" value="printable_docs"/>
<!-- Directory where jars needed for creating documentation live -->
<property name="lib.doc" value="lib/doc"/>
<!-- Directory where these 3rd party libraries live -->
<property name="lib.dir" value="lib"/>
<!-- Directory where API spec libraries live -->
<property name="lib.api" value="lib/api"/>
<!-- Directory where Optional 3rd party libraries live -->
<property name="lib.opt" value="lib/opt"/>
<!-- Other stuff -->
<property name="extras.dir" value="extras"/>
<!-- Where the distribution packages will be created -->
<property name="dist.dir" value="dist"/>
<!-- Where the web-site packages will be created -->
<property name="site.dir" value="site"/>
<!--
Optional jars, not included in distribution.
Any such jars need to be downloaded separately.
These can be put into ${lib.dir} or ${lib.opt}
- both of these are included in the build classpath
Any jars put into ${lib.dir} will be included in
the classpath used by JMeter to load classes.
Jars in ${lib.opt} are NOT normally included by JMeter.
Placing an optional jar in ${lib.opt} means that it
will be included in the build classpath, but it will
not be included in the runtime classpath. This is intended for testing JMeter without the optional Jar file(s).
-->
<target name="init-version">
<tstamp/>
<!--
JMeter version
This is overridden for formal releases.
-->
<property name="jmeter.version" value="2.3.4.${DSTAMP}"/>
<!-- Remember to change "docversion" below if necessary -->
<condition property="implementation.version"
value="${jmeter.version} r${svn.revision}" else="${jmeter.version}">
<isset property="svn.revision"/>
</condition>
<property name="display.version" value="${implementation.version}"/>
<echo level="info">jmeter.version = ${jmeter.version}</echo>
<echo level="info">display.version = ${display.version}</echo>
<echo level="info">implementation.version = ${implementation.version}</echo>
</target>
<!-- JMeter Javadoc version (own variable is used so can be overriden independently) -->
<property name="docversion" value="2.3.4"/>
<!-- Get version from SVN status -->
<target name="init-svnVersion" depends="svnCheck">
<fail message="Could not get SVN revision" unless="svn.revision"/>
<property name="jmeter.version" value="r${svn.revision}"/>
<!-- Copy the value to avoid duplication of revision in Manifests -->
<property name="implementation.version" value="${jmeter.version}"/>
<property name="display.version" value="${jmeter.version}"/>
<echo level="info">svn.revision = ${svn.revision}</echo>
<echo level="info">jmeter.version = ${jmeter.version}</echo>
<echo level="info">display.version = ${display.version}</echo>
<echo level="info">implementation.version = ${implementation.version}</echo>
</target>
<!--
- Check for anakia task
-->
<target name="check-anakia">
<available classpathref="anakia.classpath" classname="org.apache.velocity.anakia.AnakiaTask" property="AnakiaTask.present"/>
<!-- Check for Velocity version 1.5 -->
<available classpathref="anakia.classpath" classname="org.apache.velocity.io.UnicodeInputStream" property="velocity.version.15"/>
<antcall target="report-old-velocity"></antcall>
</target>
<target name="report-anakia-missing" depends="check-anakia" unless="AnakiaTask.present">
<echo>
AnakiaTask is not present, documentation will not be generated.
</echo>
</target>
<target name="report-old-velocity" unless="velocity.version.15" if="AnakiaTask.present">
<echo>
Velocity version appears to be older than 1.5: the documentation may be generated with incorrect line endings.
</echo>
</target>
<target name="run_gui" depends="package" description="Run the JMeter GUI off the jar files">
<java classname="org.apache.jmeter.NewDriver" fork="true">
<classpath>
<pathelement location="${dest.jar.jmeter}/ApacheJMeter.jar"/>
<path refid="classpath"/>
</classpath>
<sysproperty key="jmeter.home" value="${basedir}"/>
</java>
</target>
<target name="package" depends="compile, package-only"
description="Compile everything and create the jars"/>
<!--
N.B. Eclipse (and perhaps other Java IDEs) copies all files to the build directory, unless
told otherwise. This means that there might be copies of property and image files in the
build directory. To avoid including the files twice in the jar file, we include only .class
files in the list of files to be processed from the build tree.
Eclipse has been fixed so that it no longer shows files in the build tree in the Open Resource dialogue,
so having duplicates in the build tree no longer causes confusion.
Note: if built from Eclipse, the build directory will include resources and images,
and Eclipse will thus be able to run JMeter from the default path.
If built using Ant, the build tree will not contain any resources, and thus Eclipse will not be able to
run JMeter unless all the JMeter jars are added.
<!-- perhaps ought to include a basic jmeter.properties file in one of the jars,
given that JMeterUtils looks for it if it cannot find the external one
- otherwise, change utils to ignore it -->
<!-- core -->
<jar jarfile="${dest.jar}/ApacheJMeter_core.jar"
manifest="${build.dir}/MANIFEST_BIN.MF">
<!-- Only include class files from build tree - see above -->
<fileset dir="${build.core}" includes="**/*.class"
excludes="**/BeanShellClient*.class,**/NewDriver*,**/DynamicClassLoader*"/>
<fileset dir="${src.core}" includes="org/apache/jmeter/images/**"
excludes="**/*.properties"/>
<fileset dir="${src.core}" includes="**/*.properties">
<exclude name="*eucJP*"/>
</fileset>
<!-- This file is used by the jmeter -h option -->
<fileset dir="${src.core}" includes="org/apache/jmeter/help.txt"/>
<metainf dir="." includes="LICENSE,NOTICE"/>
</jar>
<!-- jms -->
<!-- Ensure that build dir exists, even if JMS has not been built -->
<mkdir dir="${build.jms}"/>
<jar jarfile="${dest.jar}/ApacheJMeter_jms.jar" manifest="${build.dir}/MANIFEST_BIN.MF">
<fileset dir="${build.jms}" includes="**/*.class" />
<fileset dir="${src.jms}" includes="**/*.properties" />
<metainf dir="." includes="LICENSE,NOTICE"/>
</jar>
<!-- Check that the 3rd party libraries are present -->
<condition property="3rdparty.present">
<and>
<!-- No need to check all jars; just check a few -->
<available classpathref="classpath" classname="org.apache.bsf.BSFEngine"/>
<available classpathref="classpath" classname="org.htmlparser.Parser"/>
<available classpathref="classpath" classname="com.thoughtworks.xstream.XStream"/>
</and>
</condition>
<target name="_message_3rdParty" unless="3rdparty.present">
<echo>Cannot find all the required 3rd party libraries.</echo>
<echo>If building from a release, you need both source and binary archives.</echo>
<fail message="Cannot find required classes"/>
</target>
<target name="install-examples" depends="compile-examples" description="Build and installs the example components.">
<jar jarfile="${dest.jar}/ApacheJMeter_examples.jar" manifest="${build.dir}/MANIFEST_BIN.MF">
<fileset dir="${build.examples}" includes="**/*.class" />
<fileset dir="${src.examples}" includes="**/*.properties" />
<metainf dir="." includes="LICENSE,NOTICE"/>
</jar>
</target>
<!-- list of files needed for a binary distribution (excluding library files) -->
<patternset id="dist.binaries.native">
<include name="LICENSE"/>
<include name="NOTICE"/>
<include name="README"/>
<include name="${dest.jar.jmeter}/BeanShell*.bshrc"/>
<include name="${dest.jar.jmeter}/log4j.conf"/>
<include name="${dest.jar.jmeter}/logkit.xml"/>
<include name="${dest.jar.jmeter}/jmeter.properties"/>
<include name="${dest.jar.jmeter}/upgrade.properties"/>
<include name="${dest.jar.jmeter}/saveservice.properties"/>
<include name="${dest.jar.jmeter}/users.dtd"/>
<include name="${dest.jar.jmeter}/users.xml"/>
<!-- Sample override properties files -->
<include name="${dest.jar.jmeter}/httpclient.parameters"/>
<include name="${dest.jar.jmeter}/system.properties"/>
<include name="${dest.jar.jmeter}/user.properties"/>
<!-- Exclude any files that might be present from testing the release -->
<exclude name="${dest.jar.jmeter}/*.log"/>
<include name="${dest.jar.jmeter}/examples/**"/>
<exclude name="${dest.jar.jmeter}/examples/*.jmx"/>
<include name="${dest.printable_docs}/**"/>
<exclude name="${dest.printable_docs}/**/*.pdf"/>
<exclude name="${dest.printable_docs}/**/*.jmx"/>
<include name="${extras.dir}/**"/>
<exclude name="${extras.dir}/*.jar"/>
<exclude name="${extras.dir}/*.jpg"/>
<exclude name="${extras.dir}/*.jmx"/>
</patternset>
<patternset id="dist.binaries.non.native">
<!-- We also need the css & images for the printable docs -->
<include name="${dest.docs}/css/**"/>
<include name="${dest.docs}/images/**"/>
<include name="${dest.jar.jmeter}/jmeter*"/>
<exclude name="${dest.jar.jmeter}/jmeter.properties"/>
<include name="${dest.jar.jmeter}/mirror-server.*"/>
<include name="${dest.jar.jmeter}/shutdown.*"/>
<include name="${dest.jar.jmeter}/stoptest.*"/>
<!-- Exclude any files that might be present from testing the release -->
<exclude name="${dest.jar.jmeter}/*.log"/>
<include name="${dest.jar}/"/>
<include name="${lib.dir}/bshclient.jar"/>
<include name="${lib.dir}/jorphan.jar"/>
<include name="${lib.dir}/junit/test.jar"/>
<include name="${dest.jar.jmeter}/ApacheJMeter.jar"/>
<include name="${dest.jar.jmeter}/examples/*.jmx"/>
<include name="${dest.printable_docs}/**/*.pdf"/>
<include name="${dest.printable_docs}/**/*.jmx"/>
<include name="${extras.dir}/*.jar"/>
<include name="${extras.dir}/*.jpg"/>
<include name="${extras.dir}/*.jmx"/>
</patternset>
<!--
List of Unix executable files in the binary distribution
These need special handling to create the correct file mode
-->
<property name="dist.executables"
value="${dest.jar.jmeter}/jmeter ${dest.jar.jmeter}/jmeter-server ${dest.jar.jmeter}/*.sh"/>
<!-- List of files in source distribution that are eol=native -->
<patternset id="dist.sources.native">
<include name="LICENSE"/>
<include name="NOTICE"/>
<include name="README"/>
<include name="${src.dir}/**"/>
<exclude name="${src.dir}/**/*.gif"/>
<exclude name="${src.dir}/**/*.jpg"/>
<exclude name="${src.dir}/**/*.png"/>
<include name="${src.docs}/**"/>
<exclude name="${src.docs}/images/**"/>
<exclude name="${src.docs}/**/*.jmx"/>
<exclude name="${src.docs}/**/*.pdf"/>
<exclude name="${src.docs}/**/*.sxi"/>
<exclude name="${src.docs}/**/*.sxw"/>
<include name="${src.test}/**"/>
<include name="build.xml"/>
<include name="build.properties"/>
<include name="${dest.jar.jmeter}/testfiles/**"/>
<exclude name="${dest.jar.jmeter}/testfiles/*.jmx"/>
<exclude name="${dest.jar.jmeter}/testfiles/*.jtl"/>
<!-- This one is generated with EOL=LF -->
<exclude name="${dest.jar.jmeter}/testfiles/BatchTestLocal.xml"/>
<!-- Ignore unit test output -->
<exclude name="${dest.jar.jmeter}/testfiles/*.out"/>
<exclude name="${dest.jar.jmeter}/testfiles/Sample_*.png"/>
<include name="eclipse.classpath"/>
<include name="eclipse.readme"/>
<include name="${lib.dir}/aareadme.txt"/>
<include name="fb-*.x*"/>
<!-- Make sure that the lib/opt directory is included in the archives -->
<include name="${lib.opt}/README.txt"/>
</patternset>
<!-- Convert eol:native source files to appropriate format if required -->
<target name="_filter" unless="native.${eoltype}">
<property name="workdir" value="${dist.dir}/${eoltype}"/>
<echo level="info">Copying files to work directory ${workdir}</echo>
<mkdir dir="${workdir}"/>
<copy includeemptydirs="false" todir="${workdir}">
<fileset dir=".">
<patternset refid="${fileset}"/>
</fileset>
</copy>
<echo level="info">Converting work files to eol=${eoltype}</echo>
<fixcrlf fixlast="false" eol="${eoltype}" srcdir="${workdir}">
</fixcrlf>
</target>
<!-- Files to be included in full download -->
<patternset id="dist_bin_files_native">
<patternset refid="dist.binaries.native"/>
<patternset refid="external.jars.notices"/>
<!-- We don't need the site docs, but we do want Javadoc (e.g. for BeanShell) -->
<include name="${dest.docs.api}/**"/>
<exclude name="${dest.docs.api}/resources/**"/>
</patternset>
<!-- NOTE: the site documents are not included in either archive -->
<!-- Invoke with -Djmeter.version=m.n [email protected] [-Dsvn.revision=nnnnn] [-Ddisplay.version=xxxx]
Creates clean build and all documentation
Creates runtime and source distributions and site documentation
-->
<target name="distribution"
depends="svnCheck,check-versions,clean,install,docs-printable,docs-api,test,_distribution"
description="Build JMeter for end-user distribution"/>
<target name="check-versions">
<fail message="jmeter.version must be defined" unless="jmeter.version"/>
<fail message="svn.revision must be defined" unless="svn.revision"/>
</target>
<target
name="nightly"
depends="init-svnVersion,check-versions,package,docs-printable,pack-nightly"
description="Build JMeter for nightly dir (package docs-printable pack-nightly)"/>
<target name="_eolcheck">
<!-- Determine if the native format is CRLF or LF (or neither) -->
<condition property="native.lf">
<os family="unix"/>
</condition>
<condition property="native.crlf">
<os family="dos"/>
</condition>
<!-- Define native.dir.x as either the source or updated directory as appropriate -->
<condition property="native.dir.lf" value="." else="${dist.dir}/lf">
<isset property="native.lf"/>
</condition>
<condition property="native.dir.crlf" value="." else="${dist.dir}/crlf">
<isset property="native.crlf"/>
</condition>
<echoproperties prefix="native"></echoproperties>
</target>
<!--
Gump targets.
There are separate build, test and documentation projects for the jmeter module.
-->
<!-- Used by project jakarta-jmeter-cvs -->
<target name="gump-build"
depends="_gump_properties,clean,install"
description="Build JMeter">
<property name="dist.name" value="jakarta-jmeter-${jmeter.version}"/>
<!-- No need to create the archives for Gump
<antcall target="_pack-binaries"/>
<antcall target="_pack-libraries"/>
<antcall target="_pack-source"/>
-->
</target>
<!-- Used by project jakarta-jmeter -->
<target name="gump-compile"
depends="_gump_properties,clean,compile"
description="Compile JMeter only">
</target>
<!-- Used by project jakarta-jmeter-test -->
<target name="gump-test"
depends="_gump_properties,compile-tests,_test"
description="Test JMeter in Gump">
<!-- Show the log file
<concat>
<filelist dir="bin" files="jmeter-test.log" />
</concat>
-->
<!--antcall target="gump-check"/-->
</target>
<target name="gump-check">
<!-- check if /usr and /x1 are the same -->
<checksum file="/usr/local/gump/public/workspace/jakarta-jmeter-22/lib/jorphan.jar" property="usrMD5"/>
<echo>usrMD5 = ${usrMD5}</echo>
<checksum file="/x1/gump/public/workspace/jakarta-jmeter-22/lib/jorphan.jar" property="x1MD5"/>
<echo>x1MD5 = ${x1MD5}</echo>
</target>
<!-- Used by project jakarta-jmeter-javadoc -->
<target name="gump-javadoc"
depends="_gump_properties,docs-api"
description="Create JMeter javadocs">
<property name="dist.name" value="jakarta-jmeter-${jmeter.version}"/>
<antcall target="_pack-javadoc"/>
</target>
<!-- Create a zip of all resource files for translators -->
<target name="pack-resources">
<mkdir dir="${dist.dir}"/>
<zip zipfile="${dist.dir}/resources.zip">
<zipfileset dir="." defaultexcludes="yes">
<patternset excludes="${src.dir}/examples/**" />
<patternset includes="${src.dir}/**/*Resources.properties" />
<patternset includes="${src.dir}/**/messages.properties" />
<patternset includes="${src.dir}/**/i18nedit.properties" />
</zipfileset>
</zip>
</target>
<!--
Utility target to create MD5 checksums in standard format (with *filename)
Usage:
<antcall target="_hash">
<param name="path" value="archive.jar|zip|gz"/>
</antcall>
-->
<!--
Clean-docs and clean-apidocs can be used to empty the docs or docs/api directories.
This should be done before regenerating the documents for a release so that any obsolete files are detected.
-->
<target name="clean-docs">
<delete>
<fileset dir="${dest.docs}" excludes=".svn/** api/**"/>
</delete>
</target>
<target name="docs-api" description="Generate the API documentation.">
<tstamp>
<!-- Used to ensure end-year is up to date -->
<format property="THISYEAR" pattern="yyyy"/>
</tstamp>
<mkdir dir="${dest.docs.api}"/>
<delete quiet="true">
<fileset dir="${dest.docs.api}" includes="**/*.html"/>
</delete>
<echo level="info">Updating overview to ${docversion}</echo>
<replaceregexp match="version [\d.]+"
replace="version ${docversion}"
flags="g" byline="true">
<fileset dir="${src.docs}" includes="overview.html" />
</replaceregexp>
<javadoc
sourcepathref="srcpaths"
overview="${src.docs}/overview.html"
additionalparam="-breakiterator"
destdir="${dest.docs.api}" protected="yes"
version="yes"
doctitle="Apache JMeter API"
windowtitle="Apache JMeter API"
header="<b>Apache JMeter</b>"
bottom="Copyright &#xA9; 1998-${THISYEAR} Apache Software Foundation. All Rights Reserved."
packagenames="org.apache.jmeter.*,org.apache.jorphan.*"
excludepackagenames="org.apache.jorphan.timer">
<classpath refid="classpath"/>
<link href="http://java.sun.com/j2se/1.4.2/docs/api/"/>
</javadoc>
</target>
<!--
Run Doccheck: See http://java.sun.com/j2se/javadoc/doccheck/docs/DocCheck.html
and http://java.sun.com/j2se/javadoc/doccheck/
Download the doclet, and put the jar in lib/opt.
Output is in reports/ directory
-->
<target name="docs-check">
<javadoc sourcepathref="srcpaths"
destdir="reports"
docletpath="${lib.opt}/doccheck.jar"
packagenames="org.apache.jmeter.*,org.apache.jorphan.*"
excludepackagenames="org.apache.jmeter.util.keystore,org.apache.jorphan.timer">
<classpath refid="classpath"/>
<doclet name="com.sun.tools.doclets.doccheck.DocCheck">
<!--
-execDepth: 1=org.* 2=org.apache.* 3+=org.apache.jmeter.*
-evident does not seem to work
-->
<param name="-execDepth" value="3"/>
<param name="-evident" value="4"/>
</doclet>
</javadoc>
</target>
<target name="docs-site" depends="init-docs" if="AnakiaTask.present" description="Generate browsable HTML documentation in web-site format.">
<taskdef name="anakia" classpathref="anakia.classpath" classname="org.apache.velocity.anakia.AnakiaTask"/>
<!-- The extending pages are rather out of date (and not linked from elsewhere) -->
<anakia basedir="${src.docs}" destdir="${dest.docs}/" extension=".html" style="${eclipse.anakia}/xdocs/stylesheets/site.vsl" projectFile="./stylesheets/project.xml"
excludes="**/stylesheets/** extending.xml extending/*.xml"
includes="**/*.xml" lastModifiedCheck="true" velocityPropertiesFile="${src.docs}/velocity.properties"/>
<echo level="info">Fixing EOL</echo>
<fixcrlf srcdir="${dest.docs}/" includes="**/*.html" excludes="api/**" fixlast="false"/>
<echo level="info">Copying files</echo>
<copy todir="${dest.docs}/css">
<fileset dir="${src.css}"/>
</copy>
<copy todir="${dest.docs}/images">
<fileset dir="${src.images}"/>
</copy>
<copy todir="${dest.docs}/demos">
<fileset dir="${src.demos}"/>
</copy>
<copy todir="${dest.docs}/usermanual">
<fileset file="${src.docs}/usermanual/*.pdf"/>
</copy>
<copy todir="${dest.docs}/extending">
<fileset file="${src.docs}/extending/jmeter_tutorial.pdf"/>
</copy>
</target>
<target name="docs-printable" depends="init-docs" if="AnakiaTask.present" description="Generate printable HTML documentation.">
<taskdef name="anakia" classpathref="anakia.classpath" classname="org.apache.velocity.anakia.AnakiaTask"/>
<!-- The extending pages are rather out of date (and not linked from elsewhere) -->
<anakia basedir="${src.docs}" destdir="${dest.printable_docs}/" extension=".html" style="${eclipse.anakia}/xdocs/stylesheets/site_printable.vsl" projectFile="./stylesheets/printable_project.xml"
excludes="**/stylesheets/** extending.xml extending/*.xml"
includes="**/*.xml" lastModifiedCheck="true" velocityPropertiesFile="${src.docs}/velocity.properties"/>
<echo level="info">Fixing EOL</echo>
<fixcrlf srcdir="${dest.printable_docs}/" includes="**/*.html" fixlast="false"/>
<!--
Share images with non-printable version
Means printable version won't work on web-site
-->
<echo level="info">Copying files</echo>
<copy todir="${dest.docs}/css">
<fileset dir="${src.css}"/>
</copy>
<copy todir="${dest.docs}/images">
<fileset dir="${src.images}"/>
</copy>
<copy todir="${dest.printable_docs}/demos">
<fileset dir="${src.demos}"/>
</copy>
<copy todir="${dest.printable_docs}/usermanual">
<fileset file="${src.docs}/usermanual/*.pdf"/>
</copy>
<copy todir="${dest.printable_docs}/extending">
<fileset file="${src.docs}/extending/jmeter_tutorial.pdf"/>
</copy>
</target>
<target name="test" depends="compile-tests,_test,batchtest,batchtestserver"
description="Run tests (use -Djava.awt.headless=true on systems without graphic displays)"/>
<java classname="org.apache.jmeter.NewDriver" fork="yes" dir="${basedir}/bin">
<classpath>
<fileset dir="${dest.jar.jmeter}" includes="*.jar"/>
<fileset dir="${dest.jar}" includes="*.jar"/>
<path refid="classpath"/>
</classpath>
<!-- Detect if non-GUI runs OK headless by forcing it to try using non-headless mode -->
<sysproperty key="java.awt.headless" value="false"/>
<arg value="-ptestfiles/jmeter-batch.properties"/>
<arg value="-n"/>
<arg value="-ttestfiles/${batchtest.name}.jmx"/>
<arg value="-j"/>
<arg value="${batchtest.name}.log"/>
<arg value="-l"/>
<arg value="${batchtest.name}.jtl"/>
<arg value="${remote}"/>
<!-- Check properties can be passed to local/remote tests -->
<arg value="-Jmodule=Module"/>
<arg value="-Gmodule=Module"/>
<!-- Check property can be used for filenames in local/remote tests (no need to defined as -G) -->
<arg value="-JCSVFILE=${batchtest.name}.csv"/>
</java>
<!-- Show the log file -->
<concat>
<filelist dir="${batchtest.out}" files="${batchtest.name}.log" />
</concat>
<condition property="BatchTestLocal.len">
<length file="${batchtest.out}/${batchtest.name}.log" when="equal" length="0" />
</condition>
<fail unless="BatchTestLocal.len">
Error detected in log file. See above.
</fail>
<deleteworkfiles/>
</target>
<!-- Generic test target, not intended to be called directly -->
<target name="_test">
<!--
The property java.awt.headless is not automatically passed on,
because the tests are run in a separate JVM from the build.
It is assumed that Gump sets java.awt.headless if required.
Set test.headless from the java.awt property, if that
is defined, otherwise it us set to "".
N.B. if test.headless is already set, it will not be changed
This allows the property to be over-ridden by test-headless etc.
-->
<condition property="test.headless" value="${java.awt.headless}">
<isset property="java.awt.headless"/>
</condition>
<!-- make sure test.headless is set to something -->
<condition property="test.headless" value="">
<not><isset property="java.awt.headless"/></not>
</condition>
<!-- set build.test.gump to build.test if not already set -->
<condition property="build.test.gump" value="${build.test}">
<not><isset property="build.test.gump"/></not>
</condition>
<echo level="info">
gump.run = ${gump.run}
java.awt.headless = ${java.awt.headless}
test.headless = ${test.headless}
user.dir = ${user.dir}
basedir = ${basedir}
test dir = ${build.test}
test dir gump = ${build.test.gump}
testsaveservice.saveout = ${testsaveservice.saveout}
</echo>
<delete quiet="true">
<fileset dir="${basedir}/bin/testfiles" includes="*.jmx.out"/>
</delete>
<java classname="org.apache.jorphan.test.AllTests" fork="yes" dir="${basedir}/bin">
<classpath>
<fileset dir="${dest.jar}" includes="*.jar"/>
<pathelement location="${build.test}"/>
<path refid="classpath"/>
</classpath>
<jvmarg value="-server"/>
<sysproperty key="java.awt.headless" value="${test.headless}"/>
<sysproperty key="testsaveservice.saveout" value="${testsaveservice.saveout}" />
<arg value="${build.test}"/>
<arg value="${basedir}/bin/testfiles/jmetertest.properties"/>
<arg value="org.apache.jmeter.util.JMeterUtils"/>
</java>
</target>
<!--
In order to run JUnit, both junit.jar and optional.jar need to be on the Ant classpath
optional.jar is normally found in ANT_HOME/lib
-->
<target name="junit" description="Run individual JUnit test">
<mkdir dir="reports"/>
<property name="test.format" value="brief"/>
<property name="test.case" value="org.apache.jorphan.test.AllTests"/>
<junit fork="true"
dir="${basedir}/bin"
showoutput="true"
printsummary="withOutAndErr">
<formatter type="${test.format}" usefile="no"/>
<formatter type="xml"/>
<classpath>
<fileset dir="${dest.jar}" includes="*.jar"/>
<fileset dir="${lib.opt}" includes="*.jar"/>
<path refid="classpath"/>
</classpath>
<test name="${test.case}" todir="reports"/>
</junit>
</target>