ffaker 2.7.0 → 2.21.0

data/lib/ffaker/job_cn.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module JobCN

data/lib/ffaker/job_fr.rb

@@ -1,4 +1,4 @@
-# encoding: UTF-8
+# frozen_string_literal: true
 
 module FFaker
   module JobFR

data/lib/ffaker/job_it.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module FFaker
+  module JobIT
+    extend ModuleUtils
+    extend self
+
+    def title
+      "#{fetch_sample(JOB_PREFIX)} #{fetch_sample(JOB_ADJ)} #{fetch_sample(JOB_NOUN)}"
+    end
+  end
+end

data/lib/ffaker/job_ja.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 module FFaker
   module JobJA

data/lib/ffaker/job_kr.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module JobKR

data/lib/ffaker/job_vn.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 module FFaker
   module JobVN

data/lib/ffaker/locale.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Locale
@@ -7,20 +7,16 @@ module FFaker
 
     def code(given_language = nil)
       code_index = LANGUAGE.index(given_language)
-      if given_language && code_index
-        LANGUAGE_CODE[code_index]
-      else
-        fetch_sample(LANGUAGE_CODE)
-      end
+      return LANGUAGE_CODE[code_index] if given_language && code_index
+
+      fetch_sample(LANGUAGE_CODE)
     end
 
     def language(given_code = nil)
-      language_index = LANGUAGE_CODE.index(given_code && given_code.upcase)
-      if given_code && language_index
-        LANGUAGE[language_index]
-      else
-        fetch_sample(LANGUAGE)
-      end
+      language_index = LANGUAGE_CODE.index(given_code&.upcase)
+      return LANGUAGE[language_index] if given_code && language_index
+
+      fetch_sample(LANGUAGE)
     end
   end
 end

data/lib/ffaker/lorem.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   # Based on Perl's Text::Lorem
@@ -7,7 +7,8 @@ module FFaker
     extend self
 
     def characters(character_count = 255)
-      Array.new(character_count < 0 ? 0 : character_count).map { fetch_sample(CHARACTERS) }.join
+      character_count = 0 if character_count.negative?
+      Array.new(character_count).map { fetch_sample(CHARACTERS) }.join
     end
 
     def word
@@ -20,11 +21,9 @@ module FFaker
 
     def sentence(word_count = 4)
       first_word, *last_words = words(word_count + rand(1..5))
-      if last_words.nil?
-        first_word.capitalize
-      else
-        "#{first_word.capitalize} #{last_words.join(' ')}."
-      end
+      return "#{first_word.capitalize} #{last_words.join(' ')}." if last_words
+
+      first_word.capitalize
     end
 
     alias phrase sentence

data/lib/ffaker/lorem_ar.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   # Based on Perl's Text::Lorem

data/lib/ffaker/lorem_br.rb

@@ -0,0 +1,45 @@
+# frozen_string_literal: true
+
+module FFaker
+  # Based on Perl's Text::Lorem
+  module LoremBR
+    extend ModuleUtils
+    extend self
+
+    def characters(character_count = 255)
+      character_count = 0 if character_count.negative?
+      Array.new(character_count).map { fetch_sample(CHARACTERS) }.join
+    end
+
+    def word
+      fetch_sample(WORDS)
+    end
+
+    def words(num = 3)
+      fetch_sample(WORDS, count: num)
+    end
+
+    def sentence(word_count = 4)
+      first_word, *last_words = words(word_count + rand(1..5))
+      return "#{first_word.capitalize} #{last_words.join(' ')}." if last_words
+
+      first_word.capitalize
+    end
+
+    alias phrase sentence
+
+    def sentences(sentence_count = 3)
+      (1..sentence_count).map { sentence }
+    end
+
+    alias phrases sentences
+
+    def paragraph(sentence_count = 3)
+      sentences(sentence_count + rand(0..2)).join(' ')
+    end
+
+    def paragraphs(paragraph_count = 3)
+      (1..paragraph_count).map { paragraph }
+    end
+  end
+end

data/lib/ffaker/lorem_cn.rb

@@ -1,7 +1,6 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
-  # Based on Perl's Text::Lorem
   module LoremCN
     extend ModuleUtils
     extend self

data/lib/ffaker/lorem_fr.rb

@@ -1,4 +1,4 @@
-# encoding: UTF-8
+# frozen_string_literal: true
 
 module FFaker
   module LoremFR

data/lib/ffaker/lorem_ie.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module FFaker
+  module LoremIE
+    extend ModuleUtils
+    extend self
+
+    def word
+      fetch_sample(WORDS)
+    end
+
+    def words(num = 3)
+      fetch_sample(WORDS, count: num)
+    end
+
+    def sentence
+      fetch_sample(SENTENCES)
+    end
+
+    alias phrase sentence
+
+    def sentences(sentence_count = 3)
+      (1..sentence_count).map { fetch_sample(SENTENCES) }
+    end
+
+    alias phrases sentences
+
+    def paragraph
+      fetch_sample(PARAGRAPHS)
+    end
+
+    def paragraphs(paragraph_count = 3)
+      (1..paragraph_count).map { paragraph }
+    end
+
+    def question
+      fetch_sample(QUESTIONS)
+    end
+  end
+end

data/lib/ffaker/lorem_it.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module FFaker
+  module LoremIT
+    extend ModuleUtils
+    extend self
+
+    def word
+      fetch_sample(WORDS)
+    end
+
+    def words(num = 3)
+      fetch_sample(WORDS, count: num)
+    end
+
+    def sentence(word_count = 4)
+      s = words(word_count + rand(0..5))
+      s = s.join(' ')
+      s.capitalize!
+      "#{s}."
+    end
+
+    alias phrase sentence
+
+    def sentences(sentence_count = 3)
+      (1..sentence_count).map { sentence }
+    end
+
+    alias phrases sentences
+
+    def paragraph(sentence_count = 3)
+      sentences(sentence_count + rand(0..2)).join(' ')
+    end
+
+    def paragraphs(paragraph_count = 3)
+      (1..paragraph_count).map { paragraph }
+    end
+  end
+end

data/lib/ffaker/lorem_ja.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module LoremJA

data/lib/ffaker/lorem_kr.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module LoremKR

data/lib/ffaker/lorem_pl.rb

@@ -0,0 +1,60 @@
+# frozen_string_literal: true
+
+module FFaker
+  # Inspirations:
+  # https://pl.wiktionary.org
+  module LoremPL
+    extend ModuleUtils
+    extend self
+
+    def character
+      fetch_sample(CHARACTERS)
+    end
+
+    def characters(count = 10)
+      fetch_sample(CHARACTERS, count: count).join
+    end
+
+    def word
+      fetch_sample(WORDS)
+    end
+
+    def words(count = 3)
+      fetch_sample(WORDS, count: count)
+    end
+
+    def sentence(count = 7)
+      sentence = words(count + rand(0..5))
+      sentence[rand(3..(sentence.length - 3))] += ',' if sentence.length > 10
+      sentence = sentence.join(' ')
+      sentence = sentence.capitalize
+      "#{sentence}#{end_of_sentence}"
+    end
+
+    alias phrase sentence
+
+    def sentences(count = 3)
+      (1..count).map { sentence }
+    end
+
+    alias phrases sentences
+
+    def paragraph(count = 3)
+      sentences(count + rand(0..2)).join(' ')
+    end
+
+    def paragraphs(count = 3)
+      (1..count).map { paragraph }
+    end
+
+    private
+
+    def end_of_sentence
+      case rand(10)
+      when 0..7 then '.'
+      when 8 then '?'
+      when 9 then '!'
+      end
+    end
+  end
+end

data/lib/ffaker/lorem_ru.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 # frozen_string_literal: true
 
 module FFaker

data/lib/ffaker/lorem_ua.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module LoremUA
@@ -17,7 +17,7 @@ module FFaker
       elements = words(word_count + rand(0..9))
       elements.insert(rand(3..(elements.count - 3)), ',') if elements.count > 10
       result = elements.join(' ').gsub(' , ', ', ')
-      capitalize_ukrainian("#{result}#{sentence_type_mark}")
+      capitalize_ukrainian(+"#{result}#{sentence_type_mark}")
     end
 
     alias phrase sentence
@@ -47,9 +47,7 @@ module FFaker
     end
 
     def capitalize_ukrainian(string)
-      unless CAPITAL_CHARS.include?(string[0])
-        string[0] = CAPITAL_CHARS[CHARS.index(string[0])]
-      end
+      string[0] = CAPITAL_CHARS[CHARS.index(string[0])] unless CAPITAL_CHARS.include?(string[0])
       string
     end
   end

data/lib/ffaker/movie.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Movie
@@ -6,8 +6,8 @@ module FFaker
     extend self
 
     SUFFIXES = [
-      'from Hell', 'from Outer Space', 'from Mars', 'from the Black Lagoon', 'with a Thousand Faces',
-      'from Across the Ocean', 'Who Fell to Earth', 'That Came to Dinner'
+      'from Hell', 'from Outer Space', 'from Mars', 'from the Black Lagoon',
+      'with a Thousand Faces', 'from Across the Ocean', 'Who Fell to Earth', 'That Came to Dinner'
     ].freeze
     COLORS = %w[Red Yellow Black White].freeze
 
@@ -59,7 +59,10 @@ module FFaker
       when 10 then "The #{fetch_sample(COLORS)} Rose of #{FFaker::AddressUK.country}"
       when 11 then "Hard Boiled #{fetch_sample(NOUNS)}"
       else
-        ::String.new.tap { |s| n = simple_title; s.replace("#{n} 2: Son of #{n}") }
+        ::String.new.tap do |string|
+          title = simple_title
+          string.replace("#{title} 2: Son of #{title}")
+        end
       end
     end
   end

data/lib/ffaker/music.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Music

data/lib/ffaker/name.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Name
@@ -113,5 +113,9 @@ module FFaker
     def suffix
       fetch_sample(SUFFIXES)
     end
+
+    def pronouns
+      fetch_sample(PRONOUNS)
+    end
   end
 end

data/lib/ffaker/name_ar.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 module FFaker
   module NameAR

data/lib/ffaker/name_br.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module NameBR

data/lib/ffaker/name_cn.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module NameCN

data/lib/ffaker/name_cs.rb

@@ -1,6 +1,4 @@
-# encoding: utf-8
-
-require 'ffaker/name'
+# frozen_string_literal: true
 
 module FFaker
   module NameCS
@@ -10,12 +8,12 @@ module FFaker
     extend self
 
     FIRST_NAMES = {
-      female: %w[Alena Andrea Anna Barbora Božena Dagmar Dana Eliška Eva Hana Helena Irena Ivana Jana Jarmila Jaroslava Jiřina Jitka Kateřina Kristýna Lenka Libuše Lucie Ludmila Marcela Marie Markéta Marta Martina Michaela Miroslava Monika Pavla Petra Tereza Věra Veronika Vlasta Zdeňka Zuzana],
-      male: %w[Adam Aleš Alexandr Alois Antonín Bedřich Bohumil Bohuslav Břetislav Dalibor Daniel David Denis Dominik Dušan Eduard Emil Filip František Ivan Ivo Jakub Jan Jaromír Jaroslav Jindřich Jiří Josef Jozef Kamil Karel Kryštof Ladislav Leoš Libor Lubomír Luboš Luděk Ludvík Lukáš Marcel Marek Marian Martin Matěj Matyáš Michael Michal Milan Miloslav Miloš Miroslav Oldřich Ondřej Otakar Patrik Pavel Petr Přemysl Radek Radim Radomír Radovan René Richard Robert Roman Rostislav Rudolf Samuel Stanislav Šimon Štefan Štěpán Tadeáš Tomáš Václav Viktor Vilém Vít Vítězslav Vladimír Vladislav Vlastimil Vojtěch Vratislav Zbyněk Zdeněk]
+      female: FEMALE_FIRST_NAMES,
+      male: MALE_FIRST_NAMES
     }.freeze
     LAST_NAMES = {
-      female: %w[Dvořáková Černá Benešová Fialová Doležalová Čermáková Blažková Bartošová Čechová Dostálová Bláhová Burešová Dušková Beranová Bednářová Bártová Fišerová Bílková Beránková Brožová Čížková Adámková Daňková Filipová Červenková Čapková Bendová Adamcová Dvořáčková Brabcová Davidová Březinová Dlouhá Dohnalová Burianová Dufková Fojtíková Burdová Červená Boháčová Bartoňová Doleželová Dudová Adamová Bauerová Divišová Coufalová Čejková Berková Balážová],
-      male: %w[Dvořák Černý Beneš Fiala Doležal Čermák Blažek Bartoš Čech Dostál Bláha Bureš Dušek Beran Bednář Bárta Bílek Beránek Fišer Brož Čížek Filip Červenka Adámek Daněk Dvořáček Benda Adamec Brabec Březina David Burian Čapek Dohnal Dlouhý Fojtík Bartoň Červený Dufek Burda Duda Adam Boháč Doležel Baláž Diviš Coufal Bauer Dolejší]
+      female: FEMALE_LAST_NAMES,
+      male: MALE_LAST_NAMES
     }.freeze
     SUFFIXES = %w[Ph.D. Th.D. DSc.].freeze
     GENDERS = %i[male female random].freeze # :nodoc:
@@ -81,8 +79,8 @@ module FFaker
     def select_sex(sex) # :nodoc:
       @fixed_sex ||= nil
       given_sex = @fixed_sex || sex
-      raise ArgumentError, "Unknown sex #{given_sex}" \
-        unless GENDERS.include?(given_sex)
+      raise ArgumentError, "Unknown sex #{given_sex}" unless GENDERS.include?(given_sex)
+
       given_sex == :random ? GENDERS[rand(0..1)] : given_sex
     end
   end

data/lib/ffaker/name_da.rb

@@ -1,6 +1,4 @@
-# encoding: utf-8
-
-require 'ffaker/name'
+# frozen_string_literal: true
 
 module FFaker
   module NameDA
@@ -29,7 +27,7 @@ module FFaker
 
     def first_name(gender = :any)
       case gender
-      when :any then rand(0..1) == 0 ? first_name(:male) : first_name(:female)
+      when :any then rand(0..1).zero? ? first_name(:male) : first_name(:female)
       when :male then fetch_sample(MALE_FIRST_NAMES)
       when :female then fetch_sample(FEMALE_FIRST_NAMES)
       else

data/lib/ffaker/name_de.rb

@@ -1,6 +1,4 @@
-# encoding: utf-8
-
-require 'ffaker/name'
+# frozen_string_literal: true
 
 module FFaker
   module NameDE

data/lib/ffaker/name_es.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module FFaker
+  module NameES
+    extend ModuleUtils
+
+    module_function
+
+    MALE_PREFIXES = %w[D. Dr.].freeze
+    FEMALE_PREFIXES = %w[D.ª Dra.].freeze
+    PREFIXES = (MALE_PREFIXES + FEMALE_PREFIXES).freeze
+    FIRST_NAMES = (FIRST_NAMES_FEMALE + FIRST_NAMES_MALE).freeze
+
+    # In Spain we use two surnames: The father's and the mother's
+    def name
+      "#{first_name} #{last_name} #{last_name}"
+    end
+
+    def name_with_prefix
+      fetch_sample(
+        [
+          female_name_with_prefix,
+          male_name_with_prefix
+        ]
+      )
+    end
+
+    def female_name_with_prefix
+      "#{female_prefix} #{first_name_female} #{last_name} #{last_name}"
+    end
+
+    def male_name_with_prefix
+      "#{male_prefix} #{first_name_male} #{last_name} #{last_name}"
+    end
+
+    def first_name
+      fetch_sample(FIRST_NAMES)
+    end
+
+    def first_name_female
+      fetch_sample(FIRST_NAMES_FEMALE)
+    end
+
+    def first_name_male
+      fetch_sample(FIRST_NAMES_MALE)
+    end
+
+    def last_name
+      fetch_sample(LAST_NAMES)
+    end
+
+    def prefix
+      fetch_sample(PREFIXES)
+    end
+
+    def female_prefix
+      fetch_sample(FEMALE_PREFIXES)
+    end
+
+    def male_prefix
+      fetch_sample(MALE_PREFIXES)
+    end
+  end
+end

data/lib/ffaker/name_fr.rb

@@ -1,7 +1,6 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
-  # Author PapePathe<pathe.sene@gmail.com> github.com/PapePathe
   # The names & first names in this module were found at this url
   # https://github.com/fzaninotto/Faker/blob/master/src/Faker/Provider/fr_FR/Person.php
   module NameFR

data/lib/ffaker/name_ga.rb

@@ -1,4 +1,4 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   # Generates names from Gambia West Africa

data/lib/ffaker/name_gr.rb

@@ -1,7 +1,6 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
-  # Author AntonyFalegkos<falegk1@gmail.com> github.com/falegk
   module NameGR
     extend ModuleUtils
     extend self
@@ -9,7 +8,7 @@ module FFaker
     # Random full name (male or female). Arguments :male, :female, :any
     def full_name(gender = :any)
       case gender
-      when :any then rand(0..1) == 0 ? male_full_name : female_full_name
+      when :any then rand(0..1).zero? ? male_full_name : female_full_name
       when :male then male_full_name
       when :female then female_full_name
       else raise ArgumentError, 'Invalid gender, must be one of :any, :male, :female'

data/lib/ffaker/name_id.rb

@@ -1,5 +1,4 @@
 # frozen_string_literal: true
-# encoding: utf-8
 
 module FFaker
   module NameID

data/lib/ffaker/name_in.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module FFaker
+  # Generates names from India
+  # Source: https://www.momjunction.com/articles/popular-indian-last-names-for-your-baby_00334734/#gref
+  # Source: https://www.babycenter.in/a25024464/top-100-boy-names-in-india-in-2017
+  # Source: https://www.babycenter.in/a25024466/top-100-girl-names-in-india-in-2017
+  module NameIN
+    extend ModuleUtils
+    extend self
+
+    def first_name_female
+      fetch_sample(FIRST_NAMES_FEMALE)
+    end
+
+    def first_name_male
+      fetch_sample(FIRST_NAMES_MALE)
+    end
+
+    def last_name
+      fetch_sample(LAST_NAMES)
+    end
+
+    def name_male
+      "#{first_name_male} #{last_name}"
+    end
+
+    def name_female
+      "#{first_name_female} #{last_name}"
+    end
+
+    def name
+      case rand(0..1)
+      when 1 then name_male
+      else name_female
+      end
+    end
+  end
+end

data/lib/ffaker/name_it.rb

@@ -1,7 +1,6 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
-  # Author microspino<info@microspino.com> github.com/microspino
   module NameIT
     extend ModuleUtils
     extend self
@@ -25,7 +24,7 @@ module FFaker
     def name
       case rand(0..9)
       when 5, 7 then "#{prefix} #{first_name} #{last_name}"
-      else        "#{first_name} #{last_name}"
+      else "#{first_name} #{last_name}"
       end
     end
   end