faker-russian 0.0.3 → 0.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1bd6b02cf4fb74d25527c82848ab0be7cdb3163d
-  data.tar.gz: 15260a247c047573f436ed18b9cc2b9e5d3ccc8b
+  metadata.gz: c75ff98fcf23e6ff7fc3cff318b5e3f917625140
+  data.tar.gz: 54c4850dc5dbabe72010989099dc61cc4a74442f
 SHA512:
-  metadata.gz: 2e0bcd450e84d772ffdad90cc91f01cabe1880d37558773e367ec2f08e39be659ca7c578cf21e6f839436c4519ed008314a8923c1a83e877556e8101e4ea8cda
-  data.tar.gz: d5fcd5308a1107a679ffc6790379c66b0f719a99aeb598cd4619a469b56986637f58b4b5fbf760b255b7c6e93219bb04ed8504e208bb9c205d424fd783baa6e2
+  metadata.gz: ef843251ab1698458ae897c03db5cc12cc43fbb401f6de4d97f8f5ba57c6eaa00ede94377ee12428aaf116b9bb0e05ee10c9715c0c45eee8c84f66f6840353f2
+  data.tar.gz: 95d78319cf1e70befc018d76ef0ed872497bde0ce2147162893223c1e380891754535e225fb48cbac12f6361e3c8d4d377b10e82ba93be4c1508f34dcd2a7b27

data/CHANGELOG.md

@@ -1,3 +1,8 @@
+# 0.0.4
+
+* Bik faker added
+* Okato faker added
+
 # 0.0.3
 
 * Okpo faker added

data/README.md

@@ -8,13 +8,14 @@
 
 Генерация русских значений: ИНН, ОКПО, КПП и т.д.
 
+* [БИК](http://ru.wikipedia.org/wiki/Банковский_идентификационный_код) (Faker::Russian.bik)
 * [ИНН](http://ru.wikipedia.org/wiki/Идентификационный_номер_налогоплательщика) (Faker::Russian.inn)
 * [ОКПО](http://ru.wikipedia.org/wiki/Общероссийский_классификатор_предприятий_и_организаций) (Faker::Russian.okpo)
 * [КПП](http://ru.wikipedia.org/wiki/Код_причины_постановки_на_учёт) (Faker::Russian.kpp)
 * (TODO) [ОГРН](http://ru.wikipedia.org/wiki/Основной_государственный_регистрационный_номер) (Faker::Russian.ogrn)
 * (TODO) [Корреспондентский счёт] (http://ru.wikipedia.org/wiki/Корреспондентский_счёт) (Faker::Russian.ks)
 * (TODO) [Рассчётный счёт] (http://ru.wikipedia.org/wiki/Расчётный_счёт) (Faker::Russian.rs)
-* (TODO) [OKATO](http://ru.wikipedia.org/wiki/Общероссийский_классификатор_объектов_административно-территориального_деления) (Faker::Russian.okato)
+* [OKATO](http://ru.wikipedia.org/wiki/Общероссийский_классификатор_объектов_административно-территориального_деления) (Faker::Russian.okato)
 * (TODO) [СНИЛС](http://ru.wikipedia.org/wiki/Страховой_номер_индивидуального_лицевого_счёта) (Faker::Russian.snils)
 * (TODO) [Значение паспорта](http://ru.wikipedia.org/wiki/Паспорт_гражданина_Российской_Федерации) (Faker::Russian.passport)
 
@@ -28,6 +29,27 @@
 
 ## Использование
 
+### БИК
+
+По умолчанию генерирует БИК со случайным номером региона по ОКАТО
+
+``` ruby
+  Faker::Russian.bik # => '0454954616'
+```
+
+Можно указывать номер региона по ОКАТО
+
+``` ruby
+  Faker::Russian.bik(okato_region_number: '40') # => '0440754281'
+```
+
+Также существуют последовательности, позволяющие получать псевдослучайные БИКи
+
+``` ruby
+  Faker::Russian.bik(sequence_number: 1) # => '0451491755'
+  Faker::Russian.bik(sequence_number: 1) # => '0451491755'
+```
+
 ### ИНН
 
 Стандартно генерирует ИНН со случайным номером региона и со случайным типом (физ или юрлицо)
@@ -83,7 +105,36 @@
 
 ``` ruby
   Faker::Russian.kpp(sequence_number: 1) # => '381201001'
-  Faker::Russian.inn(sequence_number: 1) # => '381201001'
+  Faker::Russian.kpp(sequence_number: 1) # => '381201001'
+```
+
+### ОКАТО
+
+Генерирует ОКАТО со случайным номером региона и случайной длиной
+
+``` ruby
+  Faker::Russian.okato # => '849012471'
+```
+
+Можно указать регион по классификации окато
+
+``` ruby
+  Faker::Russian.okato(okato_region_number: 25) # => '251'
+```
+
+Можно указать длину ОКАТО:
+
+``` ruby
+  Faker::Russian.okato(length: 3) # => '251'
+  Faker::Russian.okato(length: 6) # => '443758'
+  Faker::Russian.okato(length: 9) # => '849012471'
+```
+
+Также можно использовать последовательности:
+
+``` ruby
+  Faker::Russian.okato(sequence_number: 1) # => '517'
+  Faker::Russian.okato(sequence_number: 1) # => '517'
 ```
 
 ## Инструкции разработчикам

data/doc/english_readme.md

@@ -8,13 +8,14 @@
 
 Generation of specific russian values
 
+* [BIK](http://ru.wikipedia.org/wiki/Банковский_идентификационный_код) (Faker::Russian.bik) Russian bank identification number
 * [INN](http://ru.wikipedia.org/wiki/Идентификационный_номер_налогоплательщика) (Faker::Russian.inn) Russian analogue of VAT identification number
 * [OKPO](http://ru.wikipedia.org/wiki/Общероссийский_классификатор_предприятий_и_организаций) (Faker::Russian.okpo) Legal code
 * [KPP](http://ru.wikipedia.org/wiki/Код_причины_постановки_на_учёт) (Faker::Russian.kpp) Code of reason for registration
 * (TODO) [OGRN](http://ru.wikipedia.org/wiki/Основной_государственный_регистрационный_номер) (Faker::Russian.ogrn) Main state registration number
 * (TODO) [Correspondent Account Value] (http://ru.wikipedia.org/wiki/Корреспондентский_счёт) (Faker::Russian.ks)
 * (TODO) [Bank account value] (http://ru.wikipedia.org/wiki/Расчётный_счёт) (Faker::Russian.rs)
-* (TODO) [OKATO](http://ru.wikipedia.org/wiki/Общероссийский_классификатор_объектов_административно-территориального_деления) (Faker::Russian.okato)
+* [OKATO](http://ru.wikipedia.org/wiki/Общероссийский_классификатор_объектов_административно-территориального_деления) (Faker::Russian.okato)
 * (TODO) [SNILS](http://ru.wikipedia.org/wiki/Страховой_номер_индивидуального_лицевого_счёта) (Faker::Russian.snils)
 * (TODO) [Passport value](http://ru.wikipedia.org/wiki/Паспорт_гражданина_Российской_Федерации) (Faker::Russian.passport)
 
@@ -28,6 +29,27 @@ Add to Gemfile
 
 ## Usage
 
+### Bik
+
+Generates bank identification number with random okato region number
+
+``` ruby
+  Faker::Russian.bik # => '0454954616'
+```
+
+You can pass okato region number
+
+``` ruby
+  Faker::Russian.bik(okato_region_number: '40') # => '0440754281'
+```
+
+Also you can use sequences for pseudo-random Bik's
+
+``` ruby
+  Faker::Russian.bik(sequence_number: 1) # => '0451491755'
+  Faker::Russian.bik(sequence_number: 1) # => '0451491755'
+```
+
 ### INN
 
 Generate INN with random region number and type (:individual or :legal)
@@ -85,6 +107,35 @@ Also, you can use pseudo random sequence numbers (not much 1000, there is limite
   Faker::Russian.inn(sequence_number: 1) # => '381201001'
 ```
 
+### ОКАТО
+
+Generates okato with random okato region number and random length
+
+``` ruby
+  Faker::Russian.okato # => '849012471'
+```
+
+You can select okato region number
+
+``` ruby
+  Faker::Russian.okato(okato_region_number: 25) # => '251'
+```
+
+You can select okato region length:
+
+``` ruby
+  Faker::Russian.okato(length: 3) # => '251'
+  Faker::Russian.okato(length: 6) # => '443758'
+  Faker::Russian.okato(length: 9) # => '849012471'
+```
+
+You can use sequences
+
+``` ruby
+  Faker::Russian.okato(sequence_number: 1) # => '517'
+  Faker::Russian.okato(sequence_number: 1) # => '517'
+```
+
 ## Contributing
 
 Please read [CONTRIBUTING.md](../CONTRIBUTING.md) in Russian

data/lib/faker/russian/bik.rb

@@ -0,0 +1,15 @@
+module Faker
+  module Russian
+    module Bik
+      def bik(options = {})
+        options.assert_valid_keys(:sequence_number, :okato_region_number)
+
+        sequence = find_sequence(options[:sequence_number])
+        okato_region_number = find_okato_region_number(options[:okato_region_number], sequence)
+
+        '04' + okato_region_number + sprintf("%06d", sequence.rand(1_000_000))
+      end
+
+    end
+  end
+end

data/lib/faker/russian/constants.rb

@@ -13,6 +13,20 @@ module Faker
           region_numbers[sequence.rand(region_numbers.size)]
         end
       end
+
+      OKATO_REGION_NUMBERS = %w{01 03 04 05 07 08 11 12 14 15 17 19 20 22 24 25 26 27 28 29 32 33 34 36 37 38 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99}
+
+      def find_okato_region_number(number = nil, sequence)
+        region_numbers = Faker::Russian::Constants::OKATO_REGION_NUMBERS
+
+        if number.present?
+          raise('there is no okato region with that number!') unless region_numbers.include?(number.to_s)
+          number.to_s
+        else
+          region_numbers[sequence.rand(region_numbers.size)]
+        end
+      end
+
     end
   end
 end

data/lib/faker/russian/inn.rb

@@ -2,9 +2,7 @@ module Faker
   module Russian
     module Inn
       def inn(options = {})
-        if (options.keys - [:sequence_number, :region_number, :kind]).any?
-          raise 'wrong options. just :kind, :region_number or :sequence_number'
-        end
+        options.assert_valid_keys(:sequence_number, :region_number, :kind)
 
         sequence = find_sequence(options[:sequence_number])
         region_number = find_region_number(options[:region_number], sequence)
@@ -31,13 +29,13 @@ module Faker
 
       def check_digit(digits)
         if digits.length == 9
-          calc(P10, digits)
+          calc_inn(P10, digits)
         else
-          calc(P11, digits) + calc(P12, digits + calc(P11, digits))
+          calc_inn(P11, digits) + calc_inn(P12, digits + calc_inn(P11, digits))
         end
       end
 
-      def calc(p, inn)
+      def calc_inn(p, inn)
         (p.each_with_index.inject(0){ |s, p| s + p[0] * inn[p[1]].to_i } % 11 % 10).to_s
       end
 

data/lib/faker/russian/kpp.rb

@@ -2,9 +2,7 @@ module Faker
   module Russian
     module Kpp
       def kpp(options = {})
-        if (options.keys - [:sequence_number, :region_number]).any?
-          raise 'wrong options. just :region_number or :sequence_number'
-        end
+        options.assert_valid_keys(:sequence_number, :region_number)
 
         sequence = find_sequence(options[:sequence_number])
         region_number = find_region_number(options[:region_number], sequence)

data/lib/faker/russian/okato.rb

@@ -0,0 +1,35 @@
+module Faker
+  module Russian
+    module Okato
+      def okato(options = {})
+        options.assert_valid_keys(:sequence_number, :okato_region_number, :length)
+
+        sequence = find_sequence(options[:sequence_number])
+        okato_region_number = find_okato_region_number(options[:okato_region_number], sequence)
+        okato_without_calc = okato_region_number + find_length_digits(options[:length], sequence)
+        okato_without_calc + calc_okato(okato_without_calc)
+      end
+
+    private
+
+      def find_length_digits(length, sequence)
+        if length.present?
+          raise 'no such length for okato' unless %w{3 6 9}.include?(length.to_s)
+        else
+          length = [3, 6, 9][sequence.rand(3)]
+        end
+
+        sprintf("%06d", sequence.rand(1_000_000)).split(//).first(length.to_i - 3).join
+      end
+
+      def calc_okato(okato_without_calc)
+        ((calc_okato_digit(okato_without_calc, 1) < 10) ? calc_okato_digit(okato_without_calc, 1) : calc_okato_digit(okato_without_calc, 3) % 10).to_s
+      end
+
+      def calc_okato_digit(okato_without_calc, adding_number)
+        okato_without_calc.split(//).map(&:to_i).each_with_index.inject(0){ |s, p| s + p[0] * (p[1] + adding_number) } % 11
+      end
+
+    end
+  end
+end

data/lib/faker/russian/okpo.rb

@@ -2,9 +2,7 @@ module Faker
   module Russian
     module Okpo
       def okpo(options = {})
-        if (options.keys - [:sequence_number]).any?
-          raise 'wrong options. just :sequence_number'
-        end
+        options.assert_valid_keys(:sequence_number)
 
         sequence = find_sequence(options[:sequence_number])
         okpo_digits = okpo_region_numbers(sequence)

data/lib/faker/russian/version.rb

@@ -1,7 +1,7 @@
 module Faker
   module Russian
     module Version
-      VERSION = '0.0.3'
+      VERSION = '0.0.4'
 
       def version
         VERSION

data/lib/faker/russian.rb

@@ -6,8 +6,10 @@ module Faker
     extend Sequence
     extend Version
 
+    extend Bik
     extend Inn
     extend Kpp
+    extend Okato
     extend Okpo
   end
 end

data/spec/faker/russian/bik_spec.rb

@@ -0,0 +1,42 @@
+require 'spec_helper'
+
+describe Faker::Russian do
+  describe '#bik' do
+    before(:all) do
+      DummyModel.reset_callbacks(:validate)
+      DummyModel.validates(:field, bik_format: true)
+    end
+
+    it 'generate valid bik without arguments' do
+      100.times do
+        expect(DummyModel.new(field: Faker::Russian.bik)).to be_valid
+      end
+    end
+
+    it 'generate valid bik with okato region number' do
+      100.times do
+        expect(DummyModel.new(field: Faker::Russian.bik(okato_region_number: 78))).to be_valid
+      end
+    end
+
+    it 'generate difference biks with sequence' do
+      sequenced_biks = 1000.times.map{ |n| Faker::Russian.bik(sequence_number: n) }
+      expect(sequenced_biks.size).to eq(sequenced_biks.uniq.size)
+    end
+
+    it 'generate same biks for sequence' do
+      array1 = 1000.times.map{ |n| Faker::Russian.bik(sequence_number: n) }
+      array2 = 1000.times.map{ |n| Faker::Russian.bik(sequence_number: n) }
+      expect(array1).to eq(array2)
+    end
+
+    it 'permit just a few options' do
+      expect{ Faker::Russian.bik(shit: 'shit') }.to raise_error(ArgumentError)
+    end
+
+    it 'raise when selecting invalid okato region' do
+      expect{ Faker::Russian.bik(okato_region_number: '02') }.to raise_error
+    end
+
+  end
+end

data/spec/faker/russian/inn_spec.rb

@@ -49,7 +49,7 @@ describe Faker::Russian do
     end
 
     it 'permit just a few options' do
-      expect { Faker::Russian.inn(shit: 'shit') }.to raise_error
+      expect { Faker::Russian.inn(shit: 'shit') }.to raise_error(ArgumentError)
     end
 
     it 'raise when selecting invalid region' do

data/spec/faker/russian/kpp_spec.rb

@@ -31,7 +31,7 @@ describe Faker::Russian do
     end
 
     it 'permit just a few options' do
-      expect{ Faker::Russian.kpp(shit: 'shit') }.to raise_error
+      expect{ Faker::Russian.kpp(shit: 'shit') }.to raise_error(ArgumentError)
     end
 
     it 'raise when selecting invalid region' do

data/spec/faker/russian/okato_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+
+describe Faker::Russian do
+  describe '#okato' do
+    before(:all) do
+      DummyModel.reset_callbacks(:validate)
+      DummyModel.validates(:field, okato_format: true)
+    end
+
+    it 'generate valid okato without arguments' do
+      100.times do
+        expect(DummyModel.new(field: Faker::Russian.okato)).to be_valid
+      end
+    end
+
+    it 'generate valid okato with okato region number' do
+      100.times do
+        expect(DummyModel.new(field: Faker::Russian.okato(okato_region_number: 78))).to be_valid
+      end
+    end
+
+    it 'generate difference okatos with sequence' do
+      sequenced_okatos = 1000.times.map{ |n| Faker::Russian.okato(sequence_number: n, length: 9) }
+      expect(sequenced_okatos.size).to eq(sequenced_okatos.uniq.size)
+    end
+
+    it 'generate same okatos for sequence' do
+      array1 = 1000.times.map{ |n| Faker::Russian.okato(sequence_number: n) }
+      array2 = 1000.times.map{ |n| Faker::Russian.okato(sequence_number: n) }
+      expect(array1).to eq(array2)
+    end
+
+    it 'allow just 3,6,9 length' do
+      [3,6,9].each { |n| expect{Faker::Russian.okato(length: n)}.to_not raise_error }
+      [1,4,5].each { |n| expect{Faker::Russian.okato(length: n)}.to raise_error }
+    end
+
+    it 'permit just a few options' do
+      expect{ Faker::Russian.okato(shit: 'shit') }.to raise_error(ArgumentError)
+    end
+
+    it 'raise when selecting invalid okato region' do
+      expect{ Faker::Russian.okato(okato_region_number: '02') }.to raise_error
+    end
+
+  end
+end

data/spec/faker/russian/okpo_spec.rb

@@ -25,7 +25,7 @@ describe Faker::Russian do
     end
 
     it 'permit just a few options' do
-      expect{ Faker::Russian.okpo(shit: 'shit') }.to raise_error
+      expect{ Faker::Russian.okpo(shit: 'shit') }.to raise_error(ArgumentError)
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: faker-russian
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
 platform: ruby
 authors:
 - Alex
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-07-04 00:00:00.000000000 Z
+date: 2014-07-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -98,14 +98,18 @@ files:
 - doc/english_readme.md
 - faker-russian.gemspec
 - lib/faker/russian.rb
+- lib/faker/russian/bik.rb
 - lib/faker/russian/constants.rb
 - lib/faker/russian/inn.rb
 - lib/faker/russian/kpp.rb
+- lib/faker/russian/okato.rb
 - lib/faker/russian/okpo.rb
 - lib/faker/russian/sequence.rb
 - lib/faker/russian/version.rb
+- spec/faker/russian/bik_spec.rb
 - spec/faker/russian/inn_spec.rb
 - spec/faker/russian/kpp_spec.rb
+- spec/faker/russian/okato_spec.rb
 - spec/faker/russian/okpo_spec.rb
 - spec/spec_helper.rb
 - spec/support/dummy_model.rb
@@ -134,8 +138,10 @@ signing_key:
 specification_version: 4
 summary: Faker russian specific values. INN, OGRN, et.c.
 test_files:
+- spec/faker/russian/bik_spec.rb
 - spec/faker/russian/inn_spec.rb
 - spec/faker/russian/kpp_spec.rb
+- spec/faker/russian/okato_spec.rb
 - spec/faker/russian/okpo_spec.rb
 - spec/spec_helper.rb
 - spec/support/dummy_model.rb