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-RC2 (svn
revision 49779)
https://home.apache.org/~aherbert/commons-rng-1.4-RC2-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_RC
<https://gitbox.apache.org/repos/asf?p=commons-rng.git;a=commit;h=RNG_1_4_RC1>
2
You may checkout this tag using:
git clone https://gitbox.apache.org/repos/asf/commons-rng.git --branch
RNG_1_4_RC2 commons-rng-1.4-RC2
(signature can be checked from git using 'git tag -v RNG_1_4_RC2')
Commit ID the tag points at:
4d55aebc1e0ac6cab0f451ef5f3f54cd6e5440a6
Maven artifacts are here:
https://repository.apache.org/content/repositories/orgapachecommons-1571/org/apache/commons/commons-rng/1.4/
These are the artifacts and their hashes:
#Release SHA-512s
#Mon Sep 06 10:41:09 BST 2021
commons-rng-1.4-bin.tar.gz=0d3a2b7f35e31f14cd9e204fb69ba973782d5955cf106bf4972831fb19a8e99001a0baef952283103f82be255c33fc218285dea53357dc725c6fa1d5059855db
commons-rng-1.4-bin.zip=2493405ad742a4b26d7c1e7adbfeae2809a2e27f1301c468c9a2fe43e1ebda94393da4d6cbcafb858d95be2bb7b5ef07d105873f2780c336c78c5c9fb0fd8694
commons-rng-1.4-src.tar.gz=5ac9d49c6fc493bf619ce6b0b35cd537528c95094f711debadbce195c87aefbeb19a886ca3bb507954bc1ab8cc20ea5c84cf65e38c67e800d473960def198a9a
commons-rng-1.4-src.zip=8403d574021b4f66bc2cdeb3226a246e5ae9f9b5852bba488ce244f306f7b4f0bb43d7be38993b965c9811c790e2ee5d3d3e77e93474532fee2073a207fc7143
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"
I tested the RC1 issues with the site build have been resolved:
mvn pre-site (does nothing)
mvn site site:stage -DgenerateReports=false
open target/staging/userguide/rng.html#a7._Dependencies
The userguide dependencies section lists Java 1.8+.
Details of changes since 1.3 are in the release notes:
https://dist.apache.org/repos/dist/dev/commons/rng/1.4-RC2/RELEASE-NOTES.txt
https://dist.apache.org/repos/dist/dev/commons/rng/1.4-RC2/site/changes-report.html
Site:
https://dist.apache.org/repos/dist/dev/commons/rng/1.4-RC2/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-RC2-site/commons-rng-client-api/japicmp.html
https://home.apache.org/~aherbert/commons-rng-1.4-RC2-site/commons-rng-core/japicmp.html
https://home.apache.org/~aherbert/commons-rng-1.4-RC2-site/commons-rng-simple/japicmp.html
https://home.apache.org/~aherbert/commons-rng-1.4-RC2-site/commons-rng-sampling/japicmp.html
RAT Report:
https://home.apache.org/~aherbert/commons-rng-1.4-RC2-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) Extract the .tar.gz or .zip source archive from the release artifacts.
unzip commons-rng-1.4-src.zip
cd commons-rng-1.4-src
Alternatively clone and checkout the RC tag
git clone https://gitbox.apache.org/repos/asf/commons-rng.git --branch
RNG_1_4_RC2 commons-rng-1.4-RC2
cd commons-rng-1.4-RC2
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-
