Skip to content

Commit

Permalink
Initial import
Browse files Browse the repository at this point in the history
  • Loading branch information
@clarkware
clarkware committed Aug 21, 2008
0 parents commit 0fdfa75
Show file tree
Hide file tree
Showing 30 changed files with 4,143 additions and 0 deletions.
112 changes: 112 additions & 0 deletions CHANGES
@@ -0,0 +1,112 @@
JUnitPerf Change Log


Version 1.9 - 2/16/04
----------------------

- When using the Swing test runner, the progress bar now turns red
when a TimedTest fails. In prior releases, when a test failed a
failure message was printed but the progress bar stayed green.
Thanks to those folks who do use the graphical runner for
performance tests for pointing out this bug!


Version 1.8 - 9/3/02
--------------------

- Documentation edits and additions.

- Added the ExampleThroughputUnderLoadTest and
ExampleResponseTimeUnderLoadTest to the samples.

- Added the TimedTest.setQuiet() method to optionally disable output
of the test's elapsed time.


Version 1.7 - 2/26/02
---------------------

- The TestMethodFactory can be used to load test a single test method
while ensuring that each concurrent user thread uses a thread-local
instance of the test.


Version 1.6 - 11/23/01
----------------------

- If a threaded test in a load test has been stopped, either by using
the "Stop" button of the Swing UI or using the haltonfailure="yes"
attribute of a JUnit Ant task, the stopped or failed test is
cancelled and the currently active threaded tests of the load test
are allowed to complete. Prior to this upgrade, if a threaded test
was stopped, the load test would hang while waiting for the threaded
test to report its completion.


Version 1.5 - 9/8/01
---------------------

- Added the TestFactory class to allow stateful tests to be decorated
as LoadTest instances. Use of a TestFactory ensures that each
LoadTest thread uses its own decorated test instance.


Version 1.4 - 6/12/01
---------------------

- A TimedTest can now be constructed to fail immediately if the
maximum elapsed time of the decorated test is exceeded. In other
words, the TimedTest will not wait for the decorated test to run to
completion if the maximum elapsed time is exceeded.

- The TimedTest.outOfTime() method was added to unambiguously
determine whether the test failed due to the maximum elapsed time
being exceeded or the test itself failing.

- The LoadTest class now supports enforcing test atomicity using the
setEnforceTestAtomicity() method. By default, test atomicity is not
enforced for test cases that spawn threads, either directly or
indirectly.

- The TimedTest.toString() method now includes an indication of
whether the timed test will wait for test completion (WAITING) or
wait for the maximum elapsed time to expire (NON-WAITING).

- The LoadTest.toString() method now includes an indication of whether
the load test will enforce test atomicity by waiting for control to
return (ATOMIC) or waiting for all threaded tests to complete
(NON-ATOMIC).


Version 1.3 - 5/11/01
---------------------

- The LoadTest class now employs a ThreadBarrier to allow threads
spawned directly by a load test to properly signal their
completion. Threads spawned by decorated tests, either directly or
indirectly, without a specified thread group are added to the
ThreadedTestGroup by default. This was causing the active count of
the thread group to never fall to 0, thereby causing the load test
to hang indefinitely.


Version 1.2 - 4/23/01
---------------------

- Replaced the ThreadBarrier with a ThreadedTestGroup to catch and
handle uncaught exceptions thrown by threads spawned by
ThreadedTest. This improves thread safety and supports test
atomicity (as defined by transaction processing) when enabled.

- Added several variants of LoadTest constructors for convenience and
extensibility.

- Updated JUnitPerf.html and ExampleLoadTest.java to include more
examples for constructing LoadTest instances with various
constructors.


Version 1.1 - 3/3/01
--------------------

- Initial public release
29 changes: 29 additions & 0 deletions LICENSE
@@ -0,0 +1,29 @@
Copyright (C) 2001 Clarkware Consulting, Inc.
All Rights Reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions
are met:

1. Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in the
documentation and/or other materials provided with the distribution.

3. Neither the name of Clarkware Consulting, Inc. nor the names of its
contributors may be used to endorse or promote products derived
from this software without prior written permission. For written
permission, please contact clarkware@clarkware.com.

THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED WARRANTIES,
INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL
CLARKWARE CONSULTING OR ITS CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA,
OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
43 changes: 43 additions & 0 deletions README
@@ -0,0 +1,43 @@

J U N I T P E R F


What is it?
-----------

JUnitPerf is a collection of JUnit test extensions for performance and
scalability testing.


The Latest Version
------------------

The latest version of JUnitPerf is available at
http://www.clarkware.com/software/junitperf.zip.


Documentation
-------------

Documentation is available in HTML format, in the docs/ directory.
For the installation and user manual, see docs/JUnitPerf.html.
For the API documentation, see docs/api/index.html.


Support
---------

If you have any questions, comments, enhancement requests, success
stories, or bug reports regarding JUnitPerf, or if you want to be
notified when new versions of JUnitPerf are available, please email
mike@clarkware.com.


Licensing
---------

This software is licensed under the terms you may find in the file
named "LICENSE" in this directory.


Thanks for using JUnitPerf!
199 changes: 199 additions & 0 deletions build.xml
@@ -0,0 +1,199 @@
<?xml version="1.0"?>

<project name="junitperf" default="test">

<description>
Builds and tests JUnitPerf.
</description>

<property file="build.properties"/>
<property environment="env"/>

<property name="Name" value="${ant.project.name}"/>
<property name="version" value="1.9.1"/>

<property name="src.dir" location="src"/>
<property name="test.dir" location="test"/>
<property name="build.dir" location="build"/>
<property name="docs.dir" location="docs"/>
<property name="dist.dir" location="dist"/>
<property name="run.dir" location="${build.dir}"/>

<property name="javadoc.dir" location="${build.dir}/docs/api"/>
<property name="dist.name" value="${Name}-${version}"/>
<property name="package.dir" location="${dist.dir}/${dist.name}"/>
<property name="test.reports.dir" location="${build.dir}/reports" />

<property name="build.debug" value="true"/>

<path id="project.classpath">
<pathelement location="${build.dir}"/>
</path>

<target name="prepare">
<tstamp />
<mkdir dir="${build.dir}"/>
<available property="junit.available"
classname="junit.framework.TestCase"/>
<fail message="Missing junit.jar in system CLASSPATH"
unless="junit.available"/>
</target>

<target name="compile" depends="prepare"
description="Compiles the source code">
<javac srcdir="${src.dir}"
destdir="${build.dir}"
debug="${build.debug}">
<classpath refid="project.classpath"/>
</javac>
</target>

<target name="compile-samples" depends="compile"
description="Compiles the samples tests">
<javac srcdir="samples"
destdir="${build.dir}"
debug="${build.debug}">
<classpath refid="project.classpath"/>
</javac>
</target>

<target name="compile-tests" depends="compile"
if="junit.available"
description="Compiles the test code">
<javac srcdir="${test.dir}"
destdir="${build.dir}"
debug="${build.debug}">
<classpath refid="project.classpath"/>
</javac>
</target>

<target name="test" depends="compile-tests, test-samples"
if="junit.available"
description="Runs all the tests">
<junit haltonfailure="yes" fork="yes">
<test name="com.clarkware.junitperf.AllTests"/>
<formatter type="plain" usefile="false"/>
<classpath refid="project.classpath"/>
</junit>
</target>

<target name="test-samples" depends="compile-samples"
if="junit.available"
description="Runs all the sample tests">
<junit haltonfailure="yes" fork="yes">
<test name="com.clarkware.junitperf.ExamplePerfTestSuite"/>
<formatter type="plain" usefile="false"/>
<classpath refid="project.classpath"/>
</junit>
</target>

<target name="test-sample-reports" depends="compile-samples"
description="Runs all the sample tests and generates an HTML report">

<mkdir dir="${test.reports.dir}" />

<junit haltonfailure="no"
printsummary="no"
fork="no"
errorProperty="test.failed"
failureProperty="test.failed">
<formatter type="plain" usefile="false" />
<formatter type="xml" />
<classpath refid="project.classpath" />
<batchtest todir="${test.reports.dir}">
<fileset dir="${build.dir}">
<include name="**/Example*Test.class" />
</fileset>
</batchtest>
</junit>

<junitreport todir="${test.reports.dir}">
<fileset dir="${test.reports.dir}">
<include name="TEST-*.xml" />
</fileset>
<report format="frames" todir="${test.reports.dir}" />
</junitreport>

<fail if="test.failed">
Tests failed! Check test reports at ${test.reports.dir}.
</fail>

</target>

<target name="javadoc" depends="compile"
description="Generates JavaDoc">

<mkdir dir="${javadoc.dir}"/>

<javadoc packagenames="*"
sourcepath="${src.dir}"
destdir="${javadoc.dir}"
author="true"
version="true"
windowtitle="JUnitPerf ${version} API"
doctitle="JUnitPerf ${version} API"
bottom="Copyright &#169; 1999-2005 Clarkware Consulting, Inc.">
<classpath refid="project.classpath"/>
</javadoc>
</target>

<target name="jar" depends="compile"
description="Creates a JAR file">

<mkdir dir="${dist.dir}"/>

<jar destfile="${dist.dir}/${dist.name}.jar"
basedir="${build.dir}" />

</target>

<target name="package"
depends="clean, test, jar, javadoc"
description="Creates a distribution file">

<copy todir="${package.dir}">
<fileset dir="${basedir}">
<include name="build.xml"/>
<include name="README"/>
<include name="CHANGES"/>
<include name="LICENSE"/>
</fileset>
</copy>

<copy todir="${package.dir}/docs">
<fileset dir="${docs.dir}"/>
</copy>

<copy todir="${package.dir}/src">
<fileset dir="${src.dir}"/>
</copy>

<copy todir="${package.dir}/test">
<fileset dir="${test.dir}"/>
</copy>

<copy todir="${package.dir}/samples">
<fileset dir="samples"/>
</copy>

<copy todir="${package.dir}/lib"
file="${dist.dir}/${dist.name}.jar"/>

<tar tarfile="${dist.dir}/${dist.name}.tar.gz"
basedir="${dist.dir}/"
compression="gzip"
includes="${dist.name}/**" />

<zip destfile="${dist.dir}/${dist.name}.zip"
basedir="${dist.dir}/"
includes="${dist.name}/**" />

</target>

<target name="clean"
description="Deletes all build artifacts">
<delete dir="${build.dir}"/>
<delete dir="${dist.dir}"/>
</target>

</project>

0 comments on commit 0fdfa75

Please sign in to comment.