bankjob 0.5.0 → 0.5.1

data/History.txt

@@ -1,4 +1,7 @@
-== 0.0.1 2009-02-13
+== 0.5.1 2009-04-20
+* 1 minor enhancement:
+  * bpi_scraper.rb now accepts an optional third argument for the account number. Entering a number will cause the scraper to scrape that account rather than the default account.
 
+== 0.5.0 2009-04-14
 * 1 major enhancement:
   * Initial release

data/lib/bankjob.rb

@@ -8,5 +8,5 @@ require 'bankjob/scraper.rb'
 require 'bankjob/payee.rb'
 
 module Bankjob
-  BANKJOB_VERSION = '0.5.0' unless defined?(BANKJOB_VERSION)
+  BANKJOB_VERSION = '0.5.1' unless defined?(BANKJOB_VERSION)
 end

data/lib/bankjob/scraper.rb

@@ -136,7 +136,7 @@ module Bankjob
   #        transaction = create_transaction
   #        transaction.date = #... scrape a date here
   #        ...
-  #        statement.transactions <<
+  #        statement.transactions << transaction
   #      end
   #    end
   #  end

data/lib/bankjob/support.rb

@@ -79,7 +79,54 @@ module Bankjob
     return amt.to_f
   end
 
+  ##
+  # Finds a selector field in a named +form+ in the given Mechanize +page+, selects
+  # the suggested +label+
+  def select_and_submit(page, form_name, select_name, selection)
+    option = nil
+    form  = page.form(form_name)
+    unless form.nil?
+      selector = form.field(select_name)
+      unless selector.nil?
+        option = select_option(selector, selection)
+        form.submit
+      end
+    end
+    return option
+  end
+
+  ##
+  # Given a Mechanize::Form:SelectList +selector+ will attempt to select the option
+  # specified by +selection+.
+  # This algorithm is used:
+  #   The first option with a label equal to the +selection+ is selected.
+  #    - if none is found then -
+  #   The first option with a value equal to the +selection+ is selected.
+  #    - if none is found then -
+  #   The first option with a label or value that equal to the +selection+ is selected
+  #   after removing non-alphanumeric characters from the label or value
+  #    - if none is found then -
+  #   The first option with a lable or value that _contains_ the +selection+
+  #
+  # If matching option is found, the #select is called on it.
+  # If no option is found, nil is returned - otherwise the option is returned
+  #
+  def select_option(selector, selection)
+    options = selector.options.select { |o| o.text == selection }
+    options = selector.options.select { |o| o.value == selection } if options.empty?
+    options = selector.options.select { |o| o.text.gsub(/[^a-zA-Z0-9]/,"") == selection } if options.empty?
+    options = selector.options.select { |o| o.value.gsub(/[^a-zA-Z0-9]/,"") == selection } if options.empty?
+    options = selector.options.select { |o| o.text.include?(selection) } if options.empty?
+    options = selector.options.select { |o| o.value.include?(selection) } if options.empty?
+
+    option = options.first
+    option.select() unless option.nil?
+    return option
+  end
 
+  ##
+  # Uploads the given OFX document to the Wesabe account specified in the +wesabe_args+
+  #
   def self.wesabe_upload(wesabe_args, ofx_doc, logger)
     if (wesabe_args.nil? or (wesabe_args.length < 2 and wesabe_args.length > 3))
       raise "Incorrect number of args for Wesabe (#{wesabe_args}), should be 2 or 3."
@@ -113,6 +160,13 @@ module Bankjob
     end
   end
 
+  ##
+  # Helps the user determine how to upload to their Wesabe account.
+  # 
+  # When used with no args, will give generic help information.
+  # When used with Wesabe account and password, will log into Wesabe and list
+  # the users accounts, and suggest command line args to upload to each account.
+  #
   def self.wesabe_help(wesabe_args)
     if (wesabe_args.nil? or wesabe_args.length != 2)
       puts <<-EOF

data/scrapers/bpi_scraper.rb

@@ -15,7 +15,10 @@ include Bankjob        # access the namespace of Bankjob
 # as an example of how to build your own scraper.
 #
 # BpiScraper expects the user name and password to be passed on the command line
-# using -scraper_args "user password" (with a space between them).
+# using --scraper-args "user password" (with a space between them).
+# Optionally, the account number can also be specified with the 3rd argument so:
+# --scraper-args "user password 803030000001" causing that account to be selected
+# before scraping the statement
 #
 class BpiScraper < BaseScraper
 
@@ -75,6 +78,18 @@ class BpiScraper < BaseScraper
     if (transactions_page.nil?)
       raise "BPI Scraper failed to load the transactions page at #{TRANSACTIONS_URL}"
     end
+
+    # If there is a third scraper arg, it is the account number and we use it
+    # to select the account on the transactions page
+    if (scraper_args and scraper_args.length > 2)
+      account = scraper_args[2]
+      # the account selector is the field 'contaCorrente' in the form 'form_mov'
+      Bankjob.select_and_submit(transactions_page, 'form_mov', 'contaCorrente', account)
+      sleep 1
+      # refetch the transactions page after selecting the account
+      transactions_page = agent.get(TRANSACTIONS_URL)
+    end
+
     return transactions_page
   end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: bankjob
 version: !ruby/object:Gem::Version 
-  version: 0.5.0
+  version: 0.5.1
 platform: ruby
 authors: 
 - rhubarb
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-04-11 00:00:00 +01:00
+date: 2009-04-20 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency