https://github.com/unitsofmeasurement/unit-tck
JSR 385 - Technology Compatibility Kit (TCK)
https://github.com/unitsofmeasurement/unit-tck
compatibility-kit java jcp json jsr jsr363 jsr385 measurement-units quantity tck
Last synced: 22 days ago
JSON representation
JSR 385 - Technology Compatibility Kit (TCK)
- Host: GitHub
- URL: https://github.com/unitsofmeasurement/unit-tck
- Owner: unitsofmeasurement
- License: other
- Created: 2014-04-08T17:46:05.000Z (almost 12 years ago)
- Default Branch: master
- Last Pushed: 2024-08-18T18:34:17.000Z (over 1 year ago)
- Last Synced: 2025-07-14T04:46:15.460Z (7 months ago)
- Topics: compatibility-kit, java, jcp, json, jsr, jsr363, jsr385, measurement-units, quantity, tck
- Language: Java
- Homepage:
- Size: 609 KB
- Stars: 6
- Watchers: 4
- Forks: 5
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
unit-tck
========
JSR 385 Technology Compatibility Kit (TCK)
[](https://maven-badges.herokuapp.com/maven-central/tech.units/unit-tck)
[](https://javadoc.io/doc/tech.units/unit-tck/)
[](https://circleci.com/gh/unitsofmeasurement/unit-tck)
[](https://masterminds.github.io/stability/active.html)
[](http://opensource.org/licenses/BSD-3-Clause)
The current module contains the technology compatibility kit of JSR 385.
To setup the TCK with your implementation you must follow the following steps:
1. Create a new Maven project. You could also use compatible alternatives like Gradle.
2. Add this TCK and your implementation as dependency.
3. Implement a class of type `tech.units.tck.util.ServiceConfiguration`, read the Javadoc, what
you must provide with this class.
## Running
To run the TCK, simply execute
```
mvn clean test
```
1. Go to target - where you can find your TCK test results.
For help on using the TCK you may execute
```
mvn exec:java
```
This will only print instructions, to run the TCK you need to execute it through TestNG.
To get version information you may execute
```
mvn exec:java -Pversion
```
### Profiles
When running the TCK (`mvn test`) by calling the system property
```
-Dtech.units.tck.profile=
```
you may select one of the following **profiles**:
- MINIMAL
- FORMAT
- BASE_QUANTITY
- QUANTITY
- QUANTITY_FORMAT
- SPI
- FULL
The `Full` profile is default whenever you don't explicitly pass a profile.
You may pass the profile name in either case, `TCKRunner` will automatically convert them to UPPERCASE before parsing the name of the profile.
### Other System Properties
In addition to profiles, the following system properties allow you to override default behavior and storage locations of the TCK:
```
-Dtech.units.tck.outputDir=
```
To override the default output directory
```
-Dtech.units.tck.reportFile=
```
To override the default TCK report file
```
-Dtech.units.tck.verbose=true/false
```
To toggle the `verbose` option of the TCK for extended test output. The default is `false`. And you normally won't need to set this unless you require detailed analysis or issue resolution.
## Issues or Appeals
To file issues or TCK appeals, please open a ticket under [unit-tck/issues](https://github.com/unitsofmeasurement/unit-tck/issues).
Choose the label "appeals process" to establish a first-level TCK Appeals Process.