Remove deprecate safe_email and free_email methods (#2841)

* refactor: 💡 remove safe_email, free_email

* test: 💍 remove safe_email, free_email test

* refactor: 💡 remove safe_email, free_email from lib/locales/

* refactor: 💡 remove safe_email, free_email from internet.md

* refactor: 💡 remove extend Gem::Deprecate

* refactor: 💡 rubocop -a --only Layout/EmptyLinesAroundClassBody

Author: hatsu38

doc/default/internet.md

@@ -1,18 +1,5 @@
 # Faker::Internet
 
-### About faker-ruby transition to be RFC 2606 compliant
-
-faker-ruby is transitioning to no longer generating real email and url addresses.
-
-The migration plan is:
-- First step:
-  - change `email` and `domain_name` to be RFC 2606 compliant. Both now generate safe values by default using the Reserved Top Level DNS Names: `example` and `test`. To maintain backwards compatibility and give users the option to use non-safe domains at their own risk, custom domains are allowed.
-  - add deprecation message for `free_email` and `safe_email` users to switch to `email` instead.
-- Second step (after October 2023):
-  - remove deprecated generators and locales.
-
-To give users time, once the first step is released, users will have until October 2023 to make the necessary changes.
-
 ```ruby
 # Keyword arguments: name, username, email, password, domain_name, user_agent, uuid etc...
 Faker::Internet.user #=> { username: 'alexie', email: '[email protected]' }
@@ -25,15 +12,6 @@ Faker::Internet.email(name: 'Janelle Santiago', separators: ['+']) #=> "janelle+
 Faker::Internet.email(domain: 'gmail.com')  #=> "[email protected]"
 Faker::Internet.email(name: 'sam smith', separators: ['-'], domain: 'test') #=> "[email protected]"
 
-# Keyword arguments: name
-Faker::Internet.free_email #=> "[email protected]"
-Faker::Internet.free_email(name: 'Nancy') #=> "[email protected]"
-
-# Generates an RFC 2606 compliant fake email, which means it will never deliver successfully
-# Keyword arguments: name
-Faker::Internet.safe_email #=> "[email protected]"
-Faker::Internet.safe_email(name: 'Nancy') #=> "[email protected]"
-
 # Keyword arguments: specifier, separators
 Faker::Internet.username #=> "alexie"
 Faker::Internet.username(specifier: 'Nancy') #=> "nancy"

lib/faker/default/internet.rb

@@ -15,8 +15,6 @@ class Internet < Base
     ].each(&:freeze).freeze
 
     class << self
-      extend Gem::Deprecate
-
       ##
       # Returns the email address
       #
@@ -50,42 +48,6 @@ def email(name: nil, separators: nil, domain: nil)
         construct_email(sanitized_local_part, generate_domain)
       end
 
-      ##
-      # Returns the email address with domain either gmail.com, yahoo.com or hotmail.com
-      #
-      # @return [String]
-      #
-      # @param name [String]
-      #
-      # @example
-      #   Faker::Internet.free_email                                                           #=> "[email protected]"
-      #   Faker::Internet.free_email(name: 'smith')                                            #=> "[email protected]"
-      def free_email(name: nil)
-        construct_email(
-          sanitize_email_local_part(username(specifier: name)),
-          fetch('internet.free_email')
-        )
-      end
-      deprecate :free_email, :email, 2023, 10
-
-      ##
-      # Returns the email address with fixed domain name as 'example'
-      #
-      # @return [String]
-      #
-      # @param name [String]
-      #
-      # @example
-      #   Faker::Internet.safe_email                                                           #=> "[email protected]"
-      #   Faker::Internet.safe_email(name: 'smith')                                            #=> "[email protected]"
-      def safe_email(name: nil)
-        construct_email(
-          sanitize_email_local_part(username(specifier: name)),
-          "example.#{sample(%w[org com net])}"
-        )
-      end
-      deprecate :safe_email, :email, 2023, 10
-
       ##
       # Returns the username
       #

lib/locales/bg.yml

@@ -17,7 +17,6 @@ bg:
       default_country: [България]
       default_country_code: ["BG"]
     internet:
-      free_email: [abv.bg, mail.bg, dir.bg, gmail.com, yahoo.com, hotmail.com]
       domain_suffix: [com, bg, info, бг, net, org]
 
     name:

lib/locales/de-AT.yml

@@ -622,10 +622,6 @@ de-AT:
         - "#{Name.last_name}-#{Name.last_name}"
         - "#{Name.last_name}, #{Name.last_name} und #{Name.last_name}"
     internet:
-      free_email:
-        - gmail.com
-        - yahoo.com
-        - hotmail.com
       domain_suffix:
         - com
         - info

lib/locales/de-CH.yml

@@ -3505,14 +3505,6 @@ de-CH:
         - "#{half_wind_azimuth}"
         - "#{quarter_wind_azimuth}"
     internet:
-      free_email:
-        - gmail.com
-        - yahoo.com
-        - hotmail.com
-        - gmx.de
-        - web.de
-        - mail.de
-        - freenet.de
       domain_suffix:
         - ch
         - com

lib/locales/de.yml

@@ -1510,14 +1510,6 @@ de:
         - "#{half_wind_azimuth}"
         - "#{quarter_wind_azimuth}"
     internet:
-      free_email:
-        - gmail.com
-        - yahoo.com
-        - hotmail.com
-        - gmx.de
-        - web.de
-        - mail.de
-        - freenet.de
       domain_suffix:
         - com
         - info

lib/locales/ee.yml

@@ -36,7 +36,6 @@ ee:
         - "#{suffix} #{Name.last_name}"
 
     internet:
-      free_email: [gmail.com, yahoo.com, hotmail.com]
       domain_suffix: [com, com.ee, ee, net, org]
 
     name:

lib/locales/en-CA.yml

@@ -35,10 +35,6 @@ en-CA:
       default_country_code:
         - CA
     internet:
-      free_email:
-        - gmail.com
-        - yahoo.ca
-        - hotmail.com
       domain_suffix:
         - ca
         - com

lib/locales/en-IND.yml

@@ -1241,10 +1241,6 @@ en-IND:
       default_country_code:
         - IN
     internet:
-      free_email:
-        - gmail.com
-        - yahoo.co.in
-        - hotmail.com
       domain_suffix:
         - in
         - com

lib/locales/en-NEP.yml

@@ -205,11 +205,6 @@ en-NEP:
       default_country:
         - Nepal
     internet:
-      free_email:
-        - worldlink.com.np
-        - gmail.com
-        - yahoo.com
-        - hotmail.com
       domain_suffix:
         - np
         - com