csv-async

crates.io Documentation Version

build status build status build status codecov

This is CSV library to use in asynchronous environment. Implemented API is similar to existing csv crate with few exceptions like builder's create_ functions instead of from_ as in csv.

Some code is borrowed from csv crate (synchronized with version 1.1.4 - Nov 2020). This package shares CSV parsing routines with csv by means of using csv-core crate. Major version of this crate will be kept in sync with major version of csv with which it is API compatible.

CSV files are being read or written by objects of types AsyncReader / AsyncWriter to / from generic text-based structures or by AsyncDeserializer / AsyncSerializer to / from data specific structures with generated serde interfaces.

Library does not contain synchronous reader/writer. If you need it - please use csv crate.

Cargo Features

Features which can be enabled / disabled during library build.

| Feature | Default | Description | |--------------|---------|-------------| | with_serde | on | Enables crate to use serde derive macros | | tokio | off | Enables crate to be used with tokio runtime and libraries |

Enabling tokio feature allows user to use tokio::fs::File and makes AsyncReader (AsyncWriter) to be based on tokio::io::AsyncRead (tokio::io::AsyncWrite). Currently this crate depends on tokio version 0.2.

Without tokio feature, this crate depends only on futures crate and reader (writer) are based on traits futures::io::AsyncRead (futures::io::AsyncWrite), what allows user to use async_std::fs::File.

Example usage:

Sample input file: csv city,region,country,population Southborough,MA,United States,9686 Northbridge,MA,United States,14061 Marlborough,MA,United States,38334 Springfield,MA,United States,152227 Springfield,MO,United States,150443 Springfield,NJ,United States,14976 Concord,NH,United States,42605

```rust use std::error::Error; use std::process; use futures::stream::StreamExt; use async_std::fs::File;

async fn filterbyregion(region:&str, filein:&str, fileout:&str) -> Result<(), Box> { // Function reads CSV file that has column named "region" at second position (index = 1). // It writes to new file only rows with region equal to passed argument // and removes region column. let mut rdr = csvasync::AsyncReader::fromreader( File::open(filein).await? ); let mut wri = csvasync::AsyncWriter::fromwriter( File::create(fileout).await? ); wri.writerecord(rdr .headers() .await?.intoiter() .filter(|h| *h != "region") ).await?; let mut records = rdr.records(); while let Some(record) = records.next().await { let record = record?; match record.get(1) { Some(reg) if reg == region => wri.writerecord(record .iter() .enumerate() .filter(|(i, _)| *i != 1) .map(|(, s)| s) ).await?, _ => {}, } } Ok(()) }

fn main() { asyncstd::task::blockon(async { if let Err(err) = filterbyregion( "MA", "/tmp/allregions.csv", "/tmp/MAonly.csv" ).await { eprintln!("error running filterbyregion: {}", err); process::exit(1); } }); } ```

For serde example please see documentation root page.

Plans

Some ideas for future development: