This is an automated email from the ASF dual-hosted git repository. ggregory pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/commons-net.git
The following commit(s) were added to refs/heads/master by this push: new 26fbd9ed Prepare for release candidate 26fbd9ed is described below commit 26fbd9ed6ad7e551d502465968107d3d65ee1d97 Author: Gary Gregory <garydgreg...@gmail.com> AuthorDate: Sun Oct 1 09:20:24 2023 -0400 Prepare for release candidate --- README.md | 10 +++--- RELEASE-NOTES.txt | 71 ++++++++++++++++++++++++++++++++++++++++++ src/changes/changes.xml | 2 +- src/changes/release-notes.vm | 2 ++ src/site/xdoc/download_net.xml | 26 ++++++++-------- 5 files changed, 92 insertions(+), 19 deletions(-) diff --git a/README.md b/README.md index 9dc66fa6..c5b8c384 100644 --- a/README.md +++ b/README.md @@ -46,12 +46,12 @@ Apache Commons Net [](https://github.com/apache/commons-net/actions) [](https://app.codecov.io/gh/apache/commons-net) [](https://maven-badges.herokuapp.com/maven-central/commons-net/commons-net/?gav=true) -[](https://javadoc.io/doc/commons-net/commons-net/3.9.0) +[](https://javadoc.io/doc/commons-net/commons-net/3.10.0) [](https://github.com/apache/commons-net/actions/workflows/codeql-analysis.yml?query=workflow%3ACodeQL) -[](https://api.securityscorecards.dev/projects/github.com/apache/commons-text) +[](https://api.securityscorecards.dev/projects/github.com/apache/commons-net) Apache Commons Net library contains a collection of network utilities and protocol implementations. -Supported protocols include: Echo, Finger, FTP, NNTP, NTP, POP3(S), SMTP(S), Telnet, Whois +Supported protocols include: Echo, Finger, FTP, NNTP, NTP, POP3(S), SMTP(S), Telnet, Whois. Documentation ------------- @@ -64,13 +64,13 @@ Where can I get the latest release? ----------------------------------- You can download source and binaries from our [download page](https://commons.apache.org/proper/commons-net/download_net.cgi). -Alternatively, you can pull it from the central Maven repositories: +Alternatively, you can pull it from the central Maven repositories: ```xml <dependency> <groupId>commons-net</groupId> <artifactId>commons-net</artifactId> - <version>3.9.0</version> + <version>3.10.0</version> </dependency> ``` diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt index 481fb091..2e937046 100644 --- a/RELEASE-NOTES.txt +++ b/RELEASE-NOTES.txt @@ -1,3 +1,74 @@ + Apache Commons Net 3.10.0 + RELEASE NOTES + +The Apache Commons Net team is pleased to announce the release of Apache Commons Net 3.10.0. + +Apache Commons Net library contains a collection of network utilities and protocol implementations. +Supported protocols include: Echo, Finger, FTP, NNTP, NTP, POP3(S), SMTP(S), Telnet, Whois. + + +Maintenance and bug fix release (Java 8). + +For complete information on Apache Commons Net, including instructions on how to submit bug reports, +patches, or suggestions for improvement, see the Apache Commons Net website: + +https://commons.apache.org/proper/commons-net/ + +Download page: https://commons.apache.org/proper/commons-net/download_net.cgi + +Changes in this version include: +=============================== + +New features: +o Add and use DatagramSocketClient.setDefaultTimeout(Duration) and deprecate DatagramSocketClient.setDefaultTimeout(int). Thanks to Gary Gregory. +o Add and use TFTP.DEFAULT_TIMEOUT_DURATION and deprecate org.apache.commons.net.tftp.TFTP.DEFAULT_TIMEOUT. Thanks to Gary Gregory. +o Add and use DatagramSocketClient#getSoTimeoutDuration(). Thanks to Gary Gregory. +o Add and use DatagramSocketClient#setSoTimeout(Duration). Thanks to Gary Gregory. +o Add and use DatagramSocketClient.checkOpen(). Thanks to Gary Gregory. +o Add TelnetClient.sendAYT(Duration). Thanks to Gary Gregory. +o TFTPServer implements AutoCloseable. Thanks to Gary Gregory. +o DatagramSocketClient implements AutoCloseable. Thanks to Gary Gregory. +o Add IMAP package tests, include junit-jupiter-params artifact #166. Thanks to KuKa, Gary Gregory. +o Add Base64 missing tests and documentation fixes #161. Thanks to KuKa, Bruno P. Kinoshita. +o Add FTPFile tests and fix Javadoc typos #162. Thanks to KuKa, Gary Gregory. +o Add IMAPReply tests and documentation fixes #165. Thanks to KuKa, Gary Gregory, Bruno P. Kinoshita. + +Fixed Bugs: +o NET-650: Delegate host resolution to Socket.connect() #138. Thanks to Matthew McGillis, exceptionfactory, sebbASF. +o Fixes many grammar issues and typos in JavaDoc and code comments #141. Thanks to Martin Wiesner, Gary Gregory, sebbASF. +o Remove redundant (null) initializations and other clean ups #155. Thanks to Martin Wiesner, Gary Gregory. +o TFTPServer.setMaxTimeoutRetries() now throws IllegalArgumentException instead of RuntimeException. Thanks to Gary Gregory. +o TFTPServer.setSocketTimeout() now throws IllegalArgumentException instead of RuntimeException. Thanks to Gary Gregory. +o FTPCommand.checkArray() now throws IllegalStateException instead of RuntimeException. Thanks to Gary Gregory. +o org.apache.commons.net.nntp.Threader now throws IllegalStateException instead of RuntimeException. Thanks to Gary Gregory. +o POP3Command static initializer now throws IllegalStateException instead of RuntimeException. Thanks to Gary Gregory. +o SMTPCommand static initializer now throws IllegalStateException instead of RuntimeException. Thanks to Gary Gregory. +o SubnetUtils.SubnetInfo.getPreviousAddress() now throws IllegalStateException instead of RuntimeException. Thanks to Gary Gregory. +o IMAPExportMbox.MboxListener.chunkReceived(IMAP) now throws UncheckedIOException instead of RuntimeException. Thanks to Gary Gregory. +o IMAPUtils.imapLogin(URI, int, ProtocolCommandListener) now throws IOException instead of RuntimeException while maintaining method signature source compatibility. Thanks to Gary Gregory. +o [StepSecurity] ci: Harden GitHub Actions #156. Thanks to step-security-bot, Gary Gregory. +o NET-722: Javadoc for FtpClient.setControlKeepAliveReplyTimeout(Duration) says timeout is in milliseconds. Thanks to David Costanzo, Gary Gregory. +o Change class org.apache.commons.net.ftp.parser.MVSFTPEntryParser to support more datasets #182. Thanks to haegar9766, Gary Gregory. +o Bulletproof TFTPServerPathTest #173. Thanks to Jakub Kupczyk, Bruno P. Kinoshita, Gary Gregory. +o Deprecate org.apache.commons.net.util.Base64 in favor of java.util.Base64. Thanks to Gary Gregory. +o Replace use of org.apache.commons.net.util.Base64 with java.util.Base64 in org.apache.commons.net.ftp. Thanks to Gary Gregory. +o Replace use of org.apache.commons.net.util.Base64 with java.util.Base64 in org.apache.commons.net.imap. Thanks to Gary Gregory. +o Replace use of org.apache.commons.net.util.Base64 with java.util.Base64 in org.apache.commons.net.pop3. Thanks to Gary Gregory. +o Replace use of org.apache.commons.net.util.Base64 with java.util.Base64 in org.apache.commons.net.smtp. Thanks to Gary Gregory. + +Changes: +o Bump commons-parent from 54 to 62 #132, #137, #153. Thanks to Dependabot. +o Bump commons-io from 2.11.0 to 2.14.0. Thanks to Gary Gregory. +o Bump commons-lang3 from 3.12.0 to 3.13.0. Thanks to Gary Gregory. + + +Historical list of changes: https://commons.apache.org/proper/commons-net/changes-report.html + +Enjoy! +-Apache Commons Net team + +----------------------------------------------------------------------------- + Apache Commons Net 3.9.0 RELEASE NOTES diff --git a/src/changes/changes.xml b/src/changes/changes.xml index 2c211a7c..9c8b5a72 100644 --- a/src/changes/changes.xml +++ b/src/changes/changes.xml @@ -64,7 +64,7 @@ The <action> type attribute can be add,update,fix,remove. --> <body> - <release version="3.10.0" date="202Y-MM-DD" description="Maintenance and bug fix release (Java 8)."> + <release version="3.10.0" date="2023-10-01" description="Maintenance and bug fix release (Java 8)."> <!-- ADD --> <action type="add" dev="ggregory" due-to="Gary Gregory"> Add and use DatagramSocketClient.setDefaultTimeout(Duration) and deprecate DatagramSocketClient.setDefaultTimeout(int). diff --git a/src/changes/release-notes.vm b/src/changes/release-notes.vm index 9952e5d8..ab86526d 100644 --- a/src/changes/release-notes.vm +++ b/src/changes/release-notes.vm @@ -127,3 +127,5 @@ Historical list of changes: ${project.url}changes-report.html Enjoy! -Apache Commons Net team + +----------------------------------------------------------------------------- diff --git a/src/site/xdoc/download_net.xml b/src/site/xdoc/download_net.xml index d3ac9c79..7e95bf08 100644 --- a/src/site/xdoc/download_net.xml +++ b/src/site/xdoc/download_net.xml @@ -113,32 +113,32 @@ limitations under the License. </p> </subsection> </section> - <section name="Apache Commons Net 3.9.0 (Requires Java 1.8 or later)"> + <section name="Apache Commons Net 3.10.0 (Requires Java 8 or later)"> <subsection name="Binaries"> <table> <tr> - <td><a href="[preferred]/commons/net/binaries/commons-net-3.9.0-bin.tar.gz">commons-net-3.9.0-bin.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.9.0-bin.tar.gz.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.9.0-bin.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/net/binaries/commons-net-3.10.0-bin.tar.gz">commons-net-3.10.0-bin.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.tar.gz.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/net/binaries/commons-net-3.9.0-bin.zip">commons-net-3.9.0-bin.zip</a></td> - <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.9.0-bin.zip.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.9.0-bin.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/net/binaries/commons-net-3.10.0-bin.zip">commons-net-3.10.0-bin.zip</a></td> + <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.zip.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/net/binaries/commons-net-3.10.0-bin.zip.asc">pgp</a></td> </tr> </table> </subsection> <subsection name="Source"> <table> <tr> - <td><a href="[preferred]/commons/net/source/commons-net-3.9.0-src.tar.gz">commons-net-3.9.0-src.tar.gz</a></td> - <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.9.0-src.tar.gz.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.9.0-src.tar.gz.asc">pgp</a></td> + <td><a href="[preferred]/commons/net/source/commons-net-3.10.0-src.tar.gz">commons-net-3.10.0-src.tar.gz</a></td> + <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.tar.gz.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.tar.gz.asc">pgp</a></td> </tr> <tr> - <td><a href="[preferred]/commons/net/source/commons-net-3.9.0-src.zip">commons-net-3.9.0-src.zip</a></td> - <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.9.0-src.zip.sha512">sha512</a></td> - <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.9.0-src.zip.asc">pgp</a></td> + <td><a href="[preferred]/commons/net/source/commons-net-3.10.0-src.zip">commons-net-3.10.0-src.zip</a></td> + <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.zip.sha512">sha512</a></td> + <td><a href="https://downloads.apache.org/commons/net/source/commons-net-3.10.0-src.zip.asc">pgp</a></td> </tr> </table> </subsection>