IROX CSV Encoder/Decoder
Inspired by Python's csv
module, a very basic csv reader & writer.
The primary use-case of this library is interacting with unstructured, variably structured, or dubiously structured data. As such, you probably want the far more robust and far better implemented csv
crate.
Goals:
- Provide a
String
-based mechanism to read and write CSV files in rfc4180
format.
- Handle mixed formats resiliently, such as mismatched and newlines within quotes.
Non-Goals:
- Any interpretation of the contents of the CSV structure itself - everything is an owned
String
serde
support - if you need it, go use the csv
crate.
Examples:
use irox_csv::error::CSVError;
fn iter_example() -> Result<(), CSVError> {
let mut input = irox_csv::CSVReader::new(std::io::stdin());
loop {
let line : Option<Vec<String>> = input.read_line()?;
match line {
Some(fields) => {
println!("{:?}", fields); }
None => {
break;
}
}
}
Ok(())
}
use irox_csv::error::CSVError;
fn map_example() -> Result<(), CSVError> {
let mut maps = irox_csv::CSVMapReader::new(std::io::stdin());
loop {
let maybe_row : Option<Row> = maps.next_row()?;
match maybe_row {
Some(row) => {
let map = row.into_map_lossy();
println!("{:?}", map); }
None => {
break;
}
}
}
Ok(())
}
- Writing a CSV File using Maps:
fn map_writer_example() -> Result<(), CSVError> {
let mut buf: Vec<u8> = Vec::new();
let mut writer = CSVWriterBuilder::new()
.with_columns(&["first", "second", "third"])
.build(&mut buf);
let mut map = BTreeMap::new();
map.insert("first".to_string(), "firstColFirstRowVal".to_string());
map.insert("second".to_string(), "secondColFirstRowVal".to_string());
map.insert("third".to_string(), "thirdColFirstRowVal".to_string());
writer.write_fields(&map)?;
map.clear();
map.insert("first".to_string(), "firstColSecondRowVal".to_string());
map.insert("second".to_string(), "secondColSecondRowVal".to_string());
map.insert("third".to_string(), "thirdColSecondRowVal".to_string());
writer.write_fields(&map)?;
Ok(())
}
will result in a buffer:
first,second,third
firstColFirstRowVal,secondColFirstRowVal,thirdColFirstRowVal
firstColSecondRowVal,secondColSecondRowVal,thirdColSecondRowVal