Apache/commons-collections
1
0
Fork 0
mirror of https://github.com/apache/commons-collections.git synced 2025-02-09 03:25:25 +00:00
Code Issues Packages Projects Releases Wiki Activity

Prepare for the next release candidate

Browse Source
This commit is contained in:
Gary D. Gregory 2024-12-15 15:18:57 +00:00
parent 44da05d45e
commit 303d9e75a5
5 changed files with 102 additions and 113 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
CONTRIBUTING.md
View File

@ -41,9 +41,8 @@
Contributing to Apache Commons Collections Contributing to Apache Commons Collections
====================== ======================
You have found a bug or you have an idea for a cool new feature? Contributing code is a great way to give something back to Have you found a bug or have an idea for a cool new feature? Contributing code is a great way to give something back to the open-source community.
the open source community. Before you dig right into the code there are a few guidelines that we need contributors to Before you dig right into the code, we need contributors to follow a few guidelines to have a chance of keeping on top of things.
follow so that we can have a chance of keeping on top of things.
Getting Started Getting Started
--------------- ---------------
@ -62,7 +61,7 @@ Making Changes
+ Create a _topic branch_ for your isolated work. + Create a _topic branch_ for your isolated work.
* Usually you should base your branch on the `master` branch. * Usually you should base your branch on the `master` branch.
* A good topic branch name can be the JIRA bug id plus a keyword, e.g. `COLLECTIONS-123-InputStream`. * A good topic branch name can be the JIRA bug ID plus a keyword, e.g. `COLLECTIONS-123-InputStream`.
* If you have submitted multiple JIRA issues, try to maintain separate branches and pull requests. * If you have submitted multiple JIRA issues, try to maintain separate branches and pull requests.
+ Make commits of logical units. + Make commits of logical units.
* Make sure your commit messages are meaningful and in the proper format. Your commit message should contain the key of the JIRA issue. * Make sure your commit messages are meaningful and in the proper format. Your commit message should contain the key of the JIRA issue.
@ -72,7 +71,7 @@ Making Changes
+ Create minimal diffs - disable _On Save_ actions like _Reformat Source Code_ or _Organize Imports_. If you feel the source code should be reformatted create a separate PR for this change first. + Create minimal diffs - disable _On Save_ actions like _Reformat Source Code_ or _Organize Imports_. If you feel the source code should be reformatted create a separate PR for this change first.
+ Check for unnecessary whitespace with `git diff` -- check before committing. + Check for unnecessary whitespace with `git diff` -- check before committing.
+ Make sure you have added the necessary tests for your changes, typically in `src/test/java`. + Make sure you have added the necessary tests for your changes, typically in `src/test/java`.
+ Run all the tests with `mvn clean verify` to assure nothing else was accidentally broken. + Run all the tests with `mvn clean verify` to ensure nothing else was accidentally broken.
Making Trivial Changes Making Trivial Changes
---------------------- ----------------------

4
README.md
View File

@ -45,7 +45,7 @@ Apache Commons Collections
[![Java CI](https://github.com/apache/commons-collections/actions/workflows/maven.yml/badge.svg)](https://github.com/apache/commons-collections/actions/workflows/maven.yml) [![Java CI](https://github.com/apache/commons-collections/actions/workflows/maven.yml/badge.svg)](https://github.com/apache/commons-collections/actions/workflows/maven.yml)
[![Maven Central](https://img.shields.io/maven-central/v/org.apache.commons/commons-collections4?label=Maven%20Central)](https://search.maven.org/artifact/org.apache.commons/commons-collections4) [![Maven Central](https://img.shields.io/maven-central/v/org.apache.commons/commons-collections4?label=Maven%20Central)](https://search.maven.org/artifact/org.apache.commons/commons-collections4)
[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-collections4/4.5.0-M2.svg)](https://javadoc.io/doc/org.apache.commons/commons-collections4/4.5.0-M2) [![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-collections4/4.5.0-M3.svg)](https://javadoc.io/doc/org.apache.commons/commons-collections4/4.5.0-M3)
[![CodeQL](https://github.com/apache/commons-collections/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/apache/commons-collections/actions/workflows/codeql-analysis.yml) [![CodeQL](https://github.com/apache/commons-collections/actions/workflows/codeql-analysis.yml/badge.svg)](https://github.com/apache/commons-collections/actions/workflows/codeql-analysis.yml)
[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/apache/commons-collections/badge)](https://api.securityscorecards.dev/projects/github.com/apache/commons-collections) [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/apache/commons-collections/badge)](https://api.securityscorecards.dev/projects/github.com/apache/commons-collections)
@ -68,7 +68,7 @@ Alternatively, you can pull it from the central Maven repositories:
<dependency> <dependency>
<groupId>org.apache.commons</groupId> <groupId>org.apache.commons</groupId>
<artifactId>commons-collections4</artifactId> <artifactId>commons-collections4</artifactId>
<version>4.5.0-M2</version> <version>4.5.0-M3</version>
</dependency> </dependency>
``` ```

80
RELEASE-NOTES.txt
View File

@ -1,3 +1,83 @@
Apache Commons Collections 4.5.0-M3 RELEASE NOTES
-------------------------------------------------
The Apache Commons Collections package contains types that extend and augment the Java Collections Framework.
This is a feature and maintenance release. Java 8 or later is required.
Changes in this version
-----------------------
New features
------------
* LayerManager.Builder implements Supplier. Thanks to Gary Gregory.
* Add CollectionUtils.duplicateList(Collection). Thanks to Gary Gregory, hemanth0525.
* Add CollectionUtils.duplicateSet(Collection). Thanks to Gary Gregory, hemanth0525.
* Add CollectionUtils.duplicateSequencedSet(Collection). Thanks to Gary Gregory, hemanth0525.
* Add HashBag.HashBag(Iterable). Thanks to Gary Gregory.
* Add TreeBag.TreeBag(Iterable). Thanks to Gary Gregory.
* COLLECTIONS-858: Add CartesianProductIterator #509. Thanks to Alexey Pelykh, Alex Herbert, Gary Gregory.
* Add missing methods in AbstractMapTests. Thanks to Gary Gregory.
* COLLECTIONS-700: Add ConcurrentReferenceHashMap. Thanks to Gary Gregory.
* Add commons.easymock.version to parameterize EasyMock version. Thanks to Gary Gregory.
* COLLECTIONS-869: Add org.apache.commons.collections4.IteratorUtils.chainedIterator(Iterator<? extends Iterator<? extends E>>). Thanks to Gary Gregory.
* COLLECTIONS-533: Add ArrayListValuedLinkedHashMap #560. Thanks to Peter De Maeyer.
* Add missing test AbstractIteratorTest.testForEachRemaining(). Thanks to Gary Gregory.
* Add FilterIterator.removeNext() #564. Thanks to Gary Gregory, Claude Warren.
* COLLECTIONS-870: Add ExtendedIterator and tests #564. Thanks to Claude Warren, Gary Gregory.
* Refactor ExtendedIterator and FilterIterator with a new interface IteratorOperations. Thanks to Gary Gregory.
* COLLECTIONS-871: Add LinkedHashSetValuedLinkedHashMap #565. Thanks to Peter De Maeyer.
Fixed Bugs
----------
* COLLECTIONS-857: Complete bloom filter documentation #507. Thanks to Claude Warren.
* Package private AbstractEmptyIterator implements ResettableIterator so subclasses don't. Thanks to Gary Gregory.
* Deprecate AbstractEmptyIterator.add(E) without replacement. Thanks to Gary Gregory.
* Add missing Javadocs. Thanks to Gary Gregory.
* PatriciaTrie constructor reuse the stateless singleton StringKeyAnalyzer.INSTANCE. Thanks to Gary Gregory.
* Deprecate StringKeyAnalyzer.StringKeyAnalyzer() in favor of StringKeyAnalyzer.INSTANCE. Thanks to Gary Gregory.
* [Functional] FunctorUtils.validate(Closure...) is now FunctorUtils.validate(Consumer...). Thanks to Gary Gregory.
* [Functional] FunctorUtils.validate(Predicate...) is now FunctorUtils.validate(java.util.function.Predicate...). Thanks to Gary Gregory.
* [Functional] FunctorUtils.validate(Transformer...) is now FunctorUtils.validate(Function...). Thanks to Gary Gregory.
* Increase test coverage for ListUtils #517. Thanks to Dávid Szigecsán. Gary Gregory.
* Use the Junit (Jupiter) API #518. Thanks to Dávid Szigecsán.
* BloomFilterExtractor.flatten() should throw an exception instead of returning null. Thanks to Gary Gregory, Alex Herbert.
* Improve WrappedBloomFilterTest. All tests now assert copy() the same way. Thanks to Gary Gregory, Claude Warren.
* COLLECTIONS-860: Javadoc CollectionBag.add* to throw ClassCastException. Thanks to Gary Gregory, Daniele.
* Fix generics in IteratorChain.IteratorChain(Collection). Thanks to Gary Gregory.
* Fix generics in org.apache.commons.collections4.IteratorUtils.chainedIterator(Collection). Thanks to Gary Gregory.
* COLLECTIONS-856: Javadoc: Document interaction between peek and filter iterator #515. Thanks to Benjamin Confino, Gary Gregory.
* COLLECTIONS-815: Javadoc: Update ClosureUtils Javadoc to match runtime. Thanks to Elia Bertolina, Gary Gregory.
* COLLECTIONS-815: Javadoc: Update ClosureUtils Javadoc to match runtime. Thanks to Gary Gregory.
* COLLECTIONS-777: Migrate to JUnit 5. Thanks to Gary Gregory.
* Fix NullPointerException in FilterIterator.setNextObject(). Thanks to Gary Gregory.
* EqualPredicate.test(Object) should return true if the parameter is the same object as given the constructor. Thanks to Gary Gregory.
Changes
-------
* Bump org.apache.commons:commons-parent from 71 to 78 #534, #545, #550 #555, #566. Thanks to Gary Gregory.
* COLLECTIONS-857: Update bloom filter documentation #508. Thanks to Claude Warren.
* Bump commons-codec:commons-codec from 1.17.0 to 1.17.1 #514. Thanks to Dependabot, Gary Gregory.
* Bump org.apache.commons:commons-lang3 from 3.14.0 to 3.17.0 #516, #525, #535. Thanks to Dependabot, Gary Gregory.
* Bump org.hamcrest:hamcrest from 2.2 to 3.0 #522, #532. Thanks to Dependabot, Gary Gregory.
* Bump com.google.guava:guava-testlib from 33.2.1-jre to 33.3.1-jre #531, #549. Thanks to Dependabot, Gary Gregory.
* Bump MathJax from 2.7.2 to 2.7.9. Thanks to Gary Gregory.
* [test] Bump org.easymock:easymock from 5.3.0 to 5.5.0 #521, #576. Thanks to Dependabot, Gary Gregory.
* [test] Bump commons-io:commons-io from 2.16.1 to 2.18.0 #544, #575. Thanks to Dependabot, Gary Gregory.
For complete information on Apache Commons Collections, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache Commons Collections website:
https://commons.apache.org/proper/commons-collections/
Download page: https://commons.apache.org/proper/commons-collections/download_collections.cgi
-----------------------------------------------------------------------------
Apache Commons Collections 4.5.0-M2 RELEASE NOTES Apache Commons Collections 4.5.0-M2 RELEASE NOTES
------------------------------------------------- -------------------------------------------------

2
src/changes/changes.xml
View File

@ -22,7 +22,7 @@
<title>Apache Commons Collections Release Notes</title> <title>Apache Commons Collections Release Notes</title>
</properties> </properties>
<body> <body>
<release version="4.5.0-M3" date="YYYY-MM-DD" description="This is a feature and maintenance release. Java 8 or later is required."> <release version="4.5.0-M3" date="2024-12-15" description="This is a feature and maintenance release. Java 8 or later is required.">
<!-- FIX --> <!-- FIX -->
<action issue="COLLECTIONS-857" type="fix" dev="ggregory" due-to="Claude Warren">Complete bloom filter documentation #507.</action> <action issue="COLLECTIONS-857" type="fix" dev="ggregory" due-to="Claude Warren">Complete bloom filter documentation #507.</action>
<action type="fix" dev="ggregory" due-to="Gary Gregory">Package private AbstractEmptyIterator implements ResettableIterator so subclasses don't.</action> <action type="fix" dev="ggregory" due-to="Gary Gregory">Package private AbstractEmptyIterator implements ResettableIterator so subclasses don't.</action>

116
src/site/xdoc/download_collections.xml
View File

@ -113,122 +113,32 @@ limitations under the License.
</p> </p>
</subsection> </subsection>
</section> </section>
<section name="Apache Commons Collections 4.5.0-M2 (Requires Java 8 or above)"> <section name="Apache Commons Collections 4.5.0-M3 (Requires Java 8 or above)">
<subsection name="Binaries"> <subsection name="Binaries">
<table> <table>
<tr> <tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.5.0-M2-bin.tar.gz">commons-collections4-4.5.0-M2-bin.tar.gz</a></td> <td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.5.0-M3-bin.tar.gz">commons-collections4-4.5.0-M3-bin.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M2-bin.tar.gz.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M3-bin.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M2-bin.tar.gz.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M3-bin.tar.gz.asc">pgp</a></td>
</tr> </tr>
<tr> <tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.5.0-M2-bin.zip">commons-collections4-4.5.0-M2-bin.zip</a></td> <td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.5.0-M3-bin.zip">commons-collections4-4.5.0-M3-bin.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M2-bin.zip.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M3-bin.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M2-bin.zip.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.5.0-M3-bin.zip.asc">pgp</a></td>
</tr> </tr>
</table> </table>
</subsection> </subsection>
<subsection name="Source"> <subsection name="Source">
<table> <table>
<tr> <tr>
<td><a href="[preferred]/commons/collections/source/commons-collections4-4.5.0-M2-src.tar.gz">commons-collections4-4.5.0-M2-src.tar.gz</a></td> <td><a href="[preferred]/commons/collections/source/commons-collections4-4.5.0-M3-src.tar.gz">commons-collections4-4.5.0-M3-src.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M2-src.tar.gz.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M3-src.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M2-src.tar.gz.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M3-src.tar.gz.asc">pgp</a></td>
</tr> </tr>
<tr> <tr>
<td><a href="[preferred]/commons/collections/source/commons-collections4-4.5.0-M2-src.zip">commons-collections4-4.5.0-M2-src.zip</a></td> <td><a href="[preferred]/commons/collections/source/commons-collections4-4.5.0-M3-src.zip">commons-collections4-4.5.0-M3-src.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M2-src.zip.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M3-src.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M2-src.zip.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.5.0-M3-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
</section>
<section name="Apache Commons Collections 4.2 (Requires Java 7 or above)">
<subsection name="Binaries">
<table>
<tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.2-bin.tar.gz">commons-collections4-4.2-bin.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.2-bin.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.2-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.2-bin.zip">commons-collections4-4.2-bin.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.2-bin.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.2-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
<td><a href="[preferred]/commons/collections/source/commons-collections4-4.2-src.tar.gz">commons-collections4-4.2-src.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.2-src.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.2-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/collections/source/commons-collections4-4.2-src.zip">commons-collections4-4.2-src.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.2-src.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.2-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
</section>
<section name="Apache Commons Collections 4.1 (Requires Java 6 or above)">
<subsection name="Binaries">
<table>
<tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.1-bin.tar.gz">commons-collections4-4.1-bin.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.1-bin.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.1-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections4-4.1-bin.zip">commons-collections4-4.1-bin.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.1-bin.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections4-4.1-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
<td><a href="[preferred]/commons/collections/source/commons-collections4-4.1-src.tar.gz">commons-collections4-4.1-src.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.1-src.tar.gz.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.1-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/collections/source/commons-collections4-4.1-src.zip">commons-collections4-4.1-src.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.1-src.zip.sha512">sha512</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections4-4.1-src.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
</section>
<section name="Apache Commons Collections 3.2.2 (Requires Java 1.3 or above)">
<subsection name="Binaries">
<table>
<tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections-3.2.2-bin.tar.gz">commons-collections-3.2.2-bin.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections-3.2.2-bin.tar.gz.sha256">sha256</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections-3.2.2-bin.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/collections/binaries/commons-collections-3.2.2-bin.zip">commons-collections-3.2.2-bin.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections-3.2.2-bin.zip.sha256">sha256</a></td>
<td><a href="https://downloads.apache.org/commons/collections/binaries/commons-collections-3.2.2-bin.zip.asc">pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
<td><a href="[preferred]/commons/collections/source/commons-collections-3.2.2-src.tar.gz">commons-collections-3.2.2-src.tar.gz</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections-3.2.2-src.tar.gz.sha256">sha256</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections-3.2.2-src.tar.gz.asc">pgp</a></td>
</tr>
<tr>
<td><a href="[preferred]/commons/collections/source/commons-collections-3.2.2-src.zip">commons-collections-3.2.2-src.zip</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections-3.2.2-src.zip.sha256">sha256</a></td>
<td><a href="https://downloads.apache.org/commons/collections/source/commons-collections-3.2.2-src.zip.asc">pgp</a></td>
</tr> </tr>
</table> </table>
</subsection> </subsection>