Changes

• Add Lazy loading config by @stefannibrasil and @thdaraujo in #3244

Enabling lazy load

This version introduces lazy loading. It means users will only pay for what they use. Faker loads 2x faster when it's enabled.

Lazy loading the generators is disabled by default. To enable it, choose one of the configuration options below:

1 - Set lazy load as a Faker Config

Faker::Config.lazy_loading = true

2 - Set lazy load as an environment variable

FAKER_LAZY_LOAD = 1

We hope you get to see the improvement by enabling it. Please file a bug report for any issues!

Thanks to @jeremyevans for the mentoring, and to @thdaraujo for pairing and code reviews.

Full Changelog: v3.7.1...v3.8.0

Thanks to all contributors!

Drops support for Ruby 3.1

• Drop support for Ruby EOL 3.1 by @stefannibrasil in #3240

What's changed

• Remove json_schema and public-suffix versions constraint by @stefannibrasil in #3224
• Added additional football teams by @John222 in #3231
• Remove duplicate 'Recalled to Life' book title by @gkrimer in #3238

Update development dependencies

• Bump yard from 0.9.38 to 0.9.40 by @dependabot[bot] in #3237
• Bump timecop from 0.9.10 to 0.9.11 by @dependabot[bot] in #3236
• Bump rubocop from 1.85.1 to 1.86.1 by @dependabot[bot] in #3235

New Contributors

• @John222 made their first contribution in #3231
• @gkrimer made their first contribution in #3238

Full Changelog: v3.6.1...v3.7.1

It's Spring countdown in the Northern hemisphere 🌸

Security, performance improvements and bug fixes

• fix: polynomial regex on uncontrolled input by @thdaraujo in #3196
• perf: replaces list of postcodes in ja/address.yml with a 7-digit format by @thdaraujo in #3201
• Remove unnecessary whitespace from code blocks in READMEs by @ryotaro-shirai in #3209
• Document lazy load experiment results by @stefannibrasil in #3205
• [skip ci] Add-backtick by @OzuAkira in #3210
• Zeitwerk experiment changes and results [skip ci] by @stefannibrasil in #3213
• Remove duplicate reference link in README.md by @yutasb in #3217

Update development dependencies

• Bump rubocop from 1.84.0 to 1.84.1 by @dependabot[bot] in #3202
• Bump irb from 1.16.0 to 1.17.0 by @dependabot[bot] in #3203
• Bump rubocop version and fix offenses by @stefannibrasil in #3198
• Bump rdoc from 7.1.0 to 7.2.0 by @dependabot[bot] in #3204
• Bump rubocop to 1.84.2 by @stefannibrasil in #3215
• Bump rubocop-minitest from 0.38.2 to 0.39.1 by @dependabot[bot] in #3216
• Bump rubocop to v1.85.0 by @stefannibrasil in #3220

New Contributors

• @ryotaro-shirai made their first contribution in #3209
• @OzuAkira made their first contribution in #3210
• @yutasb made their first contribution in #3217

Full Changelog: v3.6.0...v3.6.1

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 #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 #3190

Improvements and bug fixes

• Autoload OpenSSL by @stefannibrasil and @thdaraujo in #3188 - this speeds faker load time by 17%!
• Fix typos in README.md by @CarlosCalgaro in #3156
• fix: badly anchored regexes by @thdaraujo in #3181
• Benchmark revamp + run benchmark as part of CI by @stefannibrasil in #3176
• Add reformat locales rake task by @thdaraujo in #3061
• Add option to trigger GH workflows manually by @stefannibrasil in #3187

Update development dependencies

• Bump bundler version by @stefannibrasil in #3165
• Add GitHub actions to dependabot workflow by @stefannibrasil in #3168
• Bump pry from 0.15.2 to 0.16.0 by @dependabot[bot] in #3175
• Bump i18n from 1.14.7 to 1.14.8 by @dependabot[bot] in #3174
• Bump yard from 0.9.37 to 0.9.38 by @dependabot[bot] in #3173
• Bump actions/checkout from 3 to 6 by @dependabot[bot] in #3170
• Bump test-unit from 3.7.1 to 3.7.7 by @dependabot[bot] in #3172
• Bump github/codeql-action from 2 to 4 by @dependabot[bot] in #3169
• Bump rubocop from 1.81.7 to 1.82.1 by @dependabot[bot] in #3171
• Bump minitest from 5.26.1 to 5.27.0 by @dependabot[bot] in #3177
• Bump 'rdoc' dependency, handle 'erb' version constraint with Ruby 3.1 and improve CI bundle cache by @stefannibrasil in #3185

New Contributors

• @CarlosCalgaro made their first contribution in #3156

Full Changelog: v3.5.3...v3.6.0

v3.5.3 (2025-12-02)

Wishing you a cozy and calm Holiday season ☃️

This version adds and improves some locales, fixes some bugs, and deprecates some generators.

Thanks to all contributors!

Deprecated generators

• Refactor: move Faker::BossaNova under Faker::Music::BossaNova by @thdaraujo in #3140
• Deprecate Faker::Twitter in favor of Faker::X and update attributes by @stefannibrasil in #3138

Improvements & Bug Fixes

• Remove duplicate entry amateur radio from locales/en/hobby.yml by @Leenday in #3099
• fix #3114: prevent scientific notation when generating bank account number by @AhmedHisham552 in #3118
• Fix: typos in locales for overwatch.yml, rajnikanth.yml and street_fighter.ym by @smorttey in #3106
• Add Artist translations for the japanese locale by @neco-nico in #3110
• Add country_code to Estonia locale (locales/ee.yml) by @HassanAkbar in #3111
• Reformat Arabic locale (locales/ar.yml) by @ramzieus in #3130
• Refactor: Improve UK Phone number false failure hit-rate by @luke-hill in #3136
• Improvements and fixes for Elder Scrolls locale (elder_scrolls.yml) by @SleekMutt in #3129
• Add en-GB ID Numbers (aka National Insurance Numbers) by @stefanjcollier in #3032
• Update ukrainian city locales to the modern ones by @SleekMutt in #3127
• Revamp the docs to make them easier to find by @stefannibrasil in #3151

Chores

• test: fix flaky test on Faker::IdNumber by @thdaraujo in #3126
• Remove minitest dependency on i18n reload test by @stefannibrasil in #3149
• Remove unused release workflow by @stefannibrasil in #3133

Update local dependencies

• Bump benchmark from 0.4.1 to 0.5.0 by @dependabot[bot] in #3122
• Bump rake from 13.3.0 to 13.3.1 by @dependabot[bot] in #3124
• Bump test-unit from 3.7.0 to 3.7.1 by @dependabot[bot] in #3128
• Bump rubocop-minitest from 0.38.1 to 0.38.2 by @dependabot[bot] in #3116
• deps: bump dependencies by @thdaraujo in #3141
• deps: bump Minitest version to v5.26.1 and fix issues by @stefannibrasil in #3144
• deps: bump rubocop version to v1.81.7 by @thdaraujo in #3143

New Contributors

• @Leenday made their first contribution in #3099
• @AhmedHisham552 made their first contribution in #3118
• @smorttey made their first contribution in #3106
• @neco-nico made their first contribution in #3110
• @HassanAkbar made their first contribution in #3111
• @ramzieus made their first contribution in #3130
• @luke-hill made their first contribution in #3136
• @SleekMutt made their first contribution in #3129
• @stefanjcollier made their first contribution in #3032

Full Changelog: v3.5.2...v3.5.3

Happy Canada Day! 🍁

This version adds and improves some locales and fixes some bugs.

Thanks to all contributors!

Improvements & Bug fixes

• Correct Faker::Address.city and Faker::Address.street_address for :fr locale by @brupla6126 in #3018
• fix condominium_fiscal_code generator length from 9 to 11 characters by @FiloSpaTeam in #3037
• Add Cell Phone, Default Time Zone and State Abbreviation translation for en-PAK locale by @wonderer007 in #3024
• Fix usage docs header indentation by @jaredsmithse in #3049
• Fix nl phone format by @klaaspieter in #3050
• Fix typo in ja/book locale by @thdaraujo in #3062
• fix a typo by @jethrodaniel in #3060
• Fix typo in restaurant.yml by @daniel-nerdgeschoss in #3067
• Fix city address with number in locales/fr/address.yml by @brupla6126 in #3071
• Fix unclosed quote in locales/en/cosmere.yml by @bensheldon in #3075
• Remove inappropriate word from ja lorem by @se4weed in #3095
• Add mountains to de-CH locale by @codez in #3066
• Bump i18n from 1.14.6 to 1.14.7 by @dependabot in #3042

Chore

• ci: run against Ruby 3.4 by @thdaraujo in #3079
• Fix Broken CI by @wonderer007 in #3073

Update local dependencies

• Bump rubocop from 1.67.0 to 1.68.0 by @dependabot in #3020
• Bump rubocop from 1.68.0 to 1.69.2 by @dependabot in #3035
• Bump rubocop version + offenses fixes by @stefannibrasil in #3053
• deps: update dev dependencies by @thdaraujo in #3078
• Bump rubocop-minitest and fix rubocop's offense by @stefannibrasil in #3052
• Bump rubocop-minitest from 0.38.0 to 0.38.1 by @dependabot in #3088
• Bump rubocop-rake from 0.6.0 to 0.7.1 by @dependabot in #3059
• deps: bump rubocop-minitest from 0.37.1 to 0.38.0. by @thdaraujo in #3080
• Bump minitest from 5.25.1 to 5.25.4 by @dependabot in #3031
• Bump test-unit from 3.6.2 to 3.6.7 by @dependabot in #3038
• Bump benchmark from 0.3.0 to 0.4.0 by @dependabot in #3021
• Bump benchmark from 0.4.0 to 0.4.1 by @dependabot in #3087
• Bump pry from 0.14.2 to 0.15.2 by @dependabot in #3039
• Bump rake from 13.2.1 to 13.3.0 by @dependabot in #3086
• Bump test-unit from 3.6.8 to 3.6.9 by @dependabot in #3096

New Contributors

• @brupla6126 made their first contribution in #3018
• @jaredsmithse made their first contribution in #3049
• @klaaspieter made their first contribution in #3050
• @jethrodaniel made their first contribution in #3060
• @daniel-nerdgeschoss made their first contribution in #3067
• @bensheldon made their first contribution in #3075
• @se4weed made their first contribution in #3095

Full Changelog: v3.5.1...v3.5.2

Happy October! 🎃

This version drops support for Ruby < 3.0. We only support one EOL Ruby version at a time. Please upgrade to Ruby 3.0 to update to this and future versions of faker-ruby.

Besides that, this version removes deprecated generators, fixes some bugs, and adds a Security Policy.

Thanks to all contributors!

Breaking Changes

• Drop support for Ruby 2.7 by @tatheerf02 in #3006
• Removes deprecated generators by @stefannibrasil in #3014

The following deprecated generators are being removed. Please use the new generators:

Improvements & Bug fixes

• Fix typos by @tagliala in #2982
• Fix benchmark:all_methods task by excluding Faker::Deprecator module from benchmark target by @amatsuda in #2988
• Add Brazilian Portuguese translations for Faker::Subscription by @murichristopher in #2960
• Deprecator improvements by @stefannibrasil in #2997
• Faker::Alphanumeric.alphanumeric determinism fix by @admtnnr in #2996
• Remove CodeClimate badges by @tagliala in #3003
• Update Company.logo example url by @dirschn in #3007
• fix(music.band): removes leading whitespace by @JeremasPosta in #3015
• Create SECURITY.md by @stefannibrasil in #3016

Update local dependencies

• Bump i18n from 1.14.5 to 1.14.6 by @dependabot in #3005
• Bump minitest from 5.24.1 to 5.25.0 by @dependabot in #2991
• Bump rubocop-minitest from 0.35.1 to 0.36.0 by @dependabot in #2999
• Bump yard from 0.9.36 to 0.9.37 by @dependabot in #3000
• Bump rubocop from 1.65.1 to 1.66.1 by @dependabot in #3001

New Contributors

• @murichristopher made their first contribution in #2960
• @admtnnr made their first contribution in #2996
• @dirschn made their first contribution in #3007
• @tatheerf02 made their first contribution in #3006
• @JeremasPosta made their first contribution in #3015

Full Changelog: v3.4.2...v3.5.1

Happy July with a new faker-ruby release.

This version:

• introduces a breaking change for Faker::NationalHealthService.british_number (more details below)
• adds translation for some generators
• fixes bugs

Breaking changes

The NHS sets aside a range of numbers from 999 000 0000 to 999 999 9999 for test purposes. The old range could
produce NHS numbers that were in use by real patients in the UK/England and Wales. In this version, Faker::NationalHealthService.british_number uses the test range for creating NHS numbers rather than the previous 400 000 0010 to 499 999 9999 range.

Breaking change was introduced in "Add test range param to NHS numbers" by @neanias in #2947

Improvements & Bug fixes

• Add Bank and Sport to Swedish locale by @twk-mn in #2961
• docs: update with notes about validity for zips by @garrettgregor in #2963
• Faker::Games::Dota missing quotes and new heroes by @arthurka-o in #2907
• Add phone_number.country_code and address.full_address in locale sv by @larkro in #2965
• Fix typo by @fynsta in #2968
• fix: Faker::Internet.username should not generate duplicated punctuation by @thdaraujo in #2970
• Update dog breed names for en-US locale by @mononoken in #2972
• Add Deprecator.skip_warning? ability to silence deprecators on tests by @keshavbiswa in #2956

Update local dependencies

• Bump timecop from 0.9.9 to 0.9.10 by @dependabot in #2969
• Bump minitest from 5.23.1 to 5.24.1 by @dependabot in #2975
• Bump bundler version to 2.4.22 by @thdaraujo in #2978
• Bump rubocop from 1.64.1 to 1.65.0 by @dependabot in #2979
• Bump rubocop-minitest from 0.35.0 to 0.35.1 by @dependabot in #2980

New Contributors

• @twk-mn made their first contribution in #2961
• @neanias made their first contribution in #2947
• @garrettgregor made their first contribution in #2963
• @arthurka-o made their first contribution in #2907
• @larkro made their first contribution in #2965
• @fynsta made their first contribution in #2968
• @mononoken made their first contribution in #2972

Full Changelog: v.3.4.1...v3.4.2

Happy end of May with a new faker-ruby release.

This version:

• adds translation for some generators
• fixes bugs
• improves some generators performance

Bug fixes

• Fix invalid IANA time zone identifier for Atlantic/Cape_Verde by @andrelaszlo in #2927
• Fix entry in faker.food.ingredients by @matthewmayer in #2933
• Docs: add absolute links to CONTRIBUTING from README by @matthewmayer in #2934
• Fix: Faker::Number.hexadecimal should include characters within the range of [0-9a-f] by @alextaujenis in #2942
• Username splits names by space and doesn't regex match them by @keshavbiswa in #2950

Features

• Add animals, desserts, foods, hobbies, house, and k-pop translations to the Korean locale file by @connie-feng in #2935
• Add adjectives to Korean locale file by @connie-feng in #2930
• Add emotions, movies, Pokemon, and Studio Ghibli to the Korean locale by @connie-feng in #2941
• Add Japanese translations for Faker::Sports::Football. by @yamat47 in #2903

What's changed

• Performance: Sample arrays instead of performing shuffle and slice by @alextaujenis in #2940
• Performance: Reduce the time complexity of Faker::Crypto generators by @alextaujenis in #2938
• Remove tzinfo dependency by @stefannibrasil in #2952

Update local dependencies

• Bump rake from 13.1.0 to 13.2.1 by @dependabot in #2929
• Bump i18n from 1.14.4 to 1.14.5 by @dependabot in #2949
• Bump minitest from 5.22.3 to 5.23.1 by @dependabot in #2957
• Bump rubocop from 1.63.4 to 1.64.0 by @dependabot in #2958

New Contributors

• @connie-feng made their first contribution in #2930
• @andrelaszlo made their first contribution in #2927
• @matthewmayer made their first contribution in #2933

Full Changelog: v3.3.1...v3.4.1

v3.3.1 (2024-04-02)

Bug fixes

• Fix bug on phone number generator for en-US locale caused by incorrect .yml file structure by @aprescott in #2924

What's Changed

• Added docs for Deprecator in CONTRIBUTING.md by @keshavbiswa in #2919
• Rename Faker::show to Faker::Theater by @keshavbiswa in #2921
• renamed nhs to national_health_service by @keshavbiswa in #2923

New Contributors

• @aprescott made their first contribution in #2924

Full Changelog: v3.3.0...v3.3.1