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

v3.3.0 (2024-03-25)

Bug Fixes

• Remove the duplicate method Faker::Commerce.material description by @mmarusyk in #2914

Features

• Add Kenya to supported countries by @AndrewNduati in #2871
• Benchmarking loading JSON file vs YML file by @salochara in #2897

What's changed

• Fix/Deprecate Faker::IDNumber to Faker::IdNumber to be more consistent with other generator's naming convention. by @Jamal-A-Mohamed in #2858
• Fix/Deprecate FmaBrotherhood Generator by @kirkkwang in #2856
• Fix/Deprecate Faker::Australia to Faker::Locations::Australia by @keshavbiswa in #2869
• Add note about EOL dependencies by @stefannibrasil in #2890

Update local dependencies

• Bump test-unit from 3.6.1 to 3.6.2 by @dependabot in #2906
• Bump i18n from 1.14.1 to 1.14.4 by @dependabot in #2913
• Bump rubocop from 1.60.2 to 1.62.1 by @dependabot in #2916
• Bump yard from 0.9.34 to 0.9.36 by @dependabot in #2909
• Bump minitest from 5.22.2 to 5.22.3 by @dependabot in #2917

New Contributors

• @AndrewNduati made their first contribution in #2871
• @Jamal-A-Mohamed made their first contribution in #2858
• @mmarusyk made their first contribution in #2914

Full Changelog: v3.2.3...v3.3.0

What's Changed

v3.2.3 (2024-01-12)

Happy 2024 with a new faker-ruby release.

This version includes bug fixes, docs typos fixes, and some changes on the contributing guides.

faker-ruby is is not accepting new features proposals

As we discussed here, we want to improve faker's performance and organization. There hasn't been to many bug reports and most of the open issues are related to performance and confusion around using faker.

As we have limited time to invest in faker, reviewing new generators and locales prevent us from focusing on the big picture work. With this decision, we hope to make the necessary changes for faker to go to the next level. Please read the Contributing guides for ways to help us get there.

Bug fixes

• Fix Phone number long number and other updates by @stefannibrasil in #2842
• Favor 'The Room' instead of 'Room' by @kirkkwang in #2854
• Limit generated Discover cards to 19 digits by @jamie in #2845
• Fix Typo in README Link: Update sports.md to sport.md by @hatsu38 in #2859
• Fix country names and codes in address by @sudeeptarlekar in #2850
• fixed typo for README. Faker::JapaneseMedia::CowboyBebop by @jacoyutorius in #2863
• Fix typo in Faker::Movies::HarryPotter.location (Castelobruxo) by @leomartins1999 in #2866
• Fix flaky spec on TestFakerFile#test_file_name by @keshavbiswa in #2868
• Update Internet#username separator param to match with the example by @AlexandreL0pes in #2882
• fix polish bban_pattern by @artur1313 in #2887

What's Changed

• Add benchmark by @salochara in #2855
• Freeze new generator and locales by @stefannibrasil in #2886
• Remove deprecate safe_email and free_email methods by @hatsu38 in #2841
• Update contribution guidelines and PULL_REQUEST_TEMPLATE by @stefannibrasil in #2878
• Remove unmaintained History.md by @y-yagi in #2880
• Adds Ruby 3.3 to the CI matrix by @m-nakamura145 in #2883

Update local dependencies

• Bump rubocop from 1.58.0 to 1.59.0 by @dependabot in #2865
• Bump rubocop-minitest from 0.34.3 to 0.34.4 by @dependabot in #2884
• Bump minitest version by @stefannibrasil in #2889

New Contributors

• @kirkkwang made their first contribution in #2854
• @jamie made their first contribution in #2845
• @hatsu38 made their first contribution in #2859
• @salochara made their first contribution in #2855
• @jacoyutorius made their first contribution in #2863
• @leomartins1999 made their first contribution in #2866
• @keshavbiswa made their first contribution in #2868
• @y-yagi made their first contribution in #2880
• @AlexandreL0pes made their first contribution in #2882
• @m-nakamura145 made their first contribution in #2883
• @artur1313 made their first contribution in #2887

Full Changelog: v3.2.2...v.3.2.3

v3.2.2 (2023-11-03)

Happy November with a new faker-ruby release.

This version:

• adds generators
• fixes bugs
• updates dev and dependencies
• updates docs

Features

• feat: add danish country code by @hoshy in #2818
• Add zh-CN translations for Bank names by @guxiaobai in #2840
• Add Code Scanning by @stefannibrasil in #2835
• Add Japanese for Games Touhou by @shiroemons in #2829
• Added Faker::Company.indian_gst_number fixed #2823 by @ankitkhadria in #2825
• Adds Smashing Pumpkins to the Music module by @redconfetti in #2817

Bug fixes

• Delete doc/default/michael_scott.md by @jmromer in #2837
• Fix typo in lib/locales/README.md by @BelaBartok39 in #2812

What's Changed

• Update contributing and maintaining guides by @stefannibrasil in #2836
• Changed tests from x.times loop to deterministically_verify helper. #2813 issue by @fernandomenolli in #2816
• Improve #deterministically_verify helper by @erichmachado in #2828

Update local dependencies

• Bump minitest from 5.19.0 to 5.20.0 by @dependabot in #2826
• Bump rake from 13.0.6 to 13.1.0 by @dependabot in #2846
• Bump rubocop-minitest from 0.32.2 to 0.33.0 by @dependabot in #2843
• Bump rubocop from 1.57.1 to 1.57.2 by @dependabot in #2844
• Bump timecop from 0.9.6 to 0.9.8 by @dependabot in #2811

New Contributors

• @BelaBartok39 made their first contribution in #2812
• @fernandomenolli made their first contribution in #2816
• @hoshy made their first contribution in #2818
• @shiroemons made their first contribution in #2829
• @erichmachado made their first contribution in #2828
• @jmromer made their first contribution in #2837
• @guxiaobai made their first contribution in #2840
• @redconfetti made their first contribution in #2817
• @ankitkhadria made their first contribution in #2825

Full Changelog: v3.2.1...v3.2.2

v3.2.1 (2023-08-11)

Happy August with a new Faker release! 🎉

This version:

• adds generators
• fixes bugs
• updates dev dependencies

This version fixes a bug with setting the locale in multi-threaded environments. It's now possible to set the locale per thread. For more details, see How to set the default locale for in threaded server environments.

Other changes included in this version:

Features

• Add Final Fantasy XIV by @old-dead-account in #2742
• Add the Ukrainian country calling code by @kyrylo in #2758
• Add exclude_words filter to Faker::Lorem.word generator by @geophilusd in #2761
• Add Japanese translations for Sports category. by @yamat47 in #2770
• Add type support for Faker::Types.rb_array by @ruban-thilak in #2771
• Added Archer into tv category. by @lepari23 in #2750
• Add train station generator by @AngusDSR in #2755
• Add custom start date for Faker::Date.forward by @luciagirasoles in #2791
• Add max_rut option to Faker::ChileRut.rut by @HACKTIVISTA in #2778
• Add Faker::Date.day_of_week_between by @aramvisser in #2713
• Html generator for Faker by @ruban-thilak in #2769

Bug fixes

• Fix locale setting by @mateusdeap in #2734
• add tests for password and fix an edge case by @DeepakRaj228 in #2741
• Remove broken chars from minecraft.yml by @ujihisa in #2765
• Fix flaky specs for name and id by @ruban-thilak in #2782
• Fixes Faker::Music::Opera.saint_saens issue by @devashishTaneja in #2792
• Fix flaky specs for dota test_player by @ruban-thilak in #2798
• Add prefixes to french name locale (Faker::Name.name) by @thdaraujo in #2800

What's Changed

• Introduce PositionalGenerator by @mike-burns in #2710
• Update South Park by @IvanReyesO7 in #2744
• Speed up Internet::Password generation using constants by @MicBruz in #2725
• Improve de-CH locale with new formats and content by @stefnnn in #2768

Update local dependencies

• Bump rubocop from 1.55.1 to 1.56.0 by @dependabot in #2807
• Update test-unit requirement from = 3.5.9 to = 3.6.1 by @dependabot in #2788
• Bump i18n from 1.12.0 to 1.13.0 by @dependabot in #2756
• Update rubocop-minitest requirement from = 0.30.0 to = 0.31.0 by @dependabot in #2759
• Bump minitest from 5.18.1 to 5.19.0 by @dependabot in #2804

New Contributors

• @old-dead-account made their first contribution in #2742
• @IvanReyesO7 made their first contribution in #2744
• @DeepakRaj228 made their first contribution in #2741
• @MicBruz made their first contribution in #2725
• @kyrylo made their first contribution in #2758
• @ujihisa made their first contribution in #2765
• @geophilusd made their first contribution in #2761
• @stefnnn made their first contribution in #2768
• @yamat47 made their first contribution in #2770
• @ruban-thilak made their first contribution in #2782
• @lepari23 made their first contribution in #2750
• @AngusDSR made their first contribution in #2755
• @devashishTaneja made their first contribution in #2792
• @mike-burns made their first contribution in #2710
• @HACKTIVISTA made their first contribution in #2778
• @mateusdeap made their first contribution in #2734
• @aramvisser made their first contribution in #2713

Full Changelog: v3.2.0...v3.2.1