We have fixed quite a few bugs and added some significant enhancements
since Apache Commons RNG 1.3 was released, so I would like to release
Apache Commons RNG 1.4.
Apache Commons RNG 1.4 RC1 is available for review here:
https://dist.apache.org/repos/dist/dev/commons/rng/1.4-RC1 (svn
revision 49724)
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/
The Git tag commit for this RC is RNG_1_4_RC1 which you can browse here:
https://gitbox.apache.org/repos/asf?p=commons-rng.git;a=commit;h=RNG_1_4_RC1
You may checkout this tag using:
git clone https://gitbox.apache.org/repos/asf/commons-rng.git --branch
RNG_1_4_RC1 commons-rng-1.4-RC1
(signature can be checked from git using 'git tag -v RNG_1_4_RC1')
Commit ID the tag points at:
6f2e939bc1ae5d7c1317d4fb1af9ef3ac8d45e54
Maven artifacts are here:
https://repository.apache.org/content/repositories/orgapachecommons-1568/org/apache/commons/
These are the artifacts and their hashes:
#Release SHA-512s
#Thu Sep 02 18:11:24 BST 2021
commons-rng-1.4-src.zip=1609416f8852d93f5d139e5c9e9be2f340e90ee2d41d0ecb5543a9bc0e8578d232844b966e65aab12d47acc4df6455012cca03a743dac0e5a6915a58f0c401c8
commons-rng-1.4-src.tar.gz=8665358138395119d7217230ab13e39e83d794524112a99af5ecd6c53bcd9188915e1fa005daa2d21bec7e4d9c0a185df503b8e3e594ffadfc34ffd5b0654669
commons-rng-1.4-bin.tar.gz=670c4cd6309fca836fae5af3e5eb54a1d1c1b0edce4c8fb65ee04fc7e87650a53cd28290578119b8cfd4c3e43039ac7b2efaf269c18d81fd4207ef0d1626f1ed
commons-rng-1.4-bin.zip=5612ad2897958a571e66e7ccff6fe056ed4fb170d2a16c79f5ae08d465e2a81b7c03e69af09fdd1e4f6bb11d1d5bd43034afa126a0a0bc997f4124b7c9387ce5
The source code contains examples that are not part of the public API.
These examples contain Java 11 modules and are enabled using a profile (see
below).
Note: Testing randomness using statistical thresholds results in failures
at a given probability. The 'maven-surefire-plugin' is configured to re-run
tests that fail, and pass the build if they succeed within the allotted
number of reruns (the test will be marked as 'flaky' in the report).
I have tested this with 'mvn clean install' using:
Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
Maven home: /usr/local/apache-maven-3.6.3
Java version: 1.8.0_241, vendor: Oracle Corporation, runtime:
/usr/lib/jvm/jdk1.8.0_241/jre
Default locale: en_GB, platform encoding: UTF-8
OS name: "linux", version: "4.15.0-153-generic", arch: "amd64", family:
"unix"
I have tested this with 'mvn clean package site site:stage
-Pcommons-rng-examples' using:
Apache Maven 3.6.3 (cecedd343002696d0abb50b32b541b8a6ba2883f)
Maven home: /usr/local/apache-maven-3.6.3
Java version: 11.0.11, vendor: Ubuntu, runtime:
/usr/lib/jvm/java-11-openjdk-amd64
Default locale: en_GB, platform encoding: UTF-8
OS name: "linux", version: "4.15.0-153-generic", arch: "amd64", family:
"unix"
Details of changes since 1.3 are in the release notes:
https://dist.apache.org/repos/dist/dev/commons/rng/1.4-RC1/RELEASE-NOTES.txt
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/changes-report.html
Site:
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/index.html
(note some *relative* links are broken and the 1.4 directories are not
yet created - these will be OK once the site is deployed.)
JApiCmp Report (compared to 1.3):
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/commons-rng-client-api/japicmp.html
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/commons-rng-core/japicmp.html
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/commons-rng-simple/japicmp.html
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/commons-rng-sampling/japicmp.html
RAT Report:
https://home.apache.org/~aherbert/commons-rng-1.4-RC1-site/rat-report.html
KEYS:
https://www.apache.org/dist/commons/KEYS
Please review the release candidate and vote.
This vote will close no sooner than 72 hours from now.
[ ] +1 Release these artifacts
[ ] +0 OK, but...
[ ] -0 OK, but really should fix...
[ ] -1 I oppose this release because...
Thank you,
Alex Herbert,
Release Manager (using key BC87A3FD0A54480F0BADBEBD21939FF0CA2A6567)
The following is intended as a helper and refresher for reviewers.
Validating a release candidate
==============================
These guidelines are NOT complete.
Requirements: Git, Java, Maven.
You can validate a release from a release candidate (RC) tag as follows.
1) Clone and checkout the RC tag
git clone https://gitbox.apache.org/repos/asf/commons-rng.git --branch
RNG_1_4_RC1 commons-rng-1.4-RC1
cd commons-rng-1.4-RC1
Alternatively extract the .tar.gz or .zip source archive from the release
artifacts.
2) Check Apache licenses
This step is not required if the site includes a RAT report page which you
then must check.
mvn apache-rat:check
3) Check binary compatibility
This step is not required if the site includes a JApiCmp report page which
you then must check.
mvn package -DskipTests -P japicmp japicmp:cmp
4) Build the package
mvn -V clean verify
You can record the Maven and Java version produced by 'mvn -v' in your VOTE
reply.
To gather OS information from a command line:
Windows: ver
Linux: uname -a
5) Build the site for a multi-module project
mvn package site site:stage
Check the site reports in:
- Windows: target\site\index.html
- Linux: target/site/index.html
-the end-
