rs-csv-toolkit

High-level CSV reading, writing, and manipulation

Installation

[dependencies]
philiprehberger-csv-toolkit = "0.1.9"

Usage

use philiprehberger_csv_toolkit::CsvReader;

let data = "name,age,city\nAlice,30,NYC\nBob,25,LA";
let reader = CsvReader::from_str(data);

assert_eq!(reader.headers(), Some(["name", "age", "city"].map(String::from).as_slice()));
assert_eq!(reader.get(0, "name"), Some("Alice"));
assert_eq!(reader.column("age"), Some(vec!["30", "25"]));

Reading from file

use philiprehberger_csv_toolkit::CsvReader;

let reader = CsvReader::from_path("data.csv").unwrap();
for row in reader.rows() {
    println!("{:?}", row);
}

Writing CSV

use philiprehberger_csv_toolkit::CsvWriter;

let output = CsvWriter::new()
    .headers(&["name", "score"])
    .row(&["Alice", "95"])
    .row(&["Bob", "87"])
    .to_string();

assert_eq!(output, "name,score\nAlice,95\nBob,87\n");

Custom delimiter

use philiprehberger_csv_toolkit::CsvReader;

let data = "name;age\nAlice;30";
let reader = CsvReader::from_str(data).delimiter(b';');
assert_eq!(reader.get(0, "name"), Some("Alice"));

Auto-detection

use philiprehberger_csv_toolkit::CsvReader;

// Delimiter is detected automatically when not explicitly set
let data = "name\tage\nAlice\t30";
let reader = CsvReader::from_str(data);
assert_eq!(reader.get(0, "age"), Some("30"));

API

`CsvReader`

Method	Description
`from_str(data)`	Parse CSV from a string
`from_path(path)`	Read CSV from a file
`delimiter(d)`	Set field delimiter (default: auto-detect)
`has_headers(b)`	Whether first row is headers (default: true)
`headers()`	Get the header row
`rows()`	Get all data rows
`column(name)`	Get all values in a column by header name
`get(row, col)`	Get a single cell by row index and column name

`CsvWriter`

Method	Description
`new()`	Create a new writer
`delimiter(d)`	Set field delimiter (default: `,`)
`headers(h)`	Set header row
`row(values)`	Add a data row
`to_string()`	Render as CSV string
`to_file(path)`	Write CSV to a file