rus_bank 0.9.2 → 0.9.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: a2e4b1b1b3a44dcf55f20c1254df58d31ece8b51
-  data.tar.gz: 4222463c5f0e73c34d9eee2e5cda7dcefcc52d47
+  metadata.gz: 6c9026cfb216253a37a33cfc069e1a1efaf4f15c
+  data.tar.gz: eef376473f7cd04e43af493fde4d3b2fd0f04028
 SHA512:
-  metadata.gz: a0bde6114b27a298950202d0989572f04ceb90181ccb1b362e120d9ae97ae997b7394770412ee8499f1150101b77150fed9dcedcf83d5b5a5e8cb83cf0c0b14d
-  data.tar.gz: 7eb189c2bc9d62a780713ad059b1e37c56c6a1e968113f2fca577c3acb049c419a263be22d5ffc1998e70bb213af1461b5ff0c0b346315acd89c41c08314bd80
+  metadata.gz: ea3d9419ea6c3c3b4896437607d29ca204ad44f2773968e5c56eef085bcc90b344cb7e13d0390be33b539441ea8c6c245375fad51d9dc3daa80b3cb707448a9b
+  data.tar.gz: 2e715a8932508af962134f9b0fec7b485f5f5f44563c93564ab5076d7534638ef972e4bc1cb05b1ce7d34d93e4805cf03b0185983f21acde053c00d0559ed3ce

data/README.rdoc

@@ -1,16 +1,38 @@
 = rus_bank
 
-Description goes here.
-
-== Contributing to rus_bank
- 
-* 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.
+Руби-интерфейс к API Банка России.
+
+Установка
+```
+$ gem install rus_bank
+```
+Либо добавить в gemfile
+```
+gem 'rus_bank'
+```
+
+Пример использования
+```
+require 'rus_bank'
+
+bank = RusBank.new
+bank.BicToIntCode(:your_bic)
+```
+Описание доступных методов тут - http://rubydoc.info/gems/rus_bank/RusBank
+Можно вызывать не реализованные в геме методы
+```
+require 'rus_bank'
+
+bank = RusBank.new
+bank.operations # Список доступных для вызова методов, включая не реализованные и те, что могут появиться на момент вызова.
+bank.call(:method, :params) # где :method - нужный метод, :params - хеш передаваемых методу параметров.
+```
+
+Надо сказать, что при каждом вызове метода гема 'дергается' внешний сервис. Это не лучший подход с точки зрения производительности,
+траффика и вообще ЦБ просит так не поступать. Было бы логичным иметь локальную базу для кеширования получаемой информации и
+обращаться к внешнему сервису только по мере необходимости.
+Гем, реализующий данную функцию для Rails - https://github.com/wildDAlex/rus_bank_rails
+
 
 == Copyright
 

data/Rakefile

@@ -19,7 +19,7 @@ Jeweler::Tasks.new do |gem|
   gem.license = "MIT"
   gem.summary = "Ruby-интерфейс для получения информации по российским банкам"
   gem.description = "Набор ruby-методов для работы с сервисами ЦБ РФ"
-  gem.email = "some@wild-x.ru"
+  gem.email = "wilddalex@wild-x.ru"
   gem.authors = ["wilDAlex"]
   # dependencies defined in Gemfile
 end

data/VERSION

@@ -1 +1 @@
-0.9.2
+0.9.3

data/lib/rus_bank.rb

@@ -6,64 +6,100 @@ class RusBank
     @client = Savon.client(wsdl: "http://www.cbr.ru/CreditInfoWebServ/CreditOrgInfo.asmx?WSDL")
   end
 
+  ##
+  # Возвращает полный список доступных для метода call методов
+
   def operations
     @client.operations
   end
 
+  ##
+  # Возвращает внутренний код банка по БИК
+
   def BicToIntCode(bic)
     params = { "BicCode" => bic }
     call(:bic_to_int_code, params)
   end
 
+  ##
+  # Возвращает регистрационный номер банка по БИК
+
   def BicToRegNumber(bic)
     params = { "BicCode" => bic }
     call(:bic_to_reg_number, params)
   end
 
+  ##
+  # Возвращает внутренний код банка по регистрационному номеру
+
   def RegNumToIntCode(reg_num)
     params = { "RegNumber" => reg_num }
     call(:reg_num_to_int_code, params)
   end
 
+  ##
+  # Возвращает регистрационный номер по внутреннему номеру
+
   def IntCodeToRegNum(int_code)
     params = { "IntNumber" => int_code }
     call(:int_code_to_reg_num, params)
   end
 
+  ##
+  # Список банков по коду региона
+
   def SearchByRegionCode(region_code)
     params = { "RegCode" => region_code }
     response = call(:search_by_region_code_xml, params)
     get_array(response, :credit_org, :enum_credits)
   end
 
+  ##
+  # Поиск по названию банка
+
   def SearchByName(bank_name)    # Метод возвращает nil, либо массив хэшей
     params = { "NamePart" => bank_name }
     response = call(:search_by_name_xml, params)
     get_array(response, :credit_org, :enum_credits)
   end
 
+  ##
+  # Возвращает список отделений по внутреннему номеру банка
+
   def GetOffices(int_code)
     params = { "IntCode" => int_code }
     response = call(:get_offices_xml, params)
     get_array(response, :co_offices, :offices)
   end
 
+  ##
+  # Список филиалов в указанном регионе
+
   def GetOfficesByRegion(region_code)
     params = { "RegCode" => region_code }
     response = call(:get_offices_by_region_xml, params)
     get_array(response, :co_offices, :offices)
   end
 
+  ##
+  # Полный список банков
+
   def EnumBic
     response = call(:enum_bic_xml)
     get_array(response, :enum_bic, :bic)
   end
 
+  ##
+  # Список регионов
+
   def RegionsEnum
     response = call(:regions_enum_xml)
     get_array(response, :regions_enum, :rgid)
   end
 
+  ##
+  # Информация по кредитной организации по внутреннему номеру
+
   def CreditInfoByIntCode(internal_code)
     params = { "InternalCode" => internal_code }
     response = call(:credit_info_by_int_code_xml, params)
@@ -74,6 +110,9 @@ class RusBank
     end
   end
 
+  ##
+  # Метод позволяет вручную вызывать нужные soap-сервисы.
+
   def call(method, params = nil)
     response = @client.call(method, message: params).to_hash[(method.to_s + "_response").to_sym][(method.to_s + "_result").to_sym]
     if response == "-1" or response.to_s.include?("NotFound")           # Разные методы сервиса возвращают ответ в разном формате

data/rus_bank.gemspec

@@ -5,13 +5,13 @@
 
 Gem::Specification.new do |s|
   s.name = "rus_bank"
-  s.version = "0.9.2"
+  s.version = "0.9.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["wilDAlex"]
-  s.date = "2014-01-29"
+  s.date = "2014-02-02"
   s.description = "\u{41d}\u{430}\u{431}\u{43e}\u{440} ruby-\u{43c}\u{435}\u{442}\u{43e}\u{434}\u{43e}\u{432} \u{434}\u{43b}\u{44f} \u{440}\u{430}\u{431}\u{43e}\u{442}\u{44b} \u{441} \u{441}\u{435}\u{440}\u{432}\u{438}\u{441}\u{430}\u{43c}\u{438} \u{426}\u{411} \u{420}\u{424}"
-  s.email = "some@wild-x.ru"
+  s.email = "wilddalex@wild-x.ru"
   s.extra_rdoc_files = [
     "LICENSE.txt",
     "README.rdoc"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rus_bank
 version: !ruby/object:Gem::Version
-  version: 0.9.2
+  version: 0.9.3
 platform: ruby
 authors:
 - wilDAlex
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-01-29 00:00:00.000000000 Z
+date: 2014-02-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: savon
@@ -81,7 +81,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 1.8.7
 description: Набор ruby-методов для работы с сервисами ЦБ РФ
-email: some@wild-x.ru
+email: wilddalex@wild-x.ru
 executables: []
 extensions: []
 extra_rdoc_files: