test-audit.xml

<?xml version="1.0" encoding="UTF-8"?>
<!--

    Units of Measurement TCK
    Copyright © 2005-2023, Jean-Marie Dautelle, Werner Keil, Otavio Santana.

    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 JSR-385 nor the names of its contributors may be used to endorse or promote products
       derived from this software without specific prior written permission.

    THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
    AND ANY EXPRESS 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 THE COPYRIGHT HOLDER OR 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.

-->
<specification
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://jboss.com/products/weld/tech.units.tck/audit"
	xsi:schemaLocation="http://jboss.com/products/weld/tech.units.tck/audit"
	name="JSR 385 Units of Measurement" version="2.2" id="JSR 385"
	generateSectionIds="false">
	<section id="0" title="TCK Setup">
		<!-- Tests class TCKSetupTest -->
		<group>
			<text>Tests the correct setup of the TCK</text>
			<assertion id="Setup">
				<text>Ensure an implementation of
					tech.units.tck.util.ServiceConfiguration is registered using the
					java.util.ServiceLoader.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4" title="API" />
	<section id="4.1" title="Packages and fundamental types">
		<group>
			<text>Unit implementation</text>
			<assertion id="41-A1">
				<text>Ensure at least one javax.measure.Unit implementation
					is
					available/registered.
				</text>
			</assertion>
		</group>
		<group>
			<text>Dimension implementation</text>
			<assertion id="41-A2">
				<text>Ensure at least one javax.measure.Dimension implementation
					is
					available/registered.
				</text>
			</assertion>
		</group>
		<group>
			<text>Prefix implementation</text>
			<assertion id="41-A3">
				<text>Ensure at least one javax.measure.Prefix implementation
					is
					available/registered.
				</text>
			</assertion>
		</group>
		<group>
			<text>Quantity implementation</text>
			<assertion id="41-A4">
				<text>Ensure at least one javax.measure.Quantity implementation
					is
					available/registered.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4.2" title="The Unit Interface" />

	<section id="4.2.1" title="Operations on Units">
		<group>
			<text>Basic Operations</text>
			<assertion id="421-A1">
				<text>Ensure the equals() operation is implemented.
				</text>
			</assertion>
			<assertion id="421-A2">
				<text>Ensure getDimension is implemented.
				</text>
			</assertion>
			<assertion id="421-A3">
				<text>Ensure registered Unit classes implement getSystemUnit.
				</text>
			</assertion>
			<assertion id="421-A4">
				<text>Ensure registered Unit classes implement getBaseUnits.
				</text>
			</assertion>
			<assertion id="421-A5">
				<text>Ensure registered Unit classes implement getName.
				</text>
			</assertion>
			<assertion id="421-A6">
				<text>Ensure registered Unit classes implement getSymbol.
				</text>
			</assertion>
			<assertion id="421-A7">
				<text>Ensure registered Unit classes override hashCode.
				</text>
			</assertion>
			<assertion id="421-A8">
                <text>Ensure registered Unit classes override isEquivalentTo.
                </text>
            </assertion>
			<assertion id="421-A9">
				<text>Ensure registered Unit classes override toString.
				</text>
			</assertion>
		</group>
	</section>
	<section id="4.2.1.2" title="Unit Operations">
		<group>
			<text>Operations on Units with same dimension as the operand</text>
			<assertion id="42121-A1">
				<text>4.2.1.2.1 Ensure the alternate() operation is implemented.
				</text>
			</assertion>
			<assertion id="42121-A2">
				<text>4.2.1.2.1 Ensure the divide() operation is implemented.
				</text>
			</assertion>
			<assertion id="42121-A3">
				<text>4.2.1.2.1 Ensure the divide(double) operation is implemented.
				</text>
			</assertion>
			<assertion id="42121-A4">
				<text>4.2.1.2.1 Ensure the divide(Number) operation is implemented.
				</text>
			</assertion>
			<assertion id="42121-A5">
				<text>4.2.1.2.1 Ensure the multiply() operation is implemented.
				</text>
			</assertion>
			<assertion id="42121-A6">
				<text>4.2.1.2.1 Ensure the multiply(double) operation is
					implemented.
				</text>
			</assertion>
			<assertion id="42121-A7">
				<text>4.2.1.2.1 Ensure the multiply(Number) operation is
					implemented.
				</text>
			</assertion>
			<assertion id="42121-A8">
				<text>Ensure the prefix() operation is implemented.
				</text>
			</assertion>
			<assertion id="42121-A9">
				<text>Ensure the shift(double) operation is implemented.
				</text>
			</assertion>
			<assertion id="42121-A10">
				<text>Ensure the shift(Number) operation is implemented.
				</text>
			</assertion>
		</group>
		<group>
			<text>Operations on Units with different dimension as the operand
			</text>
			<assertion id="42122-A1">
				<text>4.2.1.2.2 Ensure the pow() operation is implemented.
				</text>
			</assertion>
			<assertion id="42122-A2">
				<text>4.2.1.2.1 Ensure the multiply() operation is implemented.
				</text>
			</assertion>
			<assertion id="42122-A3">
				<text>4.2.1.2.2 Ensure the transform() operation is implemented.
				</text>
			</assertion>
		</group>
		<group>
			<text>Unary Operations on Units</text>
			<assertion id="42123-A1">
				<text>4.2.1.2.3 Ensure the inverse() operation is implemented.
				</text>
			</assertion>
		</group>
		<group>
			<text>Type Operations on Units</text>
			<assertion id="42124-A1">
				<text>4.2.1 Ensure the isCompatible() operation is implemented.
				</text>
			</assertion>
			<assertion id="42124-A2">
				<text>4.2.1 Ensure the asType() operation is implemented.
				</text>
			</assertion>
			<assertion id="42124-A3">
				<text>4.2.1 Ensure the getConverterTo() operation is implemented.
				</text>
			</assertion>
			<assertion id="42124-A4">
				<text>4.2.1 Ensure the getConverterToAny() operation is implemented.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4.2.3" title="Unit Conversion">
		<group>
			<text>Setup</text>
			<assertion id="423-A1">
				<text>Ensure at least one javax.measure.UnitConverter implementation
					is available/registered.
				</text>
			</assertion>
		</group>
		<group>
			<text>Conversion Operations</text>

			<assertion id="423-A2">
				<text>Ensure the equals() operation is implemented.
				</text>
			</assertion>
			<assertion id="423-A3">
				<text>Ensure the hashCode() operation is implemented.
				</text>
			</assertion>
			<assertion id="423-A4">
				<text>Ensure the inverse() method is implemented.
				</text>
			</assertion>
			<assertion id="423-A5">
				<text>Ensure the isIdentity() method is implemented.
				</text>
			</assertion>
			<assertion id="423-A6">
				<text>Ensure the isLinear() method is implemented.
				</text>
			</assertion>
			<assertion id="423-A7">
				<text>Ensure the convert() operation is implemented.
				</text>
			</assertion>
			<assertion id="423-A8">
				<text>Ensure the convert() operation is implemented.
				</text>
			</assertion>
			<assertion id="423-A9">
				<text>Ensure the concatenate() operation is implemented.
				</text>
			</assertion>
			<assertion id="423-A10">
				<text>Ensure the getConversionSteps() operation is implemented.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4.2.4" title="Prefix">
		<group>
			<text>Prefix Operations</text>

			<assertion id="424-A1">
				<text>Ensure the equals() operation is implemented.
				</text>
			</assertion>
			<assertion id="424-A2">
				<text>Ensure the hashCode() operation is implemented.
				</text>
			</assertion>
			<assertion id="424-A3">
				<text>Ensure supported Prefix implementations override getName.
				</text>
			</assertion>
			<assertion id="424-A4">
				<text>Ensure supported Prefix implementations override getSymbol.
				</text>
			</assertion>
			<assertion id="424-A5">
				<text>Ensure supported Prefix implementations override getValue.
				</text>
			</assertion>
			<assertion id="424-A6">
				<text>Ensure supported Prefix implementations override getExponent.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4.2.5" title="Unit Dimension">
		<group>
			<text>Dimension Operations</text>

			<assertion id="425-A1">
				<text>Ensure the equals() operation is implemented.
				</text>
			</assertion>
			<assertion id="425-A2">
				<text>Ensure the hashCode() operation is implemented.
				</text>
			</assertion>
			<assertion id="425-A3">
				<text>Ensure registered Dimension classes override multiply.
				</text>
			</assertion>
			<assertion id="425-A4">
				<text>Ensure registered Dimension classes override divide.
				</text>
			</assertion>
			<assertion id="425-A5">
				<text>Ensure registered Dimension classes override root.
				</text>
			</assertion>
			<assertion id="425-A6">
				<text>Ensure registered Dimension classes override pow.
				</text>
			</assertion>
			<assertion id="425-A7">
				<text>Ensure registered Dimension classes override
					getBaseDimensions.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4.3" title="The Quantity Interface" />

	<section id="4.3.1" title="Operations on Quantities">
		<group>
			<text>Basic Operations</text>

			<assertion id="431-A1">
				<text>Ensure the asType() operation is implemented.
				</text>
			</assertion>
			<assertion id="431-A2">
				<text>Ensure the equals() operation is implemented.
				</text>
			</assertion>
			<assertion id="431-A3">
				<text>Ensure the getScale() method is implemented.
				</text>
			</assertion>
			<assertion id="431-A4">
                <text>Ensure the getUnit() method is implemented.
                </text>
            </assertion>
			<assertion id="431-A5">
				<text>Ensure the getValue() method is implemented.
				</text>
			</assertion>
			<assertion id="431-A6">
                <text>Ensure the hashCode() operation is implemented.
                </text>
            </assertion>
            <assertion id="431-A7">
                <text>Ensure the isEquivalentTo() operation is implemented.
                </text>
            </assertion>
			<assertion id="431-A8">
				<text>Ensure the inverse() method is implemented.
				</text>
			</assertion>
			<assertion id="431-A9">
				<text>Ensure the to() method is implemented.
				</text>
			</assertion>
			<assertion id="431-A10">
				<text>Ensure the Quantity implementation is comparable.
				</text>
			</assertion>
		</group>
	</section>
	<section id="4.3.1.1"
		title="Operations on Quantities with same dimension as the operand">
		<group>
			<text>Result with same dimension</text>

			<assertion id="4311-A1">
				<text>Ensure the add() operation is implemented.
				</text>
			</assertion>
			<assertion id="4311-A4">
				<text>Ensure the multiply() operation is implemented.
				</text>
			</assertion>
			<assertion id="4311-A5">
				<text>Ensure the divide() operation is implemented.
				</text>
			</assertion>
			<assertion id="4311-A6">
				<text>Ensure the sbtract() operation is implemented.
				</text>
			</assertion>
		</group>
	</section>
	<section id="4.3.1.2"
		title="Operations on Quantities with different dimension as the operand">
		<group>
			<text>Result with different dimension</text>
			<assertion id="4312-A1">
				<text>Ensure the divide() operation is implemented.
				</text>
			</assertion>
			<assertion id="4312-A2">
				<text>Ensure the multiply() operation is implemented.
				</text>
			</assertion>
		</group>
	</section>
	<section id="4.4" title="Supported Quantities">
		<group>
			<text>Base Quantities</text>
			<assertion id="44-A1">
				<text>Ensure all SI Base Quantities are used by an implementation.
				</text>
			</assertion>
		</group>
		<group>
			<text>Derived Quantities</text>
			<assertion id="44-A2">
				<text>Ensure all Supported Quantities are used by an implementation.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4.5" title="Unit Formatting">
		<group>
			<text>UnitFormat implementation</text>
			<assertion id="45-A1">
				<text>Ensure at least one javax.measure.format.UnitFormat
					implementation
					is available/registered.
				</text>
			</assertion>
		</group>
		<group>
			<text>UnitFormat methods</text>
			<assertion id="45-A2">
				<text>4.5 Ensure the format() operation is implemented.
				</text>
			</assertion>
			<assertion id="45-A3">
				<text>4.5 Ensure the appendable format() operation is implemented.
				</text>
			</assertion>
			<assertion id="45-A4">
				<text>4.5 Ensure the isLocaleSensitive() method is implemented.
				</text>
			</assertion>
			<assertion id="45-A5">
				<text>4.5 Ensure the label() operation is implemented.
				</text>
			</assertion>
			<assertion id="45-A6">
				<text>4.5 Ensure the parse() operation is implemented.
				</text>
			</assertion>
		</group>
	</section>

	<section id="4.6" title="Quantity Formatting">
		<group>
			<text>QuantityFormat implementation</text>
			<assertion id="46-A1">
				<text>Ensure at least one javax.measure.format.QuantityFormat
					implementation
					is available/registered.
				</text>
			</assertion>
		</group>
		<group>
			<text>QuantityFormat methods</text>
			<assertion id="46-A2">
				<text>4.6 Ensure the format() operation is implemented.
				</text>
			</assertion>
			<assertion id="46-A3">
				<text>4.6 Ensure the appendable format() operation is implemented.
				</text>
			</assertion>
			<assertion id="46-A4">
				<text>4.6 Ensure the isLocaleSensitive() method is implemented.
				</text>
			</assertion>
			<assertion id="46-A5">
				<text>4.6 Ensure the parse() operation is implemented.
				</text>
			</assertion>
		</group>
	</section>

	<section id="5" title="SPI" />
	<section id="5.1" title="Quantity Factory">
		<group>
			<text>Ensure the Quantity Factory methods are implemented.</text>
			<assertion id="51-A1">
				<text>Ensure a QuantityFactory implementation exists for every
					ServiceProvider
				</text>
			</assertion>
			<assertion id="51-A2">
				<text>Ensure every QuantityFactory creates quantities with the
					correct scale
				</text>
			</assertion>
		</group>
	</section>
	<section id="5.2" title="System of Units">
		<group>
			<text>System of Unit methods.</text>

			<assertion id="52-A1">
				<text>Ensure at least one javax.measure.spi.SystemOfUnits
					implementation is available
				</text>
			</assertion>
			<assertion id="52-A2">
				<text>Ensure the getName() method is implemented.
				</text>
			</assertion>
			<assertion id="52-A3">
				<text>Ensure the getUnit() method is implemented.
				</text>
			</assertion>
			<assertion id="52-A4">
				<text>Ensure the getUnit(String) method is implemented.
				</text>
			</assertion>
			<assertion id="52-A5">
				<text>Ensure the getUnits() method is implemented.
				</text>
			</assertion>
			<assertion id="52-A6">
				<text>Ensure the getUnits(Dimension) method is implemented.
				</text>
			</assertion>
		</group>
	</section>
	<section id="5.3" title="Service Provider">
		<group>
			<text>ServiceProvider
				</text>
			<assertion id="53-A1">
				<text>Available ServiceProviders are not null.
				</text>
			</assertion>
			<assertion id="53-A2">
				<text>ServiceProvider has available instances.
				</text>
			</assertion>
			<assertion id="53-A3">
				<text>ServiceProvider has a current instance.
				</text>
			</assertion>
			<assertion id="53-A4">
				<text>ServiceProvider has a priority.
				</text>
			</assertion>
		</group>
	</section>
	<section id="5.4" title="Services">
		<group>
			<text>Services Methods</text>

			<assertion id="54-A01">
				<text>Access available FormatServices.
				</text>
			</assertion>
			<assertion id="54-A02">
				<text>Access available QuantityFormats in FormatServices.
				</text>
			</assertion>
			<assertion id="54-A03">
                <text>Access default QuantityFormat in FormatServices.
                </text>
            </assertion>
            <assertion id="54-A04">
                <text>Access available UnitFormats in FormatServices.
                </text>
            </assertion>
            <assertion id="54-A05">
                <text>Access default UnitFormat in FormatServices.
                </text>
            </assertion>
			<assertion id="54-A06">
				<text>Access available SystemOfUnitsServices.
				</text>
			</assertion>
			<assertion id="54-A07">
				<text>Access default SystemOfUnits in SystemOfUnitsService.
				</text>
			</assertion>
			<assertion id="54-A08">
				<text>Access available Systems OfUnits in SystemOfUnitsService.
				</text>
			</assertion>
			<assertion id="54-A09">
				<text>Access Binary Prefixes in SystemOfUnitsService.
				</text>
			</assertion>
			<assertion id="54-A10">
				<text>Access Metric Prefixes in SystemOfUnitsService.
				</text>
			</assertion>
		</group>
	</section>
	<section id="5.5" title="Obtaining Unit Instances" />
	<section id="5.5.1" title="Units Obtained from Unit Systems">
		<group>
			<text>Units Obtained from Unit Systems</text>
			<assertion id="551-A1">
				<text>Access a SystemOfUnits for each registered unit.
				</text>
			</assertion>
		</group>
	</section>
	<section id="5.5.2" title="Units Obtained by Symbol Parsing">
		<group>
			<text>Units Obtained by Symbol Parsing</text>
			<assertion id="552-A1">
				<text>Parse the string representation of each registered unit.
				</text>
			</assertion>
		</group>
	</section>
	<section id="5.6" title="Obtaining Quantity Instances" />
	<section id="5.6.1" title="Quantities Obtained from a factory">
		<group>
			<text>Quantities obtained from a factory</text>
			<assertion id="561-A1">
				<text>Test QuantityFactoryService provides a QuantityFactory for
					each base quantity.
				</text>
			</assertion>
			<assertion id="561-A2">
				<text>5.6.1 Quantities obtained from a factory has create method
				</text>
			</assertion>
			<assertion id="561-A3">
				<text>5.6.1 Quantities obtained from a factory has getSystemUnit
					method
				</text>
			</assertion>
			<assertion id="561-A4">
                <text>5.6.1 Quantities Obtained from a string representation
                </text>
            </assertion>
		</group>
	</section>
</specification>