https://github.com/kren1/tosheets

Send your stdin to google sheets
https://github.com/kren1/tosheets

command-line google-sheets google-spreadsheet pipe python stdin

Last synced: 4 months ago
JSON representation

Send your stdin to google sheets

• Host: GitHub
• URL: https://github.com/kren1/tosheets
• Owner: kren1
• License: mit
• Created: 2017-11-15T14:02:04.000Z (over 6 years ago)
• Default Branch: master
• Last Pushed: 2020-07-14T18:50:47.000Z (almost 4 years ago)
• Last Synced: 2024-02-15T21:21:38.516Z (4 months ago)
• Topics: command-line, google-sheets, google-spreadsheet, pipe, python, stdin
• Language: Python
• Size: 24.4 KB
• Stars: 545
• Watchers: 18
• Forks: 28
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• my-awesome-stars - kren1/tosheets - Send your stdin to google sheets (Python)
• awesome-stars - kren1/tosheets - Send your stdin to google sheets (Python)
• awesome-stars - kren1/tosheets - Send your stdin to google sheets (Python)
• awesome-stars - kren1/tosheets - Send your stdin to google sheets (Python)
• awesome - tosheets - Send your stdin to google sheets (Python)

README

        
A simple command line utility that sends your stdin to sheets.

Available on pip by `pip install tosheets` (python3+ only)

***NOTE:***  On first use, tosheets will open a browser window to authorize OAuth2 token.

## Using `tosheets`

Pipe a local file to a new spreadsheet.

```

cat data.csv | tosheets -c A1 -d , --new-sheet="tosheetsSheet"

```

Pipe a local file to an existing spreadsheet:

(Given a URL like `https://docs.google.com/spreadsheets/d/sample-spread-sheet-id-23sdf32543fs/edit#gid=0`)

```

cat data.csv | tosheets -c B4 -d , --spreadsheet=sample-spread-sheet-id-23sdf32543fs

```

Send sequence from 1 to 10 to a column starting at B4:

```

seq 1 10 | tosheets -c B4 --spreadsheet=sample-spread-sheet-id-23sdf32543fs

```

Send a matrix:

```

1 2

3 4

```

To the same location:

```

echo -e '1 2\n3 4' | tosheets -c B4 --spreadsheet=sample-spread-sheet-id-23sdf32543fs

```

To sheets has a variety of other options listed:

```

tosheets, send stdin to your google sheets

Usage:

  tosheets -c  [-u] [-k] [-s ] [--spreadsheet=] [--new-sheet=] [-d ] [-q ]

  tosheets (-h | --help)

  tosheets --version

Options:

  -h --help                     Prints help.

  --version                     Show version.

  -i CSV                        Read this CSV instead of stdin

  -u                            Update CELL(s) instead of appending.

  -k                            Keep fields as they are (do not try to convert int or float).

  -c CELL                       Start appending to CELL.

  -s SHEET                      Use sheet name SHEET, otherwise tries to use

                                TOSHEETS_SHEET (default: first visible sheet).

  -d DELIMITER                  Use DELIMITER to split each line (default: whitespace).

  -q QUOTE_CHAR                 A one-character string used to quote fields containing special characters,

                                such as the delimiter or quotechar, or which contain new-line characters.

                                (default: '"').

  --spreadsheet=   Send to the spreadsheet identified by spreadshetId

                                (ie. docs.google.com/spreadsheets/d//...),

                                if empty uses TOSHEETS_SPREADSHEET enviroment variable.

  --new-sheet=            Create a new spreadsheet with the chosen name. Prints the

                                spreadsheetId so it can be piped/stored.

  --open                        Open a browser with the newly created sheet

```

### Distribution

```

python setup.py sdist bdist_wheel

twine upload dist/*

```