belka 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 78525c0d19c2311d1eb08853a37d68bdb9dc2455
+  data.tar.gz: 50d4cfc5d64c1a9ab52659d832b82aadf97603b7
+SHA512:
+  metadata.gz: 7460c85bd2f56ea25a58503a03bb0098df1aebf5520a5a2507f216c90faafb4157805f1bceefaa21c27b0e39dde6425749cd4acf9a17fe81466e4818098f9f35
+  data.tar.gz: e67874d725db7a50805b6a6d2bdae93bdb99bc98c04c5be0194cde2a5ffe207ce68c80c1f826ccfdf2347a100c153f2bc8b974a36128f9c70aa51dea4276ac44

data/.gitignore

@@ -0,0 +1,22 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in belka.gemspec
+gemspec

data/Gemfile~

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in belka.gemspec
+gemspec

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Oleg Dashevskii
+
+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.md

@@ -0,0 +1,33 @@
+# Belka
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'belka'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install belka
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/belka/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
+
+Лицензия
+
+Библиотека ryba распространяется по лицензии MIT, см. файл MIT-LICENSE.

data/README.textile

@@ -0,0 +1,33 @@
+# Belka
+
+TODO: Write a gem description
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'belka'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install belka
+
+## Usage
+
+TODO: Write usage instructions here
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/belka/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
+
+Лицензия
+
+Библиотека ryba распространяется по лицензии MIT, см. файл MIT-LICENSE.

data/README.textile~

@@ -0,0 +1,135 @@
+h1. Ryba
+
+h2. Введение
+
+Часто встает задача заполнения баз данных «рыбой», т.е. случайно сгенерированными данными,
+похожими на настоящие.
+
+К таким данным относятся:
+* ФИО.
+* Почтовые адреса (индекс, город, улица, дом, квартира).
+* Телефоны.
+* E-mail адреса.
+* Названия.
+* «Просто текст» для больших текстовых полей.
+
+Есть gemы, умеющие генерировать такие данные на английском: "faker":http://faker.rubyforge.org,
+"random_data":http://rubyforge.org/projects/random-data и другие.
+
+Ryba — попытка создать аналогичный генератор для русского языка: русские имена, адреса и т.д.
+
+Библиотека находится в активной разработке. На данный момент реализованы:
+* Генерация имен людей.
+* Генерация телефонов.
+* Генерация адресов.
+* Генерация имен компаний.
+
+Ниже описан интерфейс для реализованных возможностей.
+
+h2. Генерация имен людей
+
+Методы из @Ryba::Name@.
+
+@Ryba::Name.first_name(male = nil)@ — случайное имя.
+
+@Ryba::Name.middle_name(male = nil)@ — случайное отчество.
+
+@Ryba::Name.family_name(male = nil)@ — случайная фамилия.
+
+@Ryba::Name.full_name(male = nil)@ — случайное ФИО (например, "Щетинин Камилл Ростиславович").
+
+Параметр @male@ указывает пол (@true@ — мужской, @false@ — женский). Если параметр не указывать,
+будет выбран случайный пол.
+
+Чтобы получить имена для одного пола, можно воспользоваться методом @Ryba::Name.gender@, 
+возвращающим случайный пол. Либо простым вызовом:
+
+<pre><code>
+  gender = Ryba::Name.gender
+  first_name = Ryba::Name.first_name(gender)
+  family_name = Ryba::Name.family_name(gender)
+</pre></code>
+
+...либо с помощью блока
+
+<pre><code>
+  Ryba::Name.gender do |gender|
+    first_name = Ryba::Name.first_name(gender)
+    family_name = Ryba::Name.family_name(gender)
+  end
+</pre></code>
+
+h2. Генерация телефонов
+
+Метод @Ryba::PhoneNumber.phone_number@.
+
+<pre><code>
+  >> Ryba::PhoneNumber.phone_number
+  => "2-26-47"
+  >> Ryba::PhoneNumber.phone_number
+  => "431-15-94"
+  >> Ryba::PhoneNumber.phone_number
+  => "8 (87829) 9-45-53"
+  >> Ryba::PhoneNumber.phone_number
+  => "5515328"
+  >> Ryba::PhoneNumber.phone_number
+  => "(2397) 94 78 14"
+</code></pre>
+
+h2. Генерация адресов
+
+Методы из @Ryba::Address@.
+
+@Ryba::Address.index@ — случайный почтовый индекс (просто случайное число между 100000 и 700000). _Пример: 149544_.
+
+@Ryba::Address.city@ - случайный город России. _Пример: "Выкса"_.
+
+@Ryba::Address.full_city@ - случайный город с указанием региона, если это необходимо (город не является областным центром). _Примеры:_
+* "Брянская обл., г. Унеча";
+* "г. Ярославль";
+* "г. Москва".
+
+@Ryba::Address.street@ - случайное название улицы. _Примеры:_
+* "ул. Бородина";
+* "Красный пер.";
+* "1 линия".
+
+@Ryba::Address.address@ - случайный адрес. _Примеры:_
+* "ул. Щербакова 130-279";
+* "ул. Невская, д.167, оф. 32";
+* "Пушкинский пер., д. 36, кв.234";
+* "ул. Базарная, д. 182к2, 5-й эт.".
+
+@Ryba::Address.postal@ - случайный полный почтовый адрес. _Примеры:_
+* "242733, Рязанская обл., г. Спас-Клепики, ул. Куйбышева, 42-22";
+* "471408, Челябинская обл., г. Златоуст, ул. Квартальная, 174-282";
+* "195730, Воронежская обл., г. Калач, ул. Волжская, д. 175, кв. 7";
+* "342656, Краснодарский край, г. Лабинск, ул. Ворошилова, д.153, кв.225";
+* "209218, Сахалинская обл., г. Корсаков, ул. Мусоргского д. 65 кв. 206";
+* "485245, г. Курган, ул. Литвинова д.173 кв. 245".
+
+Обратите внимание, что индекс не является настоящим и что в городе может не быть
+такой улицы (а на улице — такого дома, а в доме — такой квартиры).
+
+h2. Генерация имен компаний
+
+@Ryba::Company.name@ - случайное имя компании. _Примеры:_
+* ПродуктАэро
+* ТрастСеть
+* СалоКондитер
+* РезервФабрика
+* ДжинсКредит
+
+Опция :solidity позволяет управлять длиной имени. Например, @Ryba::Company.name(:solidity => 3)@ 
+генерирует более солидное имя для компании:
+* ТехВоенКомбинатАкадем Групп
+* ТеплоМаркетТоргСинтез
+* ПрофСайтВалютСвязь
+* ТрейдингКоммерцКомТелеком
+* ГосСервисСпецСтанция
+
+h2. Лицензия
+
+Библиотека ryba распространяется по лицензии MIT, см. файл MIT-LICENSE.
+
+Автор: Олег Дашевский, "#{%w(Oleg Dashevskii).join('').downcase}@gmail.com"

data/Rakefile

@@ -0,0 +1,27 @@
+require 'bundler'
+require 'rake/testtask'
+require 'rdoc/task'
+require 'rspec/core/rake_task'
+
+Bundler::GemHelper.install_tasks
+
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'belka'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+RSpec::Core::RakeTask.new(:spec) do |t|
+  t.ruby_opts = '-I lib -I spec'
+  t.rspec_opts = '--colour'
+end
+
+RSpec::Core::RakeTask.new(:rcov) do |t|
+  t.rcov = true
+  t.rspec_opts = '--colour'
+  t.ruby_opts = '-I lib -I spec'
+end
+
+task :default => :spec

data/belka.gemspec

@@ -0,0 +1,24 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "belka/version"
+
+Gem::Specification.new do |s|
+  s.name        = "belka"
+  s.version     = Belka::VERSION
+  s.licenses    = ['MIT']
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Belka"]
+  s.email       = %q{m.lakhvich@gmail.com}
+  s.homepage    = "https://github.com/Lakhvich/Belka"
+  s.summary     = %q{Russian faker}
+  s.description = %q{Russian names and addresses generator}
+
+  s.rubyforge_project = "belka"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+  s.extra_rdoc_files = [ "README.textile" ]
+
+end

data/lib/belka.rb

@@ -0,0 +1,44 @@
+module Belka
+  def self.numerify(number_string)
+    number_string.gsub('#') { rand(10).to_s }
+  end
+
+  def self.pick(variants)
+    case variants
+    when Array
+      variants[rand(variants.size)]
+    when String
+      variants[rand(variants.length),1]
+    when Range
+      if variants.exclude_end?
+        rand(variants.last - variants.first) + variants.first
+      else
+        rand((variants.last+1) - variants.first) + variants.first
+      end
+    end
+  end
+
+  def self.pick_multi(variants, count)
+    variants.shuffle.take(count)
+  end
+
+  def self.weighted_pick(variants)
+    total_sum = variants.inject(0) { |sum, var| sum + var[1] }
+    rnd = rand(total_sum)
+
+    sum = 0
+    variants.each do |var|
+      sum += var[1]
+      return var[0] if rnd < sum
+    end
+
+    # этого не может быть
+    raise
+  end
+end
+
+require 'belka/data'
+require 'belka/name'
+require 'belka/phone_number'
+require 'belka/address'
+require 'belka/company'

data/lib/belka/address.rb

@@ -0,0 +1,75 @@
+# encoding: utf-8
+module Belka
+  class Address
+    class<<self
+      def index
+        Belka.pick(100000...700000)
+      end
+
+      def city
+        Belka.pick(Data::AllCities).gsub('_', ' ')
+      end
+
+      def full_city
+        cty = Belka.pick(Data::AllCities)
+        h_cty = cty.gsub('_', ' ')
+
+        region = Belka.pick(Data::RegionByCities[cty])
+
+        if Data::CitiesByRegion[region].first == cty
+          "г. #{h_cty}"
+        else
+          "#{region}, г. #{h_cty}"
+        end
+      end
+
+      def street
+        Belka.pick(Data::StreetNames)
+      end
+
+      BuildingFormats = [
+        [ 'д. #', 90 ],
+        [ 'д.#', 80 ],
+        [ 'д. #/?', 15 ],
+        [ 'д. #к?', 10 ],
+        [ 'стр. #', 10 ],
+        [ 'д.#/?', 5 ],
+        [ 'д.#к?', 5 ],
+        [ 'стр.#', 5 ],
+      ].freeze
+
+      ApartmentFormats = [
+        [ 'кв. #', 10 ],
+        [ 'оф. #', 10 ],
+        [ '? этаж', 2 ],
+        [ 'кв.#', 5 ],
+        [ 'оф.#', 5 ],
+        [ '?-й эт.', 1 ],
+      ]
+
+      def address
+        building  = Belka.pick(1..200)
+        apartment = Belka.pick(1..300)
+        separator = Belka.pick([' ', ', '])
+
+        street + separator +
+          if rand(10) < 2
+            "#{building}-#{apartment}"
+          else
+            formatter = lambda do |fmts, num|
+              Belka.weighted_pick(fmts).gsub('#', num.to_s).gsub('?', Belka.pick(1..9).to_s)
+            end
+
+            building  = formatter.call(BuildingFormats, building)
+            apartment = formatter.call(ApartmentFormats, apartment)
+
+            "#{building}#{separator}#{apartment}"
+          end
+      end
+
+      def postal
+        "#{index}, #{full_city}, #{address}"
+      end
+    end
+  end
+end