Extend/Update API part 11 by JavaSaBr · Pull Request #61 · JavaSaBr/RLib

JavaSaBr · 2026-02-10T06:08:26Z

Extend/Update API part 11

github-actions · 2026-02-10T06:11:23Z

Overall Project	54.14% `-0.01%`	🍏
Files changed	99.65%	🍏

File	Coverage
Tuple.java	100%	🍏
IntRefTuple.java	100%	🍏
LongRefTuple.java	100%	🍏
NumberedEnumMap.java	98.9%	🍏
ArrayUtils.java	96.65% `-0.12%`	🍏
ImmutableArray.java	95.24%	🍏
NumberUtils.java	91.32%	🍏
DateUtils.java	89.8%	🍏
StringUtils.java	83.75%	🍏
AliasedEnumMap.java	79.82%	🍏
BufferUtils.java	72.28%	🍏
GroupThreadFactory.java	72.06%	🍏
FileUtils.java	67.62%	🍏
ClassUtils.java	47.48%	🍏
AsyncUtils.java	44.44%	🍏
ReflectionUtils.java	18.56%	🍏
ObjectUtils.java	17.39%	🍏
Utils.java	14.97%	🍏
ExtMath.java	9.54%	🍏
OperatingSystemResolver.java	0%	🍏
OperatingSystem.java	0%	🍏
Functions.java	0%	🍏
PropertyLoader.java	0%	🍏
CycleBuffer.java	0%	🍏
ThreadUtils.java	0%	🍏

Copilot

Pull request overview

This PR continues the “Extend/Update API” series by expanding utility APIs (notably FileUtils and ArrayUtils), adding/expanding unit tests, and standardizing/refreshing Javadocs across a wide portion of the library. It also bumps the project version to the next alpha.

Changes:

Expanded FileUtils API surface and significantly increased FileUtilsTest coverage for path/extension, delete, walk/tree, unzip, and relativize behaviors.
Refactored and extended ArrayUtils (new/adjusted overloads, renamed getComponentType → resolveComponentType) and introduced a large new ArrayUtilsTest.
Broad Javadoc modernization across many public APIs + version bump (10.0.alpha13).

Reviewed changes

Copilot reviewed 65 out of 66 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
rlib-io/src/test/java/javasabr/rlib/io/FileUtilsTest.java	Adds extensive tests for `FileUtils` behaviors (extensions, delete, stream, unzip, etc.).
rlib-io/src/main/java/javasabr/rlib/io/util/FileUtils.java	Adds/updates public APIs and Javadocs for common file/path operations.
rlib-common/src/test/java/javasabr/rlib/common/util/ArrayUtilsTest.java	New comprehensive unit test suite for `ArrayUtils`.
rlib-common/src/main/java/javasabr/rlib/common/util/os/OperatingSystemResolver.java	Javadoc cleanup/modernization.
rlib-common/src/main/java/javasabr/rlib/common/util/os/OperatingSystem.java	Removes redundant field/getter/setter Javadocs; updates class doc.
rlib-common/src/main/java/javasabr/rlib/common/util/Utils.java	Updates class-level documentation.
rlib-common/src/main/java/javasabr/rlib/common/util/ThreadUtils.java	Adds method-level Javadoc to `sleep`.
rlib-common/src/main/java/javasabr/rlib/common/util/StringUtils.java	Javadoc wording/consistency improvements.
rlib-common/src/main/java/javasabr/rlib/common/util/ReflectionUtils.java	Class-level Javadoc update.
rlib-common/src/main/java/javasabr/rlib/common/util/PropertyLoader.java	Adds class/method documentation.
rlib-common/src/main/java/javasabr/rlib/common/util/ObjectUtils.java	Updates class-level documentation.
rlib-common/src/main/java/javasabr/rlib/common/util/NumberedEnumMap.java	Adds richer Javadocs for map behavior and APIs.
rlib-common/src/main/java/javasabr/rlib/common/util/NumberedEnum.java	Adds interface/method Javadocs.
rlib-common/src/main/java/javasabr/rlib/common/util/NumberUtils.java	Updates class-level documentation.
rlib-common/src/main/java/javasabr/rlib/common/util/GroupThreadFactory.java	Adds extensive constructor/interface Javadocs.
rlib-common/src/main/java/javasabr/rlib/common/util/ExtMath.java	Javadoc cleanup + minor formatting improvements.
rlib-common/src/main/java/javasabr/rlib/common/util/DateUtils.java	Updates class-level documentation.
rlib-common/src/main/java/javasabr/rlib/common/util/CycleBuffer.java	Javadoc cleanup and clarification.
rlib-common/src/main/java/javasabr/rlib/common/util/ClassUtils.java	Adds Javadocs to `commonType` overloads.
rlib-common/src/main/java/javasabr/rlib/common/util/BufferUtils.java	Adds/cleans up method Javadocs.
rlib-common/src/main/java/javasabr/rlib/common/util/AsyncUtils.java	Adds detailed Javadocs to async helpers.
rlib-common/src/main/java/javasabr/rlib/common/util/ArrayUtils.java	Refactors APIs, adds docs, renames component-type helper, adjusts overloads.
rlib-common/src/main/java/javasabr/rlib/common/util/AliasedEnumMap.java	Adds richer Javadocs for alias mapping behavior.
rlib-common/src/main/java/javasabr/rlib/common/tuple/Tuple.java	Adds record-level Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/tuple/LongRefTuple.java	Adds record-level Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/tuple/IntRefTuple.java	Adds record-level Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/TriplePredicate.java	Adds/cleans up functional-interface Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/TripleFunction.java	Javadoc modernization + `@since`.
rlib-common/src/main/java/javasabr/rlib/common/function/TripleConsumer.java	Javadoc modernization + `@since`.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeTriFunction.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeSupplier.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeRunnable.java	Javadoc cleanup.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeFunction.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeFactory.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeConsumer.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeBiFunction.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/SafeBiConsumer.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/ObjectLongPredicate.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/ObjectIntFunction.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/NullableSupplier.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullSafeTriFunction.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullSafeSupplier.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullSafeFunction.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullSafeFactory.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullSafeConsumer.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullSafeBiFunction.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullSafeBiConsumer.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullConsumer.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/NotNullBiConsumer.java	Adds full Javadoc.
rlib-common/src/main/java/javasabr/rlib/common/function/LongObjectPredicate.java	Javadoc cleanup (and fixes garbled text).
rlib-common/src/main/java/javasabr/rlib/common/function/LongBiObjectConsumer.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/IntObjectPredicate.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/IntBiObjectConsumer.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/Functions.java	Adds Javadocs to functional factories.
rlib-common/src/main/java/javasabr/rlib/common/function/FunctionInt.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/FloatConsumer.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/FloatBiObjectConsumer.java	Adds Javadocs.
rlib-common/src/main/java/javasabr/rlib/common/function/DoubleObjectConsumer.java	Javadoc modernization.
rlib-common/src/main/java/javasabr/rlib/common/function/CharSupplier.java	Removes redundant author tag.
rlib-common/src/main/java/javasabr/rlib/common/ThreadSafe.java	Improves marker interface documentation.
rlib-common/src/main/java/javasabr/rlib/common/Copyable.java	Adds interface/method Javadocs.
rlib-collections/src/main/java/javasabr/rlib/collections/array/impl/ImmutableArray.java	Updates to renamed `ArrayUtils.resolveComponentType`.
build.gradle	Bumps root project version to `10.0.alpha13`.
README.md	Updates sample `rlibVersion` to `10.0.alpha13`.
.github/skills/generate-javadoc.md	Expands and clarifies internal Javadoc generation guidelines.
.github/copilot-instructions.md	Adds explicit testing and Javadoc conventions for contributors/tools.

Copilot · 2026-02-10T06:15:26Z

rlib-common/src/main/java/javasabr/rlib/common/util/ArrayUtils.java

+    var builder = new StringBuilder();
    if (needType) {
      builder.append("int");
    }


In ArrayUtils.toString(long[] …), when needType is true the prefix appended is "int"; this will produce incorrect output for long arrays (e.g., "int[...]" instead of "long[...]"). Update the prefix to "long" to match the array type (and consider adding/adjusting a test that covers needType=true for long arrays).

Copilot · 2026-02-10T06:15:27Z

rlib-common/src/main/java/javasabr/rlib/common/util/ArrayUtils.java

+  public static <T, A, R> void forEach(T @Nullable [] array, A arg, Function<T, R> getter, BiConsumer<R, A> consumer) {
+    if (isNotEmpty(array)) {
+      for (T element : array) {
+        consumer.accept(getter.apply(element), arg);
      }


The forEach overload that takes a getter now always passes the getter result to the consumer, even if the getter returns null. Previously this pattern skipped null sub-elements, so this is a behavioral change that can introduce NPEs in consumers. Either restore the null-skip behavior (and annotate getter as returning @nullable), or update the method contract/javadoc and nullness annotations to explicitly allow null to reach the consumer.

Copilot · 2026-02-10T06:15:27Z

rlib-io/src/test/java/javasabr/rlib/io/FileUtilsTest.java

+    Path nonExistentDir = Path.of("/non/existent/directory");
+
+    // when/then:
+    assertThatThrownBy(() -> FileUtils.unzip(nonExistentDir, zipFile))
+        .isInstanceOf(IllegalArgumentException.class);


Using a hard-coded absolute path ("/non/existent/directory") to represent a missing directory can be flaky across environments/OSes (the path might exist, and Windows path semantics differ). Prefer constructing a guaranteed-nonexistent path under @tempdir (e.g., tempDir.resolve("missing")) to keep the test deterministic.

Copilot · 2026-02-10T06:15:27Z

rlib-io/src/test/java/javasabr/rlib/io/FileUtilsTest.java

    Path outputDir = tempDirectory
        .resolve("output")
        .resolve("folder");
-    
+
    Files.createDirectories(outputDir);


This test uses Files.createTempDirectory (and earlier creates a temp zip file) without any cleanup. That can leave artifacts in the system temp directory (especially in CI). Prefer using JUnit's @tempdir for both locations so JUnit cleans them automatically (or ensure explicit deletion in a finally block).

Copilot · 2026-02-10T06:15:28Z

rlib-common/src/test/java/javasabr/rlib/common/util/ArrayUtilsTest.java

+    // given:
+    String[] source = {"1", "2", "3"};
+    // when:
+    Integer[] result = ArrayUtils.map(source, Integer::parseInt, Integer.class);


Potential uncaught 'java.lang.NumberFormatException'.

Copilot · 2026-02-10T06:15:28Z

rlib-common/src/test/java/javasabr/rlib/common/util/ArrayUtilsTest.java

+    // given:
+    String[] source = {};
+    // when:
+    Integer[] result = ArrayUtils.map(source, Integer::parseInt, Integer.class);


Potential uncaught 'java.lang.NumberFormatException'.

github-actions · 2026-02-10T18:36:11Z

Overall Project	54.26% `-0.02%`	🍏
Files changed	98.95%	🍏

File	Coverage
Tuple.java	100%	🍏
IntRefTuple.java	100%	🍏
LongRefTuple.java	100%	🍏
DefaultArrayIterationFunctions.java	100%	🍏
NumberedEnumMap.java	98.9%	🍏
ArrayUtils.java	96.65% `-0.35%`	🍏
ImmutableArray.java	95.24%	🍏
NumberUtils.java	91.32%	🍏
DefaultLockableOperations.java	90.86%	🍏
DateUtils.java	89.8%	🍏
StringUtils.java	83.75%	🍏
AliasedEnumMap.java	79.82%	🍏
BufferUtils.java	72.28%	🍏
GroupThreadFactory.java	72.06%	🍏
FileUtils.java	67.62%	🍏
ClassUtils.java	47.48%	🍏
AsyncUtils.java	44.44%	🍏
PoolFactory.java	27.78%	🍏
Reusable.java	25%	🍏
ReflectionUtils.java	18.56%	🍏
Pool.java	17.86%	🍏
ObjectUtils.java	17.39%	🍏
Utils.java	14.97%	🍏
ExtMath.java	9.54%	🍏
OperatingSystemResolver.java	0%	🍏
OperatingSystem.java	0%	🍏
PropertyLoader.java	0%	🍏
CycleBuffer.java	0%	🍏
ThreadUtils.java	0%	🍏
ConcurrentUtils.java	0%	🍏

JavaSaBr added 8 commits February 7, 2026 17:50

update array utils

2e69297

update array utils tests and copilot instructions

f5b1ea6

update javadoc

8a45dec

update javadoc

08618e5

update instructions

48f4d42

update javadoc

98c2901

extend FileUtilsTest

6278d5d

update instructions

f9985e5

JavaSaBr added this to the 10.0 milestone Feb 10, 2026

JavaSaBr self-assigned this Feb 10, 2026

Copilot AI review requested due to automatic review settings February 10, 2026 06:08

Copilot started reviewing on behalf of JavaSaBr February 10, 2026 06:08 View session

Copilot AI reviewed Feb 10, 2026

View reviewed changes

JavaSaBr added 4 commits February 10, 2026 18:53

resolve CR comments

a2ccadd

update javadoc

fc88ade

refactor functions

95ac4bc

update javadoc and instructions

f77d64d

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Extend/Update API part 11#61

Extend/Update API part 11#61
JavaSaBr wants to merge 12 commits intodevelopfrom
update-api-part-1

JavaSaBr commented Feb 10, 2026

Uh oh!

github-actions bot commented Feb 10, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Copilot AI Feb 10, 2026

Uh oh!

Copilot AI Feb 10, 2026

Uh oh!

Copilot AI Feb 10, 2026

Uh oh!

Copilot AI Feb 10, 2026

Uh oh!

Copilot AI Feb 10, 2026

Uh oh!

Copilot AI Feb 10, 2026

Uh oh!

github-actions bot commented Feb 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

JavaSaBr commented Feb 10, 2026

Uh oh!

github-actions bot commented Feb 10, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 10, 2026

Choose a reason for hiding this comment

Uh oh!

github-actions bot commented Feb 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant