RubyGems - faker - Versions diffs - 3.5.1 → 3.8.0 - Mend

faker 3.5.1 → 3.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (288) hide show

checksums.yaml +4 -4
data/CHANGELOG.md +251 -7
data/README.md +78 -393
data/lib/faker/blockchain/bitcoin.rb +0 -1
data/lib/faker/blockchain/tezos.rb +0 -1
data/lib/faker/blockchain.rb +9 -0
data/lib/faker/books/lovecraft.rb +1 -1
data/lib/faker/books.rb +9 -0
data/lib/faker/creature.rb +9 -0
data/lib/faker/default/avatar.rb +1 -1
data/lib/faker/default/bank.rb +1 -5
data/lib/faker/default/boolean.rb +2 -1
data/lib/faker/default/code.rb +4 -0
data/lib/faker/default/company.rb +2 -2
data/lib/faker/default/crypto.rb +0 -2
data/lib/faker/default/driving_licence.rb +3 -3
data/lib/faker/default/finance.rb +2 -2
data/lib/faker/default/hipster.rb +1 -1
data/lib/faker/default/html.rb +4 -4
data/lib/faker/default/id_number.rb +1 -1
data/lib/faker/default/invoice.rb +2 -2
data/lib/faker/default/json.rb +7 -2
data/lib/faker/default/lorem.rb +3 -3
data/lib/faker/default/lorem_flickr.rb +1 -1
data/lib/faker/default/markdown.rb +5 -5
data/lib/faker/default/national_health_service.rb +1 -2
data/lib/faker/default/omniauth.rb +58 -58
data/lib/faker/default/placeholdit.rb +2 -2
data/lib/faker/default/string.rb +1 -1
data/lib/faker/default/types.rb +2 -2
data/lib/faker/default/x.rb +189 -0
data/lib/faker/default.rb +9 -0
data/lib/faker/fantasy.rb +9 -0
data/lib/faker/games.rb +9 -0
data/lib/faker/{default/internet.rb → internet.rb} +8 -4
data/lib/faker/japanese_media.rb +9 -0
data/lib/faker/locations.rb +9 -0
data/lib/faker/movies.rb +9 -0
data/lib/faker/music/bossa_nova.rb +35 -0
data/lib/faker/music/grateful_dead.rb +0 -2
data/lib/faker/music/pearl_jam.rb +0 -2
data/lib/faker/music/rush.rb +0 -2
data/lib/faker/music/smashing_pumpkins.rb +0 -2
data/lib/faker/{music/music.rb → music.rb} +4 -0
data/lib/faker/quotes.rb +9 -0
data/lib/faker/religion/bible.rb +1 -1
data/lib/faker/religion.rb +9 -0
data/lib/faker/sports.rb +9 -0
data/lib/faker/travel.rb +9 -0
data/lib/faker/tv_shows.rb +9 -0
data/lib/faker/version.rb +1 -1
data/lib/faker.rb +67 -12
data/lib/helpers/deprecator.rb +1 -1
data/lib/helpers/positional_generator.rb +0 -2
data/lib/helpers/unique_generator.rb +1 -1
data/lib/locales/README.md +2 -2
data/lib/locales/ar.yml +1606 -49
data/lib/locales/bg.yml +935 -18
data/lib/locales/ca-CAT.yml +347 -12
data/lib/locales/ca.yml +580 -7
data/lib/locales/de-CH.yml +31 -0
data/lib/locales/ee.yml +1185 -26
data/lib/locales/en/adjective.yml +174 -174
data/lib/locales/en/airport.yml +374 -374
data/lib/locales/en/ancient.yml +128 -4
data/lib/locales/en/animal.yml +141 -2
data/lib/locales/en/app.yml +89 -2
data/lib/locales/en/appliance.yml +81 -2
data/lib/locales/en/aqua_teen_hunger_force.yml +31 -31
data/lib/locales/en/artist.yml +43 -1
data/lib/locales/en/avatar.yml +54 -28
data/lib/locales/en/back_to_the_future.yml +145 -117
data/lib/locales/en/bank.yml +91 -2
data/lib/locales/en/beer.yml +232 -6
data/lib/locales/en/bible.yml +3 -6
data/lib/locales/en/big_bang_theory.yml +34 -35
data/lib/locales/en/bird.yml +1225 -1226
data/lib/locales/en/bojack_horseman.yml +63 -3
data/lib/locales/en/book.yml +0 -1
data/lib/locales/en/bossa_nova.yml +110 -3
data/lib/locales/en/breaking_bad.yml +110 -25
data/lib/locales/en/brooklyn_nine_nine.yml +0 -1
data/lib/locales/en/buffy.yml +239 -257
data/lib/locales/en/business.yml +18 -2
data/lib/locales/en/cannabis.yml +344 -10
data/lib/locales/en/cat.yml +155 -3
data/lib/locales/en/chess.yml +2 -3
data/lib/locales/en/chiquito.yml +60 -61
data/lib/locales/en/chuck_norris.yml +78 -79
data/lib/locales/en/clash_of_clan.yml +0 -2
data/lib/locales/en/code.yml +501 -1
data/lib/locales/en/coffee.yml +450 -25
data/lib/locales/en/color.yml +73 -1
data/lib/locales/en/commerce.yml +117 -23
data/lib/locales/en/community.yml +55 -30
data/lib/locales/en/company.yml +1756 -14
data/lib/locales/en/compass.yml +108 -12
data/lib/locales/en/conan.yml +0 -2
data/lib/locales/en/construction.yml +416 -422
data/lib/locales/en/cosmere.yml +219 -54
data/lib/locales/en/cowboy_bebop.yml +56 -59
data/lib/locales/en/culture_series.yml +298 -298
data/lib/locales/en/currency.yml +358 -3
data/lib/locales/en/dc_comics.yml +178 -49
data/lib/locales/en/demographic.yml +215 -215
data/lib/locales/en/departed.yml +40 -44
data/lib/locales/en/dessert.yml +78 -3
data/lib/locales/en/doraemon.yml +278 -280
data/lib/locales/en/dr_who.yml +468 -93
data/lib/locales/en/dragon_ball.yml +240 -240
data/lib/locales/en/dumb_and_dumber.yml +72 -56
data/lib/locales/en/elder_scrolls.yml +52 -53
data/lib/locales/en/electrical_components.yml +49 -3
data/lib/locales/en/esport.yml +58 -5
data/lib/locales/en/family_guy.yml +54 -4
data/lib/locales/en/file.yml +108 -9
data/lib/locales/en/final_space.yml +1 -3
data/lib/locales/en/finance.yml +1 -1
data/lib/locales/en/food.yml +1 -1
data/lib/locales/en/football.yml +121 -5
data/lib/locales/en/fresh_prince_of_bel_air.yml +119 -70
data/lib/locales/en/friends.yml +162 -3
data/lib/locales/en/funny_name.yml +752 -1
data/lib/locales/en/futurama.yml +7 -15
data/lib/locales/en/game_of_thrones.yml +2487 -5
data/lib/locales/en/gender.yml +15 -3
data/lib/locales/en/ghostbusters.yml +101 -88
data/lib/locales/en/grateful_dead.yml +47 -45
data/lib/locales/en/greek_philosophers.yml +44 -23
data/lib/locales/en/hacker.yml +110 -5
data/lib/locales/en/hackers.yml +1 -1
data/lib/locales/en/harry_potter.yml +323 -6
data/lib/locales/en/hey_arnold.yml +104 -21
data/lib/locales/en/hipster.yml +203 -1
data/lib/locales/en/hitchhikers_guide_to_the_galaxy.yml +243 -42
data/lib/locales/en/hobby.yml +0 -1
data/lib/locales/en/horse.yml +446 -2
data/lib/locales/en/house.yml +34 -2
data/lib/locales/en/how_i_met_your_mother.yml +97 -25
data/lib/locales/en/how_to_train_your_dragon.yml +0 -1
data/lib/locales/en/id_number.yml +6 -1
data/lib/locales/en/industry_segments.yml +188 -4
data/lib/locales/en/job.yml +98 -7
data/lib/locales/en/kamen_rider.yml +272 -6
data/lib/locales/en/kpop.yml +954 -80
data/lib/locales/en/lebowski.yml +58 -40
data/lib/locales/en/lorem.yml +1095 -6
data/lib/locales/en/markdown.yml +12 -2
data/lib/locales/en/marketing.yml +54 -1
data/lib/locales/en/measurement.yml +42 -8
data/lib/locales/en/michael_scott.yml +41 -42
data/lib/locales/en/movie.yml +188 -176
data/lib/locales/en/name.yml +6068 -6
data/lib/locales/en/nato_phonetic_alphabet.yml +27 -1
data/lib/locales/en/new_girl.yml +35 -37
data/lib/locales/en/one_piece.yml +359 -6
data/lib/locales/en/opera.yml +1 -1
data/lib/locales/en/overwatch.yml +1 -1
data/lib/locales/en/parks_and_rec.yml +33 -4
data/lib/locales/en/pearl_jam.yml +207 -207
data/lib/locales/en/phish.yml +388 -389
data/lib/locales/en/prince.yml +219 -219
data/lib/locales/en/princess_bride.yml +48 -2
data/lib/locales/en/programming_language.yml +753 -3
data/lib/locales/en/quote.yml +599 -685
data/lib/locales/en/rajnikanth.yml +74 -74
data/lib/locales/en/relationship.yml +29 -6
data/lib/locales/en/restaurant.yml +31 -31
data/lib/locales/en/rick_and_morty.yml +116 -3
data/lib/locales/en/rock_band.yml +228 -2
data/lib/locales/en/rupaul.yml +120 -122
data/lib/locales/en/seinfeld.yml +110 -3
data/lib/locales/en/shakespeare.yml +46 -50
data/lib/locales/en/silicon_valley.yml +122 -50
data/lib/locales/en/simpsons.yml +897 -691
data/lib/locales/en/slack_emoji.yml +874 -8
data/lib/locales/en/space.yml +373 -14
data/lib/locales/en/star_trek.yml +105 -4
data/lib/locales/en/star_wars.yml +525 -528
data/lib/locales/en/stargate.yml +65 -18
data/lib/locales/en/stranger_thing.yml +31 -33
data/lib/locales/en/street_fighter.yml +1 -1
data/lib/locales/en/subscription.yml +47 -5
data/lib/locales/en/superhero.yml +574 -4
data/lib/locales/en/sword_art_online.yml +327 -331
data/lib/locales/en/team.yml +125 -3
data/lib/locales/en/the_expanse.yml +92 -4
data/lib/locales/en/the_it_crowd.yml +148 -152
data/lib/locales/en/the_office.yml +77 -81
data/lib/locales/en/the_room.yml +35 -35
data/lib/locales/en/the_thick_of_it.yml +83 -3
data/lib/locales/en/theater.yml +593 -593
data/lib/locales/en/tolkien.yml +2 -2
data/lib/locales/en/touhou.yml +54 -54
data/lib/locales/en/tron.yml +191 -191
data/lib/locales/en/twin_peaks.yml +130 -3
data/lib/locales/en/umphreys_mcgee.yml +266 -1
data/lib/locales/en/university.yml +15 -2
data/lib/locales/en/v_for_vendetta.yml +157 -160
data/lib/locales/en/venture_bros.yml +225 -4
data/lib/locales/en/verbs.yml +3785 -5
data/lib/locales/en/volleyball.yml +493 -493
data/lib/locales/en/warhammer_fantasy.yml +540 -573
data/lib/locales/en/world_cup.yml +1132 -235
data/lib/locales/en/yoda.yml +38 -1
data/lib/locales/en-BORK.yml +104 -1
data/lib/locales/en-GB.yml +9 -7
data/lib/locales/en-NG.yml +737 -66
data/lib/locales/en-PAK.yml +24 -1
data/lib/locales/en-TH.yml +1 -1
data/lib/locales/en-UG.yml +374 -76
data/lib/locales/en-ZA.yml +1394 -13
data/lib/locales/es-AR.yml +1 -1
data/lib/locales/es-MX.yml +1907 -40
data/lib/locales/es.yml +2117 -52
data/lib/locales/fa.yml +1624 -5
data/lib/locales/fi-FI.yml +315 -17
data/lib/locales/fr/address.yml +761 -8
data/lib/locales/fr/adjective.yml +261 -261
data/lib/locales/fr/ancient.yml +134 -134
data/lib/locales/fr/animal.yml +118 -1
data/lib/locales/fr/appliance.yml +66 -1
data/lib/locales/fr/book.yml +27 -3
data/lib/locales/fr/color.yml +31 -1
data/lib/locales/fr/company.yml +490 -10
data/lib/locales/fr/compass.yml +58 -10
data/lib/locales/fr/demographic.yml +3 -1
data/lib/locales/fr/gender.yml +18 -3
data/lib/locales/fr/internet.yml +12 -1
data/lib/locales/fr/lorem.yml +1091 -2
data/lib/locales/fr/measurement.yml +31 -4
data/lib/locales/fr/name.yml +1176 -5
data/lib/locales/fr/phone_number.yml +34 -3
data/lib/locales/fr/pokemon.yml +417 -3
data/lib/locales/fr-CA.yml +12 -6
data/lib/locales/fr-CH.yml +2455 -41
data/lib/locales/he.yml +255 -9
data/lib/locales/hy.yml +12 -6
data/lib/locales/it.yml +12 -6
data/lib/locales/ja/address.yml +350 -120526
data/lib/locales/ja/ancient.yml +15 -1
data/lib/locales/ja/animal.yml +83 -1
data/lib/locales/ja/artist.yml +46 -0
data/lib/locales/ja/bank.yml +136 -1
data/lib/locales/ja/book.yml +492 -3
data/lib/locales/ja/cat.yml +75 -1
data/lib/locales/ja/coffee.yml +19 -1
data/lib/locales/ja/color.yml +32 -1
data/lib/locales/ja/commerce.yml +98 -6
data/lib/locales/ja/company.yml +20 -2
data/lib/locales/ja/dog.yml +335 -2
data/lib/locales/ja/emotion.yml +1 -3
data/lib/locales/ja/food.yml +38 -1
data/lib/locales/ja/gender.yml +3 -1
data/lib/locales/ja/lorem.yml +1014 -3
data/lib/locales/ja/name.yml +203 -3
data/lib/locales/ja/overwatch.yml +33 -1
data/lib/locales/ja/phone_number.yml +9 -3
data/lib/locales/ja/pokemon.yml +437 -3
data/lib/locales/ja/relationship.yml +29 -6
data/lib/locales/ja/restaurant.yml +74 -3
data/lib/locales/ja/space.yml +20 -2
data/lib/locales/ja/subscription.yml +47 -5
data/lib/locales/ja/super_mario.yml +68 -4
data/lib/locales/ja/university.yml +15 -2
data/lib/locales/ja/zelda.yml +15 -1
data/lib/locales/ko.yml +1 -1
data/lib/locales/lv.yml +1221 -26
data/lib/locales/nl.yml +33514 -55
data/lib/locales/pl.yml +4008 -37
data/lib/locales/sk.yml +12 -6
data/lib/locales/sv.yml +639 -49
data/lib/locales/th.yml +375 -375
data/lib/locales/tr.yml +77 -18
data/lib/locales/uk.yml +7 -7
data/lib/locales/vi.yml +392 -49
data/lib/locales/zh-CN.yml +540 -19
data/lib/locales/zh-TW.yml +1030 -15
metadata +29 -18
data/lib/faker/default/bossa_nova.rb +0 -33
data/lib/faker/default/religion.rb +0 -6
data/lib/faker/default/twitter.rb +0 -207
/data/lib/faker/{books → default}/book.rb +0 -0
/data/lib/faker/{games → default}/game.rb +0 -0
/data/lib/faker/{movies → default}/movie.rb +0 -0
/data/lib/faker/{quotes → default}/quote.rb +0 -0
/data/lib/faker/{sports → default}/sport.rb +0 -0
/data/lib/faker/{default/internet_http.rb → internet/http.rb} +0 -0

data/README.md CHANGED Viewed

@@ -1,18 +1,16 @@
-![logotype a happy-07](https://user-images.githubusercontent.com/36028424/40263395-4318481e-5b44-11e8-92e5-3dcc1ce169b3.png)
+# Faker [![Gem Version][version-badge]][rubygems] [![Build Status][github-actions-badge]][github-actions] [![Total Downloads][downloads-total]][rubygems] [![Downloads][downloads-badge]][rubygems]
-# Faker
-[![Tests](https://github.com/faker-ruby/faker/workflows/Tests/badge.svg)](https://github.com/faker-ruby/faker/actions?query=workflow%3ATests)
-[![Gem Version](https://badge.fury.io/rb/faker.svg)](https://badge.fury.io/rb/faker)
-[![Inline docs](https://inch-ci.org/github/faker-ruby/faker.svg?branch=main)](https://inch-ci.org/github/faker-ruby/faker)
+<div align="center">
+  <img src="https://user-images.githubusercontent.com/36028424/40263395-4318481e-5b44-11e8-92e5-3dcc1ce169b3.png" width="400"/>
+  <p>Generate (almost) realistic fake data for testing, demos, and populating your database during development.</p>
+</div>
-Faker is a port of [Perl's Data::Faker library](https://metacpan.org/pod/Data::Faker).
-It's a library for generating fake data such as names, addresses, and phone numbers.
-Faker helps you generate realistic test data, and populate your
-database with more than a couple of records while you're doing development.
-It comes in very handy for taking screenshots (taking screenshots for a personal project)
-and it was the original impetus for the creation of this gem.
+[version-badge]: https://img.shields.io/gem/v/faker.svg
+[rubygems]: https://rubygems.org/gems/faker
+[github-actions-badge]: https://img.shields.io/github/actions/workflow/status/faker-ruby/faker/.github/workflows/ruby.yml?branch=main
+[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
 ## Quick links
@@ -22,40 +20,19 @@ and it was the original impetus for the creation of this gem.
 [rubydocs]: https://www.rubydoc.info/gems/faker/
 [changelog]: CHANGELOG.md
-## In the media
+## Features
-- 📰 [With Great Humor Comes Great Developer Engagement] - KTH Royal Institute of Technology research
-- 🎧 [Computer und Kommunikation 4.5.2024, komplette Sendung] - Deutschland Funk Radio Interview
+- 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 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.
-[With Great Humor Comes Great Developer Engagement]: https://arxiv.org/pdf/2312.01680
-[Computer und Kommunikation 4.5.2024, komplette Sendung]: https://www.deutschlandfunk.de/computer-und-kommunikation-4-5-2024-komplette-sendung-dlf-16492b03-100.html
+> **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.
-## Table of Contents
-- [Faker](#faker)
-  - [Quick links](#quick-links)
-  - [Table of Contents](#table-of-contents)
-    - [Notes](#notes)
-  - [Getting Started](#getting-started)
-  - [Usage](#usage)
-      - [A note about the Generators versions](#a-note-about-the-generators-versions)
-    - [Ensuring unique values](#ensuring-unique-values)
-    - [Deterministic Random](#deterministic-random)
-    - [Customization](#customization)
-    - [Minitest and Faker \>= 2.22](#minitest-and-faker--222)
-  - [Generators](#generators)
-  - [Contributing](#contributing)
-  - [Versioning](#versioning)
-  - [License](#license)
-### Notes
-* While Faker generates data at random, returned values are not guaranteed to be unique by default.
-  To explicitly specify when you require unique values, see [Ensuring Unique Values](#ensuring-unique-values).
-  Values also can be deterministic if you use the deterministic feature, see [Deterministic Random](#deterministic-random)
-* This is the `main` branch of Faker and may contain changes that are not yet released.
-  Please refer to the README of your version for the available methods.
-  The list of all versions is [available here](https://github.com/stympy/faker/releases).
+For a complete list of the generators, see [Generators](./GENERATORS.md).
 ## Getting Started
@@ -69,49 +46,44 @@ Then run `bundle install`.
 ## Usage
-Here are some examples of how to use Faker:
 ```ruby
 require 'faker'
-Faker::Name.name      #=> "Christophe Bartell"
-Faker::Address.full_address #=> "5479 William Way, East Sonnyhaven, LA 63637"
-Faker::Markdown.emphasis #=> "Quo qui aperiam. Amet corrupti distinctio. Sit quia *dolor.*"
-Faker::TvShows::RuPaul.queen #=> "Violet Chachki"
+Faker::Name.name                      #=> "Christophe Bartell"
+Faker::Internet.password              #=> "Vg5mSvY1UeRg7"
+Faker::Internet.email                 #=> "eliza@mann.test"
+Faker::Address.full_address           #=> "5479 William Way, East Sonnyhaven, LA 63637"
+Faker::Markdown.emphasis              #=> "Quo qui aperiam. Amet corrupti distinctio. Sit quia *dolor.*"
+Faker::Lorem.paragraph                #=> "Recusandae minima consequatur. Expedita sequi blanditiis. Ut fuga et."
 Faker::Alphanumeric.alpha(number: 10) #=> "zlvubkrwga"
-Faker::ProgrammingLanguage.name #=> "Ruby"
+Faker::ProgrammingLanguage.name       #=> "Ruby"
 ```
-For a complete list of the generators, see [Generators](#generators).
-#### A note about the Generators versions
-If you get a `uninitialized constant Faker::[some_class]` error, your version of
-the gem is behind main.
-To make sure that your gem is the one
-documented here, change the line in your Gemfile to:
-```ruby
-gem 'faker', :git => 'https://github.com/faker-ruby/faker.git', :branch => 'main'
-```
+## Table of Contents
-The generators have the `@faker.version` tag on top of their implementation.
-From the tags, you can identify the version the generator was added:
+- [Faker    ](#faker----)
+  - [Quick links](#quick-links)
+  - [Features](#features)
+  - [Getting Started](#getting-started)
+  - [Usage](#usage)
+  - [Table of Contents](#table-of-contents)
+    - [Notes](#notes)
+    - [Ensuring unique values](#ensuring-unique-values)
+    - [Deterministic Random](#deterministic-random)
+    - [Localization](#localization)
+    - [Minitest and Faker \>= 2.22](#minitest-and-faker--222)
+  - [Generators](#generators)
+  - [Contributing](#contributing)
+  - [Versioning](#versioning)
+  - [Inspiration](#inspiration)
+  - [In the media](#in-the-media)
+  - [License](#license)
-```ruby
-# Faker::TvShows::ParksAndRec.character
+### Notes
-# @faker.version 1.9.0
-def character
-  fetch('parks_and_rec.characters')
-end
-```
+* While Faker generates data at random, returned values are not guaranteed to be unique by default. To explicitly specify when you require unique values, see [Ensuring Unique Values](#ensuring-unique-values).
+* Values also can be deterministic if you use the deterministic feature, see [Deterministic Random](#deterministic-random).
+* This is the `main` branch of Faker and may contain changes that are not yet released. The list of all versions is [available here](https://github.com/stympy/faker/releases).
 ### Ensuring unique values
@@ -127,16 +99,15 @@ exception may be raised. It is possible to clear the record of unique values
 that have been returned, for example between tests.
 ```ruby
-Faker::Name.unique.clear # Clears used values for Faker::Name
+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
-# Usage:
 # Faker::<generator>.unique.exclude(method, arguments, list)
 # Add 'azerty' and 'wxcvbn' to the string generator with 6 char length
@@ -150,18 +121,19 @@ to provide deterministic output of repeated method calls.
 ```ruby
 Faker::Config.random = Random.new(42)
-Faker::Company.bs #=> "seize collaborative mindshare"
-Faker::Company.bs #=> "engage strategic platforms"
+Faker::Lorem.word              #=> "velit"
+Faker::Lorem.word              #=> "quisquam"
 Faker::Config.random = Random.new(42)
-Faker::Company.bs #=> "seize collaborative mindshare"
-Faker::Company.bs #=> "engage strategic platforms"
+Faker::Lorem.word              #=> "velit"
+Faker::Lorem.word              #=> "quisquam"
-Faker::Config.random = nil # seeds the PRNG using default entropy sources
-Faker::Config.random.seed #=> 185180369676275068918401850258677722187
-Faker::Company.bs #=> "cultivate viral synergies"
+Faker::Config.random = nil     # seeds the PRNG using default entropy sources
+Faker::Config.random.seed      #=> 185180369676275068918401850258677722187
+Faker::Lorem.word              #=> "ipsam"
 ```
-### Customization
+### Localization
 You may want Faker to print information depending on your location in the world.
 To assist you in this, Faker uses the `I18n` gem to store strings and formats to
@@ -180,315 +152,16 @@ check out the [locales README](lib/locales/README.md).
 ### Minitest and Faker >= 2.22
-To prevent Faker (version >= 2.22) from generating duplicate values 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
 ```
-See [Issue #2534](https://github.com/faker-ruby/faker/issues/2534) for more details.
 ## Generators
-This is the full list of generators available with this gem. If you need details about any of them, make sure to consult the documentation.
-**NOTE: Some of the generators below aren't released yet. If you want to use them, change the line in your gemfile to:**
-```ruby
-gem 'faker', :git => 'https://github.com/faker-ruby/faker.git', :branch => 'main'
-```
-<details>
-  <summary>Default</summary>
-  - [Faker::Address](doc/default/address.md)
-  - [Faker::Alphanumeric](doc/default/alphanumeric.md)
-  - [Faker::Ancient](doc/default/ancient.md)
-  - [Faker::App](doc/default/app.md)
-  - [Faker::Appliance](doc/default/appliance.md)
-  - [Faker::Artist](doc/default/artist.md)
-  - [Faker::Avatar](doc/default/avatar.md)
-  - [Faker::Bank](doc/default/bank.md)
-  - [Faker::Barcode](doc/default/barcode.md)
-  - [Faker::Beer](doc/default/beer.md)
-  - [Faker::Blood](doc/default/blood.md)
-  - [Faker::Boolean](doc/default/boolean.md)
-  - [Faker::BossaNova](doc/default/bossa_nova.md)
-  - [Faker::Business](doc/default/business.md)
-  - [Faker::Camera](doc/default/camera.md)
-  - [Faker::Cannabis](doc/default/cannabis.md)
-  - [Faker::ChileRut](doc/default/chile_rut.md)
-  - [Faker::ChuckNorris](doc/default/chuck_norris.md)
-  - [Faker::Code](doc/default/code.md)
-  - [Faker::Coffee](doc/default/coffee.md)
-  - [Faker::Coin](doc/default/coin.md)
-  - [Faker::Color](doc/default/color.md)
-  - [Faker::Commerce](doc/default/commerce.md)
-  - [Faker::Company](doc/default/company.md)
-  - [Faker::Compass](doc/default/compass.md)
-  - [Faker::Computer](doc/default/computer.md)
-  - [Faker::Construction](doc/default/construction.md)
-  - [Faker::Cosmere](doc/default/cosmere.md)
-  - [Faker::Crypto](doc/default/crypto.md)
-  - [Faker::CryptoCoin](doc/default/crypto_coin.md)
-  - [Faker::Currency](doc/default/currency.md)
-  - [Faker::Date](doc/default/date.md)
-  - [Faker::DcComics](doc/default/dc_comics.md)
-  - [Faker::Demographic](doc/default/demographic.md)
-  - [Faker::Dessert](doc/default/dessert.md)
-  - [Faker::Device](doc/default/device.md)
-  - [Faker::DrivingLicence](doc/default/driving_licence.md)
-  - [Faker::Drone](doc/drone/drone.md)
-  - [Faker::Educator](doc/default/educator.md)
-  - [Faker::ElectricalComponents](doc/default/electrical_components.md)
-  - [Faker::Emotion](doc/default/emotion.md)
-  - [Faker::Esport](doc/default/esport.md)
-  - [Faker::File](doc/default/file.md)
-  - [Faker::Finance](doc/default/finance.md)
-  - [Faker::Food](doc/default/food.md)
-  - [Faker::FunnyName](doc/default/funny_name.md)
-  - [Faker::Gender](doc/default/gender.md)
-  - [Faker::GreekPhilosophers](doc/default/greek_philosophers.md)
-  - [Faker::Hacker](doc/default/hacker.md)
-  - [Faker::Hipster](doc/default/hipster.md)
-  - [Faker::Hobby](doc/default/hobby.md)
-  - [Faker::House](doc/default/house.md)
-  - [Faker::IdNumber](doc/default/id_number.md)
-  - [Faker::IndustrySegments](doc/default/industry_segments.md)
-  - [Faker::Internet](doc/default/internet.md)
-  - [Faker::Invoice](doc/default/invoice.md)
-  - [Faker::Job](doc/default/job.md)
-  - [Faker::Json](doc/default/json.md)
-  - [Faker::Kpop](doc/default/kpop.md)
-  - [Faker::Lorem](doc/default/lorem.md)
-  - [Faker::LoremFlickr](doc/default/lorem_flickr.md)
-  - [Faker::Markdown](doc/default/markdown.md)
-  - [Faker::Marketing](doc/default/marketing.md)
-  - [Faker::Measurement](doc/default/measurement.md)
-  - [Faker::Military](doc/default/military.md)
-  - [Faker::Mountain](doc/default/mountain.md)
-  - [Faker::Name](doc/default/name.md)
-  - [Faker::Nation](doc/default/nation.md)
-  - [Faker::NatoPhoneticAlphabet](doc/default/nato_phonetic_alphabet.md)
-  - [Faker::NationalHealthService](doc/default/national_health_service.md)
-  - [Faker::Number](doc/default/number.md)
-  - [Faker::Omniauth](doc/default/omniauth.md)
-  - [Faker::PhoneNumber](doc/default/phone_number.md)
-  - [Faker::Placeholdit](doc/default/placeholdit.md)
-  - [Faker::ProgrammingLanguage](doc/default/programming_language.md)
-  - [Faker::Relationship](doc/default/relationship.md)
-  - [Faker::Restaurant](doc/default/restaurant.md)
-  - [Faker::Science](doc/default/science.md)
-  - [Faker::SlackEmoji](doc/default/slack_emoji.md)
-  - [Faker::Source](doc/default/source.md)
-  - [Faker::SouthAfrica](doc/default/south_africa.md)
-  - [Faker::Space](doc/default/space.md)
-  - [Faker::String](doc/default/string.md)
-  - [Faker::Stripe](doc/default/stripe.md)
-  - [Faker::Subscription](doc/default/subscription.md)
-  - [Faker::Superhero](doc/default/superhero.md)
-  - [Faker::Tea](doc/default/tea.md)
-  - [Faker::Team](doc/default/team.md)
-  - [Faker::Theater](doc/default/theater.md)
-  - [Faker::Time](doc/default/time.md)
-  - [Faker::Twitter](doc/default/twitter.md)
-  - [Faker::Types](doc/default/types.md)
-  - [Faker::University](doc/default/university.md)
-  - [Faker::Vehicle](doc/default/vehicle.md)
-  - [Faker::Verbs](doc/default/verbs.md)
-  - [Faker::VulnerabilityIdentifier](doc/default/vulnerability_identifier.md)
-  - [Faker::WorldCup](doc/default/world_cup.md)
-</details>
-<details>
-  <summary>Blockchain</summary>
-  - [Faker::Blockchain::Aeternity](doc/blockchain/aeternity.md)
-  - [Faker::Blockchain::Bitcoin](doc/blockchain/bitcoin.md)
-  - [Faker::Blockchain::Ethereum](doc/blockchain/ethereum.md)
-  - [Faker::Blockchain::Tezos](doc/blockchain/tezos.md)
-</details>
-<details>
-  <summary>Books</summary>
-  - [Faker::Book](doc/books/book.md)
-  - [Faker::Books::CultureSeries](doc/books/culture_series.md)
-  - [Faker::Books::Dune](doc/books/dune.md)
-  - [Faker::Books::Lovecraft](doc/books/lovecraft.md)
-  - [Faker::Books::TheKingkillerChronicle](doc/books/the_kingkiller_chronicle.md)
-</details>
-<details>
-  <summary>Fantasy</summary>
-  - [Faker::Fantasy::Tolkien](doc/fantasy/tolkien.md)
-</details>
-<details>
-  <summary>Travel</summary>
-  - [Faker:Travel::Airport](doc/travel/airport.md)
-  - [Faker:Travel::TrainStation](doc/travel/train_station.md)
-</details>
-<details>
-  <summary>Creature</summary>
-  - [Faker::Creature::Animal](doc/creature/animal.md)
-  - [Faker::Creature::Bird](doc/creature/bird.md)
-  - [Faker::Creature::Cat](doc/creature/cat.md)
-  - [Faker::Creature::Dog](doc/creature/dog.md)
-  - [Faker::Creature::Horse](doc/creature/horse.md)
-</details>
-<details>
-  <summary>Games</summary>
-  - [Faker::Game](doc/games/game.md)
-  - [Faker::Games::ClashOfClans](doc/games/clash_of_clans.md)
-  - [Faker::Games::DnD](doc/games/dnd.md)
-  - [Faker::Games::Dota](doc/games/dota.md)
-  - [Faker::Games::ElderScrolls](doc/games/elder_scrolls.md)
-  - [Faker::Games::Fallout](doc/games/fallout.md)
-  - [Faker::Games::FinalFantasyXIV](doc/games/final_fantasy_xiv.md)
-  - [Faker::Games::HalfLife](doc/games/half_life.md)
-  - [Faker::Games::Heroes](doc/games/heroes.md)
-  - [Faker::Games::HeroesOfTheStorm](doc/games/heroes_of_the_storm.md)
-  - [Faker::Games::LeagueOfLegends](doc/games/league_of_legends.md)
-  - [Faker::Games::Minecraft](doc/games/minecraft.md)
-  - [Faker::Games::Myst](doc/games/myst.md)
-  - [Faker::Games::Overwatch](doc/games/overwatch.md)
-  - [Faker::Games::Pokemon](doc/games/pokemon.md)
-  - [Faker::Games::SonicTheHedgehog](doc/games/sonic_the_hedgehog.md)
-  - [Faker::Games::StreetFighter](doc/games/street_fighter.md)
-  - [Faker::Games::SuperMario](doc/games/super_mario.md)
-  - [Faker::Games::SuperSmashBros](doc/games/super_smash_bros.md)
-  - [Faker::Games::Touhou](doc/games/touhou.md)
-  - [Faker::Games::WarhammerFantasy](doc/games/warhammer_fantasy.md)
-  - [Faker::Games::Witcher](doc/games/witcher.md)
-  - [Faker::Games::WorldOfWarcraft](doc/games/world_of_warcraft.md)
-  - [Faker::Games::Zelda](doc/games/zelda.md)
-</details>
-<details>
-  <summary>Japanese Media</summary>
-  - [Faker::JapaneseMedia::CowboyBebop](doc/japanese_media/cowboy_bebop.md)
-  - [Faker::JapaneseMedia::DragonBall](doc/japanese_media/dragon_ball.md)
-  - [Faker::JapaneseMedia::OnePiece](doc/japanese_media/one_piece.md)
-  - [Faker::JapaneseMedia::StudioGhibli](doc/japanese_media/studio_ghibli.md)
-  - [Faker::JapaneseMedia::SwordArtOnline](doc/japanese_media/sword_art_online.md)
-  - [Faker::JapaneseMedia::Naruto](doc/japanese_media/naruto.md)
-  - [Faker::JapaneseMedia::Doraemon](doc/japanese_media/doraemon.md)
-  - [Faker::JapaneseMedia::Conan](doc/japanese_media/conan.md)
-  - [Faker::JapaneseMedia::FullmetalAlchemistBrotherhood](doc/japanese_media/fullmetal_alchemist_brotherhood.md)
-</details>
-<details>
-  <summary>Movies</summary>
-  - [Faker::Movie](doc/movies/movie.md)
-  - [Faker::Movies::Avatar](doc/movies/avatar.md)
-  - [Faker::Movies::BackToTheFuture](doc/movies/back_to_the_future.md)
-  - [Faker::Movies::Departed](doc/movies/departed.md)
-  - [Faker::Movies::Ghostbusters](doc/movies/ghostbusters.md)
-  - [Faker::Movies::HarryPotter](doc/movies/harry_potter.md)
-  - [Faker::Movies::HitchhikersGuideToTheGalaxy](doc/movies/hitchhikers_guide_to_the_galaxy.md)
-  - [Faker::Movies::Hobbit](doc/movies/hobbit.md)
-  - [Faker::Movies::HowToTrainYourDragon](doc/movies/how_to_train_your_dragon.md)
-  - [Faker::Movies::Lebowski](doc/movies/lebowski.md)
-  - [Faker::Movies::LordOfTheRings](doc/movies/lord_of_the_rings.md)
-  - [Faker::Movies::PrincessBride](doc/movies/princess_bride.md)
-  - [Faker::Movies::StarWars](doc/movies/star_wars.md)
-  - [Faker::Movies::TRON](doc/movies/tron.md)
-  - [Faker::Movies::VForVendetta](doc/movies/v_for_vendetta.md)
-</details>
-<details>
-  <summary>Music</summary>
-  - [Faker::Music](doc/music/music.md)
-  - [Faker::Music::GratefulDead](doc/music/grateful_dead.md)
-  - [Faker::Music::Hiphop](doc/music/hiphop.md)
-  - [Faker::Music::Opera](doc/music/opera.md)
-  - [Faker::Music::PearlJam](doc/music/pearl_jam.md)
-  - [Faker::Music::Phish](doc/music/phish.md)
-  - [Faker::Music::Prince](doc/music/prince.md)
-  - [Faker::Music::RockBand](doc/music/rock_band.md)
-  - [Faker::Music::Rush](doc/music/rush.md)
-  - [Faker::Music::SmashingPumpkins](doc/music/smashing_pumpkins.md)
-  - [Faker::Music::UmphreysMcgee](doc/music/umphreys_mcgee.md)
-</details>
-<details>
-  <summary>Quotes</summary>
-  - [Faker::Quote](doc/quotes/quote.md)
-  - [Faker::Quotes::Chiquito](doc/quotes/chiquito.md)
-  - [Faker::Quotes::Rajnikanth](doc/quotes/rajnikanth.md)
-  - [Faker::Quotes::Shakespeare](doc/quotes/shakespeare.md)
-</details>
-<details>
-  <summary>Sports</summary>
-  - [Faker::Sport](doc/sports/sport.md)
-  - [Faker::Sports::Basketball](doc/sports/basketball.md)
-  - [Faker::Sports::Chess](doc/sports/chess.md)
-  - [Faker::Sports::Football](doc/sports/football.md)
-  - [Faker::Sports::Mountaineering](doc/sports/mountaineering.md)
-  - [Faker::Sports::Volleyball](doc/sports/volleyball.md)
-</details>
-<details>
-  <summary>Tv Shows</summary>
-  - [Faker::TvShows::AquaTeenHungerForce](doc/tv_shows/aqua_teen_hunger_force.md)
-  - [Faker::TvShows::Archer](doc/tv_shows/archer.md)
-  - [Faker::TvShows::BigBangTheory](doc/tv_shows/big_bang_theory.md)
-  - [Faker::TvShows::BojackHorseman](doc/tv_shows/bojack_horseman.md)
-  - [Faker::TvShows::BreakingBad](doc/tv_shows/breaking_bad.md)
-  - [Faker::TvShows::BrooklynNineNine](doc/tv_shows/brooklyn_nine_nine.md)
-  - [Faker::TvShows::Buffy](doc/tv_shows/buffy.md)
-  - [Faker::TvShows::Community](doc/tv_shows/community.md)
-  - [Faker::TvShows::DrWho](doc/tv_shows/dr_who.md)
-  - [Faker::TvShows::DumbAndDumber](doc/tv_shows/dumb_and_dumber.md)
-  - [Faker::TvShows::FamilyGuy](doc/tv_shows/family_guy.md)
-  - [Faker::TvShows::FinalSpace](doc/tv_shows/final_space.md)
-  - [Faker::TvShows::Friends](doc/tv_shows/friends.md)
-  - [Faker::TvShows::GameOfThrones](doc/tv_shows/game_of_thrones.md)
-  - [Faker::TvShows::HeyArnold](doc/tv_shows/hey_arnold.md)
-  - [Faker::TvShows::HowIMetYourMother](doc/tv_shows/how_i_met_your_mother.md)
-  - [Faker::TvShows::MichaelScott](doc/tv_shows/michael_scott.md)
-  - [Faker::TvShows::NewGirl](doc/tv_shows/new_girl.md)
-  - [Faker::TvShows::ParksAndRec](doc/tv_shows/parks_and_rec.md)
-  - [Faker::TvShows::RickAndMorty](doc/tv_shows/rick_and_morty.md)
-  - [Faker::TvShows::RuPaul](doc/tv_shows/rupaul.md)
-  - [Faker::TvShows::Seinfeld](doc/tv_shows/seinfeld.md)
-  - [Faker::TvShows::SiliconValley](doc/tv_shows/silicon_valley.md)
-  - [Faker::TvShows::Simpsons](doc/tv_shows/simpsons.md)
-  - [Faker::TvShows::SouthPark](doc/tv_shows/south_park.md)
-  - [Faker::TvShows::Spongebob](doc/tv_shows/spongebob.md)
-  - [Faker::TvShows::StarTrek](doc/tv_shows/star_trek.md)
-  - [Faker::TvShows::Stargate](doc/tv_shows/stargate.md)
-  - [Faker::TvShows::StrangerThings](doc/tv_shows/stranger_things.md)
-  - [Faker::TvShows::Suits](doc/tv_shows/suits.md)
-  - [Faker::TvShows::Supernatural](doc/tv_shows/supernatural.md)
-  - [Faker::TvShows::TheExpanse](doc/tv_shows/the_expanse.md)
-  - [Faker::TvShows::TheFreshPrinceOfBelAir](doc/tv_shows/the_fresh_prince_of_bel_air.md)
-  - [Faker::TvShows::TheITCrowd](doc/tv_shows/the_it_crowd.md)
-  - [Faker::TvShows::TheThickOfIt](doc/tv_shows/the_thick_of_it.md)
-  - [Faker::TvShows::TwinPeaks](doc/tv_shows/twin_peaks.md)
-  - [Faker::TvShows::VentureBros](doc/tv_shows/venture_bros.md)
-</details>
-<details>
-  <summary>Locations</summary>
-  - [Faker::Locations::Australia](doc/locations/australia.md)
-</details>
+To see the full list, check out the [GENERATORS](./GENERATORS.md) document.
 ## Contributing
@@ -499,7 +172,7 @@ instructions on setting up the repo on your machine, opening bug reports, unders
 and creating a good pull request.
 There is a [Discord channel](https://discord.gg/RMumTwB) to discuss anything
-regarding improvements or feature requests.
+regarding improvements or feature requests. This is not actively monitored by the current maintainers.
 Thank you, contributors!
@@ -507,6 +180,18 @@ Thank you, contributors!
 Faker follows Semantic Versioning 2.0 as defined at https://semver.org.
+## Inspiration
+Faker was inspired by [Perl's Data::Faker library](https://metacpan.org/pod/Data::Faker).
+## In the media
+- 📰 [With Great Humor Comes Great Developer Engagement] - KTH Royal Institute of Technology research
+- 🎧 [Computer und Kommunikation 4.5.2024, komplette Sendung] - Deutschland Funk Radio Interview
+[With Great Humor Comes Great Developer Engagement]: https://arxiv.org/pdf/2312.01680
+[Computer und Kommunikation 4.5.2024, komplette Sendung]: https://www.deutschlandfunk.de/computer-und-kommunikation-4-5-2024-komplette-sendung-dlf-16492b03-100.html
 ## License
 This code is free to use under the terms of the MIT license.

data/lib/faker/blockchain/bitcoin.rb CHANGED Viewed

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

data/lib/faker/blockchain/tezos.rb CHANGED Viewed

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

data/lib/faker/blockchain.rb ADDED Viewed

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+module Faker
+  class Blockchain
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/books/lovecraft.rb CHANGED Viewed

@@ -240,7 +240,7 @@ module Faker
           paragraph += " #{paragraph(sentence_count: 3)}" while paragraph.length < characters
-          "#{paragraph[0...characters - 1]}."
+          "#{paragraph[0...(characters - 1)]}."
         end
       end
     end

data/lib/faker/books.rb ADDED Viewed

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+module Faker
+  class Books
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/creature.rb ADDED Viewed

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+module Faker
+  class Creature
+    if Faker::Config.lazy_loading?
+      Faker.lazy_load(self)
+    end
+  end
+end

data/lib/faker/default/avatar.rb CHANGED Viewed

@@ -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/bank.rb CHANGED Viewed

@@ -17,11 +17,7 @@ module Faker
       #
       # @faker.version 1.9.1
       def account_number(digits: 10)
-        output = ''
-        output += rand.to_s[2..] while output.length < digits
-        output[0...digits]
+        Array.new(digits) { rand(10) }.join
       end
       ##

data/lib/faker/default/boolean.rb CHANGED Viewed

@@ -15,7 +15,8 @@ module Faker
       #   Faker::Boolean.boolean(true_ratio: 0.2) #=> false
       #
       # @faker.version 1.6.2
-      def boolean(true_ratio: 0.5)
+      #
+      def boolean(true_ratio: 0.5) # rubocop:disable Naming/PredicateMethod
         (rand < true_ratio)
       end
     end

data/lib/faker/default/code.rb CHANGED Viewed

@@ -168,6 +168,7 @@ module Faker
       # Reporting body identifier
       RBI = %w[01 10 30 33 35 44 45 49 50 51 52 53 54 86 91 98 99].freeze
+      private_constant :RBI
       def generate_imei
         str = Array.new(15, 0)
@@ -269,7 +270,10 @@ module Faker
       end
       EAN_CHECK_DIGIT8 = [3, 1, 3, 1, 3, 1, 3].freeze
+      private_constant :EAN_CHECK_DIGIT8
       EAN_CHECK_DIGIT13 = [1, 3, 1, 3, 1, 3, 1, 3, 1, 3, 1, 3].freeze
+      private_constant :EAN_CHECK_DIGIT13
       def rut_verificator_digit(rut)
         total = rut.to_s.rjust(8, '0').chars.zip(%w[3 2 7 6 5 4 3 2]).collect { |a, b| a.to_i * b.to_i }.inject(:+)