Metadata-Version: 2.1
Name: csvprint
Version: 0.4.1
Summary: Print csv files in columnated format, either plain or as a Markdown or LaTeX table
Home-page: https://github.com/vegarsti/csvprint
Author: Vegard Stikbakke
Author-email: vegard.stikbakke@gmail.com
License: MIT
Description: # `csvprint`
        
        [![Build Status](https://travis-ci.org/vegarsti/csvprint.svg?branch=master)](https://travis-ci.org/travis-ci/travis-web)
        
        A command-line utility for pretty printing csv files and converting to other formats.
        
        ## Installation
        
        If Python 3 with the package manager pip is installed, doing `pip3 install csvprint` in your terminal should do the trick.
        
        ## Usage
        
        `csvprint [filename]` prints a formatted table if `filename` is a comma separated file.
        
        ```
        » cat imdb.csv
        Title,Release Year,Estimated Budget
        Shawshank Redemption,1994,$25 000 000
        The Godfather,1972,$6 000 000
        The Godfather: Part II,1974,$13 000 000
        The Dark Knight,2008,$185 000 000
        12 Angry Men,1957,$350 000
        
        » csvprint imdb.csv
        Title                  Release Year Estimated Budget
        Shawshank Redemption   1994         $25 000 000
        The Godfather          1972         $6 000 000
        The Godfather: Part II 1974         $13 000 000
        The Dark Knight        2008         $185 000 000
        12 Angry Men           1957         $350 000
        ```
        You can also pipe into `csvprint`:
        
        ```
        » cat imdb.csv | csvprint
        Title                  Release Year Estimated Budget
        Shawshank Redemption   1994         $25 000 000
        The Godfather          1972         $6 000 000
        The Godfather: Part II 1974         $13 000 000
        The Dark Knight        2008         $185 000 000
        12 Angry Men           1957         $350 000
        ```
        
        ## Options
        
        Command       | Result
        :-------------|:-------------------------------------------------------------
        `--markdown`  | print as markdown
        `--latex`     | print as latex table
        `--header`    | add header decoration around the first line
        `-p [n]`      | add a padding of `n` spaces for each column, on both sides
        `-s 'char'`   | file is delimited by `char` (instead of comma), `tab` for tab
        `-d [string]` | specify the string to separate columns
        `-a`          | specify alignment (left or right) - see examples below
        `-h`          | print help message
        
        ## Alignment example
        
        There are three options for specifying alignment. One can use `l` or `r` for aligning all cells to the left or right, respectively. One can also specify a distinct alignment option for each column. Then the number of options will need to match the number of columns.
        
        ```
        » csvprint imdb.csv -a l r r
        Title                  Release Year Estimated Budget
        Shawshank Redemption           1994      $25 000 000
        The Godfather                  1972       $6 000 000
        The Godfather: Part II         1974      $13 000 000
        The Dark Knight                2008     $185 000 000
        12 Angry Men                   1957         $350 000
        ```
        
        ## Markdown example
        
        Markdown output also supports left and right alignment.
        
        ```
        » csvprint examples/imdb.csv --markdown -a l r r
        Title                  | Release Year | Estimated Budget
        :----------------------|-------------:|----------------:
        Shawshank Redemption   |         1994 |      $25 000 000
        The Godfather          |         1972 |       $6 000 000
        The Godfather: Part II |         1974 |      $13 000 000
        The Dark Knight        |         2008 |     $185 000 000
        12 Angry Men           |         1957 |         $350 000
        ```
        
        When rendered as HTML, this looks like
        
        Title                  | Release Year | Estimated Budget
        :----------------------|-------------:|----------------:
        Shawshank Redemption   |         1994 |      $25 000 000
        The Godfather          |         1972 |       $6 000 000
        The Godfather: Part II |         1974 |      $13 000 000
        The Dark Knight        |         2008 |     $185 000 000
        12 Angry Men           |         1957 |         $350 000
        
        ## Testing
        
        Run `pytest` while in the root directory of this repository.
        
Keywords: csv
Platform: UNKNOWN
Description-Content-Type: text/markdown
