fio_api 0.0.1

data/.rspec

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

data/Gemfile

@@ -0,0 +1,16 @@
+source "http://rubygems.org"
+# Add dependencies required to use your gem here.
+# Example:
+#   gem "activesupport", ">= 2.3.5"
+
+gem "httparty", "0.9.0"
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem "rspec", "~> 2.8.0"
+  gem "rspec-mocks", "~> 2.8.0"
+  gem "rdoc", "~> 3.12"
+  gem "bundler", "~> 1.2.0"
+  gem "jeweler", "~> 1.8.4"
+end

data/Gemfile.lock

@@ -0,0 +1,38 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    diff-lcs (1.1.3)
+    git (1.2.5)
+    httparty (0.9.0)
+      multi_json (~> 1.0)
+      multi_xml
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.5)
+    multi_json (1.3.7)
+    multi_xml (0.5.1)
+    rake (10.0.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rspec (2.8.0)
+      rspec-core (~> 2.8.0)
+      rspec-expectations (~> 2.8.0)
+      rspec-mocks (~> 2.8.0)
+    rspec-core (2.8.0)
+    rspec-expectations (2.8.0)
+      diff-lcs (~> 1.1.2)
+    rspec-mocks (2.8.0)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.2.0)
+  httparty (= 0.9.0)
+  jeweler (~> 1.8.4)
+  rdoc (~> 3.12)
+  rspec (~> 2.8.0)
+  rspec-mocks (~> 2.8.0)

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2012 Robin Bortlik
+
+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,44 @@
+= Fio API
+
+This project rocks and uses MIT-LICENSE.
+
+This gem is a wrapper for Fio bank API. Currently Fio API support only data listing, so you can make only a requests to get all your money transaction in some date range.
+
+== Usage
+
+=== Add to your gemfile
+  gem 'fio_api'
+
+=== Setup API token
+  FioAPI.token = "8JSKJ823DN86YRH87UIRUI2363ND5xcr3"
+
+=== Request transactions in date range 2012-11-05 and 2012-12-26
+  list = FioAPI::List.new                                         # Create new listing request
+  list.by_date_range(Date.new(2012,11,05), Date.new(2012,12,26))  # Specify listing condition and fetch request
+  list.response                                                   # Return deserialized response
+
+=== Request transactions by listing_id and year
+  list = FioAPI::List.new
+  list.by_listing_id_and_year("43XC6362ASD", 2012)
+  list.response
+
+=== Request to set last request id
+  list = FioAPI::List.new
+  list.set_last_fetch_id("SHXG738377834")
+  list.response
+
+=== Request to set last request date
+  list = FioAPI::List.new
+  list.set_last_fetch_date(Date.new(2012,11,05))
+  list.response
+
+
+== Contributing to fio_api
+
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.

data/Rakefile

@@ -0,0 +1,49 @@
+# 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 = "fio_api"
+  gem.homepage = "http://github.com/robinbortlik/fio_api"
+  gem.license = "MIT"
+  gem.summary = %Q{API wrapper for FIO bank}
+  gem.description = %Q{API wrapper for FIO bank}
+  gem.email = "robinbortlik@gmail.com"
+  gem.authors = ["Robin Bortlik"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = FileList['spec/**/*_spec.rb']
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |spec|
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "fio_api #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/fio_api.gemspec

@@ -0,0 +1,80 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run 'rake gemspec'
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = "fio_api"
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Robin Bortlik"]
+  s.date = "2012-12-06"
+  s.description = "API wrapper for FIO bank"
+  s.email = "robinbortlik@gmail.com"
+  s.extra_rdoc_files = [
+    "LICENSE.txt",
+    "README.rdoc"
+  ]
+  s.files = [
+    ".rspec",
+    "Gemfile",
+    "Gemfile.lock",
+    "LICENSE.txt",
+    "README.rdoc",
+    "Rakefile",
+    "VERSION",
+    "fio_api.gemspec",
+    "lib/base.rb",
+    "lib/base/account.rb",
+    "lib/base/deserializer.rb",
+    "lib/base/deserializers/list_response_deserializer.rb",
+    "lib/base/list.rb",
+    "lib/base/request.rb",
+    "lib/base/transaction.rb",
+    "lib/fio_api.rb",
+    "lib/utils/hash.rb",
+    "spec/base/account_spec.rb",
+    "spec/base/deserializer_spec.rb",
+    "spec/base/deserializers/list_response_deserializer_spec.rb",
+    "spec/base/list_spec.rb",
+    "spec/base/request_spec.rb",
+    "spec/base/transaction_spec.rb",
+    "spec/fio_api_spec.rb",
+    "spec/spec_helper.rb",
+    "spec/utils/hash_spec.rb"
+  ]
+  s.homepage = "http://github.com/robinbortlik/fio_api"
+  s.licenses = ["MIT"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = "1.8.24"
+  s.summary = "API wrapper for FIO bank"
+
+  if s.respond_to? :specification_version then
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<httparty>, ["= 0.9.0"])
+      s.add_development_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_development_dependency(%q<rspec-mocks>, ["~> 2.8.0"])
+      s.add_development_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_development_dependency(%q<bundler>, ["~> 1.2.0"])
+      s.add_development_dependency(%q<jeweler>, ["~> 1.8.4"])
+    else
+      s.add_dependency(%q<httparty>, ["= 0.9.0"])
+      s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+      s.add_dependency(%q<rspec-mocks>, ["~> 2.8.0"])
+      s.add_dependency(%q<rdoc>, ["~> 3.12"])
+      s.add_dependency(%q<bundler>, ["~> 1.2.0"])
+      s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+    end
+  else
+    s.add_dependency(%q<httparty>, ["= 0.9.0"])
+    s.add_dependency(%q<rspec>, ["~> 2.8.0"])
+    s.add_dependency(%q<rspec-mocks>, ["~> 2.8.0"])
+    s.add_dependency(%q<rdoc>, ["~> 3.12"])
+    s.add_dependency(%q<bundler>, ["~> 1.2.0"])
+    s.add_dependency(%q<jeweler>, ["~> 1.8.4"])
+  end
+end
+

data/lib/base/account.rb

@@ -0,0 +1,7 @@
+module FioAPI
+  # == Account class representing the Account entity
+  class Account < FioAPI::Base
+    attr_accessor :account_id, :bank_id, :currency, :iban,:bic,:opening_balance,:closing_balance,
+      :date_start, :date_end, :year_list, :id_list, :id_from, :id_to, :id_last_download
+  end
+end

data/lib/base/deserializer.rb

@@ -0,0 +1,19 @@
+module FioAPI
+  # == Base class for deserializers. Should
+  class Deserializer < FioAPI::Base
+
+    # Deserialize method is required for every deserializer
+    #
+    # == Parameters:
+    # hash::
+    #   Hash returned form request
+    #
+    # == Returns:
+    #   Should return new deserialized object
+    #
+    def deserialize(json)
+      raise "Implement deserialize method"
+    end
+
+  end
+end

data/lib/base/deserializers/list_response_deserializer.rb

@@ -0,0 +1,82 @@
+module FioAPI
+  # == ListResponseDeserializer
+  # Deserializer responsible for response json deserializing. Should construct object with account and transactions attributes.
+  #
+  class ListResponseDeserializer < FioAPI::Deserializer
+    attr_accessor :account, :transactions
+
+    # Deserialize json
+    #
+    # == Parameters:
+    # hash::
+    #   Hash returned from list request.
+    #
+    # == Returns:
+    #   New object with account and transactions attributes
+    #
+    def deserialize(json)
+      self.account = deserialize_account(json.try_path("accountStatement", "info"))
+      self.transactions = deserialize_transactions(json.try_path("accountStatement", "transactionList", "transaction"))
+      self
+    end
+
+    private
+
+    # Deserialize account info
+    # == Parameters:
+    # account_json::
+    #   Hash with informations obout account
+    # == Returns:
+    #   Account object
+    def deserialize_account(account_json)
+      FioAPI::Account.new(
+        account_id:       account_json.try_path("accountId"),
+        bank_id:          account_json.try_path("bankId"),
+        currency:         account_json.try_path("currency"),
+        iban:             account_json.try_path("iban"),
+        bic:              account_json.try_path("bic"),
+        opening_balance:  account_json.try_path("openingBalance"),
+        closing_balance:  account_json.try_path("closingBalance"),
+        date_start:       account_json.try_path("dateStart"),
+        date_end:         account_json.try_path("dateEnd"),
+        year_list:        account_json.try_path("yearList"),
+        id_list:          account_json.try_path("idList"),
+        id_from:          account_json.try_path("idFrom"),
+        id_to:            account_json.try_path("idTo"),
+        id_last_download: account_json.try_path("idLastDownload")
+      )
+    end
+
+    # Deserialize list of transactions
+    # == Parameters:
+    # transactions_json::
+    #   Hash with informations obout transactions
+    # == Returns:
+    #   Array of transactions
+    def deserialize_transactions(transactions_json)
+      Array(transactions_json).map do |trans_json|
+        FioAPI::Transaction.new(
+          transaction_id:         trans_json.try_path("column22", "value"),
+          date:                   trans_json.try_path("column0", "value"),
+          amount:                 trans_json.try_path("column1", "value"),
+          currency:               trans_json.try_path("column14", "value"),
+          account:                trans_json.try_path("column2", "value"),
+          account_name:           trans_json.try_path("column10", "value"),
+          bank_code:              trans_json.try_path("column3", "value"),
+          bank_name:              trans_json.try_path("column12", "value"),
+          ks:                     trans_json.try_path("column4", "value"),
+          vs:                     trans_json.try_path("column5", "value"),
+          ss:                     trans_json.try_path("column6", "value"),
+          user_identification:    trans_json.try_path("column7", "value"),
+          message_for_recipient:  trans_json.try_path("column16", "value"),
+          transaction_type:       trans_json.try_path("column8", "value"),
+          sender:                 trans_json.try_path("column9", "value"),
+          detail_info:            trans_json.try_path("column18", "value"),
+          comment:                trans_json.try_path("column25", "value"),
+          bic:                    trans_json.try_path("column26", "value"),
+          action_id:              trans_json.try_path("column17", "value")
+        )
+      end
+    end
+  end
+end

data/lib/base/list.rb

@@ -0,0 +1,99 @@
+require "base/deserializers/list_response_deserializer"
+
+module FioAPI
+  # Base class for request to transactions listing and account information
+  class List < FioAPI::Base
+    attr_accessor :request, :response
+
+    # Allow request transactions in date range
+    #
+    # == Parameters:
+    # from_date::
+    #   Start date for transactions list
+    # to_date::
+    #   End date for transactions list
+    #
+    # == Returns:
+    #   List insatnce with account info and transactions list
+    #
+    # https://www.fio.cz/ib_api/rest/periods/(token)/(date_from)/(date_to)/transactions.(format)
+    def by_date_range(from_date, to_date)
+      fetch_and_deserialize_response('periods', FioAPI.token, from_date, to_date, 'transactions.json')
+    end
+
+    # Allow request transactions by listing_id and year
+    #
+    # == Parameters:
+    # listing_id::
+    #   Id of listing
+    # year::
+    #   Year when listing was provided
+    #
+    # == Returns:
+    #   List insatnce with account info and transactions list
+    #
+    # https://www.fio.cz/ib_api/rest/by-id/(token)/(year)/(id)/transactions.(format)
+    def by_listing_id_and_year(listing_id, year)
+      fetch_and_deserialize_response('by-id', FioAPI.token, year, listing_id, 'transactions.json')
+    end
+
+    # Allow request transactions from last request
+    #
+    # == Returns:
+    #   List insatnce with account info and transactions list
+    #
+    # https://www.fio.cz/ib_api/rest/last/(token)/transactions.(format)
+    def from_last_fetch
+      fetch_and_deserialize_response('last', FioAPI.token, 'transactions.json')
+    end
+
+    # Allow request to set last transaction_id
+    #
+    # == Parameters:
+    # transaction_id::
+    #   Id of transaction
+    #
+    # == Returns:
+    #   List insatnce with account info and transactions list
+    #
+    # https://www.fio.cz/ib_api/rest/set-last-id/(token)/(id)/
+    def set_last_fetch_id(transaction_id)
+      fetch_and_deserialize_response('set-last-id', FioAPI.token, transaction_id)
+    end
+
+    # Allow request to set last request date
+    #
+    # == Parameters:
+    # date::
+    #   Date when last request was provided
+    #
+    # == Returns:
+    #   List insatnce with account info and transactions list
+    #
+    # https://www.fio.cz/ib_api/rest/set-last-date/(token)/(rrrr-mm-dd)/
+    def set_last_fetch_date(date)
+      fetch_and_deserialize_response('set-last-date', FioAPI.token, date)
+    end
+
+    private
+
+    # Create request object ot provided uri and instantiate list deserializer.
+    # Request uri and deserialize response to response object with account info and transactions list.
+    #
+    # == Parameters:
+    # args::
+    #   Parts of uri
+    #
+    # == Returns:
+    #   List insatnce with account info and transactions list
+    #
+    def fetch_and_deserialize_response(*args)
+      self.request = FioAPI::Request.new(deserializer: FioAPI::ListResponseDeserializer.new())
+      self.request.set_uri(*args)
+      self.request.fetch
+      self.response = self.request.response
+      self
+    end
+
+  end
+end

data/lib/base/request.rb

@@ -0,0 +1,71 @@
+require 'httparty'
+
+module FioAPI
+  class Request < FioAPI::Base
+    # Consant of base part of uri for requesting
+    BASE_URI = "https://www.fio.cz/ib_api/rest/"
+
+    class << self
+
+      # Reader for token
+      def token
+        @@token
+      end
+
+      # Setter for token
+      def token= token
+        @@token = token
+      end
+    end
+
+    attr_accessor :uri, :response_json, :deserializer
+
+    # Make request to uri
+    #
+    # == Returns:
+    #   Request instance
+    #
+    def fetch
+      self.response_json = HTTParty.get(uri)
+      self
+    end
+
+    # Set uri for request
+    #
+    # == Parameters:
+    # args::
+    #   Parts of uri
+    #
+    # == Returns:
+    #   Uri string
+    #
+    def set_uri(*args)
+      self.uri = construct_uri(*args)
+    end
+
+    # Reader for request response
+    #
+    # == Returns:
+    #   Response as a JSON or a deserialilzed response. Depends if the deserializer is set
+    #
+    def response
+      @response ||= deserializer ? deserializer.deserialize(response_json) : response_json
+    end
+
+    private
+
+    # Uri constructor
+    #
+    # == Parameters:
+    # args::
+    #   Parts of uri
+    #
+    # == Returns:
+    #   Uri string
+    #
+    def construct_uri(*args)
+      url_parts = args.map(&:to_s).join("/")
+      URI::join(BASE_URI, url_parts).to_s
+    end
+  end
+end

data/lib/base/transaction.rb

@@ -0,0 +1,8 @@
+module FioAPI
+  # == Transaction class representing the Transaction entity
+  class Transaction < FioAPI::Base
+    attr_accessor :transaction_id, :date, :amount, :currency, :account, :account_name, :bank_code,
+      :bank_name, :ks, :vs, :ss, :user_identification, :message_for_recipient, :transaction_type,
+      :sender, :detail_info, :comment, :bic, :action_id
+  end
+end

data/lib/base.rb

@@ -0,0 +1,20 @@
+module FioAPI
+  class Base
+    # Allow ruby object to be initialized with params
+    #
+    # == Parameters:
+    # hash::
+    #   Hash where key is attribute and value is new attribute value
+    #
+    # == Returns:
+    #   New object with prefilled attributes
+    #
+    def initialize(*h)
+      if h.length == 1 && h.first.kind_of?(Hash)
+        h.first.each { |k,v| send("#{k}=",v) }
+      end
+    end
+
+  end
+end
+

data/lib/fio_api.rb

@@ -0,0 +1,37 @@
+require "utils/hash"
+require "base"
+require "base/deserializer"
+require "base/account"
+require "base/transaction"
+require "base/list"
+require "base/request"
+
+module FioAPI
+  # == Returns:
+  # A string with current version of gem
+  #
+  VERSION = "0.0.1"
+
+  # Set API token for requests
+  #
+  # == Parameters:
+  # token::
+  #   Long string generated in Fio API banking application
+  #
+  # == Returns:
+  #   Token
+  #
+  def self.token= token
+    FioAPI::Request.token = token
+  end
+
+  # Get API token
+  #
+  # == Returns:
+  #   Token from gem configuration
+  #
+  def self.token
+    FioAPI::Request.token
+  end
+end
+

data/lib/utils/hash.rb

@@ -0,0 +1,22 @@
+class Hash
+  # Try provided path on hash
+  #
+  # == Parameters:
+  # args::
+  #   Keys of hash you want to try
+  #
+  # == Returns:
+  #   Value or nil if key does not exist
+  #
+  def try_path(*args)
+    value = self
+    args.each{ |arg_name| value = value.nil? ? nil : value[arg_name] }
+    value
+  end
+end
+
+class NilClass
+  def try_path(*args)
+    nil
+  end
+end

data/spec/base/account_spec.rb

@@ -0,0 +1,17 @@
+require_relative "../spec_helper"
+
+describe FioAPI::Account do
+
+  describe "instance attributes" do
+
+    [:account_id, :bank_id, :currency, :iban,:bic,:opening_balance,:closing_balance,
+    :date_start, :date_end, :year_list, :id_list, :id_from, :id_to, :id_last_download].each do |attr|
+
+      it "should respond to #{attr}" do
+        FioAPI::Account.new.should respond_to(attr)
+      end
+
+    end
+  end
+
+end

data/spec/base/deserializer_spec.rb

@@ -0,0 +1,12 @@
+require_relative "../spec_helper"
+
+describe FioAPI::Deserializer do
+
+  describe "deserialize" do
+
+    it "should raise exception" do
+      expect { FioAPI::Deserializer.new.deserialize }.to raise_error
+    end
+
+  end
+end

data/spec/base/deserializers/list_response_deserializer_spec.rb

@@ -0,0 +1,92 @@
+require_relative "../../spec_helper"
+
+describe FioAPI::ListResponseDeserializer do
+
+  describe "instance attributes" do
+
+    it "should respond to account" do
+      FioAPI::ListResponseDeserializer.new.should respond_to(:account)
+    end
+
+    it "should respond to transactions" do
+      FioAPI::ListResponseDeserializer.new.should respond_to(:transactions)
+    end
+
+  end
+
+  describe "deserialization" do
+    before(:each) do
+      @deserializer = FioAPI::ListResponseDeserializer.new
+    end
+
+    it "deserialize account info" do
+      account_json = { "accountId" => "26457567988", "bankId" => "2010", "currency" => "CZK",
+        "iban" => "CZ03345356456702600147988", "bic" => "FIOBCZPPXXX", "openingBalance" => 0.0, "closingBalance" => 11669.96,
+        "dateStart" => "2011-01-01+0100", "dateEnd" => "2012-12-26+0100", "yearList" => 2012, "idList" => 353434,
+        "idFrom" => 1145645683284, "idTo" => 1167566706, "idLastDownload" => 234234234234
+      }
+
+      result = { :account_id => "26457567988", :bank_id => "2010", :currency => "CZK", :iban => "CZ03345356456702600147988",
+        :bic => "FIOBCZPPXXX", :opening_balance => 0.0, :closing_balance => 11669.96, :date_start => "2011-01-01+0100",
+        :date_end => "2012-12-26+0100", :year_list => 2012, :id_list => 353434, :id_from => 1145645683284,
+        :id_to => 1167566706, :id_last_download => 234234234234 }
+
+      deserialized =  @deserializer.send(:deserialize_account, account_json)
+
+      result.each do |attr_name,value|
+        deserialized.send(attr_name).should eq(value)
+      end
+    end
+
+
+
+    it "deserialize transaction info" do
+      transaction_json = {
+        "column22" => { "value" => 1148734530, "name" => "ID pohybu", "id" => 22},
+        "column0" => { "value" => 1340661600000, "name" => "Datum", "id" => 0},
+        "column1" => { "value" => 1, "name" => "Objem", "id" => 1 },
+        "column14" => { "value" => "CZK", "name" => "Mena", "id" => 14 },
+        "column2" => { "value" => "2900233333", "name" => "Protiucet", "id" => 2 },
+        "column10" => { "value" => "Pavel, Novak", "name" => "Nazev protiuctu", "id" => 10},
+        "column3" => { "value" => "2010", "name" => "Kod banky", "id" => 3},
+        "column12" => { "value" => "Fio banka, a.s.", "name" => "Nazev banky", "id" => 12 },
+        "column4" => { "value" => "0558", "name" => "KS", "id" => 4 },
+        "column5" => { "value" => "0558345345345", "name" => "VS", "id" => 5 },
+        "column6" => { "value" => "055234", "name" => "SS", "id" => 6 },
+        "column7" => { "value" => "Prikaz", "name" => "Identifikace uzivatelem", "id" => 7 },
+        "column16" => { "value" => "Prikaz pro tomase", "name" => "Zprava pro prijemce", "id" => 16 },
+        "column8" => { "value" => "Prijem prevodem uvnitr banky", "name" => "Typ", "id" => 8 },
+        "column9" => { "value" => "Robin Bortlik", "name" => "Odesilatel", "id" => 9 },
+        "column18" => { "value" => "Detail info", "name" => "Detailni informace", "id" => 18 },
+        "column25" => { "value" => "Text", "name" => "Komentar", "id" => 25 },
+        "column26" => { "value" => "345790", "name" => "BIC", "id" => 26 },
+        "column17" => { "value" => 2105685816, "name" => "ID pokynu", "id" => 17}
+      }
+
+      result = {:date => 1340661600000, :amount => 1, :currency => "CZK", :account => "2900233333",
+        :account_name => "Pavel, Novak", :bank_code => "2010", :bank_name => "Fio banka, a.s.",
+        :ks => "0558", :vs => "0558345345345", :ss => "055234", :user_identification => "Prikaz",
+        :message_for_recipient => "Prikaz pro tomase", :transaction_type => "Prijem prevodem uvnitr banky",
+        :sender => "Robin Bortlik", :detail_info => "Detail info", :comment => "Text", :bic => "345790",
+        :action_id => 2105685816}
+
+      deserialized = @deserializer.send(:deserialize_transactions, [transaction_json])[0]
+
+      result.each do |attr_name,value|
+        deserialized.send(attr_name).should eq(value)
+      end
+    end
+
+    it "should return deserializer object with account and transactions" do
+      @deserializer.deserialize({"accountStatement" => {"transactionList" => {"transaction" => [{}] }}} )
+      @deserializer.account.class.should eq FioAPI::Account
+      @deserializer.transactions.class.should eq Array
+      @deserializer.transactions.first.class.should eq FioAPI::Transaction
+    end
+  end
+end
+
+
+
+
+

data/spec/base/list_spec.rb

@@ -0,0 +1,45 @@
+require_relative "../spec_helper"
+
+describe FioAPI::List do
+  before(:each) do
+    @list = FioAPI::List.new
+    HTTParty.stub(:get) { {response: "response"} }
+  end
+
+  it "should set request with uri for date range" do
+    date_from = Date.new(2011,1,1)
+    date_to = Date.new(2012,11,25)
+    url = "https://www.fio.cz/ib_api/rest/periods/#{FioAPI.token}/#{date_from}/#{date_to}/transactions.json"
+    @list.by_date_range(date_from, date_to).request.uri.should eq url
+  end
+
+  it "should set request with uri for listing_id and year" do
+    year = 2012
+    id = "12345"
+    url = "https://www.fio.cz/ib_api/rest/by-id/#{FioAPI.token}/#{year}/#{id}/transactions.json"
+    @list.by_listing_id_and_year(id, year).request.uri.should eq url
+  end
+
+  it "should set request with uri from last fetch" do
+    url = "https://www.fio.cz/ib_api/rest/last/#{FioAPI.token}/transactions.json"
+    @list.from_last_fetch.request.uri.should eq url
+  end
+
+  it "should set request with uri to set last fetch id" do
+    id = "12345"
+    url = "https://www.fio.cz/ib_api/rest/set-last-id/#{FioAPI.token}/#{id}"
+    @list.set_last_fetch_id(id).request.uri.should eq url
+  end
+
+  it "should set request with uri to set last date" do
+    date = Date.new(2012,11,25)
+    url = "https://www.fio.cz/ib_api/rest/set-last-date/#{FioAPI.token}/#{date}"
+    @list.set_last_fetch_date(date).request.uri.should eq url
+  end
+
+  it "should fetch and deserialize response" do
+    @list.send(:fetch_and_deserialize_response)
+    @list.request.should_not be_nil
+    @list.response.should_not be_nil
+  end
+end

data/spec/base/request_spec.rb

@@ -0,0 +1,54 @@
+require_relative "../spec_helper"
+
+describe FioAPI::Request do
+
+  it "should have defined token" do
+    FioAPI::Request.should respond_to :token
+  end
+
+  it "should have defined uri" do
+    FioAPI::Request.new.should respond_to :uri
+  end
+
+  it "should have defined response" do
+    FioAPI::Request.new.should respond_to :response
+  end
+
+  describe "fetch" do
+    before(:each) do
+      @response = {response: "response"}
+      HTTParty.stub(:get) { @response }
+    end
+
+    it "should fill the response" do
+      request = FioAPI::Request.new
+      request.fetch
+      request.response.should eq @response
+    end
+
+    it "should deserialize the response" do
+      deserializer = FioAPI::ListResponseDeserializer.new
+      request = FioAPI::Request.new(deserializer: deserializer)
+      request.fetch
+      request.response.should eq deserializer.deserialize(@response)
+    end
+  end
+
+  describe "uri manipulation" do
+    before(:each) do
+      FioAPI.token = "somelongtoken"
+      @url = "https://www.fio.cz/ib_api/rest/#{FioAPI.token}/transactions.json"
+      @request = FioAPI::Request.new
+    end
+
+    it "should construct uri from arguments" do
+      @request.send(:construct_uri, FioAPI.token, 'transactions.json').to_s.should eq @url
+    end
+
+    it "should set uri from arguments" do
+      @request.set_uri FioAPI.token, 'transactions.json'
+      @request.uri.should eq @url
+    end
+
+  end
+end

data/spec/base/transaction_spec.rb

@@ -0,0 +1,18 @@
+require_relative "../spec_helper"
+
+describe FioAPI::Transaction do
+
+  describe "instance attributes" do
+
+    [:transaction_id, :date, :amount, :currency, :account, :account_name, :bank_code,
+    :bank_name, :ks, :vs, :ss, :user_identification, :message_for_recipient, :transaction_type,
+    :sender, :detail_info, :comment, :bic, :action_id].each do |attr|
+
+      it "should respond to #{attr}" do
+        FioAPI::Transaction.new.should respond_to(attr)
+      end
+
+    end
+  end
+
+end

data/spec/fio_api_spec.rb

@@ -0,0 +1,18 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe FioAPI do
+  it "should setup token" do
+    token = "some token"
+    FioAPI.token = token
+    FioAPI::Request.token.should eq token
+  end
+
+  it "should return token" do
+    token = "some token"
+    FioAPI::Request.token = token
+    FioAPI.token.should eq token
+  end
+end
+
+
+

data/spec/spec_helper.rb

@@ -0,0 +1,14 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'rspec'
+require 'fio_api'
+
+# Requires supporting files with custom matchers and macros, etc,
+# in ./support/ and its subdirectories.
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each {|f| require f}
+
+FioAPI.token = "somelongtoken"
+
+RSpec.configure do |config|
+
+end

data/spec/utils/hash_spec.rb

@@ -0,0 +1,34 @@
+require_relative "../spec_helper"
+
+describe Hash do
+
+  describe "try_path" do
+
+    it "should respond to try_path method" do
+      {}.should respond_to(:try_path)
+    end
+
+    it "should return nil if can't find key" do
+      {}.try_path("key1", "key2").should be_nil
+    end
+
+    it "should return value on path" do
+      {"key1" => {"key2" => "value"} }.try_path("key1", "key2").should eq "value"
+    end
+  end
+end
+
+describe NilClass do
+
+  describe "try_path" do
+
+    it "should respond to try_path method" do
+      nil.should respond_to(:try_path)
+    end
+
+    it "should return nil" do
+      nil.try_path("key1", "key2").should be_nil
+    end
+
+  end
+end

metadata

@@ -0,0 +1,172 @@
+--- !ruby/object:Gem::Specification
+name: fio_api
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Robin Bortlik
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-06 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: httparty
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 0.9.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.8.0
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.4
+description: API wrapper for FIO bank
+email: robinbortlik@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .rspec
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- fio_api.gemspec
+- lib/base.rb
+- lib/base/account.rb
+- lib/base/deserializer.rb
+- lib/base/deserializers/list_response_deserializer.rb
+- lib/base/list.rb
+- lib/base/request.rb
+- lib/base/transaction.rb
+- lib/fio_api.rb
+- lib/utils/hash.rb
+- spec/base/account_spec.rb
+- spec/base/deserializer_spec.rb
+- spec/base/deserializers/list_response_deserializer_spec.rb
+- spec/base/list_spec.rb
+- spec/base/request_spec.rb
+- spec/base/transaction_spec.rb
+- spec/fio_api_spec.rb
+- spec/spec_helper.rb
+- spec/utils/hash_spec.rb
+homepage: http://github.com/robinbortlik/fio_api
+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: -4192978993207160883
+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: API wrapper for FIO bank
+test_files: []