A ruby command line tool for accessing watcard history.
Ruby
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
bin
lib
.gitignore
Gemfile
LICENSE.txt
README.md
Rakefile
watcard.gemspec

README.md

Watcard

A command line tool for accessing your watcard history and balance.

Installation

Install the gem with:

$ gem install watcard

Create the config file ~/.watcard.yml:

---
# Student id and watcard pin
id: 12345678
pin: 1234
# Daily food budget to use for reference (in dollars)
budget: 19
# Ledger output file
ledger: ~/Box/Life/watcard.ldg
# Accounts to use in Ledger output for different watcard balances
accounts:
  # Meal Plan are account 1
  1: ["Expenses:Food:Meals","Assets:WatCard:Meal Plan"]
  # Flex Dollars are account 4
  4: ["Expenses:Misc University","Assets:WatCard:Flex"]

Note: you can find the web UI for setting your pin and online access here.

Usage

History

Fetches history for a day and compares it with the budget (if there is one).

$ watcard hist
# Fetching history for 2014-09-05 19:53:54 -0400
Breakfast: $3.14 @ V1 Cafeteria
Dinner: $5.78 @ V1 Cafeteria
= $8.92 out of $19 surplus: 10.08
$ watcard hist 1 # One day ago
# Fetching history for 2014-09-04 19:53:01 -0400
Breakfast: $6.24 @ V1 Cafeteria
Lunch: $7.70 @ Liquid Assets
Dinner: $6.28 @ V1 Cafeteria
= $20.22 out of $19 surplus: -1.22

Ledger

Outputs double entry transactions in ledger format and optionally appends them to a file.

$ watcard ledger 1
# Fetching history for 2014-09-04 20:06:31 -0400
# Transactions:

2014/09/04 Breakfast at V1 Cafeteria
  Expenses:Food:Meals  $6.24
  Assets:WatCard:Meal Plan

2014/09/04 Lunch at Liquid Assets
  Expenses:Food:Meals  $7.70
  Assets:WatCard:Meal Plan

2014/09/04 Dinner at V1 Cafeteria
  Expenses:Food:Meals  $6.28
  Assets:WatCard:Meal Plan
# Add to file [yN]: n

You can use this with ledger's budgeting and accounting features to do lots of cool things like determine your current watcard balance and see budgeting stuff.

$ ledger -f watcard.ldg --period 'this week' --budget register expenses
14-Sep-01 Budget transaction    Expenses:Food:Meals         $-19.00      $-19.00
14-Sep-01 Lunch at V1 Cafeteria Expenses:Food:Meals           $7.74      $-11.26
14-Sep-02 Budget transaction    Expenses:Food:Meals         $-19.00      $-30.26
14-Sep-02 Breakfast at V1 Caf.. Expenses:Food:Meals           $1.34      $-28.92
14-Sep-03 Budget transaction    Expenses:Food:Meals         $-19.00      $-47.92
14-Sep-03 Breakfast at V1 Caf.. Expenses:Food:Meals           $5.40      $-42.52
14-Sep-04 Budget transaction    Expenses:Food:Meals         $-19.00      $-61.52
14-Sep-04 Breakfast at V1 Caf.. Expenses:Food:Meals           $6.24      $-55.28
14-Sep-04 Lunch at Liquid Ass.. Expenses:Food:Meals           $7.70      $-47.58
14-Sep-04 Dinner at V1 Cafete.. Expenses:Food:Meals           $6.28      $-41.30
14-Sep-05 Budget transaction    Expenses:Food:Meals         $-19.00      $-60.30
14-Sep-05 Breakfast at V1 Caf.. Expenses:Food:Meals           $3.14      $-57.16
14-Sep-05 Dinner at V1 Cafete.. Expenses:Food:Meals           $5.78      $-51.38
$ ledger -f watcard.ldg balance
            $2197.88  Assets:WatCard
             $191.50    Flex
            $2006.38    Meal Plan
           $-2250.00  Equity:RESP
              $52.12  Expenses
              $43.62    Food:Meals
               $8.50    Misc University
--------------------
                   0