data

Documentation

Overview

Package data contains functions that parse and produce data structures in different formats.

Supported formats are: JSON, YAML, TOML, and CSV.

Index

• func CSV(args ...string) ([][]string, error)
• func CSVByColumn(args ...string) (cols map[string][]string, err error)
• func CSVByRow(args ...string) (rows []map[string]string, err error)
• func JSON(in string) (map[string]interface{}, error)
• func JSONArray(in string) ([]interface{}, error)
• func TOML(in string) (interface{}, error)
• func ToCSV(args ...interface{}) (string, error)
• func ToJSON2(in interface{}) (string, error)
• func ToJSONPretty(indent string, in interface{}) (string, error)
• func ToTOML(in interface{}) (string, error)
• func ToYAML(in interface{}) (string, error)
• func YAML(in string) (map[string]interface{}, error)
• func YAMLArray(in string) ([]interface{}, error)

Functions

func CSV

func CSV(args ...string) ([][]string, error)

CSV - Unmarshal CSV parameters:

delim - (optional) the (single-character!) field delimiter, defaults to ","
   in - the CSV-format string to parse

returns:

an array of rows, which are arrays of cells (strings)

func CSVByColumn

func CSVByColumn(args ...string) (cols map[string][]string, err error)

CSVByColumn - Unmarshal CSV in a Columnar form parameters:

delim - (optional) the (single-character!) field delimiter, defaults to ","
  hdr - (optional) comma-separated list of column names,
        set to "" to get auto-named columns (A-Z), omit
        to use the first line
   in - the CSV-format string to parse

returns:

a map of columns, indexed by the header name. values are arrays of strings

func CSVByRow

func CSVByRow(args ...string) (rows []map[string]string, err error)

CSVByRow - Unmarshal CSV in a row-oriented form parameters:

delim - (optional) the (single-character!) field delimiter, defaults to ","
  hdr - (optional) comma-separated list of column names,
        set to "" to get auto-named columns (A-Z), omit
        to use the first line
   in - the CSV-format string to parse

returns:

an array of rows, indexed by the header name

func JSON

func JSON(in string) (map[string]interface{}, error)

JSON - Unmarshal a JSON Object. Can be ejson-encrypted.

func JSONArray

func JSONArray(in string) ([]interface{}, error)

JSONArray - Unmarshal a JSON Array

func TOML

func TOML(in string) (interface{}, error)

TOML - Unmarshal a TOML Object

func ToCSV

func ToCSV(args ...interface{}) (string, error)

ToCSV -

func ToJSON2

func ToJSON2(in interface{}) (string, error)

ToJSON - Stringify a struct as JSON

func ToJSONPretty

func ToJSONPretty(indent string, in interface{}) (string, error)

ToJSONPretty - Stringify a struct as JSON (indented)

func ToTOML

func ToTOML(in interface{}) (string, error)

ToTOML - Stringify a struct as TOML

func ToYAML

func ToYAML(in interface{}) (string, error)

ToYAML - Stringify a struct as YAML

func YAML

func YAML(in string) (map[string]interface{}, error)

YAML - Unmarshal a YAML Object

func YAMLArray

func YAMLArray(in string) ([]interface{}, error)

YAMLArray - Unmarshal a YAML Array