firstdirect 0.1 → 0.2

data/README.txt

@@ -5,21 +5,15 @@ Internet banking with First Direct using Ruby.
 A FirstDirect object will log into First Direct's website and create some
 Account objects for each account listed on the first page after login.
 
-Please see the RDoc / source code for further information about firstdirect.rb!
-
-== BUGS
-
-* Downloading of credit card account statements "doesn't work".
-
-    firstdirect.rb:51:in `strip_js': undefined method `[]' for nil:NilClass (NoMethodError)
-
-* Downloading statements for 'Everyday e-Saver' fails with "no date_form found".
-
-* Downloading "Regular Saver" account information often returns 'rubbish':
-
-    data downloaded looks like rubbish: <!--Build:19.01.0004-
+You can install +firstdirect+ using +gem+ (the gem is called 'firstdirect') or 
+{download it}[http://rubyforge.org/frs/?group_id=6595]
+from from the
+{Rubyforge project}[http://rubyforge.org/projects/firstdirec/].
 
+See the FirstDirect module for further information.
 
 == LICENSE
 
+Copyright (c) Edward Speyer, 2008
+
 This code is licensed under the terms of the GPL version 2.

data/Rakefile

@@ -4,6 +4,8 @@ require 'rubygems'
 require 'hoe'
 require './lib/firstdirect.rb'
 
+ENV['NODOT'] = '1'
+
 Hoe.new('firstdirect', FirstDirect::VERSION) do |p|
   p.remote_rdoc_dir = '/'
   p.developer('Edward Speyer', 'edward.rffd@example.com')

data/lib/firstdirect.rb

@@ -26,6 +26,17 @@ Each Account has a name, number, and balance.
   #=> 1st Account (10-20-30 10000000): £100.00
 
 
+You can fetch an Account's recent activity (as parsed from the HTML of the
+account page on the First Direct website) as a CSV string or an Array:
+
+  puts account.recent_statement_csv
+  #=> date,details,paid out,paid in,balance,?
+  #   08/07/2008,TROTTER R   *FRS   REGULAR SAVER,100.00,"",100.00,""
+
+  # Get an array instead:
+  account.recent_statement_array
+
+
 An Account can also download statements in CSV format:
 
   account.download
@@ -48,9 +59,11 @@ An Account can also download statements in CSV format:
   #    T100.00
 
 
+Copyright (c) Edward Speyer, 2008
+
 =end
 class FirstDirect
-  VERSION = '0.1'
+  VERSION = '0.2'
 
   require 'rubygems'
   require 'mechanize'
@@ -220,13 +233,60 @@ class FirstDirect
     def to_s
       "#{name} (#{number}): #{balance}"
     end
-
+    
     #
-    # Go to the mini-statement page for this account, which we'll need to do
+    # Go to the recent-statement page for this account, which we'll need to do
     # statement downloading.
     #
-    def page
-      trace('getting account page'){ parent.agent.get(link) }
+    # The page is cached -- if you want to force an update:
+    # 
+    #   account.page(:update => true)
+    #
+    #--
+    #
+    # This is a lazy accessor for @__page.  Please don't use @__page directly!
+    # In fact, I think I'll rename it to @__page (from @page) to discourage
+    # such access!
+    #
+    def page(options={})
+      if @__page.nil? or options[:update]
+        trace('getting account page'){ @__page = parent.agent.get(link) }
+      end
+      @__page
+    end
+
+    #
+    # Parse a recent-statement from this Account's page.
+    #
+    def recent_statement_array
+      data = []
+
+      table = page.at('table.fdStatTable')
+      headings = (table / 'thead/tr/th').map{ |el| el.inner_text.strip }
+      data << headings
+
+      last_row_data = nil
+      (table / 'tbody/tr').each do |row|
+        row_data = (row / 'td').map{ |el| el.inner_text.strip }
+        row_data[0] = last_row_data[0] if row_data[0].empty? and last_row_data
+        last_row_data = row_data
+        data << row_data
+      end
+
+      return data
+    end
+
+    #
+    # Return the recent-statement in CSV format.
+    #
+    def recent_statement_csv
+      require 'csv'
+      string = ''
+      csv = CSV::Writer.create(string)
+      for row in recent_statement_array
+        csv << row
+      end
+      return string
     end
 
     #
@@ -354,7 +414,6 @@ class FirstDirect
         row.at('td[1]/a[2]'),
         row.at('td[3]/strong')
       ].map do |v|
-        require 'cgi'
         v.inner_html.gsub('&nbsp;', ' ').strip.gsub('&pound;', '£')
       end
       b.link = Helpers.strip_js( row.at('td[1]/a[1]') )

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: firstdirect
 version: !ruby/object:Gem::Version 
-  version: "0.1"
+  version: "0.2"
 platform: ruby
 authors: 
 - Edward Speyer
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2008-07-07 00:00:00 +01:00
+date: 2008-07-08 00:00:00 +01:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency