<?xml version="1.0"?>
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
contributor license agreements.  See the NOTICE file distributed with
this work for additional information regarding copyright ownership.
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

     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,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
-->
<document>
 <properties>
  <title>Home</title>
  <author email="dev@commons.apache.org">Apache Commons Team</author>
 </properties>
<body>
<!-- ================================================== -->
<section name="Using Apache Commons CSV">
  <p>Commons CSV reads and writes files in variations of the Comma Separated Value (CSV) format.</p>
  <p>Read the documentation starting with the <a href="apidocs/index.html">Javadoc Overview</a>.</p>
</section>
<!-- ================================================== -->
<section name="Documentation">
<p>
An overview of the functionality is provided in the
<a href="apidocs/index.html">user guide</a>.
Various <a href="project-reports.html">project reports</a> are also available.
</p>
<p>
The Javadoc API documents are available online:
</p>
<ul>
  <li><a href="apidocs/index.html">Javadoc current</a></li>
  <li><a href="https://javadoc.io/doc/org.apache.commons/commons-csv/">Javadoc archives</a></li>
</ul>
<p>
The <a href="scm.html">git repository</a> can be
<a href="https://gitbox.apache.org/repos/asf?p=commons-csv.git">browsed</a>.
</p>
</section>
<!-- ================================================== -->
<section name="Releases">
<ul>
  <li><a href="https://commons.apache.org/csv/download_csv.cgi">Download Apache Commons CSV current (mirrors)</a>, requires Java 8 or above</li>
  <li><a href="https://archive.apache.org/dist/commons/csv/">Download Apache Commons CSV archived releases</a></li>
</ul>
<p>
See the
<a href="https://commons.apache.org/csv/download_csv.cgi">Download Page</a>
for the latest releases.
</p>
<p>
<a href="changes.html">Release History</a> are also available.
</p>
<p>
For previous releases, see the <a href="https://archive.apache.org/dist/commons/csv/">Apache Archive</a>
</p>
<p>
  For dependency access methods, see <a href="dependency-info.html">Dependency Information</a>
</p>
</section>

<section name="Building from sources">
  <p>The latest code can be checked out from our git repository at <a href="https://gitbox.apache.org/repos/asf/commons-csv.git">https://gitbox.apache.org/repos/asf/commons-csv.git</a>.
    You can build the component using Apache Maven using <code>mvn clean package</code>.
  </p>
</section>
<!-- ================================================== -->
<section name="Getting Involved">
  <p>
    The <a href="mail-lists.html">commons developer mailing list</a> is the main channel of communication for contributors. Please remember that the lists are shared between all commons components, so prefix your email by [csv]. </p>
  <p>You can also peruse <a href="issue-tracking.html">JIRA</a>. Specific links of interest for JIRA are:</p>
  <ul>
    <li>Ideas looking for code: <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20CSV%20AND%20resolution%20%3D%20Unresolved%20AND%20fixVersion%20%3D%20%22Patch%20Needed%22">Patch Needed</a></li>
    <li>Issues with patches, looking for reviews: <a href="https://issues.apache.org/jira/issues/?jql=project%20%3D%20CSV%20AND%20resolution%20%3D%20Unresolved%20AND%20fixVersion%20%3D%20Review">Review Patch</a></li>
  </ul>
  <p>Alternatively you can go through the <em>Needs Work</em> tags in the <a href="taglist.html">TagList report</a>.</p>
  <p>If you'd like to offer up pull requests via GitHub rather than applying patches to JIRA, we have a <a href="https://github.com/apache/commons-csv/">GitHub mirror</a>. </p>
</section>
<!-- ================================================== -->
<section name="Support">
  <p>
    The <a href="mail-lists.html">commons mailing lists</a> act as the main support forum.
    The user list is suitable for most library usage queries.
    The dev list is intended for the development discussion.
    Please remember that the lists are shared between all commons components,
    so prefix your email by [csv].
  </p>
  <p>
    Bug reports and enhancements are also welcomed via the <a href="issue-tracking.html">JIRA</a> issue tracker.
    Please read the instructions carefully.
  </p>
</section>
<!-- ================================================== -->

<section name="About Commons CSV">
  <p>Commons CSV was started to unify a common and simple interface for reading and writing CSV files under an ASL license. It has been bootstrapped by a code donation from Netcetera in Switzerland. There are three pre-existing BSD compatible CSV parsers which this component will hopefully make redundant (authors willing): </p>
  <ul>
    <li><a href="http://kasparov.skife.org/csv/">Skife CSV</a></li>
    <li><a href="https://opencsv.sourceforge.net/">Open CSV</a></li>
    <li><a href="http://www.osjava.org/genjava/multiproject/gj-csv/">Genjava CSV</a></li>
  </ul>
  <p>In addition to the code from Netcetera (org.apache.commons.csv), Martin van den Bemt has added an additional writer API. </p>
  <p>Other CSV implementations: </p>
  <ul>
    <li><a href="https://super-csv.github.io/super-csv/index.html">Super CSV</a></li>
  </ul>
</section>

<!-- ================================================== -->
</body>
</document>
