Skip to main content

Excel file CLI Reader

Project description

https://badge.fury.io/py/x_x.png https://pypip.in/d/x_x/badge.png

x_x is a command line reader that displays either Excel files or CSVs in your terminal. The purpose of this is to not break the workflow of people who live on the command line and need to access a spreadsheet generated using Microsoft Excel.

Install

The easy way:

$ pip install x_x

Or the hard way:

$ git clone https://github.com/krockode/x_x.git && cd x_x && python setup.py install

Usage

Installing this package gives you an x_x CLI executable.

$ x_x --help
Usage: x_x [OPTIONS] FILENAME

  Display Excel or CSV files directly on your terminal. The file type is
  guessed from file extensions, but can be overridden with the --file-type
  option.

Options:
  -h, --heading INTEGER        Row number containing the headings.
  -f, --file-type [csv|excel]  Force parsing of the file to the chosen format.
  -d, --delimiter TEXT         Delimiter (only applicable to CSV files)
                               [default: ',']
  -q, --quotechar TEXT         Quote character (only applicable to CSV files)
                               [default: '"']
  -e, --encoding TEXT          Encoding [default: UTF-8]
  --version                    Show the version and exit.
  --help                       Show this message and exit.

So, for example:

$ x_x dead_guys.xlsx
+---------------+--------------+
| A             | B            |
+---------------+--------------+
| Person        | Age at Death |
| Harrold Holt  | 59.0         |
| Harry Houdini | 52.0         |
| Howard Hughes | 70.0         |

Or to specify a specific row as the header which will be visible on each page:

$ x_x -h 0 dead_guys.xlsx
+---------------+--------------+
| Person        | Age at Death |
+---------------+--------------+
| Harrold Holt  | 59.0         |
| Harry Houdini | 52.0         |
| Howard Hughes | 70.0         |

Weird CSVs? No problem!

$ cat dead_guys.csv
person;age_at_death
Harrold Holt;59
Harry Houdini;52
Howard Hughes;70
|Not some guy, but just a string with ; in it|;0
$ x_x -h 0 --delimiter=';' --quotechar='|' dead_guys.csv
+----------------------------------------------+--------------+
| person                                       | age_at_death |
+----------------------------------------------+--------------+
| Harrold Holt                                 | 59           |
| Harry Houdini                                | 52           |
| Howard Hughes                                | 70           |
| Not some guy, but just a string with ; in it | 0            |

Does your CSV file not end in “csv”? Again, no problem:

$ mv dead_guys.csv dead_guys.some_other_extension
$ x_x -h 0 --file-type=csv --delimiter=';' --quotechar='|' dead_guys.some_other_extension
+----------------------------------------------+--------------+
| person                                       | age_at_death |
+----------------------------------------------+--------------+
| Harrold Holt                                 | 59           |
| Harry Houdini                                | 52           |
| Howard Hughes                                | 70           |
| Not some guy, but just a string with ; in it | 0            |

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

x_x-0.9.tar.gz (9.6 kB view details)

Uploaded Source

File details

Details for the file x_x-0.9.tar.gz.

File metadata

  • Download URL: x_x-0.9.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No

File hashes

Hashes for x_x-0.9.tar.gz
Algorithm Hash digest
SHA256 7c2eef57ca7ff36d674be6dd263e5e9b08359d9cf6104f9d77f0dc61f4c6361b
MD5 fa0c660f4ce00a4501ee1845e339fb7f
BLAKE2b-256 baff00a23ab37b51090604637f17c53ac72aa308cf8f391138d8297a5149f9f4

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page