syrup 0.0.1

data/.gitignore

@@ -0,0 +1,6 @@
+*.swp
+**/*.swp
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1 @@
+--color

data/CHANGELOG.rdoc

@@ -0,0 +1,3 @@
+0.0.1 (Date)
+
+* initial release

data/Gemfile

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

data/README.rdoc

@@ -0,0 +1,28 @@
+= Syrup
+
+Syrup is made from a yummy maple extract.
+
+== Installation
+
+The latest version of Syrup can be installed with Rubygems:
+
+  [sudo] gem install "syrup"
+
+In <b>Rails 3</b>, add this to your Gemfile and run the +bundle+ command.
+
+  gem "syrup"
+
+In <b>Rails 2</b>, add this to your environment.rb file.
+
+  config.gem "syrup"
+
+== Getting Started
+
+Spread it all over your pancakes and enjoy!
+
+== Usage
+
+  zions = Syrup::Extract.from_institution(:zions_bank)
+  zions.fetch_accounts.each do |act|
+    puts name + " " + name.current_balance
+  end

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+require 'rspec/core/rake_task'
+
+Bundler::GemHelper.install_tasks
+
+desc "Run RSpec"
+RSpec::Core::RakeTask.new do |t|
+  
+end
+
+task :default => :spec

data/lib/syrup/account.rb

@@ -0,0 +1,5 @@
+module Syrup
+  class Account
+    attr_accessor :name, :id, :account_number, :current_balance, :available_balance, :type
+  end
+end

data/lib/syrup/extract.rb

@@ -0,0 +1,14 @@
+module Syrup
+  class Extract
+    def self.from_institution(institution_sym)
+      class_name = institution_sym.to_s.gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+      Institutions.const_get(class_name).new
+    end
+    
+    def self.list_institutions
+      Institutions::AbstractInstitution.subclasses.map do |subclass|
+        subclass.institution_name
+      end
+    end
+  end
+end

data/lib/syrup/institutions/abstract_institution.rb

@@ -0,0 +1,26 @@
+module Syrup
+  module Institutions
+    class AbstractInstitution
+      
+      def self.inherited(subclass)
+        @subclasses ||= []
+        @subclasses << subclass
+      end
+      
+      def self.subclasses
+        @subclasses
+      end
+      
+      protected
+        
+        def agent
+          @agent || Mechanize.new
+        end
+          
+        def parse_currency(currency)
+          currency.scan(/[0-9.]/).join.to_f
+        end
+      
+    end
+  end
+end

data/lib/syrup/institutions/zions_bank.rb

@@ -0,0 +1,111 @@
+module Syrup
+  module Institutions
+    class ZionsBank < AbstractInstitution
+      def self.institution_name
+        "Zions Bank"
+      end
+      
+      attr_accessor :username, :password, :secret_qas
+      
+      def fetch_accounts
+        ensure_authenticated
+
+        # List accounts
+        page = agent.get('https://banking.zionsbank.com/ibuir/displayAccountBalance.htm')
+        json = ActiveSupport::JSON.decode(page.body)
+
+        accounts = []
+        json['accountBalance']['depositAccountList'].each do |account|
+          new_account = Account.new
+          new_account.name = account['name']
+          new_account.id = account['accountId']
+          new_account.account_number = account['number']
+          new_account.current_balance = parse_currency(account['currentAmt'])
+          new_account.available_balance = parse_currency(account['availableAmt'])
+          new_account.type = :deposit
+          
+          accounts << new_account
+        end
+        json['accountBalance']['creditAccountList'].each do |account|
+          new_account = Account.new
+          new_account.name = account['name']
+          new_account.id = account['accountId']
+          new_account.account_number = account['number']
+          new_account.current_balance = parse_currency(account['balanceDueAmt'])
+          new_account.type = :credit
+          
+          accounts << new_account
+        end
+
+        accounts
+      end
+      
+      def fetch_transactions
+        ensure_authenticated
+        
+        # https://banking.zionsbank.com/zfnb/userServlet/app/bank/user/register_view_main?actAcct=498282&sortBy=Default&sortOrder=Default
+
+        # The transactions table is messy. Cells we want either have data, curr, datagrey, or currgrey css class
+      end
+      
+      private
+      
+        def ensure_authenticated
+          
+          # Check to see if already authenticated
+          page = agent.get('https://banking.zionsbank.com/ibuir')
+          if page.body.include?("SessionTimeOutException") # || (page.links.size > 0 && page.links.first.href == "http://www.zionsbank.com")
+            
+            raise ArgumentError, "Username must be supplied before authenticating" unless self.username
+            raise ArgumentError, "Password must be supplied before authenticating" unless self.password
+            
+            @agent = Mechanize.new
+            
+            # Enter the username
+            page = agent.get('https://zionsbank.com')
+            form = page.form('logonForm')
+            form.publicCred1 = username
+            page = form.submit
+            
+            # If the supplied username is incorrect, raise an exception
+            raise "Invalid username" if page.title == "Error Page"
+
+            # Go on to the next page
+            page = page.links.first.click
+
+            # Find the secret question
+            question = page.search('div.form_field')[2].css('div').inner_text
+            
+            # If the answer to this question was not supplied, raise an exception
+            raise question unless secret_qas[question]
+            
+            # Enter the answer to the secret question
+            form = page.forms.first
+            form["challengeEntry.answerText"] = secret_qas[question]
+            form.radiobutton_with(:value => 'false').check
+            submit_button = form.button_with(:name => '_eventId_submit')
+            page = form.submit(submit_button)
+            
+            # If the supplied answer is incorrect, raise an exception
+            raise "Invalid answer" unless page.search('#errorComponent').empty?
+
+            # Enter the password
+            form = page.forms.first
+            form.privateCred1 = password
+            submit_button = form.button_with(:name => '_eventId_submit')
+            page = form.submit(submit_button)
+            
+            # If the supplied password is incorrect, raise an exception
+            raise "Invalid password" unless page.search('#errorComponent').empty?
+
+            # Clicking this link logs us into the banking.zionsbank.com domain
+            page = page.links.first.click
+            
+          end
+          
+          true
+        end
+      
+    end
+  end
+end

data/lib/syrup/transaction.rb

@@ -0,0 +1,10 @@
+module Syrup
+  class Transaction
+    attr_accessor :payee, :amount, :posted_at
+    def initialize(attr_hash)
+      attr_hash.each do |k, v|
+        instance_variable_set "@#{k}", v
+      end
+    end
+  end
+end

data/lib/syrup/version.rb

@@ -0,0 +1,3 @@
+module Syrup
+  VERSION = "0.0.1"
+end

data/lib/syrup.rb

@@ -0,0 +1,10 @@
+require 'date'
+require 'mechanize'
+require 'active_support/json'
+require 'syrup/extract'
+require 'syrup/account'
+require 'syrup/transaction'
+
+# require all institutions
+require 'syrup/institutions/abstract_institution'
+Dir[File.dirname(__FILE__) + '/syrup/institutions/*.rb'].each {|file| require file }

data/spec/spec_helper.rb

@@ -0,0 +1,25 @@
+#require 'rubygems'
+#require 'bundler/setup'
+
+Bundler.require(:default)
+
+#RSpec.configure do |config|
+#  config.mock_with :rr
+#  config.before(:each) do
+#    
+#  end
+#end
+
+
+# pass in username, password, secret questions
+
+# zions.fetch_accounts
+# should I store things?
+# List accounts
+#  * create an array of Account objects
+
+# account.transactions OR account.fetch_transactions
+# zions.
+# When getting transactions
+#  * create an array of Transaction objects
+#  * populate as many variables on Account as you can (eg. current_balance, etc.)

data/spec/syrup/extract_spec.rb

@@ -0,0 +1,12 @@
+require "spec_helper"
+
+describe Syrup::Extract do
+  it "lists all institutions" do
+    Syrup::Extract.list_institutions.size.should == 1
+    puts Syrup::Extract.list_institutions
+  end
+  
+  it "creates a Zions Bank institution" do
+    Syrup::Extract.from_institution(:zions_bank).class.should == Syrup::Institutions::ZionsBank
+  end
+end

data/spec/syrup/institutions/zions_bank_spec.rb

@@ -0,0 +1,5 @@
+require "spec_helper"
+
+describe Syrup::Institutions::ZionsBank do
+  it "lists all accounts"
+end

data/spec/syrup/transaction_spec.rb

@@ -0,0 +1,20 @@
+require "spec_helper"
+
+describe Syrup::Transaction do
+  before(:all) do
+    @transaction = Syrup::Transaction.new :amount => 10, :payee => "Newegg", :posted_at => DateTime.now
+  end
+  
+  it "has an amount" do
+    @transaction.amount.should_not be_nil
+  end
+  
+  it "has a payee" do
+    @transaction.payee.should_not be_nil
+  end
+  
+  it "has a posted-at date" do
+    @transaction.posted_at.should_not be_nil
+  end
+  
+end

data/syrup.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "syrup/version"
+
+Gem::Specification.new do |s|
+  s.name        = "syrup"
+  s.version     = Syrup::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Don Wilson"]
+  s.email       = ["dontangg@gmail.com"]
+  s.homepage    = "http://github.com/dontangg/syrup"
+  s.summary     = %q{Simple account balance/transactions extractor.}
+  s.description = %q{Simple account balance/transactions extractor by scraping bank websites.}
+  
+  s.add_dependency "mechanize"
+  s.add_dependency "activesupport"
+  
+  s.add_development_dependency "rspec"
+
+  s.rubyforge_project = s.name
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

metadata

@@ -0,0 +1,109 @@
+--- !ruby/object:Gem::Specification 
+name: syrup
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Don Wilson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-02-25 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: mechanize
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id003
+description: Simple account balance/transactions extractor by scraping bank websites.
+email: 
+- dontangg@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- CHANGELOG.rdoc
+- Gemfile
+- README.rdoc
+- Rakefile
+- lib/syrup.rb
+- lib/syrup/account.rb
+- lib/syrup/extract.rb
+- lib/syrup/institutions/abstract_institution.rb
+- lib/syrup/institutions/zions_bank.rb
+- lib/syrup/transaction.rb
+- lib/syrup/version.rb
+- spec/spec_helper.rb
+- spec/syrup/extract_spec.rb
+- spec/syrup/institutions/zions_bank_spec.rb
+- spec/syrup/transaction_spec.rb
+- syrup.gemspec
+has_rdoc: true
+homepage: http://github.com/dontangg/syrup
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: syrup
+rubygems_version: 1.5.0
+signing_key: 
+specification_version: 3
+summary: Simple account balance/transactions extractor.
+test_files: 
+- spec/spec_helper.rb
+- spec/syrup/extract_spec.rb
+- spec/syrup/institutions/zions_bank_spec.rb
+- spec/syrup/transaction_spec.rb