commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From bar...@apache.org
Subject [51/51] [partial] commons-rng git commit: Multimodule support
Date Tue, 25 Oct 2016 22:37:49 GMT
Multimodule support


Project: http://git-wip-us.apache.org/repos/asf/commons-rng/repo
Commit: http://git-wip-us.apache.org/repos/asf/commons-rng/commit/42530e25
Tree: http://git-wip-us.apache.org/repos/asf/commons-rng/tree/42530e25
Diff: http://git-wip-us.apache.org/repos/asf/commons-rng/diff/42530e25

Branch: refs/heads/multimodule
Commit: 42530e25b5fb1c077ec0ebf31ece540483e156e4
Parents: 3139232
Author: Artem Barger <artem@bargr.net>
Authored: Fri Oct 21 02:02:07 2016 +0300
Committer: Artem Barger <artem@bargr.net>
Committed: Wed Oct 26 01:36:36 2016 +0300

----------------------------------------------------------------------
 commons-rng-core/clirr-ignored.xml              |   21 +
 commons-rng-core/findbugs-exclude-filter.xml    |   27 +
 commons-rng-core/pmd-ruleset.xml                |   57 +
 commons-rng-core/pom.xml                        |   32 +
 commons-rng-core/src/assembly/bin.xml           |   48 +
 commons-rng-core/src/assembly/src.xml           |   41 +
 commons-rng-core/src/changes/changes.xml        |   64 +
 commons-rng-core/src/changes/release-notes.vm   |  140 +
 .../apache/commons/rng/RandomProviderState.java |   25 +
 .../org/apache/commons/rng/RandomSource.java    |  539 +++
 .../rng/RestorableUniformRandomProvider.java    |   49 +
 .../commons/rng/UniformRandomProvider.java      |  116 +
 .../commons/rng/internal/BaseProvider.java      |  153 +
 .../commons/rng/internal/ProviderBuilder.java   |  381 ++
 .../commons/rng/internal/package-info.java      |   52 +
 .../rng/internal/source32/AbstractWell.java     |  201 +
 .../rng/internal/source32/ISAACRandom.java      |  267 ++
 .../rng/internal/source32/IntProvider.java      |  130 +
 .../rng/internal/source32/JDKRandom.java        |   98 +
 .../rng/internal/source32/KISSRandom.java       |  121 +
 .../rng/internal/source32/MersenneTwister.java  |  244 ++
 .../internal/source32/MultiplyWithCarry256.java |  124 +
 .../rng/internal/source32/RandomIntSource.java  |   30 +
 .../rng/internal/source32/Well1024a.java        |   78 +
 .../rng/internal/source32/Well19937a.java       |   80 +
 .../rng/internal/source32/Well19937c.java       |   56 +
 .../rng/internal/source32/Well44497a.java       |   83 +
 .../rng/internal/source32/Well44497b.java       |   56 +
 .../commons/rng/internal/source32/Well512a.java |   78 +
 .../rng/internal/source32/package-info.java     |   52 +
 .../rng/internal/source64/LongProvider.java     |  134 +
 .../internal/source64/MersenneTwister64.java    |  202 +
 .../rng/internal/source64/RandomLongSource.java |   30 +
 .../rng/internal/source64/SplitMix64.java       |   75 +
 .../commons/rng/internal/source64/TwoCmres.java |  307 ++
 .../rng/internal/source64/XorShift1024Star.java |   94 +
 .../rng/internal/source64/package-info.java     |   52 +
 .../rng/internal/util/ByteArray2IntArray.java   |   39 +
 .../rng/internal/util/ByteArray2LongArray.java  |   39 +
 .../commons/rng/internal/util/Int2Long.java     |   31 +
 .../commons/rng/internal/util/IntArray2Int.java |   35 +
 .../rng/internal/util/IntArray2LongArray.java   |   38 +
 .../commons/rng/internal/util/Long2Int.java     |   30 +
 .../rng/internal/util/Long2IntArray.java        |   44 +
 .../rng/internal/util/Long2LongArray.java       |   50 +
 .../rng/internal/util/LongArray2IntArray.java   |   37 +
 .../rng/internal/util/LongArray2Long.java       |   35 +
 .../rng/internal/util/NoOpConverter.java        |   34 +
 .../rng/internal/util/NumberFactory.java        |  332 ++
 .../rng/internal/util/SeedConverter.java        |   35 +
 .../internal/util/SeedConverterComposer.java    |   50 +
 .../commons/rng/internal/util/SeedFactory.java  |  357 ++
 .../commons/rng/internal/util/package-info.java |   22 +
 .../org/apache/commons/rng/package-info.java    |   95 +
 commons-rng-core/src/site/apt/userguide/rng.apt |  510 +++
 .../site/resources/images/commons_rng.small.png |  Bin 0 -> 89955 bytes
 .../src/site/resources/profile.jacoco           |   17 +
 .../src/site/resources/style/project.css        |   18 +
 .../txt/userguide/stress/dh/run_1/dh_1          |  154 +
 .../txt/userguide/stress/dh/run_1/dh_10         |  178 +
 .../txt/userguide/stress/dh/run_1/dh_11         |  140 +
 .../txt/userguide/stress/dh/run_1/dh_12         |  172 +
 .../txt/userguide/stress/dh/run_1/dh_13         |  138 +
 .../txt/userguide/stress/dh/run_1/dh_14         |  140 +
 .../txt/userguide/stress/dh/run_1/dh_15         |  161 +
 .../txt/userguide/stress/dh/run_1/dh_2          |  172 +
 .../txt/userguide/stress/dh/run_1/dh_3          |  203 +
 .../txt/userguide/stress/dh/run_1/dh_4          |  229 ++
 .../txt/userguide/stress/dh/run_1/dh_5          |  168 +
 .../txt/userguide/stress/dh/run_1/dh_6          |  141 +
 .../txt/userguide/stress/dh/run_1/dh_7          |  170 +
 .../txt/userguide/stress/dh/run_1/dh_8          |  168 +
 .../txt/userguide/stress/dh/run_1/dh_9          |  140 +
 .../txt/userguide/stress/dh/run_2/dh_1          |  151 +
 .../txt/userguide/stress/dh/run_2/dh_10         |  138 +
 .../txt/userguide/stress/dh/run_2/dh_11         |  139 +
 .../txt/userguide/stress/dh/run_2/dh_12         |  171 +
 .../txt/userguide/stress/dh/run_2/dh_13         |  139 +
 .../txt/userguide/stress/dh/run_2/dh_14         |  168 +
 .../txt/userguide/stress/dh/run_2/dh_15         |  143 +
 .../txt/userguide/stress/dh/run_2/dh_2          |  141 +
 .../txt/userguide/stress/dh/run_2/dh_3          |  180 +
 .../txt/userguide/stress/dh/run_2/dh_4          |  151 +
 .../txt/userguide/stress/dh/run_2/dh_5          |  142 +
 .../txt/userguide/stress/dh/run_2/dh_6          |  258 ++
 .../txt/userguide/stress/dh/run_2/dh_7          |  175 +
 .../txt/userguide/stress/dh/run_2/dh_8          |  139 +
 .../txt/userguide/stress/dh/run_2/dh_9          |  169 +
 .../txt/userguide/stress/dh/run_3/dh_1          |  150 +
 .../txt/userguide/stress/dh/run_3/dh_10         |  169 +
 .../txt/userguide/stress/dh/run_3/dh_11         |  140 +
 .../txt/userguide/stress/dh/run_3/dh_12         |  138 +
 .../txt/userguide/stress/dh/run_3/dh_13         |  291 ++
 .../txt/userguide/stress/dh/run_3/dh_14         |  140 +
 .../txt/userguide/stress/dh/run_3/dh_15         |  139 +
 .../txt/userguide/stress/dh/run_3/dh_2          |  141 +
 .../txt/userguide/stress/dh/run_3/dh_3          |  140 +
 .../txt/userguide/stress/dh/run_3/dh_4          |  200 +
 .../txt/userguide/stress/dh/run_3/dh_5          |  139 +
 .../txt/userguide/stress/dh/run_3/dh_6          |  139 +
 .../txt/userguide/stress/dh/run_3/dh_7          |  139 +
 .../txt/userguide/stress/dh/run_3/dh_8          |  170 +
 .../txt/userguide/stress/dh/run_3/dh_9          |  143 +
 .../txt/userguide/stress/tu/run_1/tu_1          | 3879 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_10         | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_11         | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_12         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_13         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_14         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_15         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_2          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_3          | 3807 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_4          | 3805 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_5          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_6          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_7          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_8          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_1/tu_9          | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_1          | 3880 ++++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_10         | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_11         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_12         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_13         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_14         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_15         | 3802 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_2          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_3          | 3807 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_4          | 3807 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_5          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_6          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_7          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_8          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_2/tu_9          | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_1          | 3879 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_10         | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_11         | 3802 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_12         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_13         | 3802 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_14         | 3802 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_15         | 3795 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_2          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_3          | 3808 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_4          | 3805 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_5          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_6          | 3804 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_7          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_8          | 3803 +++++++++++++++++
 .../txt/userguide/stress/tu/run_3/tu_9          | 3802 +++++++++++++++++
 commons-rng-core/src/site/site.xml              |   50 +
 commons-rng-core/src/site/xdoc/developers.xml   |  277 ++
 commons-rng-core/src/site/xdoc/download_rng.xml |   69 +
 commons-rng-core/src/site/xdoc/index.xml        |   82 +
 .../src/site/xdoc/issue-tracking.xml            |  102 +
 commons-rng-core/src/site/xdoc/mail-lists.xml   |  205 +
 .../src/site/xdoc/userguide/index.xml           |   57 +
 .../src/site/xdoc/userguide/xdoc.xsl            |   68 +
 .../commons/rng/AbstractTestPerformance.java    |   59 +
 .../commons/rng/GenerationTestPerformance.java  |  115 +
 .../commons/rng/Providers32ParametricTest.java  |   62 +
 .../commons/rng/Providers64ParametricTest.java  |   62 +
 .../rng/ProvidersCommonParametricTest.java      |  761 ++++
 .../org/apache/commons/rng/ProvidersList.java   |  159 +
 .../org/apache/commons/rng/RandomAssert.java    |   92 +
 .../apache/commons/rng/RandomSourceTest.java    |   69 +
 .../commons/rng/internal/BaseProviderTest.java  |   57 +
 .../rng/internal/source32/ISAACRandomTest.java  |  375 ++
 .../rng/internal/source32/JDKRandomTest.java    |   38 +
 .../rng/internal/source32/KISSRandomTest.java   |  165 +
 .../internal/source32/MersenneTwisterTest.java  |  162 +
 .../source32/MultiplyWithCarry256Test.java      |  195 +
 .../rng/internal/source32/Well1024aTest.java    |   69 +
 .../rng/internal/source32/Well19937aTest.java   |  171 +
 .../rng/internal/source32/Well19937cTest.java   |  171 +
 .../rng/internal/source32/Well44497aTest.java   |  299 ++
 .../rng/internal/source32/Well44497bTest.java   |  299 ++
 .../rng/internal/source32/Well512aTest.java     |   67 +
 .../source64/MersenneTwister64Test.java         |  287 ++
 .../rng/internal/source64/SplitMix64Test.java   |   40 +
 .../rng/internal/source64/TwoCmresTest.java     |   85 +
 .../internal/source64/XorShift1024StarTest.java |   51 +
 .../internal/util/ByteArray2IntArrayTest.java   |   43 +
 .../internal/util/ByteArray2LongArrayTest.java  |   43 +
 .../internal/util/IntArray2LongArrayTest.java   |   39 +
 .../rng/internal/util/NumberFactoryTest.java    |  162 +
 .../rng/internal/util/SeedFactoryTest.java      |  147 +
 commons-rng-core/src/userguide/README.txt       |   22 +
 .../src/userguide/c/rng/stdin2testu01.c         |  127 +
 .../apache/commons/rng/userguide/ComputePi.java |   87 +
 .../commons/rng/userguide/GeneratorsList.java   |   59 +
 .../rng/userguide/MonteCarloIntegration.java    |   90 +
 .../rng/userguide/RandomStressTester.java       |  280 ++
 commons-rng-core/src/userguide/pom.xml          |  101 +
 pom.xml                                         |   96 +-
 src/assembly/bin.xml                            |   48 -
 src/assembly/src.xml                            |   41 -
 src/changes/changes.xml                         |   64 -
 src/changes/release-notes.vm                    |  140 -
 .../apache/commons/rng/RandomProviderState.java |   25 -
 .../org/apache/commons/rng/RandomSource.java    |  539 ---
 .../rng/RestorableUniformRandomProvider.java    |   49 -
 .../commons/rng/UniformRandomProvider.java      |  116 -
 .../commons/rng/internal/BaseProvider.java      |  153 -
 .../commons/rng/internal/ProviderBuilder.java   |  381 --
 .../commons/rng/internal/package-info.java      |   52 -
 .../rng/internal/source32/AbstractWell.java     |  201 -
 .../rng/internal/source32/ISAACRandom.java      |  267 --
 .../rng/internal/source32/IntProvider.java      |  130 -
 .../rng/internal/source32/JDKRandom.java        |   98 -
 .../rng/internal/source32/KISSRandom.java       |  121 -
 .../rng/internal/source32/MersenneTwister.java  |  244 --
 .../internal/source32/MultiplyWithCarry256.java |  124 -
 .../rng/internal/source32/RandomIntSource.java  |   30 -
 .../rng/internal/source32/Well1024a.java        |   78 -
 .../rng/internal/source32/Well19937a.java       |   80 -
 .../rng/internal/source32/Well19937c.java       |   56 -
 .../rng/internal/source32/Well44497a.java       |   83 -
 .../rng/internal/source32/Well44497b.java       |   56 -
 .../commons/rng/internal/source32/Well512a.java |   78 -
 .../rng/internal/source32/package-info.java     |   52 -
 .../rng/internal/source64/LongProvider.java     |  134 -
 .../internal/source64/MersenneTwister64.java    |  202 -
 .../rng/internal/source64/RandomLongSource.java |   30 -
 .../rng/internal/source64/SplitMix64.java       |   75 -
 .../commons/rng/internal/source64/TwoCmres.java |  307 --
 .../rng/internal/source64/XorShift1024Star.java |   94 -
 .../rng/internal/source64/package-info.java     |   52 -
 .../rng/internal/util/ByteArray2IntArray.java   |   39 -
 .../rng/internal/util/ByteArray2LongArray.java  |   39 -
 .../commons/rng/internal/util/Int2Long.java     |   31 -
 .../commons/rng/internal/util/IntArray2Int.java |   35 -
 .../rng/internal/util/IntArray2LongArray.java   |   38 -
 .../commons/rng/internal/util/Long2Int.java     |   30 -
 .../rng/internal/util/Long2IntArray.java        |   44 -
 .../rng/internal/util/Long2LongArray.java       |   50 -
 .../rng/internal/util/LongArray2IntArray.java   |   37 -
 .../rng/internal/util/LongArray2Long.java       |   35 -
 .../rng/internal/util/NoOpConverter.java        |   34 -
 .../rng/internal/util/NumberFactory.java        |  332 --
 .../rng/internal/util/SeedConverter.java        |   35 -
 .../internal/util/SeedConverterComposer.java    |   50 -
 .../commons/rng/internal/util/SeedFactory.java  |  357 --
 .../commons/rng/internal/util/package-info.java |   22 -
 .../org/apache/commons/rng/package-info.java    |   95 -
 src/site/apt/userguide/rng.apt                  |  510 ---
 src/site/resources/images/commons_rng.small.png |  Bin 89955 -> 0 bytes
 src/site/resources/profile.jacoco               |   17 -
 src/site/resources/style/project.css            |   18 -
 .../txt/userguide/stress/dh/run_1/dh_1          |  154 -
 .../txt/userguide/stress/dh/run_1/dh_10         |  178 -
 .../txt/userguide/stress/dh/run_1/dh_11         |  140 -
 .../txt/userguide/stress/dh/run_1/dh_12         |  172 -
 .../txt/userguide/stress/dh/run_1/dh_13         |  138 -
 .../txt/userguide/stress/dh/run_1/dh_14         |  140 -
 .../txt/userguide/stress/dh/run_1/dh_15         |  161 -
 .../txt/userguide/stress/dh/run_1/dh_2          |  172 -
 .../txt/userguide/stress/dh/run_1/dh_3          |  203 -
 .../txt/userguide/stress/dh/run_1/dh_4          |  229 --
 .../txt/userguide/stress/dh/run_1/dh_5          |  168 -
 .../txt/userguide/stress/dh/run_1/dh_6          |  141 -
 .../txt/userguide/stress/dh/run_1/dh_7          |  170 -
 .../txt/userguide/stress/dh/run_1/dh_8          |  168 -
 .../txt/userguide/stress/dh/run_1/dh_9          |  140 -
 .../txt/userguide/stress/dh/run_2/dh_1          |  151 -
 .../txt/userguide/stress/dh/run_2/dh_10         |  138 -
 .../txt/userguide/stress/dh/run_2/dh_11         |  139 -
 .../txt/userguide/stress/dh/run_2/dh_12         |  171 -
 .../txt/userguide/stress/dh/run_2/dh_13         |  139 -
 .../txt/userguide/stress/dh/run_2/dh_14         |  168 -
 .../txt/userguide/stress/dh/run_2/dh_15         |  143 -
 .../txt/userguide/stress/dh/run_2/dh_2          |  141 -
 .../txt/userguide/stress/dh/run_2/dh_3          |  180 -
 .../txt/userguide/stress/dh/run_2/dh_4          |  151 -
 .../txt/userguide/stress/dh/run_2/dh_5          |  142 -
 .../txt/userguide/stress/dh/run_2/dh_6          |  258 --
 .../txt/userguide/stress/dh/run_2/dh_7          |  175 -
 .../txt/userguide/stress/dh/run_2/dh_8          |  139 -
 .../txt/userguide/stress/dh/run_2/dh_9          |  169 -
 .../txt/userguide/stress/dh/run_3/dh_1          |  150 -
 .../txt/userguide/stress/dh/run_3/dh_10         |  169 -
 .../txt/userguide/stress/dh/run_3/dh_11         |  140 -
 .../txt/userguide/stress/dh/run_3/dh_12         |  138 -
 .../txt/userguide/stress/dh/run_3/dh_13         |  291 --
 .../txt/userguide/stress/dh/run_3/dh_14         |  140 -
 .../txt/userguide/stress/dh/run_3/dh_15         |  139 -
 .../txt/userguide/stress/dh/run_3/dh_2          |  141 -
 .../txt/userguide/stress/dh/run_3/dh_3          |  140 -
 .../txt/userguide/stress/dh/run_3/dh_4          |  200 -
 .../txt/userguide/stress/dh/run_3/dh_5          |  139 -
 .../txt/userguide/stress/dh/run_3/dh_6          |  139 -
 .../txt/userguide/stress/dh/run_3/dh_7          |  139 -
 .../txt/userguide/stress/dh/run_3/dh_8          |  170 -
 .../txt/userguide/stress/dh/run_3/dh_9          |  143 -
 .../txt/userguide/stress/tu/run_1/tu_1          | 3879 -----------------
 .../txt/userguide/stress/tu/run_1/tu_10         | 3803 -----------------
 .../txt/userguide/stress/tu/run_1/tu_11         | 3803 -----------------
 .../txt/userguide/stress/tu/run_1/tu_12         | 3795 -----------------
 .../txt/userguide/stress/tu/run_1/tu_13         | 3795 -----------------
 .../txt/userguide/stress/tu/run_1/tu_14         | 3795 -----------------
 .../txt/userguide/stress/tu/run_1/tu_15         | 3795 -----------------
 .../txt/userguide/stress/tu/run_1/tu_2          | 3803 -----------------
 .../txt/userguide/stress/tu/run_1/tu_3          | 3807 -----------------
 .../txt/userguide/stress/tu/run_1/tu_4          | 3805 -----------------
 .../txt/userguide/stress/tu/run_1/tu_5          | 3803 -----------------
 .../txt/userguide/stress/tu/run_1/tu_6          | 3803 -----------------
 .../txt/userguide/stress/tu/run_1/tu_7          | 3804 -----------------
 .../txt/userguide/stress/tu/run_1/tu_8          | 3803 -----------------
 .../txt/userguide/stress/tu/run_1/tu_9          | 3795 -----------------
 .../txt/userguide/stress/tu/run_2/tu_1          | 3880 ------------------
 .../txt/userguide/stress/tu/run_2/tu_10         | 3803 -----------------
 .../txt/userguide/stress/tu/run_2/tu_11         | 3795 -----------------
 .../txt/userguide/stress/tu/run_2/tu_12         | 3795 -----------------
 .../txt/userguide/stress/tu/run_2/tu_13         | 3795 -----------------
 .../txt/userguide/stress/tu/run_2/tu_14         | 3795 -----------------
 .../txt/userguide/stress/tu/run_2/tu_15         | 3802 -----------------
 .../txt/userguide/stress/tu/run_2/tu_2          | 3803 -----------------
 .../txt/userguide/stress/tu/run_2/tu_3          | 3807 -----------------
 .../txt/userguide/stress/tu/run_2/tu_4          | 3807 -----------------
 .../txt/userguide/stress/tu/run_2/tu_5          | 3803 -----------------
 .../txt/userguide/stress/tu/run_2/tu_6          | 3804 -----------------
 .../txt/userguide/stress/tu/run_2/tu_7          | 3804 -----------------
 .../txt/userguide/stress/tu/run_2/tu_8          | 3803 -----------------
 .../txt/userguide/stress/tu/run_2/tu_9          | 3795 -----------------
 .../txt/userguide/stress/tu/run_3/tu_1          | 3879 -----------------
 .../txt/userguide/stress/tu/run_3/tu_10         | 3803 -----------------
 .../txt/userguide/stress/tu/run_3/tu_11         | 3802 -----------------
 .../txt/userguide/stress/tu/run_3/tu_12         | 3795 -----------------
 .../txt/userguide/stress/tu/run_3/tu_13         | 3802 -----------------
 .../txt/userguide/stress/tu/run_3/tu_14         | 3802 -----------------
 .../txt/userguide/stress/tu/run_3/tu_15         | 3795 -----------------
 .../txt/userguide/stress/tu/run_3/tu_2          | 3803 -----------------
 .../txt/userguide/stress/tu/run_3/tu_3          | 3808 -----------------
 .../txt/userguide/stress/tu/run_3/tu_4          | 3805 -----------------
 .../txt/userguide/stress/tu/run_3/tu_5          | 3803 -----------------
 .../txt/userguide/stress/tu/run_3/tu_6          | 3804 -----------------
 .../txt/userguide/stress/tu/run_3/tu_7          | 3803 -----------------
 .../txt/userguide/stress/tu/run_3/tu_8          | 3803 -----------------
 .../txt/userguide/stress/tu/run_3/tu_9          | 3802 -----------------
 src/site/site.xml                               |   50 -
 src/site/xdoc/developers.xml                    |  277 --
 src/site/xdoc/download_rng.xml                  |   69 -
 src/site/xdoc/index.xml                         |   82 -
 src/site/xdoc/issue-tracking.xml                |  102 -
 src/site/xdoc/mail-lists.xml                    |  205 -
 src/site/xdoc/userguide/index.xml               |   57 -
 src/site/xdoc/userguide/xdoc.xsl                |   68 -
 .../commons/rng/AbstractTestPerformance.java    |   59 -
 .../commons/rng/GenerationTestPerformance.java  |  115 -
 .../commons/rng/Providers32ParametricTest.java  |   62 -
 .../commons/rng/Providers64ParametricTest.java  |   62 -
 .../rng/ProvidersCommonParametricTest.java      |  761 ----
 .../org/apache/commons/rng/ProvidersList.java   |  159 -
 .../org/apache/commons/rng/RandomAssert.java    |   92 -
 .../apache/commons/rng/RandomSourceTest.java    |   69 -
 .../commons/rng/internal/BaseProviderTest.java  |   57 -
 .../rng/internal/source32/ISAACRandomTest.java  |  375 --
 .../rng/internal/source32/JDKRandomTest.java    |   38 -
 .../rng/internal/source32/KISSRandomTest.java   |  165 -
 .../internal/source32/MersenneTwisterTest.java  |  162 -
 .../source32/MultiplyWithCarry256Test.java      |  195 -
 .../rng/internal/source32/Well1024aTest.java    |   69 -
 .../rng/internal/source32/Well19937aTest.java   |  171 -
 .../rng/internal/source32/Well19937cTest.java   |  171 -
 .../rng/internal/source32/Well44497aTest.java   |  299 --
 .../rng/internal/source32/Well44497bTest.java   |  299 --
 .../rng/internal/source32/Well512aTest.java     |   67 -
 .../source64/MersenneTwister64Test.java         |  287 --
 .../rng/internal/source64/SplitMix64Test.java   |   40 -
 .../rng/internal/source64/TwoCmresTest.java     |   85 -
 .../internal/source64/XorShift1024StarTest.java |   51 -
 .../internal/util/ByteArray2IntArrayTest.java   |   43 -
 .../internal/util/ByteArray2LongArrayTest.java  |   43 -
 .../internal/util/IntArray2LongArrayTest.java   |   39 -
 .../rng/internal/util/NumberFactoryTest.java    |  162 -
 .../rng/internal/util/SeedFactoryTest.java      |  147 -
 src/userguide/README.txt                        |   22 -
 src/userguide/c/rng/stdin2testu01.c             |  127 -
 .../apache/commons/rng/userguide/ComputePi.java |   87 -
 .../commons/rng/userguide/GeneratorsList.java   |   59 -
 .../rng/userguide/MonteCarloIntegration.java    |   90 -
 .../rng/userguide/RandomStressTester.java       |  280 --
 src/userguide/pom.xml                           |  101 -
 381 files changed, 190770 insertions(+), 190687 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/clirr-ignored.xml
----------------------------------------------------------------------
diff --git a/commons-rng-core/clirr-ignored.xml b/commons-rng-core/clirr-ignored.xml
new file mode 100644
index 0000000..ed97259
--- /dev/null
+++ b/commons-rng-core/clirr-ignored.xml
@@ -0,0 +1,21 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<differences>
+
+</differences>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/findbugs-exclude-filter.xml
----------------------------------------------------------------------
diff --git a/commons-rng-core/findbugs-exclude-filter.xml b/commons-rng-core/findbugs-exclude-filter.xml
new file mode 100644
index 0000000..99b2e8a
--- /dev/null
+++ b/commons-rng-core/findbugs-exclude-filter.xml
@@ -0,0 +1,27 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<!--
+  This file contains some false positive bugs detected by findbugs. Their
+  false positive nature has been analyzed individually and they have been
+  put here to instruct findbugs it must ignore them.
+-->
+<FindBugsFilter>
+
+
+</FindBugsFilter>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/pmd-ruleset.xml
----------------------------------------------------------------------
diff --git a/commons-rng-core/pmd-ruleset.xml b/commons-rng-core/pmd-ruleset.xml
new file mode 100644
index 0000000..c637ef7
--- /dev/null
+++ b/commons-rng-core/pmd-ruleset.xml
@@ -0,0 +1,57 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+<ruleset name="commons-rng-customized"
+    xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"
+    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+    xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 http://pmd.sourceforge.net/ruleset_2_0_0.xsd">
+  <description>
+    This ruleset checks the code for discouraged programming constructs.
+  </description>
+
+  <rule ref="rulesets/java/basic.xml"/>
+
+  <rule ref="rulesets/java/braces.xml"/>
+
+  <rule ref="rulesets/java/comments.xml">
+    <exclude name="CommentSize"/>
+  </rule>
+  <rule ref="rulesets/java/comments.xml/CommentSize">
+    <properties>
+      <property name="maxLines"      value="200"/>
+      <property name="maxLineLength" value="256"/>
+    </properties>
+  </rule>
+
+  <rule ref="rulesets/java/empty.xml"/>
+
+  <rule ref="rulesets/java/finalizers.xml"/>
+
+  <rule ref="rulesets/java/imports.xml"/>
+
+  <rule ref="rulesets/java/typeresolution.xml"/>
+
+  <rule ref="rulesets/java/clone.xml"/>
+
+  <rule ref="rulesets/java/unnecessary.xml">
+    <!-- We do use extra parentheses there as most people do not recall operator precedence,
+         this means even if the parentheses are useless for the compiler, we don't consider
+         them useless for the developer. This is the reason why we disable this rule. -->
+    <exclude name="UselessParentheses"/>
+  </rule>
+
+</ruleset>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/pom.xml
----------------------------------------------------------------------
diff --git a/commons-rng-core/pom.xml b/commons-rng-core/pom.xml
new file mode 100644
index 0000000..f3f3dfd
--- /dev/null
+++ b/commons-rng-core/pom.xml
@@ -0,0 +1,32 @@
+<?xml version="1.0"?>
+<project xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"
+         xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
+  <modelVersion>4.0.0</modelVersion>
+
+  <parent>
+    <groupId>org.apache.commons</groupId>
+    <artifactId>commons-rng</artifactId>
+    <version>1.0-SNAPSHOT</version>
+  </parent>
+
+  <groupId>org.apache.commons</groupId>
+  <artifactId>commons-rng-core</artifactId>
+  <version>1.0-SNAPSHOT</version>
+  <name>Apache Commons RNG Core</name>
+  <url>http://maven.apache.org</url>
+
+  <properties>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <inceptionYear>2016</inceptionYear>
+  <description>The Apache Commons RNG Core module includes implementations of random numbers generators.</description>
+
+  <scm>
+    <connection>scm:git:http://git-wip-us.apache.org/repos/asf/commons-rng.git</connection>
+    <developerConnection>scm:git:https://git-wip-us.apache.org/repos/asf/commons-rng.git</developerConnection>
+    <url>https://git-wip-us.apache.org/repos/asf?p=commons-rng.git</url>
+  </scm>
+
+</project>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/assembly/bin.xml
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/assembly/bin.xml b/commons-rng-core/src/assembly/bin.xml
new file mode 100644
index 0000000..a5ff153
--- /dev/null
+++ b/commons-rng-core/src/assembly/bin.xml
@@ -0,0 +1,48 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<assembly>
+  <id>bin</id>
+  <formats>
+    <format>tar.gz</format>
+    <format>zip</format>
+  </formats>
+  <includeSiteDirectory>false</includeSiteDirectory>
+  <fileSets>
+    <fileSet>
+      <includes>
+        <include>LICENSE*</include>
+        <include>NOTICE*</include>
+        <include>RELEASE-NOTES.txt</include>
+      </includes>
+    </fileSet>
+    <fileSet>
+      <directory>target</directory>
+      <outputDirectory></outputDirectory>
+      <includes>
+        <include>*.jar</include>
+      </includes>
+    </fileSet>
+    <fileSet>
+      <directory>target/site</directory>
+      <outputDirectory>docs</outputDirectory>
+      <excludes>
+      </excludes>
+    </fileSet>
+  </fileSets>
+</assembly>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/assembly/src.xml
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/assembly/src.xml b/commons-rng-core/src/assembly/src.xml
new file mode 100644
index 0000000..a78f24f
--- /dev/null
+++ b/commons-rng-core/src/assembly/src.xml
@@ -0,0 +1,41 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+<assembly>
+  <id>src</id>
+  <formats>
+    <format>tar.gz</format>
+    <format>zip</format>
+  </formats>
+  <baseDirectory>
+     ${project.artifactId}-${commons.release.version}-src
+  </baseDirectory>
+  <fileSets>
+    <fileSet>
+      <includes>
+        <include>*.txt</include>
+        <include>*.xml</include>
+      </includes>
+    </fileSet>
+    <fileSet>
+      <directory>src</directory>
+      <excludes>
+      </excludes>
+    </fileSet>
+  </fileSets>
+</assembly>
+

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/changes/changes.xml
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/changes/changes.xml b/commons-rng-core/src/changes/changes.xml
new file mode 100644
index 0000000..5a3c372
--- /dev/null
+++ b/commons-rng-core/src/changes/changes.xml
@@ -0,0 +1,64 @@
+<?xml version="1.0"?>
+<!--
+   Licensed to the Apache Software Foundation (ASF) under one or more
+  contributor license agreements.  See the NOTICE file distributed with
+  this work for additional information regarding copyright ownership.
+  The ASF licenses this file to You under the Apache License, Version 2.0
+  (the "License"); you may not use this file except in compliance with
+  the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+-->
+
+<!--
+This file is used by the maven-changes-plugin to generate the release notes.
+Useful ways of finding items to add to this file are:
+
+1.  Add items when you fix a bug or add a feature (this makes the
+release process easy :-).
+
+2.  Do a JIRA search for tickets closed since the previous release.
+
+3.  Use the report generated by the maven-changelog-plugin to see all
+SVN commits.
+
+To generate the file RELEASE-NOTES.txt from this file:
+
+mvn changes:announcement-generate -Prelease-notes [-Dchanges.version]
+
+The <action> type attribute can be add,update,fix,remove.
+-->
+
+<!-- NOTE:
+The description attribute entries below are specially formatted 
+so as to improve the layout of the generated text release notes.
+
+The parsing process removes all line feeds, replacing them with a single space.
+The Velocity template in src/changes/release-notes.vm has been enhanced to replace pairs of adjacent spaces
+with a new-line in the release notes. (These spaces are ignored when displaying HTML).
+If the output is not quite correct, check for invisible trailing spaces!
+-->
+
+<document>
+  <properties>
+    <title>Apache Commons RNG Release Notes</title>
+  </properties>
+  <body>
+    <release version="1.0" date="TBD" description="
+This is the first release of Apache Commons RNG.
+
+The minimum version of the Java platform required to compile and use
+ Apache Commons RNG 1.0 is Java 6.
+">
+      <!-- <action dev="erans" type="fix" issue="RNG-xxx"> -->
+      <!-- </action> -->
+    </release>
+
+  </body>
+</document>

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/changes/release-notes.vm
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/changes/release-notes.vm b/commons-rng-core/src/changes/release-notes.vm
new file mode 100644
index 0000000..cc1b18c
--- /dev/null
+++ b/commons-rng-core/src/changes/release-notes.vm
@@ -0,0 +1,140 @@
+## Licensed to the Apache Software Foundation (ASF) under one
+## or more contributor license agreements.  See the NOTICE file
+## distributed with this work for additional information
+## regarding copyright ownership.  The ASF licenses this file
+## to you under the Apache License, Version 2.0 (the
+## "License"); you may not use this file except in compliance
+## with the License.  You may obtain a copy of the License at
+##
+##  http://www.apache.org/licenses/LICENSE-2.0
+##
+## Unless required by applicable law or agreed to in writing,
+## software distributed under the License is distributed on an
+## "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+## KIND, either express or implied.  See the License for the
+## specific language governing permissions and limitations
+## under the License.
+
+              ${project.name} ${version} RELEASE NOTES
+
+The ${developmentTeam} is pleased to announce the release of ${finalName}
+
+$introduction.replaceAll("(?<!\015)\012", "
+")
+
+## N.B. the available variables are described here:
+## http://maven.apache.org/plugins/maven-changes-plugin/examples/using-a-custom-announcement-template.html
+##
+## Hack to improve layout: replace all pairs of spaces with a single new-line
+$release.description.replaceAll("  ", "
+")
+
+#if ($release.getActions().size() == 0)
+No changes defined in this version.
+#else
+Changes in this version include:
+
+## indent to be used if there is no issue attribute.
+## should be the same as the indent in the changes.xml file
+## less 2 spaces for the 'o' and trailing space
+#set($indent='          ')
+#if ($release.getActions('add').size() !=0)
+New features:
+#foreach($actionItem in $release.getActions('add'))
+## Use replaceAll to fix up LF-only line ends on Windows.
+#set($action=$actionItem.getAction().replaceAll("\n","
+"))
+#if ($actionItem.getIssue())
+#set($issue=$actionItem.getIssue())
+#else
+#set($issue="")
+#end
+#if ($actionItem.getDueTo())
+#set($dueto=$actionItem.getDueTo())
+#else
+#set($dueto="")
+#end
+o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end
+
+#set($issue="")
+#set($dueto="")
+#end 
+#end
+
+#if ($release.getActions('fix').size() !=0)
+Fixed Bugs:
+#foreach($actionItem in $release.getActions('fix'))
+## Use replaceAll to fix up LF-only line ends on Windows.
+#set($action=$actionItem.getAction().replaceAll("\n","
+"))
+#if ($actionItem.getIssue())
+#set($issue=$actionItem.getIssue())
+#else
+#set($issue="")
+#end
+#if ($actionItem.getDueTo())
+#set($dueto=$actionItem.getDueTo())
+#else
+#set($dueto="")
+#end
+o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end
+
+#set($issue="")
+#set($dueto="")
+#end
+#end
+
+#if ($release.getActions('update').size() !=0)
+Changes:
+#foreach($actionItem in $release.getActions('update'))
+## Use replaceAll to fix up LF-only line ends on Windows.
+#set($action=$actionItem.getAction().replaceAll("\n","
+"))
+#if ($actionItem.getIssue())
+#set($issue=$actionItem.getIssue())
+#else
+#set($issue="")
+#end
+#if ($actionItem.getDueTo())
+#set($dueto=$actionItem.getDueTo())
+#else
+#set($dueto="")
+#end
+o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end
+
+#set($issue="")
+#set($dueto="")
+#end
+#end
+
+#if ($release.getActions('remove').size() !=0)
+Removed:
+#foreach($actionItem in $release.getActions('remove'))
+## Use replaceAll to fix up LF-only line ends on Windows.
+#set($action=$actionItem.getAction().replaceAll("\n","
+"))
+#if ($actionItem.getIssue())
+#set($issue=$actionItem.getIssue())
+#else
+#set($issue="")
+#end
+#if ($actionItem.getDueTo())
+#set($dueto=$actionItem.getDueTo())
+#else
+#set($dueto="")
+#end
+o#if($!issue != "") $issue: #else$indent#end ${action} #if($!dueto != "")Thanks to $dueto. #end
+
+#set($issue="")
+#set($dueto="")
+#end
+#end
+## End of main loop
+#end
+
+For complete information on ${project.name}, including instructions on how to submit bug reports,
+patches, or suggestions for improvement, see the ${project.name} website:
+
+${project.url}
+
+

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/main/java/org/apache/commons/rng/RandomProviderState.java
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/main/java/org/apache/commons/rng/RandomProviderState.java b/commons-rng-core/src/main/java/org/apache/commons/rng/RandomProviderState.java
new file mode 100644
index 0000000..f4af719
--- /dev/null
+++ b/commons-rng-core/src/main/java/org/apache/commons/rng/RandomProviderState.java
@@ -0,0 +1,25 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.rng;
+
+/**
+ * Marker interface for objects that represents the state of a random
+ * generator.
+ *
+ * @since 1.0
+ */
+public interface RandomProviderState {}

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/main/java/org/apache/commons/rng/RandomSource.java
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/main/java/org/apache/commons/rng/RandomSource.java b/commons-rng-core/src/main/java/org/apache/commons/rng/RandomSource.java
new file mode 100644
index 0000000..bab6224
--- /dev/null
+++ b/commons-rng-core/src/main/java/org/apache/commons/rng/RandomSource.java
@@ -0,0 +1,539 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.rng;
+
+import java.util.Arrays;
+
+import org.apache.commons.rng.internal.ProviderBuilder;
+import org.apache.commons.rng.internal.util.SeedFactory;
+
+/**
+ * This class provides the API for creating generators of random numbers.
+ *
+ * <p>Usage examples:</p>
+ * <pre><code>
+ *  UniformRandomProvider rng = RandomSource.create(RandomSource.MT);
+ * </code></pre>
+ * or
+ * <pre><code>
+ *  final int[] seed = new int[] { 196, 9, 0, 226 };
+ *  UniformRandomProvider rng = RandomSource.create(RandomSource.MT, seed);
+ * </code></pre>
+ * or
+ * <pre><code>
+ *  final int[] seed = RandomSource.createIntArray(256);
+ *  UniformRandomProvider rng = RandomSource.create(RandomSource.MT, seed);
+ * </code></pre>
+ * where the first argument to method {@code create} is the identifier
+ * of the generator's concrete implementation, and the second the is the
+ * (optional) seed.
+ *
+ * <p>
+ * In the first form, a random seed will be {@link SeedFactory generated
+ * automatically}; in the second form, a fixed seed is used; a random seed
+ * is explicitly generated in the third form.
+ * </p>
+ *
+ * <p>
+ * Seeding is the procedure by which a value (or set of values) is
+ * used to <i>initialize</i> a generator instance.
+ * The requirement that a given seed will always result in the same
+ * internal state allows to create different instances of a generator
+ * that will produce the same sequence of pseudo-random numbers.
+ * </p>
+ *
+ * <p>
+ * The type of data used as a seed depends on the concrete implementation
+ * as some types may not provide enough information to fully initialize
+ * the generator's internal state.
+ * <br>
+ * The reference algorithm's seeding procedure (if provided) operates
+ * on a value of a (single) <i>native</i> type:
+ * Each concrete implementation's constructor creates an instance using
+ * the native type whose information contents is used to set the
+ * internal state.
+ * <br>
+ * When the seed value passed by the caller is of the native type, it is
+ * expected that the sequences produced will be identical to those
+ * produced by other implementations of the same reference algorithm.
+ * <br>
+ * However, when the seed value passed by the caller is not of the native
+ * type, a transformation is performed by this library and the resulting
+ * native type value will <i>not</i> contain more information than the
+ * original seed value.
+ * If the algorithm's native type is "simpler" than the type passed by
+ * the caller, then some (unused) information will even be lost.
+ * <br>
+ * The transformation from non-native to native seed type is arbitrary,
+ * as long as it does not reduce the amount of information required by
+ * the algorithm to initialize its state.
+ * The consequence of the transformation is that sequences produced
+ * by this library may <i>not</i> be the same as the sequences produced
+ * by other implementations of the same algorithm!
+ * </p>
+ *
+ * <p>
+ * For each algorithm, the Javadoc mentions the "ideal" size of the seed,
+ * meaning the number of {@code int} or {@code long} values that is neither
+ * too large (i.e. some of the seed is useless) or too small (i.e. an
+ * internal procedure will fill the state with redundant information
+ * computed from the given seed).
+ * </p>
+ *
+ * <p>
+ * Note that some algorithms are inherently sensitive to having too low
+ * diversity in their initial state.
+ * For example, it is often a bad idea to use a seed that is mostly
+ * composed of zeroes, or of repeated values.
+ * </p>
+ *
+ * <p>
+ * This class provides methods to generate random seeds (single values
+ * or arrays of values, of {@code int} or {@code long} types) that can
+ * be passed to the {@link RandomSource#create(RandomSource,Object,Object[])
+ * generators factory method}.
+ * </p>
+ * <p>
+ * Although the seed-generating methods defined in this class will likely
+ * return different values each time they are called, there is no guarantee:
+ * </p>
+ * <ul>
+ *  <li>
+ *   In any sub-sequence, it is <a href="https://en.wikipedia.org/wiki/Birthday_problem">
+ *   expected</a> that the same numbers can occur, with a probability getting
+ *   higher as the range of allowed values is smaller and the sequence becomes
+ *   longer.
+ *  </li>
+ *  <li>
+ *   It possible that the resulting "seed" will not be <i>good</i> (i.e.
+ *   it will not generate a sufficiently uniformly random sequence for the
+ *   intended purpose), even if the generator is good!
+ *   The only way to ensure that the selected seed will make the generator
+ *   produce a good sequence is to submit that sequence to a series of
+ *   stringent tests, as provided by tools such as
+ *   <a href="http://www.phy.duke.edu/~rgb/General/dieharder.php">dieharder</a>
+ *   or <a href="http://simul.iro.umontreal.ca/testu01/tu01.html">TestU01</a>.
+ *  </li>
+ * </ul>
+ *
+ * <p>
+ * The current implementations have no provision for producing non-overlapping
+ * sequences.
+ * For parallel applications, a possible workaround is that each thread uses
+ * a generator of a different type (see {@link #TWO_CMRES_SELECT}).
+ * </p>
+ *
+ * <p>
+ * <b>Note:</b>
+ * Seeding is not equivalent to restoring the internal state of an
+ * <i>already initialized</i> generator.
+ * Indeed, generators can have a state that is more complex than the
+ * seed, and seeding is thus a transformation (from seed to state).
+ * Implementations do not provide the inverse transformation (from
+ * state to seed), hence it is not generally possible to know the seed
+ * that would initialize a new generator instance to the current state
+ * of another instance.
+ * Reseeding is also inefficient if the purpose is to continue the
+ * same sequence where another instance left off, as it would require
+ * to "replay" all the calls performed by that other instance (and it
+ * would require to know the number of calls to the primary source of
+ * randomness, which is also not usually accessible).
+ * </p>
+ *
+ * @since 1.0
+ */
+public enum RandomSource {
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.JDKRandom}.
+     * <ul>
+     *  <li>Native seed type: {@code Long}.</li>
+     *  <li>Native seed size: 1.</li>
+     * </ul>
+     */
+    JDK(ProviderBuilder.RandomSourceInternal.JDK),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.Well512a}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 16.</li>
+     * </ul>
+     */
+    WELL_512_A(ProviderBuilder.RandomSourceInternal.WELL_512_A),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.Well1024a}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 32.</li>
+     * </ul>
+     */
+    WELL_1024_A(ProviderBuilder.RandomSourceInternal.WELL_1024_A),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.Well19937a}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 624.</li>
+     * </ul>
+     */
+    WELL_19937_A(ProviderBuilder.RandomSourceInternal.WELL_19937_A),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.Well19937c}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 624.</li>
+     * </ul>
+     */
+    WELL_19937_C(ProviderBuilder.RandomSourceInternal.WELL_19937_C),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.Well44497a}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 1391.</li>
+     * </ul>
+     */
+    WELL_44497_A(ProviderBuilder.RandomSourceInternal.WELL_44497_A),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.Well44497b}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 1391.</li>
+     * </ul>
+     */
+    WELL_44497_B(ProviderBuilder.RandomSourceInternal.WELL_44497_B),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.MersenneTwister}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 624.</li>
+     * </ul>
+     */
+    MT(ProviderBuilder.RandomSourceInternal.MT),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.ISAACRandom}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 256.</li>
+     * </ul>
+     */
+    ISAAC(ProviderBuilder.RandomSourceInternal.ISAAC),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source64.SplitMix64}.
+     * <ul>
+     *  <li>Native seed type: {@code Long}.</li>
+     *  <li>Native seed size: 1.</li>
+     * </ul>
+     */
+    SPLIT_MIX_64(ProviderBuilder.RandomSourceInternal.SPLIT_MIX_64),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source64.XorShift1024Star}.
+     * <ul>
+     *  <li>Native seed type: {@code long[]}.</li>
+     *  <li>Native seed size: 16.</li>
+     * </ul>
+     */
+    XOR_SHIFT_1024_S(ProviderBuilder.RandomSourceInternal.XOR_SHIFT_1024_S),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source64.TwoCmres}.
+     * This generator is equivalent to {@link #TWO_CMRES_SELECT} with the choice of the
+     * pair {@code (0, 1)} for the two subcycle generators.
+     * <ul>
+     *  <li>Native seed type: {@code Integer}.</li>
+     *  <li>Native seed size: 1.</li>
+     * </ul>
+     */
+    TWO_CMRES(ProviderBuilder.RandomSourceInternal.TWO_CMRES),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source64.TwoCmres},
+     * with explicit selection of the two subcycle generators.
+     * The selection of the subcycle generator is by passing its index in the internal
+     * table, a value between 0 (included) and 13 (included).
+     * The two indices must be different.
+     * Different choices of an ordered pair of indices create independent generators.
+     * <ul>
+     *  <li>Native seed type: {@code Integer}.</li>
+     *  <li>Native seed size: 1.</li>
+     * </ul>
+     */
+    TWO_CMRES_SELECT(ProviderBuilder.RandomSourceInternal.TWO_CMRES_SELECT),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source64.MersenneTwister64}.
+     * <ul>
+     *  <li>Native seed type: {@code long[]}.</li>
+     *  <li>Native seed size: 312.</li>
+     * </ul>
+     */
+    MT_64(ProviderBuilder.RandomSourceInternal.MT_64),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.MultiplyWithCarry256}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 257.</li>
+     * </ul>
+     */
+    MWC_256(ProviderBuilder.RandomSourceInternal.MWC_256),
+    /**
+     * Source of randomness is {@link org.apache.commons.rng.internal.source32.KISSRandom}.
+     * <ul>
+     *  <li>Native seed type: {@code int[]}.</li>
+     *  <li>Native seed size: 4.</li>
+     * </ul>
+     */
+    KISS(ProviderBuilder.RandomSourceInternal.KISS);
+
+    /** Internal identifier. */
+    private final ProviderBuilder.RandomSourceInternal internalIdentifier;
+
+    /**
+     * Wraps the internal state of the {@link RestorableUniformRandomProvider}
+     * instances created by this factory.
+     * Its purpose is to store all the data needed to recover the same
+     * state in order to restart a sequence where it left off.
+     * External code should not try to modify the data contained in instances
+     * of this class.
+     */
+    public static class State implements RandomProviderState {
+        /** Internal state. */
+        private final byte[] state;
+
+        /**
+         * Initializes an instance.
+         * The contents of the {@code state} argument is unspecified, and is
+         * guaranteed to be valid only if it was generated by implementations
+         * provided by this library.
+         *
+         * @param state Mapping of all the data which an implementation of
+         * {@link UniformRandomProvider} needs in order to reset its internal
+         * state.
+         */
+        public State(byte[] state) {
+            this.state = Arrays.copyOf(state, state.length);
+        }
+
+        /**
+         * @return the internal state.
+         */
+        public byte[] getState() {
+            return Arrays.copyOf(state, state.length);
+        }
+    }
+
+    /**
+     * @param id Internal identifier.
+     */
+    RandomSource(ProviderBuilder.RandomSourceInternal id) {
+        internalIdentifier = id;
+    }
+
+    /**
+     * @return the internal identifier.
+     */
+    ProviderBuilder.RandomSourceInternal getInternalIdentifier() {
+        return internalIdentifier;
+    }
+
+    /**
+     * Checks whether the type of given {@code seed} is the native type
+     * of the implementation.
+     *
+     * @param seed Seed value.
+     * @return {@code true} if the type of {@code seed} is the native
+     * type for this RNG source.
+     */
+    public boolean isNativeSeed(Object seed) {
+        return internalIdentifier.isNativeSeed(seed);
+    }
+
+    /**
+     * Creates a random number generator with a random seed.
+     *
+     * <p>Usage example:</p>
+     * <pre><code>
+     *  UniformRandomProvider rng = RandomSource.create(RandomSource.MT);
+     * </code></pre>
+     * <p>or, if a {@link RestorableUniformRandomProvider "save/restore"} functionality is needed,</p>
+     * <pre><code>
+     *  RestorableUniformRandomProvider rng = RandomSource.create(RandomSource.MT);
+     * </code></pre>
+     *
+     * @param source RNG type.
+     * @return the RNG.
+     *
+     * @see #create(RandomSource,Object,Object[])
+     */
+    public static RestorableUniformRandomProvider create(RandomSource source) {
+        return create(source, null);
+    }
+
+    /**
+     * Creates a random number generator with the given {@code seed}.
+     *
+     * <p>Usage example:</p>
+     * <pre><code>
+     *  UniformRandomProvider rng = RandomSource.create(RandomSource.TWO_CMRES_SELECT, 26219, 6, 9);
+     * </code></pre>
+     *
+     * <p>Valid types for the {@code seed} are:</p>
+     *  <ul>
+     *   <li>{@code Integer} (or {@code int})</li>
+     *   <li>{@code Long} (or {@code long})</li>
+     *   <li>{@code int[]}</li>
+     *   <li>{@code long[]}</li>
+     *   <li>{@code byte[]}</li>
+     *  </ul>
+     *
+     * <p>Notes:</p>
+     * <ul>
+     *  <li>
+     *   When the seed type passed as argument is more complex (i.e. more
+     *   bits can be independently chosen) than the generator's
+     *   {@link #isNativeSeed(Object) native type}, the conversion of a
+     *   set of different seeds will necessarily result in the same value
+     *   of the native seed type.
+     *  </li>
+     *  <li>
+     *   When the native seed type is an array, the same remark applies
+     *   when the array contains more bits than the state of the generator.
+     *  </li>
+     *  <li>
+     *   When the native seed type is an array and the {@code seed} is
+     *   {@code null}, the size of the generated array will be 128.
+     *  </li>
+     * </ul>
+     *
+     * @param source RNG type.
+     * @param seed Seed value.  It can be {@code null} (in which case a
+     * random value will be used).
+     * @param data Additional arguments to the implementation's constructor.
+     * Please refer to the documentation of each specific implementation.
+     * @return the RNG.
+     * @throws UnsupportedOperationException if the type of the {@code seed}
+     * is invalid.
+     * @throws IllegalStateException if data is missing to initialize the
+     * generator implemented by the given {@code source}.
+     *
+     * @see #create(RandomSource)
+     */
+    public static RestorableUniformRandomProvider create(RandomSource source,
+                                                         Object seed,
+                                                         Object ... data) {
+        return ProviderBuilder.create(source.getInternalIdentifier(), seed, data);
+    }
+
+    /**
+     * Creates a number for use as a seed.
+     *
+     * @return a random number.
+     */
+    public static int createInt() {
+        return SeedFactory.createInt();
+    }
+
+    /**
+     * Creates a number for use as a seed.
+     *
+     * @return a random number.
+     */
+    public static long createLong() {
+        return SeedFactory.createLong();
+    }
+
+    /**
+     * Creates an array of numbers for use as a seed.
+     *
+     * @param n Size of the array to create.
+     * @return an array of {@code n} random numbers.
+     */
+    public static int[] createIntArray(int n) {
+        return SeedFactory.createIntArray(n);
+    }
+
+    /**
+     * Creates an array of numbers for use as a seed.
+     *
+     * @param n Size of the array to create.
+     * @return an array of {@code n} random numbers.
+     */
+    public static long[] createLongArray(int n) {
+        return SeedFactory.createLongArray(n);
+    }
+
+    /**
+     * Wraps the given {@code delegate} generator in a new instance that
+     * does not allow access to the "save/restore" functionality.
+     *
+     * @param delegate Generator to which calls will be delegated.
+     * @return a new instance whose state cannot be saved or restored.
+     */
+    public static UniformRandomProvider unrestorable(final UniformRandomProvider delegate) {
+        return new UniformRandomProvider() {
+            /** {@inheritDoc} */
+            @Override
+            public void nextBytes(byte[] bytes) {
+                delegate.nextBytes(bytes);
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public void nextBytes(byte[] bytes,
+                                  int start,
+                                  int len) {
+                delegate.nextBytes(bytes, start, len);
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public int nextInt() {
+                return delegate.nextInt();
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public int nextInt(int n) {
+                return delegate.nextInt(n);
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public long nextLong() {
+                return delegate.nextLong();
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public long nextLong(long n) {
+                return delegate.nextLong(n);
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public boolean nextBoolean() {
+                return delegate.nextBoolean();
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public float nextFloat() {
+                return delegate.nextFloat();
+            }
+
+            /** {@inheritDoc} */
+            @Override
+            public double nextDouble() {
+                return delegate.nextDouble();
+            }
+        };
+    }
+}

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/main/java/org/apache/commons/rng/RestorableUniformRandomProvider.java
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/main/java/org/apache/commons/rng/RestorableUniformRandomProvider.java b/commons-rng-core/src/main/java/org/apache/commons/rng/RestorableUniformRandomProvider.java
new file mode 100644
index 0000000..476ce7f
--- /dev/null
+++ b/commons-rng-core/src/main/java/org/apache/commons/rng/RestorableUniformRandomProvider.java
@@ -0,0 +1,49 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.rng;
+
+/**
+ * Applies to generators whose internal state can be saved and restored.
+ *
+ * @since 1.0
+ */
+public interface RestorableUniformRandomProvider extends UniformRandomProvider {
+    /**
+     * Saves the state of a generator.
+     *
+     * @return the current state of this instance. It is a value that can
+     * subsequently be passed to the {@link #restoreState(RandomProviderState)
+     * restore} method.
+     * @throws UnsupportedOperationException if the underlying source of
+     * randomness does not support this functionality.
+     */
+    RandomProviderState saveState();
+
+    /**
+     * Restores the state of a generator.
+     *
+     * @param state State which this instance will be set to.
+     * This parameter would usually have been obtained by a call to
+     * {@link #saveState() saveState} performed either on the same
+     * object as this one, or an object of the exact same class.
+     * @throws UnsupportedOperationException if the underlying source of
+     * randomness does not support this functionality.
+     * @throws IllegalArgumentException if it was detected that the
+     * {@code state} argument is incompatible with this intance.
+     */
+    void restoreState(RandomProviderState state);
+}

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/main/java/org/apache/commons/rng/UniformRandomProvider.java
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/main/java/org/apache/commons/rng/UniformRandomProvider.java b/commons-rng-core/src/main/java/org/apache/commons/rng/UniformRandomProvider.java
new file mode 100644
index 0000000..2b974ad
--- /dev/null
+++ b/commons-rng-core/src/main/java/org/apache/commons/rng/UniformRandomProvider.java
@@ -0,0 +1,116 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+package org.apache.commons.rng;
+
+/**
+ * Applies to generators of random number sequences that follow a uniform
+ * distribution.
+ *
+ * @since 1.0
+ */
+public interface UniformRandomProvider {
+    /**
+     * Generates {@code byte} values and places them into a user-supplied array.
+     * <p>
+     * The number of random bytes produced is equal to the length of the
+     * the byte array.
+     * </p>
+     *
+     * @param bytes Byte array in which to put the random bytes.
+     * Cannot be {@code null}.
+     */
+    void nextBytes(byte[] bytes);
+
+    /**
+     * Generates {@code byte} values and places them into a user-supplied array.
+     *
+     * <p>
+     * The array is filled with bytes extracted from random integers.
+     * This implies that the number of random bytes generated may be larger than
+     * the length of the byte array.
+     * </p>
+     *
+     * @param bytes Array in which to put the generated bytes.
+     * Cannot be {@code null}.
+     * @param start Index at which to start inserting the generated bytes.
+     * @param len Number of bytes to insert.
+     * @throws IndexOutOfBoundsException if {@code start < 0} or
+     * {@code start >= bytes.length}.
+     * @throws IndexOutOfBoundsException if {@code len < 0} or
+     * {@code len > bytes.length - start}.
+     */
+    void nextBytes(byte[] bytes,
+                   int start,
+                   int len);
+
+    /**
+     * Generates an {@code int} value.
+     *
+     * @return the next random value.
+     */
+    int nextInt();
+
+    /**
+     * Generates an {@code int} value between 0 (inclusive) and the
+     * specified value (exclusive).
+     *
+     * @param n Bound on the random number to be returned.  Must be positive.
+     * @return a random {@code int} value between 0 (inclusive) and n
+     * (exclusive).
+     * @throws IllegalArgumentException if {@code n} is negative.
+     */
+    int nextInt(int n);
+
+    /**
+     * Generates a {@code long} value.
+     *
+     * @return the next random value.
+     */
+    long nextLong();
+
+    /**
+     * Generates a {@code long} value between 0 (inclusive) and the specified
+     * value (exclusive).
+     *
+     * @param n Bound on the random number to be returned.  Must be positive.
+     * @return a random {@code long} value between 0 (inclusive) and n
+     * (exclusive).
+     * @throws IllegalArgumentException if {@code n} is negative.
+     */
+    long nextLong(long n);
+
+    /**
+     * Generates a {@code boolean} value.
+     *
+     * @return the next random value.
+     */
+    boolean nextBoolean();
+
+    /**
+     * Generates a {@code float} value between 0 and 1.
+     *
+     * @return the next random value between 0 and 1.
+     */
+    float nextFloat();
+
+    /**
+     * Generates a {@code double} value between 0 and 1.
+     *
+     * @return the next random value between 0 and 1.
+     */
+    double nextDouble();
+}

http://git-wip-us.apache.org/repos/asf/commons-rng/blob/42530e25/commons-rng-core/src/main/java/org/apache/commons/rng/internal/BaseProvider.java
----------------------------------------------------------------------
diff --git a/commons-rng-core/src/main/java/org/apache/commons/rng/internal/BaseProvider.java b/commons-rng-core/src/main/java/org/apache/commons/rng/internal/BaseProvider.java
new file mode 100644
index 0000000..9a6eadd
--- /dev/null
+++ b/commons-rng-core/src/main/java/org/apache/commons/rng/internal/BaseProvider.java
@@ -0,0 +1,153 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You under the Apache License, Version 2.0
+ * (the "License"); you may not use this file except in compliance with
+ * the License.  You may obtain a copy of the License at
+ *
+ *      http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.apache.commons.rng.internal;
+
+import org.apache.commons.rng.RestorableUniformRandomProvider;
+import org.apache.commons.rng.RandomProviderState;
+import org.apache.commons.rng.RandomSource;
+
+/**
+ * Base class with default implementation for common methods.
+ */
+public abstract class BaseProvider
+    implements RestorableUniformRandomProvider {
+    /** {@inheritDoc} */
+    @Override
+    public int nextInt(int n) {
+        checkStrictlyPositive(n);
+
+        if ((n & -n) == n) {
+            return (int) ((n * (long) (nextInt() >>> 1)) >> 31);
+        }
+        int bits;
+        int val;
+        do {
+            bits = nextInt() >>> 1;
+            val = bits % n;
+        } while (bits - val + (n - 1) < 0);
+
+        return val;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public long nextLong(long n) {
+        checkStrictlyPositive(n);
+
+        long bits;
+        long val;
+        do {
+            bits = nextLong() >>> 1;
+            val  = bits % n;
+        } while (bits - val + (n - 1) < 0);
+
+        return val;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public RandomProviderState saveState() {
+        return new RandomSource.State(getStateInternal());
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public void restoreState(RandomProviderState state) {
+        if (state instanceof RandomSource.State) {
+            setStateInternal(((RandomSource.State) state).getState());
+        } else {
+            throw new IllegalArgumentException("Foreign instance");
+        }
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public String toString() {
+        return getClass().getName();
+    }
+
+    /**
+     * Creates a snapshot of the RNG state.
+     *
+     * @return the internal state.
+     * @throws UnsupportedOperationException if not implemented.
+     */
+    protected byte[] getStateInternal() {
+        throw new UnsupportedOperationException();
+    }
+
+    /**
+     * Resets the RNG to the given {@code state}.
+     *
+     * @param state State (previously obtained by a call to
+     * {@link #getStateInternal()}).
+     * @throws UnsupportedOperationException if not implemented.
+     *
+     * @see #checkStateSize(byte[],int)
+     */
+    protected void setStateInternal(byte[] state) {
+        throw new UnsupportedOperationException();
+    }
+
+    /**
+     * Checks that the {@code state} has the {@code expected} size.
+     *
+     * @param state State.
+     * @param expected Expected length of {@code state} array.
+     * @throws IllegalArgumentException if {@code state.length != expected}.
+     */
+    protected void checkStateSize(byte[] state,
+                                  int expected) {
+        if (state.length != expected) {
+            throw new IllegalArgumentException("State size must be " + expected +
+                                               " but was " + state.length);
+        }
+    }
+
+    /**
+     * Checks whether {@code index} is in the range {@code [min, max]}.
+     *
+     * @param min Lower bound.
+     * @param max Upper bound.
+     * @param index Value that must lie within the {@code [min, max]} interval.
+     * @throws IndexOutOfBoundsException if {@code index} is not within the
+     * {@code [min, max]} interval.
+     */
+    protected void checkIndex(int min,
+                              int max,
+                              int index) {
+        if (index < min ||
+            index > max) {
+            throw new IndexOutOfBoundsException(index + " is out of interval [" +
+                                                min + ", " +
+                                                max + "]");
+        }
+    }
+
+    /**
+     * Checks that the argument is strictly positive.
+     *
+     * @param n Number to check.
+     * @throws IllegalArgumentException if {@code n <= 0}.
+     */
+    private void checkStrictlyPositive(long n) {
+        if (n <= 0) {
+            throw new IllegalArgumentException("Must be strictly positive: " + n);
+        }
+    }
+}


Mime
View raw message