TODO: Could do with some tests, to guard for regressions.

2020-01-27 11:30:08 +00:00

3.2 KiB

Raw Blame History

csv2edn

Simple command line utility to convert CSV files to EDN. Assumes the first row of a CSV file contains column headers.

Installation

Leiningen/Boot

[csv2edn "0.1.0"]

Clojure CLI/deps.edn

csv2edn {:mvn/version "0.1.0"}

Gradle

compile 'csv2edn:csv2edn:0.1.0'

Maven

csv2edn csv2edn 0.1.0

Usage: as a standalone commandline tool

To run from the command line:

$ java -jar csv2edn-0.1.0-standalone.jar [options]

Options

Where options are:

-h, --help                    Print this message and exit.
-i, --input INPUT             The path name of the CSV file to be read.
  If no input file is specified, input will be read from standard input.
-o, --output OUTPUT           The path name of the EDN file to be written.
  If no output file is specified, output will be written to standard output.
-s, --separator SEPARATOR     The character to treat as a separator in the
  CSV file. If not specified, comma will be used by default.

Examples

The simplest possible use is to simply use this in a pipeline:

$ cat path/to/file.csv |\
    java -jar csv2edn-0.1.0-standalone.jar > path/to/file.edn

Exactly the same behaviour can be achieved by specifying input and output paths:

$ java -jar csv2edn-0.1.0-standalone.jar \
    -i path/to/file.csv -o path/to/file.edn

$ java -jar csv2edn-0.1.0-standalone.jar \
    --input path/to/file.csv --output path/to/file.edn

Usage: as a library

To use this package as a library in your own code:

(:require [csv2edn.csv2edn :refer [csv->edn *options*]])

And then pass either filenames or a reader and writer respectively to the function cvs->edn, thus:

(cvs->edn *in* *out*)
  ;; reads standard input and writes to standard output

(cvs->edn "path/to/data.csv" "path/to/data.edn")

In either case, if successful, the function returns a possibly-lazy sequence of maps representing the second and subsequent lines in the file (the first line being assumed to contain column headers).

If you do not wish to write an EDN file, simply do not pass the second argument.

If you want to use a non-standard separator charactor, e.g. bar rather than comma, you should rebind *options*:

(binding [*options* (merge *options* {:separator \|})]
  (cvs->edn "path/to/data.csv" "path/to/data.edn"))

Or else pass the separator character you want to use as a third argument:

(cvs->edn "path/to/data.csv" "path/to/data.edn" \|)

Bugs

Not strictly a bug, but this does not yet work in ClojureScript, because it depends on clojure.data.csv, which also doesn't. It would be good to fix this.

License

This program and the accompanying materials are made available under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at https://www.gnu.org/software/classpath/license.html.

3.2 KiB Raw Blame History