| <?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> |