Add deprecation warning for Faker::Twitter

Besides renaming the generator to Faker::X,
the generator is vastly outdated. Twitter, aka X API, has changed a lot (it's now v2),
and most of the attributes being returned in the user have been deprecated:
https://docs.x.com/x-api/enterprise-gnip-2.0/fundamentals/data-dictionary#no-longer-supported-deprecated-attributes

To maintain backwards compatibility, users still using Faker::Twitter
will keep using it but be notified of the upcoming changes.

Initially, the goal was to only update the `user` generator but
then I realized it wouldn't make sense to leave `status` as it is.

Author: stefannibrasil

lib/faker/default/twitter.rb

@@ -17,6 +17,9 @@ class << self
       #
       # @faker.version 1.7.3
       def user(include_status: true, include_email: false)
+        $stdout.puts('DEPRECATION WARNING: Faker::Internet is deprecated. Use Faker::X instead. Some return attributes \
+          will be removed, check the CHANGELOG for more details.')
+
         user_id = id
         background_image_url = Faker::LoremFlickr.image(size: '600x400')
         profile_image_url = Faker::Avatar.image(slug: user_id, size: '48x48')

test/faker/default/test_twitter.rb

@@ -8,28 +8,34 @@ def setup
   end
 
   def test_user
-    user = @tester.user
+    assert_deprecated do
+      user = @tester.user
 
-    assert_kind_of Hash, user
-    assert_equal(41, user.keys.count)
-    assert_kind_of Hash, user[:status]
-    assert_nil user[:status][:user]
+      assert_kind_of Hash, user
+      assert_equal(41, user.keys.count)
+      assert_kind_of Hash, user[:status]
+      assert_nil user[:status][:user]
+    end
   end
 
   def test_user_with_email
-    user = @tester.user(include_email: true)
+    assert_deprecated do
+      user = @tester.user(include_email: true)
 
-    assert_kind_of Hash, user
-    assert_equal(42, user.keys.count)
-    assert_kind_of String, user[:email]
+      assert_kind_of Hash, user
+      assert_equal(42, user.keys.count)
+      assert_kind_of String, user[:email]
+    end
   end
 
   def test_user_without_status
-    user = @tester.user(include_status: false)
+    assert_deprecated do
+      user = @tester.user(include_status: false)
 
-    assert_kind_of Hash, user
-    assert_equal(40, user.keys.count)
-    assert_nil user[:status]
+      assert_kind_of Hash, user
+      assert_equal(40, user.keys.count)
+      assert_nil user[:status]
+    end
   end
 
   def test_status
@@ -59,4 +65,13 @@ def test_status_with_photo
     assert_equal(1, status[:entities][:media].count)
     assert_equal(10, status[:entities][:media].first.keys.count)
   end
+
+  def assert_deprecated(&block)
+    warning = with_captured_stdout(&block)
+    result = yield block
+
+    refute_predicate warning, :empty?, 'Expected a deprecation warning within the block but received none'
+
+    result
+  end
 end