(update) a few more version upgrades 3.8.1 -> 3.9

Merge branch 'master' of https://github.com/apache/commons-lang into 3.9

LANG-1446: switch from cobertura to jacoco

Preparing the codebase for 3.9

(docs) more specificity

LANG-1442: Javadoc.

https://markmail.org/message/mbp35qav34ifjm4t

(docs) update user use -> user explore

LANG-1442: Commons-RNG citation

LANG-1443: Add more SystemUtils.IS_JAVA_XX variants (#415)

(docs) add "</p>" to end of crypto statement

(fix) unused imports

(docs) remove SecureRandom

(docs) updates to documentation about SecureRandom

Oops, remove dup property.

Update Apache Commons Parent from 47 to 48.

Add proposal for Jenkins Pipeline (#410)

Introduces a Jenkins pipeline with a build stage and an
optional deploy stage that is only executed when master
branch is build.
Post actions send mails in case of build failures.

Update Travis build with current JDKs.

Merge pull request #413 from machaval/patch-1

Fix javadoc in wrapIfMissing

Fix javadoc in wrapIfMissing

wrapIfMissing function was referencing warp function in the javadoc

[LANG-1436] (doc) Fix javadoc for 'startIndex' parameter of
StringUtils.join() methods. GitHub PR #412.

(doc) Fix javadoc for 'startIndex' parameter of StringUtils.join() methods (#412)

Consolidate the StringUtils.equals and equalsIgnoreCase methods. (#409)

* Consolidate the StringUtils.equals and equalsIgnoreCase methods.

Implement the same edge case logic for null. Use the same parameter
names. Use the same Javadoc wording. Change the equals method to use a
step-wise charAt comparison.

* LANG-1436: Added Jira to changes.xml.

Merge pull request #391 from RahulNagekar/JsonToStringStyle_Junits

Adding junits for JsonToStringStyle

Simplify test code by using lambda expressions

Update checkstyle to version 8.17

Update EasyMock to version 4.0.2

Update Hamcrest to version 2.1

Remove dependency management for JUnit (since the update to JUnit 5.4.0 we only have a single JUnit test dependency).

Simplify assertions (closes #404)

Use JUnit methods to clean up the test and simplify the assertions:
- assertArraysEqual(x, y) replaces assertTrue(Arrays.equals(x, y))
- assertEquals(x, y) replaces assertTrue(x == y)
- assertNotEquals(x, y) replaces assertFalse(x == y)

Use assertThrows in FunctionsTest (closes  #404)

Use JUnit Jupiter's elegant assertThrows method instead of the
boilerplate pattern of try-fail-catch to assert an exception was
thrown.

[ToStringBuilderTest] clean up after some old issues

- Remove code to handle old JDK 6 bugs
- Fix a mis-ordered assertEquals
- Remove a deprecated call to Character's constructor

Clean up floating point assertions (closes #402)

JUnit Jupiter 5.4.0 supports deltas of 0 when asserting double and
float equalities.
This patch utilizes these new assertEquals methods and removes the
hack of using assertTrue with an == statement that was needed in older
JUnit versions.

Upgrade JUnit depedency to 5.4.0 (closes #402)

Upgrade the JUnit dependency to the latest available 5.4.0.

Note that JUnit simplified its artifacts, and now it contains a
single, simple org.junit:junit-jupiter artifact.

Skip javadoc on Java 11 to workaround https://bugs.openjdk.java.net/browse/JDK-8212233 which causes javadoc to fail with "Exit code: 1 - javadoc: error - The code being documented uses modules but the packages defined in https://docs.oracle.com/javase/7/docs/api/ are in the unnamed module."

Merge remote-tracking branch 'origin/pr/403'

Fix javadoc errors in Functions.java

FunctionsTest whitespaces

Use four spaces instead of a tab as per the projcet's Checkstyle
rules.

FunctionsTest whitespace after comma

Add a space after the comma as per the project's Checkstyle rules

FunctionsTest method references

Use method references instead of lambda expression to clean up the
code and comply to the project's Checkstyle rules.

FunctionTest redundant constructor modifier

Remove redundant public modifiers from inner classes constructors as
per the project's Checkstyle rules.

FunctionsTest imports

Clean up FunctionsTest's imports as per the project's Checkstyle
rules.

Functions.java whitspaces

Replace tabs with four spaces, as per the project's Checkstyle rules.

Add spaces after commas in Functions.java

Add spaces after commas as per the project's Checkstyle rules.

Remove unused generic argument from Functions#tryWithResources

Fix Javadoc issues in Functions

Functions' interfaces modifiers

Remove the redundant public modifier from the inner interfaces in
Functions, as per the Checkstyle policy of the project.

Add license to FunctionsTest.java

Add a license header to FunctionsTest.java to make the rat maven task
pass.

Add missing Apache license header

Added Functions.tryWithResources.

Adding the Functions class as a helper for dealing with Java 8 Lambdas.

Fix checkstyle issues in new test code

Merge branch 'pr-379'

This closes pr #379

Thanks to @apirom9

add test use ImmutablePair class with java.util.HashMap and java.util.TreeMap

Update spotbugs-maven-plugin to version 3.1.10

Travis: "openjdk-ea" now means Java 13, so add Java 12 to JDKs to build on. (closes #396)

Refactoring junits of JsonToStringStyle

Adding junits for JsonToStringStyle

Signed-off-by: RahulNagekar <rahul.nagekar1@gmail.com>

Update to JaCoCo 0.8.2 with works Java 11+.

LANG-1427: Add SystemUtils.isJavaVersionAtMost(JavaVersion)

Fix checkstyle violations.

Merge branch 'master' of https://git-wip-us.apache.org/repos/asf/commons-lang.git

[LANG-1427] Add API
org.apache.commons.lang3.SystemUtils.isJavaVersionAtMost(JavaVersion)

Add additional tests for StandardToStringStyle (closes #390)

Update to JUnit version 5.3.2

Travis: Stop building with Java 9 and 10, as these are superseded by Java 11 and not supported anymore.

Update Spotbugs Maven Plugin to version 3.1.8

Make whitespace use around generic tokens consistent and add a checkstyle rule to enforce it.

Make whitespace use before tokens consistent and add a checkstyle rule to enforce it.

Make whitespace use after tokens consistent and add a checkstyle rule to enforce it.

Merge branch 'pr-380'

This closes #380 thanks to @oorijsonar

fix javadoc typo

Update JUnit Pioneer to version 0.3.0

Update maven-spotbugs-plugin to version 3.1.7

Update EasyMock from 3.6 to 4.0 to fix testing on Java 11.

Use surefire plugin version from parent POM.

Remove unused test code

LANG-1422: Add null-safe StringUtils.valueOf(char[]) to delegate to String.valueOf(char[])

Fix checkstyle violations

[LANG-1422] Add null-safe StringUtils.valueOf(char[]) to delegate to
String.valueOf(char[])

Travis: Remove Oracle JDK 10 because it is no longer available

Clean up assertions (closes #376)

Use built-in assertion methods provides by
org.junit.jupiter.api.Assertions instead of reimplementing the same
logic with assertTrue and assertFalse.

Note that JUnit Jupiter 5.3.1 does not support deltas of 0 for
assertEquals(double, double, double) and
assertEquals(float, float, float), so these usages of assertTrue were
left untouched, and will be addressed when JUnit Jupiter 5.4, that
addresses this isssue, will be available (see
https://github.com/junit-team/junit5/pull/1613 for details).

Clean up redundant throws clauses

Use assertTrue/assertFalse instead of reimplementing them

Use assertTrue and assertFalse instead of reimplemeting their logic by
having an if statement conditionalling call fail.

Clean up testing of exceptions

Now that the entire project is ported to JUnit Jupiter, there are more
elegant ways to test for exceptions, which this patch applies
throughtout the code base.

If throwing an exception is supposed to fail a test, just throwing it
outside of the method cleans up the code and makes it more elegant,
instead of catching it and calling Assertions#fail.

If an exception is supposed to be thrown, calling
Assertions#assertThrows is a more elegant option than calling
Assertions#fail in the try block and then catching and ignoring the
expected exception.
Note that assertThrows uses a lambda block, so the variables inside it
should be final or effectively final. Reusing variables is a common
practice in the tests, so where needed new final variables were
introduced, or the variables used were inlined.

Remove double stop() test in StopWatchTest

StopWatchTest#testBadStates has the same block of code testing
StopWatch#stop copy-pasted.
This patch cleans it up by removing one of those blocks.

Make LocaleUtilsTest#parseAllLocales parameterized

This patch converts testParseAllLocales to a @ParameterizedTest instead
of iterating over the locales inside the method's body.
This changes allows using standard asserts for each case individually
instead of having to count failures and print the problematic locales
to System.out.

Remove ConversionTest#assertBinaryEquals

JUnit Jupiter's Assertions has an
assertArraysEuqals(boolean[], boolean[]) method, so there's no longer a
need for the assertBinaryEquals method.

Update checkstyle to version 8.13

Update tests to JUnit Jupiter (closes #375)

This patch finalizes the upgrade of commons-lang's tests to use JUnit
Jupiter and remove the Vintage Engine dependency entirely.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Assert.assertEquals(double, double, double),
org.junit.jupiter.api.Assertions.assertEquals(double, double, double)
does not support deltas of zero, only strictly positive deltas.
This issue will be addressed in JUnit Jupiter 5.4 (see
https://github.com/junit-team/junit5/pull/1613 for details). In the
meanwhile, assertTrue(expected==actual) was used, and TODO comments were
placed in the code to refactor it to assertEquals once JUnit 5.4 is
available.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have a
"timeout" argument either. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertTimeoutPreemptively is used.

JUnit Jupiter also no longer has the concept of Rules. Usages of the
SystemDefaultsSwitch rule and its accompanying annotates were replaced
with the @DefaultLocale annotation that Benedikt Ritter contributed to
JUnit Pioneer, the semi-official JUnit extension project.
Following the removal of their usages, the SystemDefaults annotation,
the SystemDefaultsSwitch rule and the SystemDefaultsSwitchTest class
that tests them had no more use, and they were removed entirely.

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
more elegant with Jupiter's new features, but that work is left for
subsequent patches.

Update time tests to JUnit Jupiter

Upgrade the tests in the time package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used.

JUnit Jupiter no longer has a concept of runners. Tests previously run
with the org.junit.runners.Parameterized runner were rewritten to use
@ParameterizedTest and a @MethodSource.

JUnit Jupiter also no longer has the concept of Rules. Usages of the
SystemDefaultsSwitch rule and its accompanying annotates were replaced
with the @DefaultLocale and @DefaultTimezone annotations that
Benedikt Ritter contributed to JUnit Pioneer, the semi-official JUnit
extension project.

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
more elegant with Jupiter's new features, but that work is left for
subsequent patches.

Update mutable tests to JUnit Jupiter

Upgrade the tests in the mutable package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used.

Unlike org.junit.Assert.assertEquals(double, double, double),
org.junit.jupiter.api.Assertions.assertEquals(double, double, double)
does not support deltas of zero, only strictly positive deltas.
This issue will be addressed in JUnit Jupiter 5.4 (see
https://github.com/junit-team/junit5/pull/1613 for details). In the
meanwhile, assertTrue(expected==actual) was used, and TODO comments were
placed in the code to refactor it to assertEquals once JUnit 5.4 is
available.

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
more elegant with Jupiter's new features, but that work is left for
subsequent patches.

Update math tests to JUnit Jupiter

Upgrade the tests in the math package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used.

Unlike org.junit.Assert.assertEquals(double, double, double),
org.junit.jupiter.api.Assertions.assertEquals(double, double, double)
does not support deltas of zero, only strictly positive deltas.
This issue will be addressed in JUnit Jupiter 5.4 (see
https://github.com/junit-team/junit5/pull/1613 for details). In the
meanwhile, assertTrue(expected==actual) was used, and TODO comments were
placed in the code to refactor it to assertEquals once JUnit 5.4 is
available.

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
more elegant with Jupiter's new features, but that work is left for
subsequent patches.

Update tuple tests to JUnit Jupiter

Upgrade the tests in the text package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

Update text tests to JUnit Jupiter

Upgrade the tests in the text package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used.

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
more elegant with Jupiter's new features, but that work is left for
subsequent patches.

Update reflect tests to JUnit Jupiter

Upgrade the tests in the reflect package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used.

Unlike org.junit.Assume, org.junit.jupiter.api.Assumptions does not have
an assumtNotNull method. Instead, assumeTrue was used with an explicit
condition of a variable being different than null.

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
more elegant with Jupiter's new features, but that work is left for
subsequent patches.

Update exception tests to JUnit Jupiter

Upgrade the tests in the exception package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used.

Another non-obvious change was performed in
ContextedRuntimeExceptionTest. Unlike JUnit Vintages's @Before, JUnit
Jupiter's @BeforeEach does not apply if a parent's method is annotated
with it and the overriding method is not, so an explicit @BeforeEach
annotation had to be added to ContexedTuntimeExceptionTest#setUp().

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
made more elegant with Jupiter's new features, but that work is left
for subsequent patches.

Update event tests to JUnit Jupiter

Upgrade the tests in the event package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, it is worth noting the tests that test thrown excetpions.
Prior to this patch, this package tested for exceptions in two ways,
neither of which are supported in JUnit Jupiter:
1. With the "expected" argument of the org.junit.Test annotation.
2. With the org.junit.rules.ExpectedException @Rule

Both of these usages were replaced with calls to
org.junit.jupiter.api.Assertions#assertThrows.

Update concurrent tests to JUnit Jupiter

Upgrade the tests in the concurrent package to use JUnit Jupiter as
part of the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, there are some non-obvious changes worth mentioning.

Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used. This call allows
the test to pinpoint the exact statement that is expected to throw the
exception and allows making the tests a bit stricter by preventing
false-positives that could occur if the setup code would throw the
expected exception instead of the statement that was supposed to throw
it.

Another notable change was performed in MemoizerTest.
JUnit Jupiter does not support JUnit 4's runners, and EasyMock has no
equivalent @Extension, so a setup method was added and the mock was
explicitly initialized.

It's also worth noting this is a minimal patch for migrating the
package's tests to Jupiter. There are several tests that can be made
made more elegant with Jupiter's new features, but that work is left
for subsequent patches.

Travis: Also build with openjdk-ea, but allow openjdk-ea builds to fail.

Use JDKs provided by travis

Replace FindBugs with SpotBugs: Fix source assembly

Update builder tests to JUnit Jupiter

Upgrade the tests in the builder package to use JUnit Jupiter as part of
the effort to remove the dependency on the Vintage Engine.

While most of these changes are drop-in replacements with no functional
benefit, it is worth mentioning the change to how expected exceptions
are tested.
Unlike org.junit.Test, org.junit.jupiter.api.Test does not have an
"expected" argument. Instead, an explicit call to
org.junit.jupiter.api.Assertions.assertThrows is used. This call allows
the test to pinpoint the exact statement that is expected to throw the
expcetion and allows making the tests a bit stricter by preventing
false-positives that could occur if the setup code would throw the
expected exception instead of the statement that was supposed to throw
it.