fio_parser 0.1.0

data/lib/fio_parser.rb

@@ -0,0 +1,188 @@
+# encoding: UTF-8
+
+# fio_parser is simple library for parsing monthly account statements from the Fio Bank CZ. Supports CSV and GPC formats. 
+#
+# Author: Jaromír "Cervajz" Čevenka
+# http://www.cervajz.com
+#
+# Copyright © 2012 cervajz@cervajz.com
+#
+# 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.
+
+require 'ostruct'
+require 'date'
+
+module GPCRowParser
+  def delete_zeros str
+    str.gsub /\A0*/, ''
+  end
+
+  def gpc_bank_code row
+    result = row[71..80][2..5]
+    result.each_char { |ch| return result if (ch != '0') }
+    ''
+  end
+
+  def gpc_constant_symbol row
+    result = delete_zeros row[71..80][6..10]
+    result.each_char { |ch| return result if (ch != '0') }
+    ''
+  end
+
+  def gpc_specific_symbol row
+    result = row[81..90]
+    result.each_char { |ch| return result if (ch != '0') }
+    ''
+  end
+
+  def gpc_total row
+    result = row[48..59].to_i / 100.0
+    result = 0 - result if row[60].to_i == 1
+    result
+  end
+
+  def gpc_date row
+    Date.strptime row[122..127], '%d%m%y'
+  end
+end
+
+class FioParser
+  include GPCRowParser
+  attr_accessor :transactions
+
+  class << self
+    def parse_csv(csv_file_path)
+      return new csv_file_path, true
+    end
+
+    def parse_gpc(gpc_file_path)
+      return new gpc_file_path, false
+    end
+  end
+
+  def initialize file_path, csv=true
+    @transactions = []
+
+    if csv
+      parse_csv file_path
+    else
+      parse_gpc file_path
+    end
+  end
+
+  def incomes
+    result = []
+    @transactions.each { |t| result.push(t) if t.total > 0.0 }
+    result
+  end
+
+  def total_income
+    result = 0
+    incomes.each { |i| result += i.total }
+    result.round(2)
+  end
+
+  def total_expenses
+    result = 0
+    expenses.each { |i| result += i.total }
+    result.abs.round(2)
+  end
+
+  def expenses
+    result = []
+    @transactions.each { |t| result.push(t) if t.total < 0.0 }
+    result
+  end
+
+  def first
+    @transactions.first
+  end
+
+  def last
+    @transactions.last
+  end
+
+  private
+
+  def parse_csv csv_file
+    content = false
+
+    file_rows(csv_file).each do |row|
+      if content && contain_transaction?(row)
+        @transactions.push parse_csv_row row
+      end
+
+      content = row.downcase.include? 'převod;' unless content
+    end
+  end
+
+  def parse_gpc gpc_file
+
+    file_rows(gpc_file).each do |row|
+      if row[0..2].downcase.include?('075')
+        @transactions.push parse_gpc_row(row)
+      end
+    end
+  end
+
+  def parse_csv_row row
+    columns = row.split ';'
+
+    t = OpenStruct.new
+    t.date = Date.strptime columns[1], '%d.%m.%Y'
+    t.total = columns[2].to_s.delete(' ').gsub(',', '.').to_f
+    t.counter_acc = columns[3]
+    t.bank_code = columns[4]
+    t.vs = columns[5]
+    t.type = get_transaction_type columns[6]
+    t.counter_acc_name = columns[7]
+    t.message = columns[8]
+    t.comment = columns[9]
+
+    t
+  end
+
+  def parse_gpc_row row
+    t = OpenStruct.new
+
+    t.date = gpc_date row
+    t.total = gpc_total row
+    t.counter_acc = delete_zeros row[19..34]
+    t.bank_code = gpc_bank_code row
+    t.vs = delete_zeros row[61..70]
+    t.cs = gpc_constant_symbol row
+    t.ss = gpc_specific_symbol row
+    t.type = row[60].to_i
+    t.message = row[97..116]
+
+    t
+  end
+
+  def contain_transaction? row
+    !(row.strip.empty? || row.downcase.include?('suma;'))
+  end
+
+  def get_transaction_type str
+    if ['převodem', 'bezhotovostní', 'připsaný úrok'].any? { |w| str.downcase.include?(w) }
+      return :transfer
+    end
+
+    if ['kartou'].any? { |w| str.include?(w) }
+      return :card
+    end
+
+    :other
+  end
+
+  def file_rows file
+    result = []
+    e_c = Encoding::Converter.new 'cp1250', 'utf-8'
+    File.open(file).each_line { |line| result.push e_c.convert line }
+    result
+  end
+end
+

metadata

@@ -0,0 +1,46 @@
+--- !ruby/object:Gem::Specification
+name: fio_parser
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Jaromír Červenka
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-10-24 00:00:00.000000000 Z
+dependencies: []
+description: Gem for parsing monthly statements from the Fio Bank CZ. Supports CSV
+  and GPC formats
+email: cervajz@cervajz.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/fio_parser.rb
+homepage: https://github.com/Cervajz/fio_parser
+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: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Gem for parsing monthly statements from the Fio Bank CZ
+test_files: []