Attachment 967892 Details for Bug 1171553 – csvdiff man page

csvdiff man page

csvdiff.1 (text/plain), 1.72 KB, created by Mario Blättermann on 2014-12-12 21:42:22 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Mario Blättermann

Created: 2014-12-12 21:42:22 UTC

Size: 1.72 KB

patch

obsolete

>.TH CSVDIFF "1" "December 2014" "User Commands"
>
>.SH NAME
>csvdiff \- compare CSV files
>
>.SH SYNOPSIS
>.B csvdiff
>\fIOPTIONS\fR lhs.csv rhs.csv
>
>.SH DESCRIPTION
>.PP
>.B csvdiff
>generates a diff between two CSV files on the command-line.
>
>.SH OPTIONS
>.TP
>\fB\-h\fR, \fB\-\-help\fR
>show this help message and exit.
>.TP
>\fB\-k\fR \fIKEY, \fB\-\-key\fR=\fIKEY\fR
>prints a comma separated list of key columns.
>.TP
>\fB\-s\fR, \fB\-\-summary\fR
>summarize the changes.
>.TP
>\fB\-\-yaml\fR
>print changes in more readable YAML format.
>.TP
>\fB\-o\fR \fIOUTPUT\fR, \fB\-\-output\fR=\fIOUTPUT\fR
>saves the diff to the given filename.
>
>.SH EXAMPLES
>
>For example, suppose we have \fIa.csv\fR:
>.PP
>.nf
>.RS
>id,name,amount
>1,bob,20
>2,eva,63
>3,sarah,7
>4,jeff,19
>6,fred,10
>.RE
>.fi
>.PP
>and a matching file after some changes, b.csv:
>.PP
>.nf
>.RS
>id,name,amount
>1,bob,23
>3,sarah,7
>4,jeff,19
>5,mira,81
>6,fred,13
>.RE
>.fi
>.PP
>Now we can ask for a summary of differences:
>.PP
>.nf
>.RS
>$ csvdiff --summary -k id a.csv b.csv
>1 rows removed (20.0%)
>1 rows added (20.0%)
>2 rows changed (40.0%)
>.RE
>.fi
>.PP
>Or look at the full diff, using YAML rather than JSON (the default) to make it more readable:
>.PP
>.nf
>.RS
>$ csvdiff --yaml -k id a.csv b.csv
>removed:
>- amount: '63'
>  id: '2'
>  name: eva
>added:
>- amount: '81'
>  id: '5'
>  name: mira
>changed:
>- fields:
>    amount:
>      from: '10'
>      to: '13'
>  key:
>  - '6'
>- fields:
>    amount:
>      from: '20'
>      to: '23'
>  key:
>  - '1'
>.RE
>.fi
>.PP
>It gives us the full listing of added and removed rows, as well as a listing of what fields changed for that shared a key.
>
>For more usage options, run
>.B csvdiff \fB\-\-help\fR.
>
>.SH LICENSE
>BSD license
>
>.SH AVAILABILITY
>The
>.B csvdiff
>sources are available from https://github.com/larsyencken/csvdiff.

Actions: View

Attachments on bug 1171553: 967892