ffaker 2.10.0 → 2.23.0

data/lib/ffaker/image.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'cgi'
 require 'tempfile'
 require 'open-uri'
 
@@ -10,7 +11,18 @@ module FFaker
 
     SUPPORTED_FORMATS = %w[png jpg jpeg gif].freeze
 
-    def url(size = '300x300', format = 'png', bg_color = :random, text_color = :random, text = nil)
+    ## `*args` for old format support, it will be removed with deprecation
+    # rubocop:disable Metrics/ParameterLists
+    def url(*args, size: '300x300', format: 'png', bg_color: :random, text_color: :random, text: nil)
+      if args.any?
+        warn "Positional arguments for Image##{__method__} are deprecated. Please use keyword arguments."
+        size = args[0]
+        format = args[1] if args.size > 1
+        bg_color = args[2] if args.size > 2
+        text_color = args[3] if args.size > 3
+        text = args[4] if args.size > 4
+      end
+
       check_size!(size)
       check_format!(format)
 
@@ -18,32 +30,43 @@ module FFaker
       text_color = FFaker::Color.hex_code if text_color == :random
       text = CGI.escape(text.to_s)
 
-      "https://via.placeholder.com/#{size}/#{bg_color}/#{text_color}.#{format}?text=#{text}"
+      "https://dummyimage.com/#{size}/#{bg_color}/#{text_color}.#{format}?text=#{text}"
     end
+    # rubocop:enable Metrics/ParameterLists
+
+    ## `*args` for old format support, it will be removed with deprecation
+    # rubocop:disable Metrics/ParameterLists
+    def file(*args, size: '300x300', format: 'png', bg_color: :random, text_color: :random, text: nil)
+      if args.any?
+        warn "Positional arguments for Image##{__method__} are deprecated. Please use keyword arguments."
+        size = args[0]
+        format = args[1] if args.size > 1
+        bg_color = args[2] if args.size > 2
+        text_color = args[3] if args.size > 3
+        text = args[4] if args.size > 4
+      end
 
-    def file(size = '300x300', format = 'png', bg_color = :random, text_color = :random, text = nil)
-      download_file(url(size, format, bg_color, text_color, text))
+      uri = URI.parse(url(size: size, format: format, bg_color: bg_color, text_color: text_color, text: text))
+      file = Tempfile.new('ffaker_image')
+      file.binmode
+      file << uri.open.read
+      file.close
+      File.new(file.path)
     end
+    # rubocop:enable Metrics/ParameterLists
 
     private
 
     def check_size!(size)
-      return true if size =~ /\A\d+x\d+\z/
+      return true if size.match?(/\A\d+x\d+\z/)
+
       raise ArgumentError, 'Size should be specified in format 300x300'
     end
 
     def check_format!(format)
       return true if SUPPORTED_FORMATS.include?(format)
-      raise ArgumentError, "Supported formats are #{SUPPORTED_FORMATS.join(', ')}"
-    end
 
-    def download_file(url)
-      file = Tempfile.new('ffaker_image')
-      file.binmode
-      file << Kernel.open(url).read
-      file.close
-
-      File.new(file.path)
+      raise ArgumentError, "Supported formats are #{SUPPORTED_FORMATS.join(', ')}"
     end
   end
 end

data/lib/ffaker/internet.rb

@@ -1,13 +1,15 @@
-# encoding: utf-8
+# frozen_string_literal: true
 
 module FFaker
   module Internet
     extend ModuleUtils
     extend self
 
-    BYTE = [*'0'..'255'].freeze
+    BYTE = Array('0'..'255').freeze
     HOSTS = %w[gmail.com yahoo.com hotmail.com].freeze
-    DISPOSABLE_HOSTS = %w[mailinator.com suremail.info spamherelots.com binkmail.com safetymail.info].freeze
+    DISPOSABLE_HOSTS = %w[
+      mailinator.com suremail.info spamherelots.com binkmail.com safetymail.info
+    ].freeze
     DOMAIN_SUFFIXES = %w[co.uk com us ca biz info name].freeze
     SAFE_DOMAIN_SUFFIXES = %w[org com net].freeze
     SLUG_DELIMITERS = %w[- _ .].freeze
@@ -18,42 +20,34 @@ module FFaker
     end
 
     # returns an email address of an online disposable email service (like tempinbox.com).
-    # you can really send an email to these addresses an access it by going to the service web pages.
+    # you can really send an email to these addresses an access it by going to the
+    # service web pages.
     def disposable_email(name = nil)
       [user_name(name), fetch_sample(DISPOSABLE_HOSTS)].join('@')
     end
 
     def free_email(name = nil)
-      "#{user_name(name)}@#{fetch_sample(HOSTS)}"
+      [user_name(name), fetch_sample(HOSTS)].join('@')
     end
 
     def safe_email(name = nil)
-      "#{user_name(name)}@example.#{fetch_sample(SAFE_DOMAIN_SUFFIXES)}"
+      [user_name(name), fetch_sample(SAFE_DOMAIN_SUFFIXES)].join('@example.')
     end
 
     def user_name(name = nil)
-      if name
-        parts = shuffle(name.scan(/\w+/)).join(fetch_sample(%w[. _]))
-        parts.downcase
-      else
-        case rand(0..1)
-        when 0
-          sanitize(Name.first_name)
-        when 1
-          [Name.first_name, Name.last_name].map { |n| sanitize(n) }.join(fetch_sample(%w[. _]))
-        end
-      end
+      return shuffle(name.split(' ')).join(fetch_sample(%w[. _])).downcase if name
+
+      return sanitize(Name.first_name) if rand(0..1).zero?
+
+      [sanitize(Name.first_name), sanitize(Name.last_name)].join(fetch_sample(%w[. _]))
     end
 
     def domain_name
-      "#{domain_word}.#{domain_suffix}"
+      [domain_word, domain_suffix].join('.')
     end
 
     def domain_word
-      dw = Company.name.split(' ').first
-      dw.gsub!(/\W/, '')
-      dw.downcase!
-      dw
+      sanitize(Company.name.split(' ').first)
     end
 
     def domain_suffix
@@ -61,7 +55,7 @@ module FFaker
     end
 
     def uri(protocol)
-      "#{protocol}://#{domain_name}"
+      [protocol, domain_name].join('://')
     end
 
     def http_url
@@ -79,8 +73,7 @@ module FFaker
     end
 
     def password(min_length = 8, max_length = 16)
-      length =
-        min_length > max_length ? min_length : fetch_sample([*min_length..max_length])
+      length = min_length > max_length ? min_length : fetch_sample(min_length..max_length)
       String.from_regexp(/\w{#{length}}/)
     end
 

data/lib/ffaker/internet_se.rb

@@ -1,6 +1,4 @@
-# encoding: utf-8
-
-require 'ffaker/internet'
+# frozen_string_literal: true
 
 module FFaker
   module InternetSE
@@ -9,14 +7,16 @@ module FFaker
     extend ModuleUtils
     extend self
 
-    BYTE = [*'0'..'255'].freeze
+    BYTE = Array('0'..'255').freeze
     HOSTS = %w[gmail.com yahoo.com hotmail.com spray.se passagen.se].freeze
     DOMAIN_SUFFIXES = %w[se nu com].freeze
-    DISPOSABLE_HOSTS = %w[mailinator.com suremail.info spamherelots.com binkmail.com safetymail.info].freeze
+    DISPOSABLE_HOSTS = %w[
+      mailinator.com suremail.info spamherelots.com binkmail.com safetymail.info
+    ].freeze
     SLUG_DELIMITERS = %w[- _ .].freeze
 
     def email(name = nil)
-      "#{user_name(name)}@#{domain_name}"
+      +"#{user_name(name)}@#{domain_name}"
     end
 
     # Returns an email address of an online disposable email service
@@ -38,14 +38,12 @@ module FFaker
     # Mostly used for email creation
     def user_name(name = nil)
       return user_name_from_name(name) if name
+
       user_name_random
     end
 
     def user_name_random
-      case rand(0..1)
-      when 0 then user_name_variant_short
-      when 1 then user_name_variant_long
-      end
+      rand(0..1).zero? ? user_name_variant_short : user_name_variant_long
     end
 
     def user_name_variant_long

data/lib/ffaker/jo_jo.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+module FFaker
+  module JoJo
+    extend ModuleUtils
+    extend self
+
+    def full_name
+      fetch_sample(FULL_NAMES)
+    end
+
+    def first_name
+      fetch_sample(FIRST_NAMES)
+    end
+
+    def last_name
+      fetch_sample(LAST_NAMES)
+    end
+
+    def stand
+      fetch_sample(STANDS)
+    end
+  end
+end

data/lib/ffaker/job.rb

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

data/lib/ffaker/job_br.rb

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

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

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

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
@@ -30,7 +30,7 @@ module FFaker
     end
 
     def paragraph(sentence_count = 3)
-      sentences(sentence_count).join('、') + '、' + fetch_sample(SENTENCES_END) + '。'
+      "#{sentences(sentence_count).join('、')}、#{fetch_sample(SENTENCES_END)}。"
     end
 
     def paragraphs(count = 3)

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

@@ -1,8 +1,6 @@
-# encoding: utf-8
 # frozen_string_literal: true
 
 module FFaker
-  # Author Walerian Sobczak <walerian.sobczak@gmail.com> github.com/walerian777
   # Inspirations:
   # https://pl.wiktionary.org
   module LoremPL

data/lib/ffaker/lorem_ru.rb

@@ -1,4 +1,3 @@
-# encoding: utf-8
 # frozen_string_literal: true
 
 module FFaker
@@ -51,7 +50,7 @@ module FFaker
       if CAPITAL_CHARS.include?(string[0])
         string
       else
-        CAPITAL_CHARS[CHARS.index(string[0])] + string[1..-1]
+        CAPITAL_CHARS[CHARS.index(string[0])] + string[1..]
       end
     end
   end

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
 
@@ -37,7 +37,7 @@ module FFaker
     end
 
     def maybe_adj_or_adv
-      fetch_sample(ADJ_AND_ADV) + ' ' if rand(0..1) == 1
+      "#{fetch_sample(ADJ_AND_ADV)} " if rand(0..1) == 1
     end
 
     def simple_title
@@ -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