ryba 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.sw?
+.DS_Store
+coverage
+pkg

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.textile

@@ -0,0 +1,117 @@
+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 распространяется по лицензии MIT, см. файл MIT-LICENSE.
+
+Автор: Олег Дашевский, "#{%w(Oleg Dashevskii).join('').downcase}@gmail.com"

data/Rakefile

@@ -0,0 +1,41 @@
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |s|
+    s.name = "ryba"
+    s.summary = %Q{Russian faker}
+    s.email = "olegdashevskii@gmail.com"
+    s.homepage = "http://github.com/be9/ryba"
+    s.description = "Russian names and addresses generator"
+    s.authors = ["oleg dashevskii"]
+  end
+
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: gem install jeweler"
+end
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = 'ryba'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |t|
+  t.libs << 'lib' << 'spec'
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts << '--colour'
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |t|
+  t.libs << 'lib' << 'spec'
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.rcov = true
+end
+
+task :default => :spec

data/VERSION.yml

@@ -0,0 +1,5 @@
+--- 
+:patch: 0
+:major: 0
+:build: 
+:minor: 1

data/lib/ryba.rb

@@ -0,0 +1,39 @@
+module Ryba
+  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.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 File.join(File.dirname(__FILE__), 'ryba', 'data')
+require File.join(File.dirname(__FILE__), 'ryba', 'name')
+require File.join(File.dirname(__FILE__), 'ryba', 'phone_number')
+require File.join(File.dirname(__FILE__), 'ryba', 'address')

data/lib/ryba/address.rb

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

data/lib/ryba/data.rb

@@ -0,0 +1,817 @@
+module Ryba
+  module Data
+    # http://taina.aib.ru/names/man/man-a.htm
+    MaleNames = %w{
+      Абрам Авраам Ибрагим Аввакум Аввакуум Аббакум Август Августин
+      Авдей Авенир Аверьян Аверкий Авксентий Агап Агафон Агей Азарий
+      Адам Адольф Адриан Акакий Аким Алан Александр Алексей Алоис
+      Альберт Альбин Альфред Амадей Амвросий Ананий Анжей Анастасий
+      Анатолий Андрей Андриан Андроник Андрон Анисим Антип Антон
+      Ануфрий Аполинарий Аполлон Аристарх Аркадий Арнольд Арсен
+      Арсений Артем Артемий Артур Архип Аскольд Атанас Аурелий
+      Аурелиус Афанасий Афиноген Бажен Бальтазар Бенедикт Бернанд
+      Бертран Богдан Болеслав Бонавентура Борис Бронислав Бруно Булат
+      Вавила Вадим Валентин Валериан Валерьян Валерий Вальтер Варлаам
+      Варлам Варфоломей Василий Вацлав Велор Велорий Венедикт Вениамин
+      Викентий Виктор Вилли Винсент Виргилий Виссарион Вит Виталий
+      Витольд Владимир Владислав Владлен Влас Вольдемар Всеволод
+      Вячеслав Габриель Гавриил Галактион Гарри Геннадий Генрих
+      Георгий Егор Геракл Геральд Герасим Герман Глеб Годфрид Гордей
+      Грегор Григорий Гурий Густав Давыд Давид Даниил Данила Дементий
+      Демид Демьян Денис Джордан Димитрий Дмитрий Дональд Донат
+      Дормидонт Дорофей Евгений Евграф Евдоким Евлампий Евсевий Евсей
+      Евстафий Евстахий Евстигней Евстрат Елизар Елисей Емельян Епифан
+      Еремей Ермолай Ерофей Ефим Ефрем Жерар Захар Зенон Зигфрид
+      Зиновий Зосима Иакинф Иван Иво Игнат Игнатий Игорь Измаил
+      Изяслав Илларион Илья Имил Эмилий Иннокентий Иона Иосиф Осип
+      Ипат Ипполит Ираклий Геракл Иржи Исаак Исидор Сидор Казимир
+      Каллистрат Камилл Капитон Карл Карол Карп Касьян Ким Киприан
+      Кирилл Кирьян Клавдий Клеменс Клемент Клим Климент Климентий
+      Кондратий Кондрат Конрад Константин Корнелий Корнилий Корней
+      Кристиан Кристоф Кронид Ксавер Ксенофонт Кузьма Лавр Лаврентий
+      Лазарь Лев Леон Леонард Леонид Леонтий Леопольд Лука Лукьян
+      Любомир Людвиг Люсьен Май Макар Макарий Максим Максимилиан
+      Мануэль Марек Мариан Мариус Марк Марсель Мартин Мартын Масей
+      Матвей Матеуш Мауриций Медард Мелентий Мефодий Мечеслав Мечислав
+      Милан Милон Мирон Мирослав Митрофан Михаил Модест Моисей
+      Мстислав Назар  Назарий Наполеон Натан Нафан Наркисс Нарцисс
+      Наум Нестор Никандр Никанор Никита Никифор Никодим Николай Никон
+      Нил Нисон Норберт Овидий Олаф Олег Олесь Онисим Орест Осип Оскар
+      Остромир Павел Памфил Панфил Панкрат Пантелеймон Пантелей
+      Парамон Парфен Патрик Патрикей Паулин Пахом Петр Пимен Платон
+      Поликарп Порфирий Прокл Прокоп Прокофий Прокопий Протас Прохор
+      Ратибор Ратмир Рафаил Рафаэль Ринат Ренат Ричард Роберт Роджер
+      Родион Роланд Роман Рональд Ростислав Рубен Рудольф Руслан Рюрик
+      Савва Севастьян Савелий Самсон Самуил Святополк Святослав
+      Севастьян Северьян Селестин Семен Серафим Сергей Сила Сильвестр
+      Серж Соломон Спартак Спиридон Станислав Степан Тарас Теодор
+      Теофил Терентий Тимофей Тимур Тит Тихон Томас Трифон Трофим
+      Ульрих Устин Фабиан Фаддей Федор Федот Феликс Фелициан Феодосий
+      Феофан Фердинанд Филимон Филипп Флор Флориан Фома Франц Фридрих
+      Харитон Харольд Христиан Христофор Цезарь Эварист Эдвард Эдгар
+      Эдмунд Эдуард Эдвард Эмерик Эмиль Эммануил Эммануэль Эразм Эраст
+      Эрик Эрнест Юлиан Юлий Юрий Юхим Яков Ян Януарий Яромир
+      Ярослав}.freeze
+
+    # http://taina.aib.ru/names/woman/woman-a.htm
+    FemaleNames = %w{
+      Августа Августина Аврора Агата Агафья Аглая Аглаида Агнесса
+      Агния Агриппина Ада Аделаида Аделина Адриана Аза Акулина
+      Алевтина Александра Алина Алиса Алла Альберта Альбертина Альбина
+      Альфреда Амелия Анабела Анастасия Ангелина Анжела Анжелика
+      Анисья Анита Аниэла Анна Антонина Анфиса Апполинария Аполлония
+      Арабелла Ариадна Астра Аурелия Аурика Барбара Беата Беатриса
+      Белла Бенедикта Бернадета Берта Бибиана Бланка Богдана Болеслава
+      Борислава Бригитта Бронислава Валентина Валерия Ванда Варвара
+      Варя Василиса Васса Венера Вера Вероника Веста Ветта Иветта
+      Вивиана Виктория Вильгельмина Виолетта Вирджиния Виринея Виталия
+      Виталина Владислава Владлена Габриела Галина Гаянэ Гелена Гелла
+      Генриетта Гертруда Гизелла Глафира Гликерия Глория Гортензия
+      Грация Дайна Далия Дана Даниела Данута Дарья Дебора Джульетта
+      Диана Дина Доля Доминика Дора Дорота Дорофея Ева Евгения Евдокия
+      Евпраксия Евтебия Екатерина Елена Елизавета Ефросиния Жанна
+      Жеральдина Жозефина Забава Зинаида Зита Злата Зоя Ивона Изабелла
+      Изольда Инара Инга Инесса Инна Иоанна Иоланта Ираида Ирена Ирина
+      Ирма Ия Калерия Камилла Капитолина Карен Карина Каролина
+      Катарина Кира Клавдия Клара Климентина Клотильда Констанция Кора
+      Кристина Ксавера Ксения Лада Лайма Лариса Лаура Лена Леокадия
+      Леонтина Леся Лиана Лидия Лилиана Лилия Лиля Лия Лола Лолита
+      Лолла Луиза Лукреция Любовь Людмила Люсина Люся Люция Лючия
+      Магдалена Магдалина Майя Мануэла Маня Маргарита Марианна Марина
+      Мариэтта Мария Марлена Марселина Марта Марфа Матильда Матрена
+      Матрона Медея Мелания Милена Милица Мира Мирра Мирдза Мирра
+      Михалина Моника Муза Надежда Наина Наталья Наталия Наташа Нелли
+      Неонила Нила Ника Нина Нинель Нонна Нора Одетта Оксана Октавия
+      Октябрина Олеся Ольга Памела Патриция Паула Паулина Пелагея
+      Петиция Полина Прасковья Пульхерия Рада Раиса Рахиль Ревекка
+      Регина Рина Рената Римма Рита Роберта Роза Розалия Розамунда
+      Роксана Ростислава Руслана Руфина Сабина Сандра Сарра Сара
+      Светлана Северина Селестина Селина Серафима Сивилла Сильва
+      Сильвия Симона Сиотвия Соломея Соня София Софья Станислава
+      Стелла Стефанида Стефания Сузанна Сусанна Сюзанна Таира Таисия
+      Таисья Тамара Татьяна Текла Теодора Тереза Томила Тамила Ульяна
+      Устинья Урсула Фаина Фёкла Фелиция Феодора Феодосия Филиппина
+      Филомена Флора Франсуаза Фредерика Фрида Хильда Хильдегарда
+      Христина Цецилия Эвелина Эдита Юдифь Эдмунда Элеонора Элиана
+      Элина Элиза Элизабет Элла Эльвира Эльза Эмилия Эмма Эмма Эрика
+      Эрнестина Эстер Эстера Юдита Юлия Юнона Ядвига Яна Янина
+      Ярослава}
+
+    # http://taina.aib.ru/otchectv/man/index.htm
+    MaleMiddleNames = %w{
+      Александрович Алексеевич Альбертович Анатольевич Андреевич
+      Антонович Аркадьевич Артемович Богданович Богуславович Борисович
+      Вадимович Валентинович Валерьевич Васильевич Вениаминович
+      Викторович Владимирович Вячеславович Геннадиевич Георгиевич
+      Григорьевич Давидович Данилович Денисович Дмитриевич Евгеньевич
+      Егорович Ефимович Иванович Игоревич Ильич Иосифович Кириллович
+      Константинович Львович Леонидович Макарович Максимович Максович
+      Матвеевич Миронович Михайлович Натанович Наумович Николаевич
+      Олегович Оскарович Павлович Петрович Платонович Робертович
+      Романович Ростиславович Рубенович Рудольфович Русланович
+      Святославович Семенович Сергеевич Станиславович Степанович
+      Тарасович Тимофеевич Тимурович Федорович Феликсович Филиппович
+      Эдуардович Эльдарович Юрьевич Яковлевич Ярославович}
+
+    # http://taina.aib.ru/otchectv/woman/index.htm
+    FemaleMiddleNames = %w{
+      Александровна Алексеевна Альбертовна Анатольевна Андреевна
+      Антоновна Аркадьевна Артемовна Артуровна Архиповна Аскольдовна
+      Афанасьевна Богдановна Болеславовна Борисовна Вадимовна
+      Валентиновна Валериевна Васильевна Вениаминовна Викторовна
+      Владимировна Владиславовна Вячеславовна Владиславовна
+      Геннадиевна Георгиевна Григорьевна Даниловна Денисовна
+      Дмитриевна Евгеньевна Егоровна Ефимовна Ждановна Ивановна
+      Игоревна Ильинична Кирилловна Константиновна Кузминична Леоновна
+      Львовна Леонидовна Макаровна Максимовна Матвеевна Мироновна
+      Михайловна Натановна Наумовна Никифоровна Николаевна Ниловна
+      Олеговна Оскаровна Павловна Петровна Робертовна Романовна
+      Рубеновна Рудольфовна Руслановна Святославовна Семеновна
+      Сергеевна Степановна Станиславовна Тарасовна Тимофеевна
+      Тимуровна Федоровна Феликсовна Филипповна Эдуардовна Эльдаровна
+      Юльевна Юрьевна Яковлевна}
+
+    # http://b23.ru/qiu
+    FamilyNames = %w{
+      Абакумов Абарников Абдулов Абрамов Авдеев Аверин Аверьянов
+      Авилов Автухов Агапов Агафонов Агейкин Ажищенков Азаров Аксаков
+      Аксёнов Алеев Аленин Алиев Алистратов Алогрин Амалиев Амелин
+      Аминев Александров Алексеев Алёхин Аллилуев Андреев Андреюшкин
+      Андроников Андропов Аниканов Анисимов Анишин Анников Анохин
+      Аношкин Антипов Антонов Апалков Артамонов Арефьев Арзамасцев
+      Аристархов Арсеньев Артёмов Асланов Аслаханов Астанков Астафьев
+      Астахов Афанасьев Афонин Аспидов Бабанин Бабатьев Бабиков
+      Бабичев Бабкин Бабурин Багров Бакрылов Бажанов Баженов Базанов
+      Базаров Балакин Баландин Балахнов Балашов Бальсунов Баранов
+      Барболин Баренцев Баринов Барков Барсуков Батрутдинов Безбородов
+      Безруков Безукладников Белибердиев Беликов Белов Беломестнов
+      Беломестов Белочкин Бендлин Березин Белоусов Бершов Беспалов
+      Бескрёстнов Бехтерев Бирюков Блаженов Блатов Блинов Блохин
+      Бобров Богатырёв Богданов Боголепов Боголюбов Богомазов
+      Богомолов Богров Бойков Бойцов Болотников Болтоногов Большов
+      Бондарев Бондарчюк Бореев Бочаров Борзилов Борцов Брагин Брежнев
+      Бугаков Буданов Будников Будылин Букин Буклин Булгаков Булыгин
+      Бунин Бурков Буров Бурцов Буряков Бутылин Быков Былинкин Бычков
+      Вавилов Вагин Вазов Варенников Васильев Васин Васнев Васнецов
+      Вахров Вахрушев Венедиктов Веденеев Веденин Ведерников Вергунов
+      Верещагин Вершинин Веселов Викашев Виноградов Винокуров Витаев
+      Витвинин Вицин Вихров Водоватов Воликов Волков Вольваков
+      Воробьев Воронин Воронов Воронков Воронцов Воскобойников Вотяков
+      Вырыпаев Гавриков Гаврилов Гагарин Гаголин Галдин Галиаскаров
+      Галкин Галыгин Гарин Гачев Генкин Герасимов Гибазов Гилёв
+      Глазков Голов Голованов Головин Голодяев Голубев Голубов
+      Голубцов Гончаров Горбачёв Горбунов Горбунков Горев Горелов
+      Горемыкин Горюнов Грачёв Графов Грешнев Грибов Грибоедов
+      Григорьев Гринин Гришин Громов Губанов Гулин Гурьянов Гусаров
+      Гусев Гунин Гущин Горохов Дорофеев Давыдкин Данильцин Двойнев
+      Дворников Деменок Дементьев Демидов Деникин Дёгтин Дегтярев
+      Дежнёв Делов Дементьев Дёмин Державин Дернов Десятков Дмитриев
+      Добронравов Добрынин Долгоруков Должиков Домашев Достовалов
+      Драгомиров Дресвянин Дрёмов Друганин Другов Дубинин Дубов
+      Дульцев Дуров Дятлов Дураничев Евдокимов Евстигнеев Егоров Ежов
+      Елагин Елизаров Елисеев Ельцин Ельцов Емельянов Енин Енотин
+      Енотов Ерзов Ермаков Ермилов Еромеев Ерофеев Ершов Есипов Ефимов
+      Ефремов Емелин Ерохин Ерёмин Ёжин Ёжов Ёлкин Ёлков Жабин Жарков
+      Жарыхин Жвиков Жданов Жеглов Железкин Железнов Жестаков Живенков
+      Жиглов Жигунов Жидков Жикин Жилин Жилов Жолдин Жуков Жутов
+      Журавлёв Журов Заврагин Завражин Завражнов Завразин Завьялов
+      Задорнов Зайцев Закрятин Захаров Захарьин Звягин Зефиров Зёмин
+      Зимин Злобин Золин Золотов Зонов Зубков Зубов Зуев Зуйков
+      Зимняков Зыкин Зыков Зырянов Зюганов Зверев Игнаткович Ивазов
+      Ивакин Ибрагимов Иванов Иванков Ивашин Ивашов Ивкин Иволгин
+      Игнатьев Игошин Исмайлов Измайлов Изюмов Иканов Икашев Ильин
+      Илюшин Ильюшин Иноземцев Ипатьев Исаев Истомин Кабинов Каблуков
+      Каверин Кадников Кадцын Казаков Казанцев Казарезов Калганов
+      Калягин Камкин Канадин Канадов Канадцев Каналин Капралов
+      Каприянов Капустин Караваев Карандашов Карантиров Караулин
+      Караулов Карев Каретников Каргин Карташов Карчагин Катериночкин
+      Катин Качусов Кашарин Каширин Кашканов Кашников Киприянов Киреев
+      Кирилов Кирсанов Кирьянов Клепахов Климов Климушин Климцов
+      Клоков Князев Ковалёв Ковров Ковшутин Кожуров Кожухов Козаков
+      Козлов Колесников Коллеров Колонтаев Колосов Кольцов Комаров
+      Комзин Комолов Кондратьев Кондюрин Конев Конников Коновалов
+      Коньяков Коняшев Копейкин Кораблёв Кораблин Коренев Коренёв
+      Коржаков Коржев Корнев Корнеев Корнилов Коровин Королёв Коротаев
+      Корчагин Косарёв Косков Косомов Косоруков Костин Костомаров
+      Котов Коченков Кошелев Кошечкин Кошкин Краев Краснов Красноперов
+      Кропанин Кругликов Круглов Крупин Крутин Кручинкин Крылов Крысов
+      Крюков Кубланов Кудашов Кудрин Кудрявцев Кудряшов Кузнецов
+      Кузубов Кузьмин Куимов Куклачёв Куклин Куклов Кулагин Кулаков
+      Кулибин Куликов Куракин Курбатов Курганов Курдин Курепин
+      Курпатов Курсалин Курчин Кутепов Кутиков Кутузов Кутяков
+      Лаврентьев Лавров Лагутов Лазарев Ланцов Лапотников Лаптев
+      Лапунов Лапухов Ларин Ларионов Ласкутин Лачинов Лачков Лебедев
+      Лебединцев Легкодимов Ледовской Леонидов Леонов Лепёхин Лесков
+      Летов Лёвкин Лешев Лещёв Лилов Лимонов Липин Лисицын Листунов
+      Лихачёв Лобанов Лобов Логинов Локтев Ломоносов Ломтев Лопатин
+      Лосев Лоскутников Лоскутов Лужков Луков Лукин Львов Лыткин
+      Любимов Любимцев Любов Левкин Лягушкин Лягушов Лялюшкин Ляпин
+      Лясин Мадулин Мажулин Макаров Маклаков Максимов Максимушкин
+      Максудов Малахов Маликов Малинин Малышев Мальчиков Малыхин
+      Малюгин Мамонов Манин Манякин Маркин Марков Маринин Марьин
+      Маслов Матвеев Машарин Медведев Медведков Медников Меледин
+      Мелехов Меликов Мельников Меншиков Менщиков Меркушев Мещеряков
+      Мигунов Мизенов Милехин Милорадов Милюков Милютин Минеев Минин
+      Минкин Миров Мирнов Миронов Митин Митрофанов Михайлов Михалев
+      Михеев Мишнев Мишутин Моисеев Молчанов Моренов Морозов Моряков
+      Мосалев Москвин Муратов Мухортов Мягков Мясников Мятлев Набатов
+      Нардин Наумов Невзоров Неделяев Нежданов Немцев Немцов Ненашев
+      Нестеров Нечаев Никитин Никифоров Никишин Николаев Никонов
+      Никулин Некрасов Новиков Новичков Новосельцев Носачёв Носков
+      Носов Нуриев Оборин Образцов Обухов Овечкин Огородников Огурцов
+      Озеров Оленев Онегин Опокин Орлов Осин Осинов Осинцев Осокин
+      Осолодкин Остальцев Островерхов Ошурков Павлов Панарин Панин
+      Панкин Панков Панфилов Папанов Пасхин Патрушев Пахомов Пашин
+      Пашков Пенкин Переверзев Перевёртов Пересторонин Перехваткин
+      Перов Перфильев Перьмяков Пестов Петров Петухов Печеников Печкин
+      Пивоваров Пирогов Пирожков Пичугин Пичушкин Пищальников
+      Племянников Погодин Погодов Погребнов Подшивалов Поздняков
+      Поливанов Половцев Полотенцев Полунин Полушин Поляков
+      Помельников Поникаров Пономарёв Пончиков Попов Попырин Посохов
+      Потапов Потёмкин Праздников Прибылов Привалов Примаков Пронин
+      Проничев Протасов Прохоров Пугачёв Пугин Пузаков Пузанов Путилин
+      Путилов Путин Путинов Путятин Пушкин Пыжалов Пырьев Разин
+      Разуваев Распопов Распутин Рассказов Расторгуев Ремизов Репин
+      Решетилов Решетников Ржевский Рогачёв Рогов Рогозин Рожков
+      Романов Ростов Ростовцев Рубашкин Рудавин Рудников Румянцев
+      Рунов Русаков Ручкин Рыбалкин Рыбаков Рыжанов Рыжков Рыжов Рыков
+      Рытин Рыченков Рюриков Рябкин Рябков Рябов Рябцев Ряхин Сабанцев
+      Сабитов Савасин Савинков Савенков Саврасов Садыков Сазонов
+      Салтанов Сальков Сальников Самойлов Самохин Самсонов Санников
+      Сапогов Сапожников Сапрыкин Сафиюлин Сафронов Сахаров Свалов
+      Северинов Севостьянов Седельников Седов Селезнёв Селиванов
+      Семёнов Сенькин Сергеев Серебров Серебряков Серёгин Серов
+      Серпионов Семянин Сёмин Сеченов Сиваков Сигаев Сигачёв Сидоров
+      Сизов Силиванов Силин Сильвестров Силаев Силиванов Ситников
+      Скворцов Скрябин Скоробогатов Скороходов Скуратов Слобожанин
+      Смагин Смирнов Сметанин Смолин Смолянинов Смотров Снаткин
+      Снегирёв Снетков Соболев Соколов Солдатов Соловьёв Солодников
+      Соломин Соломонов Сопов Сорокин Спанов Сталин Стариков Старцев
+      Староверов Староволков Стародубов Стародубцев Стеблев Стегнов
+      Степанов Степанков Степашин Стрелков Стрекалов Строганов
+      Субботин Суботин Суворин Суворкин Суворов Сунгатулин Сукачев
+      Сукин Султанов Суриков Сусоев Сусляков Сутулин Суханов Сухоруков
+      Сучков Сысоев Сытников Сычёв Сычкин Сюкосев Табаков Табернакулов
+      Таланов Талалихин Танков Тарасов Татаров Татауров Твардовский
+      Тёмкин Телицын Теплов Теребов Терёшин Тетерев Тимошкин Типалов
+      Титов Тихомиров Тихонов Ткачёв Токарев Токмаков Толбанов
+      Толкачёв Толмачёв Толстобров Толстокожев Топоров Торопов Травкин
+      Трактирников Третьяков Трифонов Трофимов Трусов Трутнев Труфанов
+      Трухин Трындин Туполев Турбин Тургенев Туров Турфанов Тычкин
+      Тюшняков Тянников Убейсобакин Угольников Ульянов Ульяшин
+      Успенский Усатов Усачёв Усов Устинов Устюжанин Утёсов Ухов Фанин
+      Фамусов Федин Федосов Федотов Федосеев Федченков Фёдоров Федулов
+      Фетисов Филатов Филимонов Филипов Филиппов Флёров Фокин Фоменков
+      Фомин Фомичев Фонвизин Форопонов Фирсов Фролов Францев Фукин
+      Хабалов Хабаров Хабенский Халипов Халтурин Ханилов Ханипов
+      Ханцев Харитонов Харламов Хлебов Хлебников Хлопонин Хмельнов
+      Ходяев Холодов Хомколов Храмов Хребтов Хромов Хрущёв Худовеков
+      Худяков Хуртин Царицын Царёв Цветаев Цветков Цирюльников
+      Цитников Цуканов Чаадаев Чадов Чазов Чапаев Чеботарёв Чебыкин
+      Чежеков Чекмарёв Челомеев Челомцев Челпанов Чендев Черенчиков
+      Черепанов Черкашин Чернов Чернаков Черников Чернышёв Чесноков
+      Чиграков Чижиков Чилаев Чистяков Чичиков Чичканов Чкалов Чмыхов
+      Чугунов Чудов Чужинов Чукчов Чукреев Чупахин Чупов Чуприн Чупров
+      Чуркин Чучанов Чучумашев Шабунин Шакмаков Шаляпин Шаповалов
+      Шапошников Шарапов Шаров Шаршин Шашлов Шведов Шеломов Шепкин
+      Шеповалов Шереметьев Шерстов Шикалов Ширманов Шихранов Шишкин
+      Шишлов Шишов Шкуратов Шлыков Шмаков Шмелев Шубин Шубкин Шувалов
+      Шукшин Шулёв Шульдешов Шульгин Шурупов Шушалев Щеглов Щеголев
+      Щеголихин Щедрин Щедров Щекочихин Щепкин Щербаков Щербин Щетинин
+      Щеткин Щукин Щуров Энтин Ювелев Юганцев Югов Юдачёв Юдашкин Юдин
+      Юнкин Юракин Юрнаев Юрьев Юсупов Ютилов Юферев Якимов Яковлев
+      Якубов Якунин Якушев Якушин Янаев Янков Яромеев Ярцев Ясенев
+      Яснеев Яшин} +
+      [ [ "Аксенчук", '', '' ],
+        [ "Антонович", '', '' ],
+        [ "Бебчук", '', '' ],
+        [ "Безродн", 'ый', 'ая' ],
+        [ "Беломестн", 'ый', 'ая' ],
+        [ "Беломестных", '', '' ],
+        [ "Бережн", 'ой', 'ая' ],
+        [ "Бобр", '', '' ],
+        [ "Бобрик", '', '' ],
+        [ "Бойдало", '', '' ],
+        [ "Бок", '', '' ],
+        [ "Бортник", '', '' ],
+        [ "Букирь", '', '' ],
+        [ "Бухало", '', '' ],
+        [ "Валевач", '', '' ],
+        [ "Головаха", '', '' ],
+        [ "Голумбовск", 'ий', 'ая' ],
+        [ "Гретченко", '', '' ],
+        [ "Гречко", '', '' ],
+        [ "Григолюк", '', '' ],
+        [ "Громыко", '', '' ],
+        [ "Гурковск", 'ий', 'ая' ],
+        [ "Дубровск", 'ий', 'ая' ],
+        [ "Думановск", 'ий', 'ая' ],
+        [ "Едемск", 'ий', 'ая' ],
+        [ "Емельяненко", '', '' ],
+        [ "Ешевск", 'ий', 'ая' ],
+        [ "Завражн", 'ый', 'ая' ],
+        [ "Задорожн", 'ый', 'ая' ],
+        [ "Закревск", 'ий', 'ая' ],
+        [ "Зинченко", '', '' ],
+        [ "Илькун", '', '' ],
+        [ "Калашник", '', '' ],
+        [ "Каменских", '', '' ],
+        [ "Кандинск", 'ий', 'ая' ],
+        [ "Капица", '', '' ],
+        [ "Касат", 'ый', 'ая' ],
+        [ "Кирилловск", 'ий', 'ая' ],
+        [ "Ковалевск", 'ий', 'ая' ],
+        [ "Козарь", '', '' ],
+        [ "Козловск", 'ий', 'ая' ],
+        [ "Косяк", '', '' ],
+        [ "Кравчук", '', '' ],
+        [ "Кузьмич", '', '' ],
+        [ "Лапидус", '', '' ],
+        [ "Лебединск", 'ий', 'ая' ],
+        [ "Леснич", 'ий', 'ая' ],
+        [ "Лобан", '', '' ],
+        [ "Логиновск", 'ий', 'ая' ],
+        [ "Лосевск", 'ий', 'ая' ],
+        [ "Майсак", '', '' ],
+        [ "Маслак", '', '' ],
+        [ "Машир", '', '' ],
+        [ "Оболенск", 'ий', 'ая' ],
+        [ "Ольховск", 'ий', 'ая' ],
+        [ "Остапюк", '', '' ],
+        [ "Островск", 'ий', 'ая' ],
+        [ "Панькив", '', '' ],
+        [ "Первак", '', '' ],
+        [ "Покровск", 'ий', 'ая' ],
+        [ "Полищук", '', '' ],
+        [ "Полторак", '', '' ],
+        [ "Приходько", '', '' ],
+        [ "Рабинович", '', '' ],
+        [ "Родзянко", '', '' ],
+        [ "Рокоссовск", 'ий', 'ая' ],
+        [ "Русских", '', '' ],
+        [ "Сай", '', '' ],
+        [ "Салко", '', '' ],
+        [ "Семичаевск", 'ий', 'ая' ],
+        [ "Сиз", 'ый', 'ая' ],
+        [ "Случевск", 'ий', 'ая' ],
+        [ "Смирнитск", 'ий', 'ая' ],
+        [ "Соболевск", 'ий', 'ая' ],
+        [ "Солодских", '', '' ],
+        [ "Тихвинск", 'ий', 'ая' ],
+        [ "Ткаченко", '', '' ],
+        [ "Толст", 'ой', 'ая' ],
+        [ "Торчинович", '', '' ],
+        [ "Тредиаковск", 'ий', 'ая' ],
+        [ "Циолковск", 'ий', 'ая' ],
+        [ "Чал", 'ый', 'ая' ],
+        [ "Челомей", '', '' ],
+        [ "Черных", '', '' ],
+        [ "Чиркаш", '', '' ],
+        [ "Шевелёк", '', '' ],
+        [ "Шуйск", 'ий', 'ая' ],
+        [ "Шуличенко", '', '' ],
+        [ "Шульга", '', '' ],
+        [ "Шурша", '', '' ],
+        [ "Щавельск", 'ий', 'ая' ],
+        [ "Щегельск", 'ий', 'ая' ],
+        [ "Щербатых", '', '' ],
+        [ "Экель", '', '' ],
+        [ "Эмануиль", '', '' ],
+        [ "Эсце", '', '' ],
+        [ "Этуш", '', '' ],
+        [ "Якименко", '', '' ],
+        [ "Якубович", '', '' ],
+        [ "Янковск", 'ий', 'ая' ],
+        [ "Янукович", '', '' ],
+        [ "Ярмольник", '', '' ] ]
+
+    # http://b23.ru/qtq
+    CitiesByRegion = {
+      # Центральный федеральный округ
+      'Белгородская обл.' => %w(Белгород Алексеевка Бирюч Валуйки Грайворон Губкин Короча Строитель Шебекино
+                                Новый_Оскол Старый_Оскол),
+
+      'Брянская обл.' => %w(Брянск Дятьково Жуковка Злынка Карачев Клинцы Мглин Новозыбков Почеп Севск Сельцо
+                            Стародуб Сураж Трубчевск Унеча Фокино),
+
+      'Владимирская обл.' => %w(Владимир Александров Вязники Гороховец Гусь-Хрустальный Камешково Карабаново
+                                Киржач Ковров Кольчугино Костерево Курлово Лакинск Меленки Муром Петушки
+                                Покров Радужный Собинка Струнино Судогда Суздаль Юрьев-Польский),
+
+      'Воронежская обл.' => %w(Воронеж Бобров Богучар Борисоглебск Бутурлиновка Калач Лиски Нововоронеж
+                               Новохоперск Острогожск Павловск Поворино Россошь Семилуки Эртиль),
+
+      'Ивановская обл.' => %w(Иваново Вичуга Заволжск Кинешма Комсомольск Кохма Наволоки Плес Приволжск
+                              Пучеж Родники Тейково Фурманов Шуя Южа Юрьевец Гаврилов_Посад),
+
+      'Калужская обл.' => %w(Калуга Балабаново Белоусово Боровск Ермолино Жиздра Жуков Киров Козельск
+                             Кондрово Кремёнки Людиново Малоярославец Медынь Мещовск Мосальск Обнинск
+                             Сосенский Спас-Деменск Сухиничи Таруса Юхнов),
+
+      'Костромская обл.' => %w(Кострома Буй Волгореченск Галич Кологрив Макарьев Мантурово Нерехта Нея
+                               Солигалич Чухлома Шарья),
+
+      'Курская обл.' => %w(Курск Дмитриев-Льговский Железногорск Курчатов Льгов Обоянь Рыльск Суджа Фатеж Щигры),
+
+      'Липецкая обл.' => %w(Липецк Грязи Данков Елец Задонск Лебедянь Усмань Чаплыгин),
+
+      'Московская обл.' => %w(Москва Апрелевка Балашиха Бронницы Верея Видное Волоколамск Воскресенск
+                              Высоковск Дедовск Дзержинский Дмитров Долгопрудный Домодедово Дрезна Дубна
+                              Егорьевск Железнодорожный Жуковский Зарайск Звенигород Ивантеевка Истра Кашира
+                              Климовск Клин Коломна Королёв Красноармейск Красногорск Краснозаводск
+                              Краснознаменск Куровское Ликино-Дулёво Лобня Лосино-Петровский Луховицы Лыткарино
+                              Люберцы Можайск Мытищи Наро-Фоминск Ногинск Одинцово Ожерелье Озёры Орехово-Зуево
+                              Павловский_Посад Пересвет Подольск Протвино Пушкино Пущино Раменское Реутов Рошаль
+                              Руза Сергиев_Посад Серпухов Солнечногорск Ступино Сходня Талдом Троицк Фрязино
+                              Химки Хотьково Черноголовка Чехов Шатура Щёлково Щербинка Электрогорск
+                              Электросталь Электроугли Юбилейный Яхрома),
+
+      'Орловская обл.' => %w(Орёл Болхов Дмитровск Ливны Малоархангельск Мценск Новосиль),
+
+      'Рязанская обл.' => %w(Рязань Касимов Кораблино Михайлов Новомичуринск Рыбное Ряжск Сасово Скопин
+                             Спас-Клепики Спасск-Рязанский Шацк),
+
+      'Смоленская обл.' => %w(Смоленск Велиж Вязьма Гагарин Демидов Десногорск Дорогобуж Духовщина Ельня
+                              Починок Рославль Рудня Сафоново Сычевка Ярцево),
+
+      'Тамбовская обл.' => %w(Тамбов Жердевка Кирсанов Котовск Мичуринск Моршанск Рассказово Уварово),
+
+      'Тверская обл.' => %w(Тверь Андреаполь Бежецк Белый Бологое Весьегонск Вышний_Волочек Западная_Двина
+                            Зубцов Калязин Кашин Кимры Конаково Красный_Холм Кувшиново Лихославль Нелидово
+                            Осташков Ржев Старица Торжок Торопец Удомля),
+
+      'Тульская обл.' => %w(Тула Алексин Белев Богородицк Болохово Венев Донской Ефремов Кимовск Киреевск
+                            Липки Новомосковск Плавск Северо-Задонск Советск Сокольники Суворов Узловая
+                            Чекалин Щекино Ясногорск),
+
+      'Ярославская обл.' => %w(Ярославль Гаврилов-Ям Данилов Любим Мышкин Переславль-Залесский Пошехонье
+                               Ростов Рыбинск Тутаев Углич),
+
+      # Северо-Западный федеральный округ
+      'Республика Карелия' => [nil] + %w(Беломорск Кемь Кондопога Костомукша Лахденпохья Медвежьегорск
+                                         Олонец Петрозаводск Питкяранта Пудож Сегежа Сортавала Суоярви),
+
+      'Республика Коми' => [nil] + %w(Воркута Вуктыл Емва Инта Микунь Печора Сосногорск Сыктывкар Усинск Ухта),
+
+      'Архангельская обл.' => %w(Архангельск Вельск Каргополь Коряжма Котлас Мезень Мирный Новодвинск
+                                 Няндома Онега Северодвинск Сольвычегодск Шенкурск),
+
+      'Ненецкий автономный округ' => [nil, 'Нарьян-Мар'],
+
+      'Вологодская обл.' => %w(Вологда Бабаево Белозерск Великий_Устюг Вытегра Грязовец Кадников Кириллов
+                               Красавино Никольск Сокол Тотьма Устюжна Харовск Череповец),
+
+      'Калининградская обл.' => %w(Калининград Багратионовск Балтийск Гвардейск Гурьевск Гусев Зеленоградск
+                                   Краснознаменск Ладушкин Мамоново Неман Нестеров Озерск Пионерский Полесск
+                                   Правдинск Приморск Светлогорск Светлый Славск Советск Черняховск),
+
+      'Ленинградская обл.' => %w(Санкт-Петербург Бокситогорск Волосово Волхов Всеволожск Выборг Высоцк Гатчина
+                                 Ивангород Каменногорск Кингисепп Кириши Кировск Коммунар Лодейное_Поле Луга Любань
+                                 Никольское Новая Ладога Отрадное Пикалево Подпорожье Приморск Приозерск Светогорск
+                                 Сертолово Сланцы Сосновый_Бор Сясьстрой Тихвин Тосно Шлиссельбург),
+
+      'Мурманская обл.' => %w(Мурманск Апатиты Гаджиево Заозерск Заполярный Кандалакша Кировск Ковдор Кола Мончегорск
+                              Оленегорск Островной Полярные_Зори Полярный Североморск Скалистый Снежногорск),
+
+      'Новгородская обл.' => %w(Великий_Новгород Боровичи Валдай Малая Вишера Окуловка Пестово Сольцы
+                                Старая_Русса Холм Чудово),
+
+      'Псковская обл.' => %w(Псков Великие_Луки Гдов Дно Невель Новоржев Новосокольники Опочка Остров Печоры
+                             Порхов Пустошка Пыталово Себеж),
+
+      # Южный федеральный округ
+      'Республика Адыгея' => [nil] + %w(Адыгейск Майкоп),
+
+      'Республика Дагестан' => [nil] + %w(Буйнакск Дагестанские_Огни Дербент Избербаш Каспийск Кизилюрт
+                                          Кизляр Махачкала Хасавюрт Южно-Сухокумск),
+
+      'Республика Ингушетия' => [nil] + %w(Карабулак Магас Малгобек Назрань),
+
+      'Кабардино-Балкарская Республика' => [nil] + %w(Баксан Майский Нальчик Нарткала Прохладный Терек Тырныауз Чегем),
+
+      'Республика Калмыкия' => [nil] + %w(Городовиковск Лагань Элиста),
+
+      'Карачаево-Черкесская Республика' => [nil] + %w(Карачаевск Теберда Усть-Джегута Черкесск),
+
+      'Республика Северная Осетия-Алания' => [nil] + %w(Алагир Ардон Беслан Владикавказ Дигора Моздок),
+
+      'Чеченская Республика' => [nil] + %w(Аргун Грозный Гудермес Урус-Мартан Шали),
+
+      'Краснодарский край' => %w(Краснодар Абинск Анапа Апшеронск Армавир Белореченск Геленджик Горячий_Ключ
+                                 Гулькевичи Ейск Кореновск Кропоткин Крымск Курганинск Лабинск Новокубанск
+                                 Новороссийск Приморско-Ахтарск Славянск-на-Кубани Сочи Темрюк Тимашевск Тихорецк
+                                 Тихорецк Туапсе Усть-Лабинск Хадыженск),
+
+      'Ставропольский край' => %w(Ставрополь Благодарный Будённовск Георгиевск Ессентуки Железноводск Зеленокумск
+                                  Изобильный Ипатово Кисловодск Лермонтов Минеральные_Воды Михайловск Невинномысск
+                                  Нефтекумск Новоалександровск Новопавловск Пятигорск Светлоград),
+
+      'Астраханская обл.' => %w(Астрахань Ахтубинск Знаменск Камызяк Нариманов Харабали),
+
+      'Волгоградская обл.' => %w(Волгоград Волжский Дубовка Жирновск Калач-на-Дону Камышин Котельниково Котово
+                                 Краснослободск Ленинск Михайловка Николаевск Новоаннинский Палласовка Петров_Вал
+                                 Серафимович Суровикино Урюпинск Фролово),
+
+      'Ростовская обл.' => %w(Ростов-на-Дону Азов Аксай Батайск Белая_Калитва Волгодонск Гуково Донецк Зверево
+                              Зерноград Каменск-Шахтинский Константиновск Красный_Сулин Миллерово Морозовск
+                              Новочеркасск Новошахтинск Пролетарск Сальск Семикаракорск Таганрог Цимлянск Шахты),
+
+
+      # Приволжский федеральный округ
+      'Республика Башкортостан' => [nil] + %w(Агидель Баймак Белебей Белорецк Бирск Благовещенск Давлеканово
+                                              Дюртюли Ишимбай Кумертау Межгорье Мелеуз Нефтекамск Октябрьский
+                                              Салават Сибай Стерлитамак Туймазы Уфа Учалы Учалы Янаул),
+
+      'Республика Марий Эл' => [nil] + %w(Волжск Звенигово Йошкар-Ола Козьмодемьянск),
+
+      'Республика Мордовия' => [nil] + %w(Ардатов Инсар Ковылкино Краснослободск Рузаевка Саранск Темников),
+
+      'Республика Татарстан' => [nil] + %w(Агрыз Азнакаево Альметьевск Бавлы Болгар Бугульма Буинск Елабуга
+                                           Заинск Зеленодольск Казань Лениногорск Мамадыш Менделеевск Мензелинск
+                                           Набережные_Челны Нижнекамск Нурлат Тетюши Чистополь),
+
+      'Удмуртская Республика' => [nil] + %w(Воткинск Глазов Ижевск Камбарка Можга Сарапул),
+
+      'Чувашская Республика' => [nil] + %w(Алатырь Канаш Козловка Мариинский_Посад Новочебоксарск Цивильск
+                                           Чебоксары Шумерля Ядрин),
+
+      'Пермский край' => %w(Пермь Александровск Березники Верещагино Горнозаводск Гремячинск Губаха Добрянка
+                            Кизел Красновишерск Краснокамск Кудымкар Кунгур Лысьва Нытва Оса Оханск Очер
+                            Соликамск Усолье Чайковский Чердынь Чермоз Чернушка Чусовой),
+
+      'Кировская обл.' => %w(Киров Белая_Холуница Вятские_Поляны Зуевка Кирово-Чепецк Кирс Котельнич Луза Малмыж
+                             Мураши Нолинск Омутнинск Орлов Слободской Советск Сосновка Уржум Яранск),
+
+      'Нижегородская обл.' => %w(Нижний_Новгород Арзамас Балахна Богородск Бор Ветлуга Володарск Ворсма Выкса
+                                 Горбатов Городец Дзержинск Заволжье Княгинино Кстово Кулебаки Лукоянов Лысково
+                                 Навашино Павлово Первомайск Перевоз Саров Семенов Сергач Урень Чкаловск Шахунья),
+
+      'Оренбургская обл.' => %w(Оренбург Абдулино Бугуруслан Бузулук Гай Кувандык Медногорск Новотроицк
+                                Орск Соль-Илецк Сорочинск Ясный),
+
+      'Пензенская обл.' => %w(Пенза Беднодемьяновск Белинский Городище Заречный Каменка Кузнецк Нижний_Ломов
+                              Никольск Сердобск Сурск),
+
+      'Самарская обл.' => %w(Самара Жигулевск Кинель Нефтегорск Новокуйбышевск Октябрьск Отрадный Похвистнево
+                             Сызрань Тольятти Чапаевск),
+
+      'Саратовская обл.' => %w(Саратов Аркадак Аткарск Балаково Балашов Вольск Ершов Калининск Красноармейск
+                               Красный_Кут Маркс Новоузенск Петровск Пугачев Ртищево Хвалынск Шиханы Энгельс),
+
+      'Ульяновская обл.' => %w(Ульяновск Барыш Димитровград Инза Новоульяновск Сенгилей Карсун Старая_Майна),
+
+      # Уральский федеральный округ
+      'Курганская обл.' => %w(Курган Далматово Катайск Куртамыш Макушино Петухово Шадринск Шумиха Щучье),
+
+      'Свердловская обл.' => %w(Екатеринбург Алапаевск Арамиль Артемовский Асбест Березовский Богданович
+                                Верхний_Тагил Верхняя_Пышма Верхняя_Салда Верхняя_Тура Верхотурье Волчанск Дегтярск
+                                Заречный Ивдель Ирбит Каменск-Уральский Камышлов Карпинск Качканар Кировград
+                                Краснотурьинск Красноуральск Красноуфимск Кушва Лесной Михайловск Невьянск
+                                Нижние_Серги Нижний_Тагил Нижняя_Салда Нижняя_Тура Новая_Ляля Новоуральск
+                                Первоуральск Полевской Ревда Реж Североуральск Серов Среднеуральск Сухой_Лог
+                                Сысерть Тавда Талица Туринск),
+
+      'Тюменская обл.' => %w(Тюмень Заводоуковск Ишим Тобольск Ялуторовск),
+
+      'Ханты-Мансийский автономный округ' => %w(Ханты-Мансийск Белоярский Когалым Лангепас Лянтор Мегион
+                                                Нефтеюганск Нижневартовск Нягань Покачи Пыть-Ях Радужный
+                                                Советский Сургут Урай Югорск),
+
+      'Ямало-Ненецкий автономный округ' => [nil] + %w(Губкинский Лабытнанги Муравленко Надым Новый_Уренгой 
+                                                      Ноябрьск Салехард),
+
+      'Челябинская обл.' => %w(Челябинск Аша Бакал Верхнеуральск Верхний_Уфалей Еманжелинск Златоуст Карабаш
+                               Карталы Касли Катав-Ивановск Копейск Коркино Куса Кыштым Магнитогорск Миасс Миньяр
+                               Нязепетровск Озерск Пласт Сатка Сим Снежинск Трехгорный Троицк Усть-Катав
+                               Чебаркуль Южноуральск Юрюзань),
+
+      # Сибирский федеральный округ
+      'Республика Алтай' => %w(Горно-Алтайск),
+
+      'Республика Бурятия' => [nil] + %w(Бабушкин Гусиноозерск Закаменск Кяхта Северобайкальск Улан-Удэ),
+
+      'Республика Тыва' => [nil] + %w(Ак-Довурак Кызыл Туран Чадан Шагонар),
+
+      'Республика Хакасия' => [nil] + %w(Абаза Абакан Саяногорск Сорск Черногорск),
+
+      'Алтайский край' => %w(Барнаул Алейск Белокуриха Бийск Горняк Заринск Змеиногорск Камень-на-Оби
+                             Новоалтайск Рубцовск Славгород Яровое),
+
+      'Забайкальский край' => %w(Чита Балей Борзя Краснокаменск Могоча Нерчинск Петровск-Забайкальский
+                                 Сретенск Хилок Шилка),
+
+      'Красноярский край' => %w(Красноярск Артемовск Ачинск Боготол Бородино Дивногорск Дудинка Енисейск
+                                Железногорск Заозерный Зеленогорск Игарка Иланский Кайеркан Канск Кодинск
+                                Лесосибирск Минусинск Назарово Норильск Сосновоборск Талнах Ужур Уяр Шарыпово),
+
+      'Иркутская обл.' => %w(Иркутск Алзамай Ангарск Байкальск Бирюсинск Бодайбо Братск Вихоревка
+                             Железногорск-Илимский Зима Киренск Нижнеудинск Саянск Свирск Слюдянка Тайшет Тулун
+                             Усолье-Сибирское Усть-Илимск Усть-Кут Черемхово Шелехов),
+
+      'Кемеровская обл.' => %w(Кемерово Анжеро-Судженск Белово Березовский Гурьевск Калтан Киселевск
+                               Ленинск-Кузнецкий Мариинск Междуреченск Мыски Новокузнецк Осинники Полысаево
+                               Прокопьевск Салаир Тайга Таштагол Топки Юрга),
+
+      'Новосибирская обл.' => %w(Новосибирск Барабинск Бердск Болотное Искитим Карасук Каргат Куйбышев
+                                 Купино Обь Татарск Тогучин Черепаново Чулым),
+
+      'Омская обл.' => %w(Омск Исилькуль Калачинск Называевск Тара Тюкалинск),
+
+      'Томская обл.' => %w(Томск Асино Кедровый Колпашево Северск Стрежевой),
+
+      # Дальневосточный федеральный округ
+      'Республика Саха' => [nil] + %w(Алдан Верхоянск Вилюйск Ленск Мирный Нерюнгри Нюрба Олекминск Покровск
+                              Среднеколымск Томмот Удачный Якутск),
+
+      'Камчатский край' => %w(Петропавловск-Камчатский Вилючинск Елизово),
+
+      'Приморский край' => %w(Владивосток Арсеньев Артем Большой_Камень Дальнегорск Дальнереченск Лесозаводск
+                              Находка Партизанск Спасск-Дальний Уссурийск Фокино),
+
+      'Хабаровский край' => %w(Хабаровск Амурск Бикин Вяземский Комсомольск-на-Амуре Николаевск-на-Амуре
+                               Советская_Гавань),
+
+      'Амурская обл.' => [nil] + %w(Белогорск Благовещенск Завитинск Зея Райчихинск Свободный Сковородино
+                                    Тында Шимановск),
+
+      'Магаданская обл.' => %w(Магадан Сусуман),
+
+      'Сахалинская обл.' => %w(Южно-Сахалинск Александровск-Сахалинский Анива Горнозаводск Долинск Корсаков
+                               Красногорск Курильск Макаров Невельск Оха Поронайск Северо-Курильск Томари
+                               Углегорск Холмск Чехов Шахтерск),
+
+      'Еврейская автономная область' => [nil] + %w(Биробиджан Облучье),
+
+      'Чукотский автономный округ' => [nil] + %w( Анадырь Билибино Певек)
+    }.freeze
+
+    unless defined? RegionByCities
+      region_by_cities = Hash.new { |hash, key| hash[key] = [] }
+
+      CitiesByRegion.each do |region, cities|
+        cities.each do |city|
+          region_by_cities[city] << region if city
+        end
+      end
+
+      RegionByCities = region_by_cities.freeze
+      AllCities = RegionByCities.keys.freeze
+    end
+
+    # http://feofanov.fizteh.ru/toall/street.html
+    StreetNames = ((%w{
+      Советская Молодежная Центральная Школьная Новая Садовая Лесная Набережная
+      Ленина Мира Октябрьская Зеленая Комсомольская Заречная Первомайская
+      Гагарина Полевая Луговая Пионерская Кирова Юбилейная Северная
+      Пролетарская Степная Пушкина Калинина Южная Колхозная Рабочая Солнечная
+      Железнодорожная Восточная Заводская Чапаева Нагорная Строителей Береговая
+      Победы Горького Кооперативная Красноармейская Совхозная Речная Спортивная
+      Озерная Строительная Парковая Чкалова Мичурина Подгорная Дружбы Почтовая
+      Партизанская Вокзальная Лермонтова Свободы Дорожная Дачная Маяковского
+      Западная Фрунзе Дзержинского Московская Свердлова Некрасова Гоголя
+      Красная Трудовая Шоссейная Чехова Коммунистическая Труда Комарова
+      Матросова Островского Сосновая Клубная Куйбышева Крупской Березовая
+      Больничная Интернациональная Суворова Цветочная Трактовая Ломоносова
+      Горная Космонавтов Энергетиков Шевченко Весенняя Механизаторов
+      Коммунальная Майская Энгельса Привокзальная Таежная Транспортная Овражная
+      Светлая Вишневая Чернышевского Урицкого Ключевая Ворошилова Тургенева
+      Толстого Песчаная Ленинградская Профсоюзная Буденного Орджоникидзе
+      Герцена Верхняя Ленинская Кирпичная Мостовая Щорса Станционная
+      Луначарского Энтузиастов Титова Лазо Уральская Линейная Пугачева
+      Володарского Кутузова Фабричная Чайковского Магистральная Сибирская
+      Крестьянская Мелиораторов Российская Новоселов Тихая Широкая Нижняя
+      Белинского Тельмана Тимирязева Котовского Народная Промышленная Кольцевая
+      Есенина Дальняя Крылова Декабристов Базарная Целинная Родниковая
+      Фурманова Революционная Социалистическая Звездная Студенческая Гайдара
+      Мирная Терешковой Кубанская Гаражная Фестивальная Гражданская Песочная
+      Сиреневая Ватутина Сельская Кузнечная Пушкинская Крайняя Коммунаров
+      Гвардейская Веселая Загородная Олимпийская Гастелло Жданова Радищева
+      Нефтяников Осипенко Приозерная Рябиновая Заозерная Нахимова Боровая
+      Жукова Павлова Урожайная Попова Торговая Жуковского Королева Донская
+      Пограничная Огородная Пригородная Грибоедова Стадионная Менделеева
+      Достоевского Репина Виноградная Циолковского Воровского Киевская
+      Революции Индустриальная Красногвардейская Волжская Кошевого Пархоменко
+      Свободная Кедровая Подлесная Полярная Раздольная Карьерная Мельничная
+      Серова Украинская Шахтерская Запрудная Элеваторная Театральная
+      Добролюбова Геологическая Болотная Красина Коминтерна Придорожная
+      Кленовая Разина Черняховского Казачья Ветеранов Малая Пирогова Геологов
+      Тукая Морская Волгоградская Димитрова Средняя Безымянная Краснофлотская
+      Братская Тенистая Учительская Маркса Кавказская Ушакова Короткая
+      Деповская Амурская Сенная Поселковая Юности Короленко Прудовая Шолохова
+      Депутатская Авиационная Черемушки Кольцова Плеханова Аэродромная Большая
+      Приморская Алтайская Макаренко Глинки Специалистов Халтурина Морозова
+      Тополиная Ростовская Тракторная Коммуны Мелиоративная Ольховая Славянская
+      Карбышева Баумана Радужная Правды Краснодарская Фадеева Стахановская
+      Ярославская Челюскинцев Коллективная Ангарская Новостройка Шмидта
+      Кузнецова Локомотивная Войкова Панфилова Ягодная Смоленская Тепличная
+      Водопроводная Республиканская Автомобилистов Космодемьянской Осенняя
+      Байкальская Седова Саратовская Казанская Блюхера Воронежская Брянская
+      Производственная Спартака Техническая Енисейская Николаева Бабушкина
+      Севастопольская Окружная Октября Щетинкина Орловская Хуторская Тупиковая
+      Каштановая Омская Гончарова Привольная Щербакова Курортная Ивановская
+      Выгонная Крымская Путейская Азина Проезжая Сурикова Краснознаменная
+      Одесская Января Подстанция Логовая Высокая Ясная Портовая Снежная
+      Санаторная Союзная Волкова Ульяновская Никитина Сахалинская Горняцкая
+      Рылеева Прибрежная Химиков Рыбацкая Полтавская Тамбовская Красноярская
+      Новосельская Проточная Черноморская Курчатова Минская Микрорайон Главная
+      Докучаева Вольная Просвещения Смирнова Хвойная Космическая Моховая
+      Макарова Курская Курганная Угловая Камская Инженерная Лесозаводская
+      Астраханская Иванова Гафури Высоцкого Белорусская Бажова Кочубея
+      Заовражная Азовская Ручейная Леонова Волочаевская Надежды Ставропольская
+      Металлистов Вавилова Слободская Ульянова Тульская Харьковская Петровская
+      Владимирская Семашко Высоковольтная Шаумяна Чайкиной Лазурная Ермака
+      Дорожников Покровская Новгородская Ленская Сплавная Ударная Калужская
+      Монтажников Прудная Шишкина Краснопартизанская Ореховая Таманская
+      Иркутская Металлургов Отрадная Беляева Большевистская Троицкая Лесхозная
+      Дружба Васильковая Серафимовича Ильича Механическая Невского Путевая
+      Кузнецкая Физкультурная Леваневского Водников Вахитова Станиславского
+      Черемуховая Советов Флотская Угольная Пожарского Папанина Просторная
+      Поперечная Городская Победа Абрикосовая Бульварная Прохладная Томская
+      Энергетическая Литейная Медицинская Заливная Журавлева Бригадная Культуры
+      Минина Машиностроителей Детская ДОС Тюленина Запорожская Дальневосточная
+      Громова Балтийская Февральская Толбухина Лунная Дарвина Высотная
+      Рязанская Малиновая Механизаторская Яблоневая Красногорская Липовая
+      Марата Горняков Переселенческая Новосибирская Рождественская Тухачевского
+      Лебедева Железнодорожников Бакинская Приречная Хабаровская Тверская
+      Малышева Айвазовского Самарская Складская Приовражная Хмельницкого
+      Фруктовая Ключевская Мечникова Газовиков Продольная Калининградская
+      Земляничная Авиаторов Бородина Связи Уфимская Демократическая Желябова
+      Дубовая Прямая Калининская Кировская Менжинского Молодогвардейская
+      Петрова Кравченко Лесопильная Дача Губкина Гористая Оренбургская Невская
+      Оборонная Паровозная Артиллерийская Пржевальского Текстильщиков
+      Спартаковская Янтарная Челюскина Костромская Никольская Новороссийская
+      Обская Беговая Свобода Уссурийская Иртышская Конституции Лагерная
+      Михайловская Либкнехта Пензенская Саянская Спасская Текстильная
+      Международная Донецкая Футбольная Доватора Расковой Красносельская
+      Мичуринская Лиманная Возрождения Арсеньева Пятигорская Ремесленная
+      Рощинская Тюменская Ярославского Краснодонская Кривая Делегатская Первая
+      Аксакова Артема Юлаева Челябинская Левитана Ладожская Летняя Лескова
+      Малиновского Мусоргского Крутая Еловая Животноводов Пионеров Нефтебаза
+      Офицерская Нестерова Связистов Стаханова Лобачевского Дружная Газовая
+      Пихтовая Армейская Рудничная Прогонная Телеграфная Институтская Каменная
+      Можайского Милицейская Лихачева Забайкальская Переездная Ветеринарная
+      Федорова Ямская Каменская Знаменская Межевая Громовой Онежская Надречная
+      Огарева Багратиона Торфяная Станичная Камчатская Джамбула Новаторов
+      Ботаническая Апрельская Салтыкова-Щедрина Сеченова Солдатская Танкистов
+      Березовская Андреева Аптечная Цимлянская Сосновская Чапаевская Захарова
+      Ипподромная Литвинова Гранитная Грибная Дежнева Васильева Рокоссовского
+      Промысловая Конечная Изумрудная Маслозаводская Охотничья Низовая
+      Перспективная Базовая Республики Читинская Карельская Кустарная МОПРА
+      Жемчужная Островная Парниковая Барнаульская Бородинская Аэропорт
+      Александровская Рижская Рассветная Сельскохозяйственная Пристанская
+      Хлебная Условная Зорге Козлова Заслонова Курганская Мурманская Дунайская
+      Жигулевская Егорова Добровольского Писарева Орлова Нариманова Пестеля
+      Автомобильная Большевиков Брестская Салавата Квартальная Люксембург
+      Кропоткина Культурная Мамина-Сибиряка Гончарная Пермская Водная
+      Беломорская Пугачевская Краснооктябрьская Кузбасская Днепровская
+      Объездная Армавирская Верещагина Проселочная Ползунова Учебная Тукаева
+      Филатова Стрельникова Львовская Кулибина Интернационала Водопьянова
+      Соловьиная Черниговская Каспийская Известковая Ильинская Инициативная
+      Луганская Покрышкина Новогодняя Обручева Алексеева Силикатная Ташкентская
+      Худайбердина Магнитогорская Горская Вологодская Державина Бебеля Славы
+      Русская Правобережная} +
+      [
+        '1 Мая', '30 лет Победы', '40 лет ВЛКСМ', '40 лет Победы', '40 лет Октября', '50 лет ВЛКСМ', '50 лет Победы',
+        '50 лет Октября', '60 лет СССР', '60 лет Октября', '70 лет Октября', '8 Марта', '9 Мая', 'Зои Космодемьянской',
+        'Мусы Джалиля', 'Лизы Чайкиной', 'Льва Толстого', 'Розы Люксембург', 'Сакко и Ванцетти', 'Карла Маркса',
+        'Клары Цеткин', 'Олега Кошевого', 'Карла Либкнехта', 'Сергея Лазо', 'Дружбы Народов', 'Красных Зорь',
+        'Красная Горка', 'Маршала Жукова', 'Степана Разина', 'Демьяна Бедного', 'Молодой Гвардии', 'Красных Партизан',
+        'Максима Горького', 'Павлика Морозова', 'Богдана Хмельницкого', 'Сосновый бор', 'Салавата Юлаева',
+        'Советской Армии', 'Парижской Коммуны'
+      ]).map { |str| "ул. #{str}" } + %w{
+        Школьный Садовый Лесной Зеленый Советский Новый Октябрьский
+        Первомайский Комсомольский Пионерский Южный Северный Больничный Речной
+        Почтовый Восточный Молодежный Рабочий Солнечный Колхозный Заводской
+        Тихий Западный Степной Спортивный Центральный Луговой Кооперативный
+        Полевой Пролетарский Мирный Железнодорожный Клубный Совхозный
+        Красноармейский Дорожный Горный Заречный Озерный Майский Парковый
+        Набережный Дачный Строительный Юбилейный Малый Короткий Сосновый
+        Светлый Овражный Безымянный Березовый Береговой Пушкина Партизанский
+        Нагорный Красный Чапаева Кирова Вокзальный Коммунальный Строителей
+        Кузнечный Кирпичный Базарный Калинина Гагарина Песчаный Цветочный
+        Ленина Веселый Трудовой Мостовой Дальний Торговый Мира Мельничный
+        Вишневый Транспортный Московский Лермонтова Горького Некрасова Чехова
+        Маяковского Фабричный Чкалова Широкий Подгорный Дружбы Весенний
+        Тупиковый Шоссейный Средний Гоголя Матросова Ключевой Шевченко Крупской
+        Победы Свободный Узкий Звездный Коммунистический Линейный Таежный
+        Ленинский Свердлова Донской Островского Фрунзе Дзержинского Пушкинский
+        Станционный Мичурина Гаражный Казачий Кривой Глухой Верхний Тургенева
+        Суворова Кольцевой Куйбышева Виноградный Свободы Крайний Крестьянский
+        Песочный Интернациональный Кубанский Банный Чернышевского Гвардейский
+        Уральский Огородный Братский Театральный Крутой Пожарный Родниковый
+        Урицкого Промышленный Сибирский Ломоносова Кировский Карьерный
+        Механизаторов Болотный Привокзальный Энергетиков Гражданский Нижний
+        Володарского Энгельса Ленинградский Урожайный Тупой Щорса Буденного
+        Сенной Котовского Сельский Сиреневый Толстого Луначарского Волжский
+        Тракторный Стадионный Кедровый Комарова Герцена Марта Прямой
+        Революционный Целинный Элеваторный Киевский Крылова Детский Аптечный
+        Профсоюзный Учительский Каменный Кутузова Загородный Пугачева Радужный
+        Пригородный}.map { |str| str.end_with?("й") ? "#{str} пер." : "пер. #{str}" } +
+      [
+        'пл. Ленина', 'пр-т Ленина', 'Советская пл.', 'Школьный проезд', 'Микрорайон', 'пр-т Мира',
+        '1 линия', '2 линия', 'пл. Революции', '3 линия', 'пл. Победы', 'мкр. Северный', 'Садовый проезд',
+        'Лесной проезд', 'Московское ш.', 'пл. Свободы пл', 'Северный проезд'
+      ]
+    ).freeze
+  end
+end