watcard 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 9661609eb1149caaeed55ce608bbac94c11c73fb
+  data.tar.gz: 1d5f0f4a35af2a4ed0a5ff82d41094d2f9a4d4a8
+SHA512:
+  metadata.gz: 832d8d7441444973fbe74fdf784b6810ed6aafd44db08e50b7dc10549f65caa678c03de4b34ecd36a1a291ca08b4f0361874c9e4f3dec4a42793c7b36ff7a06a
+  data.tar.gz: 71c216a8a29ddfae5686377b55f30860f0c4c28ff537ec38a7fcf918315e6367e794b7ed9e5296844fa3f32cc0934319f5522f33e06f81f368c3fa7513015249

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in watcard.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014 Tristan Hume
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,94 @@
+# 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`:
+
+```yaml
+---
+# 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"]
+```
+
+## 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](http://ledger-cli.org/) 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

data/Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

data/bin/watcard

@@ -0,0 +1,32 @@
+#!/usr/bin/env ruby
+
+require "watcard"
+require "yaml"
+
+FILE = File.expand_path("~/.watcard.yml")
+
+begin
+  yaml_dat = IO.read(FILE)
+  conf = YAML.load(yaml_dat)
+rescue Exception => e
+  STDERR.puts "Can't load config file"
+  p e
+  STDERR.puts e.message
+end
+
+command = ARGV.shift
+case command
+when "hist"
+  hist = Watcard::History.new(conf)
+  days_ago = (ARGV.shift || 0).to_i
+  hist.output_history(days_ago)
+when "ledger"
+  hist = Watcard::History.new(conf)
+  days_ago = (ARGV.shift || 0).to_i
+  hist.output_ledger(days_ago)
+else
+  puts "Watcard CLI v#{Watcard::VERSION}"
+  puts "By Tristan Hume"
+  puts ""
+  puts "Unknown command"
+end

data/lib/watcard.rb

@@ -0,0 +1,5 @@
+require "watcard/version"
+require "watcard/history"
+
+module Watcard
+end

data/lib/watcard/history.rb

@@ -0,0 +1,138 @@
+require "nokogiri"
+require "net/http"
+require "uri"
+require "time"
+require "facets"
+
+module Watcard
+  class History
+    def initialize(config)
+      @conf = config
+    end
+
+    def log(msg)
+      STDERR.puts msg
+    end
+
+    def history_page(date)
+      uri = URI.parse("https://account.watcard.uwaterloo.ca/watgopher661.asp")
+      date_txt = date.strftime("%m/%d/%Y")
+      args = {
+        "acnt_1"=>@conf['id'],
+        "acnt_2"=>@conf['pin'],
+        "DBDATE"=>date_txt,
+        "DEDATE"=>date_txt,
+        "PASS"=>"PASS",
+        "STATUS"=>"HIST",
+        "watgopher_title"=>"WatCard History Report",
+        "watgopher_regex"=>'<hr>([\s\S]*wrong[\s\S]*)<p></p>|(<form[\s\S]*?(</center>|</form>))|(<pre><p>[\s\S]*</pre>)',
+        "watgopher_style"=>'onecard_narrow',
+      }
+      log "# Fetching history for #{date}"
+      Net::HTTP.post_form(uri, args)
+    end
+
+    def parse_loc(loc)
+      return "V1 Cafeteria" if loc =~ /WAT-FS-V1/
+      return "Liquid Assets" if loc =~ /WAT-FS-LA/
+      "Campus"
+    end
+
+    def history(date)
+      page_body = history_page(date).body
+      doc = Nokogiri::HTML(page_body)
+      table = doc.css('#oneweb_financial_history_table')
+      table.xpath('.//tr').map do |row|
+        cols = row.xpath('./td').map(&:inner_text)
+        next if cols.length < 4
+        mult = (cols[3] == "1") ? 2 : 1
+        {
+          time: Time.parse(cols[1], date),
+          amount: -(cols[2].strip.to_f)*mult,
+          loc: parse_loc(cols.last),
+          balance: cols[3].to_i
+        }
+      end.compact.reverse
+    end
+
+    def bundle_transactions(hist)
+      return hist if hist.empty?
+      hist.each do |a|
+        h = a[:time].hour
+        type = if h < 12
+          "Breakfast"
+        elsif h < 17
+          "Lunch"
+        else
+          "Dinner"
+        end
+        a[:meal] = type
+      end
+      meals = [hist.shift]
+      hist.each do |a|
+        # if last meal is same type treat them as one
+        if a[:meal] == meals.last[:meal]
+          meals.last[:amount] += a[:amount]
+        else
+          meals << a
+        end
+      end
+      meals
+    end
+
+    def add_accounts(hist)
+      accounts = @conf['accounts']
+      hist.each do |a|
+        a[:account] = accounts[a[:balance]] || accounts[4]
+      end
+    end
+
+    def fetch_meals(days_ago)
+      hist = history(Time.now.less(days_ago, :days))
+      if hist.empty?
+        log "No Transactions"
+        exit
+      end
+      bundle_transactions(hist)
+    end
+
+    def ledger_transaction(m)
+      date_str = m[:time].strftime("%Y/%m/%d")
+      transact = <<END
+
+#{date_str} #{m[:meal]} at #{m[:loc]}
+  #{m[:account][0]}  $#{sprintf('%.2f', m[:amount])}
+  #{m[:account][1]}
+END
+    end
+
+    def output_ledger(days_ago)
+      meals = fetch_meals(days_ago)
+      add_accounts(meals)
+      log "# Transactions:"
+      out = meals.map {|m| ledger_transaction(m)}.join('')
+      puts out
+      if STDIN.tty? && @conf['ledger']
+        print "# Add to file [yN]: "
+        ans = gets.chomp
+        exit if ans != "y"
+        file = File.expand_path(@conf['ledger'])
+        File.open(file, 'a') {|f| f.puts out}
+        puts "# Added to #{file}"
+      end
+    end
+
+    def output_history(days_ago)
+      meals = fetch_meals(days_ago)
+      total = 0
+      meals.each do |m|
+        total += m[:amount]
+        puts "#{m[:meal]}: $#{sprintf('%.2f', m[:amount])} @ #{m[:loc]}"
+      end
+      budget = @conf['budget']
+      print "= $#{total}"
+      print " out of $#{budget} surplus: #{sprintf('%.2f',budget-total)}" if budget
+      puts ''
+    end
+  end
+end

data/lib/watcard/version.rb

@@ -0,0 +1,3 @@
+module Watcard
+  VERSION = "0.0.2"
+end

data/watcard.gemspec

@@ -0,0 +1,26 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'watcard/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "watcard"
+  spec.version       = Watcard::VERSION
+  spec.authors       = ["Tristan Hume"]
+  spec.email         = ["tris.hume@gmail.com"]
+  spec.summary       = %q{Command line interface for University of Waterloo WatCard}
+  spec.description   = %q{Command line interface for University of Waterloo WatCard. Includes commands to see purchase history and output ledger.}
+  spec.homepage      = "https://github.com/trishume/watcard-cli"
+  spec.license       = "MIT"
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "nokogiri"
+  spec.add_dependency "facets"
+
+  spec.add_development_dependency "bundler", "~> 1.6"
+  spec.add_development_dependency "rake"
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: watcard
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Tristan Hume
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-09-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: facets
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Command line interface for University of Waterloo WatCard. Includes commands
+  to see purchase history and output ledger.
+email:
+- tris.hume@gmail.com
+executables:
+- watcard
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/watcard
+- lib/watcard.rb
+- lib/watcard/history.rb
+- lib/watcard/version.rb
+- watcard.gemspec
+homepage: https://github.com/trishume/watcard-cli
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Command line interface for University of Waterloo WatCard
+test_files: []