gocsv

README

gocsv

go csv helper, read csv and unmarshal for struct, map, list.

Features

• Read for struct/map/parser
• Support generator struct
• Support encoding

Usage

Install:

go get github.com/foolin/gocsv

Example:

package main
import (
	"github.com/foolin/gocsv"
	"fmt"
)

//Goods goods struct for csv
type Goods struct {
	ID   int `csv:"id"`	//id => ID
	Name string	// name => Name (default, first letter lowercase)
	Price float64 `csv:"cost"`	// rename price => cost
}

func main() {

	var err error

	//======================= read map[string]interface{} ===================//
	fmt.Println("\n------------- read  -------------")
	//datautf8.csv utf8 file
	data, err := gocsv.Read("datautf8.csv", true)
	if err != nil {
		panic(fmt.Sprintf("read error: %v", err))
		return
	}
	fmt.Printf("%#v\n", data)


	//======================= read list ===================//
	fmt.Println("\n------------- read list  -------------")
	var list []Goods
	//data.csv ANSI(excel default)
	err = gocsv.ReadList("data.csv", false, &list)
	if err != nil {
		fmt.Printf("read error: %v", err)
		return
	}
	fmt.Printf("%#v\n", list)


	//======================= read map ===================//
	fmt.Println("\n------------- read map  -------------")
	var vmap map[int]Goods
	//data.csv ANSI(excel default)
	err = gocsv.ReadMap("data.csv", false, "id", &vmap)
	if err != nil {
		fmt.Printf("read error: %v", err)
		return
	}
	fmt.Printf("%#v\n", vmap)

	//======================= read parser ===================//
	fmt.Println("\n------------- read parser  -------------")
	line := 1
	err = gocsv.ReadRaw("data.csv", false, func(fields []gocsv.Field) error {
		fmt.Printf("-line %v\n", line)
		for _, f := range fields {
			fmt.Printf("%#v\n", f)
		}
		line = line + 1
		return nil
	})
	if err != nil {
		fmt.Printf("read error: %v", err)
		return
	}

}

Csv:

Goods Id,Goods Name,Sell Price
id,name,cost
int,string,float
1,Apple iPhone 6s,5999.99
2,Other Mobile Phone,699.99

Output:

------------- read  -------------
[]map[string]interface {}{map[string]interface {}{"id":1, "name":"Apple iPhone 6s", "cost":5999.99}, map[string]interface {}{"id":2, "name":"Other Mobile Phone", "cost":699.99}}

------------- read list  -------------
[]main.Goods{main.Goods{ID:1, Name:"Apple iPhone 6s", Price:5999.99}, main.Goods{ID:2, Name:"Other Mobile Phone", Price:699.99}}

------------- read map  -------------
map[int]main.Goods{1:main.Goods{ID:1, Name:"Apple iPhone 6s", Price:5999.99}, 2:main.Goods{ID:2, Name:"Other Mobile Phone", Price:699.99}}

------------- read parser  -------------
-line 1
gocsv.Field{Name:"id", Value:"1", Kind:"int"}
gocsv.Field{Name:"name", Value:"Apple iPhone 6s", Kind:"string"}
gocsv.Field{Name:"cost", Value:"5999.99", Kind:"float"}
-line 2
gocsv.Field{Name:"id", Value:"2", Kind:"int"}
gocsv.Field{Name:"name", Value:"Other Mobile Phone", Kind:"string"}
gocsv.Field{Name:"cost", Value:"699.99", Kind:"float"}

Documentation

Index

• func Read(file string, isGbk bool) (list []map[string]interface{}, err error)
• func ReadLines(file string, isGbk bool) (lines [][]string, err error)
• func ReadList(file string, isGbk bool, out interface{}) (err error)
• func ReadMap(file string, isGbk bool, keyField string, out interface{}) (err error)
• func ReadRaw(file string, isGbk bool, handle func([]Field) error) (err error)
• type Field

Functions

func Read

func Read(file string, isGbk bool) (list []map[string]interface{}, err error)

Read read for map array

func ReadLines

func ReadLines(file string, isGbk bool) (lines [][]string, err error)

Read read csv for handle

func ReadList

func ReadList(file string, isGbk bool, out interface{}) (err error)

ReadList read for []struct

func ReadMap

func ReadMap(file string, isGbk bool, keyField string, out interface{}) (err error)

ReadList read for map[interface{}]struct

func ReadRaw

func ReadRaw(file string, isGbk bool, handle func([]Field) error) (err error)

Read read csv for handle

Types

type Field

type Field struct {
	Name  string
	Value string
	Kind  string
}

Field field info