Conversation
|
Contributor
There was a problem hiding this comment.
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
FileUtilsAPI surface and significantly increasedFileUtilsTestcoverage for path/extension, delete, walk/tree, unzip, and relativize behaviors. - Refactored and extended
ArrayUtils(new/adjusted overloads, renamedgetComponentType→resolveComponentType) and introduced a large newArrayUtilsTest. - 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. |
| // given: | ||
| String[] source = {"1", "2", "3"}; | ||
| // when: | ||
| Integer[] result = ArrayUtils.map(source, Integer::parseInt, Integer.class); |
There was a problem hiding this comment.
Potential uncaught 'java.lang.NumberFormatException'.
| // given: | ||
| String[] source = {}; | ||
| // when: | ||
| Integer[] result = ArrayUtils.map(source, Integer::parseInt, Integer.class); |
There was a problem hiding this comment.
Potential uncaught 'java.lang.NumberFormatException'.
|
|
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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: