api

func ParseCSV ¶

func ParseCSV[T any](r io.Reader, data *[]T, location *time.Location) error

ParseCSV parses CSV data into a slice of structs using reflection.

Supported field types:

• string: Direct mapping from CSV column value
• int: Parsed using strconv.ParseInt with base 10
• float64: Parsed using strconv.ParseFloat
• time.Time: Parsed using time.ParseInLocation (see time-layout tag)

Struct field tags:

• `column-name:"header"`: Maps field to CSV column header (required)
• `time-layout:"layout"`: Custom time format for time.Time fields (optional, defaults to "2006-01-02")

Example struct:

type StockPrice struct {
    Date   time.Time `column-name:"timestamp"`
    Open   float64   `column-name:"open"`
    High   float64   `column-name:"high"`
    Volume int       `column-name:"volume"`
}

Unmapped columns are ignored. Fields without matching columns keep their zero value. Time fields with "null" values remain as zero time.Time.