cartolify 0.1

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,17 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.0.0"
+  gem "jeweler", "~> 1.8.3"
+  gem "turn"
+end
+
+gem 'mechanize'
+gem 'nokogiri'
+gem 'json'

data/Gemfile.lock

@@ -0,0 +1,45 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ansi (1.4.1)
+    domain_name (0.5.2)
+      unf (~> 0.0.3)
+    git (1.2.5)
+    jeweler (1.8.3)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.6.5)
+    mechanize (2.1)
+      domain_name (~> 0.5, >= 0.5.1)
+      net-http-digest_auth (~> 1.1, >= 1.1.1)
+      net-http-persistent (~> 2.3, >= 2.3.2)
+      nokogiri (~> 1.4)
+      ntlm-http (~> 0.1, >= 0.1.1)
+      webrobots (~> 0.0, >= 0.0.9)
+    net-http-digest_auth (1.2)
+    net-http-persistent (2.4)
+    nokogiri (1.5.0)
+    ntlm-http (0.1.1)
+    rake (0.9.2.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    turn (0.8.2)
+      ansi (>= 1.2.2)
+    unf (0.0.4)
+      unf_ext
+    unf_ext (0.0.4)
+    webrobots (0.0.13)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0.0)
+  jeweler (~> 1.8.3)
+  json
+  mechanize
+  nokogiri
+  rdoc (~> 3.12)
+  turn

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Patricio Bruna
+
+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.rdoc

@@ -0,0 +1,18 @@
+= Cartolify
+
+Cartolify is a Library, and the main engine, of my new project for keep tracks of my budget.
+This library has 3 functions:
+
+* Return the Bank Account Balance,
+* Return the last month transactions list, and
+* Sync the transactions with a local DB
+
+== Contributing to cartolify
+ 
+For now is not possible, beacuse we are just starting
+
+== Copyright
+
+Copyright (c) 2012 Patricio Bruna. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,46 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "cartolify"
+  gem.homepage = "http://github.com/pbruna/cartolify"
+  gem.license = "MIT"
+  gem.summary = %Q{ Lib for getting info of Chilean Banks} 
+  gem.description = %Q{This is the Engine for my Budget System} 
+  gem.email = "pbruna@gmail.com"
+  gem.authors = ["Patricio Bruna"]
+  gem.version = File.exist?('VERSION') ? File.read('VERSION') : "0.0" 
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : "0.1"
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "cartolify #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1

data/lib/cartolify/bank.rb

@@ -0,0 +1,26 @@
+class Bank 
+	attr_reader :branch
+
+	def initialize(bank_class, bank_account)
+		require "cartolify/banks/#{bank_class.downcase}_bank"
+		@branch = Object.const_get("#{bank_class.upcase}Bank").new(bank_account)
+	end
+
+	def url
+		@branch.url
+	end
+
+	def balance
+		@branch.balance
+	end
+
+	def session
+		@branch.session
+	end
+
+	def transactions
+		@branch.transactions
+	end
+
+
+end

data/lib/cartolify/banks/bci_bank.rb

@@ -0,0 +1,90 @@
+# encoding: utf-8
+
+class BCIBank < Bank
+	attr_accessor :user, :password, :account_number
+	attr_reader :session
+
+	URL = "https://www.bci.cl/cl/bci/aplicaciones/seguridad/autenticacion/loginPersonas.jsf"
+	LOGIN_FORM_NAME = "frm"
+	BROWSER = "Mac FireFox"
+	START_URL = "https://www.bci.cl/cuentaswls/ControladorCuentas?opcion=CTACTECARTOLA&objeto="
+
+	def initialize(account = {})
+		@user = account[:user] 
+		@password = account[:password]
+		@account_number = account[:number]
+		@session = new_session
+	end
+
+	def url
+		URL
+	end
+
+	def balance
+		# We make sure we are on the first page
+		session.get("#{START_URL}#{self.account_number}")
+		# The balance is in the 7 table, second td
+		string_balance = session.page.root.css("table")[6].css("td")[1].text
+		# Remove de $ simbol and the dots
+		convert_money_to_integer(string_balance)
+	end
+
+	def transactions
+		transactions = []
+		# We go to the transactions page
+		session.get("#{START_URL}#{self.account_number}")
+		# Tables that hold the transactions, we select the tr's
+		table_rows = session.page.root.css("table")[10].css("tr.blanco, tr.suave")
+		table_rows.each do |row|
+			values = row.css("td").map { |td| clean_string(td) }
+			total = values[3].size > 0 ? values[3] : values[4]
+
+			transaccion_info = {
+				:date => Date.parse(values[0]),
+				:description => values[1],
+				:serial => values[2],
+				:total => convert_money_to_integer(total)
+			}
+			transactions << Transaction.new(transaccion_info)
+		end
+		transactions
+	end
+
+	def new_session
+		agent = Mechanize.new
+		agent.user_agent_alias=BROWSER
+		agent.get(URL)
+		form = agent.page.form(LOGIN_FORM_NAME)
+
+		form["frm"]="frm"
+    	form["frm:canal"]="110"
+    	form["frm:clave"]= self.password
+	    form["frm:clave_aux"]=""
+	    form["frm:dvCliente"] = self.user[-1] #digito verificador rut
+    	form["frm:grupo"] = ""
+    	form["frm:j_idt12"] ="Ingresar"
+    	# Rut only numbers without verification
+    	form["frm:rutCliente"]= self.user[0..-2].gsub(/[\--.]/,'')
+    	form["frm:rut_aux"] = ""
+    	form["frm:servicioInicial"]="SuperCartola"
+    	form["frm:touch"] = "#{(Time.now.to_f*1000).to_i}"
+    	form["frm:transaccion"] = ""
+		form.submit
+		agent
+	end
+
+	private
+	def clean_string(html_object)
+		# We have to remove the special &nbsp character, which is not a \s+
+		nbsp = Nokogiri::HTML("&nbsp;").text
+		# This is the text of the html element
+		text_of_html_el = html_object.children.text
+		text_of_html_el.strip.gsub(nbsp,'').gsub(/\n/,'')
+	end
+
+	def convert_money_to_integer(money)
+		int = money.gsub(/[\$.]/,'').gsub(/\s+/,'')
+		int.to_i
+	end
+
+end

data/lib/cartolify/banks/bci_mobi_bank.rb

@@ -0,0 +1,78 @@
+# encoding: utf-8
+
+class BCIMobiBank < Bank
+	attr_accessor :user, :password
+	attr_reader :session
+
+	URL = "https://bci.mobi"
+	LOGIN_FORM_NAME = "loginform"
+	BROWSER = "Mac FireFox"
+	START_URL = "https://bci.mobi/supercartola.do"
+
+	def initialize(account = {})
+		@user = account[:user]
+		@password = account[:password]
+		@session = new_session
+	end
+
+	def url
+		URL
+	end
+
+	def balance
+		# We make sure we are on the first page
+		session.get(START_URL)
+		# The balance is in the 5 table, second tr, second td inside a div
+		string_balance = session.page.root.css("table")[4].css("tr")[1].css("td")[1].children.text
+		# Remove de $ simbol and the dots
+		string_balance.gsub!(/[\$-.]/,'')
+		# Return Integer
+		string_balance.to_i
+	end
+
+	def get_transactions
+		transactions = []
+		# We go to the transactions page
+		session.get(START_URL)
+		# Go to transaction pages
+		# 4 link, the first that reads "Más"
+		session.page.links[3].click
+		# Tables that hold the transactions, 3 tables per page
+		tables = session.page.root.css("table")[5].css("tr")[1].css("td").css("table")
+		tables.each do |table|
+			h = {
+				:date => table.css("tr")[0].css("td")[1].text,
+				:description => table.css("tr")[1].css("td")[1].text,
+				:serial => table.css("tr")[2].css("td")[1].text,
+				:total => table.css("tr")[3].css("td")[1].text
+			}
+			transactions << h
+		end
+		transactions
+	end
+
+	def new_session
+		agent = Mechanize.new
+		agent.user_agent_alias=BROWSER
+		agent.get(URL)
+		form = agent.page.form(LOGIN_FORM_NAME)
+		form.rut = self.user
+		form.clave = self.password
+		form.canal = "901"
+		form.menu_opcion="targetSupercartola"
+		form.submit
+		agent
+		if agent.page.root.css("table").first.css("h1").text.eql?("Autentificación Inválida")
+		 	false
+		elsif agent.page.root.css("table").first.css("h1").text.eql?("Clave bloqueada")
+			false
+		elsif agent.page.root.css("table").first.css("h1").text.eql?("Error desconocido.")
+			false
+		else
+		 agent
+		end
+	end
+
+	private
+
+end

data/lib/cartolify/banks/chileempresas_bank.rb

@@ -0,0 +1,116 @@
+class CHILEEMPRESASBank < Bank
+  attr_accessor :user, :password, :account_number, :company_rut
+  attr_reader :session
+
+  HOST = "www.empresas.bancochile.cl"
+  URL = "https://#{HOST}/cgi-bin/navega?pagina=enlinea/login_fus"
+  LOGIN_FORM_NAME = "theform"
+  BROWSER = "Mac FireFox"
+  START_URL = "https://www.empresas.bancochile.cl/CCOLSaldoMovimientosWEB/selectorCuentas.do?accion=initSelectorCuentas&moneda=CTD&cuenta="
+
+  def initialize(account = {})
+    @company_rut = account[:company_rut]
+    @user = account[:user]
+    @password = account[:password]
+    @account_number = account[:number]
+    @session = new_session
+  end
+
+  def url
+    URL
+  end
+
+  def balance
+    # We make sure we are on the first page
+    session.get("#{START_URL}#{self.account_number}")
+    # The value is inside a div#saldos in the second td
+    string_balance = clean_string(session.page.root.css("#estaCuen").css(".detalleSaldosMov").css("td").last)
+    # The above result has an ":" character that we need to remove
+    string_balance.gsub!(/:/,'')
+    # Remove de $ simbol and the dots
+    convert_money_to_integer(string_balance)
+  end
+
+  def transactions
+    transactions = []
+    total = 0
+    movements = get_transactions_json
+    movements.each do |mov|
+      
+      if mov[4].empty? # Out money
+        total = convert_money_to_integer(mov[5])
+      else
+        total = convert_money_to_integer(mov[4]) * -1 
+      end
+      
+      transaccion_info = {
+				:date => Date.parse(mov[0]),
+				:description => mov[1],
+				:total => total
+			}
+			transactions << Transaction.new(transaccion_info)
+    end
+    transactions
+  end
+
+  def new_session
+    agent = Mechanize.new
+    agent.user_agent_alias=BROWSER
+    agent.get(URL)
+    form = agent.page.form(LOGIN_FORM_NAME)
+
+    form["rut_emp"] = self.company_rut[0..-2].gsub(/[\--.]/,'')
+    form["dv_emp"] = self.company_rut[-1]
+    form["rut_apo"] = self.user[0..-2].gsub(/[\--.]/,'')
+    form["dv_apo"] =  self.user[-1]
+    form["pin"] = self.password
+
+    form.submit
+    agent
+  end
+
+  private
+    def clean_string(html_object)
+      # We have to remove the special &nbsp character, which is not a \s+
+      nbsp = Nokogiri::HTML("&nbsp;").text
+      # This is the text of the html element
+      text_of_html_el = html_object.children.text
+      text_of_html_el.strip.gsub(nbsp,'').gsub(/\n/,'')
+    end
+
+    def convert_money_to_integer(money)
+      int = money.gsub(/[\$.]/,'').gsub(/\s+/,'')
+      int.to_i
+    end
+    
+    def get_transactions_json
+      self.balance
+      cookie = session.cookies.join("; ")
+      path = "/CCOLSaldoMovimientosWEB/generadorMovimientosJSON.do"
+      params = {
+        "sEcho"=> "4",
+        "iColumns" => "7",
+        "iDisplayStart" => "0",
+        "iDisplayLength" => "100"
+      }
+      http = Net::HTTP.new(HOST, 443)
+      http.use_ssl = true
+      request = Net::HTTP::Post.new(path)
+      request.set_form_data(params)
+      request.add_field("X-Requested-With", "XMLHttpRequest")
+      request.add_field('Cookie', cookie)
+      response = http.request(request)
+      json = JSON.parse(response.body)
+      clean_json(json["aaData"])
+    end
+    
+    def clean_json(json)
+      json.each do |arr|
+        [4, 5, 6].each do |el|
+          arr[el] = Nokogiri::HTML::parse(arr[el]).text # remove <p> tags
+        end
+      end
+      json
+    end
+
+end

data/lib/cartolify/transaction.rb

@@ -0,0 +1,18 @@
+class Transaction
+	attr_reader :total, :date, :description, :type
+
+	def initialize(hash)
+		@total = hash[:total]
+		@date = hash[:date]
+		@description = hash[:description]
+	end
+
+	def income?
+		total > 0
+	end
+
+	def outcome?
+		total < 0
+	end
+
+end

data/lib/cartolify.rb

@@ -0,0 +1,6 @@
+require 'cartolify/account'
+require 'cartolify/bank'
+require 'cartolify/transaction'
+require 'uri'
+require 'mechanize'
+require 'json'

data/test/helper.rb

@@ -0,0 +1,28 @@
+require 'rubygems'
+require 'bundler'
+require	'turn'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib', 'lib/cartolify',
+ 'lib/cartolify/banks'))
+require 'cartolify'
+
+class Test::Unit::TestCase
+
+	def bank_account
+		account = {
+			:user => ENV['bank_user'],
+			:password => ENV['bank_password'],
+			:number => ENV['bank_account_number']
+		}
+	end
+
+end

data/test/test_bank.rb

@@ -0,0 +1,33 @@
+require 'helper'
+
+class TestBank < Test::Unit::TestCase
+
+  def setup
+  	@bank = Bank.new("BCI", bank_account)
+  end
+
+  def test_new_bank_should_return_an_specfic_bank_Class_Instance
+  	assert_equal(BCIBank, @bank.branch.class)
+  end
+
+  def test_url_should_return_and_https_url
+  	assert_equal("https", URI(@bank.url).scheme)
+  end
+
+  def test_should_get_a_session
+	session = @bank.session
+	assert(session)
+  end
+
+  def test_balance_should_return_a_number
+  	balance = @bank.balance
+	  assert_equal(Fixnum, balance.class)
+  end
+
+  def test_transactions_should_return_an_array
+    transactions = @bank.transactions
+    assert_equal(Array, transactions.class)
+  end
+
+
+end

data/test/test_bci_bank.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+require 'helper'
+require 'cartolify/banks/bci_bank'
+
+class TestBCIBank < Test::Unit::TestCase
+
+	def setup
+		@bank = BCIBank.new( bank_account )
+	end
+
+	def test_user_should_not_be_nil
+		assert_not_nil(@bank.user)
+	end
+
+	def test_password_should_not_be_nil
+		assert_not_nil(@bank.password)
+	end
+
+	# Comment for now because it may block the account
+	# def test_wrong_login_should_be_false
+	# 	bank = BCIBank.new({:user => "13.834.853-9", :password => "mdoad"})
+	# 	session = bank.login
+	# 	assert(!session, "Should be False")
+	# end
+
+	def test_should_get_a_session
+		session = @bank.session
+		assert(session)
+	end
+
+	def test_balance_should_return_an_Fixnum
+		balance = @bank.balance
+		assert_equal(Fixnum, balance.class)
+	end
+
+end

data/test/test_cartolify.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestCartolify < Test::Unit::TestCase
+  def test_something_for_real
+    true
+  end
+end

metadata

@@ -0,0 +1,145 @@
+--- !ruby/object:Gem::Specification
+name: cartolify
+version: !ruby/object:Gem::Version
+  version: '0.1'
+  prerelease: 
+platform: ruby
+authors:
+- Patricio Bruna
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-05-27 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: mechanize
+  requirement: &70181271682280 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70181271682280
+- !ruby/object:Gem::Dependency
+  name: nokogiri
+  requirement: &70181271715480 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70181271715480
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: &70181271712300 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *70181271712300
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: &70181271710800 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: *70181271710800
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: &70181271709360 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.0.0
+  type: :development
+  prerelease: false
+  version_requirements: *70181271709360
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: &70181271723740 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.3
+  type: :development
+  prerelease: false
+  version_requirements: *70181271723740
+- !ruby/object:Gem::Dependency
+  name: turn
+  requirement: &70181271720060 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *70181271720060
+description: This is the Engine for my Budget System
+email: pbruna@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/cartolify.rb
+- lib/cartolify/account.rb
+- lib/cartolify/bank.rb
+- lib/cartolify/banks/bci_bank.rb
+- lib/cartolify/banks/bci_mobi_bank.rb
+- lib/cartolify/banks/chileempresas_bank.rb
+- lib/cartolify/transaction.rb
+- test/helper.rb
+- test/test_bank.rb
+- test/test_bci_bank.rb
+- test/test_cartolify.rb
+homepage: http://github.com/pbruna/cartolify
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+      segments:
+      - 0
+      hash: -1886146149934546780
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.10
+signing_key: 
+specification_version: 3
+summary: Lib for getting info of Chilean Banks
+test_files: []