faker 3.5.3 → 3.6.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 1451a74f2ed552404727bf2dfe6711edcdd7c6231cb1780a0d99050324b7b448
-  data.tar.gz: 63bdcd753bb373c03dc1f43e36a9fd79622ffe09c9a2c5748759475901b251e1
+  metadata.gz: f0f1f57798bdd12f9abe18fb1addd4d6ed4126bd9dd6511f85f65db979a8f09f
+  data.tar.gz: 11c90330d5e8d3aa1135acd2ec8b830ccdc84bfecfdab608a5104e73cc5cf46f
 SHA512:
-  metadata.gz: eca06030ce6ac8b3000d35df1214b262cd929964ab0c4fc23c5501ff0f6d5ed2717361bc61f7da2be2edc909cae5a1c17f762f2df1a2a2c77250c98db7167ab6
-  data.tar.gz: 49effb24c9837d69685458f9763cde1194164466c3adc73851ec8cbba680804def10fe8e94d6f89acf7ef7e2e6503a74905ef76302521d80adf548ab88c88879
+  metadata.gz: cc7aefa18cbf98cb6cf85de656e2b61bbc4c9ef42ba40f381113b3c7ec22be420ea04fa8cc8d7ae1ed30871bc95ce8a14117ae6d600a97b78c16857b2bf05fd2
+  data.tar.gz: 3f82d2eda0d9758364947ae6642f1d92b0db82589884a83a42f3ac08ae30cd59b85c0b60dc1b712595e2950cc97e8c1adb266445cdaea54725b195bd3ec17d1a

data/CHANGELOG.md

@@ -1,5 +1,84 @@
 # Changelog
 
+## [v3.6.1](https://github.com/faker-ruby/faker/tree/v3.6.1) (2026-03-04)
+
+It's almost Spring time in the Northern hemisphere 🌸 
+
+### Security, performance improvements and bug fixes
+
+* fix: polynomial regex on uncontrolled input by @thdaraujo in https://github.com/faker-ruby/faker/pull/3196
+* perf: replaces list of postcodes in `ja/address.yml` with a 7-digit format by @thdaraujo in https://github.com/faker-ruby/faker/pull/3201
+* Remove unnecessary whitespace from code blocks in READMEs by @ryotaro-shirai in https://github.com/faker-ruby/faker/pull/3209
+* Document lazy load experiment results by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3205
+* [skip ci] Add-backtick by @OzuAkira in https://github.com/faker-ruby/faker/pull/3210
+* Zeitwerk experiment changes and results [skip ci] by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3213
+* Remove duplicate reference link in README.md by @yutasb in https://github.com/faker-ruby/faker/pull/3217
+
+### Update development dependencies
+
+* Bump rubocop from 1.84.0 to 1.84.1 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3202
+* Bump irb from 1.16.0 to 1.17.0 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3203
+* Bump rubocop version and fix offenses by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3198
+* Bump rdoc from 7.1.0 to 7.2.0 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3204
+* Bump rubocop to 1.84.2 by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3215
+* Bump rubocop-minitest from 0.38.2 to 0.39.1 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3216
+* Bump rubocop to v1.85.0 by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3220
+
+### New Contributors
+* @ryotaro-shirai made their first contribution in https://github.com/faker-ruby/faker/pull/3209
+* @OzuAkira made their first contribution in https://github.com/faker-ruby/faker/pull/3210
+* @yutasb made their first contribution in https://github.com/faker-ruby/faker/pull/3217
+
+**Full Changelog**: https://github.com/faker-ruby/faker/compare/v3.6.0...v3.6.1
+
+---------------------------------
+
+## [v3.6.0](https://github.com/faker-ruby/faker/tree/v3.6.0) (2026-01-21)
+
+First release of the new year!
+
+This version comes with some performance improvements (speeds faker load time by 17%!) and removal of deprecated generators.
+
+It also drops support to Ruby's EOL `3.0`. The minimum supported Ruby version is `3.1`.
+
+### Drops support for Ruby 3.0
+
+* Drop support for Ruby EOL 3.0 by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3167
+
+### Removes deprecated generators
+
+* `Faker::Twitter` and `Faker::BossaNova` have been removed. Please use the new generators `Faker::X` and `Faker::Music::BossaNova` and check the new docs for more details in https://github.com/faker-ruby/faker/pull/3190
+
+### Improvements and bug fixes
+
+* Autoload OpenSSL by @stefannibrasil and @thdaraujo in https://github.com/faker-ruby/faker/pull/3188 - this speeds faker load time by 17%!
+* Fix typos in README.md by @CarlosCalgaro in https://github.com/faker-ruby/faker/pull/3156
+* fix: badly anchored regexes by @thdaraujo in https://github.com/faker-ruby/faker/pull/3181
+* Benchmark revamp + run benchmark as part of CI by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3176
+* Add reformat locales rake task by @thdaraujo in https://github.com/faker-ruby/faker/pull/3061
+* Add option to trigger GH workflows manually by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3187
+
+### Update development dependencies
+
+* Bump bundler version by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3165
+* Add GitHub actions to dependabot workflow by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3168
+* Bump pry from 0.15.2 to 0.16.0 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3175
+* Bump i18n from 1.14.7 to 1.14.8 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3174
+* Bump yard from 0.9.37 to 0.9.38 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3173
+* Bump actions/checkout from 3 to 6 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3170
+* Bump test-unit from 3.7.1 to 3.7.7 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3172
+* Bump github/codeql-action from 2 to 4 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3169
+* Bump rubocop from 1.81.7 to 1.82.1 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3171
+* Bump minitest from 5.26.1 to 5.27.0 by @dependabot[bot] in https://github.com/faker-ruby/faker/pull/3177
+* Bump 'rdoc' dependency, handle 'erb' version constraint with Ruby 3.1 and improve CI bundle cache by @stefannibrasil in https://github.com/faker-ruby/faker/pull/3185
+
+### New Contributors
+* @CarlosCalgaro made their first contribution in https://github.com/faker-ruby/faker/pull/3156
+
+**Full Changelog**: https://github.com/faker-ruby/faker/compare/v3.5.3...v3.6.0
+
+---------------------------------
+
 ## [v3.5.3](https://github.com/faker-ruby/faker/tree/v3.5.3) (2025-12-02)
 
 Wishing you a cozy and calm Holiday season ☃️ 

data/README.md

@@ -11,7 +11,6 @@
 [github-actions]: https://github.com/faker-ruby/faker/actions
 [downloads-total]: https://img.shields.io/gem/dt/faker.svg
 [downloads-badge]: https://img.shields.io/gem/dtv/faker.svg
-[downloads-badge]: https://img.shields.io/gem/dtv/faker.svg
 
 ## Quick links
 
@@ -26,12 +25,12 @@
 - Internet: Email addresses, Passwords, Domains, etc.
 - Date and Time: Travel back in time or to the future.
 - Person: Names, Genders, Bios, Job titles, and more.
-- Number add String: Random numbers and strings.
+- Number and String: Random numbers and strings.
 - Location: Addresses, Zip Codes, Street Names, States, and Countries.
 - Finance: Account Details, Transactions, and Crypto Addresses.
 - Localization - Customize faker with over 40 locales to generate realistic-looking Names, Addresses, and Phone Numbers.
 
-> **Note** The generated names, addresses, emails, phone numbers, and/or other data might return valid information. Please be careful when using faker in your tests.
+> **Note:** The generated names, addresses, emails, phone numbers, and/or other data might return valid information. Please be careful when using faker in your tests.
 
 For a complete list of the generators, see [Generators](./GENERATORS.md).
 
@@ -104,8 +103,8 @@ Faker::Name.unique.clear     # Clears used values for Faker::Name
 Faker::UniqueGenerator.clear # Clears used values for all generators
 ```
 
-You also can give some already used values to the unique generator if you have
-collisions with the generated data (i.e: using FactoryBot with random and
+You can also give some already-used values to the unique generator if you have
+collisions with the generated data (i.e., using FactoryBot with random and
 manually set values).
 
 ```ruby
@@ -153,11 +152,11 @@ check out the [locales README](lib/locales/README.md).
 
 ### Minitest and Faker >= 2.22
 
-To prevent Faker (version >= 2.22) from [generating duplicate values]((https://github.com/faker-ruby/faker/issues/2534)) when using Minitest,
+To prevent Faker (version >= 2.22) from [generating duplicate values](https://github.com/faker-ruby/faker/issues/2534) when using Minitest,
 you might need to add the following to the `test_helper.rb` or `rails_helper.rb` file:
 
 ```ruby
-  Faker::Config.random = Random.new
+Faker::Config.random = Random.new
 ```
 
 ## Generators

data/lib/faker/blockchain/bitcoin.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'openssl'
 require 'securerandom'
 
 module Faker

data/lib/faker/blockchain/tezos.rb

@@ -1,6 +1,5 @@
 # frozen_string_literal: true
 
-require 'openssl'
 require 'securerandom'
 
 module Faker

data/lib/faker/default/avatar.rb

@@ -37,7 +37,7 @@ module Faker
       #
       # @faker.version 1.4.3
       def image(slug: nil, size: '300x300', format: 'png', set: 'set1', bgset: nil)
-        raise ArgumentError, 'Size should be specified in format 300x300' unless size =~ /^[0-9]+x[0-9]+$/
+        raise ArgumentError, 'Size should be specified in format 300x300' unless size =~ /\A[0-9]+x[0-9]+\z/
         raise ArgumentError, "Supported formats are #{SUPPORTED_FORMATS.join(', ')}" unless SUPPORTED_FORMATS.include?(format)
 
         slug ||= Faker::Lorem.words.join

data/lib/faker/default/crypto.rb

@@ -1,7 +1,5 @@
 # frozen_string_literal: true
 
-require 'openssl'
-
 module Faker
   class Crypto < Base
     class << self

data/lib/faker/default/id_number.rb

@@ -137,7 +137,7 @@ module Faker
           Faker::Number.number(digits: 2),
           Faker::Number.between(from: 13, to: 99),
           Faker::Number.between(from: 32, to: 99)
-        ].map(&:to_s).join
+        ].join
 
         id_number = [
           invalid_date_of_birth,

data/lib/faker/default/lorem_flickr.rb

@@ -96,7 +96,7 @@ module Faker
       private
 
       def build_url(size, format, search_terms, match_all)
-        raise ArgumentError, 'Size should be specified in format 300x300' unless size =~ /^[0-9]+x[0-9]+$/
+        raise ArgumentError, 'Size should be specified in format 300x300' unless size =~ /\A[0-9]+x[0-9]+\z/
 
         url_parts = ['https://loremflickr.com']
         url_parts << format

data/lib/faker/default/placeholdit.rb

@@ -30,7 +30,7 @@ module Faker
         background_color = generate_color if background_color == :random
         text_color = generate_color if text_color == :random
 
-        raise ArgumentError, 'Size should be specified in format 300x300' unless size =~ /^[0-9]+x[0-9]+$/
+        raise ArgumentError, 'Size should be specified in format 300x300' unless size =~ /\A[0-9]+x[0-9]+\z$/
         raise ArgumentError, "Supported formats are #{SUPPORTED_FORMATS.join(', ')}" unless SUPPORTED_FORMATS.include?(format)
         raise ArgumentError, "background_color must be a hex value without '#'" unless background_color.nil? || background_color =~ /((?:^\h{3}$)|(?:^\h{6}$)){1}(?!.*\H)/
         raise ArgumentError, "text_color must be a hex value without '#'" unless text_color.nil? || text_color =~ /((?:^\h{3}$)|(?:^\h{6}$)){1}(?!.*\H)/

data/lib/faker/default/string.rb

@@ -24,7 +24,7 @@ module Faker
       private
 
       def select_a(length)
-        if length.class.included_modules.include? Enumerable
+        if length.class.include?(Enumerable)
           select_a sample(length.to_enum.to_a)
         else
           length # recursive base case

data/lib/faker/default/x.rb

@@ -0,0 +1,189 @@
+# frozen_string_literal: true
+
+module Faker
+  class X < Base
+    class << self
+      ##
+      # Produces a random X user based on X's v2 API.
+      #
+      # @return [Hash]
+      #
+      # @example
+      #   Faker::X.user #=>  { data: [{:id=>"8821452687517076614", :name=>"Lincoln Paucek", :screen_name=>"cody"...
+      #
+      # @faker.version 1.7.3
+      def user
+        author_id = Faker::Number.between(from: 1, to: 9_223_372_036_854_775_807)
+
+        {
+          data: [
+            {
+              author_id: author_id.to_s,
+              id: id.to_s,
+              text: Faker::Lorem.sentence
+            }
+          ],
+          includes: {
+            users: [
+              {
+                public_metrics: {
+                  followers_count: Faker::Number.between(to: 1, from: 1_000),
+                  following_count: Faker::Number.between(to: 1, from: 200),
+                  tweet_count: Faker::Number.between(to: 1, from: 10_000),
+                  listed_count: Faker::Number.between(to: 1, from: 1_000)
+                },
+                username: screen_name,
+                pinned_tweet_id: Faker::Number.between(from: 1, to: 9_223_372_036_854_775_807).to_s,
+                entities: user_entities,
+                description: Faker::Lorem.sentence,
+                name: Faker::Name.name,
+                verified: Faker::Boolean.boolean(true_ratio: 0.1),
+                location: Faker::Internet.public_ip_v4_address,
+                id: author_id.to_s,
+                protected: Faker::Boolean.boolean(true_ratio: 0.1),
+                url: url,
+                profile_image_url: Faker::Avatar.image(slug: id, size: '48x48'),
+                created_at: created_at
+              }
+            ]
+          }
+        }
+      end
+
+      ##
+      # Produces a random X tweet with default attributes.
+      #
+      # @param include_user [Boolean] Include user details
+      # @param include_media [Boolean] Include user media (photo) details
+      # @return [Hash]
+      #
+      # @example
+      #   Faker::X.tweet #=> { data: [{:id=>"8821452687517076614", :text=>"Ea et laboriosam vel non."...
+      #   Faker::X.tweet(include_media: true) # Get a tweet object with a photo media attachment
+      #   Faker::X.tweet(include_user: true) # Get a tweet object with an user details
+      #
+      # @faker.version 1.7.3
+      def tweet(include_media: false, include_user: false)
+        tweet = {}
+        tweet_object = tweet_item
+        includes = {}
+
+        if include_media
+          media_key = Faker::Number.between(from: 1, to: 9_223_372_036_854_775_807).to_s
+
+          includes[:media] = media(media_key)
+          tweet_object[:attachments] = { media_keys: [media_key] }
+        end
+
+        includes[:users] = user[:includes][:users] if include_user
+
+        tweet[:data] = [
+          tweet_object
+        ]
+
+        unless includes.empty?
+          tweet[:includes] = includes
+        end
+
+        tweet
+      end
+
+      ##
+      # Produces a random screen_name.
+      #
+      # @return [String]
+      #
+      # @example
+      #   Faker::X.screen_name #=> "audreanne_hackett"
+      #
+      # @faker.version 1.7.3
+      def screen_name
+        Faker::Internet.username(specifier: nil, separators: ['_'])[0...20]
+      end
+
+      private
+
+      def id
+        Faker::Number.between(from: 1, to: 9_223_372_036_854_775_807)
+      end
+
+      def created_at
+        Faker::Date.between(from: '2006-03-21', to: ::Date.today).to_time.utc.iso8601(3)
+      end
+
+      def url
+        "https://t.co/#{Faker::Lorem.characters(number: 10)}"
+      end
+
+      def user_entities
+        entities = tweet_entities
+
+        {
+          url: {
+            urls: entities[:urls]
+          },
+          description: {
+            hashtags: entities[:hashtags]
+          }
+        }
+      end
+
+      def tweet_entities
+        display_url = Faker::Internet.url(host: 'example.com')
+
+        {
+          urls: [
+            {
+              start: 0,
+              end: 5,
+              url: url,
+              expanded_url: display_url,
+              display_url: display_url.sub('http://', '')
+            }
+          ],
+          hashtags: [
+            {
+              start: 0,
+              end: 5,
+              tag: Faker::Lorem.word.capitalize
+            }
+          ]
+        }
+      end
+
+      def media(media_key)
+        expanded_url = Faker::LoremFlickr.image(size: '1064x600')
+
+        [{
+          height: Faker::Number.between(to: 1, from: 1000),
+          media_key: media_key,
+          type: 'photo',
+          preview_image_url: expanded_url,
+          width: Faker::Number.between(to: 1, from: 2000),
+          alt_text: Faker::Lorem.sentence
+        }]
+      end
+
+      def tweet_item
+        conversation_id = id.to_s
+
+        {
+          id: conversation_id,
+          text: Faker::Lorem.sentence,
+          lang: sample(%w[en fr es pt it ja]),
+          conversation_id: conversation_id,
+          created_at: created_at,
+          author_id: Faker::Number.between(from: 1, to: 9_223_372_036_854_775_807).to_s,
+          public_metrics: {
+            retweet_count: Faker::Number.between(to: 1, from: 100),
+            reply_count: Faker::Number.between(to: 1, from: 20),
+            like_count: Faker::Number.between(to: 1, from: 25),
+            quote_count: Faker::Number.between(to: 1, from: 10)
+          },
+          possibly_sensitive: Faker::Boolean.boolean(true_ratio: 0.1),
+          entities: tweet_entities
+        }
+      end
+    end
+  end
+end

data/lib/faker/music/bossa_nova.rb

@@ -34,8 +34,4 @@ module Faker
       end
     end
   end
-
-  include Faker::Deprecator
-
-  deprecate_generator('BossaNova', Music::BossaNova)
 end

data/lib/faker/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Faker # :nodoc:
-  VERSION = '3.5.3'
+  VERSION = '3.6.1'
 end

data/lib/faker.rb

@@ -5,6 +5,8 @@ mydir = __dir__
 require 'psych'
 require 'i18n'
 
+autoload(:OpenSSL, 'openssl')
+
 Dir.glob(File.join(mydir, 'helpers', '*.rb')).each { |file| require file }
 
 I18n.load_path += Dir[File.join(mydir, 'locales', '**/*.yml')]
@@ -65,8 +67,8 @@ module Faker
         letterify(numerify(string))
       end
 
-      def generate(as_type, &block)
-        PositionalGenerator.new(as_type, &block).generate
+      def generate(as_type, &)
+        PositionalGenerator.new(as_type, &).generate
       end
 
       # Given a regular expression, attempt to generate a string
@@ -93,12 +95,12 @@ module Faker
         reg
           .gsub(%r{^/?\^?}, '').gsub(%r{\$?/?$}, '') # Ditch the anchors
           .gsub(/\{(\d+)\}/, '{\1,\1}').gsub('?', '{0,1}') # All {2} become {2,2} and ? become {0,1}
-          .gsub(/(\[[^\]]+\])\{(\d+),(\d+)\}/) { |_match| Regexp.last_match(1) * sample(Array(Range.new(Regexp.last_match(2).to_i, Regexp.last_match(3).to_i))) }                # [12]{1,2} becomes [12] or [12][12]
-          .gsub(/(\([^)]+\))\{(\d+),(\d+)\}/) { |_match| Regexp.last_match(1) * sample(Array(Range.new(Regexp.last_match(2).to_i, Regexp.last_match(3).to_i))) }                 # (12|34){1,2} becomes (12|34) or (12|34)(12|34)
-          .gsub(/(\\?.)\{(\d+),(\d+)\}/) { |_match| Regexp.last_match(1) * sample(Array(Range.new(Regexp.last_match(2).to_i, Regexp.last_match(3).to_i))) }                      # A{1,2} becomes A or AA or \d{3} becomes \d\d\d
-          .gsub(/\((.*?)\)/) { |match| sample(match.gsub(/[()]/, '').split('|')) } # (this|that) becomes 'this' or 'that'
-          .gsub(/\[([^\]]+)\]/) { |match| match.gsub(/(\w-\w)/) { |range| sample(Array(Range.new(*range.split('-')))) } } # All A-Z inside of [] become C (or X, or whatever)
-          .gsub(/\[([^\]]+)\]/) { |_match| sample(Regexp.last_match(1).chars) } # All [ABC] become B (or A or C)
+          .gsub(/(\[[^\]]++\])\{(\d+),(\d+)\}/) { |_match| Regexp.last_match(1) * sample(Array(Range.new(Regexp.last_match(2).to_i, Regexp.last_match(3).to_i))) }                # [12]{1,2} becomes [12] or [12][12]
+          .gsub(/(\([^)]++\))\{(\d+),(\d+)\}/) { |_match| Regexp.last_match(1) * sample(Array(Range.new(Regexp.last_match(2).to_i, Regexp.last_match(3).to_i))) }                 # (12|34){1,2} becomes (12|34) or (12|34)(12|34)
+          .gsub(/(\\?.)\{(\d+),(\d+)\}/) { |_match| Regexp.last_match(1) * sample(Array(Range.new(Regexp.last_match(2).to_i, Regexp.last_match(3).to_i))) }                       # A{1,2} becomes A or AA or \d{3} becomes \d\d\d
+          .gsub(/\((.*?)\)/) { |match| sample(match.gsub(/[()]/, '').split('|')) }                                                                                                # (this|that) becomes 'this' or 'that'
+          .gsub(/\[([^\]]++)\]/) { |match| match.gsub(/(\w-\w)/) { |range| sample(Array(Range.new(*range.split('-')))) } }                                                        # All A-Z inside of [] become C (or X, or whatever)
+          .gsub(/\[([^\]]++)\]/) { |_match| sample(Regexp.last_match(1).chars) }                                                                                                  # All [ABC] become B (or A or C)
           .gsub('\d') { |_match| sample(Numbers) }
           .gsub('\w') { |_match| sample(Letters) }
       end
@@ -131,7 +133,8 @@ module Faker
       # formatted translation: e.g., "#{first_name} #{last_name}".
       def parse(key)
         fetched = fetch(key)
-        parts = fetched.scan(/(\(?)#\{([A-Za-z]+\.)?([^}]+)\}([^#]+)?/).map do |prefix, kls, meth, etc|
+
+        parts = fetched.scan(/(\(?)#\{([A-Za-z]+\.)?([^}]+)\}([^#]++)?/).map do |prefix, kls, meth, etc|
           # If the token had a class Prefix (e.g., Name.first_name)
           # grab the constant, otherwise use self
           cls = kls ? Faker.const_get(kls.chop) : self
@@ -195,7 +198,7 @@ module Faker
       #   name:
       #     girls_name: ["Alice", "Cheryl", "Tatiana"]
       # Then you can call Faker::Name.girls_name and it will act like #first_name
-      def method_missing(mth, *args, &block)
+      def method_missing(mth, *args, &)
         super unless flexible_key
 
         if (translation = translate("faker.#{flexible_key}.#{mth}"))

data/lib/helpers/unique_generator.rb

@@ -30,7 +30,7 @@ module Faker
       method_name.to_s.start_with?('faker_') || super
     end
 
-    RetryLimitExceeded = Class.new(StandardError)
+    class RetryLimitExceeded < StandardError; end
 
     def previous_results
       Thread.current[:faker_unique_generator_previous_results] ||= {}

data/lib/locales/README.md

@@ -20,7 +20,7 @@ Faker::Hipster.word #=> "kogi"
 
 ## How to update a locale with more translations
 
-To update a locale with more translation features, simply add a new field to the .yml file that corresponds to an existing piece of functionality in the "en.yml" file. In this example, that would mean providing Chinese hipster words.
+To update a locale with more translation features, simply add a new field to the `.yml` file that corresponds to an existing piece of functionality in the "en.yml" file. In this example, that would mean providing Chinese hipster words.
 
 ```yaml
 # /lib/locales/zh-CN.yml
@@ -52,5 +52,5 @@ Faker::Config.default_locale = :pt
 In threaded server environments, e.g., Puma, locale per thread can be set as the following:
 
 ```ruby
-  Faker::Config.locale = :es
+Faker::Config.locale = :es
 ```

data/lib/locales/ar.yml

@@ -940,7 +940,8 @@ ar:
         - وأبناؤه
         - المحدودة
       buzzwords:
-        - - حركات
+        -
+          - حركات
           - رهيب
           - بعد نظر
           - تقنية
@@ -988,7 +989,8 @@ ar:
           - قراءة
           - مبهر
       bs:
-        - - ينفّذ
+        -
+          - ينفّذ
           - ينفع
           - يدمج
           - يحسّن
@@ -1025,7 +1027,8 @@ ar:
           - يزرع
           - ينتج
           - يعيد تعريف
-        - - نقرات وقذائف
+        -
+          - نقرات وقذائف
           - قيمة مضافة
           - عمودي
           - استباقي
@@ -1066,7 +1069,8 @@ ar:
           - مخصّص
           - متعاون
           - غنيّ
-        - - القابضة
+        -
+          - القابضة
           - نماذج
           - الأسواق
           - الشراكات