Project

watcard

0.0
No commit activity in last 3 years
No release in over 3 years
Command line interface for University of Waterloo WatCard. Includes commands to see purchase history and output ledger.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.6
>= 0

Runtime

 Project Readme

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