Apache
/
commons-csv
mirror of https://github.com/apache/commons-csv.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Prepare release candidate

This commit is contained in:
Gary Gregory 2022-10-16 08:16:22 -04:00
parent 6fce181abf
commit dc786a4cf5
6 changed files with 373 additions and 237 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

67
README.md
View File

@ -44,10 +44,11 @@ Apache Commons CSV
=================== ===================
[![GitHub Actions Status](https://github.com/apache/commons-csv/workflows/Java%20CI/badge.svg)](https://github.com/apache/commons-csv/actions) [![GitHub Actions Status](https://github.com/apache/commons-csv/workflows/Java%20CI/badge.svg)](https://github.com/apache/commons-csv/actions)
[![Coverage Status](https://codecov.io/gh/apache/commons-csv/branch/master/graph/badge.svg)](https://app.codecov.io/gh/apache/commons-csv/branch/master) [![Coverage Status](https://codecov.io/gh/apache/commons-csv/branch/master/graph/badge.svg)](https://app.codecov.io/gh/apache/commons-csv)
[![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-csv/badge.svg?gav=true)](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-csv/?gav=true) [![Maven Central](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-csv/badge.svg?gav=true)](https://maven-badges.herokuapp.com/maven-central/org.apache.commons/commons-csv/?gav=true)
[![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-csv/1.9.0.svg)](https://javadoc.io/doc/org.apache.commons/commons-csv/1.9.0) [![Javadocs](https://javadoc.io/badge/org.apache.commons/commons-csv/1.10.0.svg)](https://javadoc.io/doc/org.apache.commons/commons-csv/1.10.0)
[![CodeQL](https://github.com/apache/commons-csv/workflows/CodeQL/badge.svg)](https://github.com/apache/commons-csv/actions/workflows/codeql-analysis.yml?query=workflow%3ACodeQL) [![CodeQL](https://github.com/apache/commons-csv/workflows/CodeQL/badge.svg)](hhttps://github.com/apache/commons-csv/actions/workflows/codeql-analysis.yml?query=workflow%3ACodeQL)
[![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/apache/commons-text/badge)](https://api.securityscorecards.dev/projects/github.com/apache/commons-text)
The Apache Commons CSV library provides a simple interface for reading and writing CSV files of various types. The Apache Commons CSV library provides a simple interface for reading and writing CSV files of various types.
@ -68,14 +69,14 @@ Alternatively you can pull it from the central Maven repositories:
<dependency> <dependency>
<groupId>org.apache.commons</groupId> <groupId>org.apache.commons</groupId>
<artifactId>commons-csv</artifactId> <artifactId>commons-csv</artifactId>
<version>1.9.0</version> <version>1.10.0</version>
</dependency> </dependency>
``` ```
Contributing Contributing
------------ ------------
We accept Pull Requests via GitHub. The [developer mailing list][ml] is the main channel of communication for contributors. We accept Pull Requests via GitHub. The [developer mailing list](https://commons.apache.org/mail-lists.html) is the main channel of communication for contributors.
There are some guidelines which will make applying PRs easier for us: There are some guidelines which will make applying PRs easier for us:
+ No tabs! Please use spaces for indentation. + No tabs! Please use spaces for indentation.
+ Respect the code style. + Respect the code style.
@ -100,7 +101,61 @@ Additional Resources
+ [Apache Commons Homepage](https://commons.apache.org/) + [Apache Commons Homepage](https://commons.apache.org/)
+ [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/CSV) + [Apache Issue Tracker (JIRA)](https://issues.apache.org/jira/browse/CSV)
+ [Apache Commons Slack Channel](https://the-asf.slack.com/archives/C60NVB8AD)
+ [Apache Commons Twitter Account](https://twitter.com/ApacheCommons) + [Apache Commons Twitter Account](https://twitter.com/ApacheCommons)
+ `#apache-commons` IRC channel on `irc.freenode.org` + `#apache-commons` IRC channel on `irc.freenode.org`
[ml]:https://commons.apache.org/mail-lists.html Apache Commons Components
-------------------------
| Component | GitHub Repository | Apache Homepage |
| --------- | ----------------- | ----------------|
| Apache Commons BCEL | [commons-bcel](https://github.com/apache/commons-bcel) | [commons-bcel](https://commons.apache.org/proper/commons-bcel) |
| Apache Commons Beanutils | [commons-beanutils](https://github.com/apache/commons-beanutils) | [commons-beanutils](https://commons.apache.org/proper/commons-beanutils) |
| Apache Commons BSF | [commons-bsf](https://github.com/apache/commons-bsf) | [commons-bsf](https://commons.apache.org/proper/commons-bsf) |
| Apache Commons Build-plugin | [commons-build-plugin](https://github.com/apache/commons-build-plugin) | [commons-build-plugin](https://commons.apache.org/proper/commons-build-plugin) |
| Apache Commons Chain | [commons-chain](https://github.com/apache/commons-chain) | [commons-chain](https://commons.apache.org/proper/commons-chain) |
| Apache Commons CLI | [commons-cli](https://github.com/apache/commons-cli) | [commons-cli](https://commons.apache.org/proper/commons-cli) |
| Apache Commons Codec | [commons-codec](https://github.com/apache/commons-codec) | [commons-codec](https://commons.apache.org/proper/commons-codec) |
| Apache Commons Collections | [commons-collections](https://github.com/apache/commons-collections) | [commons-collections](https://commons.apache.org/proper/commons-collections) |
| Apache Commons Compress | [commons-compress](https://github.com/apache/commons-compress) | [commons-compress](https://commons.apache.org/proper/commons-compress) |
| Apache Commons Configuration | [commons-configuration](https://github.com/apache/commons-configuration) | [commons-configuration](https://commons.apache.org/proper/commons-configuration) |
| Apache Commons Crypto | [commons-crypto](https://github.com/apache/commons-crypto) | [commons-crypto](https://commons.apache.org/proper/commons-crypto) |
| Apache Commons CSV | [commons-csv](https://github.com/apache/commons-csv) | [commons-csv](https://commons.apache.org/proper/commons-csv) |
| Apache Commons Daemon | [commons-daemon](https://github.com/apache/commons-daemon) | [commons-daemon](https://commons.apache.org/proper/commons-daemon) |
| Apache Commons DBCP | [commons-dbcp](https://github.com/apache/commons-dbcp) | [commons-dbcp](https://commons.apache.org/proper/commons-dbcp) |
| Apache Commons Dbutils | [commons-dbutils](https://github.com/apache/commons-dbutils) | [commons-dbutils](https://commons.apache.org/proper/commons-dbutils) |
| Apache Commons Digester | [commons-digester](https://github.com/apache/commons-digester) | [commons-digester](https://commons.apache.org/proper/commons-digester) |
| Apache Commons Email | [commons-email](https://github.com/apache/commons-email) | [commons-email](https://commons.apache.org/proper/commons-email) |
| Apache Commons Exec | [commons-exec](https://github.com/apache/commons-exec) | [commons-exec](https://commons.apache.org/proper/commons-exec) |
| Apache Commons Fileupload | [commons-fileupload](https://github.com/apache/commons-fileupload) | [commons-fileupload](https://commons.apache.org/proper/commons-fileupload) |
| Apache Commons Functor | [commons-functor](https://github.com/apache/commons-functor) | [commons-functor](https://commons.apache.org/proper/commons-functor) |
| Apache Commons Geometry | [commons-geometry](https://github.com/apache/commons-geometry) | [commons-geometry](https://commons.apache.org/proper/commons-geometry) |
| Apache Commons Graph | [commons-graph](https://github.com/apache/commons-graph) | [commons-graph](https://commons.apache.org/proper/commons-graph) |
| Apache Commons Imaging | [commons-imaging](https://github.com/apache/commons-imaging) | [commons-imaging](https://commons.apache.org/proper/commons-imaging) |
| Apache Commons IO | [commons-io](https://github.com/apache/commons-io) | [commons-io](https://commons.apache.org/proper/commons-io) |
| Apache Commons JCI | [commons-jci](https://github.com/apache/commons-jci) | [commons-jci](https://commons.apache.org/proper/commons-jci) |
| Apache Commons JCS | [commons-jcs](https://github.com/apache/commons-jcs) | [commons-jcs](https://commons.apache.org/proper/commons-jcs) |
| Apache Commons Jelly | [commons-jelly](https://github.com/apache/commons-jelly) | [commons-jelly](https://commons.apache.org/proper/commons-jelly) |
| Apache Commons Jexl | [commons-jexl](https://github.com/apache/commons-jexl) | [commons-jexl](https://commons.apache.org/proper/commons-jexl) |
| Apache Commons Jxpath | [commons-jxpath](https://github.com/apache/commons-jxpath) | [commons-jxpath](https://commons.apache.org/proper/commons-jxpath) |
| Apache Commons Lang | [commons-lang](https://github.com/apache/commons-lang) | [commons-lang](https://commons.apache.org/proper/commons-lang) |
| Apache Commons Logging | [commons-logging](https://github.com/apache/commons-logging) | [commons-logging](https://commons.apache.org/proper/commons-logging) |
| Apache Commons Math | [commons-math](https://github.com/apache/commons-math) | [commons-math](https://commons.apache.org/proper/commons-math) |
| Apache Commons Net | [commons-net](https://github.com/apache/commons-net) | [commons-net](https://commons.apache.org/proper/commons-net) |
| Apache Commons Numbers | [commons-numbers](https://github.com/apache/commons-numbers) | [commons-numbers](https://commons.apache.org/proper/commons-numbers) |
| Apache Commons Parent | [commons-parent](https://github.com/apache/commons-parent) | [commons-parent](https://commons.apache.org/proper/commons-parent) |
| Apache Commons Pool | [commons-pool](https://github.com/apache/commons-pool) | [commons-pool](https://commons.apache.org/proper/commons-pool) |
| Apache Commons Proxy | [commons-proxy](https://github.com/apache/commons-proxy) | [commons-proxy](https://commons.apache.org/proper/commons-proxy) |
| Apache Commons RDF | [commons-rdf](https://github.com/apache/commons-rdf) | [commons-rdf](https://commons.apache.org/proper/commons-rdf) |
| Apache Commons Release-plugin | [commons-release-plugin](https://github.com/apache/commons-release-plugin) | [commons-release-plugin](https://commons.apache.org/proper/commons-release-plugin) |
| Apache Commons Rng | [commons-rng](https://github.com/apache/commons-rng) | [commons-rng](https://commons.apache.org/proper/commons-rng) |
| Apache Commons Scxml | [commons-scxml](https://github.com/apache/commons-scxml) | [commons-scxml](https://commons.apache.org/proper/commons-scxml) |
| Apache Commons Signing | [commons-signing](https://github.com/apache/commons-signing) | [commons-signing](https://commons.apache.org/proper/commons-signing) |
| Apache Commons Skin | [commons-skin](https://github.com/apache/commons-skin) | [commons-skin](https://commons.apache.org/proper/commons-skin) |
| Apache Commons Statistics | [commons-statistics](https://github.com/apache/commons-statistics) | [commons-statistics](https://commons.apache.org/proper/commons-statistics) |
| Apache Commons Testing | [commons-testing](https://github.com/apache/commons-testing) | [commons-testing](https://commons.apache.org/proper/commons-testing) |
| Apache Commons Text | [commons-text](https://github.com/apache/commons-text) | [commons-text](https://commons.apache.org/proper/commons-text) |
| Apache Commons Validator | [commons-validator](https://github.com/apache/commons-validator) | [commons-validator](https://commons.apache.org/proper/commons-validator) |
| Apache Commons VFS | [commons-vfs](https://github.com/apache/commons-vfs) | [commons-vfs](https://commons.apache.org/proper/commons-vfs) |
| Apache Commons Weaver | [commons-weaver](https://github.com/apache/commons-weaver) | [commons-weaver](https://commons.apache.org/proper/commons-weaver) |

81
RELEASE-NOTES.txt
View File

@ -1,3 +1,84 @@
Apache Commons CSV
Version 1.10.0
Release Notes
INTRODUCTION:
This document contains the release notes for the 1.10.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 bug fix release.
Changes in this version include:
NEW FEATURES
============
o CSV-291: Make CSVRecord#values() public. Thanks to Gary Gregory.
o CSV-264: Add DuplicateHeaderMode for flexibility with header strictness. #114. Thanks to Sagar Tiwari, Seth Falco, Alex Herbert, Gary Gregory.
o CSV-295: Support for parallelism in CSVPrinter. Thanks to Gary Gregory.
o CSV-295: Add CSVPrinter.printRecord[s](Stream). Thanks to Gary Gregory.
o CSV-304: Add accessors for header/trailer comments #257. Thanks to Peter Hull, Bruno P. Kinoshita, Gary Gregory.
o Add github/codeql-action.
FIXED BUGS
==========
o Minor changes #172. Thanks to Arturo Bernal.
o CSV-292: No Automatic-Module-Name prevents usage in JPMS projects without repacking the JAR. Thanks to Rob Vesse.
o CSV-288: Fix for multi-char delimiter not working as expected #218. Thanks to Santhsoh, Angus.
o CSV-269: CSVRecord.get(Enum) should use Enum.name() instead of Enum.toString(). Thanks to Auke te Winkel, Gary Gregory.
o Allow org.apache.commons.csv.IOUtils.copy(Reader, Appendable, CharBuffer) to compile on Java 11 and run on Java 8. Thanks to Gary Gregory.
o CSV-300: CSVRecord.toList() does not give write access to the new List. Thanks to Markus Spann, Gary Gregory.
o CSVParser.getRecords() now throws UncheckedIOException instead of IOException. Thanks to Gary Gregory.
o CSV-274: Add comments to iterator() and stream() #270. Thanks to Peter Hull, Bruno P. Kinoshita, Gary Gregory.
o CSV-290: Fix wrong assumptions in PostgreSQL formats #265. Thanks to angusdev, Gary Gregory.
o Validate input to setDelimiter(String) for empty string #266. Thanks to Mykola Faryma.
CHANGES
=======
o Bump actions/cache from 2.1.6 to 3.0.10 #196, #233, #243, #267, #271. Thanks to Dependabot, Gary Gregory.
o Bump actions/checkout from 2.3.4 to 3.1.0 #188, #195, #220, #272. Thanks to Dependabot, Gary Gregory.
o Bump actions/setup-java from 2 to 3.5.1. Thanks to Gary Gregory.
o Bump commons-parent from 52 to 54 #264. Thanks to Gary Gregory.
o Bump checkstyle from 8.44 to 9.2.1 #180, #190, #194, #202, #207. Thanks to Dependabot.
o Bump junit-jupiter from 5.8.0-M1 to 5.9.1 #179, #186, #201, #244, #263. Thanks to Dependabot.
o Bump jmh-core from 1.32 to 1.35 #176, #208, #229. Thanks to Dependabot.
o Bump jmh-generator-annprocess from 1.32 to 1.35 #175, #206, #226. Thanks to Dependabot.
o Bump mockito-core from 3.11.2 to 4.8.0 #187, #197, #204, #212, #230, #237, #251, #259. Thanks to Dependabot, Gary Gregory.
o Bump maven-pmd-plugin from 3.14.0 to 3.19.0 #184, #219, #238, #254, #258. Thanks to Dependabot.
o Bump pmd from 6.36.0 to 6.50.0 #173, #189, #193, #199, #227, #233, #214, #236, #240, #247, #255, #273. Thanks to Dependabot, Gary Gregory.
o Bump opencsv from 5.5.1 to 5.7.0 #182, #221, #260. Thanks to Gary Gregory.
o Bump spotbugs-maven-plugin from 4.3.0 to 4.7.2.1 #192, #198, #203, #211, #225, #234, #242, #245, #261, #275. Thanks to Dependabot.
o Bump com.github.spotbugs:spotbugs from 4.5.3 to 4.7.2. Thanks to Gary Gregory.
o Bump h2 from 1.4.200 to 2.1.214 #200, #205, #213, #239. Thanks to Dependabot.
o Bump maven-javadoc-plugin from 3.3.0 to 3.4.1. Thanks to Gary Gregory.
o Bump biz.aQute.bnd:biz.aQute.bndlib from 5.3.0 to 6.3.1. Thanks to Gary Gregory.
o Bump jacoco-maven-plugin from 0.8.7 to 0.8.8. Thanks to Gary Gregory.
o Bump japicmp-maven-plugin from 0.15.3 to 0.16.0. Thanks to Gary Gregory.
o Bump maven-checkstyle-plugin from 3.1.2 to 3.2.0 #253. Thanks to Dependabot.
Historical list of changes: https://commons.apache.org/proper/commons-csv/changes-report.html
For complete information on Apache Commons CSV, including instructions on how to submit bug reports,
patches, or suggestions for improvement, see the Apache 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 Apache Commons CSV
Version 1.9.0 Version 1.9.0
Release Notes Release Notes

2
src/changes/changes.xml
View File

@ -38,7 +38,7 @@
<title>Apache Commons CSV Release Notes</title> <title>Apache Commons CSV Release Notes</title>
</properties> </properties>
<body> <body>
<release version="1.10.0" date="2021-MM-DD" description="Feature and bug fix release (Java 8)"> <release version="1.10.0" date="2022-10-16" description="Feature and bug fix release (Java 8)">
<!-- FIX --> <!-- FIX -->
<action type="fix" dev="ggregory" due-to="Arturo Bernal">Minor changes #172.</action> <action type="fix" dev="ggregory" due-to="Arturo Bernal">Minor changes #172.</action>
<action issue="CSV-292" type="fix" dev="kinow" due-to="Rob Vesse">No Automatic-Module-Name prevents usage in JPMS projects without repacking the JAR.</action> <action issue="CSV-292" type="fix" dev="kinow" due-to="Rob Vesse">No Automatic-Module-Name prevents usage in JPMS projects without repacking the JAR.</action>

28
src/site/xdoc/download_csv.xml
View File

@ -107,38 +107,38 @@ limitations under the License.
failing that using the <code>SHA512</code> hash (<code>*.sha512</code> checksum files). failing that using the <code>SHA512</code> hash (<code>*.sha512</code> checksum files).
</p> </p>
<p> <p>
The <a href="https://www.apache.org/dist/commons/KEYS">KEYS</a> The <a href="https://downloads.apache.org/commons/KEYS">KEYS</a>
file contains the public PGP keys used by Apache Commons developers file contains the public PGP keys used by Apache Commons developers
to sign releases. to sign releases.
</p> </p>
</subsection> </subsection>
</section> </section>
<section name="Apache Commons CSV 1.9.0 (Java 8)"> <section name="Apache Commons CSV 1.10.0 (Java 8)">
<subsection name="Binaries"> <subsection name="Binaries">
<table> <table>
<tr> <tr>
<td><a href="[preferred]/commons/csv/binaries/commons-csv-1.9.0-bin.tar.gz">commons-csv-1.9.0-bin.tar.gz</a></td> <td><a href="[preferred]/commons/csv/binaries/commons-csv-1.10.0-bin.tar.gz">commons-csv-1.10.0-bin.tar.gz</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/binaries/commons-csv-1.9.0-bin.tar.gz.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.10.0-bin.tar.gz.sha512">sha512</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/binaries/commons-csv-1.9.0-bin.tar.gz.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.10.0-bin.tar.gz.asc">pgp</a></td>
</tr> </tr>
<tr> <tr>
<td><a href="[preferred]/commons/csv/binaries/commons-csv-1.9.0-bin.zip">commons-csv-1.9.0-bin.zip</a></td> <td><a href="[preferred]/commons/csv/binaries/commons-csv-1.10.0-bin.zip">commons-csv-1.10.0-bin.zip</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/binaries/commons-csv-1.9.0-bin.zip.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.10.0-bin.zip.sha512">sha512</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/binaries/commons-csv-1.9.0-bin.zip.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/csv/binaries/commons-csv-1.10.0-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/csv/source/commons-csv-1.9.0-src.tar.gz">commons-csv-1.9.0-src.tar.gz</a></td> <td><a href="[preferred]/commons/csv/source/commons-csv-1.10.0-src.tar.gz">commons-csv-1.10.0-src.tar.gz</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/source/commons-csv-1.9.0-src.tar.gz.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/csv/source/commons-csv-1.10.0-src.tar.gz.sha512">sha512</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/source/commons-csv-1.9.0-src.tar.gz.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/csv/source/commons-csv-1.10.0-src.tar.gz.asc">pgp</a></td>
</tr> </tr>
<tr> <tr>
<td><a href="[preferred]/commons/csv/source/commons-csv-1.9.0-src.zip">commons-csv-1.9.0-src.zip</a></td> <td><a href="[preferred]/commons/csv/source/commons-csv-1.10.0-src.zip">commons-csv-1.10.0-src.zip</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/source/commons-csv-1.9.0-src.zip.sha512">sha512</a></td> <td><a href="https://downloads.apache.org/commons/csv/source/commons-csv-1.10.0-src.zip.sha512">sha512</a></td>
<td><a href="https://www.apache.org/dist/commons/csv/source/commons-csv-1.9.0-src.zip.asc">pgp</a></td> <td><a href="https://downloads.apache.org/commons/csv/source/commons-csv-1.10.0-src.zip.asc">pgp</a></td>
</tr> </tr>
</table> </table>
</subsection> </subsection>

2
src/site/xdoc/issue-tracking.xml
View File

@ -85,7 +85,7 @@ limitations under the License.
</p> </p>
<p> <p>
For more information on subversion and creating patches see the For more information on creating patches see the
<a href="https://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>. <a href="https://www.apache.org/dev/contributors.html">Apache Contributors Guide</a>.
</p> </p>

2
src/site/xdoc/mail-lists.xml
View File

@ -158,7 +158,7 @@ limitations under the License.
<td> <td>
<strong>Commons Commits List</strong> <strong>Commons Commits List</strong>
<br /><br /> <br /><br />
Only for e-mails automatically generated by the <a href="scm.html">source control</a> sytem. Only for e-mails automatically generated by the <a href="scm.html">source control</a> system.
<br /><br /> <br /><br />
</td> </td>
<td><a href="mailto:commits-subscribe@commons.apache.org">Subscribe</a></td> <td><a href="mailto:commits-subscribe@commons.apache.org">Subscribe</a></td>