faker-russian 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: caca7826229f279011ba6ffe24434bfacc18a491
-  data.tar.gz: 7826be21d07d8fffcf22afddc13283d580353c30
+  metadata.gz: 555645ea6b04286daa9446b352fe7f1566a560c3
+  data.tar.gz: e1c06a0eacb4de35f7257b99cd722c0c81eb7ee8
 SHA512:
-  metadata.gz: 442d8253bf1f2c53012e5fb48ed4234ae1e7679890ed75c5fe9201695f5e8c33d8bef03131d55266741c64ae7df8f68136f7082c6a84051ab20210ef636a360c
-  data.tar.gz: f2d163e3acbddeb92d155e0dd7dfd66a662c256a07e8c2c8367b5eb47644938c506853ffea6d3ed1dbc2f7145fe0a208834c7026414ea9783afd3d60004247d3
+  metadata.gz: 931aa64d63425363848cc0600e5315fc6e029991ada16bb681e805272697079b8a2f14f38dc50db089ecf57523632df5269ebe4778102100f7d3af61d2e81e35
+  data.tar.gz: e5f0ec94da0ff210f8d5cb5098004c69d87321b4a7f98f28ccd60959d2b21c05bd8730c949324bc707f580cc37c8ce3147e5d68db15c5a098ad8b001d3c087cd

data/.gitignore

@@ -7,7 +7,6 @@ Gemfile.lock
 InstalledFiles
 _yardoc
 coverage
-doc/
 lib/bundler/man
 pkg
 rdoc

data/.travis.yml

@@ -0,0 +1,6 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0
+script: bundle exec rspec spec

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# 0.0.2
+
+* Kpp faker added
+* Inn faker kinds fixed
+
+# 0.0.1
+
+* Inn faker added

data/README.md

@@ -1,24 +1,75 @@
 # Faker::Russian
 
-TODO: Write a gem description
+[[english_doc](doc/english_readme.md)]
+[![Gem Version](https://badge.fury.io/rb/faker-russian.svg)](http://badge.fury.io/rb/faker-russian)
+[![Build Status](https://travis-ci.org/asiniy/faker-russian.svg?branch=master)](https://travis-ci.org/asiniy/faker-russian)
+[![Code Climate](https://codeclimate.com/github/asiniy/faker-russian.png)](https://codeclimate.com/github/asiniy/faker-russian)
 
-## Installation
+Генерация русских значений: ИНН, ОКПО, КПП и т.д.
 
-Add this line to your application's Gemfile:
+* [ИНН](http://ru.wikipedia.org/wiki/Идентификационный_номер_налогоплательщика) (Faker::Russian.inn)
+* (TODO) [ОКПО](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)
+* (TODO) [СНИЛС](http://ru.wikipedia.org/wiki/Страховой_номер_индивидуального_лицевого_счёта) (Faker::Russian.snils)
+* (TODO) [Значение паспорта](http://ru.wikipedia.org/wiki/Паспорт_гражданина_Российской_Федерации) (Faker::Russian.passport)
+
+Для проверки сгенерированных значений можешь использовать [gem 'validates_russian'](https://github.com/asiniy/validates_russian)
+
+## Установка
+
+Добавь в Gemfile
 
     gem 'faker-russian'
 
-And then execute:
+## Использование
+
+### ИНН
+
+Стандартно генерирует ИНН со случайным номером региона и со случайным типом (физ или юрлицо)
+
+``` ruby
+  Faker::Russian.inn # => '183501166447'
+```
+
+Можно указывать номер региона или тип
+
+``` ruby
+  Faker::Russian.inn(region_number: '78') # => '7857296996'
+  Faker::Russian.inn(kind: :individual) # => '0229191612'
+  Faker::Russian.inn(kind: :legal) # => '366582211439'
+```
+
+Также существуют последовательности, позволяющие получать одни и те же значения
+
+``` ruby
+  Faker::Russian.inn(sequence_number: 1) # => '0956860593'
+  Faker::Russian.inn(sequence_number: 1) # => '0956860593'
+```
+
+### КПП
+
+Генерирует КПП со случайным номером региона
 
-    $ bundle
+``` ruby
+  Faker::Russian.kpp # => '525601001'
+```
 
-Or install it yourself as:
+Можно указать регион
 
-    $ gem install faker-russian
+``` ruby
+  Faker::Russian.kpp(region_number: 78) # => '784101001'
+```
 
-## Usage
+Также можно использовать последовательности (не более 1000 - количество КПП ограничено):
 
-TODO: Write usage instructions here
+``` ruby
+  Faker::Russian.kpp(sequence_number: 1) # => '381201001'
+  Faker::Russian.inn(sequence_number: 1) # => '381201001'
+```
 
 ## Contributing
 

data/doc/english_readme.md

@@ -0,0 +1,80 @@
+# Faker::Russian
+
+[[по-русски](../README.md)]
+[![Gem Version](https://badge.fury.io/rb/faker-russian.svg)](http://badge.fury.io/rb/faker-russian)
+[![Build Status](https://travis-ci.org/asiniy/faker-russian.svg?branch=master)](https://travis-ci.org/asiniy/faker-russian)
+[![Code Climate](https://codeclimate.com/github/asiniy/faker-russian.png)](https://codeclimate.com/github/asiniy/faker-russian)
+
+Generation of specific russian values
+
+* [INN](http://ru.wikipedia.org/wiki/Идентификационный_номер_налогоплательщика) (Faker::Russian.inn) Russian analogue of VAT identification number
+* (TODO) [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)
+* (TODO) [SNILS](http://ru.wikipedia.org/wiki/Страховой_номер_индивидуального_лицевого_счёта) (Faker::Russian.snils)
+* (TODO) [Passport value](http://ru.wikipedia.org/wiki/Паспорт_гражданина_Российской_Федерации) (Faker::Russian.passport)
+
+You can use [gem 'validates_russian'](https://github.com/asiniy/validates_russian) for validates generated values
+
+## Installation
+
+Add to Gemfile
+
+    gem 'validates_russian'
+
+## Usage
+
+### INN
+
+Generate INN with random region number and type (:individual or :legal)
+
+``` ruby
+  Faker::Russian.inn # => '183501166447'
+```
+
+You can set `region_number` and type
+
+``` ruby
+  Faker::Russian.inn(region_number: '78') # => '7857296996'
+  Faker::Russian.inn(kind: :individual) # => '0229191612'
+  Faker::Russian.inn(kind: :legal) # => '366582211439'
+```
+
+Also you can use sequences
+
+``` ruby
+  Faker::Russian.inn(sequence_number: 1) # => '0956860593'
+  Faker::Russian.inn(sequence_number: 1) # => '0956860593'
+```
+
+### KPP
+
+Generate KPP with random region_number
+
+``` ruby
+  Faker::Russian.kpp # => '525601001'
+```
+
+You can choose region
+
+``` ruby
+  Faker::Russian.kpp(region_number: 78) # => '784101001'
+```
+
+Also, you can use pseudo random sequence numbers (not much 1000, there is limited count of kpps)
+
+``` ruby
+  Faker::Russian.kpp(sequence_number: 1) # => '381201001'
+  Faker::Russian.inn(sequence_number: 1) # => '381201001'
+```
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/faker-russian/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/faker-russian.gemspec

@@ -1,11 +1,11 @@
 # coding: utf-8
 lib = File.expand_path('../lib', __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'faker/russian/version'
+require 'faker/russian'
 
 Gem::Specification.new do |spec|
   spec.name          = 'faker-russian'
-  spec.version       = Faker::Russian::Version::VERSION
+  spec.version       = Faker::Russian.version
   spec.authors       = ['Alex']
   spec.email         = ['kaburbundokel11g@inbox.ru']
   spec.homepage      = 'http://github.com/asiniy/faker-russian'

data/lib/faker/russian/constants.rb

@@ -0,0 +1,7 @@
+module Faker
+  module Russian
+    module SharedConstants
+      REGION_NUMBERS = %w{01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 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 70 71 72 73 74 75 76 77 78 79 83 86 87 89}
+    end
+  end
+end

data/lib/faker/russian/inn.rb

@@ -2,9 +2,14 @@ module Faker
   module Russian
     module Inn
       def inn(options = {})
-        region_number = find_region_number(options[:region_number])
-        kind = find_kind(options[:kind])
-        sequence_digits = find_sequence_digits(kind, options[:sequence_number])
+        if (options.keys - [:sequence_number, :region_number, :kind]).any?
+          raise 'wrong options. just :kind, :region_number or :sequence_number'
+        end
+
+        sequence = find_sequence(options[:sequence_number])
+        region_number = find_region_number(options[:region_number], sequence)
+        kind = find_kind(options[:kind], sequence)
+        sequence_digits = find_digits(kind, sequence)
 
         inn_without_check_digit = region_number + sequence_digits
         inn_without_check_digit + check_digit(inn_without_check_digit)
@@ -12,29 +17,32 @@ module Faker
 
     private
 
-      def find_region_number(number = nil)
+      def find_sequence(number)
+        sequence = number || Random.rand(1_000_000_000)
+        Random.new(sequence)
+      end
+
+      def find_region_number(number = nil, sequence)
+        region_numbers = Faker::Russian::SharedConstants::REGION_NUMBERS
+
         if number.present?
-          raise('there is no region with that number!') unless REGION_NUMBERS.include?(number)
-          number
+          raise('there is no region with that number!') unless region_numbers.include?(number.to_s)
+          number.to_s
         else
-          REGION_NUMBERS.sample
+          region_numbers[sequence.rand(region_numbers.size)]
         end
       end
 
-      def find_kind(kind)
+      def find_kind(kind, sequence)
         case kind
-        when :individual then :individual
-        when :legal then :legal
-        when nil then [:individual, :legal].sample
+        when :individual, :legal then kind
+        when nil then [:individual, :legal][sequence.rand(2)]
         else raise 'there is no any kind other than :individual or :legal'
         end
       end
 
-      def find_sequence_digits(kind, sequence_number)
-        sequence = sequence_number || Random.new_seed
-        Random.srand(sequence)
-
-        (kind == :legal) ? Random.rand(1_000_000..9_999_999).to_s : Random.rand(10_000_000..99_999_999).to_s
+      def find_digits(kind, sequence)
+        (kind == :legal) ? sequence.rand(1_000_000..9_999_999).to_s : sequence.rand(10_000_000..99_999_999).to_s
       end
 
       def check_digit(digits)
@@ -49,8 +57,6 @@ module Faker
         (p.each_with_index.inject(0){ |s, p| s + p[0] * inn[p[1]].to_i } % 11 % 10).to_s
       end
 
-      REGION_NUMBERS = %w{01 02 03 04 05 06 07 08 09 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 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 70 71 72 73 74 75 76 77 78 79 83 86 87 89} # TODO move to specific place
-
       P10 = [2, 4, 10, 3, 5, 9, 4, 6, 8]
       P11 = [7, 2, 4, 10, 3, 5, 9, 4, 6, 8]
       P12 = [3, 7, 2, 4, 10, 3, 5, 9, 4, 6, 8]

data/lib/faker/russian/kpp.rb

@@ -0,0 +1,39 @@
+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
+
+        sequence = find_sequence(options[:sequence_number])
+        region_number = find_region_number(options[:region_number], sequence)
+
+        region_number + two_region_numbers(sequence) + '01001'
+      end
+
+    private
+
+      def find_sequence(number)
+        sequence = number || Random.rand(1_000_000_000)
+        Random.new(sequence)
+      end
+
+      def find_region_number(number = nil, sequence)
+        region_numbers = Faker::Russian::SharedConstants::REGION_NUMBERS
+
+        if number.present?
+          raise('there is no region with that number!') unless region_numbers.include?(number.to_s)
+          number.to_s
+        else
+          region_numbers[sequence.rand(region_numbers.size)]
+        end
+      end
+
+      def two_region_numbers(sequence)
+        sprintf '%02d', sequence.rand(100)
+      end
+
+    end
+  end
+end

data/lib/faker/russian/version.rb

@@ -1,7 +1,11 @@
 module Faker
   module Russian
     module Version
-      VERSION = '0.0.1'
+      VERSION = '0.0.2'
+
+      def version
+        VERSION
+      end
     end
   end
 end

data/lib/faker/russian.rb

@@ -2,7 +2,10 @@ Dir[File.dirname(__FILE__) + '/russian/**/*.rb'].each{ |f| require f }
 
 module Faker
   module Russian
-    extend Inn
+    extend SharedConstants
     extend Version
+
+    extend Inn
+    extend Kpp
   end
 end

data/spec/faker/russian/inn_spec.rb

@@ -7,29 +7,51 @@ describe Faker::Russian do
       DummyModel.validates(:field, inn_format: true)
     end
 
-    it 'provide valid inn without arguments' do
+    it 'generate valid inn without arguments' do
       100.times do
         expect(DummyModel.new(field: Faker::Russian.inn)).to be_valid
       end
     end
 
-    it 'provide valid inn with region number' do
+    it 'generate valid inn with region number' do
       100.times do
-        expect(DummyModel.new(field: Faker::Russian.inn(region: 78))).to be_valid
+        expect(DummyModel.new(field: Faker::Russian.inn(region_number: 78))).to be_valid
       end
     end
 
-    it 'provide valid inn with kind' do
+    it 'generate valid inn with kind' do
       100.times do
         expect(DummyModel.new(field: Faker::Russian.inn(kind: [:individual, :legal].sample))).to be_valid
       end
     end
 
-    it 'provide difference inns with sequence' do
-      sequenced_inns = 10000.times.map{ |n| Faker::Russian.inn(sequence: n) }
+    it 'generate valid length for :individual' do
+      100.times do
+        expect(Faker::Russian.inn(kind: :individual).length).to eq(12)
+      end
+    end
+
+    it 'generate valid length for :legal' do
+      100.times do
+        expect(Faker::Russian.inn(kind: :legal).length).to eq(10)
+      end
+    end
+
+    it 'generate difference inns with sequence' do
+      sequenced_inns = 10000.times.map{ |n| Faker::Russian.inn(sequence_number: n) }
       expect(sequenced_inns.size).to eq(sequenced_inns.uniq.size)
     end
 
+    it 'generate same inns for sequence' do
+      array1 = 1000.times.map{ |n| Faker::Russian.inn(sequence_number: n) }
+      array2 = 1000.times.map{ |n| Faker::Russian.inn(sequence_number: n) }
+      expect(array1).to eq(array2)
+    end
+
+    it 'permit just a few options' do
+      expect { Faker::Russian.inn(shit: 'shit') }.to raise_error
+    end
+
     it 'raise when selecting invalid region' do
       expect{ Faker::Russian.inn(region_number: '90') }.to raise_error
     end

data/spec/faker/russian/kpp_spec.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: faker-russian
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Alex
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-06-28 00:00:00.000000000 Z
+date: 2014-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -88,15 +88,21 @@ extensions: []
 extra_rdoc_files: []
 files:
 - ".gitignore"
+- ".travis.yml"
+- CHANGELOG.md
 - Gemfile
 - LICENSE.txt
 - README.md
 - Rakefile
+- doc/english_readme.md
 - faker-russian.gemspec
 - lib/faker/russian.rb
+- lib/faker/russian/constants.rb
 - lib/faker/russian/inn.rb
+- lib/faker/russian/kpp.rb
 - lib/faker/russian/version.rb
 - spec/faker/russian/inn_spec.rb
+- spec/faker/russian/kpp_spec.rb
 - spec/spec_helper.rb
 - spec/support/dummy_model.rb
 homepage: http://github.com/asiniy/faker-russian
@@ -125,5 +131,6 @@ specification_version: 4
 summary: Faker russian specific values. INN, OGRN, et.c.
 test_files:
 - spec/faker/russian/inn_spec.rb
+- spec/faker/russian/kpp_spec.rb
 - spec/spec_helper.rb
 - spec/support/dummy_model.rb