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-csv.git
commit 42f9de51e9bad83c7700d58552ce17c52d51458e
Author: Gary D. Gregory <garydgreg...@gmail.com>
AuthorDate: Sat Mar 15 15:34:29 2025 +0000
Prepare for the next release candidate
---
CONTRIBUTING.md | 6 ++--
README.md | 6 ++--
RELEASE-NOTES.txt | 61 ++++++++++++++++++++++++++++++++++++++++
src/site/xdoc/download_csv.xml | 36 +++++++++++++-----------
src/site/xdoc/issue-tracking.xml | 14 +++++----
src/site/xdoc/mail-lists.xml | 14 +++++----
6 files changed, 102 insertions(+), 35 deletions(-)
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 3b1bd3d9..beb9a235 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -6,7 +6,7 @@
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
+ https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
@@ -61,11 +61,11 @@ Making Changes
+ Create a _topic branch_ for your isolated work.
* Usually you should base your branch from the `master` branch.
- * A good topic branch name can be the JIRA bug ID plus a keyword, for
example, `CSV-123-InputStream`.
+ * A good topic branch name can be the JIRA bug ID plus a keyword, e.g.
`CSV-123-InputStream`.
* If you have submitted multiple JIRA issues, try to maintain separate
branches and pull requests.
+ 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.
- * For example, `[CSV-123] Close input stream earlier`
+ * For example, `[CSV-123] Close input stream sooner`
+ Respect the original code style:
+ Only use spaces for indentation; you can check for unnecessary whitespace
with `git diff` before committing.
+ 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.
diff --git a/README.md b/README.md
index 969da9b8..42c9894d 100644
--- a/README.md
+++ b/README.md
@@ -6,7 +6,7 @@
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
+ https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
@@ -45,7 +45,7 @@ Apache Commons CSV
[](https://github.com/apache/commons-csv/actions/workflows/maven.yml)
[](https://search.maven.org/artifact/org.apache.commons/commons-csv)
-[](https://javadoc.io/doc/org.apache.commons/commons-csv/1.13.0)
+[](https://javadoc.io/doc/org.apache.commons/commons-csv/1.14.0)
[](https://github.com/apache/commons-csv/actions/workflows/codeql-analysis.yml)
[](https://api.securityscorecards.dev/projects/github.com/apache/commons-csv)
@@ -68,7 +68,7 @@ Alternatively, you can pull it from the central Maven
repositories:
<dependency>
<groupId>org.apache.commons</groupId>
<artifactId>commons-csv</artifactId>
- <version>1.13.0</version>
+ <version>1.14.0</version>
</dependency>
```
diff --git a/RELEASE-NOTES.txt b/RELEASE-NOTES.txt
index 2d99a93d..599f0d1f 100644
--- a/RELEASE-NOTES.txt
+++ b/RELEASE-NOTES.txt
@@ -1,3 +1,64 @@
+Apache Commons CSV 1.14.0 Release Notes
+
+This document contains the release notes for the 1.14.0 version of Apache
Commons CSV.
+Commons CSV reads and writes files in variations of the Comma Separated Value
(CSV) format.
+
+Commons CSV requires at least Java 8.
+
+The Apache Commons CSV library provides a simple interface for reading and
writing CSV files of various types.
+
+This is a feature and maintenance release. Java 8 or later is required.
+
+Changes in this version include:
+
+New Features
+------------
+
+* Define and use Maven property commons.jmh.version. Thanks to Gary
Gregory.
+* Add CSVFormat.Builder.setMaxRows(long). Thanks to Gary Gregory.
+* Add CSVFormat.getMaxRows(). Thanks to Gary Gregory.
+* CSVPrinter.printRecords(ResultSet) knows how to use CSVFormat's
maxRows. Thanks to Gary Gregory.
+* CSVPrinter.printRecords(Iterable) knows how to use CSVFormat's
maxRows. Thanks to Gary Gregory.
+* CSVPrinter.printRecords(Stream) knows how to use CSVFormat's
maxRows. Thanks to Gary Gregory.
+* CSVParser.stream() knows how to use CSVFormat's maxRows. Thanks to
Gary Gregory.
+* CSVParser.getRecords() knows how to use CSVFormat's maxRows.
Thanks to Gary Gregory.
+* CSVParser.iterator() knows how to use CSVFormat's maxRows. Thanks
to Gary Gregory.
+
+Fixed Bugs
+----------
+
+* CSV-317: Release history link changed from changes-report.html to
changes.html #516. Thanks to Filipe Roque.
+* Remove -nouses directive from maven-bundle-plugin. OSGi package
imports now state 'uses' definitions for package imports, this doesn't affect
JPMS (from org.apache.commons:commons-parent:80). Thanks to Gary Gregory.
+* CSVParser.parse(URL, Charset, CSVFormat) with a null CSVFormat
maps to CSVFormat.DEFAULT (like CSVParser.parse(Reader, CSVFormat)). Thanks to
Gary Gregory.
+* CSVParser.parse(String, CSVFormat) with a null CSVFormat maps to
CSVFormat.DEFAULT (like CSVParser.parse(Reader, CSVFormat)). Thanks to Gary
Gregory.
+* CSVParser.parse(File, Charset, CSVFormat) with a null CSVFormat
maps to CSVFormat.DEFAULT (like CSVParser.parse(Reader, CSVFormat)). Thanks to
Gary Gregory.
+* CSVParser.parse(Path, Charset, CSVFormat) with a null CSVFormat
maps to CSVFormat.DEFAULT (like CSVParser.parse(Reader, CSVFormat)). Thanks to
Gary Gregory.
+* CSVParser.parse(InputStream, Charset, CSVFormat) with a null
CSVFormat maps to CSVFormat.DEFAULT (like CSVParser.parse(Reader, CSVFormat)).
Thanks to Gary Gregory.
+* CSVParser.parse(*) methods with a null Charset maps to
Charset.defaultCharset(). Thanks to Gary Gregory.
+* Fix possible NullPointerException in Token.toString(). Thanks to
Gary Gregory.
+
+Changes
+-------
+
+* Bump com.opencsv:opencsv from 5.9 to 5.10. Thanks to Gary Gregory.
+* Bump commons-codec:commons-codec from 1.17.2 to 1.18.0 #522.
Thanks to Gary Gregory.
+* Bump org.apache.commons:commons-parent from 79 to 81. Thanks to
Gary Gregory.
+
+
+Historical list of changes:
https://commons.apache.org/proper/commons-csv/changes.html
+
+For complete information on Apache Commons CSV, including instructions on how
to submit bug reports,
+patches, or suggestions for improvement, see the Apache Commons CSV website:
+
+https://commons.apache.org/proper/commons-csv/
+
+Download page: https://commons.apache.org/proper/commons-csv/download_csv.cgi
+
+Have fun!
+-Apache Commons CSV team
+
+------------------------------------------------------------------------------
+
Apache Commons CSV Version 1.13.0 Release Notes
This document contains the release notes for the 1.13.0 version of Apache
Commons CSV.
diff --git a/src/site/xdoc/download_csv.xml b/src/site/xdoc/download_csv.xml
index 00b7f3c7..b5e7881d 100644
--- a/src/site/xdoc/download_csv.xml
+++ b/src/site/xdoc/download_csv.xml
@@ -7,7 +7,7 @@ The ASF licenses this file to You under the Apache License,
Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
+ https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
@@ -56,10 +56,12 @@ limitations under the License.
| |
+======================================================================+
-->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
https://maven.apache.org/xsd/xdoc-2.0.xsd";>
<properties>
<title>Download Apache Commons CSV</title>
- <author email="d...@commons.apache.org">Apache Commons Documentation
Team</author>
+ <author email="d...@commons.apache.org">Apache Commons Team</author>
</properties>
<body>
<section name="Download Apache Commons CSV">
@@ -79,7 +81,7 @@ limitations under the License.
mirrors (at the end of the mirrors list) that should be
available.
<br></br>
- [if-any logo]<a href="[link]"><img align="right" src="[logo]"
border="0"></img></a>[end]
+ [if-any logo]<a href="[link]"><img align="right" src="[logo]"
border="0" alt="Logo"></img></a>[end]
</p>
<form action="[location]" method="get" id="SelectMirror">
@@ -113,32 +115,32 @@ limitations under the License.
</p>
</subsection>
</section>
- <section name="Apache Commons CSV 1.13.0 (Java 8 or above)">
+ <section name="Apache Commons CSV 1.14.0 (Java 8 or above)">
<subsection name="Binaries">
<table>
<tr>
- <td><a
href="[preferred]/commons/csv/binaries/commons-csv-1.13.0-bin.tar.gz">commons-csv-1.13.0-bin.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.13.0-bin.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.13.0-bin.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/csv/binaries/commons-csv-1.14.0-bin.tar.gz">commons-csv-1.14.0-bin.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.14.0-bin.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.14.0-bin.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/csv/binaries/commons-csv-1.13.0-bin.zip">commons-csv-1.13.0-bin.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.13.0-bin.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.13.0-bin.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/csv/binaries/commons-csv-1.14.0-bin.zip">commons-csv-1.14.0-bin.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.14.0-bin.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.14.0-bin.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
<subsection name="Source">
<table>
<tr>
- <td><a
href="[preferred]/commons/csv/source/commons-csv-1.13.0-src.tar.gz">commons-csv-1.13.0-src.tar.gz</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.13.0-src.tar.gz.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.13.0-src.tar.gz.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/csv/source/commons-csv-1.14.0-src.tar.gz">commons-csv-1.14.0-src.tar.gz</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.14.0-src.tar.gz.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.14.0-src.tar.gz.asc";>pgp</a></td>
</tr>
<tr>
- <td><a
href="[preferred]/commons/csv/source/commons-csv-1.13.0-src.zip">commons-csv-1.13.0-src.zip</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.13.0-src.zip.sha512";>sha512</a></td>
- <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.13.0-src.zip.asc";>pgp</a></td>
+ <td><a
href="[preferred]/commons/csv/source/commons-csv-1.14.0-src.zip">commons-csv-1.14.0-src.zip</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.14.0-src.zip.sha512";>sha512</a></td>
+ <td><a
href="https://downloads.apache.org/commons/csv/source/commons-csv-1.14.0-src.zip.asc";>pgp</a></td>
</tr>
</table>
</subsection>
diff --git a/src/site/xdoc/issue-tracking.xml b/src/site/xdoc/issue-tracking.xml
index 3564ef4f..3aa64b40 100644
--- a/src/site/xdoc/issue-tracking.xml
+++ b/src/site/xdoc/issue-tracking.xml
@@ -7,7 +7,7 @@ The ASF licenses this file to You under the Apache License,
Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
+ https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
@@ -41,10 +41,12 @@ limitations under the License.
| |
+======================================================================+
-->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
https://maven.apache.org/xsd/xdoc-2.0.xsd";>
<properties>
<title>Apache Commons CSV Issue tracking</title>
- <author email="d...@commons.apache.org">Apache Commons Documentation
Team</author>
+ <author email="d...@commons.apache.org">Apache Commons Team</author>
</properties>
<body>
@@ -64,6 +66,7 @@ limitations under the License.
<p>
If you would like to report a bug, or raise an enhancement request with
Apache Commons CSV please do the following:
+ </p>
<ol>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12313222&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>Search
existing open bugs</a>.
If you find your issue listed then please add a comment with your
details.</li>
@@ -73,16 +76,15 @@ limitations under the License.
<li>Submit either a <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12313222&issuetype=1&priority=4&assignee=-1";>bug
report</a>
or <a
href="https://issues.apache.org/jira/secure/CreateIssueDetails!init.jspa?pid=12313222&issuetype=4&priority=4&assignee=-1";>enhancement
request</a>.</li>
</ol>
- </p>
<p>
Please also remember these points:
+ </p>
<ul>
<li>the more information you provide, the better we can help you</li>
<li>test cases are vital, particularly for any proposed
enhancements</li>
<li>the developers of Apache Commons CSV are all unpaid volunteers</li>
</ul>
- </p>
<p>
For more information on creating patches see the
@@ -91,12 +93,12 @@ limitations under the License.
<p>
You may also find these links useful:
+ </p>
<ul>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12313222&sorter/field=issuekey&sorter/order=DESC&status=1&status=3&status=4";>All
Open Apache Commons CSV bugs</a></li>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12313222&sorter/field=issuekey&sorter/order=DESC&status=5&status=6";>All
Resolved Apache Commons CSV bugs</a></li>
<li><a
href="https://issues.apache.org/jira/secure/IssueNavigator.jspa?reset=true&pid=12313222&sorter/field=issuekey&sorter/order=DESC";>All
Apache Commons CSV bugs</a></li>
</ul>
- </p>
</section>
</body>
</document>
diff --git a/src/site/xdoc/mail-lists.xml b/src/site/xdoc/mail-lists.xml
index 727e4a55..345cef89 100644
--- a/src/site/xdoc/mail-lists.xml
+++ b/src/site/xdoc/mail-lists.xml
@@ -7,7 +7,7 @@ The ASF licenses this file to You under the Apache License,
Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
- http://www.apache.org/licenses/LICENSE-2.0
+ https://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
@@ -39,10 +39,12 @@ limitations under the License.
| |
+======================================================================+
-->
-<document>
+<document xmlns="http://maven.apache.org/XDOC/2.0";
+ xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
+ xsi:schemaLocation="http://maven.apache.org/XDOC/2.0
https://maven.apache.org/xsd/xdoc-2.0.xsd";>
<properties>
<title>Apache Commons CSV Mailing Lists</title>
- <author email="d...@commons.apache.org">Apache Commons Documentation
Team</author>
+ <author email="d...@commons.apache.org">Apache Commons Team</author>
</properties>
<body>
@@ -53,10 +55,10 @@ limitations under the License.
To make it easier for people to only read messages related to
components they are interested in,
the convention in Commons is to prefix the subject line of messages
with the component's name,
for example:
- <ul>
- <li>[csv] Problem with the ...</li>
- </ul>
</p>
+ <ul>
+ <li>[csv] Problem with the ...</li>
+ </ul>
<p>
Questions related to the usage of Apache Commons CSV should be posted
to the
<a
href="https://lists.apache.org/list.html?u...@commons.apache.org";>User List</a>.
