Built-in data.csv plugin

[traut]

Background

There should be a way to import existing CSV files.

Design

data.csv plugin should be a part of the fabric binary.

Specification

• Configuration options:
  • delimiter -- a one-character string used to separate fields. It defaults to ,
• API interface:
  • required path string attribute that accepts a path to a file on a local filesystem.

Behavior

Using the provided path value, the plugin reads the CSV file and returns a JSON object with the data.

The plugin expects the CSV file to have a header, so the first row is always treated as a header. The CSV file is parsed using the configured delimiter.

The plugin produces a list of dictionaries -- one dictionary per row, with fields corresponding to the column names.

For example, for the CSV file

column_a,column-b,column C
1,2,3
4,5,foo

the plugin will return

[
  {
    "column_a": 1,
    "column-b": 2,
    "column C": 3
  },
  {
    "column_a": 4,
    "column-b": 5,
    "column C": "foo"
  }
]

Deliverables

• new built-in data.csv plugin
• the unit tests for the plugin

[traut]

implemented in #45